# 智能售卖机开门柜无人售货柜

**Repository Path**: weiangogo/EmberMirage

## Basic Information

- **Project Name**: 智能售卖机开门柜无人售货柜
- **Description**: 本项目是一套商业级的**智能称重柜/重力柜无人零售解决方案**。系统采用“云端+终端”的物联网架构，集成了**Java后端、PC管理后台、Android终端App、用户端小程序、商家端小程序**等全套组件。

通过重力感应技术，实现“**扫码开门、拿取商品、关门自动结算**”的无感支付体验。
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-03
- **Last Updated**: 2025-12-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 售货柜

## README

# 🚀 智能称重柜/重力柜无人零售系统源码

## 📞 联系方式
> **获取完整源码、技术咨询或商业合作，请联系：**
>
> ### 🟢 微信号：`EmberMirage`
>
> *添加时请注明“称重柜源码”，提供技术指导与二次开发建议*

---

## 📖 项目深度解析

本项目不仅仅是一个简单的售货机系统，而是一套完整的**物联网(IoT)新零售商业解决方案**。它通过重力感应技术解决了传统售货机“只能卖标品”的痛点，完美支持**生鲜、水果、蔬菜**等非标品的按重计费，同时也支持饮料零食的按件计费。

系统经过实际商业运营验证，架构稳定，支持高并发，适合**生鲜电商、社区团购、办公室零食**等多种场景。

## 🌟 核心亮点与优势

### 1. 🍎 混合售卖模式 (独家优势)
系统底层支持多种计费方式，满足不同品类需求：
- **按重计费**：适用于水果、蔬菜、散装零食。拿多少算多少，精确到克。
- **按件计费**：适用于饮料、盒饭、面包。单件重量录入，支持设置**重量误差阈值**，防止误判。
- **混合上架**：同一个柜子可以同时售卖论斤卖的苹果和论瓶卖的可乐。

### 2. 🏢 多级代理分销体系
内置强大的组织架构管理，支持无限级代理模式：
- **总部视角**：管理所有设备、商品库、全局广告。
- **代理商/加盟商**：拥有独立的管理后台，查看自己名下的设备流水、营收报表。
- **财务分账**：支持提现申请、手续费扣除、自动化分账逻辑。

### 3. 📡 工业级物联网架构
- **高并发通信**：采用 **EMQ (MQTT)** 协议与设备进行长连接，支持万级设备同时在线。
- **消息队列削峰**：引入 **RabbitMQ** 处理开门、关门结算、补货等高频异步操作，保障系统在购物高峰期不卡顿。
- **实时监控**：心跳检测机制，设备离线自动报警。

---

## 🏗 技术架构详解

### 后端服务 (Server)
- **开发语言**: Java 8
- **框架**: Spring Boot / Mybatis-Plus / Renren-Fast
- **数据库**: MySQL 5.7 (精心设计的表结构，包含订单、设备、补货、提现等全套业务)
- **缓存**: Redis (存储用户会话、设备实时状态、购物车临时数据)
- **消息队列**: RabbitMQ (处理 `BUSINESS_OPEN_DOOR` 开门指令、上货数据同步)
- **物联网**: EMQ X (MQTT Broker)

### 前端/移动端 (Client)
- **PC管理后台**: Vue.js + Element UI (源码位于 `pc端管理界面.zip`)
- **C端用户小程序**: 微信原生小程序 (源码位于 `购物端小程序.zip`)
- **B端商家小程序**: 微信原生小程序 (源码位于 `管理端小程序.zip`)
- **柜机终端App**: Android原生开发 (源码位于 `安卓.zip`)，负责串口通信（读取重力传感器）、广告播放、门锁控制。

---

## ⚡ 功能模块清单

### 📱 C端用户功能
- **扫码开门**: 微信扫码，极速鉴权开门。
- **购物体验**: 自由拿取，关门即走，自动扣款。
- **会员系统**: 余额充值、积分记录、消费明细。
- **异常处理**: 购物异常申诉、未支付订单补缴。

### 💻 商家/运营后台功能
- **设备管理**:
  - 设备绑定/解绑 (物联网卡号 `ioc_card` 管理)
  - 远程开门 (运维救急)
  - 货道配置 (支持自定义 `x_y` 坐标，适配不同层架)
  - 屏幕配置 (横屏 16:9 / 竖屏 9:16 / 旧屏 4:3)
- **商品中心**:
  - SKU库建立 (图片、成本价、售价)
  - 销售单位设置 (斤/公斤/件)
  - 价格策略调整
- **补货管理**:
  - 补货模式切换 (记录补货前后重量差)
  - 补货记录查询
- **广告投放**:
  - 全局/特定设备广告下发
  - 图片/视频素材上传
  - 广告审核流程
- **财务中心**:
  - 营收报表 (日/月/年)
  - 代理商余额提现
  - 提现审核 (通过/拒绝/手续费)

---

## 💰 盈利模式参考
拥有这套源码，您可以：
1.  **自营生鲜柜**: 在社区、写字楼投放，赚取商品差价。
2.  **招商加盟**: 开放平台，让商家带资入驻，收取**SaaS服务费**或**流水分成**。
3.  **设备销售**: 软硬件打包出售给创业者。
4.  **广告变现**: 利用柜机大屏播放商业广告。

## 📂 源码目录索引
| 文件名 | 描述 | 重要性 |
| :--- | :--- | :--- |
| `java后台` | Spring Boot 服务端核心源码 | ⭐⭐⭐⭐⭐ |
| `pc端管理界面` | 商家/代理商管理后台前端 | ⭐⭐⭐⭐⭐ |
| `安卓` | 柜机中控屏APP源码 (核心硬件交互) | ⭐⭐⭐⭐⭐ |
| `购物端小程序` | 消费者端微信小程序 | ⭐⭐⭐⭐ |
| `管理端小程序` | 商家手机端管理工具 | ⭐⭐⭐⭐ |
| `kdzn.sql` | 完整数据库脚本 (含结构+初始数据) | ⭐⭐⭐⭐⭐ |
| `重力柜Emq对接文档.txt` | 包含 MQTT 协议对接细节 | ⭐⭐⭐ |

---

## � 快速部署指南
1.  **服务器**: 准备一台 Linux 服务器 (CentOS 7+)。
2.  **环境安装**:
    - JDK 1.8
    - MySQL 5.7 (导入 `kdzn.sql`)
    - Redis
    - RabbitMQ
    - EMQ X (MQTT Broker)
3.  **配置修改**: 解压 `java后台.zip`，修改 `application.yml` 中的数据库、Redis、MQ 连接信息。
4.  **启动服务**: 运行 Jar 包。
5.  **前端发布**: 编译 Vue 项目至 Nginx。
6.  **终端联调**: 修改安卓 App 和小程序的 API 地址指向您的服务器。

> **⚠️ 注意**: 本项目涉及硬件交互（重力传感器、电磁锁），建议在购买源码后联系我获取硬件选型建议。

---

> **专业源码，诚意分享。**
> **立即添加微信 `EmberMirage` 获取完整代码与部署支持！**