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

（二）前端技术

（三）小程序端

（四）员工 APP 端

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 安装部署

（一）环境要求

（二）后端部署

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