All Posts

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.

Node HortiLink adalah control authority utama dalam arsitektur per-site. Node berbasis ESP (baseline ESP32) bertanggung jawab atas pembacaan sensor, eksekusi kontrol aktuator, enforcement interlock keselamatan, serta operasi otonom saat gateway atau server tidak tersedia. Node juga menjalankan routing relay-aware intra-site, menghasilkan telemetry dan health message sesuai HTL-01, serta mengelola buffering lokal, OTA client, dan mekanisme watchdog. Dokumen ini mengunci arsitektur firmware, model kontrol lokal, mekanisme routing, serta strategi recovery agar Node tetap deterministik, aman, dan produksi-grade dalam lingkungan pertanian dengan listrik dan jaringan yang tidak stabil.