项目进度.md 12 KB

智慧停车管理系统 — 项目进度

更新日期:2026-07-14

技术栈

层级 技术
桌面框架 Wails v2.13(WebView2)
后端 Go 1.25 + Gin + GORM + Casbin v3 + JWT
前端 Vue 3 + Vite 4 + Element Plus + Pinia
数据库 SQLite(%APPDATA%/smart-parking/

整体进度

模块 后端 前端 状态
用户管理 完成
角色权限 Casbin RBAC,动态菜单
菜单管理 -
API 管理 -
数据字典 -
操作日志 -
停车场管理 含 /parking 前缀对齐
收费岗亭 -
通道管理 方向/临停开关
UHF 设备 TCP/串口连接/启停
车辆信息 CRUD
车辆类型 -
车主管理 含 VIP
收费配置 起步价/计费单位/每日封顶/VIP折扣
黑白名单 白名单放行/黑名单禁止
车辆进场 RFID 自动 + 手动
车辆出场 计费算法完整
进出记录 查询
摄像头 ⚠️ DAO 有定义,无 API/页面
仪表盘 ECharts 图表
个人中心 -
登录页 RSA 加密 + 验证码

核心业务流完成度

1. 系统设置 ──────── 停车场→岗亭→通道→设备  ✅ 100%
2. 收费规则配置 ──── 按车型/免费时长/VIP     ✅ 100%
3. 名单管理 ──────── 白名单/黑名单           ✅ 100%
4. 车辆进场 ──────── RFID识别→查单→开闸     ⚠️ 80% (道闸继电器注释未启用)
5. 车辆出场 ──────── 识别→计费→开闸          ⚠️ 70% (缺收费+道闸继电器)
6. 收费结算 ──────── 现金/扫码/免密          ❌ 0%
7. 小票打印 ──────── ESC/POS 串口打印        ❌ 0%
8. 摄像头识别 ────── RTSP抓拍→OCR→触发       ❌ 0%
9. LED车位屏 ────── 余位实时显示             ❌ 0%
10. 交接班对账 ───── 当班统计/现金核销        ❌ 0%
11. 报表查询 ─────── 进出记录                ⚠️ 50% (缺收入/异常)
12. 实时监控 ─────── 车位/设备/在线车         ❌ 0%

车辆进出场触发方式

触发方式 状态 说明
UHF RFID 自动识别 ⚠️ 读标签→查车辆→进出场逻辑完整,但道闸继电器调用被注释,识别后不会实际开闸
前端手动录入 ⚠️ 后端 API 已实现,前端无操作页面
摄像头车牌识别 camera 表已建,无拍照/OCR/触发逻辑
车辆靠近
  ├─ UHF 读卡器 → RFID 标签 → 查车辆 → VehicleEntry/Exit ✅
  ├─ 摄像头     → 抓拍 → OCR 车牌 → 查车辆 → VehicleEntry/Exit ❌
  └─ 人工       → 手动录入车牌 → 查车辆 → VehicleEntry/Exit ⚠️(缺前端页面)
              ↓
         三者互相校验

人工手动录入待实现内容

组件 说明
进出场操作页面 输入车牌号/RFID、选停车场/车位、拍照上传、确认进出场
关联 UHF 扫描 页面可接收 UHF 读卡器实时扫描结果,自动填入车牌

摄像头识别待实现内容

组件 说明
硬件对接 RTSP 视频流抓拍或 SDK 回调
OCR 识别 车牌识别算法或第三方云服务
业务触发 识别到车牌 → 自动调用 VehicleEntry()/VehicleExit()
图片留存 VehicleRecord 已有 EntryImage/ExitImage 字段

待开发模块

P0-1 ─ 道闸控制(最高优先级)

为什么最优先:继电器代码已写完(CloseRelay1/ReleaseRelay1),进出场流程中仅被注释掉。不启用道闸,RFID 读到标签也抬不了杆,整个物理链路是断的。解除注释 + 调试即可打通。

功能 后端 前端 说明
道闸控制 ⚠️ 继电器指令已实现,handleReportData()CloseRelay1(2) 被注释

待实现内容

组件 说明
进出场开闸 handleReportData()CloseRelay1(2) 解除注释并调试
手动开闸 前端操作页面点击开闸按钮,调用继电器 API
防砸车 地感线圈或红外对射检测车辆是否还在道闸下方
超时自动落杆 开闸后 N 秒未检测到车辆通过,自动落杆

P0-2 ─ 手动进出场页面

为什么排第二:UHF RFID 不是 100% 可靠(标签损坏、无标签车辆),必须有手动兜底。后端 API 已就绪,只缺前端页面。

功能 后端 前端 说明
手动进出场操作页 POST /vehicle/entryPOST /vehicle/exit 已实现

待实现内容

组件 说明
进出场操作页面 输入车牌号/RFID、选停车场/车位、拍照上传、确认进出场
关联 UHF 扫描 页面可接收 UHF 读卡器实时扫描结果,自动填入车牌

P0-3 ─ 收费结算

为什么排第三:道闸能抬了、手动兜底有了,下一步就是收钱。计费算法已有,但没有收款流程就无法完成经营闭环。

功能 后端 前端 说明
收费结算 出场计费后无收款流程:现金/扫码支付、免密支付

待实现内容

组件 说明
现金收款 收费员输入实收金额,自动计算找零
扫码支付 微信/支付宝扫码支付(需对接支付网关或使用静态码)
免密支付 包月车/VIP 车出场自动扣费,无需人工干预
收费记录 每笔收费记录:金额、方式、收费员、时间

P0-4 ─ 小票打印

收完钱要出票:配合收费结算,收费完成后自动打印小票给车主。

功能 后端 前端 说明
小票打印 串口 ESC/POS 指令,58mm 热敏小票打印机

待实现内容

组件 说明
串口通信 通过串口/USB 连接 58mm 热敏打印机
ESC/POS 指令 封装打印指令集:文字、条码、二维码、切纸
小票模板 停车小票格式:车牌号、进场时间、出场时间、费用、收款方式
打印触发 收费完成后自动打印,支持补打

P0-5 ─ 摄像头车牌识别

双重校验防作弊:RFID 标签可能被拆换,车牌识别作为第二道校验。也是第三种进出场触发方式(无标签车辆)。

功能 后端 前端 说明
摄像头车牌识别 RTSP 视频流抓拍 + OCR 车牌识别,camera 表已建

待实现内容

组件 说明
硬件对接 RTSP 视频流拉取或 SDK 回调(海康/大华/宇视等)
抓拍触发 车辆进入识别区 → 抓拍一张图片
OCR 识别 车牌识别算法或第三方云服务(百度/阿里 OCR)
业务触发 识别到车牌 → 自动调用 VehicleEntry()/VehicleExit()
图片留存 VehicleRecord 已有 EntryImage/ExitImage 字段

P1 — 运营管理

功能 后端 前端 说明
交接班 换班统计:当班收费总额、现金实收、差异
收入报表 按日/月/班次汇总收入
异常报表 ⚠️ 无牌车、手动抬杆、断网异常记录,前端空占位
包月车管理 月卡/季卡/年卡办理、续费、到期提醒、收入报表
LED 车位显示 入口剩余车位显示屏对接(不影响车辆进出,可后续补充)

包月车管理待实现内容

组件 说明
月卡类型 月卡/季卡/年卡,不同价格
办理页面 选车辆、选月卡类型、付月费、生成月卡记录
续费页面 到期提醒列表 + 一键续费
通行控制 月卡有效期内自动加入白名单(通行复用 shortlist 逻辑)
到期处理 到期自动从白名单移除,可设宽限期
月卡收入统计 按月/年统计月卡销售收入

说明:当前包月车的通行逻辑可以用 shortlist(白名单 + ExpirationTime)变通实现,但缺少管理端(办理/续费/统计)。

P2 — 监控与边缘端

功能 后端 前端 说明
实时监控大屏 车位余量、在线车辆、设备状态
在线车辆统计 ⚠️ 前端空占位
RK3568 边缘端 edge/ 通信层(TCP协议 + 事件总线)

前端页面清单(37 页)

位置 页面 功能 状态
login/ index.vue 登录
dashboard/ index.vue + charts + table 仪表盘
parking/ parkingInfo/index.vue 停车场信息(左列表右Tab)
parkingInfo/booth.vue 岗亭管理
parkingInfo/channel.vue 通道管理
parkingInfo/device.vue UHF设备管理
carInfo.vue 车辆信息
carOwner.vue 车主管理
pricing.vue 收费配置
roster.vue 黑白名单
report/ enter.vue 进出记录
sheet.vue 异常报表 ⚠️ 空
statistics/ vehicle.vue 在线车辆统计 ⚠️ 空
superAdmin/ user/user.vue 用户管理
authority/authority.vue 角色管理
menu/menu.vue 菜单管理
api/api.vue API管理
dictionary/*.vue 字典管理
operation/*.vue 操作日志
person/ person.vue 个人中心
layout/ 9 个组件 布局框架
error/ 2 个组件 错误页

后端 API(110+ 接口)

模块 接口数 状态
Base (login/captcha) 3
User 11
Menu 9
API 9
Authority 6
Casbin 2
Dictionary 10
OperationRecord 5
FileUpload 8
Email 2
Parking Lot 7
Booth 7
Channel 7
Device (UHF) 8
Vehicle 8
Vehicle Type 6
Vehicle Record 3
Fee Config 5
Owner 6
Shortlist 5

数据库(24 张业务表)

说明 状态
parking_lot 停车场
booth 收费岗亭
channel 通道
uhf_reader UHF读卡器
camera 摄像头 ⚠️ 表有,功能无
vehicle 车辆
vehicle_type 车辆类型
vehicle_record 进出记录
fee_config 收费标准
owner 车主
shortlist 黑白名单
sys_* (13张) GVA 系统表

下一步建议

优先级 功能 预估工时 理由
P0-1 道闸控制 半天 继电器代码已有,解除注释+调试即打通物理链路
P0-2 手动进出场页面 半天 后端 API 已就绪,只缺前端页面,UHF 不可靠时兜底
P0-3 收费结算 2-3天 经营闭环核心,现金+扫码+免密收款
P0-4 小票打印 1-2天 ESC/POS 串口指令封装 + 小票模板
P0-5 摄像头车牌识别 3-5天 RTSP+OCR,RFID+车牌双重校验
P1 包月车管理 2天 月卡办理/续费/到期处理
P1 交接班 + 收入报表 2天 运营必需
P1 LED 车位显示 1天 不影响车辆进出,可后续补充
P2 监控大屏 2天 锦上添花