ARTICLE · 1370001
JAVA同城服务无人自助茶室棋牌室系统源码支持小程序+公众号+H5

00 · 无人茶室卖的不是茶,是“到店这半小时不用找人”
一间无人茶室最忙的时刻不是白天,是晚上十点以后:客人从团购平台买了券,站在门口等一个扫码;包间里上一拨人刚走,桌子还没收;有人想续一个钟头,微信问店长,店长在另一个城市。
这类门店的日常,本质上是三件事同时在跑:客人自己进店、系统自己计时、老板自己看账。任何一环靠“人盯”,无人值守就不成立——不是缺人手,是缺一个把这三件事串起来的记录。
这套系统就是围绕这三个动作搭的:扫码开门、按小时或按套餐计费、团购券核销后自动落到订单上。文章里的界面截图都来自本项目的用户端,实际支持端为小程序、公众号、H5 三个入口,同一套业务逻辑。
需要先说明:本次没有拿到源码、接口文档与部署包,文中出现的代码是按业务逻辑重写的教学示例,不表示仓库里就是这几行;券核销、门禁联动、支付结算这些细节,需要在演示和验收时逐个核实。
01 · 功能总览:11 个功能,三类角色
功能按角色拆开看最清楚:客人用的用户端、店长用的商家端、平台用的管理后台。下面这张表是文章里会逐个拆的 11 个功能,每一行都对应一个真实的操作场景。
02 · 门店与房态:让客人先在手机上看到“哪间空着”
门店与房态
客人打开首页,第一眼要回答的问题不是“这家店有什么”,而是“现在有没有房”。所以首页做成了门店列表:附近门店按距离排,常用门店留给熟客,卡片上直接给营业时间、每小时起价、包间数量与房态摘要,点进去才看细节。
房态不是一张静态图片,而是从订单状态推出来的:某间包间在今天 20:00–22:00 有一笔待使用订单,这一格就显示占用;订单完成或取消后,格子自动释放。门店营业时间、临时闭店、清洁占用(上一单结束后需要 15 分钟保洁)都在同一张时间轴上,避免“看起来空着、进去有人”。
包间与套餐
包间是计费的最小单位,所以每个包间要能配三类价格:按小时的基础单价、按时段的套餐价、以及“满几小时送一小时”这类规则。截图中同一间房既有每小时单价,也有一个套餐价,客人可以自己选怎么买。
配套信息也要跟着包间走:容纳人数、是否有窗、麻将机与茶台、WiFi、可否吸烟。这些标签不是为了好看,而是为了减少到店后的换房——换一次房,就要退一次款、改一次订单,无人值守最怕这种人工介入。

界面截图 1|门店列表与门店详情:附近门店、包间卡片、每小时单价与套餐价;截图数据为演示数据。
03 · 开台、预约与核销:从下单到进门的那几步
即时开台与计时续单
“即时开台”是无人场景里最常用的路径:客人到店,选包间、确认时长、付款,门锁打开,计时开始。系统在开台时写一条使用记录,记下开始时间、计费单价与套餐规则,之后每一次查询都是按这条记录算,而不是让客户端自己倒计时——手机关屏、切后台、换设备都不影响账。
续单是同一条记录的延长:用户点续单,系统按当前时段的价格追加时长,生成一条追加流水;如果已经超时,先按超时单价结算再续。超时提醒放在开台后固定时间点推送,让客人在被扣钱之前知道要扣钱——这一条比任何营销功能都更能减少投诉。
预约与到店核销
预约解决的是“我先占住 21:00 那一间”。预约单要先付定金或全款,落库时锁定时间段,同一包间同一时段不允许两条有效预约;到店后扫码或输入手机号后四位核销,预约单转成使用中。
核销这一下必须可追溯:谁核销的、什么时间、用的哪张券、对应哪笔订单。无人门店里没人签字,这条记录就是唯一的凭据,后面出现“我明明来了”的争议时,只能靠它。
04 · 团购券:抖音、美团、快手的券怎么落到同一张单上
自助验券
团购是这类门店的主要客流来源,也是最容易出错的地方:一张券在不同平台的编码规则不同,同一张券可能被重复提交,退款还可能发生在核销之后。系统把券抽象成“渠道 + 券码 + 状态”三件事:渠道决定去哪校验,券码是唯一键,状态决定能不能核销。
界面上做成两步:先选渠道,再扫码或手输券码。校验通过后立刻占位,避免同一张券在两台设备上同时核销;核销成功后按券面金额生成订单,差额部分再走会员卡或在线支付。兑换规则一栏必须让客人看清:有效期、可用时段、是否限包间类型、退款怎么算。

