小冈接手知识库 · 工单脉络与锁文件地图(2026-09-05)

来源:docs/TASKS.md 全量通读(269 行/84 工单行)+ GOV-2026-0904-01 认领版 + AGENTS.md §3/§9。
用途:随时顶替派工/验收/排查角色时的全景索引。

一、锁域总图(谁锁什么)

域属主强制机制
C 端页面 wxml/ts(miniprogram/miniprogram/pages/**)小冈路径闸门域1(pre-receive 仅 xiaogang 可推)
B 端 H5(b-workbench/**)一号(coze1)路径闸门域2
后端 backend/**阿仁(aren)+ 小齐(xiaoqi)路径闸门域3
方案/派工/验收/裁决/文档小齐不写业务代码
共享文件(改前会话告知全员)无锁main.py / auth.py / security.py / db.py / schemas.py / 公共表 / nginx/conf.d/*
TASKS.md无锁修改后必须跑 python3 scripts/md2html.py docs/TASKS.md 同步双版本;只许自己工单行追加
docs/*.md(方案类)视工单 🔒 声明工单行内 🔒X = 该文件锁归属

工单行内常见 🔒 专项(从 TASKS 各交付记录提炼):

二、工单脉络(84 条聚合为 11 条主线)

<div class="rich-timeline">

<div class="rich-step"><span class="rich-step-marker">A</span><div class="rich-step-body"><div class="rich-step-title">B-011 十接口链(全域建纲)</div><div class="rich-step-text">WIP-127(二号前端十接口封装)→ WIP-152(小冈后端十接口 45e8fcb/68cdb8c/d23bc1c,含 041 迁移)→ WIP-156/158(一号联调/商户名片)→ B1 生产部署后全端点 200 ✅</div></div></div>

<div class="rich-step"><span class="rich-step-marker">B</span><div class="rich-step-body"><div class="rich-step-title">订单域链</div><div class="rich-step-text">WIP-149(阿仁订单路由层 008 双轨分流)→ WIP-163(一号订单前端全链路)→ WIP-192(阿仁 refund-preview 4 硬规则 12 指纹关账)→ WIP-199(小冈 H 域表单页接线)✅;pay 端点暂停(线下结算,501)</div></div></div>

<div class="rich-step"><span class="rich-step-marker">C</span><div class="rich-step-body"><div class="rich-step-title">场景引擎链</div><div class="rich-step-text">WIP-136/139/137(一号/二号 C 端场景骨架+配置化)→ WIP-148/150/151(阿仁后端 8 接口+038 迁移+二号收尾)→ WIP-199 J 域 7 页整页重构 ✅;J5 证书数据待就绪</div></div></div>

<div class="rich-step"><span class="rich-step-marker">D</span><div class="rich-step-body"><div class="rich-step-title">需求/分销链</div><div class="rich-step-text">WIP-164/166/169(阿仁反向定制后端+一号前端逻辑+分销接线)→ WIP-133/134(商户侧 H5)→ WIP-195(custom_items 寻址修复关账)✅</div></div></div>

<div class="rich-step"><span class="rich-step-marker">E</span><div class="rich-step-body"><div class="rich-step-title">D5 档位商业化链(当前热点)</div><div class="rich-step-text">WIP-196(阿仁:049 迁移+服务费记账端点+业态功能包闸——P1 授权死码必修,推 main 待 B1 关窗后=已关窗可推)→ WIP-198(一号 D5 L1 前端半,等 196 交付后激活)→ 档位报批(刘总批 v1.1)</div></div></div>

<div class="rich-step"><span class="rich-step-marker">F</span><div class="rich-step-body"><div class="rich-step-title">测试/上线链</div><div class="rich-step-text">WIP-194(一号 E2E 三标定修复关账)→ B2 全站回归(B1 关窗后解锁)→ B3 静态稿验收 → B1 复走+48h 灰度 → 客户端发版(必含 3ace656)</div></div></div>

<div class="rich-step"><span class="rich-step-marker">G</span><div class="rich-step-body"><div class="rich-step-title">治理链</div><div class="rich-step-text">GOV 五节落地(四域闸门/工作树/白名单/预审)→ WIP-175 页脚盘点(小齐)→ 6f86353 事故闭环(f318e39/a35fc32 处置)✅</div></div></div>

<div class="rich-step"><span class="rich-step-marker">H</span><div class="rich-step-body"><div class="rich-step-title">WIP-199 C 端接线总单(小冈 ✅ 关账)</div><div class="rich-step-text">轮次 1/2/3/4/5/6(fcfa724→5f16b4b)+ 解包修复 3ace656;小齐 23:55 抽验关账(6 批链身份/TSC/单位/权限闸三分辨)</div></div></div>

</div>

三、当前活动项与待办队列(接替即看)

状态事项阻塞链
🔶 进行中WIP-196(阿仁 D5 三件套)P1 授权死码待修修后推 main(B1 已关窗可推)→ 049 生产迁移 → WIP-198 激活
🔶 待激活WIP-198(一号 D5 L1 前端)等 196
⏳ 待执行B2 全站回归(E2E 26 场景)B1 关窗已解锁=可跑
⏳ 待执行B3 静态稿验收(20 页对位)B2 前置
⏳ 待执行客户端发版(checklist 含 3ace656)回归通过+刘总令
⏳ 待办生产运营数据补录(商户内容/套餐/攻略——生产 entries 偏空)刘总/运营排产
🕐 挂起J5 证书数据 / QR 库决策 / membership 产品决策 / L1 激活长线刘总拍板
🕐 运维deploy.sh/backup.sh/migrate.sh 四缺陷修复(B1 登记)排期

四、接替要点(小齐角色视角)

  1. 派工格式:五要素(页面/端点/联调数据/边界/自验)+ 基线 HEAD + 五类管控声明(迁移/涉钱/生产/C 端 B 端/跨域=需派工)
  2. 验收格式:staging curl 契约逐字段对位 + TSC=0 + 冲突标记零 + 单位抽验(分/元)+ 权限闸负例(403/401)+ smoke 不回退 + 独立复跑(禁「预期」话术)
  3. 台账纪律:开工第一动作=TASKS 加行(署名+时间+🔒);只许自己工单行追加;改完跑 md2html 双版本
  4. 裁决习惯:争议=事实核验(源码 grep/psql 直查)→ 出裁决文档 → 停手登记纪律
  5. 踩坑史(接手须知):grep 静默零匹配坑(用 Python 正则)、差异集误判(扫 import 语句+解构名)、连错库(staging 当生产)、旧基线覆盖(git pull 基线核对)、macOS bash 3.2 语法兼容