# 07 逐入口字段对齐验收清单

Type: research
Status: resolved
Blocked by: 01

## Question

验收标准「字段对齐：列表/详情/页签字段与 Bruno 文档出参一致（含脱敏、空值 "--" 等口径）」。基于 01 号矩阵圈定的入口集，逐入口产出对齐清单，落在 `assets/field-alignment.md`：

- 请求参数表（名/类型/必填/示例——示例值取 Bruno 或 seed 数据）；
- 出参字段表（路径/类型/文案口径/脱敏标记——哪些字段后端脱敏如手机号/证件号，脱敏形态长什么样）；
- 空值渲染口径（"--"）与枚举字典文案（customer_source、stage、job_title 两级树、contact_source 等）；
- 该口径的权威出处（.bru 文件路径 + DTO 源码路径）。

用途：冒烟断言 + 人工验收双用。粒度控制：按 01 号矩阵的「缺口动作≠豁免」入口全覆盖，豁免入口不展开。

## Pointers

- Bruno 文档仓 `D:\code\crm-api-docs`（按菜单分组的 .bru）；`.scratch/customer-module/API-SUMMARY.md`。
- DTO 源码：`crm-customer/src/main/java/com/crm/customer/` 下 dto/vo 包。
- 现有 demo 的渲染口径（"--"、脱敏 reveal 按钮）可直接对照。

## Answer

（2026-09-11，AFK 决断。产出：`assets/field-alignment.md`（1091 行）+ 中间分片 `_fa-core.md`/`_fa-flow.md`（已并入正文，收口时删除）。两个抽取代理分工：核心域（矩阵 #1-#49）/ 联系人族+重流程+规则族（#31-#69），逐入口产出请求参数表、出参字段表（路径/类型/文案口径/脱敏）、空值"--"与枚举字典口径，每表附权威出处（.bru 相对路径 + DTO/Param 源码缩写，缩写表见文件头）。）

### 结构

- **头部「跨票校准注记 K1-K11」**：两代理交叉发现统一收敛，**实施/冒烟必须遵守、覆盖矩阵与 AS 旧口径**。
- **第一部分 · 核心域**（#1-#49）：通用口径（BaseParam 分页/Long→str 序列化/时间格式/"--"口径/脱敏总述/seed id）+ 逐入口表 + 字典与枚举专节 + 来源清单。
- **第二部分 · 联系人族+重流程+规则族**（#31-#69）：12 节（联系人菜单/列表/图谱/增强/导入六端点/CRUD/交割五端点/客户导入/规则族/字典/脱敏专节/来源清单）。

### K1-K11 校准要点（已回写落地）

- **K1** G4 收窄为「两件」：detail 实测 `createTime/updateTime` 经 BaseDTO 有值，仅 `creatorId/updaterId` 不暴露 → demo DEFECT_LEDGER G4 条目 + 冒烟步 13/34 已同步改（本票收口动作）。
- **K2** 关联项目页签有真端点（`CustomerProjectQueryPort`，当前 Noop → 数据空态显"--"）→ 票 11 scope 已修（矩阵 #42「无端点」过时），冒烟步 14 同步。
- **K3** 看板 summary 字段 = `cnt`/`groupValue`（demo 旧读 count/name/key 必显"--"）；cards 必传 groupValue → 票 10。
- **K4** oplog action 权威值域 **18 种**（含 GRAPH_EDIT；AS §3「17 种」未同步）→ 票 11 筛选下拉。
- **K5** projectCount 三方漂移（AS 恒 null / SQL 恒 0 / E2E 序列化 "0"）：渲染按实返回，"--"兜底。
- **K6** contact_source 真值 = group_meeting/group_activity/referral/other（crm-dict DictDataInitializer）；demo 硬编码 contact_source_01..04 系字典改版前遗留 → 票 12/13 改字典驱动。
- **K7** reminder save 控制器实为**表单绑定**（.bru 自称 JSON 例外不实）→ demo form 提交正确，不改。
- **K8** focus-batch 返回 **Void**（其余批量端点 BatchResult）→ 票 10 toast 自算条数。
- **K9** quick-create `.bru` 漏 `confirmSimilar`、误标星级选填（DTO 全 7 必填）→ 票 12 以 DTO 为准。
- **K10** 联系人电话全读路径脱敏 `138****1234`（短号全遮、导出同口径、明文唯一通道 reveal）；similarHits/check-phone 行级 masked；核心域 V1 明文（creditCode 明文回显）→ 冒烟脱敏断言。
- **K11** transfer status 权威 0/1（.bru 示例 2 超值域）；reminder 64023 精确条件 = 两天数均非空且 >0 → 冒烟断言。

### 验收用法

- 冒烟断言与人工验收双用；实施票 10-13 的字段名/枚举/端点路径一律以本清单为准，与矩阵/AS 旧口径冲突时**以 K 注记与本清单覆盖**。