六、商机管理
菜单入口：CRM客户 → 商机管理（/crm/business）。商机是有明确成交预期的销售机会：挂在客户名下、带产品清单与金额、按阶段推进，赢单后转入合同。本章重点是状态组 + 阶段的推进模型和金额三元组的计算口径。
6.1 商机列表
页面操作：查询、创建、更新、删除、导出（变更状态在详情页操作）。
- 查询条件：商机名称；
- 数据范围页签：我负责的 / 我参与的 / 下属负责的；
- 列表展示：商机名称（点击进入详情）、客户名称、商机金额、预计成交日期、下次联系时间、负责人、所属部门、商机状态组、商机阶段等。
6.2 新建商机
| 字段 | 说明 |
|---|---|
| 商机名称 | 必填 |
| 客户名称 | 必填；从客户详情页新建时默认锁定该客户 |
| 负责人 | 必填，新建时默认当前登录人 |
| 商机状态组 | 必填，创建后不可修改（见 6.3） |
| 预计成交日期 | 选填 |
| 产品清单 | 子表，选择产品并录入数量 / 单价，金额自动计算 |
| 产品总金额 / 折扣后金额 | 自动计算，不可手改（见 6.4） |
| 整单折扣（%） | 手填，参与金额计算 |
| 备注 | 选填 |
从联系人详情页新建商机时，系统会自动建立该联系人与新商机的关联（见 联系人管理）。
6.3 状态组与阶段（推进模型）
商机的推进由两层结构定义：
| 层级 | 说明 |
|---|---|
| 状态组（crm_business_status_type） | 一套阶段流程模板，按部门适配（可指定适用的部门范围），例如销售一部 / 销售二部各用一套 |
| 组内阶段（crm_business_status） | 每个阶段带赢单率 percent（如初步接触 10%、方案报价 40%…），按 sort 排序组成推进顺序 |
业务规则：
- 新建商机默认落在所选状态组的第一个阶段（阶段列表按 sort 排序取第一个）；
statusTypeId创建后不可修改：编辑表单中状态组置灰，后端更新时也会忽略该字段——阶段只能在组内推进，不能跨组；- 状态组 / 阶段被商机使用后不可修改、删除，避免在途商机的阶段引用失效；
- 状态组与阶段的维护入口见"商机状态配置"。
6.4 金额三元组
| 字段 | 含义 | 来源 |
|---|---|---|
| totalProductPrice | 产品总价：产品清单各行金额自动合计 | 自动计算 |
| discountPercent | 整单折扣（%）：整单让利比例 | 手工填写 |
| totalPrice | 商机总金额 = 产品总价 − 折扣（折扣额 = 产品总价 × 折扣%），即列表展示的"商机金额" | 自动计算 |
调整产品清单或折扣后，商机总金额实时重算；商机金额是后续合同金额、销售业绩统计的取数基础。
6.5 赢单 / 输单：变更商机状态
入口：商机详情页 →【变更商机状态】弹窗，下拉同时列出两类选项：
- 本状态组内的各阶段——选项文案带"赢单率：x%"，选择后商机推进到该阶段；
- 三个结束状态——
| endStatus | 名称 | 赢单率 |
|---|---|---|
| 1 | 赢单（WIN） | 100% |
| 2 | 输单（LOSE） | 0% |
| 3 | 无效（INVALID） | 0% |
业务规则：
- 已结束的商机（endStatus 非空）不能再变更状态——赢单 / 输单 / 无效是终态，不支持"误点输单再改回"；
- 选择的目标与当前阶段相同、且结束状态也没变时，提交会报错（不允许提交无变化的变更）；
- 赢单后的下一步是发起合同（见 合同管理）。
6.6 详情页、团队协作与删除
商机详情页页签：跟进记录、详细资料、联系人、产品、合同、操作日志、团队成员。
- 团队成员：多人协作入口，可添加成员并授予只读 / 读写权限，详见 快速入门 的数据权限说明；
- 删除校验：商机关联了合同时不允许删除（先处理合同再删商机）；删除会连带删除其数据权限；
- 商机 → 合同：赢单后在商机上发起关联合同，链路见下一章。
📖 相关文档
- 合同管理（商机转合同）