# 故障处置 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 |