车辆进出纪录需求文档 (v1.5.0)

1. 功能概述

记录车辆进出特定区域的详细信息，为“车辆管理”提供通行轨迹，并作为“车辆收费”的历史参考。系统主要通过边缘网关从停车系统获取数据。核心收费闭环由本地停车系统完成，本模块侧重于数据展示、历史归档及异常数据管理。

2. 业务需求

2.1 进场记录管理

• 自动采集 (网关同步):

  • 通过边缘网关从停车系统同步进场事件。

  • 同步要求: 不需要实时推送，但需确保用户在后台查看数据时，展现的是当前最新的进场记录。

• 重复入场处理 (核心逻辑更新):

  • 场景: 当车辆已有一条或多条“在场 (In-site)”记录时，再次产生新的入场信号。

  • 处理流程:

    1. 告警推送: 系统立即生成告警消息推送至物业员工，提示车牌逻辑异常。

    2. 状态标记: 将该车牌原有的所有“在场 (In-site)”记录状态更新为 “异常数据 (Abnormal)”。

    3. 新记创建: 允许车辆正常进入，并产生一条全新的“在场 (In-site)”记录。

    4. 不拦截原则: 确保业务流程不因逻辑异常而阻塞道闸开启。

• 记录删除功能:

  • 适用场景: 识别错误（如将广告牌识别为车牌）或道闸故障产生的无效入场记录。

  • 操作权限: 仅限具备权限的管理员操作。

  • 执行结果: 支持从列表中删除指定记录，删除后该记录不再参与后续的出场匹配及计费关联。

2.2 出场记录管理与计费关联

• 自动匹配规则:

  • 同步出场事件时，系统根据车牌号匹配记录。

  • 计费原则: 系统必须取离出场时间最近的一条“在场 (In-site)”记录进行关联结案。

  • 异常清理: 若匹配后发现仍存在其他“在场”记录，系统需自动将其标记为“异常数据 (Abnormal)”。

• 收费标准匹配:

  • 默认规则: 对于临停车及访客车辆，系统统一采用其所属车场定义的唯一一条默认收费规则。

  • 关联性: 每个车场有且只有一条默认规则，确保计费逻辑的唯一性。

2.3 状态流转 (Status Lifecycle)

• 在场 (In-site): 车辆已入场，等待匹配出场。

• 已离场 (Departed): 正常的入出场闭环记录。

• 异常数据 (Abnormal):

  • 因重复入场被系统自动标记的陈旧在场记录。

  • 被管理员手动标记为异常的记录。

• 手动结案 (Manual-Closed): 通过管理员手动执行出场操作完成。

3. 字段规划 (数据对齐)

4. 模块联动逻辑

4.1 关联【车辆收费】(d0a6-)

• 规则应用: 进出记录生成时，若判断为临停/访客，则自动关联车场默认规则。

• 计费同步: 确保 charge_id 关联的是基于“最近入场记录”产生的账单，异常数据不产生或关联有效账单。

4.2 关联【车辆管理】(77f0-)

• 记录穿透: 在车辆详情页展示“通行日志”时，需默认过滤掉“异常数据”及“已删除”记录，除非用户勾选“查看全部”。

5. 待确认事项 (已落实)

• 重复入场: 确认为“告警推送 + 自动转异常 + 匹配最近入场”。

• 收费规则: 确认为“每个车场有且只有一条默认规则”。

• 删除逻辑: 确认支持对故障/错误记录进行删除。

进出纪录 (v1.5.0)

1 进场记录

2 重复入场处理

3 出场记录

4 状态流转

5 收费关联