4.2 KiB

Raw Blame History

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 注记与本清单覆盖。

4.2 KiB Raw Blame History