Files
live-hub-py/tests/test_douyu_collab_orders.py
T

1816 lines
61 KiB
Python

"""斗鱼外部单协作:账号导入、状态机、鱼翅/积分与兑换记录查询。"""
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}"]