商机管理模块迁移方案 — 01 概述
编写日期：2026-05-31
状态：实施中
迁移目标
将原 CRM（shanxia/crm）的 商机管理 能力完整移植到 shanxia2.0，行为以 Java 实现为准，UI 对齐 Fresh Mint 规范。
迁移范围
| 子模块 |
原 CRM 入口 |
说明 |
| 商机列表 |
crm/opportunity/index.vue |
我的/全部视图、筛选、批量操作、列设置 |
| 商机详情 |
crm/opportunity/detail.vue + OpportunityDetailDrawer.vue |
详情页与抽屉 |
| 商机表单 |
components/OpportunityForm.vue |
新增/编辑 |
| 阶段/赢输单 |
ChangeStageDialog / MarkWonDialog / MarkLostDialog |
状态流转 |
| 跟进 |
FollowDialog.vue |
商机跟进记录 |
| 批量操作 |
BatchUpdateStageDialog / BatchUpdateDateDialog |
批量改阶段/日期 |
| 看板 |
kanban.vue |
按阶段分列 |
| 漏斗 |
funnel.vue |
销售漏斗 |
| 统计 |
statistics.vue |
统计图表 |
涉及数据库表
| 表名 |
说明 |
crm_opportunity |
商机主表（门户已有简化版，需增量补字段） |
crm_opportunity_follow |
跟进记录 |
crm_opportunity_product |
商机产品 |
crm_opportunity_stage_log |
阶段变更日志 |
字典已在 shanxia2.0.sql：crm_opportunity_stage、crm_opportunity_status、crm_opportunity_follow_type、crm_opportunity_change_type、crm_opportunity_source。
当前 shanxia2.0 状态
| 层级 |
状态 |
处理策略 |
| 前端页面 |
已从原 CRM 拷贝 |
step-03 UI 适配 + API 改 POST |
| 前端 API |
门户 stub 版 |
按 clue 模式重写 index.ts |
| 后端 |
仅 list 接口 |
对照 Java 全量重写 |
| DDL |
主表缺字段 + 3 张关联表缺失 |
incremental_crm_opportunity.sql |
原 CRM 源码位置
| 类型 |
路径 |
| 前端 |
shanxia/crm/web/src/views/crm/opportunity/ |
| 前端 API |
shanxia/crm/web/src/api/crm/opportunity/ |
| Java Controller |
CrmOpportunityController.java 等 |
| Java Service |
CrmOpportunityServiceImpl.java 等 |
