# 资产管理模块四级页面深化与 Demo-PRD 闸门

## 1. 目标任务说明

资产管理模块在主 PRD 中已经定义了资产驾驶舱、资产台账、资产详情、U 位/机柜视图、生命周期工作台、自动盘点、主数据治理和资产配置等三级页面；Vue Demo 也已经拆出资产总览、资产台账、生命周期、盘点与扫码核验、U 位与空间、维保与过保、资产变更、报废处置、资产配置中心和资产详情等可演示页面。

本次需要做 4 级页面深化，是因为资产管理不是“看板 + 列表”即可验收的模块。它必须覆盖新建、编辑、作废、入库、上架、移位、维修、报废、盘点差异确认、审批验收、配置治理、报表审计等真实操作面，并且每个操作面都要能在 PRD 能力点、Demo 页面元素、Mock/API/状态机证据之间建立可追溯关系。否则会出现以下交付风险：

- 只有资产首页和台账列表，不能证明生命周期闭环可用。
- Demo 有按钮或卡片，但 PRD 没有对应字段、流程和状态定义。
- PRD 写了入库、上架、盘点、报废，但 Demo 没有可点击入口、Mock 状态或流程反馈。
- 详情页只有基础档案，缺少告警、测点、证据、审计、流程单号等运营上下文。
- 审批、验收、配置、报表、审计被写成抽象能力，无法被页面级验收。

本文件作为 01 资产管理模块的四级页面深化基线和 Demo-PRD 一致性闸门，验收对象限定为：

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

## 2. 四级页面树

| 中心 | 模块 | 三级页面 | 四级页面或操作面 | 覆盖类型 | Demo 页面/元素 |
|---|---|---|---|---|---|
| 资源中心 | 资产管理 | 资产总览/资产驾驶舱 | 风险对象下钻、维保到期清单、盘点差异清单、资产类型分布下钻 | 报表/审计 | `/asset/overview`，子板块入口、风险对象、SLA、AI 盒子证据、待办流程 |
| 资源中心 | 资产管理 | 资产台账 | 新建资产抽屉、编辑资产抽屉、批量导入向导、批量治理面板、作废确认弹窗 | 增删改查 | `/asset/ledger`，查看详情、提交治理流程、资产台账清单 |
| 资源中心 | 资产管理 | 资产详情 | 档案与基座、服务范围、盒子证据、时间线、告警事件、巡检维护、操作审计 | 详情页 | `/asset/detail/:id`，档案与基座、服务范围、盒子证据、时间线 |
| 资源中心 | 资产管理 | 生命周期 | 入库向导、上架申请、移位申请、下架申请、维修登记、报废审批入口 | 审批/验收 | `/asset/lifecycle`，生命周期子板块、提交治理流程、工作流节点 |
| 资源中心 | 资产管理 | 盘点与扫码核验 | 新建盘点任务、盘点执行详情、差异处理抽屉、整改工单创建、盘点报告 | 审批/验收 | `/asset/inventory`，盘点与扫码核验、AI 盒子证据、工作流待办 |
| 资源中心 | 资产管理 | U 位与空间 | U 位预占弹窗、上架预检抽屉、闪灯定位动作、机柜图导出、容量冲突提示 | 配置/操作 | `/asset/space`，U 位与空间、CMDB 对象、AI 盒子、流程与证据 |
| 资源中心 | 资产管理 | 维保与过保 | 维保风险清单、续保审批、EOL 建议、供应商补齐、合同附件核验 | 审批/验收 | `/asset/warranty`，维保与过保、风险数、到期/验收 |
| 资源中心 | 资产管理 | 资产变更 | 搬迁变更、替换变更、扩容变更、配置变更、验收确认 | 审批/验收 | `/asset/change`，资产变更、待验收状态、工作流 |
| 资源中心 | 资产管理 | 报废处置 | 报废申请、数据擦除确认、财务残值确认、下架验收、审计归档 | 审批/验收 | `/asset/retire`，报废处置、风险对象、流程与证据 |
| 资源中心 | 资产管理 | 资产配置中心 | 生命周期字典、唯一键规则、盘点规则、字段模板、权限模板、低代码表单绑定 | 配置 | `/asset/settings`，资产配置中心、`/api/asset/settings` |
| 资源中心 | 资产管理 | 主数据治理 | 重复资产合并、字段补齐、关系修复、命名规则发布、CMDB 审计回看 | 增删改查/审计 | `/asset/ledger`，提交治理流程、CMDB 绑定、CMDB 对象 |
| 资源中心 | 资产管理 | 资产主题报表 | 月报导出、资产完整率、盘点差异趋势、维保到期趋势、报表中心跳转 | 报表/审计 | 标准交付包高保真 Demo 元素：生成报表、导出月报、进入报表中心 |

## 3. User Story 表

