63 lines
2.5 KiB
Markdown
63 lines
2.5 KiB
Markdown
# 故障处置 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: 共享数据模块
|
||
|
||
- [x] Create types, sla, seed, storage, stats, notify, index under `src/common/vehicle-fault/`
|
||
|
||
### Task 2: 故障处置原型 UI
|
||
|
||
- [x] list / detail / placeholders + PRD + annotation
|
||
|
||
### Task 3: 工作台接入
|
||
|
||
- [x] KPI + OpsCockpit 同源
|
||
|
||
### Task 4: 导航与收尾
|
||
|
||
- [x] 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 |
|