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>
83 lines
3.7 KiB
Markdown
83 lines
3.7 KiB
Markdown
# CRM 产品迁移：表模型差异与脚本说明
|
||
|
||
> 对照：`docs/sql/sx.sql`（源） vs `docs/sql/shanxia2.0.sql`（门户最新）
|
||
> 脚本：`backend/scripts/migrate_crm_product_category.py`、`migrate_crm_product.py`
|
||
> ID 策略：原样 `str(源 bigint)`，见 [`../05-id-preservation-policy.md`](../05-id-preservation-policy.md)
|
||
|
||
---
|
||
|
||
## 1. 以前有没有脚本？能不能直接用？
|
||
|
||
| 脚本 | 有无 | 能否直接用 |
|
||
|------|------|------------|
|
||
| `migrate_crm_product_category.py` | 有（历史 P1） | **须保持 status 原样**：门户字典 `sys_normal_disable` 为 `0=正常/1=停用`（勿按 DDL「1启用」反转）。2026-07-31 曾误反转已回修。 |
|
||
| `migrate_crm_product.py` | 有 | **基本可用**（字段映射已覆盖当前门户列）。已补充 `--clear-target`、文档化字段差异。 |
|
||
| 品牌/别名 | 无（sx 无表） | 门户有 `crm_product_brand` / `crm_product_alias`，**不在本次从 sx 迁移范围**。 |
|
||
|
||
结论：**有历史脚本，但分类 status 不能直接用旧逻辑；产品主表脚本可在修正分类后继续用。**
|
||
|
||
---
|
||
|
||
## 2. `crm_product` 字段对照
|
||
|
||
| sx | 门户 | 处理 |
|
||
|----|------|------|
|
||
| `id` bigint | `id` varchar(64) | `str(id)` 原样 |
|
||
| `category_id` bigint | `category_id` varchar(64) | `str(category_id)` |
|
||
| `cost` | `cost_price` | 改名 |
|
||
| `min_price` | — | 丢弃 |
|
||
| `tenant_id` | `tenant_no` | 固定 `shanxia2.0` |
|
||
| `create_dept` bigint | `create_dept_id` varchar | 本脚本置 `''`（用户映射管 create_by） |
|
||
| `create_by` / `update_by` bigint | varchar | `user_mapping`（crm_user_id）；源 `1`→admin |
|
||
| `version` | — | 丢弃 |
|
||
| — | `is_toxic` / `is_explosive` | 默认 `0` |
|
||
| — | `order_num` | 默认 `0` |
|
||
| `status` on/off | `status` char(3) | 原样规范化 |
|
||
| 其余同名业务列 | 同名 | 直接映射 |
|
||
|
||
快照规模参考：sx.sql ≈ 248 INSERT；live 通常 `del_flag=0` 约 240+。
|
||
|
||
---
|
||
|
||
## 3. `crm_product_category` 字段对照
|
||
|
||
| sx | 门户 | 处理 |
|
||
|----|------|------|
|
||
| `id` / `parent_id` | varchar | `str(...)`；`0`→`'0'` |
|
||
| `sort` | `order_num` | 改名 |
|
||
| `status` `'0'正常/'1'停用` | 同左（字典 `sys_normal_disable`） | **原样保持，勿反转**（DDL 注释「1启用」易误导） |
|
||
| `ancestors` / `version` / `tenant_id` / `create_dept` | — / tenant_no / create_dept_id | 丢弃或门户惯例 |
|
||
| — | `category_code` / `level` | code=NULL；level 按树计算 |
|
||
|
||
---
|
||
|
||
## 4. 推荐执行顺序（未自动执行，需你确认后跑）
|
||
|
||
```bash
|
||
cd backend
|
||
export PATH="venv/bin:$PATH"
|
||
SX_URL='mysql+pymysql://USER:PASS@HOST:3306/sx'
|
||
UM=../docs/data-migration/mappings/user_mapping_result.csv
|
||
|
||
# 1) 分类（先清本表再灌，修正 status）
|
||
python scripts/migrate_crm_product_category.py --dry-run --env-file .env.production --source-url "$SX_URL" --user-mapping "$UM"
|
||
python scripts/migrate_crm_product_category.py --env-file .env.production --source-url "$SX_URL" \
|
||
--clear-target --user-mapping "$UM" \
|
||
--mapping-out ../docs/data-migration/mappings/crm_product_category_id_mapping.csv
|
||
|
||
# 2) 产品（先清本表再灌，id 与 sx 一致）
|
||
python scripts/migrate_crm_product.py --dry-run --env-file .env.production --source-url "$SX_URL" --user-mapping "$UM"
|
||
python scripts/migrate_crm_product.py --env-file .env.production --source-url "$SX_URL" \
|
||
--clear-target --user-mapping "$UM" \
|
||
--mapping-out ../docs/data-migration/mappings/crm_product_id_mapping.csv
|
||
```
|
||
|
||
可选后续：`renumber_crm_product_no.py --apply`（统一产品编号；与「id 保持一致」无关）。
|
||
|
||
---
|
||
|
||
## 5. 不在本次范围
|
||
|
||
- `crm_product_brand` / `crm_product_alias`（门户新能力，sx 无源数据）
|
||
- 地磅 cargos、测试库里混入的 UUID 产品行（`--clear-target` 会清掉目标租户产品后以 sx 为准）
|