# CRM业务表设计

## 1. 设计依据

本设计根据当前前端页面反推业务模型，涉及页面如下：

- `src/pages/Opportunities.tsx`：商机储备、商机详情、跟进记录
- `src/pages/Expansion.tsx`：销售人员拓展、渠道拓展、跟进记录
- `src/pages/Work.tsx`：外勤打卡、日报、历史记录、主管点评
- `src/pages/Profile.tsx`：个人资料、统计信息
- `src/pages/Dashboard.tsx`：首页统计、待办、动态

当前前端是展示型页面，未接入真实接口，因此以下设计属于“按现有前端信息推导出的第一版业务库设计”。

---

## 2. 业务模块拆分

建议按以下模块建表：

1. 组织与人员
2. 客户与商机
3. 拓展管理
4. 工作管理
5. 待办与动态（可选增强）

---

## 3. 核心实体关系

```text
部门 department
  └─< 用户 user

客户 customer
  └─< 商机 opportunity
         └─< 商机跟进记录 opportunity_followup

用户 user
  └─< 销售拓展 sales_expansion
         └─< 拓展跟进记录 expansion_followup

用户 user
  └─< 渠道拓展 channel_expansion
         └─< 拓展跟进记录 expansion_followup

用户 user
  └─< 外勤打卡 work_checkin
         └─< 打卡附件 work_checkin_attachment

用户 user
  └─< 日报 work_daily_report
         └─< 日报点评 work_daily_report_comment
```

---

## 4. 表设计

## 4.1 `sys_department` 部门表

用于承接“华东大区、华北大区”等组织信息。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| dept_code | varchar(50) | 部门编码 |
| dept_name | varchar(100) | 部门名称 |
| parent_id | bigint | 上级部门ID |
| manager_user_id | bigint | 部门负责人 |
| status | tinyint | 1启用 0停用 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |

---

## 4.2 `sys_user` 用户表

承接“张三、李四、王五”等销售人员，以及个人页中的员工资料。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| user_code | varchar(50) | 工号/员工编号 |
| username | varchar(50) | 登录账号 |
| real_name | varchar(50) | 姓名 |
| mobile | varchar(20) | 手机号 |
| email | varchar(100) | 邮箱 |
| dept_id | bigint | 所属部门 |
| job_title | varchar(100) | 职位，如高级销售 |
| status | tinyint | 1在职 0离职 |
| hire_date | date | 入职日期 |
| avatar_url | varchar(255) | 头像地址 |
| password_hash | varchar(255) | 登录密码摘要 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |

索引建议：

- `idx_user_dept_id(dept_id)`
- `uk_user_username(username)`
- `uk_user_mobile(mobile)`

---

## 4.3 `crm_customer` 客户表

来源于商机页面中的“客户名称”，如医院、学校、集团。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| customer_code | varchar(50) | 客户编码 |
| customer_name | varchar(200) | 客户名称 |
| customer_type | varchar(50) | 客户类型，如医院/高校/企业 |
| industry | varchar(50) | 行业 |
| province | varchar(50) | 省份 |
| city | varchar(50) | 城市 |
| address | varchar(255) | 地址 |
| owner_user_id | bigint | 当前负责人 |
| source | varchar(50) | 来源，如渠道推荐/市场活动 |
| status | varchar(30) | 潜在/跟进中/成交/流失 |
| remark | text | 备注 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |

索引建议：

- `idx_customer_owner(owner_user_id)`
- `idx_customer_name(customer_name)`

---

## 4.4 `crm_opportunity` 商机表

这是前端最核心业务表，对应“商机储备”页面。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| opportunity_code | varchar(50) | 商机编号，如 `HD-20231024-001` |
| opportunity_name | varchar(200) | 商机名称 |
| customer_id | bigint | 关联客户 |
| owner_user_id | bigint | 商机负责人 |
| amount | decimal(18,2) | 商机金额 |
| expected_close_date | date | 预计结单日期 |
| confidence_pct | tinyint | 把握度，0-100 |
| stage | varchar(50) | 阶段，如初步沟通/方案交流/招投标/商务谈判/已成交 |
| opportunity_type | varchar(50) | 类型，如新建/扩容 |
| product_type | varchar(100) | 产品类别，如VDI/VOI/IDV云桌面 |
| source | varchar(50) | 商机来源 |
| pushed_to_oms | tinyint | 是否已推送OMS |
| oms_push_time | datetime | 推送OMS时间 |
| description | text | 商机说明/备注 |
| status | varchar(30) | 正常/赢单/输单/关闭 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |

索引建议：

- `uk_opportunity_code(opportunity_code)`
- `idx_opportunity_customer(customer_id)`
- `idx_opportunity_owner(owner_user_id)`
- `idx_opportunity_stage(stage)`
- `idx_opportunity_expected_close(expected_close_date)`

---

## 4.5 `crm_opportunity_followup` 商机跟进记录表

