夜雨聆风学习资料网

ARTICLE · 1370001

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

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

00 · 无人茶室卖的不是茶,是“到店这半小时不用找人”

一间无人茶室最忙的时刻不是白天,是晚上十点以后:客人从团购平台买了券,站在门口等一个扫码;包间里上一拨人刚走,桌子还没收;有人想续一个钟头,微信问店长,店长在另一个城市。

这类门店的日常,本质上是三件事同时在跑:客人自己进店、系统自己计时、老板自己看账。任何一环靠“人盯”,无人值守就不成立——不是缺人手,是缺一个把这三件事串起来的记录。

这套系统就是围绕这三个动作搭的:扫码开门、按小时或按套餐计费、团购券核销后自动落到订单上。文章里的界面截图都来自本项目的用户端,实际支持端为小程序、公众号、H5 三个入口,同一套业务逻辑。

需要先说明:本次没有拿到源码、接口文档与部署包,文中出现的代码是按业务逻辑重写的教学示例,不表示仓库里就是这几行;券核销、门禁联动、支付结算这些细节,需要在演示和验收时逐个核实。

01 · 功能总览:11 个功能,三类角色

功能按角色拆开看最清楚:客人用的用户端、店长用的商家端、平台用的管理后台。下面这张表是文章里会逐个拆的 11 个功能,每一行都对应一个真实的操作场景。

11 个功能与它解决的那件事
门店与房态
多门店、附近与常用门店、营业时间与今日房态
包间与套餐
房型、每小时单价、套餐优惠、可用设施标签
即时开台与计时
扫码即开、使用时长实时计算、续单与超时
预约与到店核销
小时预约、预约时间窗、到店确认开门
自助验券
抖音 / 美团 / 快手团购券,券码与券类型校验
订单中心
待支付、待使用、使用中、待评价、已完成
会员卡与储值
充值档位、赠送金额、余额与消费流水
商家中心
营业额、待结算、已结算、收益趋势
用户与复购
总用户、新增、复购、会员卡余额沉淀
营销推广
积分商城、分享好友、我的团队
多端与权限
小程序 / 公众号 / H5,商家端与平台后台分权

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|计时与计费

JAVA · 计时与计费
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|并发开台

JAVA · 并发开台
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|券核销幂等

JAVA · 券核销幂等
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|状态推进

JAVA · 状态推进
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|储值扣减

JAVA · 储值扣减
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|后台分页与越权

JAVA · 后台分页与越权
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 · 上线清单与六个常见问题

验收时按下面这张表逐项过,比“看着挺全”可靠。

上线验收清单
门店与房态
新增门店、改营业时间、临时闭店,房态是否即时刷新
开台与计时
开台后杀进程重进,使用时长是否仍然正确
续单与超时
超时提醒是否在扣费前到达,超时单价是否与展示一致
券核销
同一张券重复提交两次,是否只核销一次
储值
充值 100 到账 110,消费后本金与赠送的扣减顺序是否正确
结算
待结算金额与实际到账是否对得上,手续费是否可查
权限
店员账号能否看到其他门店的营业额
多端
小程序、公众号 H5、独立 H5 的登录与支付是否都能走通

Q:部署这套系统需要什么环境?

后台服务是 springboot+mybatisplus+mysql,需要一台能跑 JVM 的服务器与一个 MySQL 实例;用户端 uniapp 需要 Node 环境打包,小程序还要在对应平台注册并配置合法域名;管理后台是 vue+elementUi,打包成静态资源挂在同一个域名下即可。具体版本号以源码里的 pom 与 package.json 为准,本次没有拿到仓库,无法代填。

Q:源码包含哪些端,后台能改价格吗?

按项目方说明支持小程序、公众号、H5 三个用户端入口,另含商家端与平台管理后台。包间单价、套餐、充值档位这些都属于配置项,在管理后台维护,改完对已生成的订单不追溯。

Q:门禁和智能锁怎么对接?

这类硬件通常提供 HTTP 或 MQTT 接口,系统在开台成功后调用开门,失败时进补偿队列并提示客人联系店长。开门不是下单的强依赖:先落单、再开门,避免门锁故障导致客人付了钱进不去。具体协议要看采购的门锁型号,本项目没有附带硬件驱动。

Q:团购券核销必须对接平台开放平台吗?

要自动核销就需要,抖音、美团、快手各自有开放平台与授权流程;如果暂时不接,可以先用“人工核销 + 后台补录”,但同一张券的防重仍然要靠券码唯一索引,否则重复核销的账对不上。

Q:客人的手机号和支付信息怎么处理?

只采集履约必需的信息:下单手机号、支付流水号、开门记录。开门记录属于行踪类信息,保存期限要短于订单,到期删除;客服查询要有权限控制与操作日志;导出功能建议默认关闭,按需申请。

Q:交付物里有什么,怎么验收?

按项目方描述,交付物是各端源码与数据库脚本,具体包含哪些模块、是否含部署文档与演示数据,需要以实际交付清单为准。验收建议按上面那张清单逐项跑一遍,尤其是“重复核销”和“杀进程重进后的计时”这两项最容易出问题。

如果这套系统正好对上你在做的门店类型,可以先要一份功能清单和演示环境,用自己的手机走一遍“选包间—付款—开门—续单—评价”的完整链路,再决定要不要看源码。演示里跑不通的,源码里大概率也不会更顺。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料