七、合同管理
菜单入口：CRM客户 → 合同管理。合同是成交的凭证，走 BPM 审批流（流程 Key：crm-contract-audit），审批通过后才能回款。
页面操作：查询、创建、更新、删除、导出。
7.1 合同字段要点
| 字段组 | 字段 | 说明 |
|---|---|---|
| 关联 | 客户（必填）、商机（可选） | 关联商机后商机不可删除 |
| 签约 | 合同编号、签约时间（order_date）、签约人、签约联系人 | order_date 是业绩/排行榜统计的归属日期 |
| 金额 | 产品明细 + 整单折扣 | 合同总金额 = 明细合计 − 折扣（回款金额上限的基数） |
| 审批 | 流程编号 processInstanceId、审批状态 | 见下 |
| 其他 | 开始/结束时间、备注、附件 | 结束时间用于"即将到期"提醒 |
7.2 审批流（状态机）
草稿(未提交) --提交审批--> 审批中 --通过--> 审核通过
├--不通过--> 审核不通过（可编辑后重新提交）
└--取消----> 已取消业务规则：
- 只有未提交/审批中状态可编辑；
- 提交后进入流程中心审批，审批结果自动回写合同状态（本地事件 + MQ 双通道保障）；
- 删除限制：已产生回款记录的合同不可删除；删除商机前也会校验无关联合同。
7.3 审批通过后系统发生什么
这是合同的关键时点，通过后自动获得四项能力：
- 可以建回款：回款创建校验合同必须"审核通过"（未通过的合同报"合同未通过审核"）；
- 纳入到期提醒：按合同配置的提前天数进入 待办事项 "即将到期的合同"（需在 合同配置 开启提醒）；
- 纳入金额统计：排行榜/员工业绩/客户分析只统计审批通过的合同；
- 客户成交口径：客户"已成交"统计以存在审批通过合同为准。
7.4 典型操作流程
商机赢单 → 新建合同（关联客户/商机，录明细与折扣）→ 提交审批
→ 流程中心审批通过 → 制定回款计划 → 陆续登记回款（见第八章）