对应商机详情里的“跟进记录”时间线。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| opportunity_id | bigint | 商机ID |
| followup_time | datetime | 跟进时间 |
| followup_type | varchar(50) | 跟进方式，如电话沟通/现场拜访/微信沟通 |
| content | text | 跟进内容 |
| next_action | varchar(255) | 下一步动作 |
| followup_user_id | bigint | 跟进人 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |

索引建议：

- `idx_opp_followup_opportunity(opportunity_id, followup_time desc)`
- `idx_opp_followup_user(followup_user_id)`

---

## 4.6 `crm_sales_expansion` 销售拓展表

对应“销售人员拓展”。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| candidate_name | varchar(50) | 候选人姓名 |
| mobile | varchar(20) | 手机号 |
| email | varchar(100) | 邮箱 |
| target_dept_id | bigint | 目标归属部门 |
| industry | varchar(50) | 擅长行业 |
| title | varchar(100) | 当前或目标职位 |
| intent_level | varchar(20) | 意向度，高/中/低 |
| stage | varchar(50) | 阶段，如初步沟通/方案交流 |
| has_desktop_exp | tinyint | 是否有云桌面经验 |
| in_progress | tinyint | 是否持续跟进中 |
| employment_status | varchar(20) | 在职/离职/已入职/已放弃 |
| expected_join_date | date | 预计入职日期，可为空 |
| owner_user_id | bigint | 负责人 |
| remark | text | 备注 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |

索引建议：

- `idx_sales_expansion_owner(owner_user_id)`
- `idx_sales_expansion_stage(stage)`
- `idx_sales_expansion_mobile(mobile)`

---

## 4.7 `crm_channel_expansion` 渠道拓展表

对应“渠道拓展”。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| channel_name | varchar(200) | 渠道名称 |
| province | varchar(50) | 所在省份 |
| industry | varchar(50) | 主要行业 |
| annual_revenue | decimal(18,2) | 年营收规模 |
| staff_size | int | 公司人数 |
| contact_name | varchar(50) | 联系人 |
| contact_title | varchar(100) | 联系人职务 |
| contact_mobile | varchar(20) | 联系电话 |
| stage | varchar(50) | 阶段，如初步接触/合作洽谈 |
| landed_flag | tinyint | 是否已落地 |
| expected_sign_date | date | 预计签约日期 |
| owner_user_id | bigint | 负责人 |
| remark | text | 备注 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |

索引建议：

- `idx_channel_expansion_owner(owner_user_id)`
- `idx_channel_expansion_stage(stage)`
- `idx_channel_expansion_name(channel_name)`

---

## 4.8 `crm_expansion_followup` 拓展跟进记录表

销售拓展和渠道拓展都存在“跟进记录”，建议共用一张表，通过对象类型区分。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| biz_type | varchar(20) | `sales` / `channel` |
| biz_id | bigint | 对应拓展对象ID |
| followup_time | datetime | 跟进时间 |
| followup_type | varchar(50) | 电话/微信/面谈等 |
| content | text | 跟进内容 |
| next_action | varchar(255) | 下一步动作 |
| followup_user_id | bigint | 跟进人 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |

索引建议：

- `idx_exp_followup_biz(biz_type, biz_id, followup_time desc)`
- `idx_exp_followup_user(followup_user_id)`

---

## 4.9 `work_checkin` 外勤打卡表

对应工作台里的“外勤打卡”。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| user_id | bigint | 打卡人 |
| checkin_date | date | 打卡日期 |
| checkin_time | datetime | 打卡时间 |
| longitude | decimal(10,6) | 经度 |
| latitude | decimal(10,6) | 纬度 |
| location_text | varchar(255) | 地址文本 |
| remark | varchar(500) | 备注说明 |
| status | varchar(30) | 正常/异常/补卡 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |

索引建议：

- `idx_checkin_user_date(user_id, checkin_date desc)`

---

## 4.10 `work_checkin_attachment` 打卡附件表

前端要求“现场照片必填”，建议单独拆附件表。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| checkin_id | bigint | 打卡ID |
| file_url | varchar(255) | 文件地址 |
| file_type | varchar(30) | image/audio/video |
| file_name | varchar(255) | 原始文件名 |
| file_size | bigint | 文件大小 |
| created_at | datetime | 创建时间 |

索引建议：

- `idx_checkin_attachment_checkin(checkin_id)`

---

## 4.11 `work_daily_report` 日报表

对应“每日表”和右侧历史日报。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| user_id | bigint | 提交人 |
| report_date | date | 日报日期 |
| work_content | text | 今日工作内容 |
| tomorrow_plan | text | 明日工作计划 |
| source_type | varchar(30) | manual/voice |
| submit_time | datetime | 提交时间 |
| status | varchar(30) | 待提交/已提交/已阅/已点评 |
| score | int | 评分 |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |

