慧猫开源停车平台慧猫开源停车平台
首页
介绍
快速了解
演示环境
停车平台
Gitee
GitHub
首页
介绍
快速了解
演示环境
停车平台
Gitee
GitHub
  • 文档

    • 介绍
    • 快速了解
    • 环境部署
    • 项目介绍
    • 后台手册
    • 前端手册
    • 组件文档
    • 更新日志
  • 微服务

    • 服务网关
    • 认证中心
    • 注册中心
    • 配置中心
    • 服务调用
    • 服务监控
    • 系统接口
    • 链路追踪
    • 熔断和降级
    • 分布式文件
    • 分布式事务
    • 分布式日志
    • 应用容器部署
  • 停车平台

    • 系统概述
    • 业务能力
    • 架构设计
    • 开放接口
    • 运营结算
  • 其他

    • 常见问题
    • 捐赠支持

项目介绍

慧猫开源停车平台基于 huizhi 多租户微服务底座构建,后端以 witos-parking 承载停车业务,以 witos-parking-simulator 承载设备模拟联调能力,以 witos-system 承载租户、权限、菜单、角色、日志等平台能力。

平台适合按 SaaS 方式交付给多个停车运营主体,也适合集团物业、园区、商圈、城市停车公司做私有化部署。

文件结构

后端结构

com.witos
├── witos-ui              // 前端框架 [80]
├── witos-gateway         // 网关模块 [38080]
├── witos-auth            // 认证中心 [39200]
├── witos-api             // 接口模块
│       └── witos-api-system                          // 系统接口
├── witos-common          // 通用模块
│       └── witos-common-core                         // 核心模块
│       └── witos-common-datascope                    // 权限范围
│       └── witos-common-datasource                   // 多数据源
│       └── witos-common-log                          // 日志记录
│       └── witos-common-redis                        // 缓存服务
│       └── witos-common-security                     // 安全模块
│       └── witos-common-swagger                      // 系统接口
│       └── witos-common-message                      // 消息通知
│       └── witos-common-mybatisplus                  // mybatis增强组件
├── witos-modules         // 业务模块
│       └── witos-system                              // 系统模块 [39201]
│       └── witos-gen                                 // 代码生成 [39202]
│       └── witos-file                                // 文件服务 [39300]
│       └── witos-job                                 // 调度服务 [39024]
│       └── witos-parking                             // 智慧停车业务服务
│       └── witos-parking-simulator                   // 停车设备模拟器
├── witos-visual          // 图形化管理模块
│       └── witos-visual-monitor                      // 监控中心 [39100]
├──pom.xml                // 公共依赖

前端结构

├── build                      // 构建相关
├── bin                        // 执行脚本
├── public                     // 公共文件
│   ├── favicon.ico            // favicon图标
│   └── index.html             // html模板
├── src                        // 源代码
│   ├── api                    // 所有请求
│   ├── assets                 // 主题 字体等静态资源
│   ├── components             // 全局公用组件
│   ├── directive              // 全局指令
│   ├── layout                 // 布局
│   ├── router                 // 路由
│   ├── store                  // 全局 store管理
│   ├── utils                  // 全局公用方法
│   ├── views                  // view
│   ├── App.vue                // 入口页面
│   ├── main.js                // 入口 加载组件 初始化等
│   ├── permission.js          // 权限管理
│   └── settings.js            // 系统配置
├── .editorconfig              // 编码格式
├── .env.development           // 开发环境配置
├── .env.production            // 生产环境配置
├── .env.staging               // 测试环境配置
├── .eslintignore              // 忽略语法检查
├── .eslintrc.js               // eslint 配置项
├── .gitignore                 // git 忽略项
├── babel.config.js            // babel.config.js
├── package.json               // package.json
└── vue.config.js              // vue.config.js

停车业务结构

witos-parking
├── controller
│   ├── admin              // 车场、车道、设备、收费、账户、提现、统计
│   ├── open               // 设备事件与 H5 缴费开放接口
│   └── common             // 地图、城市等公共接口
├── domain                 // 停车核心实体
├── dto                    // 入场、出场、心跳、支付、提现等请求模型
├── mapper                 // 数据访问层
├── service                // 停车业务服务
├── util                   // 停车编号、计费器
└── vo                     // 看板、订单、账户、H5 展示对象

