298 lines
8.8 KiB
Markdown
298 lines
8.8 KiB
Markdown
# 公海池模块迁移方案 — 06 分步实施计划
|
||
|
||
---
|
||
|
||
## 步骤 1：清理现有不符合规范的代码
|
||
|
||
### 目标
|
||
删除现有 shanxia2.0 中公海池相关的不规范代码，为重新移植做准备。
|
||
|
||
### 具体任务
|
||
1. 删除前端：`web-admin/src/views/crm/customer/pool/` 目录
|
||
2. 删除前端：`web-admin/src/api/crm/poolRule.ts`
|
||
3. 清理前端：`web-admin/src/api/crm/customer.ts` 中的公海池 API 函数
|
||
4. 删除后端：`backend/app/crud/crm/customer_pool.py`
|
||
5. 删除后端：`backend/app/crud/crm/pool_rule.py`
|
||
6. 删除后端：`backend/app/schemas/crm/customer_pool.py`
|
||
7. 删除后端：`backend/app/schemas/crm/pool_rule.py`
|
||
8. 清理后端：`backend/app/models/crm_models.py` 中的 CrmCustomerPool 和 CrmCustomerPoolRule
|
||
9. 清理后端：`backend/app/api/crm.py` 中的公海池相关路由
|
||
10. 删除后端：`backend/app/tasks/customer_pool.py`
|
||
|
||
### 涉及文件
|
||
- 上述所有文件
|
||
|
||
### 完成标准
|
||
- [ ] 所有公海池相关代码已删除
|
||
- [ ] 后端能正常启动（无 import 错误）
|
||
|
||
### 预计代码量
|
||
- 删除约 800 行
|
||
|
||
---
|
||
|
||
## 步骤 2：前端拷贝 — 公海池列表页
|
||
|
||
### 目标
|
||
从原 CRM 拷贝 `pool/index.vue` 到 shanxia2.0，保留完整功能。
|
||
|
||
### 具体任务
|
||
1. 拷贝 `shanxia/crm/web/src/views/crm/pool/index.vue` → `web-admin/src/views/crm/customer/pool/index.vue`
|
||
2. 不做任何修改，先保留原版代码
|
||
|
||
### 涉及文件
|
||
- `web-admin/src/views/crm/customer/pool/index.vue`（新建）
|
||
|
||
### 完成标准
|
||
- [ ] 文件已拷贝，内容与原 CRM 一致
|
||
|
||
---
|
||
|
||
## 步骤 3：前端拷贝 — 领取/分配弹窗
|
||
|
||
### 目标
|
||
拷贝 claimDialog 和 assignDialog 到 shanxia2.0。
|
||
|
||
### 具体任务
|
||
1. 拷贝 `claimDialog.vue` → `ClaimDialog.vue`
|
||
2. 拷贝 `assignDialog.vue` → `AssignDialog.vue`
|
||
|
||
### 涉及文件
|
||
- `web-admin/src/views/crm/customer/pool/components/ClaimDialog.vue`（新建）
|
||
- `web-admin/src/views/crm/customer/pool/components/AssignDialog.vue`（新建）
|
||
|
||
### 完成标准
|
||
- [ ] 两个弹窗文件已拷贝
|
||
|
||
---
|
||
|
||
## 步骤 4：前端适配 — pool/index.vue script 部分
|
||
|
||
### 目标
|
||
逐行审阅并适配 pool/index.vue 的 `<script>` 部分。
|
||
|
||
### 具体任务
|
||
1. 移除 `getCurrentInstance()` / `proxy`，改用直接 API 调用
|
||
2. 替换 `proxy?.useDict('xxx')` → `dictStore.getOptions('xxx')`
|
||
3. 替换 `proxy?.$modal.msgSuccess` → `ElMessage.success`
|
||
4. 移除手动 import（Element Plus 自动导入）
|
||
5. 替换 API 调用：`request({ url, method })` → `request.post(url, data)`
|
||
6. 创建 `web-admin/src/api/crm/pool.ts` 统一公海池 API
|
||
|
||
### 涉及文件
|
||
- `web-admin/src/views/crm/customer/pool/index.vue`
|
||
- `web-admin/src/api/crm/pool.ts`（新建）
|
||
|
||
### 完成标准
|
||
- [ ] 无 proxy/getCurrentInstance 残留
|
||
- [ ] 无手动 Element Plus import
|
||
- [ ] API 调用使用 shanxia2.0 风格
|
||
|
||
---
|
||
|
||
## 步骤 5：前端适配 — pool/index.vue template + style
|
||
|
||
### 目标
|
||
适配模板和样式为 Fresh Mint 风格。
|
||
|
||
### 具体任务
|
||
1. 替换 `<el-card>` 布局 → `page-container` + `panel` 布局
|
||
2. 替换 `<right-toolbar>` → `list-toolbar`
|
||
3. 替换 `<dict-tag>` → `<el-tag>` + dictStore
|
||
4. 添加模块标题竖线样式（`title-bar-heading`）
|
||
5. 弹窗适配：`label-width` → `label-position="top"`，添加 `dialog-form-layout`
|
||
6. 替换 UnoCSS 类 → SCSS/Tailwind
|
||
7. 添加 `<el-icon>` 到所有按钮
|
||
|
||
### 涉及文件
|
||
- `web-admin/src/views/crm/customer/pool/index.vue`
|
||
|
||
### 完成标准
|
||
- [ ] 无 el-card / right-toolbar / dict-tag 残留
|
||
- [ ] 按钮 icon 齐全
|
||
- [ ] 弹窗符合 dialog-form-layout 标准
|
||
|
||
---
|
||
|
||
## 步骤 6：前端适配 — ClaimDialog 和 AssignDialog
|
||
|
||
### 目标
|
||
适配两个弹窗组件。
|
||
|
||
### 具体任务
|
||
1. 移除 proxy/getCurrentInstance
|
||
2. 替换消息提示为 ElMessage
|
||
3. 弹窗样式适配（label-position="top"，icon 按钮）
|
||
4. AssignDialog 中 `listUser` API 替换为 shanxia2.0 的用户列表 API
|
||
|
||
### 完成标准
|
||
- [ ] 弹窗功能完整，符合 UI 规范
|
||
|
||
---
|
||
|
||
## 步骤 7：前端新增 — 规则管理页面
|
||
|
||
### 目标
|
||
新建公海池规则管理页面（原 CRM 无前端，shanxia2.0 新增）。
|
||
|
||
### 具体任务
|
||
1. 新建 `views/crm/customer/pool/RuleIndex.vue`（参考标准列表模板 `unit/index.vue`）
|
||
2. 新建 `views/crm/customer/pool/components/RuleDialog.vue`（新增/编辑弹窗）
|
||
3. 在 `api/crm/pool.ts` 中添加规则管理 API 函数
|
||
4. 在 `router/modules/sqxp.ts` 中添加规则管理路由
|
||
|
||
### 涉及文件
|
||
- `web-admin/src/views/crm/customer/pool/RuleIndex.vue`（新建）
|
||
- `web-admin/src/views/crm/customer/pool/components/RuleDialog.vue`（新建）
|
||
- `web-admin/src/api/crm/pool.ts`
|
||
- `web-admin/src/router/modules/sqxp.ts`
|
||
|
||
### 完成标准
|
||
- [ ] 规则 CRUD 页面可正常渲染
|
||
- [ ] 路由已配置
|
||
|
||
---
|
||
|
||
## 步骤 8：后端 DDL + Model
|
||
|
||
### 目标
|
||
创建正确的 DDL 和 SQLAlchemy Model。
|
||
|
||
### 具体任务
|
||
1. 创建增量 SQL 脚本 `docs/sql/incremental_crm_customer_pool.sql`
|
||
2. 修正 `crm_models.py` 中的 CrmCustomerPool（字段名回归 sx.sql）
|
||
3. 修正 `crm_models.py` 中的 CrmCustomerPoolRule（字段名/类型/值回归 sx.sql）
|
||
|
||
### 涉及文件
|
||
- `docs/sql/incremental_crm_customer_pool.sql`（新建）
|
||
- `backend/app/models/crm_models.py`
|
||
|
||
### 完成标准
|
||
- [ ] DDL 与 sx.sql 业务字段一致
|
||
- [ ] Model 字段与 DDL 一一对应
|
||
- [ ] 7 项公共字段适配正确
|
||
|
||
---
|
||
|
||
## 步骤 9：后端 Schema
|
||
|
||
### 目标
|
||
创建 Pydantic v2 Schema，字段名回归。
|
||
|
||
### 具体任务
|
||
1. 重写 `schemas/crm/customer_pool.py`：字段用 `fromUserId`, `toUserId`, `reason`, `createByName`
|
||
2. 重写 `schemas/crm/pool_rule.py`：字段用 `poolName`, `timeoutDays`, `sort`, `ruleType`(no_follow/no_deal), `status`(enable/disable)
|
||
|
||
### 完成标准
|
||
- [ ] Schema 字段名与 DDL 字段 camelCase 一致
|
||
- [ ] 校验规则与 Java Bo 一致
|
||
|
||
---
|
||
|
||
## 步骤 10：后端 CRUD — 操作记录
|
||
|
||
### 目标
|
||
重写 `crud/crm/customer_pool.py`。
|
||
|
||
### 具体任务
|
||
1. `_row_to_dict`：字段名回归（fromUserId, toUserId, reason, createByName）
|
||
2. `list_pool_records`：按 create_time DESC
|
||
3. `create_pool_record`：写入操作记录
|
||
4. `get_pool_record`：按 ID 查询
|
||
|
||
### 完成标准
|
||
- [ ] CRUD 函数与 API 规格对应
|
||
|
||
---
|
||
|
||
## 步骤 11：后端 CRUD — 规则管理 + 定时任务
|
||
|
||
### 目标
|
||
重写 `crud/crm/pool_rule.py` 和 `tasks/customer_pool.py`。
|
||
|
||
### 具体任务
|
||
1. pool_rule CRUD：list/add/update/delete/toggle/execute
|
||
2. execute_pool_rules：按 no_follow/no_deal 规则类型执行回收
|
||
3. 定时任务：check_protect_period_expired + remind_protect_expiring
|
||
|
||
### 完成标准
|
||
- [ ] 规则 CRUD 完整
|
||
- [ ] 执行逻辑与 Java 一致（no_follow/no_deal 分支）
|
||
|
||
---
|
||
|
||
## 步骤 12：后端 API 路由
|
||
|
||
### 目标
|
||
在 `api/crm.py` 中添加公海池相关路由。
|
||
|
||
### 具体任务
|
||
1. 公海池客户列表：`/customer/pool/list`
|
||
2. 操作记录：`/customer/pool/record/list`, `/customer/pool/record/detail`
|
||
3. 规则管理：`/customer/pool/rule/list|detail|add|update|delete|updateStatus|execute`
|
||
4. 领取/分配/放入：复用客户管理路由
|
||
|
||
### 完成标准
|
||
- [ ] 路由与 API 规格一一对应
|
||
- [ ] 前端 API URL 与后端路由匹配
|
||
|
||
---
|
||
|
||
## 步骤 13：字典数据导入
|
||
|
||
### 目标
|
||
将公海池相关字典从 sx.sql 导入 shanxia2.0。
|
||
|
||
### 具体任务
|
||
1. 检查 sx.sql 中 `sys_dict_data` 是否有 `crm_pool_*` 字典
|
||
2. 如有，导出 INSERT 语句到增量 SQL 脚本
|
||
3. 如没有，根据 Java Bo 注解创建字典数据
|
||
|
||
### 完成标准
|
||
- [ ] 字典值与原 CRM 一致
|
||
|
||
---
|
||
|
||
## 步骤 14：整体验证
|
||
|
||
### 目标
|
||
端到端验证所有公海池功能。
|
||
|
||
### 验证清单
|
||
- [ ] 页面正常渲染，无控制台错误
|
||
- [ ] 公海池客户列表加载正常
|
||
- [ ] 搜索筛选功能正常
|
||
- [ ] 统计信息显示正确
|
||
- [ ] 领取功能正常
|
||
- [ ] 分配功能正常
|
||
- [ ] 放入公海功能正常（从客户管理操作）
|
||
- [ ] 规则 CRUD 功能正常
|
||
- [ ] 规则启停功能正常
|
||
- [ ] 列设置功能正常
|
||
- [ ] UI 规范合规（见 07-verify.md）
|
||
|
||
### 参考
|
||
- 验证清单详见 `07-verify.md`
|
||
|
||
---
|
||
|
||
## 步骤汇总
|
||
|
||
| 步骤 | 类型 | 目标 | 涉及文件 | 预计代码量 |
|
||
|------|------|------|---------|-----------|
|
||
| 1 | 清理 | 删除不规范代码 | 10+ 文件 | -800行 |
|
||
| 2 | 前端拷贝 | 拷贝 pool/index.vue | 1 文件 | ~350行 |
|
||
| 3 | 前端拷贝 | 拷贝弹窗组件 | 2 文件 | ~200行 |
|
||
| 4 | 前端适配 | script 部分适配 | 2 文件 | ~100行改动 |
|
||
| 5 | 前端适配 | template/style 适配 | 1 文件 | ~150行改动 |
|
||
| 6 | 前端适配 | 弹窗适配 | 2 文件 | ~60行改动 |
|
||
| 7 | 前端新增 | 规则管理页面 | 3 文件 | ~400行 |
|
||
| 8 | 后端 | DDL + Model | 2 文件 | ~120行 |
|
||
| 9 | 后端 | Schema | 2 文件 | ~120行 |
|
||
| 10 | 后端 | 操作记录 CRUD | 1 文件 | ~100行 |
|
||
| 11 | 后端 | 规则 CRUD + 任务 | 2 文件 | ~250行 |
|
||
| 12 | 后端 | API 路由 | 1 文件 | ~200行 |
|
||
| 13 | 数据 | 字典导入 | 1 文件 | ~20行 |
|
||
| 14 | 验证 | 整体验证 | — | — |
|
||
| **合计** | | | | **~1170行** |
|