zlwuandCursor
10c3c5470c
Bundle pending backend/web-admin feature updates, data-migration scripts, and related docs so the V1.5 branch on the Tencent Cloud Gogs matches the current workspace (excluding local secrets). Co-authored-by: Cursor <cursoragent@cursor.com>
58 lines
3.4 KiB
Markdown
58 lines
3.4 KiB
Markdown
# 生产数据同步（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` 文末。
|