1. Project Overview

WeMQ - IoT Debugging Management Platform

MQTT Debugging Management Platform is a lightweight IoT device debugging management platform developed based on SpringBoot

Its main functions are to centrally manage customers' MQTT debugging pages (connection information, sent information), system administrators can add customers and debugging pages in the background, set debugging page connection information, sent messages, and corresponding sent button text, and set sharing links and page opening status, users can open the configuration page through sharing links, and implement self-device management and debugging

2. Open Source License

Licensed under Apache-2.0

3. Screenshots

Project Screenshots:

Console

User Debugging Interface

Debugging Page Parameters

4. Feature Overview

WeMQ Features

Suitable for IoT service providers to debug and manage solutions.

Simple Interface

The debugging interface is adapted to multiple terminals and supports PC, mobile phone, tablet, and other multiple devices.

Secure Communication

Using self-developed message middleware for communication, avoiding frontend leakage of MQTT sensitive information.

High Performance

Multi-threaded Message Middleware, supporting high concurrency and high throughput message communication.

Multiple Protocols

Supporting MQTT, WebSocket, and other multiple protocols, meeting the needs of different scenarios.

Multiple Functions

Supporting debugging page management, MQTT server management, operator management, and other multiple functions.

Independent Debugging Page

Generating an independent debugging link for each debugging page, making it convenient for debugging personnel to debug.

Predefined Debugging Instructions

Defining predefined debugging instructions for each debugging page, making it convenient for debugging personnel to debug.

Easy Deployment

One-click deployment, supporting Docker, Jar, and other multiple deployment methods.

Source: WeMQ Official Website Documentation

5. Tech Stack

1.2 Technical Selection

1. System Environment

• Java 8

• Servlet 3.0

• Apache Maven 3

2. Main Framework

• Spring Boot 2.7.x

• Spring Framework 5.3.x

• Spring MVC 5.3.x

3. Persistent Layer

• Mybatis 3.5.x

• Alibaba Druid 1.2.x

• Hibernate Validation 6.0.x

• Java MySQL Connector 8.0.x

4. View Layer

• Thymeleaf 3.x

• Bootstrap 5.x

• Layui 2.x

5. Tool Class

• Apache Commons

• Hutool 5.x

1.3 Main Functions

• System Administrator Management

• Customer Management

• Debugging Page Management

• Interface with Nmqs (NicholasLD's Message Queue Service)

• Customer Debugging Page

• Login Log

1.4 Project Structure

cn.mmanager
├── mm-common            // Utility Class
│       └── annotation                    // Custom Annotation
│       └── constant                      // Common Constant
│       └── core                          // Core Control
│       └── enums                         // Common Enum
│       └── exception                     // Common Exception
├── mm-framework         // Framework Core
│       └── aspectj                       // Annotation Implementation
│       └── interceptor                   // Interceptor
│       └── manager                       // Asynchronous Processing
│       └── web                           // Front-end Control
├── mm-web          // Web Service
├── mm-dao         // Data Access Layer
├── mm-service     // Business Layer
├── mm-model       // Model

2. Deployment Documents

2.1 How to Deploy

Firstly, import the WeMQ.sql file in the project root directory into the database, with the database name as WeMQ, and then configure the database connection information. The database connection information configuration is in the application.yml file in the mm-web module's /src/main/resources directory.

2.2 How to modify the Nmqs service address

This project relies on another open-source project Nmqs to implement MQTT forwarding and connection, and if you need to deploy Nmqs, please visit.

In application.yml, modify the properties under wemq to adapt automatically to http or https, ws or wss according to the WeMQ project address.

wemq:
  nmqs:
    host: localhost # The address must be accessible from the outside, and cannot be used in production environments such as 127.0.0.1/localhost
    port: 8081

2.3 Start the project

Start WeMQApplication in mm-web, and access http://<your project address>:8080 to start the project.

The initial account password is admin/admin