# 能效AI节能生产级 PRD（业务子板块深拆版）

## 1. 模块定位

能效AI节能属于智航平台`能耗中心`能力域。本版已从“通用模板页面”升级为“专业子板块产品结构”，所有子板块均在独立 Vue Demo、Mock、API、字段、业务表、埋点、CLI/智能体和一致性矩阵中同步体现。

## 2. 独立 Demo

- 独立工程：`vue-demo/`
- 默认路由：`/energy-ai/overview`
- 技术框架：Vue 3 / Vite / TypeScript / Element Plus / Pinia / Vue Router / MockJS
- 视觉框架：网梯标杆后台系统风格。

## 3. 专业子板块

- `能效总览`：PUE、能耗结构、节能量、AI策略收益总览
- `PUE分析`：园区/楼栋/机房PUE趋势、基准、偏差和预测
- `用电分析`：IT负载、动力、照明、损耗、峰谷电价和异常
- `制冷能效`：冷机、冷站、精密空调、水系统、热密度和COP
- `AI节能策略`：策略推荐、仿真、置信度、约束、审批发布
- `节能任务闭环`：策略执行、现场调参、盒子核验、回滚和验收
- `效果评估`：节能量、费用、碳减排、舒适度和风险评估
- `AI服务状态`：AI模型、Dify/OpsGPT/GBI可用性、降级和告警
- `能效配置中心`：指标口径、模型参数、策略边界、报告模板

## 4. 页面清单

| 路由 | 页面 | 目标 |
|---|---|---|
| `/energy-ai/overview` | 能效总览 | PUE、能耗结构、节能量、AI策略收益总览 |
| `/energy-ai/pue` | PUE分析 | 园区/楼栋/机房PUE趋势、基准、偏差和预测 |
| `/energy-ai/power` | 用电分析 | IT负载、动力、照明、损耗、峰谷电价和异常 |
| `/energy-ai/cooling` | 制冷能效 | 冷机、冷站、精密空调、水系统、热密度和COP |
| `/energy-ai/strategy` | AI节能策略 | 策略推荐、仿真、置信度、约束、审批发布 |
| `/energy-ai/task` | 节能任务闭环 | 策略执行、现场调参、盒子核验、回滚和验收 |
| `/energy-ai/effect` | 效果评估 | 节能量、费用、碳减排、舒适度和风险评估 |
| `/energy-ai/service` | AI服务状态 | AI模型、Dify/OpsGPT/GBI可用性、降级和告警 |
| `/energy-ai/settings` | 能效配置中心 | 指标口径、模型参数、策略边界、报告模板 |
| `/energy-ai/detail/:id` | 节能策略详情 | 360详情、CMDB、盒子、流程、证据、时间线 |

## 5. 业务闭环

主流程：子板块识别对象 -> 绑定CMDB影响范围 -> 生成低代码表单 -> 提交工作流 -> AI盒子/现场证据回传 -> 复核验收 -> 报表/指标仓库沉淀。

状态集合：`正常`、`预警`、`处理中`、`待验收`、`已关闭`。

## 6. 字段口径

核心对象 `energy_ai_record` 必须包含：`id`、`name`、`board`、`category`、`status`、`severity`、`healthScore`、`slaRate`、`riskCount`、`cmdbObjects`、`boxId`、`workflowId`、`owner`、`evidence`、`timeline`。

## 7. API

- `GET /api/energy-ai/overview`
- `GET /api/energy-ai/list`
- `GET /api/energy-ai/detail/{id}`
- `POST /api/energy-ai/workflow/submit`
- `GET /api/energy-ai/settings`

## 8. 验收结论

本模块必须按子板块验收，不能只验收总览/台账是否存在。每个子板块至少要看到：KPI、对象清单、CMDB引用、AI盒子证据、工作流动作和PRD映射。