docs(plan): 新增自动化与资料收集规划与皮肤准入映射分析

把「CK 全靠人工维护 / 资料靠人转述 / 兑换无台账」整理成分期规划,并基于两套
线上库的实测数据定下关键口径。

数据结论(2026-10-02 实测):
- order_site 271,134 单按履约路由二选一且完全不重叠:A 有 fulfillment_tasks
  85,338 单(88.3% 已 delivered,是发货平台的活)、B 有 work_orders 96,755 单
  (打手)、C 两者都无 89,542 单 —— 只有 C 是「没人管」,才是本系统的目标;
- 斗鱼可兑换商品只有 78 个(皮肤类 60)。C 桶皮肤类 923 个快手商品名映射过去:
  62 个唯一命中(27.7% 件数)、14 个命中多个(12.4%,需用户选)、847 个斗鱼
  兑不了(59.9%)—— 准入白名单以斗鱼商品目录为准,不匹配就不建单;
- order_items.spec_json 已带 sellerId/relItemId/relSkuId/skuNick,(itemId, skuId)
  才是单订单的精确定位键(4,092 个数字 skuId 中 89% 唯一),接单平台就是按
  sku_exact/sku_series 匹配的,本系统照此设计;
- CK 巡检规模 12,881 行(valid 10,079 / invalid 905 / 从未检测 1,897),按 6h
  周期反推 batch_size 应为 200 而非 50,否则实际周期被拉长到 21 小时。

规划要点:
- 与 order_site 整合选只读直连 PG:order_site 零代码改动,跨库 SQL 只允许出现在
  一个适配层文件里,另配降级开关与只读保护参数;
- P1 拆成 P1a(只检测、不改动任何 CK)与 P1b(自动重登,默认关闭),按「渐进
  上线」原则逐步减少人工;
- 用户截图一律进私有 OSS 桶 + 后端鉴权代理读图,不落本地磁盘;
- P4 的规则/模板/状态机对齐 order_site 接单平台:资料模板固定为游戏编号 +
  游戏昵称 + 主页截图,皮肤由订单号自动对应,仅多选类让用户选一件;
- 取消规则映射层(与 skin_aliases 职责重叠),规则直接挂 commodity_id,
  连带去掉 rule_ambiguous 状态。

三轮复核:① 补齐结构与缺口(术语表、P0 章节、权限表、配置清单、保留策略、
文案、测试计划、风险回退、迁移与文件清单、施工单);② 逐条核对代码事实
(路径/符号/接口/字段/迁移 head/测试基线全部命中);③ 找出并修掉 8 处实现级
矛盾(选择结果无处存、365 天命中的状态缺失、draft 悬空、多选回链断点、P4 与
P1b 排期矛盾、映射层重叠、P2 能力错位、用户回看链接缺失)。

含:docs/自动化与资料收集规划.md、docs/皮肤准入映射分析.md,并更新文档索引。
This commit is contained in:
yml2213
2026-10-02 19:34:37 +08:00
parent 2bdabc4e03
commit 6a62bbe70f
3 changed files with 1441 additions and 1 deletions
+3 -1
View File
@@ -1,9 +1,11 @@
# 项目文档索引
更新时间:2026-09-02
更新时间:2026-10-02
## 当前入口
- [自动化与资料收集规划](自动化与资料收集规划.md):CK 自动管理、资料收集链接、皮肤台账与半自动工单的分期计划(规划中,未开工)。
- [皮肤准入映射分析](皮肤准入映射分析.md):C 桶皮肤类到斗鱼商品目录的归一与覆盖分析(923 个快手名 → 78 个斗鱼商品,覆盖率 40.1%)。
- [虎牙 Cookie 路线状态](HUYA_COOKIE路线状态.md):当前实现、字段状态、验证边界和后续工作。
- [虎牙网页设备字段溯源](HUYA_WEB_FIELD_TRACE.md):浏览器证据、字段来源和生成算法。
- [虎牙 Cookie 合并审计与来源矩阵](HUYA_COOKIE合并审计与来源矩阵.md):字段来源约束和合并策略。