Spring Boot+Vue3 多租户自助门店系统：IoT 硬件集成与无人值守方案

Spring Boot+Vue3 多租户自助门店系统：IoT 硬件集成与无人值守方案 | 极客日志

01 项目概述

智场未来·多租户自助门店系统是一套完整的线下实体空间数字化解决方案，涵盖微信小程序端（用户端）、员工 APP 端、Web 管理后台（总平台/门店端）及 IoT 物联网中台四大核心模块。

平台聚焦台球厅、棋牌室、24h 共享茶室、羽毛球馆、高尔夫练习场、健身房等自助场景，提供从场地预约、智能门禁、灯光控电、商品自助购买、会员营销到多角色分账的全流程服务。系统采用多租户架构设计，支持品牌连锁加盟模式，实现总部统管、分店自营、数据隔离，为线下实体数字化转型提供坚实的技术底座。

文章配图

02 项目优势

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

文章配图

硬件深度整合，真正实现无人值守
自研 IoT 网关中间件，支持 485/232 协议、TCP/IP 直连及蓝牙 Mesh 组网。稳定对接门禁、电控、灯光、空调、售货机等 20+ 类硬件，用户下单即通电，离店自动断电，彻底取代前台，一年节省十几万人工成本。

多业态适配，一套代码跑通'体育+'
无论是按小时计费的台球、棋牌，还是按场次收费的羽毛球、篮球，亦或是按包段计费的茶室、按人次的游泳健身，系统灵活的'乐高式'计费引擎都能完美适配，支持任意组合计费规则。

文章配图

全端覆盖，业务流程无缝协同
小程序端（用户下单）、员工 APP 端（保洁工单）、POS 端（门店管理）、总后台（数据决策）四端联动，从用户进店到离场，从保洁打扫到财务对账，全流程数字化闭环。

开放架构，支持二次开发
提供完整的 OpenAPI 接口、Webhook 事件订阅、硬件接入 SDK 及插件化架构，开发者可基于系统进行深度定制，满足各类个性化需求。

文章配图

03 技术栈

（一）后端技术

技术	版本/说明
编程语言	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	腾讯地图 / 高德地图
目标平台	微信小程序

（四）员工 APP 端

技术	版本/说明
核心框架	uni-app
目标平台	微信小程序（员工码）/ 安卓 APK

04 功能介绍

（一）小程序端（C 端用户）

首页模块：基于 LBS 展示附近门店、轮播图、快捷功能入口（扫码开门/预约/拼团）、热门场地推荐、优惠活动展示。

门店详情：展示门店环境图、场地列表（台球桌/棋牌包间/羽毛球场地）、实时空闲状态、计费规则、用户评价、门店公告。

预约下单：支持日历选时（按小时/按场次）、在线选座/选桌、支付押金、优惠券抵扣、多人拼单、一键开门。

个人中心：订单记录（进行中/已完成/已取消）、会员卡/次卡管理、优惠券包、收藏门店、邀请有礼、客服咨询。

商品购买：场馆内自助下单购买饮料/球杆/零食，支持扫码取货、快递到家、到店自提。

评价反馈：离场后对场地环境、设备状况进行多维度评分，支持图文评价。

文章配图

（二）员工 APP 端（B 端执行）

工单处理：接收系统自动派发的保洁工单，完成打扫后一键切换房间状态为'可售'。

设备控制：远程开关灯光、空调、门锁，处理客户误操作或紧急情况。

异常处理：处理用户退款申请、远程开门请求、硬件离线告警。

库存管理：查看自助售货机库存，接收补货提醒，扫码补货。

文章配图

（三）Web 管理后台

总平台端（SaaS 运营商）

多租户管理：租户（加盟商）入驻审核、套餐订购、到期提醒、资源配额管理。

数据看板：平台总交易额、分店营收排行、用户增长趋势、硬件在线状态大盘。

分账管理：平台服务费自动扣除、T+1 结算给商户、分账明细查询。

应用市场：插件管理（如赛事报名、私教预约）、第三方应用接入。

文章配图

门店端（单店老板/店长）

数据驾驶舱：实时展示门店坪效、空置率、硬件在线状态、今日营收、客流分析。

订单管理：订单列表、订单详情、退款审核、异常订单处理。

场地管理：场地编辑、计费规则配置（高峰期/低谷期定价）、场地维护状态设置。

商品管理：商品上架/下架、库存预警设置、自助售货机绑定。

会员管理：会员列表、会员标签、储值卡/次卡发放、流失会员唤醒。

营销中心：优惠券发放（满减/折扣）、拼团活动、积分商城、邀请有礼配置。

财务管理：收入明细、提现申请、押金管理、分账记录。

硬件管理：设备列表、设备状态监控、远程控制、故障告警。

系统设置：门店信息设置、营业时间、管理员权限分配。

文章配图

（四）IoT 物联网中台

设备管理：设备注册、在线状态监控、OTA 固件升级。

协议适配：支持 Modbus、BACnet、私有 TCP 协议转换。

规则引擎：设备联动规则配置（如门锁开启→自动通电→灯光亮起）。

告警中心：设备离线告警、异常开门告警、阈值告警。

文章配图

05 特色功能详解

多业态计费引擎（核心灵魂）

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

按时间计费：高峰期/低谷期不同定价（台球、棋牌），支持分钟级计费与小时级计费混合
按场次计费：固定时段翻台（羽毛球、篮球），超时自动加收费用
按人次计费：入场门票模式（游泳、健身），支持次卡、季卡、年卡核销
组合计费：低消 + 按时长（茶室、包间），例如包厢低消 200 元，超出部分按小时计费
分段计费：前 1 小时 X 元，之后每 30 分钟 Y 元（适合台球等非整点消费场景）

