# 能效管理与AI节能模块四级页面深化与 Demo-PRD 闸门

## 1. 目标任务说明

能效管理与 AI 节能模块在主 PRD 中已经定义了能效驾驶舱、能耗异常分析、AI 节能策略、节能任务闭环、效果评估、指标口径与数据质量、AI 节能服务状态和报告中心；页面深化文档又补充了 PUE/CLF 详情、策略详情、控制审批、执行验收、PLF/折损分析、AI 降级和回滚流程。当前 Vue Demo 已拆出能效总览、PUE 分析、用电分析、制冷能效、AI 节能策略、节能任务闭环、效果评估、AI 服务状态、能效配置中心和节能策略详情。

本模块必须做 4 级页面深化，是因为“能耗看板”不能代表“AI 节能闭环”。客户验收时需要看到从异常发现、归因解释、策略生成、审批发布、任务执行、现场证据、效果验收、服务降级、配置治理到报表审计的完整链路。如果只停留在三级页面或静态指标卡，会出现以下交付风险：

- 只有能效首页、PUE 趋势或节能率 KPI，不能证明策略能从建议进入审批、任务和验收。
- Demo 有“提交治理流程”“查看详情”等按钮，但 PRD 没有对应字段、状态机、审批节点和缺口处理。
- PRD 写了 AI 服务 502 降级、策略模拟、回滚条件和数据质量阻断，但 Demo 未显性展示降级边界或不可验收条件。
- 详情页只有基础对象信息，缺少 CMDB 对象、工作流、AI 盒子证据、时间线、数据质量和审计口径。
- 配置、报表、审计被写成抽象能力，无法按页面、Mock/API、状态机证据逐项验收。

本文件作为 16 能效管理与 AI 节能模块的四级页面深化基线和 Demo-PRD 一致性闸门，验收对象限定为：

- PRD：`16_能效管理与AI节能模块/PRD.md`
- 页面深化：`16_能效管理与AI节能模块/页面与用例深化.md`
- 标准交付包：`商业化模块Demo/16_能效管理与AI节能模块/00_标准交付包/*`
- Vue Demo 只读参考：`商业化模块Demo/16_能效管理与AI节能模块/vue-demo/**/*`

## 2. 四级页面树

| 中心 | 模块 | 三级页面 | 四级页面或操作面 | 覆盖类型 | Demo 页面/元素 |
|---|---|---|---|---|---|
| 能耗中心 | 能效管理与AI节能 | 能效总览/能效驾驶舱 | 全国/区域 KPI 下钻、PUE/CLF/节能率详情、风险对象下钻、节能机会清单、服务降级横幅 | 详情页/报表 | `/energy-ai/overview`，能效总览、风险对象、Top 对象、集成能力、`getDashboard()` |
| 能耗中心 | 能效管理与AI节能 | PUE分析 | PUE 趋势详情、基线对比、异常机房详情、归因证据抽屉、PUE 治理流程提交 | 详情页/审批 | `/energy-ai/pue`，PUE分析清单、查看详情、提交治理流程、`EAI-PUE-M3-001` |
| 能耗中心 | 能效管理与AI节能 | 用电分析 | 峰谷用电优化、IT/动力/照明/损耗分项、负载迁移建议、峰谷策略审批、异常用电处理 | 增删改查/审批 | `/energy-ai/power`，用电分析清单、B28峰谷用电优化、流程与证据 |
| 能耗中心 | 能效管理与AI节能 | 制冷能效 | 冷站 COP 详情、冷机/精密空调分析、送风温度策略、风道检查任务、现场证据 | 详情页/验收 | `/energy-ai/cooling`，制冷能效清单、A6冷站COP下降、AI盒子证据 |
| 能耗中心 | 能效管理与AI节能 | AI节能策略 | 生成策略、策略详情、收益仿真、风险评估、回滚条件、忽略原因、提交审批 | 增删改查/审批 | `/energy-ai/strategy`，AI节能策略、提交治理流程、`S1 AI送风温度策略` |
| 能耗中心 | 能效管理与AI节能 | 节能任务闭环 | 认领任务、转巡检/维护/维修/任务、推进状态、上传执行证据、申请回滚、提交复核 | 审批/验收 | `/energy-ai/task`，节能任务闭环、状态=处理中/待验收、工作流时间线 |
| 能耗中心 | 能效管理与AI节能 | 效果评估 | 基线期选择、验证期选择、节能率验收、异常剔除说明、置信度判定、验收结论 | 验收/报表 | `/energy-ai/effect`，效果评估、待验收对象、流程与证据 |
| 能耗中心 | 能效管理与AI节能 | AI服务状态 | aieconomy 502 探测、降级策略引擎、恢复检测、切换真实服务、影响页面清单 | 配置/审计 | `/energy-ai/service`，AI服务状态、`G2 AI服务降级监控`、服务不可用说明 |
| 能耗中心 | 能效管理与AI节能 | 能效配置中心 | 指标口径配置、模型参数、策略边界、审批规则、报告模板、配置版本发布 | 配置 | `/energy-ai/settings`，能效配置中心、`/api/energy-ai/settings` |
| 能耗中心 | 能效管理与AI节能 | 策略详情页 | 档案与基座、服务范围、盒子证据、时间线、工作流、CMDB 对象、责任人、验收期限 | 详情页/审计 | `/energy-ai/detail/:id`，档案与基座、服务范围、盒子证据、时间线 |
| 能耗中心 | 能效管理与AI节能 | 指标口径与数据质量 | PUE/WUE/CLF/UPS效率口径、测点完整率、采样延迟、单位映射、边缘在线率、阻断规则 | 配置/审计 | PRD 4.6；交付包 32 指标口径；配置中心与详情页承接 |
| 能耗中心 | 能效管理与AI节能 | 报告中心 | 节能周报、月报、策略复盘、客户材料、报表中心跳转、导出审计 | 报表/审计 | PRD 4.8；交付包 17 报表指标；Mock 聚合 `metrics.amount/sla` |

