lc_garage/doc/功能缺失.md

智慧停车管理系统功能缺失清单

更新日期：2026-08-11
评估范围：lc_garage 当前前端、后端、设备接入和自动化测试代码
状态说明：本文用于记录尚未完成的业务闭环和生产风险，不代表相关模块完全没有代码。

1. 总体结论

当前项目已经具备单机人工收费停车场的基础业务链路，包括停车场配置、车辆管理、统一进出场、停车会话、数字票、人工收费、支付流水、月卡、交接班、报表、道闸模拟和小票打印。

距离正式运营仍缺少三个关键闭环：

1. POS、扫码、中央缴费机等真实资金交易。
2. 业务异常、设备异常的记录和处置。
3. 摄像头、道闸、地感、LED 屏的状态反馈和联动。

“存在支付方式配置”不等同于“已经接入真实支付”。当前非现金支付主要用于业务流程确认，尚未连接实际支付终端或支付网关。

2. P0：上线前必须解决

2.1 非现金支付没有真实交易能力

当前情况

• 已支持支付入口、支付方式及可用关系配置。
• POS 和外部扫码方式可以直接创建支付流水并把会话标记为已支付。
• 尚未实现支付订单、POS 驱动、扫码下单、支付网关、异步回调、主动查询和超时处理。

业务影响

• 操作员确认不能证明外部资金已经到账。
• 网络超时、支付成功但本地未更新等情况可能造成资金与业务状态不一致。

完成标准

• 增加独立支付订单和明确的待支付、处理中、成功、失败、不确定、已退款状态。
• 外部支付只能由可信终端结果、回调或主动查询确认成功。
• 支付回调、重复通知和主动查询必须幂等。
• 实现退款、撤销、冲正、失败补偿和财务对账。

2.2 异常报表和异常处置未实现

当前情况

• frontend/src/view/report/sheet.vue 只有静态表单和空表格。
• 没有异常事件实体、后端接口、查询、处置状态和审计记录。

应覆盖的异常

• 无牌车、车牌识别冲突、重复入场、无入场记录出场。
• 丢票、票据打印失败、支付失败、支付状态不确定。
• 人工抬杆、强制免费、开闸失败、设备离线。
• 余位为负、会话与数字票状态不一致。

完成标准

• 异常自动落库，包含来源、停车会话、车辆、通道、设备和操作员。
• 支持待处理、处理中、已解决、已关闭状态和处理备注。
• 人工放行和资金相关异常需要权限控制与完整审计。

2.3 票机打印失败补偿未完成

当前情况

• 票机已经接入 PassageService，按通道定位停车场和设备，并执行统一准入、会话、数字票和开闸流程。
• 已按新建停车会话直接返回数字票，不再通过车牌查询最新票据。
• 无牌取票会生成唯一票机会话身份，避免多辆无牌车共用空车牌。
• 当前打印仍是同步硬件调用；打印失败时会返回已完成的会话、票据和闸机状态，但尚无持久化任务、自动重试、重打和作废机制。

完成标准

• 打印任务持久化，支持失败重试、重打、作废和操作审计。
• 会话创建、开闸和打印失败之间有明确的补偿规则。

3. P1：已有基础实现但业务闭环不足

3.1 计费引擎能力不足

• 当前只有免费时长、起步价、固定时间单位、单次日封顶和 VIP 优惠。
• 超过 24 小时仍只应用一次日封顶，多日停车计费不正确。
• 缺少自然日或滚动 24 小时规则、跨日分段、夜间价、节假日、阶梯计费和不同停车场费率。
• 缺少缴费后免费离场时限及超时重新计费。
• 未配置收费规则时按每分钟 0.1 隐式收费，可能造成错误收费。
• 收费配置缺少负值、折扣范围、时间单位和封顶金额等完整校验。

3.2 月卡办理、续费和退卡不是完整事务

• 创建月卡、写白名单和写支付流水没有放在同一事务中，部分错误被忽略。
• 续费更新月卡、白名单和支付流水时也可能产生部分成功。
• 月卡收费固定记为收费岗亭现金，不能选择支付入口和支付方式。
• 退卡只标记 refunded 并删除白名单，没有退款金额、退款流水和审批。
• 月、季、年按 30、90、365 天计算，不是自然月、自然季度和自然年。
• 缺少过期清理、提前续费、冻结、转车、退款计算等业务规则。

3.3 交接班只覆盖现金

