# 智航缺失模块最高标准 Demo 与 PRD 验收准则

## 1. 标杆结论

从 2026-06-18 起，`09_供应商管理增强模块` 的独立 Vue Demo 与同步 PRD 作为后续所有缺失模块的最高交付标杆。

标杆不是“更好看一点”的自定义页面，而是以下组合：

- 技术框架：复用参考网梯完整 Vue 3 工程，保持 Vue 3、Vite、TypeScript、Element Plus、Pinia、Vue Router、MockJS。
- 视觉框架：保持网梯后台系统风格，白色模块、浅灰底、细边框、直角、低阴影、小间距、表格/表单密集度一致。
- 功能复杂度：达到商业化交付水准，不停留在列表页；必须包含总览、列表、详情、增改、流程、配置、分析或证据闭环。
- 智航基座：强结合 CMDB、低代码、工作流、AI盒子、ERP、报表/指标仓库、告警/事件/工单，不做孤立系统。
- 文档一致：Demo 页面展示的字段、状态、动作、Mock、API、表结构、埋点、CLI/智能体工具必须在 PRD 中同步出现。

## 2. 供应商标杆当前状态

| 项 | 标杆要求 | 供应商模块状态 |
|---|---|---|
| 独立运行 | 每个模块独立 Vue 工程，可单独 `npm run dev` | 已满足，路径 `商业化模块Demo/09_供应商管理增强模块/vue-demo` |
| 网梯框架 | 顶部、侧栏、路由、登录、模块切换、Element Plus 风格一致 | 已收敛 |
| 总览页 | 真实业务驾驶舱，有指标、趋势、风险、TOP、基座状态 | 已满足 |
| 列表页 | 查询、筛选、分页、状态、行操作，不是静态表格 | 已满足 |
| 详情页 | 360详情，多Tab，主数据、关系、证据、时间线 | 已满足 |
| 增改流程 | 至少一个新增/编辑或配置发布流程可操作 | 已满足 |
| 流程闭环 | 可提交 Mock 工作流，状态/提示/时间线体现闭环 | 已满足 |
| 基座结合 | CMDB、低代码、工作流、AI盒子、ERP清晰可见 | 已满足 |
| PRD同步 | 主PRD、页面、字段、接口、表、Mock、埋点、CLI一致 | 已满足，需要随Demo变更持续维护 |

## 3. 最高标准验收门禁

每个模块必须同时通过以下 12 个门禁，否则不得标记为“完成”。

| 门禁 | 通过标准 | 不通过示例 |
|---|---|---|
| G1 独立工程 | 每个模块有独立可运行 Demo，不能只依赖总工程截图 | 只有一个 HTML 截图或只能在总页面里看 |
| G2 网梯框架一致 | 顶部、侧栏、菜单、容器、卡片、表格、弹窗、按钮、间距与网梯标杆一致 | 自定义大屏风、营销页风格、圆角卡片过重 |
| G3 页面结构完整 | 至少包含总览、列表、详情、流程/配置四类页面 | 多个菜单实际都是同一种列表页 |
| G4 总览可视化 | 首页必须有业务指标、趋势、风险/TOP/结构分布 | 首页只有欢迎语或单表格 |
| G5 详情可交付 | 详情必须展示主对象、关联对象、证据链、时间线、状态 | 抽屉里只有几个基础字段 |
| G6 增改可演示 | 至少一个新增、编辑、配置或审批提交路径可完整点击 | 所有按钮都是刷新或无动作 |
| G7 状态机闭环 | 状态、流程节点、驳回/超时/关闭/复核有清晰演示 | 没有状态变化和流程语义 |
| G8 Mock真实 | Mock 数据贴近智航业务，含ID、时间、责任人、基座引用 | `张三/测试数据/xxx` 占位 |
| G9 基座强结合 | 页面可见 CMDB、低代码、工作流、盒子、ERP或相关已有系统引用 | 完全像新建孤立SaaS |
| G10 PRD字段一致 | 页面字段、接口、表结构、Mock、埋点、CLI在PRD里一致 | Demo改了但PRD仍是旧字段 |
| G11 CLI/智能体 | 定义 CLI 命令和智能体工具调用，含审计和权限 | 只有GUI，没有自动化调用口径 |
| G12 校核记录 | 有页面级验收、运行校核、差异结论和未覆盖风险 | 没有验收矩阵 |

