52 lines
2.0 KiB
Markdown
52 lines
2.0 KiB
Markdown
# 参考：数据库迁移规则
|
||
|
||
> 编写 DDL、Model、Schema 时加载此文档。
|
||
|
||
---
|
||
|
||
## 公共字段适配（7 项强制）
|
||
|
||
| 变更项 | 原 CRM（Java） | shanxia2.0 | 示例 |
|
||
|--------|---------------|------------|------|
|
||
| 主键 | `bigint(20) AUTO_INCREMENT` | `varchar(64) NOT NULL`（UUID） | `id varchar(64) NOT NULL COMMENT '主键ID（UUID）'` |
|
||
| 租户 | `tenant_id varchar(20)` | `tenant_no varchar(64)` | — |
|
||
| 创建部门 | `create_dept bigint(20)` | `create_dept_id varchar(64)` | — |
|
||
| 删除标记 | `del_flag tinyint(1)` | `del_flag smallint(6)` | — |
|
||
| 版本号 | `version int(11)` | 移除 | 不使用乐观锁 |
|
||
| 公共字段顺序 | 不统一 | `tenant_no → order_num → remark → create_by → create_dept_id → create_time → update_by → update_time → del_flag` | — |
|
||
| 字符集 | `utf8mb4` | `utf8mb4`（不变） | — |
|
||
|
||
## 业务字段对齐原则
|
||
|
||
除 7 项公共字段适配外，所有业务字段语义必须与原 CRM 完全一致：
|
||
|
||
- 字段名不变（`customer_name`、`deal_status` 等）
|
||
- 类型可等价或略宽（`varchar(20)` 保留，不得缩为 `char(1)`）
|
||
- 默认值不变（`status varchar(20) DEFAULT 'normal'`，不得改为 `DEFAULT '1'`）
|
||
- COMMENT 枚举不变
|
||
- 索引保留
|
||
|
||
## 字典数据迁移（强制）
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| `dict_type` 不可改 | 如 `crm_customer_status`，原样迁移 |
|
||
| `dict_value` 不可改 | 如 `on/off`、`normal/pool/invalid`，禁止改为 `1/0` |
|
||
| `dict_label` 不可改 | 展示文案以原 CRM 为准 |
|
||
| 数据来源 | 从 `sx.sql` 的 `sys_dict_type` / `sys_dict_data` 中筛选 `crm_%` 导入 |
|
||
|
||
禁止做法：
|
||
- ❌ 将 `on/off` 改为 `1/0`
|
||
- ❌ 将 `normal/pool/invalid` 改为 `1/2/3`
|
||
- ❌ 写兼容层做值转换
|
||
|
||
## DDL 检查清单
|
||
|
||
- [ ] 主键 `varchar(64) NOT NULL`
|
||
- [ ] 业务字段与 `sx.sql` 一致
|
||
- [ ] 公共字段按标准顺序排列
|
||
- [ ] 字符集 `utf8mb4`，引擎 `InnoDB`
|
||
- [ ] 所有字段有 COMMENT
|
||
- [ ] 索引与原 CRM 等价
|
||
- [ ] SQL 增量脚本保存到 `docs/sql/`
|