# 02 容量管理模块四级页面深化与 Demo-PRD 闸门

## 1. 目标任务说明

容量管理模块已经在主 PRD 中定义了“资源中心 -> DCIM 工作台 -> 容量管理”的产品定位，并覆盖容量总览、空间容量地图、容量预占、机柜容量详情、趋势预测、风险中心、规则配置和容量报表。现有 Vue Demo 则以 `/biz-capacity/*` 路由落成专业子板块：首页总览、空间、电力、制冷、网络、申请预占、风险治理、配置中心和隐藏详情页。

本次 4 级页面深化的目标，是把“页面存在”升级为“业务闭环可验收”：

- 把三级页面继续拆到详情页、操作面、弹窗、抽屉、审批/验收和配置发布面，避免只有驾驶舱和列表。
- 把 PRD 的四维容量、预占锁、审批、风险派工、配置、报表、审计要求，逐项绑定到 Demo 页面、Mock/API、状态机和字段证据。
- 建立 Demo-PRD 一致性闸门，后续验收时不能只看页面截图，必须同时看 PRD 位置、页面元素、Mock/API/状态机证据和缺口处理。
- 明确不通过条件，避免 Demo 有元素但 PRD 无字段、PRD 有流程但 Demo 无入口、按钮只有展示没有流程、详情页缺失审计证据等问题被误判通过。

本文件不修改 Demo 源码，仅基于 `02_容量管理模块/PRD.md`、`02_容量管理模块/页面与用例深化.md`、标准交付包和 `vue-demo` 只读结构补强验收闸门。

## 2. 四级页面树

| 中心 | 模块 | 三级页面 | 四级页面或操作面 | Demo 页面/元素 | 验收重点 |
|---|---|---|---|---|---|
| 资源中心 | 容量管理 | 容量总览 | 四维容量 KPI 详情 | `/biz-capacity/overview` KPI：子板块、纳管对象、风险对象、SLA、AI盒子证据、待办流程 | 总览必须能解释容量健康、风险和待办来源 |
| 资源中心 | 容量管理 | 容量总览 | 子板块风险分布 | `/biz-capacity/overview` 子板块风险分布、专业子板块入口 | 首页入口必须能下钻到专业板块 |
| 资源中心 | 容量管理 | 空间容量 | 空间对象列表 | `/biz-capacity/space` 容量清单、站点、状态、健康分、CMDB对象、AI盒子 | 覆盖空间容量对象检索和风险定位 |
| 资源中心 | 容量管理 | 空间容量 | 容量对象详情 | `/biz-capacity/detail/:id` 档案与基座、服务范围、盒子证据、时间线 | 详情页必须能追溯 CMDB、工作流、盒子证据和时间线 |
| 资源中心 | 容量管理 | 电力容量 | UPS/PDU 容量详情 | `/biz-capacity/power` 清单、`POWER-B28-UPS-01` Mock 记录 | 电力余量、N+1、负载预警需落到对象和证据 |
| 资源中心 | 容量管理 | 制冷容量 | 冷冻水/空调容量详情 | `/biz-capacity/cooling` 清单、`COOL-M3-CHW-02` Mock 记录 | 制冷冗余、热密度、现场核验需落到对象和流程 |
| 资源中心 | 容量管理 | 网络端口容量 | 端口预占详情 | `/biz-capacity/network` 清单、`NET-A6-UPLINK-03` Mock 记录 | 端口预占、释放确认和验收状态需可追踪 |
| 资源中心 | 容量管理 | 容量申请与预占 | 新建/提交治理流程弹窗 | `/biz-capacity/reservation` 提交治理流程、对象选择、意见、提交 | 覆盖新增/提交，不允许只有列表无操作 |
| 资源中心 | 容量管理 | 容量申请与预占 | 资源锁与审批详情 | `/biz-capacity/detail/:id` 工作流、到期/验收、时间线；`/api/biz-capacity/workflow/submit` | 预占必须关联审批实例和资源锁释放规则 |
| 资源中心 | 容量管理 | 容量风险治理 | 风险确认/派工操作面 | `/biz-capacity/risk` 提交治理流程、流程与证据、状态刷新 | 风险治理必须推进状态，不允许只有风险展示 |
| 资源中心 | 容量管理 | 容量配置中心 | 阈值/模型/预占策略配置清单 | `/biz-capacity/settings` 配置清单；`GET /api/biz-capacity/settings` | 配置项必须有版本、owner、说明和审批入口 |
| 资源中心 | 容量管理 | 容量配置中心 | 配置发布审批面 | `/biz-capacity/settings` 提交治理流程弹窗 | 发布配置需走工作流，不允许前端直接改阈值 |
| 资源中心 | 容量管理 | 容量报表 | 利用率/预占效率/闭环时长报表 | `/biz-capacity/overview` SLA、趋势、子板块风险分布；PRD 报表中心 | Demo 当前只展示 SLA/趋势摘要，正式报表导出需作为缺口跟踪 |
| 资源中心 | 容量管理 | 容量审计 | 状态流转与证据审计 | `/biz-capacity/detail/:id` 盒子证据、时间线；状态机 `capacity_status_log`、`capacity_audit_log` | 所有审批、验收、派工、配置发布必须留痕 |

