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.
30 lines
2.2 KiB
30 lines
2.2 KiB
2 days ago
|
# 06 · 字段说明清晰化（(d) 类问题修复）
|
||
|
|
|
||
|
|
**Type:** task
|
||
|
|
**Status:** resolved
|
||
|
|
**Blocked by:** 03
|
||
|
|
|
||
|
|
## Question
|
||
|
|
|
||
|
|
按票 03 worklist 的 (d) 类问题修复响应字段说明，达到「前端不看源码就能懂」的联调清晰度：
|
||
|
|
|
||
|
|
- **值域枚举补全**：状态/类型类字段（如 levelSource、importStatus、dedupStrategy、viewType 等）在说明里列出全部取值与含义
|
||
|
|
- **口径/语义补全**：如 version 的 bump 时机、脱敏规则（前3+****+后4）、clip500、乐观锁错误码触发条件
|
||
|
|
- **格式/单位补全**：时间格式、金额单位、id 形态（雪花字符串）
|
||
|
|
|
||
|
|
**纪律**：说明的单一真源是源码 `@Schema`——说明改动若对文档与源码不一致，**先回写源码注解再重新生成**（与 a4-doc-fields 票 03 同纪律），不留文档侧手改漂移点。涉及跨模块端点（dict/preference 等）同样处理。
|
||
|
|
|
||
|
|
**产物**：修复清单执行 + 源码 @Schema 回写（如需）+ 文档写回。
|
||
|
|
|
||
|
|
## Answer
|
||
|
|
|
||
|
|
**2026-09-11 resolved（(d) 类四项全修 + 错误码 78/78 全量恢复）**
|
||
|
|
|
||
|
|
脚本 `fix_d_class_t06.py` + 补刀 `fix_ec_round2_t06.py`：
|
||
|
|
|
||
|
|
1. **错误码节回捞 30 文件**：worklist 备注标注 24 + 全量对账（HEAD 有节×工作树无节）补捞 6 → 全仓含错误码节 **78/78**（= HEAD 基线），插入位置＝字段表与响应示例之间（HEAD 同位）；回捞码全集 67001–67024 经源码常量比对**零漂移**。
|
||
|
|
2. **createTime 行 ×9**：交割三件（发起时间，锚点 status 后，与源码字段序一致）+ 导入任务结果×3（提交时间，锚点 creatorName 后）+ 最近导入记录×3（content[].createTime）。
|
||
|
|
3. **详情公共头部 7 行截断**：按源码 CustomerDetailHeadDTO @Schema 原文重建（`显 "--"` 完整句），dangling 行清零。
|
||
|
|
4. **jobTitleLevel 值域 ×3**：先回写源码 ContactDTO @Schema（「等级真值 1–10，可空，null=未设置等级落右侧栏」，与 entity @Comment 同口径）→ 三文档行同步；三端点（detail/page/search）同源 ContactDTO，源码一处改全生效。
|
||
|
|
5. 验证：dangling=0、createTime 仍缺=[]、值域仍缺=[]、触碰文件 BOM=无。
|