业务模块

  • 多租户管理:支持集团、物业、运营商、车场、合作商按租户隔离运营。
  • 车场管理:车场基础信息、位置、图片、车位数量、收费规则、二维码。
  • 车道管理:入口、出口通道管理,支持启停和排序。
  • 设备管理:相机、道闸、一体机、余位屏、诱导屏、自助缴费机等统一扩展。
  • 收费规则:免费时长、计费单位、首段价格、后续价格、封顶、补费。
  • 停车会话:车辆入场、在场、待支付、已支付待离场、完成、异常。
  • 停车订单:普通订单、超时补费订单、支付状态、离场截止时间。
  • H5 缴费:车牌查单、扫码缴费、停车记录、缴费记录。
  • 开闸指令:支付成功后生成开闸指令,设备回调执行结果。
  • 账户结算:收入入账、账户余额、可提现余额、冻结金额、提现审核。
  • 经营统计:今日数据、月度经营、收入趋势、车位使用率、客单价、周转率。
  • 设备模拟器:模拟在线、离线、心跳、入场、出场,提升联调效率。
  • 会员扩展:会员等级、储值、月租、固定车位、亲情车牌、优惠券、积分、商户核销、无感支付。

核心技术

TIP

  • 前端技术栈 ES6、vue、vuex、vue-router、vue-cli、axios、element-ui
  • 后端技术栈 Spring Boot、Spring Cloud & Alibaba、Nacos、Sentinel

后端技术

SpringBoot框架

1、介绍
Spring Boot是一款开箱即用框架,提供各种默认配置来简化项目配置。让我们的Spring应用变的更轻量化、更快的入门。 在主程序执行main函数就可以运行。你也可以打包你的应用为jar并通过使用java -jar来运行你的Web应用。它遵循"约定优先于配置"的原则, 使用SpringBoot只需很少的配置,大部分的时候直接使用默认的配置即可。同时可以与Spring Cloud的微服务无缝结合。

提示

Spring Boot2.x版本环境要求必须是jdk8或以上版本,服务器Tomcat8或以上版本

2、优点

  • 使编码变得简单: 推荐使用注解。
  • 使配置变得简单: 自动配置、快速集成新技术能力 没有冗余代码生成和XML配置的要求
  • 使部署变得简单: 内嵌Tomcat、Jetty、Undertow等web容器,无需以war包形式部署
  • 使监控变得简单: 提供运行时的应用监控
  • 使集成变得简单: 对主流开发框架的无配置集成。
  • 使开发变得简单: 极大地提高了开发快速构建项目、部署效率。

SpringCloud框架

1、介绍
Spring Cloud是一系列框架的有序集合。它利用Spring Boot的开发便利性巧妙地简化了分布式系统基础设施的开发, 如服务发现注册、配置中心、消息总线、负载均衡、断路器、数据监控等,都可以用Spring Boot的开发风格做到一键启动和部署。 Spring Cloud并没有重复制造轮子,它只是将目前各家公司开发的比较成熟、经得起实际考验的服务框架组合起来, 通过Spring Boot风格进行再封装屏蔽掉了复杂的配置和实现原理,最终给开发者留出了一套简单易懂、易部署和易维护的分布式系统开发工具包。

2、优点
把模块拆分,使用接口通信,降低模块之间的耦合度。
把项目拆分成若干个子项目,不同的团队负责不同的子项目。
增加功能时只需要再增加一个子项目,调用其他系统的接口就可以。
可以灵活的进行分布式部署。

Spring Security安全控制

1、介绍
Spring Security是一个能够为基于Spring的企业应用系统提供声明式的安全访问控制解决方案的安全框架。

2、功能
Authentication 认证,就是用户登录
Authorization 授权,判断用户拥有什么权限,可以访问什么资源
安全防护,跨站脚本攻击,session攻击等
非常容易结合Spring进行使用

3、Spring Security与Shiro的区别

相同点

1、认证功能
2、授权功能
3、加密功能
4、会话管理
5、缓存支持
6、rememberMe功能
....

不同点

优点:

1、Spring Security基于Spring开发,项目如果使用Spring作为基础,配合Spring Security做权限更加方便。而Shiro需要和Spring进行整合开发
2、Spring Security功能比Shiro更加丰富,例如安全防护方面
3、Spring Security社区资源相对比Shiro更加丰富

缺点:

1)Shiro的配置和使用比较简单,Spring Security上手复杂些
2)Shiro依赖性低,不需要依赖任何框架和容器,可以独立运行。Spring Security依赖Spring容器

前端技术

  • npm:node.js的包管理工具,用于统一管理我们前端项目中需要用到的包、插件、工具、命令等,便于开发和维护。
  • ES6:Javascript的新版本,ECMAScript6的简称。利用ES6我们可以简化我们的JS代码,同时利用其提供的强大功能来快速实现JS逻辑。
  • vue-cli:Vue的脚手架工具,用于自动生成Vue项目的目录及文件。
  • vue-router: Vue提供的前端路由工具,利用其我们实现页面的路由控制,局部刷新及按需加载,构建单页应用,实现前后端分离。
  • vuex:Vue提供的状态管理工具,用于统一管理我们项目中各种数据的交互和重用,存储我们需要用到数据对象。
  • element-ui:基于MVVM框架Vue开源出来的一套前端ui组件。
最近更新:: 2026/6/1 21:03
Contributors: guankecheng-20250523, 王春
Prev
环境部署
Next
后台手册