界面截图 2|会员卡充值、商家看板与自助验券:券类型、券码与兑换规则;截图数据为演示数据。
05 · 订单中心:一笔订单从下单到评价要走完的状态
订单中心
订单状态只有五个:待支付、待使用、使用中、待评价、已完成。状态少了会丢信息,状态多了店里的人记不住。每一步迁移都要有触发条件与操作人,取消与退款单独留痕,不覆盖原状态。
列表页按状态分栏,卡片上给三样东西:店铺与包间、预约或使用时间、实付金额。客人最常点的两个动作是“去评价”和“再看一眼订单”,所以这两个入口放在拇指能够到的位置。

界面截图 3|我的、我的订单与订单详情:状态分栏、实付金额与订单编号;截图数据为演示数据。
06 · 会员与储值:把一次性客人变成会再来的人
会员卡与储值
储值的核心不是充值按钮,是账。充 100 到账 110,这 10 元是赠送额度,不能提现、不能和本金混在一起算退款;每一次消费要能拆出“扣了多少本金、扣了多少赠送”,否则退款时永远算不清。
第一个客人往往是被低价券带来的,第二次来才可能办卡。所以会员入口放在首页与“我的”两处,充值档位用“到账金额”表达而不是折扣率——客人对“到账110”的理解成本,远低于“9.1折”。充值前必须勾选协议,协议里写清有效期、退款规则与赠送额度的处理方式。
07 · 商家中心:老板真正每天要看的那几行数字
商家中心与结算
店长打开商家端,只关心三件事:今天收了多少钱、有多少钱还没结算、这个月趋势是涨还是跌。所以首页直接给累计营业额、待结算、已结算三个数字,下面才是明细。结算周期与手续费规则要写在明面上,避免“钱到账了但不知道扣了什么”。
用户与复购数据
用户数据这块容易做成虚荣指标,实际有用的是四个:总用户、新增、复购人数、会员卡余额。复购人数决定这家店能不能靠老客撑起工作日的白天时段,会员卡余额则是提前收到的现金,也是退款压力。把这两个数放在一起看,比看总营业额更能判断经营状况。
08 · 增长与多端:分享、积分与三个入口
营销推广
无人门店没有店员推销,增长只能靠客人自己带人。做法是把“分享好友”“我的团队”“积分商城”放进“我的”页的推荐工具里:分享带参数,好友下单后双方得积分,积分能抵时长或换券。奖励规则要写清上限与有效期,避免变成刷单套利的口子。
多端与权限
用户端一套逻辑跑三端:小程序、公众号 H5、独立 H5。差别主要在登录与支付通道,业务接口应当是同一套;商家端只给店长与店员,能看本店数据、能开台与核销;平台后台管门店入驻、价格模板与结算。三者权限必须分开,店员能看到全平台营业额是最常见的越权。
09 · 技术架构:后台服务、用户端与管理后台怎么分工
按项目方提供的原文列出技术栈,顺序不改:用户端 uniapp(vue语法),管理后台 vue+elementUi,后台服务 springboot+mybatisplus+mysql。具体版本与依赖清单以源码为准,本文不代填。
技术栈
用户端 uniapp(vue语法)
管理后台 vue+elementUi
后台服务 springboot+mybatisplus+mysql
分工上,后台服务负责所有“会算错钱”的逻辑:计时、计费、券核销、储值扣减、结算;用户端只做展示与提交,不信任客户端时间;管理后台负责配置与对账,所有写操作都要留操作日志。门禁这类硬件走独立的设备服务,开门失败不能阻塞下单,但要进补偿队列。
10 · 核心代码:六段可以直接改的实现
下面六段是 JAVA 教学示例,刻意保持框架无关:不写 Spring 注解、不写 Mapper,只表达业务规则。真正接到 springboot+mybatisplus 时,把这些方法放进 Service 即可。
代码 1|计时与计费
public class Billing { // 起步按小时,超出按分钟进位 public BigDecimal cost(Order o, BigDecimal hourPrice) { long sec = Duration.between( o.getStart(), o.getEnd()) .getSeconds(); if (sec < 0) { throw new IllegalStateException( "end before start"); } long min = (sec + 59) / 60; long hours = (min + 59) / 60; return hourPrice.multiply( BigDecimal.valueOf(hours)); }} |
按“实际使用秒数”算钱,向上取整到分钟,避免 59 秒被算成一小时。
代码 2|并发开台
public class OpenRoomService { private final RoomOrderMapper mapper; public Long open(Long roomId, LocalDateTime start, LocalDateTime end) { // 唯一索引兜底并发 if (mapper.countCovering(roomId, start, end) > 0) { throw new IllegalStateException( "该时段已被占用"); } RoomOrder o = new RoomOrder(); o.setRoomId(roomId); o.setStartTime(start); o.setEndTime(end); o.setStatus(OrderStatus.IN_USE); mapper.insert(o); return o.getId(); }} |
同一包间同一时段只允许一笔有效单:先查占用,再用唯一约束兜底。
代码 3|券核销幂等
public class CouponService { // channel: DOUYIN / MEITUAN / KUAISHOU public VerifyResult verify(String channel, String code, Long orderId) { CouponRecord old = mapper .findByCode(channel, code); if (old != null) { // 幂等:原样返回,不重复扣 return VerifyResult.of(old); } CouponRecord rec = remoteVerify(channel, code); if (!rec.isValid()) { return VerifyResult.fail(); } rec.setOrderId(orderId); // (channel, code) 唯一索引 mapper.insert(rec); return VerifyResult.ok(rec); }} |
券码做唯一键,重复提交只返回第一次的结果,不重复扣减。
代码 4|状态推进
public class OrderStateMachine { // 状态常量已静态导入 private static final Set<OrderStatus> PAY = Set.of(PAID, CANCELLED); private static final Set<OrderStatus> USE = Set.of(IN_USE, CANCELLED); private static final Set<OrderStatus> CMT = Set.of(PENDING_COMMENT); private Set<OrderStatus> next( OrderStatus s) { switch (s) { case PENDING_PAY: return PAY; case PAID: return USE; case IN_USE: return CMT; case PENDING_COMMENT: return Set.of(DONE); default: return Set.of(); } } public void move(Order o, OrderStatus to) { Set<OrderStatus> nx = next(o.getStatus()); if (!nx.contains(to)) { throw new IllegalStateException( "越级改状态"); } o.setStatus(to); log.info("order {} -> {}", o.getId(), to); }} |
只允许相邻状态迁移,越级改状态直接拒绝并留日志。
代码 5|储值扣减
public class WalletService { // 先扣赠送,再扣本金 public void pay(Wallet w, BigDecimal amt) { BigDecimal gift = w.getGiftBalance().min(amt); BigDecimal cash = amt.subtract(gift); if (cash.compareTo( w.getCashBalance()) > 0) { throw new IllegalStateException( "余额不足"); } w.setGiftBalance(w.getGiftBalance() .subtract(gift)); w.setCashBalance(w.getCashBalance() .subtract(cash)); flowMapper.insert( Flow.of(w.getId(), gift, cash)); }} |
本金与赠送分开扣,退款只退本金,赠送额度先扣。
代码 6|后台分页与越权
public class OrderQueryService { public Page<OrderVO> page(LoginUser u, OrderQuery q) { // 店铺 ID 取自会话,不信前端 if (u.isMerchant()) { q.setShopId(u.getShopId()); } else if (!u.isPlatformAdmin()) { throw new IllegalStateException( "无权限"); } Page<Order> p = new Page<>( q.getPageNo(), q.getPageSize()); return mapper .selectPage(p, q.toWrapper()) .convert(OrderVO::of); }} |
商家端只能查本店数据:把店铺 ID 从会话里取,不从请求参数里取。
11 · 合规与上线:无人值守最容易踩的四个坑
第一个坑是“棋牌”两个字。棋牌室在国内属于需要备案的经营场所,系统本身不能提供任何赌博功能:不做筹码兑换、不做输赢结算、不做抽水。文章与销售话术里也要把这一点说清楚,否则容易被当成涉赌工具。
第二个坑是计时与价格不透明。不足半小时怎么算、超时按什么价、套餐是否含服务费,必须在下单前展示,并在订单详情里可回看。无人门店没有店员解释,规则就是唯一的客服。
第三个坑是个人信息。手机号、支付信息、开门记录都属于个人信息,开门记录还涉及行踪,保存期限要写清楚、到期要能删。监控如果拍摄到公共区域,要有显著告知,不能只贴一张小纸条。
第四个坑是团购券的退款。券在平台侧退款、在系统侧已核销,这类不一致必须有对账任务每天跑,发现差异人工处理,而不是等客人投诉才发现。
12 · 上线清单与六个常见问题
验收时按下面这张表逐项过,比“看着挺全”可靠。
Q:部署这套系统需要什么环境?
后台服务是 springboot+mybatisplus+mysql,需要一台能跑 JVM 的服务器与一个 MySQL 实例;用户端 uniapp 需要 Node 环境打包,小程序还要在对应平台注册并配置合法域名;管理后台是 vue+elementUi,打包成静态资源挂在同一个域名下即可。具体版本号以源码里的 pom 与 package.json 为准,本次没有拿到仓库,无法代填。
Q:源码包含哪些端,后台能改价格吗?
按项目方说明支持小程序、公众号、H5 三个用户端入口,另含商家端与平台管理后台。包间单价、套餐、充值档位这些都属于配置项,在管理后台维护,改完对已生成的订单不追溯。
Q:门禁和智能锁怎么对接?
这类硬件通常提供 HTTP 或 MQTT 接口,系统在开台成功后调用开门,失败时进补偿队列并提示客人联系店长。开门不是下单的强依赖:先落单、再开门,避免门锁故障导致客人付了钱进不去。具体协议要看采购的门锁型号,本项目没有附带硬件驱动。
Q:团购券核销必须对接平台开放平台吗?
要自动核销就需要,抖音、美团、快手各自有开放平台与授权流程;如果暂时不接,可以先用“人工核销 + 后台补录”,但同一张券的防重仍然要靠券码唯一索引,否则重复核销的账对不上。
Q:客人的手机号和支付信息怎么处理?
只采集履约必需的信息:下单手机号、支付流水号、开门记录。开门记录属于行踪类信息,保存期限要短于订单,到期删除;客服查询要有权限控制与操作日志;导出功能建议默认关闭,按需申请。
Q:交付物里有什么,怎么验收?
按项目方描述,交付物是各端源码与数据库脚本,具体包含哪些模块、是否含部署文档与演示数据,需要以实际交付清单为准。验收建议按上面那张清单逐项跑一遍,尤其是“重复核销”和“杀进程重进后的计时”这两项最容易出问题。
如果这套系统正好对上你在做的门店类型,可以先要一份功能清单和演示环境,用自己的手机走一遍“选包间—付款—开门—续单—评价”的完整链路,再决定要不要看源码。演示里跑不通的,源码里大概率也不会更顺。















































































