feat(fulfillment): 新增直播账号履约工作台

This commit is contained in:
yml
2026-11-17 14:44:28 +08:00
parent f8a35ec224
commit 1ca768eba5
30 changed files with 3729 additions and 27 deletions
+12 -3
View File
@@ -11,8 +11,9 @@ import os
import time
from collections.abc import Iterator
from contextlib import contextmanager
from datetime import UTC, datetime
from datetime import UTC, datetime, timedelta
import pytest
from sqlalchemy.orm import sessionmaker
import web.backend.database as database_module
@@ -30,8 +31,15 @@ def _force_non_utc_timezone(name: str = "Asia/Shanghai") -> Iterator[None]:
只有开发机(UTC+8)才现形 —— 而「只在某些机器上失败」的测试等于没有测试。
"""
previous = os.environ.get("TZ")
can_change_tz = hasattr(time, "tzset")
os.environ["TZ"] = name
time.tzset()
if can_change_tz:
time.tzset()
elif (datetime.now().astimezone().utcoffset() or timedelta()) == timedelta():
os.environ.pop("TZ", None)
if previous is not None:
os.environ["TZ"] = previous
pytest.skip("当前 Python 运行时缺少 time.tzset,且宿主机为 UTC")
try:
yield
finally:
@@ -39,7 +47,8 @@ def _force_non_utc_timezone(name: str = "Asia/Shanghai") -> Iterator[None]:
os.environ.pop("TZ", None)
else:
os.environ["TZ"] = previous
time.tzset()
if can_change_tz:
time.tzset()
class _Base:
+1 -1
View File
@@ -35,7 +35,7 @@ TESTS_DIR = Path(__file__).resolve().parent
PROJECT_ROOT = TESTS_DIR.parent
VERSIONS_DIR = PROJECT_ROOT / "web" / "backend" / "migrations" / "versions"
HEAD_REVISION = "20261113_0082"
HEAD_REVISION = "20261117_0084"
# 迁移新增、但不声明在模型里的复合查询索引。
EXTRA_INDEXES = (
+399
View File
@@ -0,0 +1,399 @@
"""直播账号履约:订单同步、映射、选号、绑码状态和人工完成。"""
from __future__ import annotations
from datetime import UTC, datetime, timedelta
import pytest
from tests.support.db import get_test_engine, make_test_session
from web.backend.models import (
Account,
AccountLease,
AutomationJob,
DouyuGoodsSnapshot,
DouyuTask,
PlatformCommodityMapping,
PlatformFulfillmentTask,
User,
)
from web.backend.services.automation.jobs import platform_fulfillment_lease_reaper as reaper
from web.backend.services.platform_fulfillment import account_selector, service
NOW = datetime.now(UTC).replace(microsecond=0)
COMMODITY = "20260120QYOOB_bag10"
INTERNAL_SKU = "套装-兔兔白日梦"
class _Base:
def setup_method(self):
self.engine = get_test_engine()
self.session = make_test_session(self.engine)
self.admin = User(
username="pf-admin",
password_hash="h",
role="super_admin",
)
self.session.add(self.admin)
self.session.commit()
self.admin_id = self.admin.id
def teardown_method(self):
self.session.close()
def account(
self,
name: str,
*,
points: int = 2000,
opened: bool = True,
role_available_at: datetime | None = None,
) -> Account:
row = Account(
username=name,
password="p",
email=f"{name}@example.com",
email_password="ep",
status="active",
ck_check_status="valid",
cookie="PHPSESSID=x",
elite_opened=opened,
points=points,
gold_balance=100,
auto_managed=True,
role_change_available_at=role_available_at,
)
self.session.add(row)
self.session.commit()
return row
def mapping(self, enabled: bool = True) -> PlatformCommodityMapping:
row = PlatformCommodityMapping(
target_platform="douyu",
internal_sku_key=INTERNAL_SKU,
commodity_id=COMMODITY,
goods_name=INTERNAL_SKU,
required_points=1280,
scope="elite",
enabled=enabled,
created_by=self.admin_id,
created_at=NOW,
updated_at=NOW,
)
self.session.add(row)
self.session.commit()
return row
def task(self, *, mapped: bool = True) -> PlatformFulfillmentTask:
mapping = self.mapping() if mapped else None
row = PlatformFulfillmentTask(
source_system="order_site",
source_order_id="100",
source_order_item_id="101",
source_fulfillment_id="201",
platform_order_id="ORDER-101",
provider="91kaquan",
shop_id="shop-1",
shop_name="测试店",
sku_code=INTERNAL_SKU,
sku_name=INTERNAL_SKU,
internal_sku_key=INTERNAL_SKU,
quantity=1,
order_amount_fen=9900,
target_platform="douyu",
scope="elite",
commodity_mapping_id=mapping.id if mapping else None,
commodity_id=COMMODITY if mapping else "",
required_points=1280 if mapping else None,
binding_status="not_started",
execution_status="ready" if mapping else "pending_mapping",
exchange_status="not_started",
source_snapshot_json={"order_no": "ORDER-101"},
created_at=NOW,
updated_at=NOW,
)
self.session.add(row)
self.session.commit()
return row
class TestSyncAndMapping(_Base):
def test_sync_creates_pending_mapping_task(self, monkeypatch):
monkeypatch.setattr(
service,
"list_pending_manual_fulfillments",
lambda limit: [
{
"source_system": "order_site",
"source_order_id": "100",
"source_order_item_id": "101",
"source_fulfillment_id": "201",
"platform_order_id": "ORDER-101",
"provider": "91kaquan",
"shop_id": "shop-1",
"shop_name": "测试店",
"sku_code": INTERNAL_SKU,
"sku_name": INTERNAL_SKU,
"internal_sku_key": INTERNAL_SKU,
"quantity": 1,
"revenue_amount_fen": 9900,
"total_amount": 9900,
"paid_at": NOW,
"item_updated_at": NOW,
}
],
)
result = service.sync_pending_tasks(self.session, limit=10)
assert result["created"] == 1
task = self.session.query(PlatformFulfillmentTask).one()
assert task.execution_status == "pending_mapping"
assert task.internal_sku_key == INTERNAL_SKU
assert task.order_amount_fen == 9900
def test_sync_is_idempotent_and_applies_mapping(self, monkeypatch):
self.mapping()
monkeypatch.setattr(
service,
"list_pending_manual_fulfillments",
lambda limit: [
{
"source_order_id": "100",
"source_order_item_id": "101",
"source_fulfillment_id": "201",
"platform_order_id": "ORDER-101",
"provider": "91kaquan",
"shop_id": "shop-1",
"shop_name": "测试店",
"sku_code": INTERNAL_SKU,
"sku_name": INTERNAL_SKU,
"internal_sku_key": INTERNAL_SKU,
"quantity": 1,
"revenue_amount_fen": 9900,
"total_amount": 9900,
"paid_at": NOW,
"item_updated_at": NOW,
}
],
)
first = service.sync_pending_tasks(self.session, limit=10)
second = service.sync_pending_tasks(self.session, limit=10)
assert first["created"] == 1
assert second["created"] == 0
assert self.session.query(PlatformFulfillmentTask).count() == 1
task = self.session.query(PlatformFulfillmentTask).one()
assert task.execution_status == "ready"
assert task.commodity_id == COMMODITY
def test_upsert_mapping_advances_existing_task(self):
task = self.task(mapped=False)
self.session.add(
DouyuGoodsSnapshot(
commodity_id=COMMODITY,
name=INTERNAL_SKU,
score=1280,
)
)
self.session.commit()
service.upsert_mapping(
self.session,
internal_sku_key=INTERNAL_SKU,
commodity_id=COMMODITY,
goods_name="",
required_points=None,
enabled=True,
current=self.admin,
)
self.session.refresh(task)
assert task.execution_status == "ready"
assert task.commodity_id == COMMODITY
assert task.required_points == 1280
class TestAccountSelection(_Base):
def test_eligible_account_excludes_cooldown_and_uses_least_points(self):
self.account("small", points=1300)
self.account("large", points=9000)
self.account(
"cooldown",
points=1400,
role_available_at=NOW + timedelta(days=1),
)
candidates = account_selector.eligible_accounts(
self.session,
commodity_id=COMMODITY,
required_points=1280,
now=NOW,
)
assert [row.username for row in candidates] == ["small", "large"]
def test_lease_is_unique_per_account(self):
account = self.account("leased")
candidate = account_selector.eligible_accounts(
self.session,
commodity_id=COMMODITY,
required_points=1280,
now=NOW,
)[0]
first = account_selector.lease_account(
self.session,
candidate=candidate,
holder_user_id=self.admin_id,
task_id=1,
commodity_id=COMMODITY,
now=NOW,
)
second = account_selector.lease_account(
self.session,
candidate=candidate,
holder_user_id=self.admin_id,
task_id=2,
commodity_id=COMMODITY,
now=NOW,
)
assert first is not None
assert second is None
assert self.session.query(AccountLease).filter_by(account_id=account.id).count() == 1
def test_allocate_and_release_task(self):
account = self.account("allocated")
task = self.task()
detail = service.allocate_task(
self.session,
task_id=task.id,
current=self.admin,
)
assert detail["task"]["account"]["id"] == account.id
assert detail["task"]["executionStatus"] == "allocated"
lease = self.session.query(AccountLease).one()
assert lease.purpose == "platform_fulfillment"
assert lease.status == "active"
released = service.release_task_account(
self.session,
task_id=task.id,
current=self.admin,
)
assert released["task"]["executionStatus"] == "ready"
self.session.refresh(lease)
assert lease.status == "released"
class TestBindingAndCompletion(_Base):
def _allocated(self):
self.account("bind-account")
task = self.task()
service.allocate_task(self.session, task_id=task.id, current=self.admin)
self.session.refresh(task)
return task
def test_refresh_binding_maps_role_ready(self):
task = self._allocated()
bind_task = DouyuTask(
batch_id="bind-1",
account_id=task.account_id,
account_assigned_to=self.admin_id,
task_type="get_bind_qr",
handbook_scope="elite",
status="success",
result={"url": "https://example.com/qr", "role_name": "测试角色"},
created_by=self.admin_id,
)
self.session.add(bind_task)
self.session.flush()
task.bind_task_id = bind_task.id
task.binding_status = "preparing"
task.execution_status = "waiting_bind"
self.session.commit()
detail = service.refresh_binding(self.session, task_id=task.id)
assert detail["task"]["bindingStatus"] == "role_ready"
assert detail["task"]["bindTask"]["roleName"] == "测试角色"
def test_list_hides_qr_but_detail_returns_it(self):
task = self._allocated()
bind_task = DouyuTask(
batch_id="bind-qr",
account_id=task.account_id,
account_assigned_to=self.admin_id,
task_type="get_bind_qr",
handbook_scope="elite",
status="running",
result={"url": "https://example.com/private-qr"},
created_by=self.admin_id,
)
self.session.add(bind_task)
self.session.flush()
task.bind_task_id = bind_task.id
task.binding_status = "qr_pending"
task.execution_status = "waiting_bind"
self.session.commit()
listed = service.list_tasks(self.session)
detail = service.get_task_detail(self.session, task.id)
assert listed["items"][0]["bindTask"]["qrUrl"] == ""
assert detail["task"]["bindTask"]["qrUrl"] == "https://example.com/private-qr"
def test_manual_completion_requires_bound_and_releases_lease(self):
task = self._allocated()
task.binding_status = "bound"
task.execution_status = "bound"
task.exchange_status = "eligible"
self.session.commit()
detail = service.complete_manual_exchange(
self.session,
task_id=task.id,
current=self.admin,
note="人工兑换完成",
)
assert detail["task"]["executionStatus"] == "completed"
assert detail["task"]["exchangeStatus"] == "manual_done"
lease = self.session.query(AccountLease).one()
assert lease.status == "released"
def test_expired_lease_moves_unfinished_task_to_manual(self):
task = self._allocated()
lease = self.session.query(AccountLease).one()
lease.expires_at = NOW - timedelta(minutes=1)
self.session.commit()
job = AutomationJob(key=reaper.JOB_KEY, batch_size=100)
result = reaper.run_platform_fulfillment_lease_reaper(
self.session,
job,
now=NOW,
)
self.session.refresh(task)
assert result["expired"] == 1
assert task.execution_status == "manual_required"
assert task.issue_code == "lease_expired"
def test_completion_rejects_limited_exchange(self):
task = self._allocated()
task.binding_status = "bound"
task.execution_status = "manual_required"
task.exchange_status = "limited"
self.session.commit()
with pytest.raises(Exception):
service.complete_manual_exchange(
self.session,
task_id=task.id,
current=self.admin,
)