## 3. User Story 表

| 编号 | 角色 | 前置条件 | 主流程 | 异常分支 | 成功标志 | 对应 Demo 页面/元素 |
|---|---|---|---|---|---|---|
| 16-US-01 | 运营经理 | 已进入能耗中心，具备能效总览权限 | 打开能效总览，查看 PUE、AI 后 CLF、综合节能率、预计节约电费、风险对象和服务降级提示 | `/api/energy-ai/overview` 失败时展示重试和降级说明；无数据时提示检查 CMDB/映射/TDengine | 10 秒内能判断节能收益、风险数量和待处理对象 | `/energy-ai/overview`；能效总览、metrics、Top 对象、集成能力 |
| 16-US-02 | 能耗管理员 | M3 数据中心存在 PUE 异常对象 `EAI-PUE-M3-001` | 进入 PUE 分析，筛选 M3，点击查看详情，核对基线、当前值、CMDB 对象、工作流和 AI 盒子证据 | 测点缺失或数据质量低时转入数据质量提示，不允许正式发布策略 | 明确 PUE 偏高对象、证据和下一步治理流程 | `/energy-ai/pue`；PUE分析清单、查看详情、`/energy-ai/detail/:id` |
| 16-US-03 | 动力专家 | B28 存在峰谷用电优化对象 | 在用电分析页查看 IT/动力/峰谷用电对象，提交治理流程并填写迁移负载或错峰建议 | 负载迁移影响 SLA、PDU 负载或租户边界时需要升级审批 | 生成工作流实例，时间线追加治理流程节点 | `/energy-ai/power`；B28峰谷用电优化、提交治理流程、`submitWorkflow` |
| 16-US-04 | 制冷专家 | A6 冷站 COP 下降且已有 AI 盒子证据 | 在制冷能效页查看 COP 下降对象，打开详情，核对冷站/精密空调/风道证据后提交现场核验 | AI 盒子离线时允许人工补录，但必须标注证据来源和待同步状态 | 对象进入处理中或待验收，证据链可追溯 | `/energy-ai/cooling`；A6冷站COP下降、流程与证据、盒子证据 |
| 16-US-05 | 能耗管理员 | AI 服务处于降级或策略需要审批 | 在 AI 节能策略页查看 S1 送风温度策略，确认预期收益、风险、回滚条件和适用范围，提交审批 | aieconomy 502 时必须标记“降级策略引擎”；高风险策略无回滚条件时禁止提交 | 生成审批/治理流程，策略状态可被跟踪 | `/energy-ai/strategy`；S1 AI送风温度策略、提交治理流程 |
| 16-US-06 | 机房现场人员 | 节能策略已转为任务，责任人已分派 | 在节能任务闭环页认领任务，执行风道/空调/UPS 操作，上传现场照片或 AI 盒子证据，推进到待验收 | 现场温度超阈值、工单失败或证据缺失时申请回滚或返工 | 任务时间线出现执行证据，状态进入待验收或已回滚 | `/energy-ai/task`；节能任务闭环、工作流、AI盒子证据 |
| 16-US-07 | 能耗管理员 | 策略执行完成 24 小时或达到验证周期 | 打开效果评估，选择基线期和验证期，查看节能量、费用、碳减排、置信度和异常剔除说明，提交验收结论 | 数据质量低、边缘离线、天气/IT 负载未归一化时标记“不可正式验收” | 形成节能率结论和复盘证据，状态进入已验收或验证失败 | `/energy-ai/effect`；效果评估、待验收、流程与证据 |
| 16-US-08 | 平台管理员 | 需要调整指标口径、模型参数或审批规则 | 在能效配置中心查看规则模板、CMDB 映射和 AI 盒子证据模板，保存配置版本并走审批发布 | 口径与指标仓库冲突、测点单位不一致或审批人缺失时禁止发布 | `/api/energy-ai/settings` 返回规则版本，配置变更写入审计 | `/energy-ai/settings`；规则模板、CMDB对象映射、AI盒子证据模板 |
| 16-US-09 | NOC/值班长 | AI 节能服务不可用或出现 502 | 打开 AI 服务状态页，查看 aieconomy 状态、降级模式、影响页面和恢复切换方式 | 若页面把 Mock 策略包装成真实 AI 服务，则不得验收 | 明确当前使用降级策略引擎，不影响能耗中心只读演示 | `/energy-ai/service`；G2 AI服务降级监控、AI服务状态 |
| 16-US-10 | 区域负责人 | 月度节能复盘需要对外汇报 | 从总览或效果评估进入报表口径，生成节能月报，包含节能率、费用、碳减排、异常说明、证据截图和未闭环风险 | 缺少报表口径、导出状态或审计记录时只能算演示通过，不能算正式验收 | 报表可追溯到策略、任务、验收和证据 | PRD 报告中心；交付包 17 报表指标；Mock 聚合 metrics |
| 16-US-11 | 审计/合规人员 | 需要追踪一次策略从建议到验收的全链路 | 打开策略详情页，核对档案、服务范围、盒子证据、时间线、工作流、责任人和验收期限 | 时间线缺少操作者、状态前后值或审批意见时要求补审计 Tab | 能还原谁在何时基于什么证据推进了策略 | `/energy-ai/detail/:id`；档案与基座、服务范围、盒子证据、时间线 |
| 16-US-12 | 用户智能体 | 智能体持有受限 token 并具备模块授权 | 调用能效 AI 查询或流程提交接口，获取对象、详情、设置和流程提交结果 | 智能体写操作必须先 dry-run 或受状态机约束；无权限返回 403 | GUI、API、CLI/MCP 的状态和审计行为一致 | 交付包 14 CLI与智能体调用；API `getList/getDetail/submitWorkflow` |

