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.
41 lines
5.1 KiB
41 lines
5.1 KiB
2 days ago
|
# 01 全功能覆盖对账矩阵
|
||
|
|
|
||
|
|
Type: research
|
||
|
|
Status: resolved
|
||
|
|
Blocked by: —
|
||
|
|
|
||
|
|
## Question
|
||
|
|
|
||
|
|
把目标范围拆成 Demo 必须实现的**每一个可见入口**（列表列/筛选器/按钮/表单项/页签/弹窗/批量操作），逐项标注：
|
||
|
|
|
||
|
|
1. 触发的后端端点（方法+URL+关键查询参数）；
|
||
|
|
2. 出参字段契约源（Bruno .bru 文件路径 / API-SUMMARY 条目）；
|
||
|
|
3. 现有 demo `.scratch/customer-e2e/demo/index.html`（2264 行）是否已覆盖；
|
||
|
|
4. 缺口动作：新增 / 改造 / 豁免（豁免须引 gap-report 台账或 map Out-of-scope 依据）。
|
||
|
|
|
||
|
|
范围三大族（brief 原文）：
|
||
|
|
|
||
|
|
- **核心域**：三 workspace（我的/总览/公海）列表+看板+saved-view、新增/编辑/查重（check-name/check-credit-code 相似确认流）、联系人 CRUD/搜索、详情头部 + 6 页签（客户信息/联系人/跟进/关联商机/团队成员/操作日志——注意与战略协议页签并存的口径以矩阵核实为准）、跟进、关注/重点、团队成员、归属动作（分配/领取/抛公海/归档/换负责人）、商机侧硬依赖。
|
||
|
|
- **重流程**：交割两段式（预览→发起→交接单列表/详情/分配）、导入三段式（上传预检→确认执行→结果，客户与联系人两套）、超期提醒配置。
|
||
|
|
- **规则族**：查重设置、公海池配置。
|
||
|
|
|
||
|
|
产出矩阵落在 `assets/coverage-matrix.md`（本目录下），逐行：入口 → 端点 → 契约源 → 现有 demo → 缺口动作 → 依据。
|
||
|
|
|
||
|
|
## Pointers
|
||
|
|
|
||
|
|
- 现有 demo 功能清单（已侦察）：客户列表（三 workspace、视图类型、keyword、分页、汇总卡、批量分配/领取/抛公海/归档/关注/工商更新 stub/发起交割、新建客户含查重流）；客户详情 7 子页签（客户信息/联系人[列表+图谱+批量编辑+reveal+导出+导入+快速添加]/跟进记录/关联商机/战略协议/团队成员/操作日志）；客户导入两段式；客户交割；设置（超期提醒 A7-3-3-1 + 查重设置 A7-3-3-2）。
|
||
|
|
- 端点全集：`.scratch/customer-module/API-SUMMARY.md`（85 端点）；Controller 源码 `crm-customer/src/main/java/com/crm/customer/controller/`（13 类）。
|
||
|
|
- 原型树：`.scratch/api-docs-reorg/lanhu-tree-v29.md` A4 分区（A4-1 公海[2] / A4-2 总览[3] / A4-3 我的客户[9] / A4-4 客户详情[12] / A4-5 联系人[7] / A4-6 查重[3] / A4-7 交割[4]）。
|
||
|
|
- 缺口参照：`.scratch/customer-frontend-handover/mapping-a4-pages.md`（39 页对照）与 `gap-report.md`（P2/P3/豁免）。
|
||
|
|
- 对照审计已有结论：零缺接口（票03），故本矩阵重点在**入口/字段级**而非端点级。
|
||
|
|
|
||
|
|
## Answer
|
||
|
|
|
||
|
|
**结论**：端点级零缺口维持成立（GR 实测 59 唯一路径全对账）；缺口全部在**入口呈现层**。69 个入口逐行对账（入口→端点→契约源→现有 demo→缺口动作→依据），完整矩阵见 [assets/coverage-matrix.md](../assets/coverage-matrix.md)。两处口径已钉死：(1) 详情页签权威口径 = 原型/后端一致 **8 页签**，demo 现为 7（缺「关联项目」恒"--"页签），brief 的 6 页签清单少计关联项目+战略协议；(2) brief 点名的「换负责人」在 85 端点内无契约源（归属变更由 assign/transfer 承载）→ 豁免。
|
||
|
|
|
||
|
|
**缺口汇总（top）**：新增 9（saved-view 下拉、形态偏好切换、看板视图、批量分配按钮、页签5 占位、quick-create 演示入口、商机侧 search 演示入口、联系人独立菜单页、联系人详情+日志空态）；改造 16（视图下拉补 FOLLOW_UP_DUE/RECENT、六列筛选器、归档态开关、分屏/卡片、列表补列、汇总卡口径、工商联想输入、头部金额卡、跟进入/日志筛选器、导入任务过滤 + G2/G3/G4/G5 字段级四件）；豁免 14（全部有台账：换负责人、A4-6 三态、OCR、客户导出、日志导出、金额开关、触发校验复选框、附件位、企查查真实源、图谱展开折叠、联系人扩展档案、batchEdit 空串、P2 记档 demo 侧）；待姊妹票 4（#69 公海池配置→待02——crm-rule 客户域仅查重/提醒双单例、无池配置控制器，`.bru` 亦无，疑似 brief 点名但未实现；#41/#47/#48→待03；#8/#9 pool·board 实态→待04）。
|
||
|
|
|
||
|
|
**对 05 号票输入**：33/69 入口无缺口 + 图谱/批量编辑/双导入/交割/设置等已验证沉没成本高 → 支持方案 A fork 演化；改造面集中四块（偏好三件套 UI、看板 UI、联系人独立菜单、筛选器接线）；迁移风险 6 条见矩阵「对 05 号票输入要点」（汇总卡挪用拆分、assign 批量语义、pool 越界视图空集、F6 stub 保留、API_BASE/token 搬运、I-06 不断言拒绝）。
|
||
|
|
|
||
|
|
**对 07 号票输入**：展开范围 = 矩阵「缺口动作≠豁免」行；G2 列清单须待03 收口后定稿；脱敏断言点（similarHits.masked/图谱 phoneMasked/reveal/导出脱敏）与「--」位置清单（projectCount/页签5/金额卡/四件套）已在矩阵 §对07 输入列出；demo 硬编码字典枚举（follow_way×5、contact_source×4、STAGE）需对字典树核对，job_title 树已动态拉取。
|