企业官网建设流程全解析

随着线下自助消费场景的持续渗透，面向手工娱乐业态的无人自助拼豆系统逐渐成为门店数字化升级的主流方案。该系统结合物联网技术实现软硬件一体化管理，用户无需店员介入即可完成到店、选材、创作、结算全流程，同时支持运营方远程管理门店库存、设备状态与订单数据。本文将从架构设计、后端核心实现、前端适配、部署运维四个维度，完整拆解无人自助拼豆系统的开发与落地全流程。

一、系统核心业务逻辑与架构设计

核心业务流程

用户侧的完整操作链路为：1. 打开小程序/H5，基于LBS查看附近门店，支持一键导航到店；2. 扫码绑定门店设备，选择拼豆套装规格生成租借订单；
3. 权限验证通过后柜门自动弹开，用户取出拼豆材料包进行创作；4. 创作完成后将剩余材料放回原格，关闭柜门后系统自动称重核算剩余量，完成费用结算；5. 用户可在订单中心查看历史租借记录与凭证。
运营侧的核心逻辑包括设备状态实时监控、库存余量预警、订单数据统计、用户权益管理、门店配置维护等，全程无需线下人员驻店，即可实现多门店统一管理。

整体架构分层

系统采用前后端分离+物联网分层架构，从上到下分为四层：

1. 终端层：包含C端用户入口（小程序、H5、APP，基于Uniapp多端适配）、运营管理后台（基于Vue+Element UI构建）
   、线下智能柜终端（集成锁控、称重、4G联网模块）；
2. 网关层：包含HTTP网关处理业务接口请求，MQTT网关处理物联网设备的长连接消息，支持百万级设备并发接入；
3. 服务层：基于Spring Boot + MyBatis Plus构建后端服务，拆分出用户服务、订单服务、设备服务、库存服务、统计服务等独立模块，模块间通过RESTful接口通信，支持横向扩展；
4. 存储层：MySQL存储业务核心数据（用户、订单、设备、库存等结构化数据），Redis存储会话信息、设备临时状态、热点数据缓存，MongoDB存储操作日志与设备上报的
   非结构化数据。

二、核心功能模块的后端实现

设备联动模块

设备联动是无人系统的核心能力，负责处理智能柜的开门、称重数据上报、状态同步等逻辑，核心接口实现示例如下：

@RestController@RequestMapping("/api/device")publicclassDeviceController{@AutowiredprivateDeviceServicedeviceService;@AutowiredprivateOrderServiceorderSe rvice;@PostMapping("/open")publicRopenCabinet(@RequestBodyOpenCabinetDTOdto){// 校验设备合法性与在线状态Devicedevice=deviceService.getBySn(dto.getDeviceSn());if(device==null||device.getStatus()!=1){returnR.fail("设备当前不可用，请尝试其 他门店");}// 校验用户是否存在有效未完成订单Orderorder=orderService.getValidOrderByUserId(dto.getUserId());if(order==null){returnR.fail("无有效租借订单，请先选择拼豆套装下单");}// 通过MQTT网关向设备发送开门指令，等待设备ACK确认Booleanresult=deviceSer vice.sendOpenCommand(dto.getDeviceSn(),dto.getCabinetId());returnresult?R.success("开门成功，请取走对应材料包"):R.fail("开门失败，请稍后重试");}}

接口设计中加入了双重校验逻辑，避免恶意开门请求，同时所有设备指令都采用消息ID做幂等校验，防止重复执行。

订单结算模块

结算逻辑核心是根据拼豆套装的初始重量、归还时的称重差值计算实际消耗量，再匹配对应计费规则生成结算单。针对线下网络不稳定的场景，称重数据
会自动重试上报，后端通过「订单ID+上报时间戳」做幂等校验，避免重复结算。结算完成后自动触发库存更新，同步扣减对应柜格的可用库存。

库存预警模块

系统每15分钟扫描所有柜格的库存余量，当某类拼豆套装的剩余存量低于预设阈值时，自动向运营后台推送预警通知，提醒运营人员补货，同时前端用户端会自动隐藏该规格的下单入口，避免用户下单后无货。开发过程中可通过MyBatis Plus的代码生成器快速生成库存、订单等模块的CRUD接口，大幅提升开发效率，同时支持多数据源配置，满足不同门店数据隔离的需求。

三、前端多端适配与交互优化

C端用户端实

现
用户端基于Uniapp框架开发，采用Vue语法，一次开发可同时适配小程序、H5、APP等多平台，降低多端开发的同步成本。核心交互优化点包括：

1. LBS定位与导航：集成主流地图SDK，用户进入首页后自动获取当前位置，展示半径3公里内的所有门店，点击门店卡片即可调用系统地图实现一键导航；
2. 弱网适配：针对线下弱网场景，扫码失败时自动重试3次，同时支持手动输入设备SN码绑定设备，避免用户因网络问题无法操作；
3. 状态实时同步：通过WebSocket与后端建立长连接，开门结果、结算完成等状态实时推送到前端，无需用户手动刷新页
   面；
4. 分包加载：针对小程序包体积限制，将非核心页面（历史订单、个人中心、权益说明等）放到分包中，首屏加载速度可提升40%以上。

运营管理后台实现

管理后台基于Vue 3 + Element Plus构建，核心功能包括设备监控看板、订单管理、库存管理、门店管理、数据统计五大模块。其中设备监控看板支持实时查看所有在线设备的状态、当前柜格占用情况，异常设备标红展示，方便运营人员快速定位问题。

四、部署落地与运维注意事项

标准化部署流程

1. 后端服务部署：采用Docker容器化部署，将Spring Boot应用打
   包成镜像，配合Docker Compose编排MySQL、Redis、MQTT Broker、Nginx等依赖服务，部署脚本可复用性强，10分钟即可完成一套环境的搭建。Nginx配置反向代理与SSL证书，保障接口请求的安全性；
2. 前端部署：Uniapp打包后的小程序代码直接上传到对应平台审核，H5代码打包后上传到OSS或者服务器目录，通过Nginx配置静态资源访问；管理后台打包后同样采用Nginx托管，配置路由重写适配History模式；
3. 设备对接：线下智能柜终端通过MQTT协议接入后端服务，每个设备绑定SN码，设备上线时自动向
   服务端注册，心跳间隔设置为30秒，超过3次心跳未上报则标记为离线。

核心运维规范

1. 数据备份：MySQL配置每天凌晨2点全量备份，开启binlog增量备份，备份文件同步到对象存储，避免数据丢失；
2. 异常告警：配置监控告警规则，当设备离线率超过10%、接口成功率低于99%、库存预警数量超过20条时，自动推送告警通知到运营渠道；
3. 灰度发布：新功能上线时，先选择1-2家试点门店的设备升级固件，服务端配置灰度路由，仅试点门店的请求打到新版本服务，验证72小时无问题后再全量发布。

常见问题排查思路：用户扫码无法开门
时，首先检查设备是否在线，再检查用户订单状态是否正常，后查看MQTT消息的发送与ACK记录，即可快速定位是设备问题、网络问题还是业务逻辑问题。

整体来看，无人自助拼豆系统的技术栈具备较强的通用性，核心的物联网设备对接、订单管理、多端适配逻辑可快速复用到其他无人共享场景，比如共享文具柜、共享玩具柜、共享手工材料柜等。开发过程中重点要保障设备通信的稳定性与结算逻辑的准确性，上线前需要做多场景的压力测试与异常Case验证，确保线下场景的高可用性。

![配图](https://myshop.xianmxkj.com/file/uploadPath/2026/
06/11/bab143fa8dcfdba299603a24f9c2a11e.png)