All Posts

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.

DEV-HTL-04 mendefinisikan sinkronisasi non-kritikal antara Server lokal dan Cloud melalui HTTPS over TLS dengan spool queue berbasis SQLite. Cloud sync berjalan asynchronous, menggunakan batch upload, exponential backoff, serta backlog drain policy tanpa mempengaruhi MQTT internal atau kontrol lokal. Dokumen ini mengunci endpoint contract, idempotency requirement, retry strategy (5–300 detik), serta disk wear consideration (SSD recommended). WAN failure, TLS error, dan token expiration ditangani tanpa mengganggu operasi site. Cloud hanya berperan sebagai supervisory/analytics layer, bukan control authority, sesuai prinsip HTL-00. Dengan implementasi ini, setiap site tetap otonom meskipun koneksi internet gagal total.

Dokumen ini adalah entry-point resmi untuk seluruh framework engineering HortiLink (HTL-00 s/d HTL-09) beserta dokumen eksekusi DEV-HTL-01 s/d DEV-HTL-04. Ia mendefinisikan struktur dokumentasi formal, tata kelola revisi, otoritas perubahan, serta menerjemahkan arsitektur sistem menjadi panduan implementasi riil dari Node hingga Cloud. README ini memastikan setiap engineer memahami boundary sistem, kontrak lintas tim, hierarki kontrol, model degradasi, keamanan, serta bagaimana spesifikasi formal diturunkan menjadi firmware, bridge, backend, dan cloud sync yang siap produksi.

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.