修复(半自动履约): 收口虎牙绑定为单一状态机
This commit is contained in:
+15
-3
@@ -3,16 +3,16 @@ type: 权威架构与实施计划
|
||||
description: 订单、内部 SKU、履约路由、履约执行、商品、成本与财务的唯一权威口径及重构计划。
|
||||
tags: [订单, 内部SKU, 履约, 商品, 成本, 财务, 迁移]
|
||||
status: authoritative
|
||||
version: 2.30
|
||||
version: 2.31
|
||||
updated_at: 2026-11-19
|
||||
---
|
||||
|
||||
# 统一订单、履约与财务模型
|
||||
|
||||
> 状态:**唯一权威文档**。
|
||||
> 最后校准:2026-11-18。
|
||||
> 最后校准:2026-11-19。
|
||||
> 生产基线:迁移 `175`(2026-11-19 核对)。
|
||||
> 开发基线:迁移 `176`(仅本地,尚未部署生产)。
|
||||
> 开发基线:迁移 `177`(仅本地,尚未部署生产)。
|
||||
>
|
||||
> 从本文件生效起,订单、内部 SKU、履约渠道、履约载体、标准商品、成本和财务相关实现,
|
||||
> 只能以本文件为业务口径。其他旧分析只作为历史资料,不再具备设计或验收效力。
|
||||
@@ -411,6 +411,13 @@ manual fulfillment
|
||||
- 角色文本、区服和身份比对只能使用公共账号绑定策略层;虎牙、斗鱼 Adapter 只把平台事实映射成
|
||||
统一字段,不得各自实现另一套空格、大小写或区服匹配规则。平台 Adapter 仍可保留各自的登录、
|
||||
二维码、换绑、冷却和错误协议,公共层不得直接调用平台 RPC。
|
||||
- 虎牙绑定流程、客服执行状态和完成门禁只有一个业务判断入口
|
||||
`resolveHuyaBindingDecision`;任务 DTO、客户页、后台详情、外部 Connector 快照和完成事务只能消费
|
||||
该结果,不得再按 `binding_status`、pending 字段或角色字段自行推导第二套流程。
|
||||
原始 `binding_status = confirmed` 只表示 Connector 观察到的平台事实;只有决策器输出
|
||||
`flowState = confirmed` 且 `canCompleteTask = true` 时才允许进入 `waiting_operator` 或完成履约。
|
||||
账号侧冷却、目标角色侧冷却、换绑拒绝、目标不一致和绑定标志不完整分别由决策器输出对应的
|
||||
`flowState / rebindBlockScope / allowedActions`,各写入口不得自行分类。
|
||||
- 外部 Connector 通过签名 Webhook `POST /api/integration/platform-fulfillment/semi-auto/task-state`
|
||||
提交登录与绑定快照,事件 ID 使用 `integration_inbox` 幂等;Connector 只提交平台观察到的事实,
|
||||
不得直接声明业务履约完成。执行状态由登录、绑定和人工确认规则推导。
|
||||
@@ -1178,6 +1185,11 @@ docs/archive/
|
||||
迁移 `168` 曾新增 `bind_game_role_id`,后续生产事实证实现行虎牙返回的是加密 role token;
|
||||
迁移 `176` 将其语义拆分并冻结旧字段,新增 `bind_game_role_token`、`platform_game_role_uid`、
|
||||
pending 角色快照、`role_identity_source` 与 `verification_basis`。
|
||||
迁移 `177` 持久化虎牙账号角色标志、账号侧换绑窗口、唯一决策器输出的
|
||||
`binding_flow_state / account_role_state / target_role_match / rebind_block_scope`、
|
||||
确认与换绑请求状态及二维码/生效时间;同时修复“登录成功但绑定未确认却进入 `waiting_operator`”
|
||||
和“未确认任务过早写入 `bound_at`”的历史错位。结构化快照仍只提交平台观察到的事实,
|
||||
执行状态与完成门禁由统一决策器重新推导。
|
||||
迁移 `169` 增加客户游戏角色资料三项(`customer_game_role_name` / `customer_game_role_id` /
|
||||
`customer_game_server_zone`),并允许从工单素材回退合并;客户页流程收敛为
|
||||
「登录 → 填写资料 → 绑定角色」,资料未填全不得生成绑定二维码。
|
||||
|
||||
Reference in New Issue
Block a user