8.0 KiB
8.0 KiB
故障处置（车辆运维）设计规格
| 项 | 说明 |
|---|---|
| 日期 | 2026-07-22 |
| 状态 | 已确认 |
| 方案 | 方案一：新建原型 + 工作台同源数据 |
| 原型 ID（拟定） | vehicle-fault-handling |
| 菜单 | OneOS → 车辆运维 → 故障处置 |
| 关联 | oneos-web-workbench-new（预警 KPI + 运维看板故障登记） |
1. 问题与目标
运维需要承接 AI 故障机器人上报的原始故障（聊天摘要、图片、视频），在系统内完成处置、挂起与归档，并满足 30 天闭环 时限与催办。处置记录须足够详细，作为日后向整车厂索赔的证据链基础。
本期目标
- 新建「故障处置」列表 + 独立详情页，完成待处理 → 处理中 → 挂起 → 已归档。
- 证据链多附件与归档硬门槛。
- 时限与通知规则演示（含短信/邮件模板与发送记录，不接真实通道）。
- 工作台预警 KPI + 运维看板「故障登记」与本模块同口径。
非目标（二期 / 占位）
- AI 对话上报界面（机器人仅作数据来源）
- 真实短信 / 邮件网关
- 品牌 · 车型 · 部位 · 等级完整分类统计看板
- 按品牌车型一键出具故障证明与自动分析结论（本期仅入口占位）
2. 信息架构
OneOS
└── 车辆运维（新一级菜单）
├── 故障处置 ← 本期主功能
├── 分类统计 ← 二期占位
└── 故障证明 ← 二期占位
- 新建原型目录：
src/prototypes/vehicle-fault-handling/ - 不改造旧合包
oneos-web-ops内「故障管理」页为唯一入口；旧页可暂并存，导航以新菜单为准。 - AI 上报：无 UI；以种子数据模拟「已入库的待处理原始记录」。
3. 状态机
| 状态 | 进入条件 |
|---|---|
| 待处理 | AI 上报后系统自动入库 |
| 处理中 | 运维首次保存处置内容（可分次保存） |
| 挂起 | 运维选择暂时挂起，必须填写挂起原因 |
| 已归档 | 通过归档硬门槛，完成闭环 |
流转规则
待处理→ 首次保存 →处理中待处理/处理中→ 挂起 →挂起挂起→ 恢复继续 →处理中处理中→ 归档校验通过 →已归档- 挂起不可直接归档；须先恢复为处理中，补齐硬门槛后再归档
4. 时限规则（文档中的「SLA」含义）
此处 SLA = 处理时效约定，非另有系统模块：
- 时针从 故障记录上报时刻 起算，30 个自然日内必须已归档
- 暂时挂起不停表（挂起期间仍计入 30 天）
| 时机 | 条件 | 收件人 | 通道 | 频次 |
|---|---|---|---|---|
| 临期 | 未归档，且剩余天数 ≤ 7（未逾期），进入临期窗口时触发 | 当前处理人；无人接手 → 运维主管 | 短信 + 邮件 | 进入临期窗口触发一次 |
| 逾期升级 | 已超 30 天，仍未归档 | 固定运维主管 | 短信 + 邮件 | 逾期当天 1 次；之后 每周 1 次，直至归档 |
原型：展示「通知记录」列表与模板正文；标记「已发送（演示）」，不接真实通道。
4.1 通知模板
临 7 天 · 短信
【OneOS故障】${故障号} ${车牌/车型} 将于 ${截止日} 到期（剩7天）仍未归档，请尽快处置。详情见故障处置。
临 7 天 · 邮件
- 标题：
【故障临期提醒】${故障号} 距闭环截止还剩 7 天 - 正文须含：故障号、车辆、上报时间、当前状态、截止日、处理人、系统链接
超 30 天 · 短信
【OneOS故障·逾期】${故障号} 已超 30 天未归档（状态：${状态}），请主管督促闭环。
超 30 天 · 邮件
- 标题：
【故障逾期升级】${故障号} 已超过 30 天未归档 - 正文须含：上述字段 + 逾期天数、历史挂起原因摘要、末次催办时间
5. 页面结构
采用 列表 + 独立详情页（非抽屉）。
5.1 列表页
- 筛选：状态、等级、品牌/车型、临期、逾期
- 搜索：故障号、车牌
- 列：故障号/车辆、部位·等级、状态、剩余天数（或逾期天数）、操作「处置」
- 临期 / 逾期视觉标识
5.2 详情页分区
- 原始记录（只读）：AI 聊天摘要、图、视频
- 处置主档：故障时间、地点、部位、等级、处置结果、备注、关联车辆（品牌/车型/车牌）
- 证据链：多附件（图片、视频、PDF、Word 等常用类型）；可预览示意；记录文件名、类型、上传人、时间
- 挂起与通知：挂起原因历史；短信/邮件发送记录
- 底栏：保存（→ 处理中）· 挂起 · 归档（硬门槛）
5.3 归档硬门槛
必须全部满足方可归档：
- 故障时间、地点、部位、等级、处置结果
- 至少 1 个证据附件
- 备注选填
任一缺失：阻断归档并提示缺项。
6. 工作台接入
数据与 vehicle-fault-handling 同源（本地共享种子 / src/common 模块，未接真实 API）。
6.1 欢迎区预警 KPI（运维角色可见；多角色并集规则沿用工作台现规）
| 指标 | 口径 | 点击 |
|---|---|---|
| 临 7 天未归档 | 未归档且剩余天数 ≤ 7 且未逾期 | 故障处置列表 · 临期筛选 |
| 已超 30 天未归档 | 未归档且已过截止日 | 列表 · 逾期筛选 |
| 待处理积压 | 状态 = 待处理 | 列表 · 待处理 |
6.2 运维看板「故障登记」
- 总数 = 全部故障记录（含已归档）
- 已归档 = 状态为已归档
- 闭环率 = 已归档 / 总数
- 可辅显：挂起数、临期数
- 可见性：主管/兼岗全量 + 按人筛；普通运维本人/本地区（沿用现有
OpsCockpit规则）
7. 数据对象（摘要）
FaultRecord 主要字段：
- 标识：故障号、上报时间、截止时间、来源（AI）
- 状态与处理人
- 原始：聊天摘要、媒体列表
- 处置：时间、地点、部位、等级、结果、备注、车辆引用
- 证据附件列表、挂起历史、通知历史
二期统计 / 证明所需的品牌、车型、部位、等级字段在一期处置主档中已采集，证明生成逻辑本期不做。
8. 组件与实现边界（实现阶段指引）
| 单元 | 职责 | 依赖 |
|---|---|---|
vehicle-fault-handling 原型 |
列表、详情、状态流转、证据链、通知演示 | 共享故障种子 |
共享数据模块（如 src/common/vehicle-fault/） |
记录类型、状态派生、时限计算、看板/KPI 聚合 | 无真实 API |
oneos-web-workbench-new |
KPI 瓦片 + OpsCockpit 故障列改读共享数据 | 共享模块 |
| 导航 | nav-menu.json 增加车辆运维 / 故障处置；nav:sync |
— |
错误处理：归档校验失败明确列出缺项；挂起无原因不可提交。
9. 已确认决策记录
| 决策点 | 选择 |
|---|---|
| AI 端 | 仅数据来源，不做对话 UI |
| 落地路径 | 方案一：新原型 + 工作台同源 |
| 菜单 | 车辆运维 → 故障处置 |
| 中间态名称 | 处理中 |
| 挂起与时针 | 不停表 |
| 临 7 天含义 | 未归档且剩余天数 ≤ 7（未逾期） |
| 一期范围 | 处置闭环 + 证据链；统计/证明占位 |
| 归档 | 硬门槛 |
| 工作台 | 预警 + 看板都接 |
| 临期收件人 | 处理人，无人接手→主管 |
| 逾期 | 固定主管；当天 1 次 + 每周 1 次 |
| 详情布局 | 列表 + 独立详情页 |
10. 验收重点（设计层）
- 种子数据入库即为待处理；保存后为处理中；挂起必填原因；归档卡硬门槛。
- 列表可按临期/逾期筛选；详情可看原始记录与证据链。
- 通知记录可演示临期与逾期模板内容。
- 工作台运维角色可见三类故障预警；看板故障登记闭环率与模块数据一致。
- 菜单路径正确；二期入口为占位说明。