# 108 网梯标杆新目标闸门与返工准则

## 1. 新目标

本轮返工只认两个基准：

- 前端 Demo 基准：`参考网梯的高保真demo标杆`
- PRD 颗粒度基准：`产品需求文档（容量+指标）PRD.pdf`

此前以深色 DCIM 静态壳子作为统一入口验收的结论作废。后续 17 个模块必须统一回到网梯 Vue 工程范式，不再接受单页静态展示页作为可验收 Demo。

## 2. 技术栈硬门槛

每个模块必须保留并实际使用独立 `vue-demo` 工程：

- Vue 3
- Vite
- TypeScript
- Element Plus
- Pinia
- Vue Router
- MockJS
- ECharts

模块根入口 `商业化模块Demo/XX_模块/index.html` 只能作为进入 Vue Demo 的发布入口，不得再呈现另一套深色静态工作台。

## 3. UI 范式硬门槛

必须对齐网梯标杆的后台系统风格：

- `Layout.vue + SidebarMenu + TopNav + router-view` 主布局。
- 180px 左侧菜单、40px 顶部导航、右侧浅灰页面底与白色工作区。
- Element Plus 直角控件，低阴影、细边框、紧凑表格、紧凑表单。
- 页面必须是业务系统界面，不是大屏、营销页、装饰性驾驶舱。
- 主色、背景、边框、字体层级以 `src/assets/style/var.scss` 和 `common.scss` 为准。

## 4. PRD 最低颗粒度

以容量+指标 PRD 为最低要求，每个模块至少要有：

- 产品背景、定位、目标、目标用户、用户场景、用户旅程。
- 一级/二级模块、功能点、功能描述、业务规则。
- 总览页、列表页、详情页、配置页、流程页。
- 新增、编辑、删除/关闭、提交、审批/验收、异常处理。
- 角色权限矩阵、状态机、字段字典、接口契约。
- Mock 初始化数据、报表指标、性能要求、埋点方案。
- CLI/MCP/智能体调用说明、审计与回滚边界。
- Demo-PRD 字段级一致性矩阵和逐元素验收表。

## 5. Demo 闭环硬门槛

每个模块 Demo 必须能演示完整业务故事：

- 登录/角色或模块角色上下文。
- 总览数据发现问题。
- 列表筛选定位对象。
- 进入详情查看证据链、状态、时间线或关联基座数据。
- 执行至少一个关键操作。
- 进入审批、验收、驳回、返工、关闭或回滚路径之一。
- 看到操作后的状态变化与审计记录。

Mock 数据不能只给少量卡片数字，必须支撑多角色、多状态、多对象、多异常路径演示。

## 6. 不回退约束

原来已经存在的工程化资产不能丢：

- `00_标准交付包`
- `CLI_AND_AGENT_SPEC.md`
- `TRACKING_PLAN.md`
- `DEMO_PRD_ALIGNMENT.md`
- `API_SPEC.md`
- `MOCK_DATA.json`
- `FIELD_DICTIONARY.md`
- `STATE_MACHINE.md`
- `vue-demo/src/directives/tracking.ts`
- `vue-demo/src/mock`
- `vue-demo/src/api`

如果返工过程中改入口或重建 dist，必须保证这些文档和源码仍存在，并被新闸门纳入检查。

## 7. 失败即返工

任一模块出现以下情况，直接判定不通过：

- 根入口打开后仍是 `智航 DCIM` 深色静态壳。
- `vue-demo/dist/index.html` 使用 `/assets/...` 绝对资源路径，导致子目录部署失败。
- 缺少网梯布局、Element Plus、Pinia、Vue Router、MockJS。
- 页面只到总览/列表，没有详情、操作、配置、流程或异常路径。
- PRD 只写功能介绍，没有用户旅程、页面级需求、状态机、字段、接口、埋点、CLI/MCP、验收矩阵。
- Mock 数据无法支撑真实业务故事闭环。

## 8. 执行顺序

1. 修正 17 个模块入口与构建基路径。
2. 用新闸门跑出全量失败清单。
3. 以 09 供应商管理增强模块和 02 容量管理模块为优先校准样板。
4. 逐模块补齐 Vue 页面、Mock、操作、详情和 PRD。
5. 每轮修复后运行脚本和浏览器 E2E，未通过继续返工。