lc_garage/doc/项目进度.md

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

更新日期：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识别→查单→开闸     ✅ 100%
5. 车辆出场 ──────── 识别→计费→..→开闸      ⚠️ 80% (缺收费)
6. 收费结算 ──────── 现金/扫码/免密          ❌ 0%
7. 小票打印 ──────── ESC/POS 串口打印        ❌ 0%
8. 交接班对账 ────── 当班统计/现金核销       ❌ 0%
9. 报表查询 ──────── 进出记录                ⚠️ 50% (缺收入/异常)
10. 实时监控 ─────── 车位/设备/在线车         ❌ 0%

车辆进出场触发方式

触发方式	状态	说明
UHF RFID 自动识别	✅	service/uhf/reader.go，读标签→查车辆→进出场
前端手动录入	⚠️	后端 API 已实现，前端无操作页面
摄像头车牌识别	❌	camera 表已建，无拍照/OCR/触发逻辑

车辆靠近
  ├─ UHF 读卡器 → RFID 标签 → 查车辆 → VehicleEntry/Exit ✅
  ├─ 摄像头     → 抓拍 → OCR 车牌 → 查车辆 → VehicleEntry/Exit ❌
  └─ 人工       → 手动录入车牌 → 查车辆 → VehicleEntry/Exit ⚠️（缺前端页面）
              ↓
         三者互相校验

人工手动录入待实现内容：

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

摄像头识别待实现内容：

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

待开发模块

P0 — 核心闭环（收费 + 打印）

功能	后端	前端	说明
收费结算	❌	❌	出场计费后无收款流程：现金/扫码支付、免密支付
小票打印	❌	❌	串口 ESC/POS 指令，58mm 热敏小票

P1 — 运营管理

功能	后端	前端	说明
交接班	❌	❌	换班统计：当班收费总额、现金实收、差异
收入报表	❌	❌	按日/月/班次汇总收入
异常报表	❌	⚠️	无牌车、手动抬杆、断网异常记录，前端空占位

P0.5 — 手动进出场页面

功能	后端	前端	说明
手动进出场操作页	✅	❌	后端 API 已有，缺前端操作页面

P2 — 监控与硬件

功能	后端	前端	说明
实时监控大屏	❌	❌	车位余量、在线车辆、设备状态
在线车辆统计	❌	⚠️	前端空占位
摄像头车牌识别	❌	❌	DAO 已有 camera 表，抓拍/OCR/触发全缺
LED 车位显示	❌	❌	入口剩余车位屏
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 系统表	✅

下一步建议

1. 手动进出场操作页面 (P0.5) — 后端 API 已就绪，只需前端页面，半天可完成
2. 收费结算模块 (P0) — 闭环核心，优先级最高
3. 小票打印 (P0) — 配合收费
4. 摄像头车牌识别 (P2) — 第三种进出场触发方式
5. 交接班 + 收入报表 (P1) — 运营必需
6. 监控大屏 (P2) — 锦上添花