xiaoxia-saas/tests/unit/test_points_routes.py

"""积分/会员 API 路由对齐测试 — fix/1895-points-api-align

覆盖:
- P0-1: POST /points/recharge 返回 pay_params / points_amount / expire_at
- P0-2: POST /points/check 任意 scene_key 均可查询（已下线场景返回 cost=0，不报错）
- P1-3: GET /points/rules 返回 description 字段
- P1-6: GET /subscription/plans 返回档位列表
- P1-7: multiplier 实际扣费一致（calculate_points_cost 统一应用）
"""

from __future__ import annotations

import os
from datetime import UTC, datetime, timedelta
from unittest.mock import MagicMock, patch

import pytest
from fastapi import HTTPException


def _make_cu(user_id="user-1", is_member=False, member_type=None):
    cu = MagicMock()
    cu.user.id = user_id
    cu.user.is_member = is_member
    cu.user.member_type = member_type
    cu.user.member_expires_at = None
    return cu


# ── P0-1: recharge response fields ────────────────────────────────────


class TestRechargeOrderResponse:
    def test_recharge_returns_pay_params_points_amount_expire_at(self):
        """recharge 响应必须包含 pay_params / points_amount / expire_at。"""
        from app.api.routes.points import create_recharge_order
        from app.schemas.points import PointsRechargeRequest

        svc = MagicMock()
        svc.create_order.return_value = {
            "id": "order-1",
            "order_type": "points",
            "product_code": "starter_pack",
            "amount_cents": 990,
            "status": "pending",
            "created_at": datetime.now(UTC).isoformat(),
        }
        db = MagicMock()
        cu = _make_cu()
        body = PointsRechargeRequest(package_id="starter_pack")

        before = datetime.now(UTC)
        with patch("app.api.routes.points._get_service", return_value=svc):
            resp = create_recharge_order(body=body, current_user=cu, db=db)
        after = datetime.now(UTC) + timedelta(hours=48)

        assert resp.points_amount == 100  # starter_pack 100 分
        assert isinstance(resp.pay_params, dict)
        assert resp.expire_at is not None
        expire_dt = datetime.fromisoformat(resp.expire_at)
        assert expire_dt >= before + timedelta(hours=47, minutes=55)
        assert expire_dt <= after

    def test_recharge_invalid_package_returns_400(self):
        from app.api.routes.points import create_recharge_order
        from app.schemas.points import PointsRechargeRequest

        svc = MagicMock()
        svc.create_order.side_effect = ValueError("invalid package")
        db = MagicMock()
        cu = _make_cu()
        body = PointsRechargeRequest(package_id="nonexistent")

        with pytest.raises(HTTPException) as exc, patch("app.api.routes.points._get_service", return_value=svc):
            create_recharge_order(body=body, current_user=cu, db=db)
        assert exc.value.status_code == 400


# ── P0-2: check 任意 scene_key（已下线场景返回 cost=0） ──────────────────


class TestCheckPointsUnknownScene:
    def test_unknown_scene_returns_zero_cost_not_error(self):
        """任意 scene_key 均可查询，已下线/未知场景返回 cost=0（免费放行）。"""
        from app.api.routes.points import check_points
        from app.schemas.points import PointsCheckRequest

        svc = MagicMock()
        svc.get_or_create_account.return_value = {"balance": 0}
        db = MagicMock()
        cu = _make_cu()

        with (
            patch("app.api.routes.points._credits_enabled", return_value=True),
            patch("app.api.routes.points._get_service", return_value=svc),
        ):
            for scene in ["ai_script", "ai_voice", "ai_video", "ai_title", "ai_cover", "nonexistent"]:
                body = PointsCheckRequest(scene_key=scene, quantity=1)
                resp = check_points(body=body, current_user=cu, db=db)
                assert resp.required_points == 0, f"{scene} should be free"
                assert resp.allowed is True

    def test_voice_clone_synth_still_charges(self):
        """合法付费场景 voice_clone_synth 正常计费：免费用户 1 分钟 = ceil(1*1.15)=2 积分。"""
        from app.api.routes.points import check_points
        from app.schemas.points import PointsCheckRequest

        svc = MagicMock()
        svc.get_or_create_account.return_value = {"balance": 50}
        db = MagicMock()
        cu = _make_cu()
        body = PointsCheckRequest(scene_key="voice_clone_synth", quantity=1, duration_minutes=1)

        with (
            patch("app.api.routes.points._credits_enabled", return_value=True),
            patch("app.api.routes.points._get_service", return_value=svc),
        ):
            resp = check_points(body=body, current_user=cu, db=db)
        assert resp.required_points == 2  # ceil(1 * 1.15) = 2
        assert resp.current_balance == 50
        assert resp.allowed is True


# ── P1-3: rules include description ───────────────────────────────────


