车辆管理需求文档 (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)：处理换车及首次授权入口。