# 02 — 客户主表字段清单

Type: research
Status: open
Blocked by:

## 问题

定客户主表 `customer` 的完整字段清单 + 索引 + DataScope 注解。这是扇出最广的票，其他票（三视图/查重/交割/阶段）回填它。

## 一手证据（蓝湖缓存 txt）

- `a4-3-3-1_新增客户信息.txt` — 新增页字段（基本信息/工商信息/跟进人员/关联信息/补充资料五区）
- `a4-4-1_客户详情_客户信息_.txt` — 详情页字段分区（基本信息/关联信息/补充资料/工商信息/系统信息）
- `a4-2-1_客户总览列表_列表视图_.txt` — 列表列 + 字段设置项

## 已知字段线索（待核实归类）

- **系统生成**：客户编号 `customer_no`(KH+日期+序，只读)、创建人/时间、修改人/时间。
- **基本信息**：客户名称*、客户类型*(字典)、所属地区*(省市区)、行业*(两级树，复用 crm-dict `industry`)、客户星级*(一~五星)、关系星级*(一~五星)、人脉关系单位(标签集)、公司决策人。
- **归属（轴1）**：`owner_user_id`(销售负责人*)+`owner_dept_id`(销售部门*快照)+协同人(团队子表)。
- **阶段（轴2）**：`customer_stage`(潜在/重潜/已成交)。
- **档案状态**：`archive_status`(有效/已归档/已被合并)。
- **战略协议**（划出）：`战略协议等级` 列在列表出现——但战略协议子域划出，主表是否冗余一个等级快照列供列表展示？→ 本票决定（建议：留 `strategic_agreement_level` 快照列供列表，实体本身划出）。
- **已成交VIP客户等级**：列表有列 → 主表字段还是 A5 驱动？待定（疑似阶段=已成交后的细分，可能留 seam）。
- **工商信息**（企查查回填）：统一社会信用代码(唯一)、法定代表人、成立时间、注册资本、经营范围、人员规模、年产值、公司地址、工商名称。
- **关联信息**：是否商机勾兑*、总监近期拜访时间、是否子客户*(是→父客户关联必填)、父客户关联(禁自身及下级/防环)、合作系统、不合作原因、是否参加总裁班/产品经理班(+参加人/电话，条件必填)。
- **补充资料**：备注(≤500)、附件(crm-file)。

## 待拍板点（research 中逐一给推荐 + grill）

1. 战略协议等级 / 已成交VIP等级 是否主表冗余快照列（战略协议实体划出）？
2. 父子客户：自关联 `parent_customer_id` + 防环校验口径。
3. 客户类型字典分组（`customer_type`）取值：甲方(企业/政府/普教/中高职/高校)… 需列全。
4. 客户星级/关系星级：字典 or 定长枚举(一~五星)？
5. 冗余快照列（列表免 join）：最近跟进时间、关联业务计数(商机/项目)、owner 名快照。
6. DataScope：`@DataScope(module="customer", ownerColumn="owner_user_id", deptColumn="owner_dept_id")`。
7. 索引：UNIQUE 统一社会信用代码 / owner+stage / owner_dept+archive_status(公海视图)。

## Answer

_(待 resolve)_