IoT Concentrator Bridge

Professional MQTT-based IoT concentrator and bridge platform built around an ESP32 concentrator, an ESP8266 bridge, a FastAPI backend, and a modern React dashboard.

The project standardizes telemetry into a clean topic model, stores historical data in a database, and streams live updates to the browser through a backend websocket. The firmware is organized as PlatformIO projects with non-blocking reconnect logic, retained status messages, OTA support, and structured JSON payloads.

The production-ready code now lives at the repository root:

backend/
docs/
firmware/
frontend/
infrastructure/

1. Copy infrastructure/.env.example to infrastructure/.env and fill in your broker and database credentials.
2. Start Mosquitto, the backend, the database, and the frontend with Docker Compose from infrastructure/docker-compose.yml.
3. Copy each firmware project’s src/config/secrets.h.example to src/config/secrets.h and flash the PlatformIO projects in firmware/concentrator-esp32 and firmware/bridge-esp8266.

Architecture notes are in docs/ARCHITECTURE.md, firmware details are in docs/FIRMWARE.md, and API references are in docs/API.md.

This repository is licensed under MIT. See LICENSE.