Farmify — Smart Farming System

Sistem monitoring dan kontrol irigasi terdistribusi berbasis REST API. Memantau kelembapan tanah secara real-time dan mengontrol pompa air secara manual maupun otomatis.

---

Arsitektur Sistem

[Python Device Simulator] ──POST /api/ingest──▶ [Laravel REST API]
                                                        │
                                                   [MySQL DB]
                                                        │
[Python Worker] ◀──GET /api/command/pending────────────┘
      │
      └──POST /api/status/update──▶ [Laravel REST API]
                                          │
                                    [Web Dashboard]

---

Struktur Folder

farmify/
├── app/                        # Laravel application
│   └── Http/
│       ├── Controllers/
│       │   ├── Api/            # API controllers (device, command, status, dashboard)
│       │   └── Web/            # Web dashboard controllers
│       └── Middleware/
│           └── ApiKeyMiddleware.php
├── database/migrations/        # Database migrations
├── resources/views/dashboard/  # Blade views
├── routes/
│   ├── api.php                 # API routes
│   └── web.php                 # Web routes
├── public/
│   ├── css/dashboard.css
│   └── js/dashboard.js
├── python/
│   ├── device_simulator.py     # Simulator 3 device sensor
│   ├── worker.py               # Worker polling command
│   └── requirements.txt
├── Dockerfile
└── docker-compose.yml

---

Prasyarat

• Docker & Docker Desktop
• Python 3.8+
• pip

---

Instalasi & Menjalankan

1. Clone repository

git clone https://github.com/username/farmify.git
cd farmify

2. Jalankan Docker

docker compose up -d --build

Tunggu hingga semua container running:

docker compose ps

Container	Port
farmify_app	http://localhost:8000
farmify_db	localhost:3307
farmify_pma	http://localhost:8080

3. Migrasi database

docker exec -it farmify_app php artisan migrate

4. Buat API key

docker exec -it farmify_app php artisan tinker

\App\Models\ApiClient::create([
    'name'      => 'Python Device Client',
    'api_key'   => 'smartfarm-secret-key-2024',
    'is_active' => 1,
]);
exit

5. Install dependensi Python

cd python
pip install -r requirements.txt

6. Konfigurasi Python

Edit device_simulator.py dan worker.py, sesuaikan:

API_BASE_URL = "http://localhost:8000/api"
API_KEY      = "smartfarm-secret-key-2024"

7. Jalankan Device Simulator

Buka terminal baru:

cd python
python device_simulator.py

Output normal:

13:25:49 [ZONE-A] ✓ Sent | moisture=55.28% temp=26.57°C hum=78.12%
13:25:49 [ZONE-B] ✓ Sent | moisture=70.68% temp=29.84°C hum=55.5%
13:25:49 [ZONE-C] ✓ Sent | moisture=52.5% temp=33.34°C hum=56.18%

8. Jalankan Worker

Buka terminal baru:

cd python
python worker.py

Output normal:

13:29:52 [WORKER] Found 2 pending command(s).
13:29:52 [WORKER] Executing [start_pump] for device_id=1 (cmd_id=1)
13:29:57 [WORKER] ✓ Done: device_id=1 pump=running

9. Akses Dashboard

Buka browser: http://localhost:8000/dashboard

---

API Endpoints

Semua endpoint memerlukan header:

X-API-Key: <api_key>
Content-Type: application/json

Method	Endpoint	Deskripsi
POST	/api/ingest	Device kirim data sensor
GET	/api/devices	List semua device
POST	/api/command/send	Kirim perintah pompa
GET	/api/command/pending	Worker ambil command pending
PATCH	/api/command/{id}/done	Worker update status command
POST	/api/status/update	Worker update status pompa
GET	/api/dashboard/data	Data sensor untuk dashboard
GET	/api/dashboard/log	Log aktivitas

Contoh request — kirim data sensor

curl -X POST http://localhost:8000/api/ingest \
  -H "X-API-Key: smartfarm-secret-key-2024" \
  -H "Content-Type: application/json" \
  -d '{"device_code":"ZONE-A","soil_moisture":45.2,"temperature":28.5,"humidity":72.0}'

---

Device Simulator

Tiga device zona lahan berjalan paralel via threading:

Device	Zona	Rentang Moisture
ZONE-A	Lahan Padi	20–85%
ZONE-B	Lahan Sayur	15–75%
ZONE-C	Lahan Buah	25–90%

Moisture turun secara bertahap saat pompa mati, naik saat pompa nyala.

---

Auto Irrigation

Sistem otomatis membuat command start_pump ketika soil_moisture < 30%. Threshold dapat diubah di Dashboard → Settings → Irrigation Threshold.

---

Environment Variables

Variable	Default	Deskripsi
THRESHOLD_MOISTURE	30	Trigger auto-irrigation (%)
THRESHOLD_STOP	70	Stop irrigation (%)
POLL_INTERVAL	5	Interval worker polling (detik)
DEVICE_TIMEOUT	60	Timeout device offline (detik)
INGEST_INTERVAL	10	Interval kirim data sensor (detik)

---

Database

Tabel	Isi
api_clients	API key management
devices	Daftar device/zona
sensor_data	Rekaman data sensor
commands	Antrian dan histori command
pump_status	Status pompa real-time
activity_log	Log seluruh aktivitas

---

Troubleshooting

API 404 — Pastikan routes/api.php terdaftar di bootstrap/app.php.

Middleware error — Pastikan ApiKeyMiddleware terdaftar di bootstrap/app.php:

$middleware->alias(['auth.apikey' => \App\Http\Middleware\ApiKeyMiddleware::class]);

Worker timeout — Pastikan container running (docker compose ps) dan API key benar.

migrate:fresh error — Cek duplikasi migration file yang membuat tabel sama.

---

Tech Stack

Layer	Teknologi
Backend API	Laravel 13, PHP 8.4
Database	MySQL 8.0
Frontend	Blade, Chart.js, Remixicon
Device Simulator	Python 3, requests, threading
Worker	Python 3, requests
Infrastructure	Docker, Apache