营销管理 - 销售计划（销售目标）前端联调方案

涉及页面

• 营销管理 → 销售计划（菜单 1065000，组件 crm/salesTarget/index）
• 营销管理 → 达成分析（菜单 1065100，组件 crm/salesTarget/analysis/index）

业务流程与数据带入

1. 设定目标：管理员在「销售计划」页按周期（年/季/月）+ 维度（个人/部门/产品）设定销售目标。目标对象（用户/部门/物料）从系统下拉选择，目标指标（合同金额、回款金额、商机金额、新增客户数、新增合同数）手工录入。
2. 周期自动换算：前端只提交 periodType（1年/2季度/3月）与 periodValue（如 2026、2026-Q1、2026-07），后台自动换算周期起止时间并落库；列表/详情展示换算后的起止时间。
3. 状态自动判定：后台保存时按当前时间与周期自动判定状态（未生效/已生效/已结束），前端展示即可；仅「作废/恢复」由用户手动触发。
4. 达成统计自动带入：列表、详情、达成分析均返回实际达成（合同金额、回款金额、商机金额、新增客户数、新增合同数）与达成率，前端直接展示，无需另行调用统计接口。
5. 达成分析：用户在「达成分析」页选择周期（必选）+ 维度（可选）+ 状态（可选），后台按周期过滤返回目标列表（含实际达成与达成率）。

API

创建/更新请求参数（CrmSalesTargetSaveReqVO）

状态变更请求参数（CrmSalesTargetChangeStatusReqVO）

达成分析请求参数（CrmSalesTargetAnalysisReqVO）

响应字段（CrmSalesTargetRespVO）

目标基础字段（name/periodType/periodValue/startTime/endTime/targetDimension/status/remark/createTime/creator）之上，新增以下字段：

响应示例：

{
  "code": 0,
  "data": {
    "id": 1,
    "name": "2026年度销售目标-张三",
    "periodType": 1,
    "periodValue": "2026",
    "startTime": "2026-01-01 00:00:00",
    "endTime": "2027-01-01 00:00:00",
    "targetDimension": 1,
    "targetUserId": 1,
    "targetUserName": "张三",
    "contractTarget": 500000.00,
    "actualContractPrice": 32377.00,
    "contractRate": 6.48,
    "status": 1
  }
}

字段展示规则

业务规则说明

注意事项

• 达成率字段可能为 null，前端展示需兜底为 -，避免显示 0。
• 周期值格式严格：年 YYYY、季 YYYY-Q1~YYYY-Q4、月 YYYY-MM，前端表单校验需按此约束。
• 目标维度与目标对象互斥：维度=个人填 userId，部门填 deptId，产品填 itemId，其余留空；前端按维度切换表单项。
• 达成分析接口的 periodType + periodValue 为必填，未选周期时不应发起请求。
• 达成统计查询为逐条目标计算（约 5 条小 SQL），目标数量级几十~几百时性能可接受；若后续目标量级增大需改造为聚合统计，需提前知会后端。
• 「销售计划」页排序建议按创建时间倒序，与后台返回顺序一致（按 id 倒序）。