crm-backend-matt/.scratch/customer-demo-ref/issues/11-core-detail.md

11 核心域·详情层改造

Type: task Status: resolved Blocked by: 07, 09

Scope

矩阵 #29/30/40/41/42/44/45：

• 详情头部 4 张金额卡（恒"--"+P3-6 角标）。
• 页签补齐 8 个：页签5 关联项目接线真端点（CustomerProjectQueryPort，当前 Noop 实现 → 数据空态显"--"，不做硬占位）；端点路径查 assets/field-alignment.md 第二部分。
• 关联商机 7 列真名（G2 角标；列名以 field-alignment/opp-deps 为准）。
• 信息页签系统信息区（G4 角标）；成员列表（G3 角标）。
• 跟进筛选器（followWay/时间范围）；oplog 筛选器（action 17 值/keyword/时间）。
• G 系列角标挂载（G1/G2/G3/G4/G5/G6 对应位置）。

Accept

smoke-plan 步 11-19 可过；8 页签全遍历。

Answer

（2026-09-11，AFK 实施。demo/index.html → 2597 行（票 11 净增约 +105）。契约全部按 field-alignment #29/#30/#40/#41/#42/#44/#45 + K1/K2/K4/K5/K10。）

1. 详情头部 4 张金额卡（#29/P3-6）：金额汇总区 4 卡（已中标项目总额/跟进中方案预估/进行中商机总额/合同·回款）按契约恒 null 显 "--" 不显 0，挂 P3-6 dbadge；头部「项目计数」去掉旧「（契约恒 null 显 --）」文案改按实返回。
2. 页签补齐 8 个：subtabs = 信息/联系人/跟进/关联商机/关联项目（新）/战略协议/团队成员/操作日志。
3. 页签5 关联项目接真端点（K2）：GET /api/customer/project/page?id=（CustomerProjectQueryPort 反查，当前 Noop 实现 → 数据空态显 "--"，非硬占位）；列=ProjectItem 真名 9 字段子集（项目名称/阶段/状态/报备状态/项目金额/负责人/最近更新）。
4. 关联商机 7 列真名（#41/G2）：修复旧 5 列三处字段名漂移（opportunityName/statusName/ownerUserName 系幻影字段）→ 契约 7 字段列头（商机ID/商机名称/阶段/预计金额/负责人ID/负责人/最近更新），G2 dbadge+缺列说明。
5. 信息页签（#30/G4/K1/K10）：grid 补「创建人/更新人」两行（creatorId/updaterId 不在 DTO → 恒 "--"）+ G4 dbadge 与口径提示（创建/更新时间经 BaseDTO 有值，如实渲染）；修复信用代码字段名漂移 creditCode→unifiedCreditCode（K10 明文回显，否则冒烟步 13 明文断言必 FAIL）。
6. 跟进筛选器（#40/G1）：followWay 五值下拉 + 起止日期（补 00:00:00/23:59:59 含端）+ 查询；G1 dbadge 明示操作人筛选豁免（FollowPageParam 无参数）；写跟进按钮挪入筛选条；行渲染修正 followWay 字典名（后端不回名→前端 FOLLOW_WAYS 翻译）与 followByName 快照（旧读 createByName 系幻影字段）。
7. oplog 筛选器（#45/K4）：action 下拉按权威 18 种渲染（含 GRAPH_EDIT，映射中文文案）+ 叙事 keyword + 起止日期；日志行 action 翻译文案。
8. 成员列表 G3（#44）：添加协同人旁挂 G3 dbadge + 「职务/加入时间两列 DTO 未暴露，缺列不补」提示。
9. G5 角标：联系人页签列表视图条挂静态 data-defect="G5"（ContactDTO 未暴露负责人快照）。G6 归票 12 联系人独立菜单。

证据

• Playwright 快验（_quickcheck.py）：pageerror=0；subtabs=8（projects 就位）；G5 静态角标存在；缺陷面板 33 行不受影响。截图 demo/shots/t11-quick-detail.png。
• 金额卡/7 列/筛选器/项目页签的带数据断言归票 14 冒烟步 11-19（需起服）。