## 4. Demo-PRD 闸门矩阵

| PRD能力点 | PRD文件位置 | Demo页面/元素 | Mock/API/状态机证据 | 是否通过 | 缺口处理 |
|---|---|---|---|---|---|
| 能效驾驶舱展示 PUE、CLF、节能率、成本和待处理对象 | `16_能效管理与AI节能模块/PRD.md` 3 信息架构、4.1 能效驾驶舱 | `/energy-ai/overview`，能效总览、metrics、Top 对象、集成能力 | `getDashboard()`、`/api/energy-ai/overview`、Mock `dashboardData()` | 通过 | 后续需补 PRD 路由 `/energy/efficiency-ai/overview` 与 Demo `/energy-ai/overview` 的映射说明 |
| PUE 异常对象可从列表进入详情并看到证据链 | `PRD.md` 4.2 能耗异常分析页；页面深化 2 四级页面树 | `/energy-ai/pue`，PUE分析清单、查看详情、`/energy-ai/detail/:id` | Mock record `EAI-PUE-M3-001`，`getDetail(id)`，evidence/timeline | 通过 | 归因瀑布图和 TDengine/Grafana 缩略证据仍需补成真实组件或静态模拟块 |
| 用电分析覆盖峰谷优化、负载迁移和治理流程 | `PRD.md` 4.2 归因维度、4.3 策略类型；页面深化 2 | `/energy-ai/power`，B28峰谷用电优化、提交治理流程 | Mock record `EAI-PWR-B28-002`，`submitWorkflow()` | 部分通过 | Demo 已有流程提交，但缺少峰谷电价、负载迁移约束和影响 SLA 的专用字段 |
| 制冷能效覆盖 COP、冷站、精密空调和现场证据 | `PRD.md` 4.3 策略类型、4.4 节能任务闭环；页面深化 2 | `/energy-ai/cooling`，A6冷站COP下降、流程与证据 | Mock record `EAI-CLD-A6-003`，boxId/evidence/timeline | 通过 | 需补冷机/水系统/风道温差指标字段，避免仅靠摘要表达 |
| AI 节能策略展示收益、风险、回滚条件、解释和审批 | `PRD.md` 4.3 AI节能策略页；8 高保真 Demo 开发提示 | `/energy-ai/strategy`，S1 AI送风温度策略、提交治理流程 | Mock record `EAI-AI-S1-004`，workflowId、`submitWorkflow()` | 部分通过 | Vue Demo 现有字段不含 explicit rollback/why/confidence，需在详情或策略卡补齐 |
| 节能任务闭环支持认领、审批、执行、待验证、回滚 | `PRD.md` 4.4 节能任务闭环页；5 主流程 | `/energy-ai/task`，节能任务闭环、状态=处理中/待验收 | 交付包 07 状态机；Mock status `处理中`、`待验收`；`submitWorkflow()` | 部分通过 | 需要补认领、上传执行证据、申请回滚和提交复核的独立操作面 |
| 效果评估支持基线期、验证期、节能率、置信度和异常剔除 | `PRD.md` 4.5 效果评估页；页面深化 3 核心操作页 | `/energy-ai/effect`，效果评估、待验收对象 | Mock record `EAI-AI-S1-004` status=待验收；交付包 32 指标口径 | 部分通过 | Vue Demo 未见基线/验证期选择和归一化说明，需补评估表单与验收结论 |
| 指标口径与数据质量阻断策略发布和正式验收 | `PRD.md` 4.6 指标口径与数据质量页；页面深化 3 | `/energy-ai/settings`，规则模板、CMDB 映射；交付包 32 | `/api/energy-ai/settings`、交付包 31 决策表 | 部分通过 | 缺少测点完整率、采样延迟、单位映射、边缘在线率等页面字段 |
| AI 节能服务状态真实展示 aieconomy 502 和降级边界 | `PRD.md` 4.7 AI节能服务状态页；8 开发提示 | `/energy-ai/service`，G2 AI服务降级监控、AI服务状态 | Mock record `EAI-SVC-G2-005` summary=Dify/OpsGPT不可用；service board | 通过 | 需在页面文案中明确 `aieconomy.meta42.indc.vnet.com` 502，而不是泛化为 Dify/OpsGPT |
| 能效配置中心维护指标、模型、策略边界和报告模板 | `PRD.md` 4.6、4.8；交付包 03 页面清单 | `/energy-ai/settings`，能效配置中心 | `getSettings()`、Mock `/api/energy-ai/settings` 返回规则模板/CMDB映射/AI盒子模板 | 通过 | 保存、发布、审批和版本回滚需要补写操作与状态机 |
| 策略详情页展示档案、服务范围、盒子证据和时间线 | `PRD.md` 4.2 证据链、4.4 任务字段；交付包 30 下钻规则 | `/energy-ai/detail/:id`，档案与基座、服务范围、盒子证据、时间线 | `getDetail(id)`；BizItem 字段 `cmdbObjects/boxId/workflowId/evidence/timeline` | 通过 | 需补数据质量、审批意见、字段前后值和审计日志 Tab |
| CMDB、工作流、AI盒子证据贯穿能效对象 | `PRD.md` 0 模块边界与复用原则、7 复用关系 | 各子板块清单和详情页：CMDB对象、AI盒子、流程与证据 | Mock records `cmdbObjects/boxId/workflowId/evidence` | 通过 | 真实联调阶段必须替换 Mock 为 CMDB/工作流/AI盒子接口 |
| 报告中心输出周报、月报、策略复盘和客户材料 | `PRD.md` 4.8 报告中心；交付包 17 报表指标 | 总览/效果评估/报告口径；交付包报表指标 | `dashboardData().metrics.amount/sla`；交付包 32 导出口径 | 部分通过 | Vue Demo 未见独立报告页、导出按钮状态和报表中心跳转 |
| 状态推进必须走服务端状态机和审计，不允许前端私改 | `PRD.md` 4.4 任务闭环；交付包 07 状态机、31 决策表 | 提交治理流程弹窗、状态标签、时间线 | `/api/energy-ai/workflow/submit` 返回 pushed: portal_todo/workflow/audit_log | 通过 | 状态枚举需从 normal/warning/critical 与中文状态建立映射，减少双口径 |
| 权限覆盖运维工程师、值班经理、总部专家、运维管理线、机房现场 | `PRD.md` 2 用户角色；交付包 33 权限矩阵 | 路由 meta roles | `vue-demo/src/router/modules/energyAi.ts` `ALL_ROLES` | 通过 | PRD 角色“运营经理/能耗管理员/NOC/售前”需与 Demo 角色建立映射表 |
| CRUD 操作面覆盖策略新建/编辑/忽略、配置保存、任务推进和报告生成 | `PRD.md` 4.3、4.4、4.6、4.8；页面深化 3 | Demo 现有刷新、查看详情、提交治理流程；文档中定义模拟收益、创建任务、申请回滚、生成报告 | `getList/getDetail/submitWorkflow/getSettings` | 不通过 | 当前 Vue Demo 未覆盖新增、编辑、删除/忽略、配置保存、报告生成的完整操作闭环，必须补页面或明确降级 |

