# 智慧停车 — 进出场流程详解 > 日期：2026-07-30 本文档详细描述车辆进出场完整流程，涵盖车辆类型区分、入场方式、收费结算方式。 --- ## 1. 车辆类型体系 系统通过 `vehicle_type` 表 + `shortlist` 名单 + `monthly_card` 包月卡三层结构区分车辆身份。 ### 1.1 类型分类 ``` 车辆 │ ├─ 临时车 (vehicle_type.is_system = true) │ └─ 首次进场自动创建，无车主 │ ├─ 固定车 (vehicle_type.is_system = false，已注册) │ ├─ VIP 车 (owner.is_vip = true 且未过期) │ │ └─ 享受 VIP 折扣 / 免费 │ │ │ └─ 普通固定车 │ └─ 按对应 vehicle_type 计费 │ ├─ 月租车 (monthly_card 有效记录) │ └─ 自动加入白名单，有效期内免费通行 │ ├─ 白名单车 (shortlist.list_type = "白名单") │ └─ 放行，不拦截 │ └─ 黑名单车 (shortlist.list_type = "黑名单") └─ 拦截，禁止进出 ``` ### 1.2 优先级判断 进出场时判断顺序： ``` 1. 黑名单 → 拦截，禁止通行 2. 白名单 → 放行（月租车在此层） 3. 余额/支付 → 按车辆类型计费规则 ``` --- ## 2. 入场流程 ### 2.1 入场方式 | 方式 | 触发 | 场景 | 当前状态 | |------|------|------|:--:| | RFID 自动 | UHF 读卡器读取标签 | 有标签车辆 | ✅ | | 车牌识别 | 摄像头 OCR | 无标签车辆 | ❌ P0-5 | | 手动录入 | 操作员在 entryExit.vue 输入 | 无标签/系统故障兜底 | ✅ | | 二维码扫码 | 扫描预约/月卡二维码 | 线上预约 | 🔜 规划中 | ### 2.2 入场判断流程 ``` 车辆到达入口 │ ├─ 触发识别 (RFID / 车牌 / 手动) │ ▼ ┌─────────────────────────────────────────────────┐ │ ① 黑名单检查 │ │ CheckVehicleShortlist(plate, rfid) │ │ └─ 黑名单 → 🚫 拦截 │ │ │ │ ② 车辆查询/创建 │ │ 存在 → 使用现有记录 │ │ 不存在 → 自动创建 (临时车类型) │ │ │ │ ③ 重复入场检查 │ │ 有未出场记录 → "车辆已入场" │ │ │ │ ④ 入场方式判断 │ │ ┌─ 月租车 (白名单+未过期) → 🟢 直接放行 │ │ ├─ 固定车/VIP → 🟢 直接放行 │ │ └─ 临时车 → 通道判断 │ │ ├─ 通道允许临停 → 🟡 取票/二维码放行 │ │ └─ 通道不允许 → 🚫 拦截 │ │ │ │ ⑤ 创建入场记录 + 数字票 │ │ INSERT vehicle_record │ │ INSERT digital_ticket (state=pending_payment) │ │ ┌─ RFID → GateOpener 抬杆 │ │ └─ 手动 → 仅记录，人工抬杆 │ └─────────────────────────────────────────────────┘ ``` ### 2.3 放行策略 | 车辆类型 | 放行方式 | 说明 | |---------|---------|------| | 月租车（有效期内） | **直接放行** | RFID 识别→白名单验证→抬杆，无需任何操作 | | VIP/固定车 | **直接放行** | 已注册车辆，自动抬杆 | | 临时车（允许临停通道） | **取票放行** | 按票机按钮出纸质小票/或系统生成数字票，抬杆入场 | | 临时车（禁止临停通道） | **拦截** | 提示"临时车禁止入场" | | 黑名单 | **拦截** | 任何通道均不放行 | --- ## 3. 出场流程 ### 3.1 计费引擎 ``` calculateFee(vehicle, stayTime) │ ├─ 1. 查 fee_config WHERE vehicle_type_id = ? │ 未找到/全零 → 默认费率 0.1元/分钟 │ ├─ 2. VIP 判断 │ isVip=true && 过期时间未到 && 非零值 │ ├─ 3. VIP 免费（isVip && IsVIPFree）→ fee=0 │ ├─ 4. 免费时长内 (stayTime ≤ StartTime) → fee=0 │ ├─ 5. 超时计费 │ extraUnits = ceil((stayTime - StartTime) / UnitTime) │ fee = StartFee + extraUnits × UnitFee │ ├─ 6. 每日封顶 (DailyMaxFee) │ └─ 7. VIP 折扣 (fee ×= VIPDiscount) ``` ### 3.2 出场判断流程 ``` 车辆到达出口 │ ├─ 触发识别 (RFID / 车牌 / 手动 / 扫码) │ ▼ ┌─────────────────────────────────────────────────┐ │ ① 黑名单检查 │ │ └─ 黑名单 → 🚫 拦截 │ │ │ │ ② 查询未出场记录 │ │ 无记录 → "车辆未入场" │ │ │ │ ③ 计费 │ │ calculateFee() → 算出金额 │ │ │ │ ④ 结算方式判断 │ │ ┌─ 月租车 (白名单+未过期) → 🟢 直接放行(免费) │ │ ├─ VIP (免费策略) → 🟢 直接放行(免费) │ │ ├─ 临时车 fee=0 → 🟢 直接放行 │ │ └─ 临时车 fee>0 → 需结算 │ │ ├─ 人工现金收费 → 收费员收款 → 放行 │ │ ├─ 出口 POS 刷卡 → 刷卡支付 → 放行 │ │ └─ 中央缴费机 → 提前扫码支付 → 出口验证 │ │ │ │ ⑤ 创建支付记录 + 更新数字票状态 │ │ INSERT payment_record │ │ UPDATE digital_ticket (state=paid) │ │ ┌─ RFID → GateOpener 抬杆 │ │ └─ 手动 → 仅记录，人工抬杆 │ └─────────────────────────────────────────────────┘ ``` --- ## 4. 交易结算方式 ### 4.1 结算方式对比 | 结算方式 | 适用场景 | 费用归属 | 当前状态 | |---------|---------|---------|:--:| | **人工收费** | 岗亭操作员收现金 | 记录到 payment_record + shift_record | ✅ | | **免密放行** | 月租/VIP/免费车辆 | payment_method=free | ✅ | | **出口 POS 机** | 临时车出口刷卡 | 银行卡/会员卡扣款 | 🔜 P0-4 | | **中央缴费机** | 车主出场前在机器扫码支付 | 与中央缴费系统对接 | 🔜 规划中 | | **线上支付** | APP/小程序预支付 | 微信/支付宝 | 🔜 规划中 | ### 4.2 人工收费流程（当前） ``` 临时车到达出口 │ ├─ 操作员在 entryExit.vue 输入车牌 → 查询 │ ├─ ExitPreview → 显示费用/停留时长/车型 │ ├─ 临时车：弹出支付界面 │ ├─ 选择支付方式 [现金] [扫码(预留)] [POS(预留)] │ └─ 选现金 → 输入实收金额 → 显示找零 │ ├─ 点击"确认收款并放行" │ └─ ExitConfirm(payment_method=cash, paid_amount, operator_id) │ └─ 创建 payment_record + 抬杆 ``` ### 4.3 中央缴费机流程（规划中） ``` 出场前车主操作流程： 车主在自助缴费机 → 输入车牌 或 扫描数字票二维码 │ ├─ 系统查询 digital_ticket 表 │ └─ 找到未支付票 → 显示费用 │ ├─ 车主选择支付方式 │ ├─ 微信/支付宝扫码 → 调支付网关 → 支付成功回调 │ └─ 现金/硬币 → 机内识别 → 确认收款 │ ├─ 支付成功 │ └─ digital_ticket.state → paid │ └─ INSERT payment_record │ └─ 打印收据（可选） 车主开车到出口 │ ├─ RFID/车牌识别 → 查到 digital_ticket │ └─ state=paid → 🟢 直接抬杆放行 │ └─ 超时未离场（如缴费后15分钟未到出口） └─ 加收超时费 或 自动过期 ``` ### 4.4 出口 POS 机流程（规划中） ``` 临时车到达出口 → 识别车牌 │ ├─ 计费 → 屏幕显示金额 │ ├─ POS 机进入待支付状态 │ └─ 车主刷卡/闪付/扫码（银行卡或会员卡） │ ├─ POS 返回支付成功 │ └─ 系统记录 payment_record → 抬杆放行 ``` --- ## 5. 月租车完整流程 ### 5.1 办卡 ``` 操作员 → 包月车管理 → 选择车辆 → 选卡类型(月/季/年) │ ├─ INSERT monthly_card (start_date, end_date, fee) │ ├─ INSERT shortlist (list_type=白名单, expiration_time=end_date) │ └─ INSERT payment_record (card fee) ``` ### 5.2 进出场 ``` 月租车到达入口 │ ├─ RFID/车牌识别 │ ├─ CheckVehicleShortlist → 白名单 + 未过期 │ └─ 🟢 直接抬杆放行（零费用） │ └─ 创建 vehicle_record + digital_ticket（记录进出时间） 月租车到达出口 │ ├─ 白名单 + 未过期 │ └─ 🟢 直接抬杆放行 │ └─ 创建 payment_record(payment_method=free) ``` ### 5.3 到期处理 ``` 月租到期 → shortlist.expiration_time < now │ ├─ 进场时：白名单过期 → 按车辆原类型计费（如临时车） │ ├─ 出场时：白名单过期 → 按普通费率收费 │ └─ 续费：操作员在包月车管理中点击续费 └─ end_date 延长 → shortlist 同步更新 ``` --- ## 6. 数字票状态跟踪 ``` 车辆入场 │ └─ digital_ticket.Create() state: pending_payment │ ├─ 月租/VIP/免费 → 直接 paid → exited │ └─ 临时车需付费 │ ├─ 人工收费 → paid → exited ├─ POS 刷卡 → paid → exited（规划） └─ 中央缴费 → paid → exited（规划） ``` --- ## 7. 代码入口汇总 | 流程节点 | 函数 | 文件 | |---------|------|------| | RFID 入场 | `HandlePassage()` | `internal/service/parking/passage.go` | | 手动入场 | `VehicleEntry()` | `internal/service/vehicle/vehicle.go` | | 计费引擎 | `calculateFee()` | `internal/service/vehicle/vehicle.go` | | 出场预览 | `ExitPreview()` | `internal/service/vehicle/vehicle.go` | | 出场确认 | `ExitConfirm()` | `internal/service/vehicle/vehicle.go` | | 名单检查 | `CheckVehicleShortlist()` | `internal/service/vehicle/shortlist.go` | | 数字票 | `TicketService.Create()` | `internal/modules/digital-ticket/service/service.go` | | 支付处理 | `ProcessPayment()` | `internal/modules/payment/service/service.go` | | 通道事件 | `PushChannelEvent()` | `internal/service/uhf/reader.go` |