决策模块重构 - 前端联调方案

版本：v1.0 ｜ 日期：2026-09-09 ｜ 后端模块：yudao-module-bi（决策支持）
详细设计见 decision_module_redesign.md

涉及页面

• 决策总览大屏（/bi/decision-overview）
• 采购销售大屏（/bi/purchase-sales）
• 仓库大屏（/bi/warehouse）
• 生产设备大屏（/bi/production-equipment）
• 质量大屏（/bi/quality）
• 能耗监控大屏（/bi/energy，新增）
• 营销客户大屏（/bi/sales-customer，新增）
• 决策 BI 大屏 / 图表配置管理页 / 数据源配置管理页（既有）

API 变更说明

本次为新增接口，不改动既有接口签名。

1. KPI 历史快照趋势（趋势研判）

请求参数（Query）：

响应字段：

{
  "code": 0,
  "data": {
    "kpiCode": "device_operation_rate",
    "kpiName": "开机率",
    "category": "device_operation",
    "unit": "%",
    "periodType": "hour",
    "points": [
      {"time": "2026-09-09T02:00:00", "value": 100.0000},
      {"time": "2026-09-09T03:00:00", "value": 100.0000}
    ]
  }
}

快照由定时任务每小时聚合写入，KPI 定义后需等待下一整点聚合出数；无快照时 points 为空数组。

2. KPI 环比研判

响应字段：

3. 预测生成（扩展模型参数）

新增 Query 参数：

4. 基于 KPI 历史生成预测

请求参数（Query）：

响应： 生成的预测记录数（int）

注意： 历史快照不足时返回 BI_FORECAST_NO_HISTORY 错误码（code 非 0），前端需提示"暂无历史数据，无法预测"。

5. 既有接口（无变更）

• POST /bi/dashboard/{dashboardCode}/data — 大屏数据（沿用既有 bi_dashboard_frontend.md 联调约定）
• GET /bi/decision/forecast/list、POST /bi/decision/forecast/history、POST /bi/decision/forecast/generate-work-order、GET /bi/decision/alert/page 等

KPI 编码清单（前端展示用）

新增大屏 code 与数据带入说明

大屏统一走 POST /bi/dashboard/{code}/data，position 用 12 列栅格（{x,y,w,h}），图表类型 number/gauge/line/bar 渲染约定与既有 bi_dashboard_frontend.md 一致。

业务规则说明

注意事项

• 指标卡/仪表盘面板建议对"分类"做 tab 分组（能耗/设备/生产/质量/采购/营销/安全），共用同一套卡片组件。
• 预警中心页面（既有）已支持未处理计数与确认/处理操作，可直接复用本次 KPI 体系产出的 bi_alert_record。
• 权限点沿用既有：bi:decision:kpi:query/update、bi:decision:alert:query/confirm/handle，新接口不新增权限，无需改菜单。