2.5 KiB
2.5 KiB
故障处置 Implementation Plan
For agentic workers: Use inline execution in this session (user requested 执行). Steps use checkbox syntax.
Goal: 交付 vehicle-fault-handling 原型（列表+独立详情），共享故障数据驱动工作台预警与运维看板「故障登记」，并挂到 OneOS → 车辆运维 → 故障处置。
Architecture: src/common/vehicle-fault/ 持有类型、种子、localStorage、时限/归档校验与统计聚合；原型页读写该模块；工作台 KPI / OpsCockpit 改读同一聚合。AI 上报无 UI，仅种子模拟待处理原始记录。
Tech Stack: React + Ant Design + TypeScript；useHashPage（list / detail / stats-placeholder / proof-placeholder）；PrototypeAnnotationHost；localStorage。
Spec: docs/superpowers/specs/2026-07-22-vehicle-fault-handling-design.md
File map
| Path | Responsibility |
|---|---|
src/common/vehicle-fault/types.ts |
状态、附件、通知、FaultRecord |
src/common/vehicle-fault/sla.ts |
截止日、剩余天数、临期/逾期判定、归档硬门槛 |
src/common/vehicle-fault/seed.ts |
演示种子（含临期、逾期、待处理、处理中、挂起、已归档） |
src/common/vehicle-fault/storage.ts |
load/save localStorage |
src/common/vehicle-fault/stats.ts |
KPI 明细 + 看板 faultStats |
src/common/vehicle-fault/notify.ts |
短信/邮件模板渲染与演示发送记录 |
src/common/vehicle-fault/index.ts |
导出 |
src/prototypes/vehicle-fault-handling/* |
UI：列表、详情、占位页、样式、PRD、标注 |
src/prototypes/oneos-web-workbench-new/data/kpi.ts 等 |
接入故障 KPI |
src/prototypes/oneos-web-workbench-new/data/ops-cockpit.ts + OpsCockpit |
故障登记同源统计 |
src/prototypes/oneos-prototype-nav/nav-menu.json |
车辆运维菜单 |
Task 1: 共享数据模块
- Create types, sla, seed, storage, stats, notify, index under
src/common/vehicle-fault/
Task 2: 故障处置原型 UI
- list / detail / placeholders + PRD + annotation
Task 3: 工作台接入
- KPI + OpsCockpit 同源
Task 4: 导航与收尾
- sidebar + nav-menu 车辆运维 → 故障处置
Spec coverage
| Spec 节 | Task |
|---|---|
| §2 菜单/新原型 | 2, 4 |
| §3 状态机 | 1, 2 |
| §4 时限与模板 | 1 notify, 2 UI |
| §5 列表+独立详情 | 2 |
| §5.3 硬门槛 | 1 sla, 2 |
| §6 工作台 | 3 |
| 二期占位 | 2, 4 |