修复(半自动履约): 收口虎牙确认恢复与任务切换
This commit is contained in:
+19
-6
@@ -3,16 +3,16 @@ type: 权威架构与实施计划
|
||||
description: 订单、内部 SKU、履约路由、履约执行、商品、成本与财务的唯一权威口径及重构计划。
|
||||
tags: [订单, 内部SKU, 履约, 商品, 成本, 财务, 迁移]
|
||||
status: authoritative
|
||||
version: 2.31
|
||||
updated_at: 2026-11-19
|
||||
version: 2.32
|
||||
updated_at: 2026-11-20
|
||||
---
|
||||
|
||||
# 统一订单、履约与财务模型
|
||||
|
||||
> 状态:**唯一权威文档**。
|
||||
> 最后校准:2026-11-19。
|
||||
> 最后校准:2026-11-20。
|
||||
> 生产基线:迁移 `175`(2026-11-19 核对)。
|
||||
> 开发基线:迁移 `177`(仅本地,尚未部署生产)。
|
||||
> 开发基线:迁移 `178`(仅本地,尚未部署生产)。
|
||||
>
|
||||
> 从本文件生效起,订单、内部 SKU、履约渠道、履约载体、标准商品、成本和财务相关实现,
|
||||
> 只能以本文件为业务口径。其他旧分析只作为历史资料,不再具备设计或验收效力。
|
||||
@@ -420,7 +420,15 @@ manual fulfillment
|
||||
`flowState / rebindBlockScope / allowedActions`,各写入口不得自行分类。
|
||||
- 外部 Connector 通过签名 Webhook `POST /api/integration/platform-fulfillment/semi-auto/task-state`
|
||||
提交登录与绑定快照,事件 ID 使用 `integration_inbox` 幂等;Connector 只提交平台观察到的事实,
|
||||
不得直接声明业务履约完成。执行状态由登录、绑定和人工确认规则推导。
|
||||
不得直接声明业务履约完成。每个快照必须携带任务级单调 `stateVersion`;同一任务的旧版本或
|
||||
同版本重复快照不得覆盖当前事实。执行状态由登录、绑定和人工确认规则推导。
|
||||
- 虎牙确认绑定必须先持久化 `bind_confirm_state = submitting`,再调用平台写接口;平台受理后持久化
|
||||
`accepted` 与生效截止时间。Connector 重启或请求超时后,以数据库中的 pending 角色和确认状态恢复,
|
||||
只读回查平台角色;current 与 pending 的角色名、区服和 role token 一致后才收敛为 `confirmed`,
|
||||
不得因 Connector 内存丢失重新放行第二次平台写操作。
|
||||
- 人工履约配置切换半自动平台或停用半自动时,必须按当前 `fulfillments.fulfillment_config_id`
|
||||
主动收敛既有任务:旧活动任务先写取消事件并保留为历史,再按新配置创建新的活动任务。
|
||||
同一订单项最多一条非取消任务,取消任务不得阻止后续重新物化。
|
||||
- order_site 与 live-hub 的通信职责必须区分:
|
||||
① order_site → live-hub 的正常路径走事务 `integration_outbox`,事件必须携带目标订单项的有界
|
||||
业务快照和稳定去重指纹,由 worker 投递签名
|
||||
@@ -1168,7 +1176,7 @@ docs/archive/
|
||||
|
||||
## 十三、当前下一步
|
||||
|
||||
截至 2026-11-19,生产基线为 `175`,当前开发基线为 `176`。迁移 `152` 保护订单来源快照,
|
||||
截至 2026-11-20,生产基线为 `175`,当前开发基线为 `178`。迁移 `152` 保护订单来源快照,
|
||||
迁移 `158–160` 收口寄卖登记人同步、寄卖平台与自动匹配设置;
|
||||
迁移 `161` 一次建立人工渠道半自动任务、内置 Connector 默认值、账号级 Cookie JSON 凭证、
|
||||
任务凭证引用和最终约束;迁移 `162` 建立履约待办四桶只读投影、补载体专用索引和新单优先扫描口径。
|
||||
@@ -1190,6 +1198,11 @@ pending 角色快照、`role_identity_source` 与 `verification_basis`。
|
||||
确认与换绑请求状态及二维码/生效时间;同时修复“登录成功但绑定未确认却进入 `waiting_operator`”
|
||||
和“未确认任务过早写入 `bound_at`”的历史错位。结构化快照仍只提交平台观察到的事实,
|
||||
执行状态与完成门禁由统一决策器重新推导。
|
||||
迁移 `178` 为外部 Connector 快照增加任务级 `connector_state_version` 单调闸门,将同一订单项约束
|
||||
收敛为“最多一条非取消任务”,并重新核对历史 `waiting_operator + confirmed` 任务:客户资料缺失、
|
||||
区服无法解析或角色名/区服不一致时退出客服待办,进入客户补资料或换绑流程;无取消任务的唯一索引
|
||||
允许旧任务保留审计、新配置创建新的活动任务。确认绑定写平台前先持久化 `submitting`,重启或超时后
|
||||
只按数据库 pending 与平台 current 回查收敛,不得重复提交平台写操作。
|
||||
迁移 `169` 增加客户游戏角色资料三项(`customer_game_role_name` / `customer_game_role_id` /
|
||||
`customer_game_server_zone`),并允许从工单素材回退合并;客户页流程收敛为
|
||||
「登录 → 填写资料 → 绑定角色」,资料未填全不得生成绑定二维码。
|
||||
|
||||
Reference in New Issue
Block a user