# WeMQ **Repository Path**: qwdingyu/WeMQ ## Basic Information - **Project Name**: WeMQ - **Description**: WeMQ是一款基于SpringBoot开发的一款物联网设备调试管理平台，其功能主要是对客户MQTT调试页面进行集中管理（连接信息、发送信息），系统管理员可在后台添加客户和调试页面，并设置调试页面的连接信息、发送消息和对应的发送按钮文字，并设置分享链接以及页面的开启状态，用户可通过分享链接打开配置好对应信息的页面，实现对自己设备的管理调试。 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: http://wemq.nicholasld.cn/ - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 130 - **Created**: 2023-07-06 - **Last Updated**: 2023-07-06 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # WeMQ - 物联网调试管理平台 [![mqttlogo.png](https://img.nicholasld.cn/i/2023/04/08/6430b2aff1b11.png)](https://img.nicholasld.cn/i/2023/04/08/6430b2aff1b11.png) >本项目于2023年6月19日直接迁移至Spring Boot，原版本代码不再保留。 ## 1. 项目介绍 ### 1.1 项目简介 **MQTT调试管理平台是一款基于SpringBoot开发的一款物联网设备调试管理平台。** 其功能主要是对客户MQTT调试页面进行集中管理（连接信息、发送信息），系统管理员可在后台添加客户和调试页面，并设置调试页面的连接信息、发送消息和对应的发送按钮文字，并设置分享链接以及页面的开启状态，用户可通过分享链接打开配置好对应信息的页面，实现对自己设备的管理调试。 ![GitHub](https://img.shields.io/github/license/NicholasLD/WeMQ) [![star](https://gitee.com/nicholasld/WeMQ/badge/star.svg?theme=dark)](https://gitee.com/nicholasld/WeMQ/stargazers) [![fork](https://gitee.com/nicholasld/WeMQ/badge/fork.svg?theme=dark)](https://gitee.com/nicholasld/WeMQ/members) #### 项目截图： 控制台 ![D7CCC3CA-0B97-4A0F-8A03-8DC8A91F58A2.png](https://img.nicholasld.cn/i/2023/05/31/647643c75a2ff.png) 用户调试界面 ![QQ20230531-024439@2x.png](https://img.nicholasld.cn/i/2023/05/31/64764423835be.png) 调试页面参数 ![QQ20230531-024618@2x.png](https://img.nicholasld.cn/i/2023/05/31/64764485019c2.png) ### 1.2 技术选型 ##### 1. 系统环境 - Java 8 - Servlet 3.0 - Apache Maven 3 ##### 2. 主框架 - Spring Boot 2.7.x - Spring Framework 5.3.x - Spring MVC 5.3.x ##### 3. 持久层 - Mybatis 3.5.x - Alibaba Druid 1.2.x - Hibernate Validation 6.0.x - Java MySQL Connector 8.0.x ##### 4. 视图层 - Thymeleaf 3.x - Bootstrap 5.x ##### 5. 工具类 - Apache Commons - Hutool 5.x ### 1.3 主要功能 - 系统管理员管理 - 客户管理 - 调试页面管理 - 对接Nmqs（NicholasLD's Message Queue Service） - 客户调试页面 - 登录日志 ### 1.4 项目结构 ``` cn.mmanager ├── mm-common // 工具类 │ └── annotation // 自定义注解 │ └── constant // 通用常量 │ └── core // 核心控制 │ └── enums // 通用枚举 │ └── exception // 通用异常 ├── mm-framework // 框架核心 │ └── aspectj // 注解实现 │ └── interceptor // 拦截器 │ └── manager // 异步处理 │ └── web // 前端控制 ├── mm-web // Web服务 ├── mm-dao // 数据访问层 ├── mm-service // 业务层 ├── mm-model // 模型 ``` ### 1.5 数据库结构 ![https://img.nicholasld.cn/i/2023/05/19/646712f025150.png](https://img.nicholasld.cn/i/2023/05/19/646712f025150.png) ## 2. 部署文档 ### 2.1 如何部署 首先导入项目根目录的 WeMQ.sql 文件到数据库，数据库名为 `WeMQ`，然后对数据库连接信息进行配置，在`mm-web`模块的`/src/main/resources/application.yml`文件中进行数据库连接信息的配置 ### 2.2 如何修改 Nmqs服务地址 本项目依赖于另一个开源项目 Nmqs 来实现对MQTT的转发和连接，如需部署Nmqs，[请访问](https://gitee.com/nicholasld/nmqs)。 在`mm-web/src/main/webapp/statics/system/common.js`中修改第一行的url变量，如果需要https，则修改第三行的http为https ### 2.3 启动项目 启动`mm-web`中的`WeMQApplication`，访问`http://<你的项目地址>:8080`即可 初始账号密码为`admin`/`admin` ## 3. 开发规划 - [x] 迁移至Spring Boot - [ ] 优化调试页面的样式 - [ ] 使Nmqs服务实现集群，实现高可用 - [ ] 实现后台用户的权限管理 ## Issues & Pull Requests 欢迎提交Issues和Pull Requests，开源大门永远向所有人敞开。 ## 联系作者 - Email: 878639947@qq.com - QQ: 878639947 - WeChat: NicholasLD505 ## License(开源许可证) Apache License Version 2.0 see http://www.apache.org/licenses/LICENSE-2.0.html ## 版权使用说明 WeMQ遵循Apache2.0开源协议，可用于个人学习、毕设、公司项目、商业产品等，但必须保留版权信息。