opportunity_management/README.md

商机管理模块 (Opportunity Management)

模块概述

商机管理模块提供完整的销售跟进和商机全生命周期管理功能，支持商机创建、阶段管理、漏斗分析和销售预测。

功能特性

2.1 商机管理（销售跟进模块）

2.1.1 商机全生命周期管理

• 商机创建：支持手动录入和线索转化，必填字段包括客户名称、预估金额、销售阶段、预计成交时间
• 阶段管理：自定义销售漏斗（初步接洽→需求确认→方案报价→合同谈判→成交），阶段变更需记录原因

2.1.2 商机分析

• 漏斗可视化：展示各阶段商机数量/金额占比，支持按区域、销售维度筛选
• 预测功能：基于历史转化率自动计算预计成交金额，偏差率≤15%

数据库表结构

opportunities (商机表)

• id: 商机ID (主键)
• customer_name: 客户名称 (必填)
• estimated_amount: 预估金额 (必填)
• current_stage: 当前销售阶段 (必填)
• expected_close_date: 预计成交时间 (必填)
• source_type: 来源类型 (manual=手动录入, lead=线索转化)
• owner_id: 负责人ID
• region: 区域
• created_at: 创建时间
• updated_at: 更新时间
• status: 状态 (active=活跃, won=成交, lost=丢单)

sales_stages (销售阶段表)

• id: 阶段ID (主键)
• stage_name: 阶段名称
• stage_order: 阶段顺序
• description: 阶段描述
• conversion_rate: 历史转化率
• is_active: 是否启用

opportunity_stage_history (商机阶段变更历史表)

• id: 历史记录ID (主键)
• opportunity_id: 商机ID
• from_stage: 原阶段
• to_stage: 目标阶段
• change_reason: 变更原因 (必填)
• changed_by: 变更人ID
• changed_at: 变更时间

opportunity_predictions (商机预测表)

• id: 预测记录ID (主键)
• opportunity_id: 商机ID
• predicted_amount: 预测金额
• confidence_level: 置信度
• prediction_date: 预测日期
• actual_amount: 实际金额 (成交后更新)
• deviation_rate: 偏差率

API接口

商机管理

• create_opportunity(): 创建商机
• update_opportunity_stage(): 更新商机阶段

数据分析

• get_funnel_analysis(): 获取销售漏斗分析数据
• get_sales_prediction(): 获取销售预测汇总

前端界面

• 商机列表CRUD界面
• 销售阶段管理界面
• 销售漏斗可视化图表
• 销售预测汇总卡片

安装部署

1. 将模块目录复制到 ~/repos/ 目录下
2. 运行主应用的 build.sh 脚本，自动处理数据库表创建和前端资源链接
3. 模块将自动集成到系统中

依赖要求

• ahserver >= 1.0.0
• sqlor-database-module >= 1.0.0
• bricks-framework >= 1.0.0