# 数据库迁移

这些文件是历史增量，不是完整数据库。运行全部迁移前，必须导入经授权的脱敏基础结构，至少存在 `users.teacher`；其他业务表依赖私有 dbtable 模块，也需核对。不要用虚构的 users 表冒充完整初始化。

在上级工作区运行 `./scripts/workspace.ps1 migrate`，使用隔离的本地 MySQL 和 golang-migrate 记录版本。已有数据库须先核对 schema_migrations 与实际结构；禁止盲目 force。已执行的 SQL 不修改，新变更新增时间戳文件。

`node scripts/check-migrations.mjs` 仅检查命名、版本唯一性和非空。SQL 是否可执行须在脱敏基线数据库验证。现有迁移无 down 脚本，生产回退依赖经验证的备份恢复或补偿迁移，不自动回滚。