• 只统计 payment_method='cash'，没有按支付入口和支付方式汇总其他交易。
• 支付流程没有要求操作员必须处于当班状态。
• 开班、收款和交班缺少统一事务约束。
• 缺少管理者复核、差异审批、交班单打印和交班后锁定。
• 页面缺少完整分页、筛选、备注管理和审核能力。

3.4 收入报表维度和财务口径不足

• 当前主要按日期和停车场汇总，只单独展示现金和免费。
• 缺少支付入口、支付方式、操作员、班次、车型、通道等维度。
• 缺少退款、撤销、冲正、月卡收入和交班差异。
• 缺少明细追溯、日结、月结、导出和打印。

3.5 数字票过期状态没有自动执行机制

• 已定义 expired 状态和状态流转规则。
• 没有发现根据 expire_at 自动过期的定时任务。
• 需要明确待支付票、已支付未离场票分别在何种条件下过期，以及过期后的恢复策略。

3.6 道闸和设备模型不够独立

• 当前工作台从 UHFReader 获取道闸设备，读卡器和道闸控制器共用设备模型。
• 无法完整表达一个通道包含摄像头、读卡器、入口票机、道闸、地感等多设备拓扑。
• 缺少闸杆状态反馈、地感、防砸、落杆确认、失败重试和指令流水。
• 模拟道闸配置若在生产环境误开启，会显示在线但不发送真实指令。

3.7 停车场基础配置约束不足

• 已修复按 LotId 查询条件、容量低于当前在场车辆数校验，以及存在未出场会话时禁止删除。
• 删除停车场前仍未检查岗亭、通道和设备关联。
• 已结束的历史停车会话仍允许所属停车场被软删除，历史页面需要统一处理已删除配置的名称展示。

3.8 操作审计和敏感数据保护不足

• 操作日志保存请求体和响应体，未见密码、令牌、支付字段统一脱敏。
• 摄像头账号密码缺少加密存储方案。
• 设备失败主要写日志，尚未进入业务告警和异常处置中心。

4. P2：完全缺失或只有模型

功能	当前状态	目标能力
车牌摄像头接入	只有 camera 数据实体	摄像头配置、RTSP/SDK、OCR 回调、置信度、抓拍、防重复识别、通道绑定
中央缴费机	只有支付入口概念	终端注册、心跳、订单查询、支付、出场校验、远程配置
LED 余位屏	未实现	屏幕配置、协议适配、余位推送、离线重试
线上支付	未实现	微信/支付宝等下单、回调、查询、退款和对账
设备告警中心	未实现	在线状态、故障事件、告警等级、确认和恢复
远程设备诊断	未实现	设备参数、连通性测试、指令测试、诊断审计
数据备份恢复	未实现	SQLite 备份、校验、恢复、保留策略和恢复演练
数据归档清理	未实现	历史会话、日志、抓拍图片的归档和容量管理
报表导出打印	未实现	Excel/PDF 导出、日结单、月报和打印
打印任务管理	未实现	打印机配置、任务队列、状态、失败重试和重打权限
短信/邮件验证	模拟实现	服务商配置、发送限制、验证码校验和审计

5. 测试覆盖缺口

现有自动化测试重点覆盖停车会话、数字票、支付金额边界、重复和并发支付、事务回滚、道闸接口及 USB 票据版式。以下范围仍缺少完整测试：

• 票机打印任务持久化、失败补偿、重打和作废权限。
• 月卡办理、续费、退卡的跨表事务和退款。
• 交接班、收入报表和多支付方式对账。
• 多日计费、跨日规则、缴费后超时和收费配置异常。
• 异常事件的生成、处置、权限和审计。
• 摄像头、地感、真实道闸、LED 屏的集成和现场测试。
• 数据备份、恢复和故障恢复演练。

6. 推荐实施顺序

1. 建立异常事件、人工处置和设备指令流水。
2. 建立支付订单层，接入 POS、扫码和中央缴费机。
3. 重构多日计费及缴费后离场超时规则。
4. 完成月卡事务、退款、交接班和财务对账。
5. 接入摄像头、地感、道闸反馈和 LED 余位屏。
6. 补充报表导出、打印任务、备份恢复和生产运维能力。

7. 维护规则

• 功能开始开发时，在对应条目中补充负责人、计划版本和关联任务。
• 功能完成后必须同时满足代码实现、权限控制、自动化测试和业务验收，不能仅因页面或配置存在就标记完成。
• 已完成条目从本文移除前，应同步更新 项目进度.md、相关流程文档和测试报告。