# 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**

### 交付物

1. **`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 全局单例，只落待发通知 |

2. **`CONTEXT-MAP.md`** 已加一行：`crm-customer` 客户业务。

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

### 依赖方向（定稿）

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