# 生产数据同步（shanxia2.0）

将三地磅、山峡 1.0（CRM + 报销）、山峡 2.0 门户的生产数据，按阶段灌入 `shanxia2.0` 生产库。

## 与代码移植文档的关系

| 目录 | 用途 |
|------|------|
| `docs/crm-migration/` | CRM **功能**移植（前后端代码） |
| `docs/bx-migration/` | 报销 **功能**移植 |
| `docs/db-migration/` | 地磅 **功能**移植 |
| **`docs/data-migration/`** | **生产数据**同步过程记录（本文档体系） |

代码移植完成后，业务表结构已在 `docs/sql/shanxia2.0.sql`；本目录负责「如何把旧库数据填进去」。

## SQL 快照权威来源

| 系统 | 快照文件 | 说明 |
|------|---------|------|
| 地磅 | `docs/sql/dibang.sql` | 独立库，12 表 |
| 山峡 1.0 | `docs/sql/sx.sql` | CRM + 报销 + 若依 sys_*，157 表 |
| 山峡 2.0 | `docs/sql/shanxia2.0.sql` | 目标库，当前几乎无业务数据 |

## 文档索引

| 文件 | 内容 |
|------|------|
| **[PRODUCTION_MIGRATION_RUNLOG.md](./PRODUCTION_MIGRATION_RUNLOG.md)** | **生产迁移全过程续写记录（执行状态 / 命令 / 部门结论）** |
| [00-master-plan.md](./00-master-plan.md) | 总体规划、原则、阶段划分 |
| [01-user-account-inventory.md](./01-user-account-inventory.md) | **三系统用户账号明细**（供勾选移植范围） |
| [02-user-unification.md](./02-user-unification.md) | **用户统一方案**（中文名登录） |
| [05-id-preservation-policy.md](./05-id-preservation-policy.md) | **全局主键策略**：原系统 id 原样迁入（`str(bigint)`） |
| [03-process-logging.md](./03-process-logging.md) | **移植过程留痕规范**（日志模板、幂等、二次移植） |
| [04-execution-order.md](./04-execution-order.md) | 全局执行顺序与依赖 |
| [phase-0-foundation/step-01-dict.md](./phase-0-foundation/step-01-dict.md) | P0 字典（已分析：无需批量导入） |
| [phase-0-foundation/step-04-users.md](./phase-0-foundation/step-04-users.md) | P0 用户同步操作步骤 |
| [phase-1-crm/step-01-product-category.md](./phase-1-crm/step-01-product-category.md) | P1 产品分类 |
| [phase-1-crm/step-02-product.md](./phase-1-crm/step-02-product.md) | P1 产品主表 |
| [phase-1-crm/step-03-product-no-renumber.md](./phase-1-crm/step-03-product-no-renumber.md) | P1 产品编号统一 |
| [mappings/crm_product_no_mapping.csv](./mappings/crm_product_no_mapping.csv) | 产品编号旧→新映射（239 行） |
| [mappings/user_mapping.csv](./mappings/user_mapping.csv) | 三源用户 → 门户 `sys_user` 映射表 |
| [mappings/crm_product_category_id_mapping.csv](./mappings/crm_product_category_id_mapping.csv) | 产品分类 ID 映射 |
| [mappings/crm_product_id_mapping.csv](./mappings/crm_product_id_mapping.csv) | 产品 ID 映射（239 行恒等） |

## 当前状态

| 阶段 | 状态 | 说明 |
|------|------|------|
| P0 基础（字典/部门/角色/用户） | 进行中 | 字典已验收无需导入；用户已执行见 `mappings/user_mapping_result.csv` |
| P1 CRM 业务数据 | **P1-1c 产品编号已统一** | 产品 239 条 + 编号映射；见 `logs/2026-07-12-2106-product-no-renumber.md` |
| P2 报销业务数据 | 未开始 | 依赖 P0 |
| P3 地磅业务数据 | 脚本已有 | `backend/scripts/migrate_dibang_data.py` |
| P4 验收与切换 | 未开始 | — |

## 执行记录

每步执行后在对应 `phase-*/logs/` 下追加记录（禁止覆盖历史批次）。模板见各 `step-*.md` 文末。