193 lines
9.0 KiB
Markdown
193 lines
9.0 KiB
Markdown
# 公海池模块迁移方案 — 02 数据库表模型
|
||
|
||
> **规范约束**：`docs/crm-migration/ref-database-rules.md`
|
||
|
||
---
|
||
|
||
## 2.1 crm_customer_pool（公海池操作记录表）
|
||
|
||
### 2.1.1 原始 DDL（来自 sx.sql 第 859 行）
|
||
|
||
```sql
|
||
CREATE TABLE `crm_customer_pool` (
|
||
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
|
||
`customer_id` bigint(20) NOT NULL COMMENT '客户ID',
|
||
`customer_name` varchar(200) DEFAULT NULL COMMENT '客户名称(冗余)',
|
||
`operation_type` varchar(20) NOT NULL COMMENT '操作类型(into/claim/assign/recycle)',
|
||
`from_user_id` bigint(20) DEFAULT NULL COMMENT '原负责人ID',
|
||
`from_user_name` varchar(50) DEFAULT NULL COMMENT '原负责人姓名(冗余)',
|
||
`to_user_id` bigint(20) DEFAULT NULL COMMENT '新负责人ID',
|
||
`to_user_name` varchar(50) DEFAULT NULL COMMENT '新负责人姓名(冗余)',
|
||
`reason` varchar(500) DEFAULT NULL COMMENT '操作原因',
|
||
`tenant_id` varchar(20) DEFAULT '000000' COMMENT '租户编号',
|
||
`create_dept` bigint(20) DEFAULT NULL COMMENT '创建部门',
|
||
`create_by` bigint(20) DEFAULT NULL COMMENT '创建者(操作人)',
|
||
`create_by_name` varchar(50) DEFAULT NULL COMMENT '操作人姓名(冗余)',
|
||
`create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间(操作时间)',
|
||
`update_by` bigint(20) DEFAULT NULL COMMENT '更新者',
|
||
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP,
|
||
`del_flag` tinyint(1) DEFAULT '0',
|
||
`version` int(11) DEFAULT '0',
|
||
`remark` varchar(500) DEFAULT NULL,
|
||
PRIMARY KEY (`id`),
|
||
KEY `idx_customer_id` (`customer_id`),
|
||
KEY `idx_operation_type` (`operation_type`),
|
||
KEY `idx_from_user` (`from_user_id`),
|
||
KEY `idx_to_user` (`to_user_id`),
|
||
KEY `idx_create_time` (`create_time`),
|
||
KEY `idx_tenant` (`tenant_id`)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-客户公海池记录表';
|
||
```
|
||
|
||
### 2.1.2 迁移后 DDL
|
||
|
||
```sql
|
||
DROP TABLE IF EXISTS `crm_customer_pool`;
|
||
CREATE TABLE `crm_customer_pool` (
|
||
`id` varchar(64) NOT NULL COMMENT '主键ID（UUID）',
|
||
`customer_id` varchar(64) NOT NULL COMMENT '客户ID',
|
||
`customer_name` varchar(200) DEFAULT NULL COMMENT '客户名称(冗余)',
|
||
`operation_type` varchar(20) NOT NULL COMMENT '操作类型(into/claim/assign/recycle)',
|
||
`from_user_id` varchar(64) DEFAULT NULL COMMENT '原负责人ID',
|
||
`from_user_name` varchar(50) DEFAULT NULL COMMENT '原负责人姓名(冗余)',
|
||
`to_user_id` varchar(64) DEFAULT NULL COMMENT '新负责人ID',
|
||
`to_user_name` varchar(50) DEFAULT NULL COMMENT '新负责人姓名(冗余)',
|
||
`reason` varchar(500) DEFAULT NULL COMMENT '操作原因',
|
||
`create_by_name` varchar(50) DEFAULT NULL COMMENT '操作人姓名(冗余)',
|
||
`tenant_no` varchar(64) NOT NULL DEFAULT 'shanxia2.0' COMMENT '租户编号',
|
||
`order_num` int(11) DEFAULT NULL COMMENT '排序号',
|
||
`remark` varchar(512) DEFAULT NULL COMMENT '备注',
|
||
`create_by` varchar(64) DEFAULT NULL COMMENT '创建人ID',
|
||
`create_dept_id` varchar(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID',
|
||
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||
`update_by` varchar(64) DEFAULT NULL COMMENT '更新人ID',
|
||
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
`del_flag` smallint(6) NOT NULL DEFAULT '0' COMMENT '删除标记(0存在 1删除)',
|
||
PRIMARY KEY (`id`),
|
||
KEY `idx_customer_id` (`customer_id`),
|
||
KEY `idx_operation_type` (`operation_type`),
|
||
KEY `idx_from_user` (`from_user_id`),
|
||
KEY `idx_to_user` (`to_user_id`),
|
||
KEY `idx_create_time` (`create_time`),
|
||
KEY `idx_tenant` (`tenant_no`)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-客户公海池记录表';
|
||
```
|
||
|
||
### 2.1.3 字段对照表
|
||
|
||
| # | 数据库字段 | API 字段（camelCase） | 类型 | 必填 | 说明 |
|
||
|---|-----------|---------------------|------|------|------|
|
||
| 1 | id | id | string(UUID) | 自动 | 主键 |
|
||
| 2 | customer_id | customerId | string | 是 | 客户ID |
|
||
| 3 | customer_name | customerName | string | 否 | 客户名称(冗余) |
|
||
| 4 | operation_type | operationType | string | 是 | into/claim/assign/recycle |
|
||
| 5 | from_user_id | fromUserId | string | 否 | 原负责人ID |
|
||
| 6 | from_user_name | fromUserName | string | 否 | 原负责人姓名 |
|
||
| 7 | to_user_id | toUserId | string | 否 | 新负责人ID |
|
||
| 8 | to_user_name | toUserName | string | 否 | 新负责人姓名 |
|
||
| 9 | reason | reason | string | 否 | 操作原因 |
|
||
| 10 | create_by_name | createByName | string | 否 | 操作人姓名 |
|
||
|
||
### 2.1.4 与现有实现的差异（需修正）
|
||
|
||
| 现有字段名（错误） | 正确字段名（回归 sx.sql） |
|
||
|-------------------|-------------------------|
|
||
| `before_owner_user_id` | `from_user_id` |
|
||
| `before_owner_user_name` | `from_user_name` |
|
||
| `after_owner_user_id` | `to_user_id` |
|
||
| `after_owner_user_name` | `to_user_name` |
|
||
| `pool_reason` | `reason` |
|
||
| `customer_no` | **删除**（sx.sql 无此字段） |
|
||
| `recycle_rule_id` | **删除**（sx.sql 无此字段） |
|
||
|
||
---
|
||
|
||
## 2.2 crm_customer_pool_rule（公海池规则表）
|
||
|
||
### 2.2.1 原始 DDL（来自 sx.sql 第 892 行）
|
||
|
||
```sql
|
||
CREATE TABLE `crm_customer_pool_rule` (
|
||
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
|
||
`pool_name` varchar(100) NOT NULL COMMENT '规则名称',
|
||
`rule_type` varchar(20) NOT NULL COMMENT '规则类型(no_follow/no_deal)',
|
||
`timeout_days` int(11) NOT NULL COMMENT '超时天数',
|
||
`protect_days` int(11) NOT NULL DEFAULT '0' COMMENT '保护期天数',
|
||
`status` varchar(20) DEFAULT 'enable' COMMENT '状态(enable/disable)',
|
||
`sort` int(11) DEFAULT '0' COMMENT '排序号',
|
||
`tenant_id` varchar(20) DEFAULT '000000',
|
||
`create_dept` bigint(20) DEFAULT NULL,
|
||
`create_by` bigint(20) DEFAULT NULL,
|
||
`create_time` datetime DEFAULT CURRENT_TIMESTAMP,
|
||
`update_by` bigint(20) DEFAULT NULL,
|
||
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP,
|
||
`del_flag` tinyint(1) DEFAULT '0',
|
||
`version` int(11) DEFAULT '0',
|
||
`remark` varchar(500) DEFAULT NULL,
|
||
PRIMARY KEY (`id`),
|
||
KEY `idx_status` (`status`),
|
||
KEY `idx_rule_type` (`rule_type`),
|
||
KEY `idx_tenant` (`tenant_id`)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-客户公海池规则表';
|
||
```
|
||
|
||
### 2.2.2 迁移后 DDL
|
||
|
||
```sql
|
||
DROP TABLE IF EXISTS `crm_customer_pool_rule`;
|
||
CREATE TABLE `crm_customer_pool_rule` (
|
||
`id` varchar(64) NOT NULL COMMENT '主键ID（UUID）',
|
||
`pool_name` varchar(100) NOT NULL COMMENT '规则名称',
|
||
`rule_type` varchar(20) NOT NULL COMMENT '规则类型(no_follow/no_deal)',
|
||
`timeout_days` int(11) NOT NULL COMMENT '超时天数',
|
||
`protect_days` int(11) NOT NULL DEFAULT '0' COMMENT '保护期天数',
|
||
`status` varchar(20) DEFAULT 'enable' COMMENT '状态(enable/disable)',
|
||
`sort` int(11) DEFAULT '0' COMMENT '排序号',
|
||
`tenant_no` varchar(64) NOT NULL DEFAULT 'shanxia2.0' COMMENT '租户编号',
|
||
`order_num` int(11) DEFAULT NULL COMMENT '排序号',
|
||
`remark` varchar(512) DEFAULT NULL COMMENT '备注',
|
||
`create_by` varchar(64) DEFAULT NULL COMMENT '创建人ID',
|
||
`create_dept_id` varchar(64) NOT NULL DEFAULT '' COMMENT '创建人部门ID',
|
||
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
|
||
`update_by` varchar(64) DEFAULT NULL COMMENT '更新人ID',
|
||
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||
`del_flag` smallint(6) NOT NULL DEFAULT '0' COMMENT '删除标记(0存在 1删除)',
|
||
PRIMARY KEY (`id`),
|
||
KEY `idx_status` (`status`),
|
||
KEY `idx_rule_type` (`rule_type`),
|
||
KEY `idx_tenant` (`tenant_no`)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='CRM-客户公海池规则表';
|
||
```
|
||
|
||
### 2.2.3 字段对照表
|
||
|
||
| # | 数据库字段 | API 字段 | 类型 | 必填 | 说明 |
|
||
|---|-----------|---------|------|------|------|
|
||
| 1 | id | id | string(UUID) | 自动 | 主键 |
|
||
| 2 | pool_name | poolName | string | 是 | 规则名称 |
|
||
| 3 | rule_type | ruleType | string | 是 | no_follow / no_deal |
|
||
| 4 | timeout_days | timeoutDays | int | 是 | 超时天数（≥1） |
|
||
| 5 | protect_days | protectDays | int | 是 | 保护期天数（≥0） |
|
||
| 6 | status | status | string | 否 | enable / disable |
|
||
| 7 | sort | sort | int | 否 | 排序号 |
|
||
|
||
### 2.2.4 与现有实现的差异（需修正）
|
||
|
||
| 现有字段名/值（错误） | 正确字段名/值（回归 sx.sql） |
|
||
|----------------------|----------------------------|
|
||
| `rule_name` | `pool_name` |
|
||
| `limit_days` | `timeout_days` |
|
||
| `order_num`（作为排序字段） | `sort` |
|
||
| `rule_type` = `follow_time` / `deal_time` | `no_follow` / `no_deal` |
|
||
| `status` = `smallint(0/1)` | `varchar('enable'/'disable')` |
|
||
| `deal_status_limit` | **删除**（sx.sql 无此字段） |
|
||
| `description` | **删除**（sx.sql 无此字段） |
|
||
|
||
### 2.2.5 字典关联
|
||
|
||
| 字段 | 字典类型（dict_type） | 字典值 |
|
||
|------|----------------------|--------|
|
||
| rule_type | `crm_pool_rule_type` | `no_follow`=未跟进 / `no_deal`=未成交 |
|
||
| status | `crm_pool_rule_status` | `enable`=启用 / `disable`=禁用 |
|
||
| operation_type | `crm_pool_operation_type` | `into`=进入公海 / `claim`=领取 / `assign`=分配 / `recycle`=回收 |
|