Integrasi Pihak Ketiga & Otomasi Kandang - Unit Peternakan Terpadu (UNT-LAYER)

Dokumen ini memuat spesifikasi integrasi antarmuka pemrograman aplikasi (Application Programming Interface / API), protokol komunikasi sensor lingkungan IoT, timbangan panen digital tanpa kabel, serta pelaporan kesehatan hewan resmi pada Unit Peternakan BUMDes.

1. Arsitektur Konektivitas IoT & Pihak Ketiga#

+-------------------------------------------------------------------------+
| ERP BUMDes - Core Livestock Engine |
| (PostgreSQL Database, PSAK 69 Triggers, Row Level Security, Alert Bot) |
+-------------------------------------------------------------------------+
 | | |
 v (MQTT / HTTP POST) v (Bluetooth SPP/BLE) v (REST API)
+------------------+ +-------------------+ +--------------------+
| IoT Micro-Climate| | Digital Scale BLE | | iSIKHNAS Kementan |
| (ESP32 Sensor) | | (Timbangan Telur) | | (Dinas Peternakan) |
+------------------+ +-------------------+ +--------------------+
 | | |
 v v v
 Suhu, Kelembaban, Bobot Panen Telur Laporan Penyakit
 Amonia (NH3) Kandang Tervalidasi Otomatis & Vaksinasi Resmi

2. Telemetri Sensor Lingkungan Kandang (IoT MQTT Engine)#

2.1. Spesifikasi Perangkat Keras Sensor Kandang

• Mikrokontroler: NodeMCU ESP32 dengan koneksi Wi-Fi industri terhubung router kandang.
• Sensor Suhu & Kelembaban: Sensirion SHT30 presisi tinggi (akurasi suhu +/- 0,2 derajat Celsius).
• Sensor Gas Amonia: Sensor elektrokimia MQ-137 / Winsen ZE03-NH3 (rentang ukur 0 - 100 ppm).
• Interval Pengiriman Data: Setiap 60 detik mengirim payload JSON terenkripsi ke MQTT broker internal:

json
{
 "device_id": "IOT-KDG1-NODE01",
 "house_id": "BLOK-1",
 "temperature_celsius": 26.4,
 "relative_humidity_pct": 65.2,
 "ammonia_ppm": 8.5,
 "power_status": "PLN_ACTIVE",
 "fan_active_count": 4,
 "timestamp": "2026-09-14T05:30:00Z"
}

2.2. Tindakan Pemicu Ambang Batas Otomatis (Event Triggers)

• Suhu > 29,5 derajat C: Sistem secara otomatis mengaktifkan relay cooling pad evaporatif tambahan.
• Suhu > 32,0 derajat C: Memicu panggilan telepon dan pesan peringatan darurat merah WhatsApp ke Kepala Kandang dan Mandor: "PERINGATAN: Suhu Kandang Blok 1 mencapai 32.4C. Segera periksa blower!"
• Amonia > 20,0 ppm: Mengirim perintah kerja (work order) otomatis ke aplikasi ABK untuk melakukan penaburan zeolit dan penyemprotan probiotik di kolong kandang.

3. Timbangan Digital Bluetooth Panen Telur (BLE Scale Integration)#

1. Alur Kerja Tanpa Sentuh (Touchless Weighing):

• Petugas meletakkan 1 krat telur (150 butir) di atas timbangan lantai digital Bluetooth.
• Aplikasi PWA pada tablet Android petugas secara otomatis mendeteksi stabilitas angka timbangan (weight lock) melalui protokol Bluetooth Low Energy (BLE).
• Petugas hanya perlu menekan tombol konfirmasi pada layar untuk merekam berat netto telur tanpa mengetik angka manual.

2. Eliminasi Kecurangan & Kesalahan Catat:

• Menghilangkan praktik manipulasi angka timbangan (shrinkage manipulation) atau kesalahan pembacaan manual oleh pekerja gudang.

4. Integrasi Sistem Pelaporan Nasional (iSIKHNAS Kementan)#

• Peternakan BUMDes terintegrasi secara berkala dengan sistem iSIKHNAS (Sistem Informasi Kesehatan Hewan Nasional) Kementerian Pertanian melalui SMS/API Gateway resmi:
• Pelaporan rutin status populasi ayam dan program vaksinasi bulanan.
• Pelaporan darurat indikasi gejala flu burung (tanda pial biru, pembengkakan kepala) untuk penanganan cepat petugas medik veteriner dinas kabupaten.