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.
42 lines
4.3 KiB
42 lines
4.3 KiB
1 week ago
|
# 08: 客户管理模块可行性评估（A4，最新原型 30+ 页）
|
||
|
|
|
||
|
|
`Type: research`
|
||
|
7 days ago
|
`Status: resolved`
|
||
|
1 week ago
|
`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（半天量级，不构成客户管理模块）。
|
||
|
7 days ago
|
- 拍板记录（20260831）：**选项 A** — 整模块挂起记 map.md（P2 后续迭代）。用户口径：「A：整模块挂起记map.md（推荐）」。处置：全量（≈40 端点/6-8 新表）与最小切片（≈15+ 端点，公海机制+企查查躲不开）均=大档，无小口径逃生门；D-02 已由票 04 快照池降级闭环，商机域零硬依赖无技术债；客户主数据域（合并/交割/导入/公海规则/企查查/职务字典六深水区）整体留后续迭代。
|