# 小羚羚小程序 · 交车说明

**文档版本**：V1.3.2  
**更新日期**：2026-07-01  
**适用范围**：运维管理 / 交车模块（`#page=delivery`）  
**参照**：web 交车管理 + Axhub「交车（完成）」原型 · 默认区域权限：浙江省-嘉兴市

---

## 一、列表页

- **KPI**：全部 / 进行中 / 已完成，点击切换筛选。
- **搜索**：车牌、项目、客户名称。
- **卡片字段**：车牌（未选车显示「车辆待选」）、交车状态 Tag（未开始 / 已保存 / 待客户签章 / 待重新签章 / 客户已签章）、项目、客户、交车区域。
- **进行中 Tab**：提供状态筛选 Chip（全部状态、未开始、已保存、待客户签章、待重新签章）。
- **操作**：进行中任务展示「去办理 / 继续办理」按钮。

---

## 二、分步表单（顶部步骤条）

顶部步骤条：**车辆情况** → **交车检查项** → **拍摄照片**，可点击切换。

### 2.1 车辆情况

Hero 展示客户名称、项目名称与交车区域；含选择车辆、车辆配置、驾驶培训、交车数据、交车位置（独立卡片）。

#### 识别车牌号

拍照 OCR 识别车牌后，根据识别结果匹配车辆并校验交车资格，须同时满足：

- **车辆状态 = 已备车**
- **保险状态 = 正常**
- **证照状态 = 正常**

任一条件不满足则报错阻断，不可选车。报错提示文案与「选择车辆」页车辆卡片底部 readiness 提示条一致，例如：

- 「交强险已到期无法交车」
- 「商业险已到期无法交车」
- 「交强险、商业险已到期无法交车」
- 「行驶证已到期无法交车」
- 未备车时「该车辆未备车，请先进行备车」

支持**拍照识别**或**相册选取**车牌照片。

#### 相册上传

交车模块内**所有拍照环节**均支持从手机相册本地上传图片，包括：识别车牌号、车辆配置（车身广告/放大字）、驾驶培训手动记录证件照、交车连拍/补拍、瑕疵与其他照片添加、备胎拍摄等；相机页底部提供「拍照」「相册」操作。

**相册选择规则（V1.3.2）**：

| 场景 | 规则 |
| --- | --- |
| **连拍环节** | **相册单选**：文件选择器为单选模式，每次只能选 1 张；选好后进入当前项预览，点「完成」确认 |
| 瑕疵 / 其他补充照片 | 相册多选可一次添加多张（该类合计最多 6 张） |
| 备胎 / 其他单拍场景 | 相册单选，每次 1 张 |
| 通用限制 | 仅接受常见图片格式；单张不超过 5MB |

#### 车辆配置

- 车身广告及放大字、尾板（必填，有则须上传照片）
- 备胎（选填，仅选择有/无）

#### 驾驶培训（必填）

支持**电子培训** / **手动记录**两种模式。

**电子培训**：展示培训二维码（微信扫码观看视频），完成后识别提车码。

**手动记录（运维端）**：

1. 录入司机手机号、姓名、身份证号
2. 上传身份证正反面、驾驶证正反面、司机正面照片、从业资格证（重卡必填）
3. 点击底部「生成培训码」
4. 培训码与录入信息绑定，展示二维码供司机微信扫码
5. 生成后交车页标记「待司机确认」，可「查看培训码」或「刷新培训状态」
6. 司机签字完成并同步后标记「已完成驾驶培训」

**手动记录 · 司机微信端**（仅需求说明，本期原型不实现）：

司机微信扫描二维码后，首先阅读并同意安全培训文件（倒计时 10 秒后可点确定）；随后在司机微信浏览器展示运维登记的司机「姓名」「手机号」「身份证号」及身份证正反面、驾驶证正反面、司机正面照片、从业资格证照片；下方点击「确认签字」唤起签名板，完成签字后提示培训成功，相关信息同步至安全培训记录。

#### 交车数据（必填）

- 里程、氢量、电量均支持 2 位小数输入（无数字步进器）
- 氢量单位按「型号参数」仪表盘单位随车型自动匹配（%/MPa，不可手动切换）
- 送车服务费为选填，精确至 2 位小数（元）
- 氢量下方备注为选填
- **不含**交车时间字段

#### 交车位置

- 车辆 GPS 在线：交车位置取车辆 GPS 当前定位
- 车辆 GPS 离线：交车位置取手机当前定位
- 独立卡片展示地图、蓝点标记坐标；GPS 离线时支持手动「获取当前定位」

### 2.2 交车检查项

证件信息 → 工具信息 → 外观检查 → 轮胎检查。

- 前 3 类：开关表示检查情况并可填备注
- 轮胎检查项：填写胎纹深度 (mm)

**实际交车时间**：运维提交 E签宝签章时系统自动记录；仅在交车列表「待客户签章」卡片展示。

### 2.3 拍摄照片

