# 车辆管理 · 详情页产品需求说明（PRD）

> 本页为单车档案详情。标注「原型演示」的跨模块跳转仅 Toast 提示，不做真实路由。

---

## 1. 模块定位

| 项 | 说明 |
|---|---|
| 模块名称 | 车辆管理 — 详情页（查看页） |
| 入口 | 列表页点击车牌或「查看」 |
| 核心任务 | 查看单车档案、证照、保险、租赁及各类业务记录，维护可编辑字段 |
| 页面结构 | 顶栏返回 + 车辆概要 + 统计条 + Tab 内容区；右上角工具栏：「查看需求说明」「PRD文档MD文件下载」「下载测试用例」 |

---

## 2. 页面框架

### 2.1 顶栏

| 元素 | 行为 |
|---|---|
| 返回列表 | 回到列表页，保留列表筛选/KPI/分页状态 |
| 查看需求说明 | 打开详情页 PRD（本文档） |
| PRD文档MD文件下载 | 下载列表页、详情页两份 Markdown PRD |
| 下载测试用例 | 下载 Excel，含列表页与详情页测试用例两个 Sheet |

### 2.2 车辆概要区

- 车牌号、品牌·型号、VIN
- 在线状态（在线/离线圆点）
- 运营城市文案、GPS 时间

### 2.3 统计条（4 项）

| 字段 | 可编辑 | 行为 |
|---|---|---|
| 运营城市 | 仅来源为「人工」时可改 | 点击 → 运营城市修改弹窗；展示车机/GPS/人工来源标签 |
| 里程数 | 否 | 在线时展示车机标签 |
| 停放区域 | 否 | 只读 |
| 运维负责人 | 有运维权限时可改 | 点击铅笔图标 → 运维负责人弹窗 |

---

## 3. Tab 总览

| 序号 | Tab | 说明 |
|---|---|---|
| 1 | 基本信息 | 档案、项目、证照摘要等，部分字段行内可编辑 |
| 2 | 型号参数 | 车型参数与保养项目表 |
| 3 | 证照信息 | 行驶证、营运证等分组展示与照片预览 |
| 4 | 保险记录 | 险种概览卡片 + 采购历史表 |
| 5 | 租赁记录 | 合同/交还车历史 |
| 6 | 事故记录 | 筛选 + 事故列表 |
| 7 | 故障记录 | 筛选 + 故障列表 |
| 8 | 违章记录 | 筛选 + 违章列表 |
| 9 | 异动记录 | 筛选 + 异动列表 |
| 10 | 调拨记录 | 筛选 + 调拨列表 |
| 11 | 年审记录 | 筛选 + 已完成年审历史（对齐年审管理历史列表） |

各业务记录 Tab 通用规则：

- 数据按当前车辆 `plateNo` 从对应 JSON 种子文件过滤
- 筛选区：**查询**生效、**重置**清空，修改未查询不影响列表
- 日期范围使用双月历弹层组件
- 表格左对齐；金额/数字列使用等宽数字
- 底栏：共 N 条 + 紧凑分页（默认 10 条/页）

---

## 4. 基本信息 Tab

### 4.1 档案信息

| 字段 | 可编辑 |
|---|---|
| 出厂年份 | 是（年份选择） |
| 采购入库日期 | 是（日期选择） |
| 运营状态、车辆来源、停车场等 | 只读展示 |

保存后 Toast「车辆信息已更新」，写回内存台账。

### 4.2 项目信息

租赁/自营车辆展示项目名称、合同编码、客户名称；否则显示「无」。

### 4.3 证照摘要

- 检验有效期：展示到期日与剩余/过期标签
- 未上传时可点击 → Toast 跳转证照管理编辑（原型演示）

---

## 5. 型号参数 Tab

- 展示车辆型号技术参数（只读）
- 保养项目表：养护项目、保养公里/时间周期、工时费、材料费、合计

---

## 6. 证照信息 Tab

- 分组：行驶证、道路运输证、上海牌专项证件等（按车牌规则显隐）
- 每证展示：证件号、有效期、余额（如有）、照片网格
- 照片可点击全屏预览；证件状态色点图例
- 数据来自 `utils/vehicleLicenses` 与车辆台账关联

---

## 7. 保险记录 Tab

### 7.1 险种概览卡片

交强险、商业险、承运人责任险等；点击切换下方历史表。

- 未购买险种卡片可点击 → Toast 跳转保险采购（原型演示）
- 展示状态 Tag 与到期剩余天数

### 7.2 采购历史表

| 列 | 说明 |
|---|---|
| 保险导入时间、操作人、类型、保单号 | 只读 |
| 保险状态 | Tag |
| 保险公司、付款时间、到期日期 | 只读 |
| 保单文件 | 有附件时「预览」「下载」可点击 → Toast 演示 |

---

## 8. 租赁记录 Tab

### 8.1 筛选

合同编码、项目名称、客户名称、业务类型。

### 8.2 表格与跳转

| 列 | 可点击 | 跳转目标（原型 Toast） |
|---|---|---|
| 合同编码 | 是 | 租赁合同详情 |
| 项目名称 | 有值时 | 租赁合同详情 |
| 交车日期 | 有值时 | 交车管理详情 |
| 还车日期 | 有值时 | 还车管理详情 |

