Appearance
迁移升级
面向实施交付。权威说明见 monorepo oars-java/oars-migration/README.md；运行期排障见 Flyway。
当前规则（摘要）
- 迁移 SQL 统一管理，扫描位置：
classpath:db/migration。 - 当前基线：
V20260428193000__baseline.sql。 - 旧
V1.x开发期脚本已归档，不应继续出现在 Flyway 历史中。 - 新脚本命名：
VyyyyMMddHHmmss__domain_action.sql。
升级前检查
- 备份数据库。
- 查看
flyway_schema_history，确认没有失败记录。 - 确认待合并脚本版本号全库唯一。
- 已执行的迁移脚本禁止改名和修改内容。
常见处理
- 新库：创建库后启动应用，让 Flyway 执行 baseline 和后续脚本。
- 已有业务表但无历史表：依赖
baseline-on-migrate=true标记为20260428193000。 - 旧历史残留：
flyway_schema_history里若还有V1.0.0～V1.1.19，需按 L2 README 处理，否则会校验失败。
生产回滚说明
生产环境的数据库回滚只能通过备份恢复或编写前向修复脚本处理，不允许直接修改已执行的迁移脚本。
L2 详细说明（monorepo）
| 主题 | 文档 |
|---|---|
| Flyway 全流程 | oars-java/oars-migration/README.md |
| 数据库连接 | oars-java/DATABASE-GUIDE.md |