## 3. User Story 表

| 编号 | 角色 | 前置条件 | 主流程 | 异常分支 | 成功标志 | 对应 Demo 页面/元素 |
|---|---|---|---|---|---|---|
| 02-US43-01 | 容量规划负责人 | 已登录并具备容量查看权限，Mock 返回 `/api/biz-capacity/list` | 进入容量总览，查看风险对象、待办流程和子板块入口，点击空间容量下钻 | `/api/biz-capacity/list` 失败时展示重试；无数据时展示初始化引导 | 10 秒内判断哪个子板块需要干预 | `/biz-capacity/overview` KPI、专业子板块入口、子板块风险分布 |
| 02-US43-02 | 机房运维工程师 | 已具备空间容量和详情权限，存在 `SPACE-M3-U-001` | 从空间容量进入清单，筛选对象，打开详情页查看 CMDB、工作流、盒子证据 | 对象不存在时详情回退为空态；无权限时隐藏敏感字段 | 能定位容量对象、责任人、证据和流程时限 | `/biz-capacity/space` 清单，`/biz-capacity/detail/:id` 档案与基座 |
| 02-US43-03 | 动力专业工程师 | 存在电力容量预警对象 `POWER-B28-UPS-01` | 进入电力容量，查看 UPS 容量水位、健康分、CMDB 对象和 AI 盒子证据 | 采集异常时不得自动转扩容，只能生成治理任务 | 电力风险有对象、状态、证据和责任人 | `/biz-capacity/power` 清单；Mock `status=预警`、`cmdbObjects`、`boxId` |
| 02-US43-04 | 制冷专业工程师 | 存在制冷容量处理中对象 `COOL-M3-CHW-02` | 进入制冷容量，打开对象详情，核对时间线和现场证据 | 盒子离线时进入待同步状态，允许人工补录但需标记来源 | 制冷风险从识别到复核的节点可追溯 | `/biz-capacity/cooling`，`/biz-capacity/detail/:id` 盒子证据、时间线 |
| 02-US43-05 | 网络工程师 | 存在端口预占对象 `NET-A6-UPLINK-03`，状态为待验收 | 进入网络端口容量，查看端口预占对象，打开详情核对到期/验收日期 | 验收证据不足时不能关闭预占；需退回补证 | 端口预占具备验收状态、到期时间、工作流实例 | `/biz-capacity/network`，详情页“到期/验收”“工作流” |
| 02-US43-06 | 业务申请人 | 具备容量申请与预占权限，存在 `RSV-G2-NEW-04` | 进入容量申请与预占，打开提交治理流程弹窗，选择对象，填写意见，提交 | 工作流失败时状态保持不变并提示失败原因；资源冲突返回 409 | 返回 `WF-CAP-*` 实例并刷新状态/时间线 | `/biz-capacity/reservation` 提交治理流程；`POST /api/biz-capacity/workflow/submit` |
| 02-US43-07 | 值班经理 | 存在容量风险对象，用户具备风险治理权限 | 进入容量风险治理，查看流程与证据，提交治理流程给专业工程师复核 | 采集质量不足时不能直接生成扩容，需发数据治理任务 | 风险进入处理中，时间线追加工作流提交记录 | `/biz-capacity/risk` 提交治理流程、流程与证据 |
| 02-US43-08 | 配置管理员 | 具备容量配置权限，存在配置模板 | 进入容量配置中心，读取规则模板、CMDB 映射、AI 盒子证据模板，提交发布审批 | 缺少测点映射或版本说明时禁止发布 | 配置有版本、owner、说明和审批流程 | `/biz-capacity/settings`；`GET /api/biz-capacity/settings` |
| 02-US43-09 | 审计人员 | 具备审计查看权限，业务对象已经发生状态推进 | 打开详情页，核对工作流、AI盒子、CMDB对象、证据和时间线 | 任一状态推进无 `workflowId` 或无证据来源时标记不通过 | 每次推进有业务表、状态日志、审计日志锚点 | `/biz-capacity/detail/:id`；状态机要求 `capacity_status_log`、`capacity_audit_log` |
| 02-US43-10 | 管理层 | 具备只读权限，模块已有容量对象和 SLA 数据 | 进入总览查看 SLA、风险对象、趋势和专业子板块分布 | 报表口径未发布时不能导出正式月报，只能预览 | 能看到容量风险闭环效率和对象分布 | `/biz-capacity/overview` SLA、趋势、风险分布；PRD 容量报表 |

