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、JWTORM框架MyBatis Plus 3.5.x数据库MySQL 8.0支持分库分表缓存Redis 6.x消息队列RocketMQ / RabbitMQ分布式任务XXL-JOB / Quartz连接池Druid 1.2.xAPI文档Knife4j / Swagger 3对象存储阿里云OSS / 七牛云 / MinIO支付接口微信支付、支付宝IoT通信Netty MQTT分账系统微信支付分账、自定义分账引擎二前端技术技术版本/说明前端框架Vue 3.5.x构建工具Vite 5.xUI组件库Element Plus 2.4.x状态管理Pinia路由管理Vue Router 4HTTP客户端Axios数据可视化ECharts 5管理后台store-admin基于Vue 3 Element Plus三小程序端技术版本/说明核心框架uni-appVue 3UI组件库uni-ui / uView Plus地图SDK腾讯地图 / 高德地图目标平台微信小程序四员工APP端技术版本/说明核心框架uni-app目标平台微信小程序员工码/ 安卓APK04 功能介绍一小程序端C端用户首页模块基于LBS展示附近门店、轮播图、快捷功能入口扫码开门/预约/拼团、热门场地推荐、优惠活动展示。门店详情展示门店环境图、场地列表台球桌/棋牌包间/羽毛球场地、实时空闲状态、计费规则、用户评价、门店公告。预约下单支持日历选时按小时/按场次、在线选座/选桌、支付押金、优惠券抵扣、多人拼单、一键开门。个人中心订单记录进行中/已完成/已取消、会员卡/次卡管理、优惠券包、收藏门店、邀请有礼、客服咨询。商品购买场馆内自助下单购买饮料/球杆/零食支持扫码取货、快递到家、到店自提。评价反馈离场后对场地环境、设备状况进行多维度评分支持图文评价。二员工APP端B端执行工单处理接收系统自动派发的保洁工单完成打扫后一键切换房间状态为“可售”。设备控制远程开关灯光、空调、门锁处理客户误操作或紧急情况。异常处理处理用户退款申请、远程开门请求、硬件离线告警。库存管理查看自助售货机库存接收补货提醒扫码补货。三Web管理后台总平台端SaaS运营商多租户管理租户加盟商入驻审核、套餐订购、到期提醒、资源配额管理。数据看板平台总交易额、分店营收排行、用户增长趋势、硬件在线状态大盘。分账管理平台服务费自动扣除、T1结算给商户、分账明细查询。应用市场插件管理如赛事报名、私教预约、第三方应用接入。门店端单店老板/店长数据驾驶舱实时展示门店坪效、空置率、硬件在线状态、今日营收、客流分析。订单管理订单列表、订单详情、退款审核、异常订单处理。场地管理场地编辑、计费规则配置高峰期/低谷期定价、场地维护状态设置。商品管理商品上架/下架、库存预警设置、自助售货机绑定。会员管理会员列表、会员标签、储值卡/次卡发放、流失会员唤醒。营销中心优惠券发放满减/折扣、拼团活动、积分商城、邀请有礼配置。财务管理收入明细、提现申请、押金管理、分账记录。硬件管理设备列表、设备状态监控、远程控制、故障告警。系统设置门店信息设置、营业时间、管理员权限分配。四IoT物联网中台设备管理设备注册、在线状态监控、OTA固件升级。协议适配支持Modbus、BACnet、私有TCP协议转换。规则引擎设备联动规则配置如门锁开启→自动通电→灯光亮起。告警中心设备离线告警、异常开门告警、阈值告警。05 特色功能详解多业态计费引擎核心灵魂系统设计了一套“乐高式”计费规则引擎支持任意组合按时间计费高峰期/低谷期不同定价台球、棋牌支持分钟级计费与小时级计费混合按场次计费固定时段翻台羽毛球、篮球超时自动加收费用按人次计费入场门票模式游泳、健身支持次卡、季卡、年卡核销组合计费低消按时长茶室、包间例如包厢低消200元超出部分按小时计费分段计费前1小时X元之后每30分钟Y元适合台球等非整点消费场景深度预约管理系统针对羽毛球、高尔夫等强预约属性的场景系统提供多级预约引擎资源锁定支持按场地、按教练、按设备如发球机进行预约防冲突算法采用Redis分布式锁机制确保在毫秒级并发下同一时间段同一场地不会被重复预定预约日历支持按周、按月设置场地开放规则支持设置预定保证金杜绝黄牛占位排队候补当场地已满时用户可进入候补队列有空位时自动通知硬件接入清单门禁类磁力锁、电插锁、人脸识别平板、身份证读卡器棋牌室实名控制类智能空开精准控电、智能灯控分区控制节能30%、智能球杆柜锁、空调温控器远程调温交易类自助售货机联动退押金、共享充电宝、智能零食货柜扫码开门即取特色场景高尔夫模拟器计时计费、羽毛球发球机控制、跑步机/健身器械数据同步多角色分账体系合伙人分账支持按比例如甲60%、乙40%自动分账每日/每月自动结算房东/物业分账支持按营业额抽成模式自动计算应付租金平台服务费自动扣除技术服务费T1将剩余款项结算给商户硬件供应商分账融资租赁硬件按使用次数自动分润06 开放平台与二次开发完整API生态提供RESTful API WebSocket双通道接口覆盖90%以上核心业务功能接口覆盖用户认证、订单创建、支付回调、硬件控制、会员查询、商品库存详细文档Postman集合 Swagger在线文档包含详细参数说明与错误码解析Webhook事件支持订单支付、开门请求、保洁完成等事件实时推送插件化架构系统采用钩子Hooks与过滤器Filters设计模式业务钩子在“订单创建前”、“支付成功后”、“会员注册时”预留钩子可挂载自定义逻辑前端组件化小程序端采用Uniapp开发页面模块化拆分支持替换或新增业务组件自定义字段与对象针对不同业态的特殊数据记录需求引入元数据Metadata框架自定义对象如高尔夫“球童管理”、羽毛球“教练预约”扩展字段针对标准对象添加自定义属性支持搜索、报表和条件判断硬件接入SDK开放IoT设备接入SDK支持开发者将自研硬件快速接入设备影子利用现成的设备管理、OTA升级、数据上报功能协议适配层私有协议可通过编写协议转换插件快速对接07 安装部署一环境要求组件版本要求JDK1.8 或 11Maven3.6MySQL8.0Redis6.xNode.js16开发工具HBuilderX、微信开发者工具二后端部署1. 创建数据库sqlCREATE 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、secret3. 编译运行bash# 克隆项目 git clone https://github.com/your-repo/smart-venue.git # 进入目录 cd smart-venue # 打包 mvn clean package -Dmaven.test.skiptrue # 运行 java -jar smart-venue-admin/target/smart-venue-admin.jar4. 访问接口文档texthttp://localhost:8080/doc.html三管理后台部署Vue31. 安装依赖bashcd smart-venue-ui npm install2. 修改配置编辑.env.developmenttextVITE_APP_BASE_API http://localhost:80803. 启动开发环境bashnpm run dev # 访问地址http://localhost:80 # 默认账号admin 密码admin1234. 生产构建bashnpm run build:prod四小程序端部署uni-app1. 导入项目使用 HBuilderX 打开smart-venue-uniapp目录2. 修改配置编辑manifest.json配置微信小程序appid编辑utils/config.js修改baseUrl指向后端API地址3. 运行调试HBuilderX中点击“运行→运行到小程序模拟器”→选择微信开发者工具4. 发布上线HBuilderX中点击“发行→小程序-微信”在微信开发者工具中上传代码提交微信公众平台审核五员工端小程序部署同小程序端部署流程使用独立的项目目录smart-venue-employee08 演示与获取在线演示管理后台http://demo.smart-venue.com 账号demo 密码demo123用户小程序微信搜索“智场未来体验版”员工端小程序微信搜索“智场员工端”项目获取开源版本提供基础版代码GPL协议商业版本提供完整源码 部署文档 技术支持 二次开发指导SaaS服务支持按年付费免部署快速上线如果你正在寻找一套能真正打通线下流量、降低人工成本、支持多业态扩张的自助门店系统欢迎来聊聊。我们不做简单的工具只做赋能实体数字化转型的基础设施。