- 分车身 / 底盘 / 轮胎 / 瑕疵 / 其他五类
- 连拍严格按顺序拍摄且不可跳过；中途退出后再次进入自动从下一项续拍
- 模拟相机页支持**拍照或相册上传**，轮胎项下方录入胎纹；完成后可补拍瑕疵/其他
- **所有拍照场景均支持调焦**：点击取景区域设定对焦点，右侧 +/- 调整 1.0×～3.0× 数码变焦（连拍、备胎、车身广告/放大字、手动记录证件照）

**备胎照片**：从车辆情况步骤移至拍摄照片「轮胎情况」连拍末项（有备胎时必拍）；车辆情况仅保留是否有备胎。

**拍照操作条布局（V1.3）**：

相机页底部操作条（`.xll-dv-photo-camera-actions`）按钮等宽平铺：

| 状态 | 按钮 |
| --- | --- |
| 未拍摄 | 「拍照」「相册」两按钮等宽 |
| 已拍摄 | 「重新拍摄」「相册」「完成」三按钮等宽 |

**分步操作条**：车辆情况、交车检查项点击「下一步」时自动保存；拍摄照片步骤完成后为「保存」「发送签章文件」。

**连拍自动保存（V1.3）**：连拍中每次点击「完成」进入下一拍摄项时，**强制静默自动保存**交车单草稿（未开始 → 已保存）。与「下一步」自动保存规则一致，无需用户再点「保存」。

**照片上传**：连拍/单拍每次点击「完成」继续时，上一张自动上传并在服务端打水印（时间、地点）。

**胎纹 OCR**：胎纹未反写成功时禁止继续拍摄下一张。

### 2.4 签章流程

**选择被授权人**：多卡片展示姓名与手机号，选中高亮；发送签章文件后跳转 E签宝 完成运维签字。

| 状态 | 规则 |
| --- | --- |
| **待客户签章** | 只读查看各步骤，底部「返回」「清除签章」；确认后记录变为「待重新签章」 |
| **待重新签章** | 交车信息全部锁定，仅可重选被授权人；底部「返回」「重新发起签章」，完成 E签宝 运维签字后恢复「待客户签章」 |
| **客户已签章** | 被授权人短信完成签章后进入「已完成」列表 |

---

## 三、查看态

- **客户已签章 / 待客户签章**：只读浏览各步骤，不可编辑。
- **待重新签章**：各步骤只读，仅「选择被授权人」可改。
- **已完成**：可下载 E签宝签章 PDF；展示是否归还。

---

## 四、导航

- 表单内左上返回先退出办理页；再次返回退出交车模块。
- 步骤条可点击跳转。

---

## 五、验收要点

请在预览中逐项确认（可提供截图或页面路径反馈）：

- [ ] 业务页进入交车模块，列表 KPI / 搜索 / 状态筛选可用
- [ ] 进行中任务可「去办理 / 继续办理」，列表与表单同页切换
- [ ] OCR / 相册识别车牌，未备车或保险/证照异常时阻断选车
- [ ] 车辆配置、驾驶培训、交车数据、交车位置各卡片可填写
- [ ] 交车检查项四类可填，轮胎胎纹支持 mm 录入
- [ ] 拍摄照片五类连拍、相册上传、调焦与备胎末项规则
- [ ] **连拍相册单选**：连拍环节相册为单选模式，每次只能选 1 张（无法多选）
- [ ] **瑕疵/其他多选**：补充照片仍可相册批量添加
- [ ] **连拍自动保存**：每次点「完成」进入下一项后草稿状态为「已保存」
- [ ] **拍照操作条**：拍照/相册（及完成态三按钮）等宽平铺展示
- [ ] 发送签章 → 待客户签章 → 清除签章 / 重新签章 / 客户已签章状态流转
- [ ] 标注目录可打开本 PRD；页面标注 `page-delivery` 可定位交车模块

**预览地址示例**：`http://localhost:51721/prototypes/xll-miniapp#page=delivery`

---

## 六、关联文档

| 文档 | 位置 |
| --- | --- |
| 小程序总览 | 标注目录「PRD 00｜小程序总览」 |
| 审批中心改版 | 标注目录「PRD 01｜审批中心改版说明」 |
| 页面标注 | `page-delivery` |
| 原型评审 | `src/prototypes/xll-miniapp/.spec/prototype-review.md` |

---

## 七、版本记录

| 版本 | 日期 | 说明 |
| --- | --- | --- |
| V1.3.2 | 2026-07-01 | 连拍相册明确为单选模式（非多选后取首张） |
| V1.3.1 | 2026-07-01 | 连拍环节相册改为仅支持单张上传（不支持批量） |
| V1.3 | 2026-07-01 | 瑕疵/其他相册多选；连拍「完成」强制自动保存；拍照操作条按钮等宽平铺 |
| V1.2 | 2026-06-29 | 交车分步表单、连拍、签章与相册上传基线 |