## 4. Demo-PRD 闸门矩阵

| PRD能力点 | PRD文件位置 | Demo页面/元素 | Mock/API/状态机证据 | 是否通过 | 缺口处理 |
|---|---|---|---|---|---|
| 四维容量统一账本 | `PRD.md` 0、2、3、4.1 | `/biz-capacity/overview` 专业子板块入口，空间/电力/制冷/网络页面 | `records.board` 覆盖空间容量、电力容量、制冷容量、网络端口容量 | 通过 | 继续保留四维入口，不得退化为单一列表 |
| 容量总览风险和待办判断 | `PRD.md` 4.1，`页面与用例深化.md` 2 | `/biz-capacity/overview` 风险对象、待办流程、SLA、AI盒子证据 | `getList`、`dashboardData.metrics`、`riskCount`、`processingCount` | 通过 | 后续需补真实趋势图时仍沿用该闸门 |
| 空间容量下钻到详情 | `PRD.md` 4.2、4.4，`页面与用例深化.md` 2 | `/biz-capacity/space` 查看详情，`/biz-capacity/detail/:id` | `GET /api/biz-capacity/detail/{id}`，`SPACE-M3-U-001` | 通过 | 详情必须保留 CMDB、工作流、证据和时间线 |
| 电力容量风险对象 | `PRD.md` 4.1、4.6、6 | `/biz-capacity/power` 电力容量清单 | Mock `POWER-B28-UPS-01`、`status=预警`、`summary=UPS负载率 82%` | 通过 | 若后续要演示 N+1 计算，需补公式字段 |
| 制冷容量风险对象 | `PRD.md` 4.1、4.6、6 | `/biz-capacity/cooling` 制冷容量清单 | Mock `COOL-M3-CHW-02`、`status=处理中`、`riskCount=3` | 通过 | 采集异常和现场核验需继续绑定盒子证据 |
| 网络端口容量预占 | `PRD.md` 4.3、4.4、6 | `/biz-capacity/network` 网络端口容量清单 | Mock `NET-A6-UPLINK-03`、`status=待验收`、`summary=40G上联端口预占4个` | 通过 | 验收关闭前必须有释放确认或现场证据 |
| 容量申请与预占操作 | `PRD.md` 4.3、5.2，`页面与用例深化.md` 3 | `/biz-capacity/reservation` 提交治理流程弹窗 | `POST /api/biz-capacity/workflow/submit` 返回 `WF-CAP-*` | 通过 | 当前 Demo 是治理流程提交，不是完整三步推荐向导；正式验收需补推荐方案/资源锁明细 |
| 容量对象 360 详情 | `PRD.md` 4.4，`页面与用例深化.md` 2 | `/biz-capacity/detail/:id` 档案与基座、服务范围、盒子证据、时间线 | `BizItem` 字段：`workflowId`、`boxId`、`cmdbObjects`、`evidence`、`timeline` | 通过 | 不得用仅弹窗摘要替代详情页 |
| 审批/验收流程 | `PRD.md` 5.2、9，`页面与用例深化.md` 3 | 提交治理流程、详情页到期/验收、工作流字段 | 状态枚举 `待验收`，`workflowId`，`submitWorkflow`，状态机 `workflow_instance_id` | 部分通过 | 已有流程提交和验收状态，缺少审批节点详情、驳回/通过动作和资源释放结果 |
| 容量风险派工闭环 | `PRD.md` 4.6、5.3 | `/biz-capacity/risk` 提交治理流程、流程与证据 | `POST /workflow/submit`，状态机 `normal -> warning -> critical -> mitigating -> resolved -> closed` | 部分通过 | 当前 Demo 提交流程可演示派工，但未区分确认、转事件、生成扩容工单、关闭风险四个独立动作 |
| 配置中心读取和发布 | `PRD.md` 3、4.7、7，`页面与用例深化.md` 3 | `/biz-capacity/settings` 配置清单、提交治理流程 | `GET /api/biz-capacity/settings` 返回模板 version/owner/desc；`POST /workflow/submit` | 部分通过 | 已有配置清单和审批入口，缺少阈值编辑字段、版本 diff 和发布审批状态 |
| 数据可信度和证据链 | `PRD.md` 4.1、7、9 | 总览 AI盒子证据、详情页盒子证据、CMDB 对象 | `boxId`、`evidence[]`、`cmdbObjects[]`、`timeline[]` | 通过 | 后续接真实边缘数据时需补采集延迟、可信度数值和异常态 |
| 状态机和审计日志 | `02_容量管理模块_07_状态机.md` | 所有提交治理流程和详情页时间线 | `capacity_status_log`、`capacity_audit_log`、`capacity_status_changed` 埋点要求 | 部分通过 | 文档已定义审计锚点，Demo Mock 仅追加 timeline，未真实输出日志表 |
| 报表/月报/导出 | `PRD.md` 3、4.8、8、9 | `/biz-capacity/overview` SLA、趋势、风险分布；PRD 报表中心 | `dashboardData.trend`、`metrics.sla`、交付包 `17_报表指标与验收口径.md` | 部分通过 | 当前 Vue Demo 无独立报表页和导出按钮；正式验收需补 `/biz-capacity/reports` 或明确跳转报表中心 |
| CLI/MCP 和智能体调用 | `02_容量管理模块_05_用户故事与用例.md` UC-03、`14_CLI与智能体调用.md` | Demo 页面无直接入口 | 交付包要求 `zhihang biz-capacity *` 或同等 JSON 输出 | 部分通过 | Demo 不强制展示 CLI，但 PRD 验收需用接口/CLI 同源输出验证 |

