🚀 Google Oyun ve Uygulama Akademisi Flutter Grup 79 tarafından geliştirilen
"Bilginin Gücü" temalı yapay zeka destekli quiz uygulaması
🤩 Merhabalar herkese!
- 🎯 Proje Amacı
- ✨ Proje Özellikleri
- 📱 Ekran Görüntüleri
- 🛠️ Teknolojiler
- 🏗️ Proje Yapısı
- 🚀 Kurulum
- 📖 Kullanım
- 🎮 Özellikler
- 🧪 Test
- 🤝 Katkıda Bulunma
- 🚩 Takım Üyeleri
- 📄 Lisans
- ⭐ Destek
💯 Google Oyun ve Uygulama Akademisi Flutter Grup 79 olarak, takım arkadaşlarımızla birlikte yapay zeka destekli bir quiz uygulaması geliştirmeye karar verdik. "Bilginin Gücü" temalı bu projede, bilgimizi en iyi şekilde yansıtabilmek için quiz formatını tercih ettik.
"Yapay zeka ile öğrenmeyi daha eğlenceli ve etkileşimli hale getirmek"
- Eğitici İçerik: Kaliteli ve öğretici quiz soruları
- AI Destekli Deneyim: Gemini API ile akıllı soru üretimi
- Kullanıcı Dostu Tasarım: Modern ve sezgisel arayüz
- Sosyal Öğrenme: Arkadaşlarla yarışma imkanı
Umarız beğenirsiniz! 🙌
Modern ve kullanıcı dostu arayüz tasarımı ile akıcı deneyim |
Güvenli kullanıcı girişi ve hesap yönetimi sistemi |
Yapay zeka destekli akıllı soru üretimi ve değerlendirme |
- ✅ Modern Flutter UI: Material Design 3 ile uyumlu tasarım
- ✅ Firebase Integration: Real-time database ve authentication
- ✅ Gemini AI API: Akıllı soru üretimi ve analiz
- ✅ Responsive Design: Tüm ekran boyutlarında mükemmel görünüm
- ✅ Real-time Scoring: Anlık puan hesaplama sistemi
- ✅ User Analytics: Detaylı performans takibi
- ✅ Offline Support: İnternet bağlantısı olmadan da kullanılabilir
- ✅ Multi-language: Çoklu dil desteği hazır
quizz_ai/
├── 📁 android/ # Android platform dosyaları
├── 📁 ios/ # iOS platform dosyaları
├── 📁 lib/
│ ├── 📁 core/
│ │ ├── constants/ # Sabitler ve konfigürasyonlar
│ │ ├── services/ # API ve Firebase servisleri
│ │ ├── utils/ # Yardımcı fonksiyonlar
│ │ └── theme/ # Tema ve stil dosyaları
│ ├── 📁 features/
│ │ ├── auth/ # Kimlik doğrulama
│ │ ├── quiz/ # Quiz işlemleri
│ │ ├── profile/ # Kullanıcı profili
│ │ └── leaderboard/ # Skor tablosu
│ ├── 📁 shared/
│ │ ├── widgets/ # Ortak widget'lar
│ │ └── models/ # Veri modelleri
│ └── main.dart # Ana uygulama dosyası
├── 📁 assets/
│ ├── images/ # Görseller
│ ├── icons/ # İkonlar
│ └── fonts/ # Yazı tipleri
├── 📁 screenshots/ # Uygulama ekran görüntüleri
├── pubspec.yaml # Flutter bağımlılıkları
└── README.md # Proje dokümantasyonu
# Flutter SDK kurulumu
flutter doctor
# Gerekli bileşenler
✅ Flutter SDK
✅ Android Studio
✅ VS Code (Opsiyonel)
✅ Git- Repository'yi klonlayın
git clone https://github.com/huseyineneserturk/quizz_ai.git
cd quizz_ai- Flutter bağımlılıklarını yükleyin
flutter pub get- Firebase konfigürasyonunu ayarlayın
# Firebase CLI kurulumu
npm install -g firebase-tools
# Firebase projesini başlatın
firebase login
flutterfire configure- API anahtarlarını ayarlayın
// lib/core/constants/api_constants.dart
class ApiConstants {
static const String geminiApiKey = 'YOUR_GEMINI_API_KEY';
static const String firebaseApiKey = 'YOUR_FIREBASE_API_KEY';
}- Uygulamayı çalıştırın
# Debug modu
flutter run
# Release modu
flutter run --release-
📱 Uygulamayı Açın
- Splash screen ile karşılanırsınız
- Ana sayfaya yönlendirilirsiniz
-
🔐 Giriş Yapın veya Kayıt Olun
// Firebase Auth kullanımı final FirebaseAuth _auth = FirebaseAuth.instance; // Email ile kayıt await _auth.createUserWithEmailAndPassword( email: email, password: password, );
-
🎯 Quiz Kategorisi Seçin
- Genel Kültür
- Bilim & Teknoloji
- Tarih
- Spor
- Sanat & Edebiyat
-
🧠 AI Destekli Sorularla Yarışın
- Gemini AI ile üretilen sorular
- Gerçek zamanlı değerlendirme
- Anında feedback
// Gemini AI entegrasyonu örneği
class GeminiService {
static Future<List<Question>> generateQuestions({
required String category,
required int count,
required String difficulty,
}) async {
// Gemini API çağrısı
final response = await geminiClient.generateContent([
Content.text(
'Generate $count quiz questions about $category '
'with $difficulty difficulty level'
)
]);
return parseQuestions(response.text);
}
}- Authentication: Email/Password, Google Sign-In
- Firestore: Real-time veri senkronizasyonu
- Cloud Functions: Sunucu tarafı işlemleri
- Analytics: Kullanıcı davranış analizi
- Gerçek Zamanlı Skorlama
- İlerleme Grafikleri
- Başarı Rozetleri
- Liderlik Tablosu
# Unit testler
flutter test
# Widget testler
flutter test test/widget_test.dart
# Integration testler
flutter test integration_test/# Coverage raporu oluşturma
flutter test --coverage
genhtml coverage/lcov.info -o coverage/html- 🍴 Fork edin
- 🌿 Feature branch oluşturun
- 💾 Commit edin
- 📤 Push edin
- 🔄 Pull Request açın
- Flutter Standards: Official Dart/Flutter style guide
- Commit Messages: Conventional Commits formatı
- Code Review: Tüm PR'lar review edilir
- Testing: Yeni özellikler için test yazılmalı
Hüseyin Enes Ertürk 🎯 Backend Developer & AI Integration & Frontend Developer 
|
Abdülkerim Akan 🎨 Backend Developer & AI Integration & Frontend Developer
|
Yavuz Karakuş 🤖 UI/UX Designer & Frontend Developer
|
🏆 Google Oyun ve Uygulama Akademisi Flutter Grup 79
- 👨💻 Hüseyin Enes: ,Frontend geliştirme, Backend geliştirme, API Entegrasyonu
- 🎨 Abdülkerim: Frontend geliştirme, Backend geliştirme, API Entegrasyonu
- 🤖 Yavuz: UI/UX tasarım, Frontend geliştirme
Bu proje MIT Lisansı ile lisanslanmıştır.
MIT License
Copyright (c) 2024 Google Flutter Grup 79
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software...