文章配图

深度预约管理系统

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

资源锁定：支持按场地、按教练、按设备（如发球机）进行预约
防冲突算法：采用 Redis 分布式锁机制，确保在毫秒级并发下，同一时间段同一场地不会被重复预定
预约日历：支持按周、按月设置场地开放规则，支持设置预定保证金，杜绝黄牛占位
排队候补：当场地已满时，用户可进入候补队列，有空位时自动通知

文章配图

硬件接入清单

门禁类：磁力锁、电插锁、人脸识别平板、身份证读卡器（棋牌室实名）

控制类：智能空开（精准控电）、智能灯控（分区控制，节能 30%+）、智能球杆柜锁、空调温控器（远程调温）

交易类：自助售货机（联动退押金）、共享充电宝、智能零食货柜（扫码开门即取）

特色场景：高尔夫模拟器计时计费、羽毛球发球机控制、跑步机/健身器械数据同步

多角色分账体系

合伙人分账：支持按比例（如甲 60%、乙 40%）自动分账，每日/每月自动结算

房东/物业分账：支持按营业额抽成模式，自动计算应付租金

平台服务费：自动扣除技术服务费，T+1 将剩余款项结算给商户

硬件供应商分账：融资租赁硬件按使用次数自动分润

文章配图

06 开放平台与二次开发

完整 API 生态

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

接口覆盖：用户认证、订单创建、支付回调、硬件控制、会员查询、商品库存
详细文档：Postman 集合 + Swagger 在线文档，包含详细参数说明与错误码解析
Webhook 事件：支持订单支付、开门请求、保洁完成等事件实时推送

文章配图

插件化架构

系统采用**钩子（Hooks）与过滤器（Filters）**设计模式：

业务钩子：在'订单创建前'、'支付成功后'、'会员注册时'预留钩子，可挂载自定义逻辑
前端组件化：小程序端采用 Uniapp 开发，页面模块化拆分，支持替换或新增业务组件

自定义字段与对象

针对不同业态的特殊数据记录需求，引入元数据（Metadata）框架：

自定义对象：如高尔夫'球童管理'、羽毛球'教练预约'
扩展字段：针对标准对象添加自定义属性，支持搜索、报表和条件判断

硬件接入 SDK

开放IoT 设备接入 SDK，支持开发者将自研硬件快速接入：

设备影子：利用现成的设备管理、OTA 升级、数据上报功能
协议适配层：私有协议可通过编写协议转换插件快速对接

文章配图

07 安装部署

（一）环境要求

组件	版本要求
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，配置：

MySQL 数据库连接
Redis 连接
微信支付参数（小程序 ID、商户号、APIv3 密钥）
阿里云 OSS 配置（图片/文件存储）
微信小程序配置（appid、secret）

文章配图

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

文章配图

（三）管理后台部署（Vue3）

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

（四）小程序端部署（uni-app）

1. 导入项目

使用 HBuilderX 打开 smart-venue-uniapp 目录

2. 修改配置

编辑 manifest.json，配置微信小程序 appid
编辑 utils/config.js，修改 baseUrl 指向后端 API 地址

3. 运行调试

HBuilderX 中点击'运行→运行到小程序模拟器'→选择微信开发者工具

4. 发布上线

HBuilderX 中点击'发行→小程序 - 微信'，在微信开发者工具中上传代码，提交微信公众平台审核

（五）员工端小程序部署

同小程序端部署流程，使用独立的项目目录 smart-venue-employee

Spring Boot+Vue3 多租户自助门店系统：IoT 硬件集成与无人值守方案

01 项目概述

02 项目优势

03 技术栈

（一）后端技术

（二）前端技术

（三）小程序端

（四）员工 APP 端

04 功能介绍

（一）小程序端（C 端用户）

（二）员工 APP 端（B 端执行）

（三）Web 管理后台

总平台端（SaaS 运营商）

门店端（单店老板/店长）

（四）IoT 物联网中台

05 特色功能详解

多业态计费引擎（核心灵魂）

深度预约管理系统

硬件接入清单

多角色分账体系

06 开放平台与二次开发

完整 API 生态

插件化架构

自定义字段与对象

硬件接入 SDK

07 安装部署

（一）环境要求

（二）后端部署

（三）管理后台部署（Vue3）

（四）小程序端部署（uni-app）

（五）员工端小程序部署

更多推荐文章

相关免费在线工具

Spring Boot+Vue3 多租户自助门店系统：IoT 硬件集成与无人值守方案

01 项目概述

02 项目优势

03 技术栈

（一）后端技术

（二）前端技术

（三）小程序端

（四）员工 APP 端

04 功能介绍

（一）小程序端（C 端用户）

（二）员工 APP 端（B 端执行）

（三）Web 管理后台

总平台端（SaaS 运营商）

门店端（单店老板/店长）

（四）IoT 物联网中台

05 特色功能详解

多业态计费引擎（核心灵魂）

深度预约管理系统

硬件接入清单

多角色分账体系

06 开放平台与二次开发

完整 API 生态

插件化架构

自定义字段与对象

硬件接入 SDK

07 安装部署

（一）环境要求

（二）后端部署

（三）管理后台部署（Vue3）

（四）小程序端部署（uni-app）

（五）员工端小程序部署

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具