参考：数据库迁移规则

编写 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/