# 智慧停车 — 进出场流程详解

> 日期：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` |
