面向仓储与车间物料管理的智能声光寻物系统，由 Web 服务端与移动 App 两端组成，通过 MQTT 物联网通信链路联动电子灯条，实现"扫码绑定—按需找件—一键亮灯—用后灭灯"的物料快速定位闭环，把"人找货"变成"灯找人"，减少翻找时间与错料风险。

项目背景

在多品种、小批量的仓储与生产现场，物料规格繁杂、库位密集，传统找料方式高度依赖人工记忆与纸质台账，常见问题包括：

• 物料编号与实物位置脱节，新员工上手慢，找一件料要翻多个货位；
• 同规格物料外观相近，靠肉眼辨别容易拿错、混料；
• 找料、盘点、退料环节缺少数字化留痕，账实一致性难保证；
• 物料与货位关系变更后，台账更新滞后，历史绑定关系无法复用。

解决方案

系统采用"App 客户端 — Web 服务端 — MQTT 中间件 — 基站 — 电子灯条"五层链路设计，Web 端负责数据解析、指令下发、业务逻辑与接口服务，App 端作为现场操作入口。

一、Web 服务端能力

1. MQTT 中间件部署与配置

支持 Mosquitto、RabbitMQ、EMQX、ActiveMQ、Kafka、HiveMQ 等主流 MQTT 中间件部署，完成端口、账号、密码配置；采用固定 IP 部署避免通信中断，并配合基站供应商完成基站侧 MQTT 服务器地址、端口与账号同步，通过连接状态确认基站正常接入。

2. 基站数据解析与存储

订阅 MQTT 消息并按基站数据格式解析上报内容，提取灯条状态、设备运行数据等关键信息，入库存储，为灯条状态查询与异常预警提供数据支撑。

3. 灯条控制指令下发

按消息定义向指定主题发布 MQTT 指令，精准关联目标灯条，实现亮灯与灭灯两种控制动作，打通"服务端—中间件—基站—灯条"的控制闭环。

4. 核心业务逻辑

• 绑定：建立灯条编码与业务编号（物料编号、物料名称等）的关联存储，为找件提供匹配依据；
• 找件：接收物料编号/名称查询请求，快速匹配目标灯条并触发亮灯指令；
• 解绑：删除灯条与业务的关联关系，用途变更时同步下发灭灯指令，确保灯条状态与业务一致。

5. HTTP 接口服务

提供标准 HTTP 接口作为 App 通信桥梁，覆盖灯条绑定、找件、解绑、亮灭灯控制等全部业务请求，保障接口稳定性与版本兼容性。

6. 基础运行保障

Web 应用服务器采用固定 IP 部署，避免 IP 变化导致 App 或中间件连接异常；适配 Linux 服务器环境，保障长期稳定运行。

二、App 客户端能力

• 灯条绑定：支持输入灯条号或扫描灯条二维码获取编码，录入物料编号/名称后一键绑定，调用服务端接口完成关联。
• 找件查询：支持按物料编号、物料名称、灯条号查询，或扫描物料条码发起请求。
• 一键亮灯/灭灯：查询到目标灯条后一键点亮定位物料，找到后可一键灭灯，避免能耗浪费与误识别。
• 一键解绑：通过输入灯条号或从已绑定列表选择目标，一键解除关联，并同步复位灯条状态。
• 信息查询：查询灯条绑定状态及对应物料信息，为绑定、找件、解绑操作提供依据。
• 基础通信：通过 HTTP / TCP-IP 协议与服务端交互，稳定传递操作请求并回显结果，形成"用户操作—App—服务端"的完整交互闭环。

技术架构

• 通信协议：MQTT（设备侧）+ HTTP（App 侧）双通道
• 消息中间件：支持 Mosquitto / RabbitMQ / EMQX / ActiveMQ / Kafka / HiveMQ 等主流选型
• 服务端：固定 IP 部署，适配 Linux 运行环境
• 终端：移动 App（Android/iOS）+ 电子灯条 + 定位基站
• 数据层：灯条编码与业务编号关联关系持久化存储，支撑快速匹配与状态查询

项目价值

• 找料效率提升：从"人找货"转为"灯找人"，按物料编号一键点亮目标货位，缩短寻找时间。
• 降低错料风险：灯条与物料唯一绑定，扫码即得对应位置，减少肉眼辨料导致的混料。
• 账实关系可维护：绑定/解绑在线完成，用途变更即时生效，历史关系清晰可查。
• 现场操作轻量化：手机扫码 + 一键亮灯，无需额外手持终端或电脑，一线人员上手快。
• 可扩展性强：MQTT 架构便于后续扩展更多基站与灯条，适配更大仓储规模。

常见问题（FAQ）

这套系统是怎么实现"找件"的？

先在 App 里把灯条编码与物料编号绑定；找件时在 App 输入或扫描物料编号，请求经 HTTP 接口送到 Web 服务端，服务端匹配到对应灯条后，通过 MQTT 向基站下发亮灯指令，目标货位的灯条发光即可快速定位，找到后一键灭灯。

支持哪些 MQTT 中间件？

支持 Mosquitto、RabbitMQ、EMQX、ActiveMQ、Kafka、HiveMQ 等主流中间件，可完成端口、账号、密码配置，并配合基站侧同步服务器地址与鉴权信息。

物料更换货位或用途变更时怎么办？

在 App 中一键解绑即可解除灯条与物料的关联，系统会同步下发灭灯指令复位灯条状态；重新绑定到新物料或新货位后即可继续使用，历史关系可查询。

App 端需要什么设备？现场人员好上手吗？

普通智能手机即可，通过 HTTP/TCP-IP 与服务端通信。核心操作只有"扫码/输入—绑定—一键亮灯/灭灯—解绑"几步，无需专业培训即可上手。

后续仓储规模扩大，系统能扩容吗？

可以。系统基于 MQTT 发布订阅架构，新增基站与灯条只需完成基站接入与灯条绑定，Web 服务端与 App 无需重构，支持规模化扩展。