material_manage_system/docs/phase1-migration.md

第一阶段数据库迁移

本阶段将公司组织、业务伙伴、仓库/库位、物料基础配置和库存余额拆分到独立表。旧的 materials.current_stock 与 materials.warning_stock 暂时保留用于回滚观察，但应用代码不再读写。

执行顺序

1. 备份现有数据库，并暂停入库、出库和物料申请操作。

2. 为当前 shell 设置 DB_DSN，不要把账号密码写入仓库。

3. 在项目根目录运行：

   go run ./cmd/migrate
   

4. 确认迁移 001 到 006 均为非 dirty 状态，并检查 006 最后的库存差异查询没有结果。

5. 发布后端和前端，再恢复库存操作。

迁移器按文件名顺序执行并记录在 schema_migrations。MySQL DDL 可能隐式提交；如果某个版本为 dirty，迁移器会停止，必须根据报错的语句编号人工核对并修复，不能直接假定事务已回滚。

核对重点

• 每个旧用户均已分配默认组织和默认仓库。
• 旧物料数量与 inventory_balances.on_hand 汇总一致。
• 旧预警值与 stock_warning_rules.minimum_available 一致。
• materials API 响应不再包含库存数量和预警值。
• 公司组织位于 organizations，外部公司位于 business_partners，合作关系位于 organization_partners。

不要在生产库直接试跑。应先在数据库副本验证一次；当前自动化测试只验证迁移执行器和应用查询， 不替代生产数据副本的迁移核对。