RailwaySystem 数据库 V2 双门禁验证报告 (Gate A / Gate B)

本文档记录 RailwaySystem 数据库 V2 测试迁移准入阶段在真实环境下的双门禁（Gate A 与 Gate B）实测验证结果。

一、验证环境与连接上下文

配置项	实际环境参数	状态
数据库版本	KingbaseES V009R003C018	正常连通
数据库实例	`training`	确认
当前 Schema	`public`	确认
会话 search_path	`public, sys_catalog`	确认
数据库模式	`database_mode = mysql`	确认
JDBC 驱动	`com.kingbase8:kingbase8:8.6.0` (via preferQueryMode=simple)	官方原生驱动
连接安全性	脱敏隧道接入，无外部明文暴露	合规

二、Gate A: 事务回滚能力探测验证

2.1 执行目标与原则

验证脚本: RuoYi-Vue/sql/train/v2/000_tx_capability_probe.sql
执行目标: 探测当前 KingbaseES 实例在 database_mode = mysql 下是否支持 DDL + BEGIN / ROLLBACK 事务原子性回滚能力。
约束: 仅在临时对象 public.__railway_v2_tx_probe 上执行，绝不触碰任何业务表。

2.2 验证结果矩阵

探测步骤	预期行为	实际执行结果	判定
1. 显式开启事务	`BEGIN;`	事务启动成功	PASS
2. 探针表建表	`CREATE TABLE public.__railway_v2_tx_probe (id INTEGER);`	表创建成功	PASS
3. 探针表改表	`ALTER TABLE public.__railway_v2_tx_probe ADD COLUMN test_col INTEGER;`	字段追加成功	PASS
4. 显式回滚事务	`ROLLBACK;`	事务回滚成功	PASS
5. 匿名块断言	`DO $$ ... $$;` 检查表是否存在并发出提示	收到 `[Probe-PASS]` 通知	PASS
6. 最终只读断言	`SELECT count(*) FROM information_schema.tables WHERE ...` 为 0	`count = 0`	PASS

2.3 Gate A 关键原始日志

==================================================
>>> 正在启动 Gate A: 000_tx_capability_probe.sql
>>> 目标文件: RuoYi-Vue/sql/train/v2/000_tx_capability_probe.sql
==================================================
Database: training, Schema: public
Database Mode: mysql
Version: KingbaseES V009R003C018
>>> 开始执行 000_tx_capability_probe.sql 内容 (preferQueryMode=simple)...
Statement [1] update count: 0
>>> [STMT NOTICE/WARNING] >>> [Probe-PASS] 数据库 DDL 事务原子性验证通过：Kingbase 实例支持 DDL 事务回滚，符合 V2 迁移安全前提。
Statement [2] update count: 0
Statement [3] update count: 0
Statement [4] update count: 0
Statement [5] update count: 0
>>> 000_tx_capability_probe.sql 脚本执行完成，无异常抛出。
>>> 验证探针表残留情况 (SELECT count(*) FROM information_schema.tables)...
>>> public.__railway_v2_tx_probe count = 0
==================================================
>>> [GATE A FINAL EVALUATION]: PASS
==================================================

2.4 Gate A 结论

Gate A = PASS。当前 KingbaseES 实例完全支持本次 V2 迁移所依赖的 DDL 事务原子性回滚能力，探针表完全回滚且零残留。

三、Gate B: Phase 0.5 基线强校验验证

3.1 执行目标与原则

验证脚本: RuoYi-Vue/sql/train/v2/000_preflight.sql
执行目标: 纯只读核验当前真实数据库精确处于 Phase 0.5 基线状态，杜绝环境漂移或非纯净基线。

3.2 验证结果矩阵

核验分类	核验项	期望值	实测值	判定
Schema 确认	会话 Schema	`public`	`public`	PASS
业务表集合	14 张 Phase 0.5 历史表集合全等	仅这 14 张 `train_*`	14 张精确存在	PASS
表差异探测	`MISSING_TABLE`	0	0	PASS
表差异探测	`UNEXPECTED_TABLE`	0	0	PASS
数据行数基线	`train_teacher`	1 行	1 行	PASS
数据行数基线	其余 13 张旧业务表	全部 0 行	全部 0 行	PASS
V2 新增表	8 张 V2 新表存在性	全部不存在 (0)	全部不存在 (0)	PASS
主键约束	14 个旧表 PK 定义	14/14 匹配	14/14 匹配	PASS
自增列	6 个旧表 Identity 主键	6/6 匹配	6/6 匹配	PASS
唯一约束	7 组旧表 UNIQUE 约束	7/7 匹配	7/7 匹配	PASS
外键约束	24 组旧表 FK 约束 (名称/源列/引用表/引用列)	24/24 匹配	24/24 匹配	PASS
触发器	9 个 update_time 触发器	9/9 匹配	9/9 匹配	PASS
旧字段特征	旧列特征检查 (`c_id`, `t_id`, `lesson_start_time` 等)	符合旧模型	符合旧模型	PASS
系统底座表	`sys_*` 基础表数据完整性	1/106/15/44/500	1/106/15/44/500	PASS

