数据库约定

列名

MyBatis 关闭了下划线转驼峰。列名与 Java 字段同名，使用 camelCase（如 createTime），不要写成 create_time。

表名可用 snake_case（如 biz_order）。字段名、模块 JSON 使用 lowerCamelCase；模块标识使用 kebab-case。

平台迁移

平台表结构由启动时的版本化脚本执行。已经执行过的脚本禁止改内容、禁止改名；发现问题只能新增后续脚本。

新库启动会跑基线及之后的增量。升级前备份，见 迁移升级。

插件 SQL

客户专属表放在插件的 sql/ 目录：

• 初次安装：*.install.sql
• 停用入口：*.uninstall.sql（默认不删业务数据）
• 后续变更：sql/upgrade/ 追加，不改已执行文件

生成器在允许的环境可执行安装 SQL。生产变更仍按迁移纪律走，不要在生产库手工改历史记录凑校验值。