---

## 9. 事故记录 Tab

### 9.1 筛选

事故时间（日期范围）、客户名称、事故等级、事故状态。

### 9.2 表格

| 列 | 可点击 | 跳转 |
|---|---|---|
| 事故编码 | 是 | 事故管理详情页 |
| 其余列 | 否 | — |

---

## 10. 故障记录 Tab

### 10.1 筛选

上报时间（日期范围）、故障编号、故障等级、故障类型、解决情况、AI 匹配状态。

### 10.2 表格

| 列/操作 | 可点击 | 行为 |
|---|---|---|
| 故障编号 | 是 | Toast 跳转故障管理详情 |
| 操作「查看」 | 是 | 同上 |
| 操作「编辑」 | 是 | Toast 编辑故障记录演示 |

---

## 11. 违章记录 Tab

### 11.1 筛选

违法时间、客户名称、缴费状态、是否处理。

### 11.2 表格

| 列 | 可点击 | 跳转 |
|---|---|---|
| 违法行为 | 是 | 违章管理详情页（按违法时间标识） |
| 其余列 | 否 | — |

---

## 12. 异动记录 Tab

### 12.1 筛选

异动开始日期、异动目的地、异动类型。

### 12.2 表格

宽表展示异动起止里程/电量/氢量等；**异动开始日期**可点击 → Toast 跳转异动管理详情。

---

## 13. 调拨记录 Tab

### 13.1 筛选

调拨日期、调出人、接收人。

### 13.2 表格

**调拨日期**可点击 → Toast 跳转车辆调拨详情。

---

## 14. 年审记录 Tab

对齐「年审管理」历史列表字段（不含车牌/品牌/型号，因已在详情页上下文）。

### 14.1 筛选

| 字段 | 说明 |
|---|---|
| 完成时间 | 按办结日期范围 |
| 检验有效期 | 按检验有效期至范围 |
| 办理人 | 下拉选择 |

### 14.2 表格列

| 列 | 可点击 | 说明 |
|---|---|---|
| 检验有效期至 | **是** | Toast 跳转年审管理详情（原型演示） |
| 检测服务站名称 | 否 | 无数据显示「—」 |
| 检测费用 | 否 | 金额两位小数，无数据显示「—」 |
| 二保服务站名称 | 否 | 同上 |
| 二保费用 | 否 | 同上 |
| 整备服务站名称 | 否 | 同上 |
| 整备费用 | 否 | 同上 |
| 办理人 | 否 | — |
| 完成时间 | 否 | 办结时间，默认倒序 |

### 14.3 数据

- 来源：`data/annual-review-records.json`，按 `plateNo` 过滤
- 样例车 `粤AGP5156` 含 3 条已完成年审记录

---

## 15. 跨模块跳转 Toast 汇总

| 场景 | 文案模板 |
|---|---|
| 证照编辑 | 即将跳转至证照管理编辑页（原型演示）：{车牌} |
| 保险采购 | 即将跳转至保险采购编辑页（原型演示）：{车牌} · {险种} |
| 保单预览 | 预览保单文件（原型演示）：{文件名} |
| 保单下载 | 已开始下载：{文件名}（原型演示） |
| 租赁合同 | 即将跳转至租赁合同详情（原型演示）：{车牌} · {合同编码} |
| 交车记录 | 即将跳转至交车管理详情（原型演示）：{车牌} · {合同} · {交车日期} |
| 还车记录 | 即将跳转至还车管理详情（原型演示）：{车牌} · {合同} · {还车日期} |
| 事故详情 | 即将跳转至事故管理详情页（原型演示）：{事故编码} |
| 故障详情 | 即将跳转至故障管理详情页（原型演示）：{故障编号} |
| 故障编辑 | 编辑故障记录（原型演示）：{车牌} · {故障编号} |
| 违章详情 | 即将跳转至违章管理详情页（原型演示）：{违法时间} |
| 异动详情 | 即将跳转至异动管理详情页（原型演示）：{异动开始日期} |
| 调拨详情 | 即将跳转至车辆调拨详情页（原型演示）：{调拨日期} |
| 年审详情 | 即将跳转至年审管理详情页（原型演示）：{检验有效期至} |
| 字段保存 | 车辆信息已更新 / 运维负责人已更新 / 运营城市已更新 |

---

## 16. 原型局限

1. 各业务记录为前端 JSON 种子，不与外部年审/事故等模块真实联动。
2. 详情 Tab 间切换不保留各 Tab 内筛选/分页状态（刷新组件即重置）。
3. 行内编辑与弹窗保存仅更新内存，刷新页面后丢失。

---

## 17. 验收要点

- [ ] 返回列表保留列表态
- [ ] 11 个 Tab 均可切换且内容正确
- [ ] 各记录 Tab 筛选查询/重置/分页正常
- [ ] 所有标注可点击字段触发对应 Toast
- [ ] 年审记录含检测服务站/检测费用列，检验有效期至可点击
- [ ] 右上角「查看需求说明」展示本文档（详情页 PRD），非列表页 PRD
- [ ] 「PRD文档MD文件下载」「下载测试用例」在详情页可用且行为正确
