shanxia2.0/docs/crm-migration/plan-template/01-overview.md

模块迁移方案 — 01 概述

模板说明：编写新模块迁移方案时，复制此模板到 docs/crm-migration/plans/{module}/01-overview.md 并填充内容。 参考范例：docs/客户管理及公海池迁移方案.md 第一章

---

迁移范围

本次迁移涉及 CRM 系统中的 [N] 个模块：

模块	功能概述	涉及表
[模块名]	[功能描述]	[表名列表]

涉及的数据库表

共 [N] 张业务表，均迁移至 shanxia2.0 数据库：

序号	表名	说明	原始 DDL 位置
1	crm_xxx	[说明]	docs/sql/sx.sql 第 XXX 行

迁移策略

方法论

采用「先拷贝原版，再逐段适配」：

1. 拷贝：从 CRM 前端源码完整拷贝 Vue 组件到 shanxia2.0，保留全部功能逻辑
2. 适配：逐行阅读后按需修改，适配门户 UI 规范（Fresh Mint）
3. 后端：理解 Java 业务逻辑后用 Python 重写

数据库适配规则

按 docs/crm-migration/ref-database-rules.md 执行 7 项公共字段适配，业务字段与 sx.sql 一致。

字典数据一致性

按通用指南 §强制要求，dict_type/dict_value/dict_label 与原 CRM 完全一致。

前端文件映射

原 CRM 文件	shanxia2.0 目标文件	功能说明
crm/{module}/index.vue	views/crm/{module}/index.vue	[说明]
...	...	...

后端文件清单

文件	路径	说明
Model	backend/app/models/crm_models.py	新增 [表名] Model
Schema	backend/app/schemas/crm/{module}.py	新建
CRUD	backend/app/crud/crm/{module}.py	新建
API	backend/app/api/crm.py	追加路由