Spring Boot+Vue3 多租户自助门店系统:IoT 硬件集成与无人值守方案
一套基于 Spring Boot 和 Vue3 的多租户自助门店系统。系统支持微信小程序、员工 APP 及 Web 管理后台,涵盖台球、棋牌、茶室等多种业态。核心功能包括场地预约、智能硬件控制(门禁/电控)、商品自助购买及分账管理。采用多租户架构实现数据隔离,通过 IoT 中台对接各类设备,支持无人值守运营。技术栈包含 Java、MySQL、Redis、Netty 等,提供开放 API 便于二次开发。
一套基于 Spring Boot 和 Vue3 的多租户自助门店系统。系统支持微信小程序、员工 APP 及 Web 管理后台,涵盖台球、棋牌、茶室等多种业态。核心功能包括场地预约、智能硬件控制(门禁/电控)、商品自助购买及分账管理。采用多租户架构实现数据隔离,通过 IoT 中台对接各类设备,支持无人值守运营。技术栈包含 Java、MySQL、Redis、Netty 等,提供开放 API 便于二次开发。
智场未来·多租户自助门店系统是一套完整的线下实体空间数字化解决方案,涵盖微信小程序端(用户端)、员工 APP 端、Web 管理后台(总平台/门店端)及 IoT 物联网中台四大核心模块。
平台聚焦台球厅、棋牌室、24h 共享茶室、羽毛球馆、高尔夫练习场、健身房等自助场景,提供从场地预约、智能门禁、灯光控电、商品自助购买、会员营销到多角色分账的全流程服务。系统采用多租户架构设计,支持品牌连锁加盟模式,实现总部统管、分店自营、数据隔离,为线下实体数字化转型提供坚实的技术底座。

多租户架构,连锁扩张的基石
原生支持多租户 + 多门店模式,总后台统一定价、统一营销,各分店数据实时隔离又汇总。无论是管理一个城市的 10 家自助台球分店,还是管理全国不同品牌的羽毛球馆,后台都能做到精细管控。

硬件深度整合,真正实现无人值守
自研 IoT 网关中间件,支持 485/232 协议、TCP/IP 直连及蓝牙 Mesh 组网。稳定对接门禁、电控、灯光、空调、售货机等 20+ 类硬件,用户下单即通电,离店自动断电,彻底取代前台,一年节省十几万人工成本。
多业态适配,一套代码跑通'体育+'
无论是按小时计费的台球、棋牌,还是按场次收费的羽毛球、篮球,亦或是按包段计费的茶室、按人次的游泳健身,系统灵活的'乐高式'计费引擎都能完美适配,支持任意组合计费规则。

全端覆盖,业务流程无缝协同
小程序端(用户下单)、员工 APP 端(保洁工单)、POS 端(门店管理)、总后台(数据决策)四端联动,从用户进店到离场,从保洁打扫到财务对账,全流程数字化闭环。
开放架构,支持二次开发
提供完整的 OpenAPI 接口、Webhook 事件订阅、硬件接入 SDK 及插件化架构,开发者可基于系统进行深度定制,满足各类个性化需求。

| 技术 | 版本/说明 |
|---|---|
| 编程语言 | Java 1.8 / 11 |
| 应用框架 | Spring Boot 2.7.x |
| 微服务组件 | Spring Cloud Alibaba(可选) |
| 认证授权 | Spring Security、JWT |
| ORM 框架 | MyBatis Plus 3.5.x |
| 数据库 | MySQL 8.0(支持分库分表) |
| 缓存 | Redis 6.x |
| 消息队列 | RocketMQ / RabbitMQ |
| 分布式任务 | XXL-JOB / Quartz |
| 连接池 | Druid 1.2.x |
| API 文档 | Knife4j / Swagger 3 |
| 对象存储 | 阿里云 OSS / 七牛云 / MinIO |
| 支付接口 | 微信支付、支付宝 |
| IoT 通信 | Netty + MQTT |
| 分账系统 | 微信支付分账、自定义分账引擎 |
| 技术 | 版本/说明 |
|---|---|
| 前端框架 | Vue 3.5.x |
| 构建工具 | Vite 5.x |
| UI 组件库 | Element Plus 2.4.x |
| 状态管理 | Pinia |
| 路由管理 | Vue Router 4 |
| HTTP 客户端 | Axios |
| 数据可视化 | ECharts 5 |
| 管理后台 | store-admin(基于 Vue 3 + Element Plus) |
| 技术 | 版本/说明 |
|---|---|
| 核心框架 | uni-app(Vue 3) |
| UI 组件库 | uni-ui / uView Plus |
| 地图 SDK | 腾讯地图 / 高德地图 |
| 目标平台 | 微信小程序 |
| 技术 | 版本/说明 |
|---|---|
| 核心框架 | uni-app |
| 目标平台 | 微信小程序(员工码)/ 安卓 APK |
首页模块:基于 LBS 展示附近门店、轮播图、快捷功能入口(扫码开门/预约/拼团)、热门场地推荐、优惠活动展示。
门店详情:展示门店环境图、场地列表(台球桌/棋牌包间/羽毛球场地)、实时空闲状态、计费规则、用户评价、门店公告。
预约下单:支持日历选时(按小时/按场次)、在线选座/选桌、支付押金、优惠券抵扣、多人拼单、一键开门。
个人中心:订单记录(进行中/已完成/已取消)、会员卡/次卡管理、优惠券包、收藏门店、邀请有礼、客服咨询。
商品购买:场馆内自助下单购买饮料/球杆/零食,支持扫码取货、快递到家、到店自提。
评价反馈:离场后对场地环境、设备状况进行多维度评分,支持图文评价。