## 5. 不通过闸门

以下任一情况出现，本模块不得判定为 Demo-PRD 一致性通过：

1. 只有 `/biz-capacity/overview` 首页或驾驶舱，没有空间、电力、制冷、网络、预占、风险、配置和详情页入口。
2. 有列表但没有 `/biz-capacity/detail/:id` 详情页，或详情页缺少 CMDB 对象、工作流、AI盒子证据、时间线中的任意两类追溯信息。
3. “发起预占”“提交审批”“提交治理流程”“保存规则”等按钮只有视觉元素，没有对应 Mock/API、状态机或审计锚点。
4. Demo 有字段或元素，但 PRD、字段字典、接口契约、业务表或验收矩阵中找不到业务落点。
5. PRD 要求的四维容量只做了空间或电力单维度展示，未覆盖制冷和网络端口容量。
6. 预占流程只展示申请清单，没有资源锁、审批实例、到期/验收、取消释放或冲突处理口径。
7. 审批/验收只改前端状态，未关联 `workflowId`、状态流转日志或审计日志。
8. 风险治理只能查看风险，不能确认、转事件、派工、提交治理流程或追踪闭环状态。
9. 配置中心只有静态文案，没有阈值/模板/版本/owner/发布审批中的可验收字段。
10. 报表只展示单个 KPI，无法说明容量利用率、预占效率、风险闭环时长或报表中心跳转/导出口径。
11. 采集异常、边缘离线、测点缺失与真实容量过载混为同一状态，导致系统可自动派工或自动扩容。
12. Demo 状态枚举与 PRD 状态机不一致，或前端私有状态未进入 API 响应、埋点、CLI/MCP、日志要求。
13. Mock 数据缺少业务对象 ID、站点、状态、责任人、CMDB 对象、工作流实例、证据链，导致页面不能做端到端验收。
14. Vue Demo 新增了页面或按钮，但没有同步更新交付包索引、一致性矩阵、字段字典和接口契约。

## 6. 本轮补强结论

- 已把容量管理从“三级页面清单”深化到“三级页面 -> 四级页面/操作面 -> Demo 元素 -> 验收重点”。
- 已补充 10 条 User Story，覆盖详情页、增删改查中的新增/查询/详情/提交、审批/验收、配置、报表/审计和异常分支。
- 已补充 15 行 Demo-PRD 闸门矩阵，明确通过、部分通过和缺口处理。
- 当前 Vue Demo 可支撑总览、专业子板块、详情、流程提交、配置读取和证据追溯的演示；预占推荐三步向导、审批节点详情、风险独立动作、报表导出、真实审计日志仍是正式产品化验收前的缺口。


## PM 质量闸门语义补充

容量管理必须覆盖容量预留、容量释放、容量规划、容量趋势预测与扩容审批，Demo 与 PRD 均需以这些业务词作为页面和流程主线。