# 车辆管理需求文档 (PRD) v1.10.0

## 修订历史

| 版本号 | 修订日期 | 修订内容 | 修订人 | 状态 |
| :--- | :--- | :--- | :--- | :--- |
| v1.0.0 | 2026-01-27 | 初始版本：定义车辆档案核心字段与基础状态 | Antigravity | 已发布 |
| v1.1.0 | 2026-01-27 | 扩展版本：整合车场、车位、计费及进出记录关联需求 | Antigravity | 已发布 |
| v1.2.0 | 2026-01-27 | 细化版本：调整权属信息逻辑、固定车辆类型标签 | Antigravity | 已发布 |
| v1.3.0 | 2026-01-27 | 强化版本：明确“先审核后下发”约束 | Antigravity | 已发布 |
| v1.4.0 | 2026-01-27 | 最终修正：细化续费免审流程、增加消息提醒 | Antigravity | 已发布 |
| v1.5.0 | 2026-01-28 | 逻辑更新：支持手动下发、调整有效期逻辑 | Antigravity | 已发布 |
| v1.6.0 | 2026-01-29 | 扩展标签：新增访客车与黑名单车辆 | Antigravity | 已发布 |
| v1.7.0 | 2026-01-29 | 深度细化：完善访客车生命周期、黑名单操作机制 | Antigravity | 已发布 |
| v1.8.0 | 2026-01-29 | 逻辑修正：优化访客冲突提示、换车账单逻辑、增加异常通行处理 | Antigravity | 已发布 |
| v1.9.0 | 2026-01-29 | 逻辑更新：访客计费模式、支付驱动续期、临时车延期删除 | Antigravity | 已发布 |
| v1.10.0 | 2026-01-30 | 逻辑精炼：访客准入豁免、道闸进出约束、有效期更新算法、换车1换1原则 | Antigravity | 草稿 |

---

## 1. 目标
构建完整的车辆管理体系，实现车辆档案、车位授权、费用管理、设备同步及通行记录的闭环管理，确保数据唯一性与业务逻辑的严密性。

## 2. 核心功能需求

### 2.1 车辆档案管理与查重
- **唯一性原则**：系统内一个车牌号只能存在一条有效的档案数据。
- **访客登记查重**：若检测到车牌已存在于住户/物业车辆档案中，提示：“**该车牌已登记为[XX住户/物业]的车辆，不用将车辆添加为访客车**”。此时，该车辆的收费逻辑沿用原绑定的收费逻辑。

### 2.2 车辆有效期与更新逻辑 (Validity Update Logic)
- **术语规范**：车辆有效期明确使用“**更新**” (Update) 描述，不再使用“延长”或“挪动”，以避免逻辑歧义。
- **首次授权**：起始点为车辆第一次申请并审核通过的时间。
- **支付驱动更新算法**：
  - **更新公式**：`车辆有效期 = MAX(当前有效期, 所有已支付账单中的最晚结束时间)`。
  - **账单支付顺序约束**：账单必须按时间先后**顺序支付**，或在单次操作中**一并支付**，禁止跨期支付。
- **通行判定 (道闸约束)**：
  - **进场限制**：道闸仅在车辆处于**有效期范围内**时允许进场。
  - **出场限制**：道闸**不限制**车辆出场的有效期，即车辆在任何时间均可离场（离场时根据计费规则结算费用）。

### 2.3 访客车辆管理 (Visitor Management)
- **准入控制豁免**：
  - **定义**：访客车属于“**系统已登记车辆**”。
  - **逻辑**：当车场管理模块设置“**关闭准入**”（禁止外部车辆进入）时，**仍允许**已登记的有效访客车进场放行。
- **有效期定义**：
  - **车辆管理维度**：访客车有效期按“**来访日期段**”计算（例如：1月30日至1月31日），即该日期段内均有效。
  - **车辆收费维度**：计费有效期基于**真实的进场和出场时间戳**。
- **信息维护**：
  - **车牌变更**：支持对已登记的访客车进行车牌号变更，并同步更新来访车辆信息。
- **计费与支付**：
  - 按车场**默认规则**计费。支持访客或住户通过扫描临停二维码缴费。
- **有效期合并**：若同一车牌被多人登记，合并所有登记的日期段为最大覆盖范围。

### 2.4 换车申请逻辑 (1-to-1 Swap)
- **1换1原则**：换车申请必须严格遵循“**1换1**”对应关系。
- **资源流转**：
  - 换车申请审核通过后，**原车自动释放**其绑定的车位资源。
  - **新车自动占用**原车释放的车位资源。
  - **约束**：总车位占用数及车辆总数应保持恒定。

### 2.5 临时车过期处理（欠费保护）
- **检查机制**：2年有效期到期时，检查是否存在待支付账单。
- **状态流转**：存在欠费时标记为“已过期待清算”，缴清后执行软删除。

### 2.6 黑名单管控 (Blacklist Management)
- **强制结清原则**：必须结清所有欠费后，才允许移出黑名单。
- **下发逻辑**：立即下发至边缘网关，失败则持续重试。

### 2.7 异常通行与清理
- **重复入场处理**：离场时按最近的一条入场数据计费，其他冲突数据标记为“异常数据”。
- **车辆删除清理**：删除时保留进出记录和已付账单，解除通行权限和车位绑定。

---

## 3. 业务规则
- **默认收费规则唯一性**：每个停车场有且仅有一条“默认收费规则”。
- **消息提醒**：欠费通知、租赁到期前 2 天通知、审核结果通知、临时车过期清算通知。

---

## 4. 外部模块关联定义
- **车场管理 (4e27-)**：提供唯一默认收费规则及准入控制状态。
- **车位管理 (7531-)**：处理换车时的资源释放与占用。
- **车辆收费 (d0a6-)**：提供实时账单状态及支付驱动的有效期更新。
- **车辆审核 (3b4e-5)**：处理换车及首次授权入口。