| 编号 | 角色 | 前置条件 | 主流程 | 异常分支 | 成功标志 | 对应 Demo 页面/元素 |
|---|---|---|---|---|---|---|
| 01-US-01 | 资产管理员 | 已进入资源中心资产管理，具备资产创建权限 | 在资产台账点击新建资产，填写资产名称、类型、品牌型号、SN、所属空间、责任团队，提交入库向导并上传验收照片 | SN 重复时阻断提交，提示合并、保留或重新录入 | 资产详情出现入库节点，CMDB 对象生成，状态进入库存中或已入库 | `/asset/ledger`；高保真 Demo 元素：新建资产、PagePlug 入库表单、提交入库 |
| 01-US-02 | 资产管理员 | 资产已存在，字段或关系存在缺失 | 在资产台账选择资产，进入编辑抽屉，补齐供应商、维保日期、空间关系并提交治理流程 | 运行中关键字段变更需要审批；CMDB 关系缺失时进入关系修复 | 字段完整率提升，生成操作审计，流程单号写入履历 | `/asset/ledger`；提交治理流程、CMDB 绑定、工作流 |
| 01-US-03 | 资产管理员 | 资产有重复 SN 或错误实例 | 在主数据治理面板筛选 SN 重复，选择合并治理，确认主资产和作废资产 | 有未关闭工单、告警或财务处置时不可作废 | 重复资产被合并或作废，保留 CMDB 审计记录 | 高保真 Demo 元素：SN 重复、合并治理、确认合并 |
| 01-US-04 | 机房运维工程师 | 资产处于已入库或待上架状态，目标机柜有空间数据 | 在资产详情或 U 位与空间页发起上架预检，选择目标机柜、U 位、PDU、网络口，提交审批 | 容量、电力、制冷、承重或网络口不足时展示替代机柜和冲突原因 | U 位被预占，生成上架变更单，资产状态进入待上架审批 | `/asset/space`；上架预检、预占 U 位、容量预检、锁定资源并生成变更 |
| 01-US-05 | 机房现场人员 | 上架变更已批准，现场扫码或 AI 盒子可回传证据 | 执行现场扫码，上传铭牌/机柜照片，确认 SN、U 位和资产编码一致 | 扫码 SN 与台账不一致时流程暂停并生成盘点差异 | 资产状态变为运行中，详情页出现盒子证据和时间线节点 | `/asset/detail/:id`；盒子证据、时间线、AI 盒子证据 |
| 01-US-06 | 值班经理 | 资产发生告警或健康评分下降 | 从资产总览风险对象进入资产详情，查看测点、历史维修、盒子证据，发起维修流程 | 资产未绑定 CMDB 关系时转入治理提示；维修中禁止移位和报废 | 生成维修工作流，资产状态进入维修中，风险待办可追踪 | `/asset/overview`、`/asset/detail/:id`；风险对象、发起维修、工作流 |
| 01-US-07 | 资产管理员 | 已创建盘点任务，边缘采集或扫码数据返回 | 在盘点与扫码核验页查看账实差异，打开差异处理抽屉，选择确认变更、发起整改或忽略并备注 | 边缘设备离线时不能自动判定缺失，只能标记人工复核 | 差异状态更新，整改工单或盘点报告生成 | `/asset/inventory`；盘点与扫码核验、AI 盒子证据、整改、证据 |
| 01-US-08 | 运维经理 | 维保 30/45 天到期风险已被识别 | 在维保与过保页查看到期清单，选择资产并发起续保或报废建议审批 | 供应商、合同或责任人缺失时要求先补齐字段 | 续保审批或报废建议生成，资产履历记录到期处置 | `/asset/warranty`；维保与过保、到期/验收、流程与证据 |
| 01-US-09 | 变更负责人 | 资产需要搬迁、替换或扩容 | 在资产变更页创建搬迁/替换/扩容变更，绑定 CMDB 对象、工作流和验收人 | 未完成审批不可执行；验收不通过时回滚位置关系 | 变更状态进入待验收或已关闭，资产详情时间线同步 | `/asset/change`；资产变更、待验收、工作流 |
| 01-US-10 | 资产管理员/财务接口人 | 老旧资产达到 EOL 或维修不可修复 | 在报废处置页发起报废，确认下架、数据擦除、财务残值和审计附件 | 有未关闭告警、工单或未清除数据时不可完成报废 | 资产状态变为下线或已报废，U 位和容量释放，审计归档 | `/asset/retire`；报废处置、报废审批、流程与证据 |
| 01-US-11 | 平台配置管理员 | 需要上线资产生命周期规则或唯一键规则 | 在资产配置中心维护生命周期字典、唯一键规则、盘点规则、字段模板和权限模板 | 规则与现有 CMDB 字段冲突时禁止发布 | `/api/asset/settings` 返回新规则版本，页面显示配置模板 | `/asset/settings`；资产配置中心、`/api/asset/settings` |
| 01-US-12 | 区域负责人 | 月度资产治理需要向管理层汇报 | 在资产总览或报表入口生成资产月报，包含完整率、差异、维保、风险、审批闭环 | 报表口径缺少 CMDB 或工作流数据时标记未充分命中 | 月报可导出，指标可追溯到资产对象和流程证据 | `/asset/overview`；标准交付包元素：生成报表、导出月报、进入报表中心 |

