系统概述

平台愿景

慧猫开源停车平台定位为停车行业的多租户运营中台。它面向的不是单一停车场，而是“一个平台管理多个客户、多个项目、多个停车场、多个设备厂商、多个会员体系、多个财务结算主体”的复杂运营场景。

平台把传统停车系统拆成可扩展的业务中台能力：车场资源、设备接入、交易订单、会员权益、支付结算、经营分析、权限审计、开放接口。每个能力都可以独立演进，也可以组合成完整的 SaaS 产品交付给物业集团、停车运营商、城市停车公司和商业综合体。

核心链路

flowchart LR
    A[车辆入场] --> B[设备识别上报]
    B --> C[生成停车会话]
    C --> D[出口识别计费]
    D --> E[车主 小程序 查单缴费]
    E --> F[支付成功]
    F --> G[下发开闸指令]
    G --> H[设备回调]
    H --> I[订单归档]
    I --> J[收入入账]
    J --> K[经营统计与结算]

多租户模型

慧猫开源停车平台的多租户不是简单加一个 tenant_id 字段，而是围绕停车运营建立完整隔离：

租户隔离：每个运营主体拥有独立数据空间。
菜单隔离：不同租户可开通不同功能模块。
角色隔离：总部、区域、车场、财务、客服、设备运维各司其职。
数据隔离：用户只能看到自己租户、部门、车场范围内的数据。
套餐隔离：基础版、专业版、集团版、城市版可按能力组合售卖。
品牌隔离：可扩展租户 Logo、系统名称、主题色和专属入口。
结算隔离：不同租户独立账户、独立流水、独立提现审核。

设备模型

平台将硬件统一抽象为设备、车道和事件：

设备：相机、道闸、一体机、余位屏、诱导屏、自助缴费机、岗亭终端、地磁、扫码盒子等。
车道：入口、出口、混合通道、人工通道、无人值守通道。
事件：入场识别、出场识别、心跳、开闸结果、异常告警。
指令：开闸、关闸、重试、状态同步、参数下发等可扩展能力。

当前代码已实现入场、出场、心跳、开闸回调等开放接口，厂商编码、接入方式、设备密钥和配置 JSON 已预留，后续接入真实设备厂商时具备扩展基础。

业务对象

停车场 ParkingLot
├── 车场位置、车位数量、临停/月租车位、收费规则、缴费二维码
├── 通道 ParkingGate
│   ├── 入口通道
│   └── 出口通道
├── 设备 ParkingDevice
│   ├── 相机
│   ├── 道闸
│   └── 一体机
├── 停车会话 ParkingSession
├── 停车订单 ParkingOrder
├── 支付记录 ParkingPayment
├── 开闸指令 ParkingGateCommand
├── 账户 ParkingAccount
└── 提现记录 ParkingWithdrawOrder

运营闭环

停车业务真正有价值的地方在运营闭环：

车主进场自动识别，减少取卡和人工录入。
出场自动计费，减少岗亭争议。
车主扫码自助缴费，减少排队。
支付成功自动开闸，提高通行效率。
超过离场宽限期自动补费，减少逃费。
每笔收入自动入账，方便对账。
每个租户独立提现审核，方便平台化运营。
所有数据进入看板，辅助经营决策。

适配场景

商场停车：会员积分、消费抵扣、商户发券、停车券核销。
园区停车：员工月租、访客预约、企业车队、固定车位。
社区停车：业主车辆、亲情车牌、临停访客、黑白名单。
医院停车：高峰快速通行、无感支付、特殊车辆减免。
城市停车：路内路外统一监管、区域统计、财政结算。
运营商 SaaS：为多个停车场客户提供统一后台和独立账号。

为什么适合二开

平台已经把通用后台和停车主流程打通，后续扩展重点可以放在客户最关心的差异化能力上，例如会员中心、支付通道、真实硬件协议、电子发票、分账规则、场内导航、余位发布、无人值守运营等。