Mqtt-bridge

DEV-HTL-03 mendefinisikan implementasi bridge antara Gateway (ESP32) dan Server (Raspberry Pi) menggunakan MQTT dengan kontrak topic, QoS, retain policy, ACL, serta store-and-forward buffering. Gateway menerjemahkan frame radio menjadi payload MQTT, mengelola buffer bounded RAM, serta mempublikasikan health telemetry. Server menjalankan Mosquitto broker dan ingestion service berbasis SQLite dengan WAL mode untuk integritas data. Dokumen ini mengunci lifecycle reconnect, backoff, dan degradasi saat broker atau LAN gagal, tanpa mengganggu kontrol lokal. Selain itu, disediakan konfigurasi ACL Mosquitto, schema SQLite, serta pengujian integrasi sesuai HTL-09. DEV-HTL-03 memastikan observability dan orchestration lokal berjalan stabil sebelum ekspor data ke cloud.

Gateway HortiLink adalah bridge intra-site antara domain Node (ESP-NOW relay-aware) dan Server Raspberry Pi (MQTT). Gateway bertindak sebagai ESP-NOW coordinator, validator routing, deduplication engine, store-and-forward buffer, serta distributor time authority. Gateway tidak memiliki otoritas kontrol aktuator dan tidak boleh menggantikan local control engine pada Node. Dokumen ini mengunci arsitektur firmware Gateway, mekanisme validasi pesan, buffering, rate limiting, reconnect strategy, serta health monitoring agar sistem tetap deterministik, terisolasi per-site, dan tahan terhadap kegagalan jaringan atau broker tanpa mengganggu kontrol lokal pada Node.