feat(fulfillment): 新增直播账号履约工作台
This commit is contained in:
@@ -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:
|
||||
|
||||
@@ -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 = (
|
||||
|
||||
@@ -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,
|
||||
)
|
||||
Reference in New Issue
Block a user