qiaoqichaoandClaude Code
d8a7d3858c
T02 首个子卡 = S1 契约层。新增 backend/contracts/prescreen.py（设计指定的 唯一 owner），定义 SourceLocator / ImportItem / ImportBatch / FactConflict 与共用约束、错误码与错误信封。 落实的规格条目： - BR-22 逐文件保留来源/定位/解析版本与状态 - BR-23 多来源冲突保留候选并要求显式处理（resolved 需说明+选择+人） - AC-23 反例：绝对路径(C:/、/、//share)、上级引用(..)、超限、空集合、 failed 缺 error_code、parsed 缺 document_id、parsed 带 error_code - AC-24 反例：候选值全同不构成冲突；未知用 null 而非 0/空串； candidates 必须与 candidate_evidence_ids 同序同集合 - 01 §5 错误码与既有 translate() 的 HTTP 语义对齐；E-17 为运行级、HTTP 200 - 03 §9.1 时间必须带时区；禁止未知字段（E-07） D3 定案（工程限制，非业务阈值）：单文件 ≤10 MiB 沿用既有 LIMIT；单批 ≤20 文件 / ≤20 MiB。依据 03 §1 末「管理员只能降低初期限制，放宽须重新验证」， 取保守方向即规格许可；放宽需另立验证。 依赖方向：contracts 不导入 services，标准字段白名单校验留在 service 层。 测试：新增 test_prescreen_contracts.py 38 项，全绿；scripts/verify.py 9/9 PASS。 Co-Authored-By: Claude Code <noreply@anthropic.com>