Files
xiaotutongxue/docs
lovife b991e3d68e docs(contract): V2.6 六处口径修正 + 新增 §17 实现补充与偏差记录(客户确认)
17 项决策里的 A 组:契约按已确认的口径改写,不动代码。

一、六处口径修正
  · §2.7 notifyBizType:5/6 对调修正为「5 催报 / 6 导出完成」——
    旧表若按写实现,催报去重会静默失效(F-30)
  · §2.7 auditAction:补全 7 个动作,撤回=7(3 是批量通过;F-7);
    §11.4 约束补「状态 2 可撤(撤的是初审)」、留痕改 action=7
  · §3.6/§9.5 collect_file.source:改为建表口径「谁传的」
    (1 本人/2 班主任代传/3 管理员代传/4 整理器;F-38/39 —— 代传可追溯)
  · §9.5 重写为「上传前置检查(预检/秒传/压缩建议)」,direct:false,
    明写「客户端可跳过;服务端上传本身做全部校验」(F-3/71/72);
    §9.6 process 改为「有原始件时的重新规范化」;§9.9 OCR 标注一期缓做
  · §12.1 validation/run 改同步并返回统计
    (checkedSubmissions/issuesFound/unresolvedLeft/elapsedMs;F-51 ——
    全契约本就没有查 jobId 的接口,返回一个查不到的作业号没有意义)

二、新增 §17 实现补充与偏差记录
  · 17.1:41 个「代码有、§4 清单没有」的接口按六类分组
    (材料通道/微信授权/签名URL下载/界面必需/契约链条断在第一步/运维动作);
    清单声明由 check-api-parity.py --extra 生成 —— 手抄件会过期,命令不会
  · 17.2:12 条已确认偏离 D-1~D-12(notifyBizType、source、上传链路、process、
    validation 同步、撤回动作码、§14 路径前缀、biz_type 落库字符串、归档可删、
    租户域名、通知两级、OCR 缓做)—— 每条带契约原口径/实现口径/依据编号

验证:python scripts/verify-docs.py → 22 项全部通过(含表格列数一致性);
      check-api-parity.py --quiet → 契约 121 / 已实现 120(§17 不影响 §4 计数)
2026-09-30 12:38:47 +08:00
..