## 4. PRD 同步强制要求

每个模块目录下至少需要保留以下文件，并与 Demo 同步：

| 文件 | 内容 |
|---|---|
| `PRD.md` | 产品主PRD、目标、范围、角色、业务规则、非功能需求 |
| `PAGE_REQUIREMENTS.md` | 页面清单、路由、组件、字段、按钮、弹窗、异常态 |
| `FIELD_DICTIONARY.md` | 字段名、中文名、类型、来源、示例、展示规则 |
| `API_SPEC.md` | API路径、请求、响应、错误码、权限 |
| `DB_TABLE_SPEC.md` | 业务数据表，不重复建设CMDB/工作流底表 |
| `INITIAL_DATA_SPEC.md` | 初始化数据、业务样例、枚举和配置项 |
| `MOCK_DATA.json` | 与 Demo 使用的 Mock 一致 |
| `TRACKING_PLAN.md` | 埋点、分析目标、卡点判断、事件属性 |
| `CLI_AND_AGENT_SPEC.md` | CLI命令、MCP/智能体工具、审计、安全 |
| `DEMO_PRD_ALIGNMENT.md` | Demo-PRD一致性矩阵 |
| `00_模块交付索引.md` | 模块内导航索引 |
| `00_标准交付包/` | 上述文件的标准编号版本 |

## 5. Demo 页面最低复杂度

每个模块 Demo 至少需要：

1. `总览页`：KPI卡、趋势/结构/TOP/风险至少三类信息。
2. `列表页`：搜索、筛选、分页、状态标签、行操作。
3. `详情页`：360视图，多区块或多Tab。
4. `流程页或弹窗`：新增、编辑、审批、派单、整改、发布、复核中的至少一个。
5. `配置或规则页`：体现低代码、规则、模板、阈值或模型配置。
6. `证据链`：涉及现场动作的模块必须展示 AI盒子/视频/图片/扫码/签到/验收证据。
7. `异常态`：至少描述并在PRD中覆盖空态、接口失败、权限不足、基座不可用。

## 6. 视觉一致性验收

| 项 | 标准 |
|---|---|
| 页面背景 | `var(--bg-color-page)` 浅灰背景，不用大面积自定义渐变 |
| 模块容器 | 白色模块、细边框、直角、低阴影或无阴影 |
| 顶部区 | 与容量/指标标杆一致，简洁标题 + 操作区 |
| 统计区 | 可用 `StatCard` 或同风格白底卡片，不能做营销式大卡 |
| 表格 | 使用 `BaseTable` 或 Element Plus 表格，密度、列标题、状态标签一致 |
| 表单 | Element Plus 表单、弹窗、抽屉，直角、统一按钮样式 |
| 交互 | 复杂但克制，优先后台系统效率，不做炫技动效 |

## 7. 最终统一索引入口要求

最终需要建设一个统一索引入口：

- 入口页面展示 17 个模块的卡片、优先级、完成状态、Demo路径、PRD路径、验收状态。
- 每个模块卡片点击进入该模块独立 Demo 的总览页。
- 支持按 P0/P1、模块族、完成状态筛选。
- 每个模块总览页内部再进入本模块列表、详情、流程、配置等页面。
- 统一索引只负责导航，不把所有模块粘成一个不可拆的大系统。

## 8. 执行真实性要求

所有模块推进报告必须区分：

- `supervisor_direct`：Codex 直接设计/开发/校核。
- `local_subagent_parallel`：当前会话内本地子代理或并行切片。
- `real_external_owner`：真实调用外部 Kimi/OpenCode/Spark 等可观察执行现场。
- `degraded_delegation`：计划外部执行但降级为 Codex 直做。

不得把 Codex 直做包装成外部代理完成。