工单处理:接收系统自动派发的保洁工单,完成打扫后一键切换房间状态为'可售'。
设备控制:远程开关灯光、空调、门锁,处理客户误操作或紧急情况。
异常处理:处理用户退款申请、远程开门请求、硬件离线告警。
库存管理:查看自助售货机库存,接收补货提醒,扫码补货。

多租户管理:租户(加盟商)入驻审核、套餐订购、到期提醒、资源配额管理。
数据看板:平台总交易额、分店营收排行、用户增长趋势、硬件在线状态大盘。
分账管理:平台服务费自动扣除、T+1 结算给商户、分账明细查询。
应用市场:插件管理(如赛事报名、私教预约)、第三方应用接入。

数据驾驶舱:实时展示门店坪效、空置率、硬件在线状态、今日营收、客流分析。
订单管理:订单列表、订单详情、退款审核、异常订单处理。
场地管理:场地编辑、计费规则配置(高峰期/低谷期定价)、场地维护状态设置。
商品管理:商品上架/下架、库存预警设置、自助售货机绑定。
会员管理:会员列表、会员标签、储值卡/次卡发放、流失会员唤醒。
营销中心:优惠券发放(满减/折扣)、拼团活动、积分商城、邀请有礼配置。
财务管理:收入明细、提现申请、押金管理、分账记录。
硬件管理:设备列表、设备状态监控、远程控制、故障告警。
系统设置:门店信息设置、营业时间、管理员权限分配。

设备管理:设备注册、在线状态监控、OTA 固件升级。
协议适配:支持 Modbus、BACnet、私有 TCP 协议转换。
规则引擎:设备联动规则配置(如门锁开启→自动通电→灯光亮起)。
告警中心:设备离线告警、异常开门告警、阈值告警。

系统设计了一套**'乐高式'计费规则引擎**,支持任意组合:

针对羽毛球、高尔夫等强预约属性的场景,系统提供多级预约引擎:

门禁类:磁力锁、电插锁、人脸识别平板、身份证读卡器(棋牌室实名)
控制类:智能空开(精准控电)、智能灯控(分区控制,节能 30%+)、智能球杆柜锁、空调温控器(远程调温)
交易类:自助售货机(联动退押金)、共享充电宝、智能零食货柜(扫码开门即取)
特色场景:高尔夫模拟器计时计费、羽毛球发球机控制、跑步机/健身器械数据同步
合伙人分账:支持按比例(如甲 60%、乙 40%)自动分账,每日/每月自动结算
房东/物业分账:支持按营业额抽成模式,自动计算应付租金
平台服务费:自动扣除技术服务费,T+1 将剩余款项结算给商户
硬件供应商分账:融资租赁硬件按使用次数自动分润

提供RESTful API + WebSocket双通道接口,覆盖 90% 以上核心业务功能:

系统采用**钩子(Hooks)与过滤器(Filters)**设计模式:
针对不同业态的特殊数据记录需求,引入元数据(Metadata)框架:
开放IoT 设备接入 SDK,支持开发者将自研硬件快速接入:

| 组件 | 版本要求 |
|---|---|
| JDK | 1.8 或 11+ |
| Maven | 3.6+ |
| MySQL | 8.0+ |
| Redis | 6.x+ |
| Node.js | 16+ |
| 开发工具 | HBuilderX、微信开发者工具 |
1. 创建数据库
CREATE DATABASE smart_venue DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
use smart_venue;
source sql/smart_venue.sql;
2. 修改配置
编辑 application-dev.yml,配置:

3. 编译运行
# 克隆项目
git clone <project-repo>/smart-venue.git
# 进入目录
cd smart-venue
# 打包
mvn clean package -Dmaven.test.skip=true
# 运行
java -jar smart-venue-admin/target/smart-venue-admin.jar
4. 访问接口文档
http://localhost:8080/doc.html

1. 安装依赖
cd smart-venue-ui
npm install
2. 修改配置
编辑 .env.development:
VITE_APP_BASE_API = 'http://localhost:8080'
3. 启动开发环境
npm run dev
# 访问地址:http://localhost:80
# 默认账号:admin 密码:admin123

4. 生产构建
npm run build:prod
1. 导入项目
使用 HBuilderX 打开 smart-venue-uniapp 目录
2. 修改配置
manifest.json,配置微信小程序 appidutils/config.js,修改 baseUrl 指向后端 API 地址3. 运行调试
HBuilderX 中点击'运行→运行到小程序模拟器'→选择微信开发者工具
4. 发布上线
HBuilderX 中点击'发行→小程序 - 微信',在微信开发者工具中上传代码,提交微信公众平台审核
同小程序端部署流程,使用独立的项目目录 smart-venue-employee

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online