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.
26 lines
2.6 KiB
26 lines
2.6 KiB
2 days ago
|
# 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）。
|