## 4. Demo-PRD 闸门矩阵

| PRD 能力点 | PRD 文件位置 | Demo 页面/元素 | Mock/API/状态机证据 | 是否通过 | 缺口处理 |
|---|---|---|---|---|---|
| 资产总览展示资产总量、风险、待办、证据和 SLA | `01_资产管理模块/PRD.md` 3 信息架构、4.1 资产驾驶舱 | `/asset/overview`，资产管理总览、风险对象、SLA、AI 盒子证据、待办流程 | `getList({page:1,pageSize:50})`，`/api/asset/list` records 聚合 | 通过 | 后续如要演示 U 位热力图，需补 ECharts 或专用热力组件 |
| 资产台账支持查询、列表、查看详情和治理流程 | `01_资产管理模块/PRD.md` 4.2 资产台账 | `/asset/ledger`，资产台账清单、查看详情、提交治理流程 | `/api/asset/list`、`/api/asset/workflow/submit` | 通过 | 新建/编辑/作废目前在高保真元素和文档中定义，Vue Demo 需补真实抽屉 |
| 资产详情统一展示档案、基座、服务范围、证据和时间线 | `01_资产管理模块/PRD.md` 4.3 资产详情 | `/asset/detail/:id`，档案与基座、服务范围、盒子证据、时间线 | `/api/asset/detail/{id}`，record.evidence、record.timeline | 通过 | 告警事件、测点趋势、巡检维护、操作审计需补成独立 Tab 或字段 |
| 入库流程校验 SN 唯一性并形成生命周期节点 | `01_资产管理模块/PRD.md` 5.1 入库到上架主流程；`页面与用例深化.md` 核心操作页 | 高保真 Demo 元素：PagePlug 入库表单、提交入库、SN 重复 | 高保真 Demo 元素清单；Mock records 含 id/name/cmdbObjects/workflowId | 部分通过 | Vue Demo 未见真实入库抽屉和 SN 唯一性状态机，需补 `/api/asset/create` 和重复校验反馈 |
| 上架前容量预检和 U 位预占 | `01_资产管理模块/PRD.md` 4.4 U 位/机柜视图、5.1 入库到上架主流程 | `/asset/space`，上架预检、预占 U 位、容量预检、锁定资源并生成变更 | `submitWorkflow` 推送 workflow/audit；高保真 Demo 元素清单 | 部分通过 | Vue Demo 需补 U 位图、冲突原因和预占锁状态 |
| 自动盘点支持差异识别、证据查看和整改工单 | `01_资产管理模块/PRD.md` 4.5 自动盘点 | `/asset/inventory`，盘点与扫码核验、证据、整改、AI 盒子证据 | records 中盘点差异对象 `AST-RACK-S1-003`，evidence/timeline | 通过 | 需补边缘离线不能自动判缺失的状态展示 |
| 维保到期触发续保或报废建议 | `01_资产管理模块/PRD.md` 4.1 风险待办、5.2 维修与报废流程 | `/asset/warranty`，维保与过保、到期/验收 | record `AST-UPS-B28-002`，dueDate、workflowId | 通过 | 续保审批表单字段需与供应商/合同字段打通 |
| 维修流程从资产详情或告警进入，维修中锁定资产 | `01_资产管理模块/PRD.md` 5.2 维修与报废流程 | 高保真 Demo 元素：发起维修、提交维修、完成维修；`/asset/detail/:id` | `submitWorkflow` 可改变记录为处理中并追加 timeline | 部分通过 | Vue Demo 未显式锁定移位/报废按钮，需补状态约束 |
| 资产变更覆盖搬迁、替换、扩容和验收 | `01_资产管理模块/PRD.md` 7 与变更系统交互；页面深化四级树 | `/asset/change`，资产变更、待验收、工作流 | record `AST-FW-G2-004` status=待验收、workflowId | 通过 | 需补验收通过/不通过后的回滚状态 |
| 报废处置覆盖下架、数据擦除、财务残值和审计归档 | `01_资产管理模块/PRD.md` 5.2 维修与报废流程 | `/asset/retire`，报废处置、报废审批 | record `AST-OLD-A6-005`，riskCount、workflowId、timeline | 通过 | 数据擦除、残值确认字段需要在详情或流程表单中显性化 |
| 资产配置中心维护生命周期字典、唯一键规则、盘点规则和字段模板 | `01_资产管理模块/PRD.md` 3 信息架构、8 高保真 Demo 开发提示 | `/asset/settings`，资产配置中心 | `/api/asset/settings` 返回规则模板、CMDB 对象映射、AI 盒子证据模板 | 通过 | 需补保存规则后的版本发布与冲突校验 |
| CMDB 对象、工作流、AI 盒子证据贯穿资产对象 | `01_资产管理模块/PRD.md` 1 复用现有基座、7 具体交互 | `/asset/ledger`、`/asset/detail/:id`，CMDB 对象、工作流、AI 盒子 | record.cmdbObjects、record.workflowId、record.boxId、record.evidence | 通过 | 真实联调阶段必须替换 Mock 为 CMDB/工作流/盒子接口 |
| 报表指标包括完整率、盘点差异、维保趋势和月报导出 | `01_资产管理模块/PRD.md` 4.1、9 非功能和验收标准；交付包 17 报表指标 | 高保真 Demo 元素：生成报表、导出月报、进入报表中心 | Demo 元素清单含报表入口；overview 聚合 SLA、风险、证据 | 部分通过 | Vue Demo 未见真实报表页和下载状态，需补报表中心跳转或导出模拟 |
| 操作必须有审计记录，不允许绕过流程直接改生命周期 | `01_资产管理模块/PRD.md` 9 非功能和验收标准 | `/asset/ledger` 提交治理流程；`/asset/detail/:id` 时间线 | `/api/asset/workflow/submit` 返回 pushed: portal_todo/workflow/audit_log，timeline 追加 | 通过 | 审计 Tab 需从时间线拆出操作者、时间、字段前后值 |
| 权限覆盖资产管理员、机房运维、值班经理、总部专家、现场人员 | `01_资产管理模块/PRD.md` 2 用户角色；交付包 33 权限矩阵 | 路由 meta roles: 运维工程师、值班经理、总部专家、运维管理线、机房现场 | `vue-demo/src/router/modules/asset.ts` roles 配置 | 通过 | 资产管理员角色名与 Demo 角色名需建立映射表 |

