# 智航缺失模块 PRD 高保真 Demo 开发规范

## 1. 目标

本规范用于把“功能模块PRD”提升到“前端可以直接开发高保真Demo”的颗粒度。所有模块PRD必须让Demo开发者不再追问：页面有哪些、字段有哪些、按钮点了发生什么、假数据怎么造、与智航现有系统怎么结合。

## 2. 开发总原则

- 复用智航现有平台，不做孤立系统。
- Demo允许mock，但mock结构必须贴近未来真实接口。
- 页面必须能串成业务故事，而不是孤立菜单。
- 每个模块必须有首页、列表页、详情页、配置页、闭环页中的至少3类页面。
- 涉及现场动作的模块必须有AI盒子/视频/移动端证据链。
- 涉及流程动作的模块必须说明状态机、审批节点、超时升级和关闭条件。

## 3. PRD必备结构

每个模块PRD建议按以下结构输出：

```md
# 模块名称 PRD

## 0. Demo开发摘要
- 一句话定位
- 菜单挂载
- Demo主路径
- 核心页面
- 复用智航能力
- 需要mock的API

## 1. 现有能力复用分析
- 已有子系统
- 已有数据源
- 已有流程/低代码/报表/AI能力
- 本模块新增边界

## 2. 用户与场景
- 角色
- 场景
- 目标
- 成功标准

## 3. 信息架构与页面清单
- 页面路由
- 页面用途
- 复用/新增
- 入口来源

## 4. 页面级PRD
- 页面布局
- 组件
- 字段
- 操作按钮
- 状态
- 弹窗/抽屉
- 空态/异常态

## 5. 业务流程与状态机
- 主流程
- 分支流程
- 状态流转
- 审批/超时/驳回/关闭

## 6. 数据模型与字段字典
- 主对象
- 字段表
- 来源系统
- 示例值

## 7. Mock API与假数据
- API路径
- 请求参数
- 返回JSON
- 分页/筛选/错误码

## 8. 与智航技术基座集成
- CMDB
- 低代码
- 工作流
- 映射管理
- 边缘管理
- 报表/指标仓库
- 告警/事件/作战室
- AI助手/知识库
- AI盒子/视频源

## 9. 高保真交互说明
- 动效
- 图表
- 大屏/PC/移动端适配
- 权限态

## 10. Demo验收脚本
- Step 1
- Step 2
- Step 3
- 成功标志
```

## 4. 页面说明颗粒度

页面级PRD不能只写“展示列表”，必须写清：

| 项 | 示例 |
|---|---|
| 页面标题 | 资产全生命周期驾驶舱 |
| 路由 | `/resource/assets/lifecycle` |
| 挂载位置 | 资源中心 / DCIM工作台 / 资产管理 |
| 顶部指标 | 总资产数、异常资产、即将过保、盘点差异 |
| 筛选器 | 数据中心、机房、设备类型、生命周期状态、供应商 |
| 表格列 | 资产编号、设备名称、位置、状态、责任人、最近变更 |
| 主按钮 | 新增资产、批量导入、发起盘点、导出 |
| 行操作 | 查看详情、发起维修、发起变更、定位视频 |
| 空态 | 当前筛选条件下无资产，提示清空筛选或导入资产 |
| 异常态 | CMDB连接失败，展示最后同步时间和重试按钮 |
| 权限态 | 无资产编辑权限时隐藏新增/导入按钮，仅允许查看 |

## 5. Mock API规范

Demo API 命名建议：

- `/mock/api/{module}/dashboard`
- `/mock/api/{module}/list`
- `/mock/api/{module}/{id}`
- `/mock/api/{module}/{id}/actions`
- `/mock/api/{module}/workflow/submit`
- `/mock/api/{module}/events/timeline`

返回结构建议：

```json
{
  "code": 0,
  "message": "ok",
  "data": {},
  "traceId": "demo-20260617-0001",
  "source": "mock-mapped-to-zhihang-baseline"
}
```

列表结构建议：

```json
{
  "code": 0,
  "data": {
    "page": 1,
    "pageSize": 20,
    "total": 128,
    "items": []
  }
}
```

## 6. 状态机规范

任何流程型模块必须至少定义：

- `draft` 草稿
- `submitted` 已提交
- `reviewing` 审批中
- `assigned` 已派单
- `processing` 处理中
- `pending_acceptance` 待验收
- `closed` 已关闭
- `rejected` 已驳回
- `overdue` 已超时
- `cancelled` 已取消

## 7. 智航基座复用写法

每个模块必须有一张“复用矩阵”：

| 能力 | 复用对象 | 本模块使用方式 | 是否新增 |
|---|---|---|---|
| CMDB | `iot.meta42.indc.vnet.com` | 读取设备、空间、关系、模型 | 否 |
| 低代码 | NocoBase/PagePlug | 配置表单、审批、字段 | 配置扩展 |
| 工作流 | BPMN/AbBPM | 审批、派单、验收 | 配置扩展 |
| 告警 | `usability.meta42.indc.vnet.com` | 告警转事件/工单 | 否 |
| 事件作战室 | `event-live.meta42.indc.vnet.com` | 重大事件协同 | 否 |
| 报表 | Grafana/报表中心 | 指标看板 | 否 |
| 边缘 | `edge.meta42.indc.vnet.com` | 采集器/盒子状态 | 配置扩展 |
| 映射 | `systemfront.meta42.indc.vnet.com` | 点位/单位/协议映射 | 配置扩展 |
| AI盒子 | 视频/边缘节点 | 现场识别、证据归档 | 需要接入适配 |

## 8. Demo验收最低标准

一个模块的高保真Demo至少要能完成：

1. 从主门户或中心菜单进入模块首页。
2. 首页展示真实业务口径的指标卡和趋势图。
3. 列表支持筛选、搜索、状态标签、分页。
4. 详情页展示对象主数据、关系、时间线、关联工单/告警/视频。
5. 至少一个关键操作可打开弹窗/抽屉并提交mock流程。
6. 提交后状态发生变化，时间线新增记录。
7. 有异常态和空态，不是纯静态截图。
8. 明确展示复用智航基座的痕迹：CMDB对象、告警ID、工单ID、盒子证据、报表指标等。



## 12. 最高标准升级：以供应商管理增强模块为标杆

在原有最低标准之上，后续所有模块必须以 `09_供应商管理增强模块` 的最新独立 Vue Demo 与 PRD 包作为最高验收标杆。

强制升级点：

1. 视觉框架必须与参考网梯 Demo 保持一致，不能因为追求“更好看”而变成另一个系统。
2. 功能复杂度必须达到商业化产品 Demo 水准，不能停留在多个列表页。
3. 每个模块必须独立可运行，并能由统一索引入口跳转到模块总览页。
4. Demo 和 PRD 必须字段级一致，包括页面、字段、API、Mock、业务表、埋点、CLI/智能体调用。
5. 供应商模块当前作为后续模块验收样板，详见 `98_网梯标杆高标准Demo与PRD验收准则.md`。