"""斗鱼外部单协作:账号导入、状态机、鱼翅/积分与兑换记录查询。""" import pytest from tests.support.db import get_test_engine, make_test_session from web.backend.models import ( Account, AccountEvent, AccountLease, AuditLog, DouyuTask, PlatformCommodityMapping, PlatformFulfillmentEvent, PlatformFulfillmentTask, User, ) from web.backend.routers import douyu_collab as collab_api from web.backend.schemas import ( DouyuCollabAccountLookupOut, DouyuCollabAccountRecommendOut, DouyuCollabAccountRequest, DouyuCollabCkExportOut, DouyuCollabOrderCreate, DouyuCollabOrderOut, DouyuCollabOrderUpdate, DouyuCollabUsernameExportOut, ) from web.backend.services import douyu_collab_service as collab class FakeClient: def __init__(self, *, points=5000, fish=1000, records=None): self.points = points self.fish = fish self.records = records if records is not None else [] self.records_calls = 0 self.orders_calls = 0 def elite_user_info(self, **_): return { "manual_type": 1, "manual_score": self.points, "expire_time": 0, "user_info": {"nickname": "斗鱼昵称"}, } def bind_info(self, **_): return { "is_bound_account": True, "is_bound_role": True, "is_bound_act": True, "role_name": "角色A", "area_name": "微信", "plat_name": "苹果(iOS)", "nickname": "微信昵称", } def gold_account(self): return {"gold": self.fish} def list_goods(self, **_): return { "goods": [ { "commodityId": "gift-a", "commodityName": "礼包A", "score": 100, "status": 0, "openStatus": 1, "mark": "", "count": 10, } ] } def exchange_records(self, **_): self.records_calls += 1 return {"records": self.records} def exchange_orders(self, **_): self.orders_calls += 1 return {"orders": []} class FakeNoBindClient(FakeClient): def bind_info(self, **_): raise RuntimeError("未绑定角色") class FakeUnboundClient(FakeClient): def bind_info(self, **_): return { "is_bound_account": False, "is_bound_role": False, "is_bound_act": False, "role_name": "", "area_name": "", "plat_name": "", "nickname": "", } class TestDouyuCollabOrders: def setup_method(self): self.engine = get_test_engine() self.session = make_test_session(self.engine) self.admin = User( username="douyu-collab-admin", password_hash="hash", role="super_admin", is_active=True, ) self.session.add(self.admin) self.session.commit() self.account = Account( username="douyu-account-a", password="password", email="a@example.com", email_password="mail-password", cookie="acf_uid=100; acf_nickname=test", ) self.session.add(self.account) self.session.commit() def teardown_method(self): self.session.close() def _platform_task_lease(self): task = PlatformFulfillmentTask( source_system="order_site", source_order_id="PLATFORM-TAKEOVER-ORDER", source_order_item_id="PLATFORM-TAKEOVER-ITEM", source_fulfillment_id="PLATFORM-TAKEOVER-FULFILLMENT", platform_order_id="PLATFORM-TAKEOVER-NO", target_platform="douyu", scope="elite", internal_sku_key="套装-接管测试", commodity_id="takeover-goods", required_points=100, account_id=self.account.id, execution_status="allocated", binding_status="not_started", exchange_status="not_started", ) self.session.add(task) self.session.flush() lease = AccountLease( account_id=self.account.id, holder_user_id=self.admin.id, scope="elite", purpose="platform_fulfillment", commodity_id="takeover-goods", batch_id=f"pf:{task.id}", status="active", ) self.session.add(lease) self.session.flush() task.lease_id = lease.id self.session.commit() return task, lease def test_douyu_order_mutations_accept_takeover_flag(self): create = DouyuCollabOrderCreate( order_no="DY-TAKEOVER-SCHEMA", takeover_platform_lease=True, ) update = DouyuCollabOrderUpdate(takeover_platform_lease=True) account = DouyuCollabAccountRequest( account_username="douyu-account-a", takeover_platform_lease=True, ) assert create.takeover_platform_lease is True assert update.takeover_platform_lease is True assert account.takeover_platform_lease is True def test_lookup_account_resolves_internal_ck_and_role(self): result = collab.lookup_account( self.session, "douyu-account-a", client=FakeClient() ) assert result["found"] is True assert result["ok"] is True assert result["account_id"] == self.account.id assert result["bind_game_role"] == "角色A" assert result["manual_score"] == 5000 assert result["fish_fin_balance"] == 1000 assert result["goods"][0]["commodity_id"] == "gift-a" DouyuCollabAccountLookupOut.model_validate(result) def test_unlink_account_clears_snapshots_and_keeps_platform_lease(self): order = collab.create_order( self.session, self.admin, order_no="DY-UNLINK-PLATFORM", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/unlink.png"], client=FakeClient(), ) collab_lease = self.session.query(AccountLease).one() collab_lease.status = "released" collab_lease.release_reason = "test_handoff" platform_lease = AccountLease( account_id=self.account.id, holder_user_id=self.admin.id, scope="elite", purpose="platform_fulfillment", batch_id="pf:unlink-platform", status="active", ) self.session.add(platform_lease) self.session.commit() collab.unlink_account( self.session, self.admin, order, reason="账号已用于其它履约订单", expected_version=order.version, ) self.session.refresh(order) self.session.refresh(platform_lease) assert order.account_id is None assert order.account_username == "" assert order.bind_game_role == "" assert order.fish_fin_balance is None assert order.points_balance is None assert order.status == collab.STATUS_INCOMPLETE assert platform_lease.status == "active" assert platform_lease.purpose == "platform_fulfillment" assert ( self.session.query(AuditLog) .filter_by(action="douyu:collab:account_unlink") .count() == 1 ) def test_unlink_account_releases_last_collab_lease(self): order = collab.create_order( self.session, self.admin, order_no="DY-UNLINK-LEASE", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/unlink-lease.png"], client=FakeClient(), ) lease = self.session.query(AccountLease).one() collab.unlink_account( self.session, self.admin, order, reason="误关联", expected_version=order.version, ) self.session.refresh(lease) assert lease.status == "released" assert lease.release_reason == "douyu_collab_account_unlinked" def test_account_replace_requires_super_admin_or_operation(self): order = collab.create_order( self.session, self.admin, order_no="DY-UNLINK-SUPPORT", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/unlink-support.png"], client=FakeClient(), ) support = User( username="douyu-collab-support", password_hash="hash", role="support", custom_permissions=[], is_active=True, ) self.session.add(support) self.session.commit() with pytest.raises(collab.CollabError) as excinfo: collab.unlink_account( self.session, support, order, reason="越权测试", ) assert excinfo.value.code == "account_replace_forbidden" def test_operation_can_unlink_account(self): order = collab.create_order( self.session, self.admin, order_no="DY-UNLINK-OPERATION", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/unlink-operation.png"], client=FakeClient(), ) operator = User( username="douyu-collab-operation", password_hash="hash", role="operation", is_active=True, ) self.session.add(operator) self.session.commit() collab.unlink_account( self.session, operator, order, reason="运营纠正误关联", expected_version=order.version, ) self.session.refresh(order) assert order.account_id is None assert order.status == collab.STATUS_INCOMPLETE def test_recommend_accounts_prefers_unbound_and_can_exclude_rebindable(self): mapping = PlatformCommodityMapping( target_platform="douyu", internal_sku_key="推荐礼包", commodity_id="gift-a", goods_name="推荐礼包", required_points=100, scope="elite", enabled=True, ) self.session.add(mapping) self.session.flush() order = collab.create_order( self.session, self.admin, order_no="DY-RECOMMEND", shop="店铺A", gift_name="推荐礼包", draft=True, ) bound = Account( username="douyu-account-bound", password="password", email="bound@example.com", email_password="mail-password", cookie="acf_uid=200; acf_nickname=bound", status="active", auto_managed=True, elite_opened=True, points=1000, ) empty = Account( username="douyu-account-empty", password="password", email="empty@example.com", email_password="mail-password", cookie="acf_uid=300; acf_nickname=empty", status="active", auto_managed=True, elite_opened=True, points=500, role_bind_status="unbound", ) self.session.add_all([bound, empty]) self.session.commit() clients = { int(self.account.id): FakeClient(), int(bound.id): FakeClient(), int(empty.id): FakeUnboundClient(), } result = collab.recommend_accounts( self.session, self.admin, order, include_rebindable=True, limit=5, client_factory=lambda account: clients[int(account.id)], ) assert order.commodity_id == "gift-a" assert result["candidates"][0]["account_id"] == empty.id assert result["candidates"][0]["match_type"] == "empty" assert any(item["match_type"] == "rebind" for item in result["candidates"]) DouyuCollabAccountRecommendOut.model_validate(result) unbound_only = collab.recommend_accounts( self.session, self.admin, order, include_rebindable=False, limit=5, client_factory=lambda account: clients[int(account.id)], ) assert [item["account_id"] for item in unbound_only["candidates"]] == [ empty.id ] def test_create_strict_order_uses_internal_account_and_advances(self): order = collab.create_order( self.session, self.admin, order_no="DY-001", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-1.png"], client=FakeClient(), ) assert order.account_id == self.account.id assert order.bind_game_role == "角色A" assert order.points_balance == 5000 assert order.fish_fin_balance == 1000 assert order.status == collab.STATUS_TO_RECHARGE DouyuCollabOrderOut.model_validate(collab.serialize_one(self.session, order)) def test_manual_gift_without_goods_snapshot_keeps_name_and_points(self): order = collab.create_order( self.session, self.admin, order_no="DY-MANUAL-001", shop="店铺A", account_username="douyu-account-a", gift_name="套装-暗影哥特", required_points=888, home_images=["collab/home-manual.png"], client=FakeClient(), ) assert order.gift_name == "套装-暗影哥特" assert order.commodity_id == "" assert order.required_points == 888 assert order.status == collab.STATUS_TO_RECHARGE collab.update_order( self.session, self.admin, order, { "gift_name": "套装-暗影哥特", "commodity_id": "", "required_points": 888, "remark": "接口未返回商品,手动填写", }, expected_version=order.version, ) payload = collab.serialize_one(self.session, order) assert payload["gift_name"] == "套装-暗影哥特" assert payload["commodity_id"] == "" assert payload["required_points"] == 888 DouyuCollabOrderOut.model_validate(payload) def test_gift_catalog_crud_rename_cascades_and_delete_guard(self): gift = collab.create_gift( self.session, self.admin, name="套装-暗影哥特", points=888, remark="接口未返回商品", ) assert gift.points == 888 with pytest.raises(collab.CollabError) as duplicated: collab.create_gift( self.session, self.admin, name="套装-暗影哥特", points=900, ) assert duplicated.value.code == "gift_exists" order = collab.create_order( self.session, self.admin, order_no="DY-GIFT-001", shop="店铺A", account_username="douyu-account-a", gift_name=gift.name, required_points=None, home_images=["collab/home-gift.png"], client=FakeClient(), ) assert order.gift_name == "套装-暗影哥特" assert order.commodity_id == "" assert order.required_points == 888 collab.update_gift( self.session, self.admin, gift, {"name": "套装-暗影哥特-返场", "points": 999}, ) self.session.refresh(order) assert order.gift_name == "套装-暗影哥特-返场" assert order.required_points == 888 with pytest.raises(collab.CollabError) as in_use: collab.delete_gift(self.session, self.admin, gift) assert in_use.value.code == "gift_in_use" spare = collab.create_gift( self.session, self.admin, name="套装-星河流浪者", points=1680, ) assert [ row.name for row in collab.list_gifts(self.session, active_only=True) ] == [ "套装-暗影哥特-返场", "套装-星河流浪者", ] collab.delete_gift(self.session, self.admin, spare) assert [row.name for row in collab.list_gifts(self.session)] == [ "套装-暗影哥特-返场" ] collab.create_gift( self.session, self.admin, name="礼包A", points=999, ) api_order = collab.create_order( self.session, self.admin, order_no="DY-GIFT-API-001", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=None, home_images=["collab/home-gift-api.png"], client=FakeClient(), ) # 接口恢复返回商品后以接口积分为准,字典只做兜底。 assert api_order.required_points == 100 assert api_order.commodity_id == "gift-a" def test_gift_catalog_write_requires_manage_permission(self): from web.backend.permissions import get_role_permissions support = get_role_permissions("support") assert "douyu:collab:view" in support assert "douyu:collab:manage" not in support assert "douyu:collab:manage" in get_role_permissions("operation") def test_same_account_allows_multiple_orders(self): collab.create_order( self.session, self.admin, order_no="DY-002", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-1.png"], client=FakeClient(), ) second = collab.create_order( self.session, self.admin, order_no="DY-003", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-2.png"], client=FakeClient(), ) assert second.account_id == self.account.id assert collab.group_points_total(self.session, second) == 200 lease = self.session.query(AccountLease).one() assert lease.account_id == self.account.id assert lease.purpose == collab.LEASE_PURPOSE_DOUYU_COLLAB assert lease.batch_id == f"collab:{self.account.id}" assert lease.status == "active" assert ( self.session.query(AccountEvent) .filter(AccountEvent.event_type == "lease_acquired") .count() == 1 ) def test_create_order_rejects_account_leased_by_platform(self): self.session.add( AccountLease( account_id=self.account.id, holder_user_id=self.admin.id, scope="elite", purpose="platform_fulfillment", batch_id="pf:99", status="active", ) ) self.session.commit() with pytest.raises(collab.CollabError) as excinfo: collab.create_order( self.session, self.admin, order_no="DY-LEASE-CONFLICT", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-conflict.png"], client=FakeClient(), ) assert excinfo.value.code == "account_lease_conflict" assert ( self.session.query(collab.DouyuExternalOrder) .filter(collab.DouyuExternalOrder.order_no == "DY-LEASE-CONFLICT") .first() is None ) def test_create_order_explicitly_takes_over_platform_lease(self): task, lease = self._platform_task_lease() lease_id = lease.id order = collab.create_order( self.session, self.admin, order_no="DY-LEASE-TAKEOVER", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-takeover.png"], takeover_platform_lease=True, client=FakeClient(), ) self.session.refresh(task) self.session.refresh(lease) assert order.account_id == self.account.id assert task.execution_status == "manual_required" assert task.account_id is None assert task.lease_id is None assert lease.id == lease_id assert lease.status == "active" assert lease.purpose == collab.LEASE_PURPOSE_DOUYU_COLLAB assert lease.batch_id == f"collab:{self.account.id}" assert lease.expires_at is None event = ( self.session.query(PlatformFulfillmentEvent) .filter_by(task_id=task.id, event_type="collab_takeover") .one() ) assert event.detail_json["collabOrderNo"] == "DY-LEASE-TAKEOVER" assert event.detail_json["releasedLeaseId"] == lease_id assert ( self.session.query(AuditLog) .filter_by(action="douyu:collab:lease_takeover") .count() == 1 ) assert ( self.session.query(AccountEvent) .filter_by(event_type="lease_acquired") .count() == 1 ) def test_same_source_platform_lease_is_forced_to_collab_on_takeover(self): task, lease = self._platform_task_lease() order = collab.DouyuExternalOrder( order_no="DY-SAME-SOURCE-TAKEOVER", source_type=collab.SOURCE_TYPE_PLATFORM_FULFILLMENT, source_task_id=task.id, account_id=self.account.id, account_username=self.account.username, status=collab.STATUS_INCOMPLETE, owner_id=self.admin.id, created_by=self.admin.id, ) self.session.add(order) self.session.commit() collab.set_account( self.session, self.admin, order, self.account.username, takeover_platform_lease=True, client=FakeClient(), ) self.session.refresh(task) self.session.refresh(lease) assert task.execution_status == "manual_required" assert task.account_id is None assert task.lease_id is None assert lease.status == "active" assert lease.purpose == collab.LEASE_PURPOSE_DOUYU_COLLAB def test_takeover_rejects_running_exchange_task(self): task, lease = self._platform_task_lease() self.session.add( DouyuTask( batch_id="platform-exchange-running", account_id=self.account.id, account_assigned_to=self.admin.id, task_type="exchange_goods", handbook_scope="elite", status="running", platform_task_id=task.id, created_by=self.admin.id, ) ) self.session.commit() with pytest.raises(collab.CollabError) as excinfo: collab.create_order( self.session, self.admin, order_no="DY-TAKEOVER-BLOCKED", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-takeover-blocked.png"], takeover_platform_lease=True, client=FakeClient(), ) assert excinfo.value.code == "platform_task_running" self.session.refresh(task) self.session.refresh(lease) assert task.execution_status == "allocated" assert task.account_id == self.account.id assert task.lease_id == lease.id assert lease.purpose == "platform_fulfillment" def test_takeover_requires_platform_permission(self): task, lease = self._platform_task_lease() operator = User( username="douyu-collab-no-platform", password_hash="hash", role="operation", custom_permissions=[], is_active=True, ) self.session.add(operator) self.session.commit() with pytest.raises(collab.CollabError) as excinfo: collab.create_order( self.session, operator, order_no="DY-TAKEOVER-FORBIDDEN", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-takeover-forbidden.png"], takeover_platform_lease=True, client=FakeClient(), ) assert excinfo.value.code == "platform_takeover_forbidden" self.session.refresh(task) self.session.refresh(lease) assert task.execution_status == "allocated" assert task.account_id == self.account.id assert lease.purpose == "platform_fulfillment" def test_void_releases_only_after_last_active_order(self): first = collab.create_order( self.session, self.admin, order_no="DY-LEASE-VOID-1", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-lease-void-1.png"], client=FakeClient(), ) second = collab.create_order( self.session, self.admin, order_no="DY-LEASE-VOID-2", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-lease-void-2.png"], client=FakeClient(), ) collab.set_status( self.session, self.admin, first, status=collab.STATUS_VOID, reason="第一单作废", ) lease = self.session.query(AccountLease).one() assert lease.status == "active" collab.set_status( self.session, self.admin, second, status=collab.STATUS_VOID, reason="第二单作废", ) self.session.refresh(lease) assert lease.status == "released" assert lease.release_reason == "douyu_collab_void" restored = collab.set_status( self.session, self.admin, first, status=collab.STATUS_INCOMPLETE, reason="恢复第一单", ) restored_lease = ( self.session.query(AccountLease) .filter(AccountLease.status == "active") .one() ) assert restored.status == collab.STATUS_INCOMPLETE assert restored_lease.status == "active" assert restored_lease.purpose == collab.LEASE_PURPOSE_DOUYU_COLLAB def test_set_account_conflict_keeps_original_lease(self): order = collab.create_order( self.session, self.admin, order_no="DY-LEASE-SWITCH", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-lease-switch.png"], client=FakeClient(), ) other = Account( username="douyu-account-busy", password="password", email="busy@example.com", email_password="mail-password", cookie="acf_uid=200; acf_nickname=busy", ) self.session.add(other) self.session.flush() self.session.add( AccountLease( account_id=other.id, holder_user_id=self.admin.id, scope="elite", purpose="platform_fulfillment", batch_id="pf:100", status="active", ) ) self.session.commit() with pytest.raises(collab.CollabError) as excinfo: collab.set_account( self.session, self.admin, order, other.username, client=FakeClient(), ) assert excinfo.value.code == "account_lease_conflict" self.session.refresh(order) assert order.account_id == self.account.id original_lease = ( self.session.query(AccountLease) .filter( AccountLease.account_id == self.account.id, AccountLease.status == "active", ) .one() ) assert original_lease.purpose == collab.LEASE_PURPOSE_DOUYU_COLLAB def test_status_flow_and_exchange_record_marks_done(self): order = collab.create_order( self.session, self.admin, order_no="DY-004", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-3.png"], client=FakeClient(), ) collab.set_status( self.session, self.admin, order, status=collab.STATUS_RECHARGED, reason="鱼翅已充值", ) collab.set_status( self.session, self.admin, order, status=collab.STATUS_SCRIPTED, reason="脚本已上", ) result = collab.query_activity( self.session, self.admin, order, client=FakeClient(records=[{"commodityName": "礼包A"}]), ) assert result["verdict"] == collab.VERDICT_SUCCESS assert result["order"].status == collab.STATUS_DONE assert result["order"].done_at is not None lease = self.session.query(AccountLease).one() assert lease.status == "released" assert lease.release_reason == "douyu_collab_done" def test_status_change_rejects_unrelated_active_platform_lease(self): order = collab.create_order( self.session, self.admin, order_no="DY-PLATFORM-LEASE-STATUS", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-platform-lease.png"], client=FakeClient(), ) collab_lease = self.session.query(AccountLease).one() collab_lease.status = "released" collab_lease.release_reason = "test_handoff" platform_lease = AccountLease( account_id=self.account.id, holder_user_id=self.admin.id, scope="elite", purpose="platform_fulfillment", batch_id="pf:999", status="active", ) self.session.add(platform_lease) self.session.commit() with pytest.raises(collab.CollabError) as excinfo: collab.set_status( self.session, self.admin, order, status=collab.STATUS_RECHARGED, reason="仅补记充值状态", ) assert excinfo.value.code == "account_lease_conflict" self.session.rollback() self.session.refresh(order) self.session.refresh(platform_lease) assert order.status == collab.STATUS_TO_RECHARGE assert platform_lease.status == "active" assert platform_lease.purpose == "platform_fulfillment" def test_status_change_backfills_missing_collab_lease(self): order = collab.create_order( self.session, self.admin, order_no="DY-BACKFILL-LEASE-STATUS", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-backfill-lease.png"], client=FakeClient(), ) lease = self.session.query(AccountLease).one() lease.status = "released" lease.release_reason = "test_missing" self.session.commit() changed = collab.set_status( self.session, self.admin, order, status=collab.STATUS_RECHARGED, reason="补记充值状态并恢复占用", ) assert changed.status == collab.STATUS_RECHARGED restored = ( self.session.query(AccountLease) .filter( AccountLease.account_id == self.account.id, AccountLease.status == "active", ) .one() ) assert restored.purpose == collab.LEASE_PURPOSE_DOUYU_COLLAB def test_recharged_status_can_backfill_without_bind_role(self): order = collab.create_order( self.session, self.admin, order_no="DY-RECHARGED-NO-ROLE", shop="店铺A", account_username="douyu-account-a", draft=True, ) collab.update_order( self.session, self.admin, order, { "account_username": "douyu-account-a", "gift_name": "礼包A", "commodity_id": "gift-a", "required_points": 100, "home_images": ["collab/home-recharged-no-role.png"], }, client=FakeNoBindClient(), ) self.session.refresh(order) assert order.status == collab.STATUS_INCOMPLETE assert not order.bind_game_role with pytest.raises(collab.CollabError) as excinfo: collab.set_status( self.session, self.admin, order, status=collab.STATUS_TO_RECHARGE, reason="进入待充值", ) assert excinfo.value.code == "recharge_precondition" assert "绑定角色(先校验账号)" in str(excinfo.value) changed = collab.set_status( self.session, self.admin, order, status=collab.STATUS_RECHARGED, reason="充值已完成,补记状态", ) assert changed.status == collab.STATUS_RECHARGED assert changed.recharged_at is not None with pytest.raises(collab.CollabError) as excinfo: collab.set_status( self.session, self.admin, order, status=collab.STATUS_SCRIPTED, reason="角色资料仍未补齐", ) assert excinfo.value.code == "recharge_precondition" assert "绑定角色(先校验账号)" in str(excinfo.value) def test_account_role_error_keeps_lease_and_requires_explicit_rollback(self): order = collab.create_order( self.session, self.admin, order_no="DY-ROLE-ERROR", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-role-error.png"], client=FakeClient(), ) changed = collab.set_status( self.session, self.admin, order, status=collab.STATUS_ROLE_ERROR, reason="角色区服与订单不一致", ) assert changed.status == collab.STATUS_ROLE_ERROR assert collab.ORDER_STATUS_LABELS[changed.status] == "账号角色异常" lease = self.session.query(AccountLease).one() assert lease.status == "active" assert ( collab.list_orders(self.session, status=collab.STATUS_ROLE_ERROR)["total"] == 1 ) assert collab.summary(self.session)["by_status"][collab.STATUS_ROLE_ERROR] == 1 with pytest.raises(collab.CollabError) as excinfo: collab.set_status( self.session, self.admin, order, status=collab.STATUS_SCRIPTED, reason="直接恢复", ) assert excinfo.value.code == "rollback_required" restored = collab.set_status( self.session, self.admin, order, status=collab.STATUS_SCRIPTED, reason="角色已修正", rollback=True, ) assert restored.status == collab.STATUS_SCRIPTED self.session.refresh(lease) assert lease.status == "active" audit = ( self.session.query(AuditLog) .filter(AuditLog.action == "douyu:collab:role_error") .order_by(AuditLog.id.desc()) .first() ) assert audit is not None assert audit.detail is not None and '"from":"to_recharge"' in audit.detail def test_admin_can_restore_voided_order_to_another_status(self): order = collab.create_order( self.session, self.admin, order_no="DY-RESTORE-1", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-restore-1.png"], client=FakeClient(), ) collab.set_status( self.session, self.admin, order, status=collab.STATUS_VOID, reason="误作废", ) restored = collab.set_status( self.session, self.admin, order, status=collab.STATUS_SCRIPTED, reason="管理员确认恢复", ) assert restored.status == collab.STATUS_SCRIPTED assert restored.void_reason == "" assert restored.recharged_at is not None assert restored.scripted_at is not None payload = collab.serialize_one(self.session, restored) serialized = DouyuCollabOrderOut.model_validate(payload).model_dump() assert serialized["status"] == collab.STATUS_SCRIPTED assert serialized["void_reason"] == "" audit = ( self.session.query(AuditLog) .filter(AuditLog.action == "douyu:collab:void_restore") .order_by(AuditLog.id.desc()) .first() ) assert audit is not None assert audit.username == self.admin.username assert '"from":"void"' in audit.detail assert '"to":"scripted"' in audit.detail assert '"previous_void_reason":"误作废"' in audit.detail def test_non_admin_cannot_restore_voided_order(self): operator = User( username="douyu-collab-restore-operator", password_hash="hash", role="operation", is_active=True, ) self.session.add(operator) self.session.commit() order = collab.create_order( self.session, self.admin, order_no="DY-RESTORE-2", account_username="douyu-account-a", draft=True, ) collab.set_status( self.session, self.admin, order, status=collab.STATUS_VOID, reason="测试权限", ) with pytest.raises(collab.CollabError) as excinfo: collab.set_status( self.session, operator, order, status=collab.STATUS_INCOMPLETE, reason="越权恢复", ) assert excinfo.value.status_code == 403 assert excinfo.value.code == "admin_required" assert order.status == collab.STATUS_VOID assert order.void_reason == "测试权限" def test_void_restore_still_enforces_recharge_fields(self): order = collab.create_order( self.session, self.admin, order_no="DY-RESTORE-3", account_username="douyu-account-a", draft=True, ) collab.set_status( self.session, self.admin, order, status=collab.STATUS_VOID, reason="资料不全", ) with pytest.raises(collab.CollabError) as excinfo: collab.set_status( self.session, self.admin, order, status=collab.STATUS_RECHARGED, reason="直接恢复", ) assert excinfo.value.code == "recharge_precondition" assert order.status == collab.STATUS_VOID assert order.void_reason == "资料不全" def test_points_shortage_enters_points_error(self): order = collab.create_order( self.session, self.admin, order_no="DY-005", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-4.png"], client=FakeClient(), ) collab.set_status( self.session, self.admin, order, status=collab.STATUS_RECHARGED, reason="鱼翅已充值", ) order.points_threshold = 10 self.session.commit() result = collab.query_activity( self.session, self.admin, order, client=FakeClient(points=50, records=[]), ) assert result["points_reason"] == "shortage" assert result["order"].status == collab.STATUS_POINTS_ERROR def test_balance_query_skips_records_and_never_changes_status(self): order = collab.create_order( self.session, self.admin, order_no="DY-106", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-5.png"], client=FakeClient(), ) collab.set_status( self.session, self.admin, order, status=collab.STATUS_RECHARGED, reason="鱼翅已充值", ) order.points_threshold = 10 self.session.commit() client = FakeClient(points=50, records=[{"commodityName": "礼包A"}]) result = collab.query_activity( self.session, self.admin, order, client=client, source="balance_batch", include_records=False, ) assert client.records_calls == 0 assert client.orders_calls == 0 assert result["scope"] == "balances" assert result["verdict"] == collab.VERDICT_UNKNOWN assert result["points_reason"] == "shortage" assert result["order"].status == collab.STATUS_RECHARGED assert result["metric"].source == "balance_batch" assert result["metric"].records_total == 0 def test_balance_query_keeps_last_exchange_verdict_visible(self): order = collab.create_order( self.session, self.admin, order_no="DY-107", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-6.png"], client=FakeClient(), ) collab.set_status( self.session, self.admin, order, status=collab.STATUS_RECHARGED, reason="鱼翅已充值", ) collab.set_status( self.session, self.admin, order, status=collab.STATUS_SCRIPTED, reason="脚本已上", ) record_result = collab.query_activity( self.session, self.admin, order, client=FakeClient(records=[{"commodityName": "礼包A"}]), ) assert record_result["order"].status == collab.STATUS_DONE collab.query_activity( self.session, self.admin, order, client=FakeClient(), source="balance_batch", include_records=False, ) payload = collab.serialize_one(self.session, order) assert payload["status"] == collab.STATUS_DONE assert payload["last_verdict"] == collab.VERDICT_SUCCESS assert payload["last_records_matched"] == 1 assert payload["last_metric_message"] == "仅查询鱼翅与积分,未查询兑换记录" def test_draft_can_be_created_before_account_resolution(self): order = collab.create_order( self.session, self.admin, order_no="DY-006", shop="", account_username="not-exists-yet", draft=True, ) assert order.status == collab.STATUS_INCOMPLETE assert order.account_id is None assert order.account_username == "not-exists-yet" def test_draft_existing_username_links_account_and_can_be_completed(self): order = collab.create_order( self.session, self.admin, order_no="DY-009", shop="店铺A", account_username="douyu-account-a", draft=True, ) assert order.account_id == self.account.id collab.update_order( self.session, self.admin, order, { "account_username": "douyu-account-a", "gift_name": "礼包A", "commodity_id": "gift-a", "required_points": 100, "home_images": ["collab/home-7.png"], }, client=FakeClient(), ) self.session.refresh(order) assert order.bind_game_role == "角色A" assert order.status == collab.STATUS_TO_RECHARGE assert collab.serialize_one(self.session, order)["missing_fields"] == [] def test_missing_bind_role_keeps_incomplete_and_explains_why(self): order = collab.create_order( self.session, self.admin, order_no="DY-011", shop="店铺A", account_username="douyu-account-a", draft=True, ) collab.update_order( self.session, self.admin, order, { "account_username": "douyu-account-a", "gift_name": "礼包A", "commodity_id": "gift-a", "required_points": 100, "home_images": ["collab/home-missing-role.png"], }, client=FakeNoBindClient(), ) self.session.refresh(order) assert order.status == collab.STATUS_INCOMPLETE payload = collab.serialize_one(self.session, order) assert "绑定角色(先校验账号)" in payload["missing_fields"] DouyuCollabOrderOut.model_validate(payload) def test_done_order_is_not_counted_again_in_group_points(self): first = collab.create_order( self.session, self.admin, order_no="DY-007", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-5.png"], client=FakeClient(), ) second = collab.create_order( self.session, self.admin, order_no="DY-008", shop="店铺A", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-6.png"], client=FakeClient(), ) assert collab.group_points_total(self.session, second) == 200 collab.set_status( self.session, self.admin, first, status=collab.STATUS_DONE, reason="已兑换", ) assert collab.group_points_total(self.session, second) == 100 def test_goods_normalization_keeps_zero_values(self): goods = collab.serialize_live_goods( [ { "commodityId": "gift-23", "commodityName": "23返场礼包", "score": 8000, "status": 0, "openStatus": 0, "startTime": "1792749600", "endTime": "1793375999", "mark": "限时", "count": 2000, } ] ) assert goods[0]["status"] == "0" assert goods[0]["open_status"] == 0 assert goods[0]["start_time"] == 1792749600 assert goods[0]["is_limited"] is True def test_shop_rename_cascades_and_delete_rejects_in_use(self): shop = collab.create_shop(self.session, self.admin, name="店铺B", remark="测试") order = collab.create_order( self.session, self.admin, order_no="DY-009", shop="店铺B", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-7.png"], client=FakeClient(), ) collab.update_shop( self.session, self.admin, shop, {"name": "店铺B-改名", "is_active": False}, ) self.session.refresh(order) assert order.shop == "店铺B-改名" assert shop.is_active is False with pytest.raises(collab.CollabError): collab.delete_shop(self.session, self.admin, shop) collab.delete_order(self.session, self.admin, order) assert collab.delete_shop(self.session, self.admin, shop)["success"] is True def test_ck_status_filter_and_summary_count_invalid(self): order = collab.create_order( self.session, self.admin, order_no="DY-010", shop="店铺C", account_username="douyu-account-a", gift_name="礼包A", required_points=100, home_images=["collab/home-8.png"], client=FakeClient(), ) self.account.ck_check_status = collab.CK_INVALID self.session.commit() invalid = collab.list_orders(self.session, ck_status=collab.CK_INVALID) assert [item["id"] for item in invalid["items"]] == [order.id] assert collab.list_orders(self.session, ck_status=collab.CK_VALID)["total"] == 0 assert collab.summary(self.session)["ck_invalid"] == 1 def test_export_cks_reads_linked_account_and_skips_missing_cookie(self): first = collab.create_order( self.session, self.admin, order_no="DY-EXP-1", account_username="douyu-account-a", draft=True, ) blank_account = Account( username="douyu-account-blank", password="password", email="blank@example.com", email_password="", cookie="", ) self.session.add(blank_account) self.session.commit() blank = collab.create_order( self.session, self.admin, order_no="DY-EXP-2", account_username="douyu-account-blank", draft=True, ) missing = collab.create_order( self.session, self.admin, order_no="DY-EXP-3", account_username="douyu-account-missing", draft=True, ) self.account.ck_check_status = collab.CK_VALID self.session.commit() result = collab.export_cks( self.session, self.admin, [first.id, blank.id, missing.id], ) assert result["total"] == 3 assert result["exported"] == 1 assert result["items"][0]["order_no"] == "DY-EXP-1" assert result["items"][0]["ck_text"] == self.account.cookie assert result["items"][0]["account_username"] == self.account.username assert result["items"][0]["account_password"] == "password" assert result["items"][0]["ck_status_label"] == "CK 正常" assert [item["order_no"] for item in result["skipped"]] == [ "DY-EXP-2", "DY-EXP-3", ] assert "没有 CK" in result["skipped"][0]["reason"] assert "还没绑定" in result["skipped"][1]["reason"] DouyuCollabCkExportOut.model_validate(result) def test_export_ck_audit_never_contains_the_cookie_body(self): order = collab.create_order( self.session, self.admin, order_no="DY-EXP-4", account_username="douyu-account-a", draft=True, ) collab.export_cks(self.session, self.admin, [order.id]) audit = ( self.session.query(AuditLog) .filter(AuditLog.action == collab.CK_EXPORT_ACTION) .order_by(AuditLog.id.desc()) .first() ) assert audit is not None assert audit.username == self.admin.username assert order.order_no in audit.detail assert "douyu-account-a" in audit.detail assert self.account.cookie not in audit.detail def test_export_cks_rejects_empty_and_too_many(self): with pytest.raises(collab.CollabError) as excinfo: collab.export_cks(self.session, self.admin, []) assert excinfo.value.code == "ck_export_empty" with pytest.raises(collab.CollabError) as excinfo: collab.export_cks( self.session, self.admin, list(range(1, collab.CK_EXPORT_BATCH_MAX + 2)), ) assert excinfo.value.code == "ck_export_too_large" def test_single_row_copy_is_super_admin_only(self): operator = User( username="douyu-collab-operator", password_hash="hash", role="operation", is_active=True, ) self.session.add(operator) self.session.commit() order = collab.create_order( self.session, self.admin, order_no="DY-EXP-5", account_username="douyu-account-a", draft=True, ) result = collab_api.copy_external_order_ck(order.id, self.session, self.admin) assert result["exported"] == 1 assert result["items"][0]["ck_text"] == self.account.cookie assert result["items"][0]["account_password"] == "password" with pytest.raises(collab_api.HTTPException) as excinfo: collab_api.copy_external_order_ck(order.id, self.session, operator) assert excinfo.value.status_code == 403 def test_export_usernames_dedupes_and_skips_empty(self): first = collab.create_order( self.session, self.admin, order_no="DY-USER-1", account_username="douyu-account-a", draft=True, ) second = collab.create_order( self.session, self.admin, order_no="DY-USER-2", account_username="douyu-account-a", draft=True, ) blank = collab.create_order( self.session, self.admin, order_no="DY-USER-3", draft=True, ) result = collab.export_usernames( self.session, [first.id, second.id, blank.id], ) assert result["total"] == 3 assert result["exported"] == 2 assert result["unique"] == 1 assert result["usernames"] == ["douyu-account-a"] assert [item["order_no"] for item in result["items"]] == [ "DY-USER-1", "DY-USER-2", ] assert result["skipped"] == [ { "id": blank.id, "order_no": "DY-USER-3", "reason": "这单还没填斗鱼用户名", } ] DouyuCollabUsernameExportOut.model_validate(result) def test_export_usernames_rejects_empty_and_too_many(self): with pytest.raises(collab.CollabError) as excinfo: collab.export_usernames(self.session, []) assert excinfo.value.code == "username_export_empty" with pytest.raises(collab.CollabError) as excinfo: collab.export_usernames( self.session, list(range(1, collab.USERNAME_EXPORT_BATCH_MAX + 2)), ) assert excinfo.value.code == "username_export_too_large" def test_ck_export_permission_defaults_to_operation(self): from web.backend.permissions import ROLE_PERMISSIONS assert "douyu:collab:ck_export" in ROLE_PERMISSIONS["operation"] assert "douyu:collab:ck_export" in ROLE_PERMISSIONS["super_admin"] assert "douyu:collab:ck_export" not in ROLE_PERMISSIONS["support"] def test_batch_verify_returns_ck_and_binding_role_results(self, monkeypatch): first = collab.create_order( self.session, self.admin, order_no="DY-BATCH-VERIFY-1", account_username="douyu-account-a", draft=True, ) second = collab.create_order( self.session, self.admin, order_no="DY-BATCH-VERIFY-2", account_username="douyu-account-a", draft=True, ) orders = {first.id: first, second.id: second} monkeypatch.setattr( collab, "get_order", lambda _db, order_id: orders[order_id], ) def fake_verify(_db, _current, order): if order.id == first.id: probe = { "ok": True, "ck_status": collab.CK_VALID, "bind_game_role": "角色A", "message": "", } else: probe = { "ok": False, "ck_status": collab.CK_VALID, "bind_game_role": "", "message": "绑定角色: 未绑定", } return {"order": order, "probe": probe} monkeypatch.setattr(collab, "verify_order", fake_verify) monkeypatch.setattr( collab_api, "_publish_change", lambda *_args, **_kwargs: None ) result = collab_api.verify_external_orders_batch( [first.id, second.id], db=self.session, current=self.admin, ) assert result["success"] is True assert result["results"][0] == { "id": first.id, "success": True, "ok": True, "ck_status": collab.CK_VALID, "role": "角色A", "role_ok": True, "message": "", } assert result["results"][1] == { "id": second.id, "success": True, "ok": False, "ck_status": collab.CK_VALID, "role": "", "role_ok": False, "message": "绑定角色: 未绑定", } def test_douyu_collab_routes_registered(self): from web.backend.main import app paths = app.openapi()["paths"] assert "/api/douyu/external-orders" in paths assert "/api/douyu/external-orders/{order_id}/status" in paths assert "/api/douyu/external-orders/status/batch" in paths assert "/api/douyu/external-orders/verify/batch" in paths assert "/api/douyu/external-orders/accounts/lookup" in paths assert "/api/douyu/external-orders/ck/export" in paths assert "/api/douyu/external-orders/{order_id}/ck/copy" in paths assert "/api/douyu/external-orders/usernames/export" in paths assert "/api/douyu/external-orders/balances/query" in paths assert "/api/douyu/external-orders/{order_id}/balances/query" in paths assert "/api/douyu/external-orders/activity/query" in paths assert "/api/douyu/external-orders/{order_id}/activity/query" in paths assert "/api/douyu/collab-shops/{shop_id}" in paths assert "put" in paths["/api/douyu/collab-shops/{shop_id}"] assert "delete" in paths["/api/douyu/collab-shops/{shop_id}"] assert "/api/douyu/collab-gifts" in paths assert "get" in paths["/api/douyu/collab-gifts"] assert "post" in paths["/api/douyu/collab-gifts"] assert "/api/douyu/collab-gifts/{gift_id}" in paths assert "put" in paths["/api/douyu/collab-gifts/{gift_id}"] assert "delete" in paths["/api/douyu/collab-gifts/{gift_id}"]