Mqtt-lan

HortiLink adalah sistem kontrol pertanian terdistribusi berbasis site otonom dengan arsitektur local-first. Setiap site memiliki Node (ESP sensor/actuator), relay-aware intra-site network, Gateway ESP, dan Server Raspberry Pi sebagai supervisory layer lokal. Kontrol kritikal berada di Node dan tetap berjalan walaupun gateway atau server gagal. Server menyediakan MQTT broker, database, dashboard, dan OTA repository tanpa ketergantungan internet. Dokumen ini mengunci boundary sistem, hierarchy kontrol, topologi komunikasi, asumsi kapasitas (10–15 node/site), serta model degradasi sistem sebagai dasar seluruh spesifikasi teknis berikutnya.

HTL-01 mendefinisikan kontrak komunikasi formal antar Node, Gateway, dan Server dalam satu site HortiLink. Dokumen ini mengunci struktur MQTT topic, skema payload telemetry, health, command, ACK, konfigurasi, serta metadata OTA. Selain itu, ditetapkan state machine command yang idempotent, aturan TTL, retry/backoff policy, dan batasan kapasitas payload sesuai constraint ESP dan Raspberry Pi. Tujuannya adalah memastikan pengembangan paralel antar tim tanpa ambiguitas, menjaga determinisme eksekusi kontrol, serta mencegah inkonsistensi komunikasi yang dapat menyebabkan perilaku tak terprediksi pada sistem produksi.