You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2.6 KiB
2.6 KiB
02 · 真值 specimens 补全采集（42 占位端点 + 退化示例）
Type: task Status: resolved Blocked by: 01, 03
Question
为文档示例真值化补全采集 specimens：对票 03 worklist 列出的 42 个占位示例端点 + 退化示例端点（「E2E 实测」标记但 data 空集/null 可有数据的），设计有数据的种子状态与 happy-path 调用，逐端点抓 representative 真值响应。
采集口径：
- 读端点必须非退化——示例要能当前端看懂结构：图谱先 save 出多级节点+手动边再读
graph/detail（而非首读懒建空图）；列偏好先保存再读；相似命中先造疑似重复客户再读 similar 列表；字典/偏好/日志类先写入再读出 - 写端点（POST 返回 data:null 或简单 id）真值允许 data:null 形态——真实信封即可，清除「非真实返回」标记的意义在于「这是实测的」
- 二进制端点（export/template）沿用 contact-graph 票 09 口径：文字说明 + 关键响应头
输入：票 03 的 assets/doc-gap-worklist.md（端点×问题清单）+ 票 01 起服基建。
产物：specimens-doc-truth.json（端点→实测响应，逐字段真值）+ 采集脚本（幂等可重跑，e2c- 夹具正门清理）。
Answer
2026-09-11 resolved（23 端点真值全采集，交割缺口收口）
harvest_doc_truth.py重跑两轮收敛至 23 端点 specimens（H1–H11，幂等，重跑即清夹具重来）：图谱有数据读/联系人详情/quickAdd 部分失败/batchEdit（failedRows 行级失败不可达，如实空集——语义发现②）/客户导入三段式含 failures/联系人导入/旧版分页/偏好 save+get 原值恢复/批量三端点含失败行/交割四端点/quick-create 校验拒真值（67001，最小必填 7 项——语义发现①）。- 交割采集补手术（D22）：BUDDY 部门无 leader → resign 自动推导 67011。改造 h_transfer_assign：圈定安全前置（BUDDY 名下非夹具客户即放弃）→ 原值先查先存（华南销售部 leader/BUDDY 部门）→ 华南销售部 leader=admin + BUDDY 划入 → initiate
reason=transfer_post + toDirectorId=ADMIN（调动路径，覆盖 toDirectorId 范围校验分支）→ finally 还原组织原值。实测：initiate 返回 TransferDetailDTO 含 details×2；assign 信封 code=0 + failures 行{id:999…, reason:UNKNOWN, message:明细不属于该交接单}（BatchRunner 部分成功语义）；assignable 6047 行真值（总监部门含子部门全量，不分页）。 - 残留核验：leader/BUDDY 部门/名下归属/夹具/当日交割单全部归零（check_restore_t02.py）。