57 lines
1.8 KiB
Markdown
57 lines
1.8 KiB
Markdown
# 模块迁移方案 — 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` | 追加路由 |
|