feat(douyu): 锁定成功订单购买信息
This commit is contained in:
@@ -181,6 +181,18 @@ STATUS_TIMESTAMP_FIELDS = {
|
||||
STATUS_DONE: "done_at",
|
||||
}
|
||||
|
||||
# 成功订单已经锁定购买事实。这些字段一旦变更,会让订单号、购买账号或
|
||||
# 兑换商品与后续核账/审计不一致,因此只允许超级管理员显式确认后修改。
|
||||
SUCCESS_PURCHASE_FIELDS = frozenset(
|
||||
{
|
||||
"order_no",
|
||||
"account_username",
|
||||
"gift_name",
|
||||
"commodity_id",
|
||||
"required_points",
|
||||
}
|
||||
)
|
||||
|
||||
ARCHIVABLE_STATUSES = (STATUS_DONE,)
|
||||
# 同一账号核账只统计“还没有完成兑换”的单:done/scripted 不重复占积分。
|
||||
POINTS_GROUP_STATUSES: tuple[str, ...] = (
|
||||
@@ -236,6 +248,14 @@ def _text(value: Any, *, max_length: int | None = None) -> str:
|
||||
return text[:max_length] if max_length else text
|
||||
|
||||
|
||||
def _mark_order_succeeded(
|
||||
order: DouyuExternalOrder, when: datetime | None = None
|
||||
) -> None:
|
||||
"""记录首次成功时间;状态回退不能清掉这条购买锁定依据。"""
|
||||
if order.succeeded_at is None:
|
||||
order.succeeded_at = when or _now()
|
||||
|
||||
|
||||
def _json_safe(value: Any) -> Any:
|
||||
if isinstance(value, dict):
|
||||
return {str(k): _json_safe(v) for k, v in value.items()}
|
||||
@@ -531,6 +551,7 @@ def unlink_account(
|
||||
) -> DouyuExternalOrder:
|
||||
"""解除协作单与账号的关联,但不删除内部账号。"""
|
||||
_assert_account_replace_permission(current)
|
||||
_assert_success_account_change_allowed(current, order)
|
||||
_assert_account_replaceable(order)
|
||||
_assert_version(order, expected_version)
|
||||
if not order.account_id and not _text(order.account_username):
|
||||
@@ -949,6 +970,17 @@ def _assert_account_replaceable(order: DouyuExternalOrder) -> None:
|
||||
)
|
||||
|
||||
|
||||
def _assert_success_account_change_allowed(
|
||||
current: User, order: DouyuExternalOrder
|
||||
) -> None:
|
||||
if order.succeeded_at is not None and current.role != "super_admin":
|
||||
raise CollabError(
|
||||
"订单已有成功记录,购买账号仅允许超级管理员修改",
|
||||
status_code=403,
|
||||
code="purchase_lock_admin_required",
|
||||
)
|
||||
|
||||
|
||||
def _order_occupies_account(order: DouyuExternalOrder) -> bool:
|
||||
return (
|
||||
bool(order.account_id)
|
||||
@@ -1795,6 +1827,7 @@ def _apply_platform_fulfillment_status(
|
||||
if task.execution_status == "completed":
|
||||
order.status = STATUS_DONE
|
||||
order.done_at = order.done_at or task.completed_at or _now()
|
||||
_mark_order_succeeded(order, order.done_at)
|
||||
elif task.execution_status == "cancelled":
|
||||
order.status = STATUS_VOID
|
||||
order.void_reason = order.void_reason or "直播履约任务已取消"
|
||||
@@ -1808,6 +1841,7 @@ def _apply_platform_fulfillment_status(
|
||||
):
|
||||
order.status = STATUS_DONE
|
||||
order.done_at = order.done_at or task.completed_at or _now()
|
||||
_mark_order_succeeded(order, order.done_at)
|
||||
elif task.execution_status == "cancelled" and order.status != STATUS_VOID:
|
||||
order.status = STATUS_VOID
|
||||
order.void_reason = order.void_reason or "直播履约任务已取消"
|
||||
@@ -2051,6 +2085,7 @@ def update_order(
|
||||
_assert_version(order, expected_version)
|
||||
previous_account_id = int(order.account_id or 0)
|
||||
changes: dict[str, dict[str, Any]] = {}
|
||||
pending: dict[str, Any] = {}
|
||||
editable = {
|
||||
"order_no",
|
||||
"shop",
|
||||
@@ -2086,9 +2121,28 @@ def update_order(
|
||||
)
|
||||
else:
|
||||
new = _text(payload[field], max_length=512 if field == "remark" else 128)
|
||||
pending[field] = new
|
||||
if new != old:
|
||||
changes[field] = {"old": old, "new": new}
|
||||
setattr(order, field, new)
|
||||
|
||||
if order.succeeded_at is not None:
|
||||
locked_changes = SUCCESS_PURCHASE_FIELDS.intersection(changes)
|
||||
if locked_changes:
|
||||
if current.role != "super_admin":
|
||||
raise CollabError(
|
||||
"订单已有成功记录,购买信息仅允许超级管理员修改",
|
||||
status_code=403,
|
||||
code="purchase_lock_admin_required",
|
||||
)
|
||||
if payload.get("confirm_purchase_change") is not True:
|
||||
raise CollabError(
|
||||
"修改成功订单的购买信息需要二次确认",
|
||||
status_code=409,
|
||||
code="purchase_change_confirmation_required",
|
||||
)
|
||||
|
||||
for field, new in pending.items():
|
||||
setattr(order, field, new)
|
||||
if "account_username" in payload and (
|
||||
order.account_id is None
|
||||
or not order.bind_game_role
|
||||
@@ -2190,6 +2244,7 @@ def set_account(
|
||||
commit: bool = True,
|
||||
) -> dict[str, Any]:
|
||||
_assert_mutable(order)
|
||||
_assert_success_account_change_allowed(current, order)
|
||||
_assert_version(order, expected_version)
|
||||
account = account_by_username(db, username)
|
||||
if account is None:
|
||||
@@ -2371,6 +2426,8 @@ def _restore_void_status(
|
||||
setattr(order, field, _now())
|
||||
|
||||
order.status = target
|
||||
if target == STATUS_DONE:
|
||||
_mark_order_succeeded(order)
|
||||
order.void_reason = ""
|
||||
order.updated_by = current.id
|
||||
order.version = int(order.version or 0) + 1
|
||||
@@ -2544,6 +2601,8 @@ def set_status(
|
||||
allow_missing_role=target == STATUS_RECHARGED,
|
||||
)
|
||||
|
||||
if target == STATUS_DONE:
|
||||
_mark_order_succeeded(order, now)
|
||||
if rollback:
|
||||
for name, field in STATUS_TIMESTAMP_FIELDS.items():
|
||||
if STAGE_INDEX.get(name, -1) > target_index:
|
||||
@@ -3379,6 +3438,8 @@ def serialize_order(
|
||||
"recharged_at": order.recharged_at,
|
||||
"scripted_at": order.scripted_at,
|
||||
"done_at": order.done_at,
|
||||
"succeeded_at": order.succeeded_at,
|
||||
"purchase_change_locked": order.succeeded_at is not None,
|
||||
"void_reason": order.void_reason or "",
|
||||
"is_archived": order.archived_at is not None,
|
||||
"archived_at": order.archived_at,
|
||||
|
||||
Reference in New Issue
Block a user