修复(半自动履约): 收口虎牙绑定为单一状态机

This commit is contained in:
yml
2026-11-19 15:32:03 +08:00
parent b9dadf2e02
commit 4c64967145
21 changed files with 2691 additions and 613 deletions
@@ -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`),并允许从工单素材回退合并;客户页流程收敛为
「登录 → 填写资料 → 绑定角色」,资料未填全不得生成绑定二维码。