4.1 KiB

Raw Blame History

01 — 客户域领域词汇 + crm-customer/CONTEXT.md 骨架

Type: task Status: resolved

⚠ 20260902 复核注记：本文件关于「档案状态」仍写三值（有效/已归档/已被合并）。D19 已拍板去掉「已被合并」态（合并 Out-of-scope），archive_status 收敛为有效/已归档两值。以 01-answer.md 为准。 Blocked by:

目标

新建 crm-customer 模块，落 crm-customer/CONTEXT.md（ubiquitous language，纯 glossary，无实现细节），并在根 CONTEXT-MAP.md 增一行。对称 crm-lead/CONTEXT.md / crm-opportunity/CONTEXT.md 的写法。

要收录的核心术语（随各票 resolve 回填/校准）

客户 (Customer) — crm-customer 核心聚合根；归属由 owner_user_id(销售负责人)+owner_dept_id(销售部门快照) 表达，owner 空=在公海。Avoid: 线索(转化前)、商机(下游)、联系人。
销售负责人 / 销售部门 — 客户的 owner + 部门快照；抛公海/交割时变更。Avoid: 领取人(那是线索术语)、创建人。
协同人 — 客户团队非负责人成员；抛公海清空、交割不自动恢复。
客户阶段 (customer_stage) — 潜在→重潜→已成交，只前进不回退，外部成功结果驱动，不可手动改。Avoid: 客户状态、归属状态。
档案状态 (archive_status) — 有效/已归档/已被合并，正交于归属。
客户公海 — owner 空的有效客户逻辑视图；无独立池实体（对称商机公海）。
联系人 (customer_contact) — 归属某客户的独立实体，无独立 ACL，权限继承客户。
人脉关系单位 — 客户下的关系单位名标签集（非关联 CRM 客户）。
客户交割 — 销售离职/调岗时把名下客户批量交给直属总监，再分配；同步变更关联商机/项目负责人。

依赖方向

单向：crm-opportunity → crm-customer（商机读客户/建关联，已有 customer_id 契约占位，见商机图「customer_id 契约占位」决策）；crm-customer → crm-rule → (crm-auth / crm-dict / crm-file)。客户读「关联商机」走查 crm-opportunity（下游反查上游，注意 ADR-0029 循环依赖技术债，同库单体阶段可接受）。

Answer

Status: resolved

交付物

crm-customer/CONTEXT.md 已创建（ubiquitous language，纯 glossary，对称 crm-lead/CONTEXT.md 写法）。收录 11 个核心术语，每个带 _Avoid_ 校准：

术语	关键点
客户	归属(owner)+档案(archive_status)正交；阶段(customer_stage)只前进
销售负责人	`owner_user_id`，唯一持有者
销售部门	`owner_dept_id` 快照，随负责人变更（区别于线索 dept_id 不变）
协同人	非负责人成员，可看不可归档/合并
客户阶段	潜在/重潜/已成交，外部结果驱动，不可手动改
档案状态	有效/已归档/已被合并，正交于归属
客户公海	owner 空 + 有效的逻辑视图，无独立池实体
客户总览	管理视角，@DataScope 覆盖
我的客户	销售视角，负责人或协同人 + 有效
联系人	子实体，必属客户，无独立 ACL
人脉关系单位	纯文本标签，非关联客户
客户交割	两段式：交接→分配，同步商机/项目负责人
超期未跟进提醒	crm-rule 全局单例，只落待发通知

CONTEXT-MAP.md 已加一行：crm-customer 客户业务。
术语校准点（相比票内初稿的修正）：
- 明确「销售部门是随负责人变更的快照」——区别于线索 dept_id 全生命周期不变（这是本模块与线索的重要语义差异）。
- 明确「协同人抛公海清空、交割不自动恢复」。
- 「客户公海 = 逻辑视图」写进定义，杜绝将来误建池表。

依赖方向（定稿）

crm-opportunity → crm-customer（商机读客户/建关联）
crm-customer → crm-rule → (crm-auth / crm-dict / crm-file)
crm-customer → crm-opportunity（「关联商机」页签下游反查上游，同库单体可接受，ADR-0029 技术债）

4.1 KiB Raw Blame History