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