数据迁移框架
Data Migration Framework
版本化数据库 schema 迁移，支持自动迁移、安全检查、备份验证和格式兼容
子问题
1.Schema 版本追踪
2.自动迁移触发
3.迁移安全检查
4.旧格式兼容层
5.跨引擎数据提取的编译环境兼容
6.迁移目标服务器身份验证
7.迁移后独立重查验证
各项目的解法1 solutions
Signals
横向对比
| 维度 | beads |
|---|---|
| 迁移架构 | 双路径（CGO + sqlite3 CLI shim），共享 5 阶段安全流程 |
| 幂等机制 | 每个 migration 内部 columnExists/tableExists 检查，无版本号表 |
| 验证策略 | 独立连接重查 + count 校验 + 首尾 spot-check |
| 回滚机制 | 带时间戳备份 + 失败时删除目标目录 + 恢复 metadata.json |
| 兼容层设计 | sqlite3 CLI JSON 模式 + PRAGMA table_info 动态列检测 |
| 诊断能力 | Doctor 系统输出 MigrationValidationResult JSON，支持自动化消费 |
最佳实践
1.迁移前自动备份
2.安全检查防止数据丢失
3.shim 层兼容旧格式
4.断点续传支持
5.双路径提取覆盖所有编译环境
6.独立连接重查而非信任导入返回值
7.原子切换：验证通过后才更新配置和重命名源文件
8.Doctor 诊断输出机器可解析 JSON 供自动化消费