## 5. 不通过闸门

以下任一情况出现时，01 资产管理模块不得判定为 Demo-PRD 一致性验收通过：

1. 只有 `/asset/overview` 或首页看板，没有 `/asset/detail/:id` 详情页或详情页没有 CMDB 对象、工作流、证据、时间线。
2. 有资产台账列表，但没有新建、编辑、作废、导入、治理流程等操作入口或状态反馈。
3. Demo 出现按钮，例如新建资产、发起上架预检、发起维修、报废审批、生成报表，但没有对应 PRD 流程、字段、状态或 Mock/API 响应。
4. PRD 写了入库、上架、维修、移位、报废、盘点整改，但 Demo 只有静态文字，没有流程提交、状态变化、时间线或工单号。
5. Demo 有资产字段或页面元素，但 PRD 字段字典、页面详细设计或接口契约没有对应定义。
6. 资产生命周期状态可以在前端直接改为运行中、维修中或报废，而没有审批、验收、审计或工作流证据。
7. U 位与空间页面不能展示目标机柜、U 位、容量预检、预占或冲突原因，只能看到普通列表。
8. 自动盘点不能区分账实一致、账有实无、实有账无、位置不一致、SN 不一致和边缘离线。
9. 盘点差异没有证据预览、人工复核、整改工单或忽略备注，无法形成闭环。
10. 维保与过保只有到期日期，没有供应商、合同、续保审批、报废建议或责任人。
11. 资产配置中心只有展示页，没有生命周期字典、唯一键规则、盘点规则、字段模板和权限模板。
12. 报表能力只有“生成报表”按钮，没有指标口径、导出状态、报表中心跳转或审计留痕。
13. Mock 数据没有 CMDB 对象、工作流 ID、AI 盒子证据、责任人、风险数、到期日等关键字段，无法支撑演示口径。
14. 路由或菜单与 PRD 页面名称脱节，导致客户无法从资源中心/资产管理路径完成验收路径。
15. Demo 页面通过视觉元素模拟能力，但无法指出 PRD 文件位置、Mock/API/状态机证据和缺口处理。

## 6. 当前结论

当前 01 资产管理模块已经具备子板块级 Demo 骨架、Mock 资产对象、资产详情、工作流提交、CMDB/AI 盒子/流程证据字段和配置中心接口，能够支撑“资产管理不是通用列表”的基础演示。

仍需按闸门补强的重点是：Vue Demo 的新建/编辑/作废抽屉、SN 唯一性校验、U 位图与预占锁、维修锁定、报表导出、审计 Tab 字段前后值、边缘离线盘点分支。这些缺口不影响本文档作为 4 级页面深化基线，但在外包验收或客户演示前必须逐项关闭或明确降级说明。