blp/railwaysystem
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

文档修正：更新导航与迁移后引用

Browse Source
This commit is contained in:
wangzhibiao committed 2026-09-17 16:53:03 +08:00
1 parent f7db7b592c
commit dd2082cc39
18 files changed
+160 -148
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/database-v2/05_execution_contract.md
+15 -15
View File
@@ -1,7 +1,7 @@
# RailwaySystem 数据库 V2 迁移执行契约 (Execution Contract)
> **适用范围**：数据库 V2 迁移在测试环境与未来生产环境中的正式执行规范
> **技术基线**：KingbaseES V009R003C018 (`database=training`, `schema=public`, `database_mode=mysql`)
> **适用范围**：数据库 V2 迁移在测试环境与未来生产环境中的正式执行规范
> **技术基线**：KingbaseES V009R003C018 (`database=training`, `schema=public`, `database_mode=mysql`)
> **核心原则**：**双门禁强准入 (Gate A/B)、单文件显式事务、纯 SQL 执行器兼容、失败即刻熔断**
---
@@ -43,18 +43,18 @@ graph TD
| 阶段 | 脚本文件 | 事务边界 | 失败处理与影响 |
| :---: | :--- | :---: | :--- |
| **Gate A** | [`000_tx_capability_probe.sql`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/000_tx_capability_probe.sql) | 探针显式事务 | **强阻断**：实证探测实例 DDL 回滚能力。若表残留立即抛出异常并中止，严禁进入后续阶段 |
| **Gate B** | [`000_preflight.sql`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/000_preflight.sql) | 纯只读骨架断言 | **强阻断**：集合差集校验 14旧表PK、24旧表FK、7组UNIQUE、6个identity主键、9触发器与行数基线，任何不符立即中止 |
| **Stage 1** | [`001_backup_current_schema.sql`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/001_backup_current_schema.sql) | `BEGIN ... COMMIT` | **强阻断**：全量快照 14 张表至 `bak_v1_*`；若已存在备份表则阻断；失败全单回滚 |
| **Stage 2** | [`002_create_new_tables.sql`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/002_create_new_tables.sql) | `BEGIN ... COMMIT` | 创建 V2 新增 8 张表；严禁 `IF NOT EXISTS`；失败事务回滚，新表全部撤销 |
| **Stage 3** | [`003_alter_master_tables.sql`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/003_alter_master_tables.sql) | `BEGIN ... COMMIT` | 调整 8 张主数据表；移除旧触发器与阻断外键，添加 V2 新列；失败事务回滚 |
| **Stage 4** | [`004_rebuild_business_tables.sql`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/004_rebuild_business_tables.sql) | `BEGIN ... COMMIT` | 断言 0 行后重构 5 张业务表；失败事务回滚，原表结构保持不变 |
| **Stage 5** | [`005_constraints.sql`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/005_constraints.sql) | `BEGIN ... COMMIT` | 集中注入 13 组 UNIQUE、26 组 FK (NO ACTION)、9 组 CHECK；失败事务回滚 |
| **Stage 6** | [`006_indexes.sql`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/006_indexes.sql) | `BEGIN ... COMMIT` | 创建外键索引、排课多维复合索引及双非空部分唯一索引；失败事务回滚 |
| **-** | [`007_dicts.sql`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/007_dicts.sql) | - | **【本迁移流水线跳过不执行】** 业务字典留待应用接口及权限配置阶段接入 |
| **Stage 7** | [`008_migrate_teacher.sql`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/008_migrate_teacher.sql) | `BEGIN ... COMMIT` | 迁移并断言教师 1 行数据，固化 NOT NULL，安全清理旧列；失败事务回滚 |
| **Stage 8** | [`009_drop_legacy_score.sql`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/009_drop_legacy_score.sql) | `BEGIN ... COMMIT` | 断言 0 行后下线旧表 `train_score_info`；失败事务回滚，旧表完好保留 |
| **Stage 9** | [`010_verify.sql`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/010_verify.sql) | 纯只读深度断言 | **强阻断**：定义级全量验收 21 表、UNIQUE 列清单、FK NO ACTION、CHECK 表达式、12 Identity、默认值及系统表零受损 |
| **Gate A** | [`000_tx_capability_probe.sql`](../../RuoYi-Vue/sql/train/v2/000_tx_capability_probe.sql) | 探针显式事务 | **强阻断**：实证探测实例 DDL 回滚能力。若表残留立即抛出异常并中止，严禁进入后续阶段 |
| **Gate B** | [`000_preflight.sql`](../../RuoYi-Vue/sql/train/v2/000_preflight.sql) | 纯只读骨架断言 | **强阻断**：集合差集校验 14旧表PK、24旧表FK、7组UNIQUE、6个identity主键、9触发器与行数基线，任何不符立即中止 |
| **Stage 1** | [`001_backup_current_schema.sql`](../../RuoYi-Vue/sql/train/v2/001_backup_current_schema.sql) | `BEGIN ... COMMIT` | **强阻断**：全量快照 14 张表至 `bak_v1_*`；若已存在备份表则阻断；失败全单回滚 |
| **Stage 2** | [`002_create_new_tables.sql`](../../RuoYi-Vue/sql/train/v2/002_create_new_tables.sql) | `BEGIN ... COMMIT` | 创建 V2 新增 8 张表；严禁 `IF NOT EXISTS`；失败事务回滚，新表全部撤销 |
| **Stage 3** | [`003_alter_master_tables.sql`](../../RuoYi-Vue/sql/train/v2/003_alter_master_tables.sql) | `BEGIN ... COMMIT` | 调整 8 张主数据表；移除旧触发器与阻断外键，添加 V2 新列；失败事务回滚 |
| **Stage 4** | [`004_rebuild_business_tables.sql`](../../RuoYi-Vue/sql/train/v2/004_rebuild_business_tables.sql) | `BEGIN ... COMMIT` | 断言 0 行后重构 5 张业务表；失败事务回滚，原表结构保持不变 |
| **Stage 5** | [`005_constraints.sql`](../../RuoYi-Vue/sql/train/v2/005_constraints.sql) | `BEGIN ... COMMIT` | 集中注入 13 组 UNIQUE、26 组 FK (NO ACTION)、9 组 CHECK；失败事务回滚 |
| **Stage 6** | [`006_indexes.sql`](../../RuoYi-Vue/sql/train/v2/006_indexes.sql) | `BEGIN ... COMMIT` | 创建外键索引、排课多维复合索引及双非空部分唯一索引；失败事务回滚 |
| **-** | [`007_dicts.sql`](../../RuoYi-Vue/sql/train/v2/007_dicts.sql) | - | **【本迁移流水线跳过不执行】** 业务字典留待应用接口及权限配置阶段接入 |
| **Stage 7** | [`008_migrate_teacher.sql`](../../RuoYi-Vue/sql/train/v2/008_migrate_teacher.sql) | `BEGIN ... COMMIT` | 迁移并断言教师 1 行数据，固化 NOT NULL，安全清理旧列；失败事务回滚 |
| **Stage 8** | [`009_drop_legacy_score.sql`](../../RuoYi-Vue/sql/train/v2/009_drop_legacy_score.sql) | `BEGIN ... COMMIT` | 断言 0 行后下线旧表 `train_score_info`；失败事务回滚，旧表完好保留 |
| **Stage 9** | [`010_verify.sql`](../../RuoYi-Vue/sql/train/v2/010_verify.sql) | 纯只读深度断言 | **强阻断**：定义级全量验收 21 表、UNIQUE 列清单、FK NO ACTION、CHECK 表达式、12 Identity、默认值及系统表零受损 |
---
@@ -87,6 +87,6 @@ graph TD
- 若流水线中任何一个脚本执行报错，**严禁跳过该步骤继续执行后续脚本**！
- 单文件具备 `BEGIN ... COMMIT`，当前失败脚本的所有物理改动会自动回滚撤销。
2. **应急回滚调用准则**：
- 若在 Stage 2 ~ Stage 8 中途发生不可调和的异常，必须立即暂停，并由 DBA 评估调用 [`rollback/`](file:///Users/wzb/Desktop/项目/RailwaySystem/RuoYi-Vue/sql/train/v2/rollback/) 脚本；
- 若在 Stage 2 ~ Stage 8 中途发生不可调和的异常，必须立即暂停，并由 DBA 评估调用 [`rollback/`](../../RuoYi-Vue/sql/train/v2/rollback/) 脚本；
- 回滚流水线严格按照：`001_rollback_new_tables.sql` -> `002_rollback_modified_tables.sql` -> `003_restore_legacy_score.sql` 倒序执行；
- 回滚完毕后，必须运行 `000_preflight.sql` 校验是否完全恢复至 Phase 0.5 精确基线。