自助系统的四层解耦架构
门店自助系统最大的长期风险不是功能不够，是被单一硬件厂商锁死。我们把「设备怎么接」和「业务怎么跑」彻底分开：换硬件只改接入层的驱动适配，业务代码一行不动。
自助球馆系统分四层，每层只干一件事
四川智如客科技有限公司把硬件与平台彻底分开：设备换品牌只改接入层的驱动适配，业务逻辑一行不动。四层的划分不是为了画图好看，是为了让每次改造只影响一层。
终端层
闸机、门禁、灯控、空调控制、摄像头、球台锁、自助终端机。按业态选型，球馆与台球厅、茶楼的设备组合完全不同。
接入层
网关协议对接、设备心跳、指令下发与状态回传。不同厂家协议不一样，差异全部在这一层消化掉。
平台层
订单引擎、计费引擎、会员体系、多租户与权限。三条业务线共用这一层，是「开新业务线不用从零写」的原因。
应用层
用户端小程序、老板端、员工端、经营看板。同一个订单在不同角色眼里看到的东西不一样，按角色分发。
为什么这样分层
换硬件不重写。门店开业三五年后，闸机老化要换、灯控要升级、摄像头要加装。如果业务代码里写死了某家厂商的协议，换设备就等于重做系统。分层之后，换硬件只影响接入层的一个驱动。
开新业态不重写。球馆、台球厅、茶楼的共同点是「按时间占用一个空间并收费」，差异只在场地形态、计费规则和硬件组合。共性的部分留在平台层，差异做成配置项，第四条业务线可以直接跑在同一个平台上。
自助球馆系统下一单，要走完八个节点
自助门店的核心不是「扫码付款」，是「付款之后系统知道该干什么」。下面是一次完整的入场到离场链路。
| # | 节点 | 系统动作 | 失败会怎样 |
|---|---|---|---|
| 1 | 扫码 | 用户扫场地码或门店码，进入小程序，识别门店与场地 | 码被贴错 / 场地被改编号 → 订单挂到错误场地 |
| 2 | 校验 | 校验时段是否可售、余额是否足够、会员权益是否覆盖 | 重复预订 / 超卖 → 到店没场地 |
| 3 | 下单 | 生成订单、锁定时段、扣减余额或发起支付 | 支付成功但订单未落库 → 用户付了钱进不去 |
| 4 | 开门 | 向闸机 / 门禁下发开门指令，写入入场时间 | 指令超时 → 门口排队，需重新下发或人工放行 |
| 5 | 通电 | 按场地编号开启对应灯光与空调，其他场地保持关闭 | 开错灯 → 客户体验差且电费上升 |
| 6 | 计时 | 按订单时段计时，临近结束前推送续时提醒 | 无提醒 → 超时占场，与下一场冲突 |
| 7 | 结算 | 结束计时，按实际使用时长与规则计价，处理退补 | 计价规则配错 → 客诉与对账不平 |
| 8 | 清场 | 断电、关门，场地回到可售状态，流水进经营看板 | 未断电 → 下一场开始前设备状态不一致 |
这八个节点里，任何一个「静默失败」都会变成客户投诉。所以每一步都要有状态回写和超时告警，而不是发完指令就当成功。
自助球馆系统扛不扛得住这三种异常
正常情况下所有系统都能跑。真正区分好坏的是这三种场景怎么处理——四川智如客科技有限公司在交付时会把这三项写成明确的处理规则，而不是等出事再商量。
门店断网了还能不能开门
门店断网、接入层与平台层之间断开时，闸机、灯光、空调都可以切到现场手动开关，由店内人员直接开合，门店照常营业。要说清楚的是：我们不做本地网关离线读数据，也没有恢复网络后自动同步记录的那套逻辑——断网期间的操作不进系统，需现场登记、事后补录。目标是「断网也能开门」，不是「断网等于没断」。
闸机换品牌要不要重做系统
不要。业务代码只调用「开某个门」这个抽象动作，具体是哪个厂家的协议由接入层驱动实现。换品牌时新增一个驱动适配，平台层与应用层不用改，历史订单与会员数据不受影响。
第二家店要不要重新配置一遍
不要。多租户结构下，新门店是一个新租户：复制业态模板、改场地数量与计费规则、绑定该店设备，即可开业。老板端在一个界面看到所有门店的经营数据，也可以按店下钻。
部署方式与硬件选型口径
部署方式与硬件口径直接决定投入。四川智如客科技有限公司按场地条件给方案，不按固定套餐套；能复用现有设备的地方会明说，不为了多卖硬件让你整套换掉。
部署方式
| 方式 | 说明 | 适用 |
|---|---|---|
| SaaS 公有云 | 系统部署在我们的服务器，门店按店开通账号，设备通过网关接入 | 单店 / 少店 |
| 独立部署 | 系统部署在客户自有服务器，数据不出客户内网 | 连锁 / 数据敏感 |
| 混合 | 业务在云上，设备网关与数据落在门店本地 | 网络不稳定门店 |
硬件选型
| 设备 | 作用 | 必需 |
|---|---|---|
| 智能闸机 / 门禁 | 凭码核验入场，记录进出时间 | 是 |
| 智能灯控 | 按场地独立开关灯，配合时段控制 | 是 |
| 空调控制模块 | 远程开关与温度设定，降低无人时段能耗 | 建议 |
| 监控摄像头 | 远程查看现场，处理纠纷与安全事件 | 建议 |
| 自助终端机 | 无手机用户现场购票与开台 | 可选 |
具体型号与报价按门店实际场地数量、门数、场地分布测算，不在此页列固定价格——同一套「8 片场地」方案，场地是否分散在不同楼层、是否需要独立配电，成本差别很大。
数据与安全
需要技术方案说明或架构评审材料？
连锁客户或需要走内部采购流程的客户，我们可以提供系统架构说明、设备清单与部署方案文档。
