shanxia2.0/docs/crm-migration/plans/customer-pool/06-steps.md

公海池模块迁移方案 — 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行