feat(半自动履约): 补齐微博游戏角色绑定流程
This commit is contained in:
+30
-8
@@ -3,7 +3,7 @@ type: 权威架构与实施计划
|
||||
description: 订单、内部 SKU、履约路由、履约执行、商品、成本与财务的唯一权威口径及重构计划。
|
||||
tags: [订单, 内部SKU, 履约, 商品, 成本, 财务, 迁移]
|
||||
status: authoritative
|
||||
version: 2.25
|
||||
version: 2.27
|
||||
updated_at: 2026-11-18
|
||||
---
|
||||
|
||||
@@ -12,7 +12,7 @@ updated_at: 2026-11-18
|
||||
> 状态:**唯一权威文档**。
|
||||
> 最后校准:2026-11-18。
|
||||
> 生产基线:迁移 `166`。
|
||||
> 开发基线:迁移 `167`(仅本地,尚未部署生产)。
|
||||
> 开发基线:迁移 `170`(仅本地,尚未部署生产)。
|
||||
>
|
||||
> 从本文件生效起,订单、内部 SKU、履约渠道、履约载体、标准商品、成本和财务相关实现,
|
||||
> 只能以本文件为业务口径。其他旧分析只作为历史资料,不再具备设计或验收效力。
|
||||
@@ -300,8 +300,9 @@ terminal 已退款、退款申请、平台取消或商业订单已关闭
|
||||
manual fulfillment
|
||||
→ semi_auto_tasks
|
||||
→ 客户登录平台并获取账号 CK
|
||||
→ 客户填写游戏角色资料(区服 / 游戏编号 / 角色名)
|
||||
→ 核对并绑定平台角色
|
||||
→ 平台查询游戏角色与绑定事实
|
||||
→ 客户填写或扫码确认目标游戏角色
|
||||
→ 确认平台角色绑定
|
||||
→ 客服使用 CK 在平台侧手动处理
|
||||
→ confirmManualFulfillment
|
||||
```
|
||||
@@ -349,6 +350,15 @@ manual fulfillment
|
||||
浏览器注入只下发与目标 URL 匹配的 Cookie;账号级凭证保存完整集合,以便导出、会话恢复和跨域重放。
|
||||
- 微博手机号登录首次发码返回 `mfa_1` 时,客户必须在浏览器完成网易易盾安全验证,再使用同一会话的
|
||||
`mfa_id` 重发短信;服务端不尝试绕过或伪造人机验证。
|
||||
- 微博客户页流程固定为「登录 → 查询微博游戏角色 → 微信/QQ 扫码绑定 → 客服处理」:
|
||||
① 登录只代表取得账号 CK,不得直接写入“绑定已确认”;
|
||||
② order_site 读取 `https://vipclub.e.weibo.com/aj/mall/home` 的
|
||||
`data.game_role.is_bound / role_name / can_rebind / rebind_remain_days / bind_url`;
|
||||
③ `is_bound = false` 时使用 `bind_url` 通过来联生成微信或 QQ 小程序绑定二维码,
|
||||
`is_bound = true` 且角色名变化后才收敛为 `binding_status = confirmed`;
|
||||
④ 已绑定且 `can_rebind = false` 时不得生成换绑二维码,必须展示冷却剩余天数;
|
||||
⑤ 绑定二维码是 10 分钟短期会话状态,不单独落库;Connector 重启后以账号级 CK 恢复会话并重新查询
|
||||
`game_role`,已绑定事实照常确认,未绑定事实回到重新生成二维码。
|
||||
- 半自动任务通过 `connector_mode` 显式记录 Connector 来源:
|
||||
`embedded` 为 order_site 内置真实实现并作为默认值,`external` 为显式配置的远程真实实现,
|
||||
`mock` 为 order_site 内置开发 Mock 且仅在非生产环境可用。开发 Mock 造单时默认选择 `embedded`,
|
||||
@@ -373,6 +383,15 @@ manual fulfillment
|
||||
事务提交后才执行报表刷新、Connector 会话撤销等旁路动作。
|
||||
- 半自动履约状态采用与斗鱼领取一致的同步原则:客户操作、Connector 回调和后台操作都是状态快照输入,
|
||||
统一由一个状态收敛服务在任务行锁内写入正式字段并追加事件;多个入口不得各自拼接或覆盖状态。
|
||||
- 账号绑定能力由平台声明,不由页面或业务服务按平台散落判断。虎牙、斗鱼、微博均为 `game_role`:
|
||||
虎牙必需字段 `roleName / roleId / serverZone`,由 order_site 查询、客户比对确认和提交换绑;
|
||||
斗鱼必需字段 `roleName / serverZone`,由 live-hub 查询和提交换绑;
|
||||
微博必需字段 `roleName`,由 order_site 查询,微信/QQ 扫码完成绑定或换绑,不要求客户重复填写角色资料。
|
||||
公共策略还必须声明 `confirmationMode` 与 `rebindMode`:虎牙、斗鱼为客户资料比对确认,
|
||||
微博为平台角色事实确认;虎牙、斗鱼走平台确认换绑,微博走重新扫码换绑。
|
||||
- 角色文本、区服和身份比对只能使用公共账号绑定策略层;虎牙、斗鱼 Adapter 只把平台事实映射成
|
||||
统一字段,不得各自实现另一套空格、大小写或区服匹配规则。平台 Adapter 仍可保留各自的登录、
|
||||
二维码、换绑、冷却和错误协议,公共层不得直接调用平台 RPC。
|
||||
- 外部 Connector 通过签名 Webhook `POST /api/integration/platform-fulfillment/semi-auto/task-state`
|
||||
提交登录与绑定快照,事件 ID 使用 `integration_inbox` 幂等;Connector 只提交平台观察到的事实,
|
||||
不得直接声明业务履约完成。执行状态由登录、绑定和人工确认规则推导。
|
||||
@@ -667,13 +686,15 @@ has_active_cost
|
||||
客户页 `/c/<平台订单号>` 统一展示:
|
||||
|
||||
```text
|
||||
登录 → 填写资料 → 绑定角色 → 客服处理 → 完成
|
||||
登录 → 查询或填写角色资料 → 绑定角色 → 客服处理 → 完成
|
||||
```
|
||||
|
||||
- 三步进度固定为「登录虎牙账号 → 填写游戏资料 → 绑定游戏角色」,当前步骤高亮,已完成为勾选。
|
||||
- 虎牙三步进度固定为「登录虎牙账号 → 填写游戏资料 → 绑定游戏角色」,当前步骤高亮,已完成为勾选。
|
||||
- 登录成功后才展示资料表单;资料三项(区服 / 游戏编号 / 角色名)未填全时不展示绑定二维码。
|
||||
- 绑定角色页展示平台角色与客户资料的逐项对照:三项完全一致才出现「提交平台绑定」;
|
||||
不一致时固定显示「重新扫码换绑」「上一步修改资料」,换绑后仍不一致时以修改资料为主。
|
||||
- 微博登录成功后直接展示微信/QQ 绑定入口;平台返回已绑定角色时直接进入等待客服,
|
||||
未绑定时展示扫码二维码,扫码后重新读取平台角色,角色名发生变化才视为换绑成功。
|
||||
- 页面只能展示客户完成操作所需的最小信息,不得展示 CK、内部成本或其他订单。后台默认只展示平台 UID、
|
||||
凭证来源、健康状态、更新时间、CK 导出和一次性注入入口。CK 导出不依赖绑定状态、任务领取人或
|
||||
额外权限;导出动作必须留审计且不得复用普通详情接口。
|
||||
@@ -1096,7 +1117,7 @@ docs/archive/
|
||||
|
||||
## 十三、当前下一步
|
||||
|
||||
截至 2026-11-17,生产基线为 `166`,集成分支开发基线为 `170`。迁移 `152` 保护订单来源快照,
|
||||
截至 2026-11-18,生产基线为 `166`,集成分支开发基线为 `170`。迁移 `152` 保护订单来源快照,
|
||||
迁移 `158–160` 收口寄卖登记人同步、寄卖平台与自动匹配设置;
|
||||
迁移 `161` 一次建立人工渠道半自动任务、内置 Connector 默认值、账号级 Cookie JSON 凭证、
|
||||
任务凭证引用和最终约束;迁移 `162` 建立履约待办四桶只读投影、补载体专用索引和新单优先扫描口径。
|
||||
@@ -1127,7 +1148,8 @@ docs/archive/
|
||||
再按窗口执行 `--execute --confirm=REBUILD_DERIVED`,并验证第二次重建幂等。
|
||||
5. 观察一个完整财务期间,确认页面、履约、事实和总账持续对平。
|
||||
6. 半自动平台负责客户登录、账号 CK 获取和游戏角色绑定;微博支持手机号登录、易盾二次验证、
|
||||
完整域名 Cookie 保存和会话恢复;虎牙支持客户手动触发的短信验证码登录和扫码登录。
|
||||
完整域名 Cookie 保存、会话恢复、游戏角色查询和微信/QQ 扫码绑定;虎牙支持客户手动触发的
|
||||
短信验证码登录和扫码登录。
|
||||
虎牙客户登录后必须先填写区服 / 游戏编号 / 角色名,再进入绑定;三项与平台角色完全一致
|
||||
才能提交平台绑定,不一致时只能重新扫码换绑或返回上一步修改资料,不提供直接使用原角色的快捷确认。
|
||||
7. 观察期结束后,再单独发布兼容表、旧脚本别名和 `legacy_*` 字段的删除迁移。
|
||||
|
||||
Reference in New Issue
Block a user