3.3 14 张 Phase 0.5 业务表行数实测明细

train_teacher: 1 行
train_student: 0 行
train_course: 0 行
train_class_plan: 0 行
train_dormitory_info: 0 行
train_dorm_auth: 0 行
train_classroom_info: 0 行
train_training_site: 0 行
train_class_report: 0 行
train_electronic_board: 0 行
train_student_checkin: 0 行
train_score_info: 0 行
train_study_duration: 0 行
train_student_portrait: 0 行

3.4 8 张 V2 新增表独立只读探测

train_resource: 不存在 (count = 0)
train_course_resource: 不存在 (count = 0)
train_plan_course: 不存在 (count = 0)
train_enrollment: 不存在 (count = 0)
train_lesson: 不存在 (count = 0)
train_accommodation: 不存在 (count = 0)
train_score_item: 不存在 (count = 0)
train_student_score: 不存在 (count = 0)

3.5 Gate B 关键原始日志

==================================================
>>> 正在启动 Gate B: 000_preflight.sql
>>> 目标文件: RuoYi-Vue/sql/train/v2/000_preflight.sql
==================================================
Database: training, Schema: public
Database Mode: mysql
Version: KingbaseES V009R003C018

>>> 开始执行 000_preflight.sql 脚本 (只读强校验)...
[PREFLIGHT LOG] ==============================================================================
[PREFLIGHT LOG] >>> [Preflight-PASS] Phase 0.5 精确骨架校验全部通过！
[PREFLIGHT LOG] >>> 核验项: 14旧表 + 14 PK + 24 FK + 7 UNIQUE + 6 Identity + 9 Triggers + 行数基线
[PREFLIGHT LOG] >>> 判定结果: 当前数据库处于纯净 Phase 0.5 历史基线状态，允许执行 V2 迁移。
[PREFLIGHT LOG] ==============================================================================
>>> 000_preflight.sql 脚本执行成功，全部内部断言 PASS！

==================================================
>>> 开始收集 Phase 0.5 详细只读核验明细数据...
==================================================
Probe Table '__railway_v2_tx_probe' Count: 0

Actual train_* tables count: 14
Actual train_* tables list: [train_class_plan, train_class_report, train_classroom_info, train_course, train_dorm_auth, train_dormitory_info, train_electronic_board, train_score_info, train_student, train_student_checkin, train_student_portrait, train_study_duration, train_teacher, train_training_site]

Row count per train_* table:
  - train_class_plan: 0 行
  - train_class_report: 0 行
  - train_classroom_info: 0 行
  - train_course: 0 行
  - train_dorm_auth: 0 行
  - train_dormitory_info: 0 行
  - train_electronic_board: 0 行
  - train_score_info: 0 行
  - train_student: 0 行
  - train_student_checkin: 0 行
  - train_student_portrait: 0 行
  - train_study_duration: 0 行
  - train_teacher: 1 行
  - train_training_site: 0 行

Checking V2 new tables existence:
  - train_resource: NOT EXISTS (PASS)
  - train_course_resource: NOT EXISTS (PASS)
  - train_plan_course: NOT EXISTS (PASS)
  - train_enrollment: NOT EXISTS (PASS)
  - train_lesson: NOT EXISTS (PASS)
  - train_accommodation: NOT EXISTS (PASS)
  - train_score_item: NOT EXISTS (PASS)
  - train_student_score: NOT EXISTS (PASS)

Primary Keys count: 14 (expected: 14)
Foreign Keys count: 24 (expected: 24)
Unique constraints count: 7 (expected: 7)
Identity columns count: 6 (expected: 6)
Triggers count: 9 (expected: 9)

==================================================
>>> [GATE B FINAL EVALUATION]: PASS
==================================================

3.6 Gate B 结论

Gate B = PASS。当前数据库精确处于 Phase 0.5 迁移起点状态，无任何缺失、漂移或意外对象。

四、双门禁总体结论与状态说明

准入资格判定:
- Gate A: PASS
- Gate B: PASS
- 结论: 数据库 V2 迁移正式获得 Stage 1 (001_backup_current_schema.sql) 执行准入资格。
迁移脚本执行边界声明:
- 截至 Gate A/B 完成与报告生成时，001~010 正式数据库迁移脚本均未执行。
- 数据库依然保持纯净 Phase 0.5 状态。

8.8 KiB Raw Permalink Blame History Unescape Escape