class TestPointsRulesDescription:
    def test_rules_have_description_field(self):
        from app.api.routes.points import get_rules

        resp = get_rules(_current_user=_make_cu())
        # 场景列表包含 voice_clone_train / voice_clone_synth / viral_video（爆款视频为动态定价）
        keys = {r.scene_key for r in resp.rules}
        assert {"voice_clone_train", "voice_clone_synth", "viral_video"}.issubset(keys)
        for rule in resp.rules:
            assert rule.description, f"{rule.scene_key} missing description"
            assert isinstance(rule.description, str)
            assert len(rule.description) > 0

    def test_free_user_multiplier_returned(self):
        from app.api.routes.points import get_rules

        resp = get_rules(_current_user=_make_cu())
        assert resp.free_user_multiplier == 1.15


# ── P1-6: GET /subscription/plans ─────────────────────────────────────


class TestSubscriptionPlans:
    @staticmethod
    def _import_plans_fn():
        """Import from the real file to avoid sys.modules shadowing by integration fixtures."""
        import importlib.util

        _route_path = os.path.join(
            os.path.dirname(os.path.abspath(__file__)),
            "..",
            "..",
            "apps",
            "api",
            "app",
            "api",
            "routes",
            "subscription.py",
        )
        _spec = importlib.util.spec_from_file_location("_real_subscription_routes", os.path.abspath(_route_path))
        _mod = importlib.util.module_from_spec(_spec)
        # inject settings before exec
        import os as _os

        _os.environ.setdefault("JWT_SECRET_KEY", "test-secret")
        _spec.loader.exec_module(_mod)
        return _mod.list_membership_plans

    def test_plans_endpoint_reads_admin_table(self):
        """/subscription/plans 改读管理后台 plans 表：返回 catalog 服务提供的真实档位。"""
        list_membership_plans = self._import_plans_fn()
        real_plan = {
            "plan_id": "premium_yearly",
            "billing_cycle": "yearly",
            "name": "高级会员年卡",
            "description": "高级会员年度订阅，享受全部功能",
            "price_cents": 39900,
            "monthly_price_cents": 3325,
            "duration_days": 365,
            "features": {
                "4K 超清分辨率": True,
                "批量渲染": True,
                "优先处理队列": True,
                "credits_per_month": 500,
            },
        }
        with patch(
            "packages.application.catalog.admin_catalog.get_membership_plans",
            return_value=[real_plan],
        ):
            resp = list_membership_plans(current_user=_make_cu())
        plans = resp["plans"]
        assert len(plans) == 1
        p0 = plans[0]
        assert p0["plan_id"] == "premium_yearly"
        assert p0["price_cents"] == 39900
        assert p0["duration_days"] == 365
        assert p0["features"]["4K 超清分辨率"] is True

    def test_plans_endpoint_empty_when_all_disabled(self):
        """后台停用全部套餐时，用户端返回空列表。"""
        list_membership_plans = self._import_plans_fn()
        with patch(
            "packages.application.catalog.admin_catalog.get_membership_plans",
            return_value=[],
        ):
            resp = list_membership_plans(current_user=_make_cu())
        assert resp["plans"] == []

# ── P1-7: multiplier consistency ──────────────────────────────────────


class TestMultiplierConsistency:
    def test_free_user_voice_clone_synth_1min_costs_2(self):
        """voice_clone_synth base=1，免费用户 ceil(1*1.15)=2。"""
        from packages.domain.points_rules import calculate_points_cost

        assert calculate_points_cost("voice_clone_synth", is_member=False, duration_minutes=1) == 2

    def test_retired_scenes_return_zero(self):
        """已下线场景（ai_voice/ai_title/ai_cover/ai_rewrite 等）calculate_points_cost 统一返回 0。"""
        from packages.domain.points_rules import calculate_points_cost

        for scene in ["ai_voice", "ai_title", "ai_cover", "ai_rewrite", "ai_video", "ai_digital_human"]:
            assert calculate_points_cost(scene, is_member=False, quantity=1) == 0

    def test_check_matches_direct_calculation(self):
        """check 端点 required_points 与 calculate_points_cost 结果一致。"""
        from app.api.routes.points import check_points
        from app.schemas.points import PointsCheckRequest

        from packages.domain.points_rules import calculate_points_cost

        svc = MagicMock()
        svc.get_or_create_account.return_value = {"balance": 999}
        db = MagicMock()
        cu = _make_cu()

        with patch("app.api.routes.points._credits_enabled", return_value=True):
            for scene in ["voice_clone_synth", "voice_clone_train", "ai_voice", "ai_video", "ai_title"]:
                body = PointsCheckRequest(scene_key=scene, quantity=1, duration_minutes=1)
                with patch("app.api.routes.points._get_service", return_value=svc):
                    resp = check_points(body=body, current_user=cu, db=db)
                expected = calculate_points_cost(scene, is_member=False, quantity=1, duration_minutes=1)
                assert resp.required_points == expected, f"{scene}: got {resp.required_points}, expected {expected}"