kra-new/docs/sw6-to-kra

商务迁移维护入口

旧 Java 商务使用测试库 sw8，当前 Go 商务使用 sw9。两库来自相同线上副本；未执行正式库 sw6 迁移。

执行顺序

1. 准备完整业务副本及 SQL 要求的 26 张框架源表，保存数据库备份。
2. 在 统一迁移 SQL 开头修改 USE，当前为 USE sw9。用支持 DELIMITER 的客户端在同一连接执行，遇错停止。
3. 启动当前 Go 版本，执行版本迁移，补齐业务锁、密码重置表、附件引用和查询索引。大表首次建索引需要等待完成。
4. 配置主库和 lx、hw、yq、oa 数据源。配置和凭据保存在仓库外；数据库连接信息不写入本目录。
5. 对照 验收记录 与 汇总任务说明 复核接口和任务。迁入计划默认停用，启用前应确认业务所需运行时段。

SQL 自动区分首次迁移、已完成迁移的菜单调整和异常中间状态；不会对完成迁移的库重新导入账号。重复执行及旧表已归档/清理的路径均有演练记录。

当前 SQL v5 按 LF 规范化 SHA-256： 07e2c8395b6f43f064fe973407f374a962b39d07474bfba68aeb2b3c5ffe8bf2。

维护材料

• 验收与性能记录：数据、任务、已知契约差异和性能基线。
• 历史逐接口验收索引：63 项旧契约及 230 项检查；时间点为最近一次完整写入演练，不代表以后每轮都重跑写操作。
• 原生系统接口与旧别名、附件引用转换。
• 各域 *-source-notes.md：长期保留的查询、权限和统计口径。
• 当前接口审查：此次修复、测试范围与需继续验证的框架边界。

SQL 生成器位于旧仓库 script/sql/sw6_to_kra/build_sw7_migration.py。修改生成器后同步本目录统一 SQL，并重新核对散列及迁移结果；不要恢复分阶段 SQL 补丁。

阶段报告、重复 JSON、全部临时验证脚本已归档到本机仓库外 D:/Users/Yvan/backups/sw9/20261104_rehearsal/cleanup-archive/，最后保留的工具位于其中的 scripts-final/。项目不再保留 scripts 目录，Go 任务运行不依赖这些脚本。归档及相邻的运行配置、原始响应、分区备份不纳入 Git。历史索引中 reports 项的文件名可在归档内查找。