## 5. 不通过闸门

以下任一情况出现时，16 能效管理与 AI 节能模块不得判定为 Demo-PRD 一致性验收通过：

1. 只有 `/energy-ai/overview` 首页或 KPI 卡，没有 `/energy-ai/detail/:id` 详情页，或详情页没有 CMDB 对象、工作流、AI 盒子证据和时间线。
2. PUE、用电、制冷、策略、任务、效果评估等子板块只是同一通用列表换标题，没有本板块对象、字段、证据或流程差异。
3. Demo 有“提交治理流程”“创建任务”“申请回滚”“生成报告”“模拟收益”等按钮，但没有对应 PRD 流程、字段、状态机、Mock/API 响应或失败提示。
4. PRD 写了 aieconomy 当前 502 和降级策略引擎，但 Demo 没有显性降级提示，或把 Mock 策略包装成真实 AI 节能服务。
5. PRD 写了策略收益、风险、回滚条件、解释依据和置信度，但 Demo 策略卡或详情页没有对应字段。
6. PRD 写了任务认领、审批、执行、待验证、验证失败、已回滚，但 Demo 只能提交一个通用流程，不能区分状态和操作。
7. 效果评估没有基线期、验证期、节能率、费用、碳减排、置信度、异常剔除和数据质量提示。
8. 数据质量低、测点缺失、单位映射错误、边缘离线或质量任务暂停时，Demo 仍允许正式发布策略或正式验收。
9. 能效配置中心只有只读模板，没有指标口径、模型参数、策略边界、审批规则、报告模板、配置版本和冲突校验。
10. 报表能力只有文字或按钮，没有报表指标口径、导出状态、报表中心跳转、生成记录或审计留痕。
11. Mock 数据没有 site、status、severity、cmdbObjects、boxId、workflowId、owner、evidence、timeline 等关键字段，无法支撑演示证据链。
12. 状态可以由前端私自改写，而不是通过 `/api/energy-ai/workflow/submit` 或状态机/工作流回写。
13. GUI、API、CLI/MCP 对同一对象返回的状态、权限、审计和错误码不一致。
14. Demo 页面元素存在，但无法指出 PRD 文件位置、Mock/API/状态机证据和缺口处理。
15. 路由口径与 PRD 口径脱节，且没有映射说明，例如 PRD 使用 `/energy/efficiency-ai/*`，Demo 使用 `/energy-ai/*` 却未说明归属能耗中心。

## 6. 当前结论

当前 16 能效管理与 AI 节能模块已经具备子板块级 Vue Demo 骨架、9 个可演示子板块、策略详情页、Mock 能效对象、CMDB/工作流/AI 盒子证据字段、流程提交接口和配置中心接口，能够支撑“能耗中心内的 AI 节能闭环”基础演示。

仍需按闸门补强的重点是：策略卡的回滚条件/解释依据/置信度字段、任务闭环的认领/上传证据/回滚/复核操作面、效果评估的基线和验证期表单、数据质量阻断字段、AI 服务状态对 `aieconomy.meta42.indc.vnet.com` 502 的显性提示、报告中心导出和审计、CRUD 完整操作面、PRD 路由与 Demo 路由映射。上述缺口不影响本文档作为 4 级页面深化基线，但在客户演示或外包验收前必须逐项关闭或明确降级说明。