索引建议：

- `idx_daily_report_user_date(user_id, report_date desc)`
- `idx_daily_report_status(status)`
- `uk_daily_report_user_date(user_id, report_date)`

---

## 4.12 `work_daily_report_comment` 日报点评表

对应历史记录中的“主管点评”。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| report_id | bigint | 日报ID |
| reviewer_user_id | bigint | 点评人 |
| score | int | 评分 |
| comment_content | text | 点评内容 |
| reviewed_at | datetime | 点评时间 |
| created_at | datetime | 创建时间 |

索引建议：

- `idx_report_comment_report(report_id)`

---

## 4.13 `work_todo` 待办表（建议补充）

首页有“待办事项”，虽然现在是静态数据，但真实业务通常需要。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| user_id | bigint | 所属用户 |
| title | varchar(200) | 待办标题 |
| biz_type | varchar(30) | opportunity / expansion / report / other |
| biz_id | bigint | 业务对象ID |
| due_date | datetime | 截止时间 |
| status | varchar(20) | todo / done / canceled |
| priority | varchar(20) | high / medium / low |
| created_at | datetime | 创建时间 |
| updated_at | datetime | 更新时间 |

---

## 4.14 `sys_activity_log` 动态日志表（建议补充）

首页“最新动态”适合由统一动态表驱动。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | bigint PK | 主键 |
| biz_type | varchar(30) | 业务类型 |
| biz_id | bigint | 业务ID |
| action_type | varchar(50) | 如商机阶段更新/日报点评/新增渠道 |
| title | varchar(200) | 动态标题 |
| content | varchar(500) | 动态描述 |
| operator_user_id | bigint | 操作人 |
| created_at | datetime | 创建时间 |

索引建议：

- `idx_activity_created(created_at desc)`
- `idx_activity_biz(biz_type, biz_id)`

---

## 5. 推荐枚举值

为了避免硬编码中文状态，建议状态字段统一使用编码值，前端再做字典映射。

### 商机阶段 `opportunity.stage`

- `initial_contact` 初步沟通
- `solution_discussion` 方案交流
- `bidding` 招投标
- `business_negotiation` 商务谈判
- `won` 已成交
- `lost` 已丢单

### 商机状态 `opportunity.status`

- `active`
- `won`
- `lost`
- `closed`

### 销售拓展意向 `sales_expansion.intent_level`

- `high`
- `medium`
- `low`

### 外勤打卡状态 `work_checkin.status`

- `normal`
- `abnormal`
- `reissue`

### 日报状态 `work_daily_report.status`

- `draft`
- `submitted`
- `read`
- `reviewed`

---

## 6. 第一版最小可落地表

如果先做 MVP，建议优先落以下 8 张：

1. `sys_department`
2. `sys_user`
3. `crm_customer`
4. `crm_opportunity`
5. `crm_opportunity_followup`
6. `crm_channel_expansion`
7. `work_checkin`
8. `work_daily_report`

这 8 张就能支撑目前前端大部分核心展示。

如果要把“拓展管理”做完整，再补：

1. `crm_sales_expansion`
2. `crm_expansion_followup`
3. `work_checkin_attachment`
4. `work_daily_report_comment`

---

## 7. 建表原则建议

1. 所有业务表统一保留 `created_at`、`updated_at`。
2. 负责人、创建人、点评人等人员字段统一关联 `sys_user.id`。
3. 跟进记录建议独立建表，不要直接塞进主表。
4. 金额统一用 `decimal(18,2)`，不要用字符串。
5. 时间类字段区分清楚 `date` 和 `datetime`。
6. 中文状态不要直接写死在数据库，建议存编码值。
7. 如果后续要对接 OMS，商机表中保留 `pushed_to_oms` 和外部系统单号字段会更稳妥。

---

## 8. 与前端页面的映射关系

### 商机页

- 列表：`crm_opportunity`
- 客户名称：`crm_customer`
- 详情跟进：`crm_opportunity_followup`

### 拓展页

- 销售拓展：`crm_sales_expansion`
- 渠道拓展：`crm_channel_expansion`
- 跟进记录：`crm_expansion_followup`

### 工作页

- 外勤打卡：`work_checkin`
- 打卡照片：`work_checkin_attachment`
- 日报：`work_daily_report`
- 主管点评：`work_daily_report_comment`

### 首页/我的

- 统计看板：由商机、拓展、打卡、日报聚合生成
- 待办事项：`work_todo`
- 最新动态：`sys_activity_log`
- 个人信息：`sys_user` + `sys_department`

---

## 9. 下一步建议

如果要继续往后端落地，建议按以下顺序推进：

1. 先定字段字典和状态流转
2. 再输出 MySQL DDL
3. 再补接口文档
4. 最后和前端页面一一对齐新增/编辑/详情接口

如果需要，我下一步可以直接继续帮你补一版 MySQL 建表 SQL。