Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lehuyhongnhat/iot_dashboard
IoT Dashboard is a web-based solution for real-time monitoring and remote control of IoT devices, featuring responsive data visualization, secure authentication, and data analysis tools.
https://github.com/lehuyhongnhat/iot_dashboard
esp32-arduino expressjs iot iot-device iot-platform javascript mysql nodejs reactjs socket-io
Last synced: 12 days ago
JSON representation
IoT Dashboard is a web-based solution for real-time monitoring and remote control of IoT devices, featuring responsive data visualization, secure authentication, and data analysis tools.
- Host: GitHub
- URL: https://github.com/lehuyhongnhat/iot_dashboard
- Owner: LeHuyHongNhat
- License: mit
- Created: 2024-08-26T07:21:06.000Z (5 months ago)
- Default Branch: master-pro
- Last Pushed: 2024-11-12T06:47:13.000Z (3 months ago)
- Last Synced: 2024-11-25T13:45:11.991Z (2 months ago)
- Topics: esp32-arduino, expressjs, iot, iot-device, iot-platform, javascript, mysql, nodejs, reactjs, socket-io
- Language: JavaScript
- Homepage:
- Size: 6.62 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🌐 IoT Dashboard
*A comprehensive solution for monitoring and controlling IoT devices through an intuitive web interface*
[](https://choosealicense.com/licenses/mit/)
[](https://nodejs.org/)
[](https://reactjs.org/)
[](https://expressjs.com/)
[](https://www.mysql.com/)
## 👨💻 Tác giả
**Lê Huy Hồng Nhật**
Sinh viên tại Học viện Công nghệ Bưu chính Viễn thông (PTIT)
## 📑 Mục lục
- [🌟 Tính năng](#-tính-năng)
- [🏗️ Cấu trúc dự án](#️-cấu-trúc-dự-án)
- [🛠️ Công nghệ sử dụng](#️-công-nghệ-sử-dụng)
- [⚙️ Cài đặt](#️-cài-đặt)
- [📱 Sử dụng](#-sử-dụng)
- [📚 API Documentation](#-api-documentation)
- [🤝 Đóng góp](#-đóng-góp)
- [📄 Giấy phép](#-giấy-phép)
- [📧 Liên hệ](#-liên-hệ)
## 🌟 Tính năng
| Tính năng | Mô tả |
|-----------|--------|
| 📊 **Realtime Data** | Cập nhật liên tục các chỉ số nhiệt độ, độ ẩm, ánh sáng |
| 🎮 **Remote Control** | Điều khiển thiết bị từ xa qua dashboard |
| 📱 **Responsive UI** | Giao diện tương thích mọi thiết bị |
| 🔐 **Authentication** | Hệ thống đăng nhập và phân quyền an toàn |
| 📈 **Data Analysis** | Phân tích và xem lại dữ liệu lịch sử |
| ⚡ **Alerts** | Thông báo khi chỉ số vượt ngưỡng |
## 🏗️ Cấu trúc dự án
```mermaid
graph TD
A[IoT Dashboard] --> B[Backend - BE]
A --> C[Frontend - FE]
A --> D[ESP32]
B --> E[Node.js + Express]
B --> F[Prisma ORM]
B --> G[MQTT]
C --> H[React.js]
C --> I[Chart.js]
D --> J[Arduino IDE]
D --> K[WiFi + MQTT]
```
### 🔧 Backend (BE)
- Xử lý dữ liệu và cung cấp API RESTful
- Quản lý kết nối với cơ sở dữ liệu
- Xử lý logic nghiệp vụ và xác thực
- Kết nối với thiết bị IoT thông qua MQTT
### 🎨 Frontend (FE)
- Giao diện người dùng web sử dụng React
- Hiển thị dữ liệu dưới dạng biểu đồ và bảng
- Cung cấp các điều khiển để tương tác với thiết bị IoT
### 🔌 ESP32
- Mã nguồn cho thiết bị IoT
- Đọc dữ liệu từ cảm biến và gửi lên server
- Nhận lệnh điều khiển từ server và thực thi
## 🛠️ Công nghệ sử dụng
### Backend Stack
[](https://nodejs.org/)
[](https://expressjs.com/)
[](https://www.prisma.io/)
[](https://www.mysql.com/)
[](https://socket.io/)
### Frontend Stack
[](https://reactjs.org/)
[](https://www.chartjs.org/)
[](https://getbootstrap.com/)
[](https://axios-http.com/)
### IoT Stack
[](https://www.arduino.cc/)
[](https://www.espressif.com/)
[](https://mqtt.org/)
## ⚙️ Cài đặt
### Prerequisites
```bash
Node.js (v14.0.0+)
npm (v6.0.0+)
MySQL (v8.0+)
Arduino IDE (v1.8.0+)
```
### Backend Setup
```bash
# Di chuyển vào thư mục BE
cd BE
# Cài đặt dependencies
npm install
# Tạo file .env
cp .env.example .env
# Chạy migrations
npx prisma migrate dev
# Khởi động server
npm start
```
### Frontend Setup
```bash
# Di chuyển vào thư mục FE
cd FE
# Cài đặt dependencies
npm install
# Tạo file .env.local
cp .env.example .env.local
# Khởi động ứng dụng
npm start
```
### ESP32 Setup
```cpp
// Cấu hình trong Arduino IDE
const char* ssid = "Your_WiFi_SSID";
const char* password = "Your_WiFi_Password";
const char* mqtt_server = "Your_MQTT_Broker_Address";
```
## 📱 Sử dụng
1. Truy cập dashboard: `http://localhost:3000`
2. Các tính năng chính:
- 📊 Xem biểu đồ realtime
- 🎮 Điều khiển thiết bị
- 📈 Xem lịch sử dữ liệu
- 👤 Quản lý thông tin cá nhân
## 📚 API Documentation
### Endpoints
| Endpoint | Mô tả |
|----------|--------|
| `/api/auth` | 🔐 Xác thực người dùng |
| `/api/devices` | 📱 Quản lý thiết bị |
| `/api/data` | 📊 Truy xuất dữ liệu cảm biến |
| `/api/control` | 🎮 Điều khiển thiết bị |
[Chi tiết API →](https://schema.getpostman.com/json/collection/v2.1.0/collection.json)
## 🤝 Đóng góp
1. Fork repository
2. Tạo branch mới (`git checkout -b feature/AmazingFeature`)
3. Commit thay đổi (`git commit -m 'Add some AmazingFeature'`)
4. Push lên branch (`git push origin feature/AmazingFeature`)
5. Mở Pull Request
## 📄 Giấy phép
Dự án này được phân phối dưới giấy phép [MIT](https://github.com/LeHuyHongNhat/IOT_Dashboard?tab=MIT-1-ov-file). Xem file [`LICENSE`](https://github.com/LeHuyHongNhat/IOT_Dashboard?tab=MIT-1-ov-file) để biết thêm chi tiết.
## 📧 Liên hệ
👨💻 **Lê Huy Hồng Nhật**
- GitHub: [@LeHuyHongNhat](https://github.com/LeHuyHongNhat)
- Email: [email protected]
- Project Link: [IoT Dashboard](https://github.com/LeHuyHongNhat/IoT-Dashboard)
---
### ⭐ Star us on GitHub — it helps!
Made with ❤️ by Lê Huy Hồng Nhật
© 2024 Lê Huy Hồng Nhật. All rights reserved.