# 需求:产品流程图补齐+防腐化闸(doc-flows-fresh)
状态: done(2026-10-11 已落地:17仓申报doc-flows-fresh并挂进 ops/rules_check.py 每日名单(本次扩编9仓);FLOW图24张(easy_screenshot 5/mapforge 2/account_center 2/company 2 含三kit分发对账+product-wall,其余13仓各1);全量实跑17正常/2异常=easy_flow kit-rust-kit-declared 存量缺口(09:16前已挂)+easy_screenshot 并发会话10:13改动snip.rs被防腐闸当日抓到(首跑stale即立威,待该会话收口刷核对行))
归属: 公司运营
来源: boss 直投(会话)
日期: 2026-10-11
建议: 做,boss 2026-10-11 拍板「方案通过,开干吧」:21个活跃仓现有流程图0张(实查mermaid/plantuml/drawio,仅easy-disk冒烟CSV假阳性);四期=Phase0口径(DOC-LAYOUT-STANDARD §7/§8已落)+Phase1试点(easy_screenshot根README+5图/account_center 2图/两仓申报doc-coverage实跑)+Phase2闸门(rulecheck探测器doc-flows-fresh:覆盖目录git提交时间比对+核对超龄60天)+Phase3按事故史推广;验收=试点仓FLOW文档头部三字段行顶格+含失败分支+rulecheck存量测试全绿+rules_check.py读数记录;当日认领行见ops/worklog/2026-10-11.md 08:48节

## 现状

- 21 个活跃仓(登记表 `ops/products/*.yaml` 实查)现有流程图 **0 张**:全仓 grep mermaid/plantuml/drawio,唯一命中是 easy-disk `docs/assets/smoke_*.report.csv` 的字符串假阳性;
- 事故史最厚的链恰恰无图:easy_screenshot 0.7.5 换票反序列化形状不符、0.7.6 capabilities ACL 拒 event、设置窗 CSP connect-src 静默失败、0.8.0 发布断点续发被 check#2 拦——登记表 notes 全是文字叙事;
- 机检口径空窗已实证三层:①doc-coverage(10-11 02:00 落地)只在 company 申报,产品仓未申报=没检查(今日 rules-check.json easy_screenshot `gaps:[]`);②引擎判据不盯仓根(rel 为空跳过),缺根 README 结构上不会被报;③产品源码仓 src 树若全量申报,minFiles=2 存量会爆量;
- easy_screenshot 无根 README(仅 AGENTS.md/CHANGELOG.md),docs/ 13 份全是一次性 plan 文档,0.11.0 已发布而文档停在迁移期=腐化实例。

## 方案

判据正本 = `docs/工程规范/DOC-LAYOUT-STANDARD.md` §7(仓根 README 口径)/§8(FLOW-<链名>.md 格式与防腐判据),本票只留执行步骤:

1. **Phase 0(口径)**:标准补 §7/§8——已完成(本次建票同批落盘);
2. **Phase 1(试点 2 仓)**:easy_screenshot 根 README + 5 份 FLOW(登录/换票/续期链、WebDAV 同步、确认式更新流、会员墙分支、截图主流程);account_center 2 份(魔法链接登录状态机、响应形状↔SDK 契约图);两仓 `docs/rules.json` 申报 doc-coverage(roots 含 `"."`,src 只列建图目录),实跑 `rulecheck run` 记录 gaps 存量;
3. **Phase 2(闸门)**:rulecheck 新探测器 `doc-flows-fresh`——解析 FLOW 文档头部三字段行,覆盖目录 git 提交时间晚于文档=过期 gaps、核对超龄 60 天=gaps、缺头部字段=gaps;测试含负向变异;挂 rules_check.py 现链路;
4. **Phase 3(推广)**:第一梯队 app-admin/official-website/mapforge → 第二梯队 easy-flow/easy-disk/easy-image/easy-clipboard → 第三梯队 weave/spindle/short-play/mail-hub → 收口三 kit 合一张分发对账图 + relay-watch/failbook/book-room/product-wall。每日循环排工消化,不另开专项。

跨仓代做范围声明:产品仓只增 `README.md`(缺者)、`docs/FLOW-*.md`、`docs/rules.json` 规则实例,不动业务代码;company 仓改标准正本与本票。

## 验收标准

- [ ] Phase 0:DOC-LAYOUT-STANDARD §7/§8 存在,`AGENTS.md` 体积闸门实跑不受影响(本票未动 AGENTS.md)
- [ ] Phase 1:试点 2 仓 7 份 FLOW 文档头部三字段行顶格(正本/覆盖/核对)、每图含失败分支;easy_screenshot 有根 README 且含流程图索引节
- [ ] Phase 1:两仓申报 doc-coverage 后 `node rulecheck run` 实跑读数记入 worklog(存量数字,不静默调门槛)
- [ ] Phase 2:`doc-flows-fresh` 探测器 + 负向变异测试,rulecheck `npm test` 全绿;`python ops/rules_check.py` 无 FAIL 噪音;过期图能真实挂日报(实盘变异:改覆盖目录代码不刷图→报红,复原→转绿)
- [ ] Phase 3:推广梯队清单各仓 FLOW 文档落位或 notes 记豁免理由;本票 done 时缺口存量=0