crm-backend-matt/.scratch/opportunity-bugfix/issues/08-feasibility-customer.md

08: 客户管理模块可行性评估（A4，最新原型 30+ 页）

Type: research Status: resolved Blocked by: 01

问题

用户点名评估：客户管理模块开发可行性。工作量大 → 标记后续迭代；工作量小 → 简易实现 + 造测试数据 + 开放接口。

背景：v29 sitemap 实锤 A4 客户管理是最大块的未建模块（30+ 页）：客户公海 / 客户总览 / 我的客户 / 客户导入 / 新增编辑客户 / 客户详情（9 个 Tab）/ 联系人管理 / 客户查重 / 客户合并 / 客户交割。商机域已有关联客户子表 + primaryCustomerNameSnapshot（消费客户数据），但客户主数据域（crm 里似乎没有独立客户模块）不存在。

评估步骤

1. 读 A4 全部页面文本（lanhu-pages/ A4 前缀页 + 索引）+ 需求批注，提炼：
   • 实体：客户主档字段集、联系人、公海池、合并/交割/查重的业务规则
   • 与商机/线索的挂接（商机的「添加关联客户」弹窗搜的就是客户池 → 票 04 D-02 的 search 端点依赖客户主数据！这是强耦合点，评估必须覆盖）
   • 特殊机制：公海规则（客户版，与商机公海规则同构？）、导入（Excel？）、查重（什么维度）、合并（主档归一）、交割（跨部门转移）
2. 盘点代码现状：全仓库搜 customer 相关表/实体/端点（dict 的客户类型字典、商机关联客户子表已存在）；确认无 crm-customer 模块。
3. 产出评估（feasibility-customer.md）：
   • 端点估算（客户 CRUD + 公海流转 + 联系人 + 导入 + 查重 + 合并 + 交割 + 详情聚合 ≈ 25-40 端点量级）
   • 工作量分档（口径同票 07：小 = 纯 CRUD+列表+详情无新基础设施；大 = 合并/交割/导入/公海规则引擎等任一深水区）
   • 特别回答：票 04 的 D-02「关联客户 search」在客户主数据不存在时怎么实现（搜什么源？），给短期替代口径（例如搜商机已关联列表 or 从字典/种子表造最小客户池）——这个答案票 04 实现时直接用。
   • 建议 + 分界线，交用户拍板。
4. 拍板后处置同票 07（小 → graduate task 票；大 → 挂起记 map.md）。

验收

• feasibility-customer.md 含：实体/页面/规则清单、端点估算、与商机域耦合点分析（含 D-02 替代口径）、工作量分档结论、建议。
• 用户拍板记录在 Answer。

Answer

2026-08-30 评估完成，停等拍板（评估步骤 1-3 已闭环；步骤 4 待用户拍板后处置）。

• 产出：feasibility-customer.md（39 页盘点 + 实体/字段集 + 六大深水区规则实锤 + 耦合点分析 + 端点估算 + 分档 + 建议）。
• 分档结论：大——全量 ≈40 端点 / 6-8 新表；深水区六项（合并关联数据全迁移+单事务 / 交割跨模块级联+原子性 / 导入 / 企查查外部服务 / 公海规则 / 职务字典+联系人图谱）；最小切片（主档+联系人+公海+查重提示）仍是大档（≈15+ 端点，公海机制与企查查是躲不开的最小集）。
• D-02 特别回答：已由票 04 以快照池降级实现并闭环（customer/search 搜全库 opportunity_customer 快照），不依赖客户主数据；未来切真源端点签名/语义不变。商机域对客户模块零硬依赖，无技术债。
• 代码现状实锤：全仓库无 crm-customer 模块；客户数据仅以商机子表快照存在，customerId 为无主引用（票 11 种子用占位 id 920000000000000xxx）。
• 待拍板选项：A（推荐）整模块挂起记 map.md（P2 后续迭代）；B 做最小切片（主档+联系人+公海三件套，需明确接受大档工作量）；C 只造真客户池种子表替代快照池假 id（半天量级，不构成客户管理模块）。
• 拍板记录（20260831）：选项 A — 整模块挂起记 map.md（P2 后续迭代）。用户口径：「A：整模块挂起记map.md（推荐）」。处置：全量（≈40 端点/6-8 新表）与最小切片（≈15+ 端点，公海机制+企查查躲不开）均=大档，无小口径逃生门；D-02 已由票 04 快照池降级闭环，商机域零硬依赖无技术债；客户主数据域（合并/交割/导入/公海规则/企查查/职务字典六深水区）整体留后续迭代。