MasterStudy LMS Mobile App – Flutter v.3 iOS & Android

✨ Temel Özellikler

• Platformlar arası Flutter v3 kod tabanı — Flutter 3.x'in en iyi uygulamalarını kullanan iOS ve Android için tek kod tabanı.
• Kullanıcı Kimlik Doğrulaması — JWT / OAuth'a hazır oturum açma, sosyal oturum açma kancaları (isteğe bağlı) ve güvenli oturum yönetimi.
• Kurs Kataloğu ve Arama — kategorilere göz atın, seviyeye, eğitmene, fiyata göre filtreleyin ve tam metin arama yapın.
• Ders Oynatma — video/ses akışı, uyarlanabilir oynatma, ilerlemeyi sürdürme ve çevrimdışı görüntüleme için indirilebilir kaynaklar.
• Sınavlar ve Ödevler — süreli sınavlara katılın, ödevleri gönderin ve anında geri bildirimleri ve notları görüntüleyin.
• İlerleme Takibi — kursun tamamlandığını, sertifika verme kancalarını ve kullanıcı kontrol panellerini izleyin.
• Anında Bildirimler — Duyurular, kurs güncellemeleri ve hatırlatıcılar için Firebase Bulut Mesajlaşma (FCM) entegrasyonu.
• Çevrimdışı Destek — derslerin ve varlıkların önbelleğe alınması, durum için yerel SQLite/SharedPreferences ve zarif çevrimdışı geri dönüşler.
• Uygulama İçi Satın Almalar ve Ödemeler — Stripe, Apple/Google IAP veya sunucu tarafı ödemeleri için yer tutucu/ödeme SDK entegrasyon noktaları.
• Eğitmen Profilleri ve Mesajlaşma — eğitmenin biyografisini, iletişim kancalarını ve temel uygulama içi iletişim kanallarını görüntüleyin.
• Erişilebilirlik ve Yerelleştirme — i18n'ye hazır dizeler ve temel erişilebilirlik uyumluluğu (etiketler, ölçeklenebilir metin).
• Genişletilebilir Mimari - Blok/Sağlayıcı uyumlu durum yönetimi (veya seçtiğiniz sağlayıcı), modüler klasör yapısı ve hızlı özelleştirme için iyi yorumlanmış kod.

⚙️ Teknik Yığın

Ön uç (mobil): Flutter v3 (Dart 2.17+/v3 için kararlı), Materyal Tasarımı widget'ları, telefonlar ve tabletler için duyarlı düzenler.

Arka uç (entegrasyon): MasterStudy LMS (dağıtımınıza bağlı olarak PHP / WordPress eklentisi veya Laravel tabanlı API) — Veri senkronizasyonu için RESTful JSON API veya GraphQL uç noktaları.

İsteğe bağlı hizmetler ve entegrasyonlar: Firebase (Push için FCM, Analytics), medya için AWS/Cloud CDN, gelişmiş oynatma için ExoPlayer/AVPlayer sarmalayıcıları ve çevrimdışı içerik için güvenli depolama.

Durum yönetimi önerileri: Bloc, Provider veya Riverpod (modüler kullanıma hazır).

Derleme ve CI: Android SDK (Android 10'dan fazla hedef önerilir), Xcode (iOS 13+), otomatik derlemeler için fastlane desteği önerilir.

🧩 Kurulum Kılavuzu (Hızlı)

1. Önkoşullar: Flutter SDK v3.x'i, Android SDK'yı ve Xcode'u (macOS iOS sürümleri için) yükleyin.
2. Depoyu klonlayın: Flutter projesini geliştirme çalışma alanınıza yerleştirin.
3. API'yi yapılandırın: lib/config.dart veya .env dosyasını MasterStudy LMS API temel URL'niz ve kimlik bilgilerinizle (JWT anahtarları, istemci kimlikleri) güncelleyin.
4. Deps'i yükleyin: Dart paketlerini getirmek için flutter pub get komutunu çalıştırın.
5. Android kurulumu: Android/app/build.gradle'ı yapılandırın, SHA anahtarlarını ekleyin ve applicationId'yi ayarlayın. Anlık bildirimler kullanılıyorsa FCM kimlik bilgilerini yapılandırın.
6. iOS kurulumu: ios/Runner.xcworkspace'i Xcode'da açın, paket tanımlayıcıyı, özellikleri ve push sertifikalarını yapılandırın.
7. Çalıştır ve test et: Emülatörde/cihazda geliştirme için flutter run'u kullanın. Üretim için CI veya yerel araçlar aracılığıyla APK/AAB ve iOS App Store paketi oluşturun.

Not: App Store ve Play Store gönderimleri (temel hazırlık profilleri, yetkilendirmeler ve gizlilik politikaları) için platforma özel ayrıntılı derleme notları ve temel hazırlık adımları takip edilmelidir.

📦 Teslimatlar

• iOS ve Android için tam Flutter v3 kaynak kodu (Dart).
• Belgeler: kurulum kılavuzu, API sözleşme örnekleri ve oluşturma talimatları.
• FCM, analiz ve medya akışı için örnek yapılandırma.
• İsteğe bağlı: hızlı entegrasyon testi için örnek arka uç API taslakları / Postacı koleksiyonu.
• Varlıklar: simgeler, açılış ekranları ve demo derlemeleri için örnek kurs verileri.

📱 Desteklenen Platformlar

Mobil İşletim Sistemi: Android (Android 8.0 / API 26+ önerilir) ve iOS (iOS 13+ önerilir). Flutter, hem telefon hem de tablet form faktörleriyle uyumluluk sağlar.

Geliştirici İşletim Sistemi: iOS derlemeleri için macOS gereklidir; MacOS/Linux/Windows, Android geliştirme ve Flutter araçları için desteklenir.

🧠 Notlar

Lisans: Bu mobil uygulama dağıtımı GPL tarzı yeniden dağıtım için hazırlanmıştır. Paketin GNU Genel Kamu Lisansı (GPL) metnini içerdiğinden ve yeniden dağıtılan türevlerin GPL yükümlülüklerine uygun olduğundan emin olun.

Özelleştirme ipuçları:

• Yukarı akış güncellemelerini basitleştirmek için API'ye özgü uyarlamaları tek bir yapılandırma modülünde tutun.
• Deneysel modüller arasında geçiş yapmak için özellik işaretlerini kullanın (öncelikle çevrimdışı dersler, gelişmiş analizler).
• Medya işlemeyi modüler hale getirerek yerel önbelleğe almayı, CDN'yi veya üçüncü taraf akışını minimum değişiklikle değiştirebilirsiniz.
• Platform gizlilik kurallarına uyun: izinleri bildirin, gizlilik politikası bağlantılarını sağlayın ve varsa GDPR/CCPA'ya göre kişisel verileri yönetin.

SEO ve App Store optimizasyon güvencesi: SEO web içeriğini hedeflerken uygulama, keşfedilebilirliği artıran derin bağlantıları ve paylaşılabilir herkese açık kurs sayfalarını destekler. Mağazanın bulunabilirliği için anlaşılır App Store/Play Store açıklamaları, ekran görüntüleri ve yerelleştirilmiş meta veriler sağlayın.

👨‍💻 Orijinal Geliştirici Kredisi

Yazar / kaynak: Bu mobil yardımcı uygulama, MasterStudy LMS ekosistemini temel alır. Kesin yazar ve orijinal listeleme ayrıntıları için pakette yer alan satıcı bilgilerini ve orijinal pazar listesini (örneğin, CodeCanyon veya tema/eklenti satıcı sayfası) doğrulayın.

Örnek liste (arama): CodeCanyon'da MasterStudy LMS Mobile listelerini arayın

Yetkililik: Orijinal yazarı her zaman tam olarak dağıtılan paket dosyalarında (/LICENSE, /readme) gösterildiği gibi onaylayın ve kaynak gösterin.

🔒 Sorumluluk reddi beyanı

GPL yeniden dağıtım bildirimi: Bu açıklama, bir mobil yardımcı uygulamanın GPL tarzında yeniden dağıtımına yöneliktir. GNU Genel Kamu Lisansı, aynı lisans kapsamında değişiklik yapılmasına ve yeniden dağıtılmasına izin verir; lisans bildirimlerini saklayın ve gerektiği şekilde alt alıcılara kaynak kodunu sağlayın. Bu içerik hukuki tavsiye niteliğinde değildir; Ticari olarak yeniden dağıtımı planlıyorsanız GPL metnine veya hukuk danışmanına danışın.

✅ E-E-A-T Uyumluluğu (Tecrübe • Uzmanlık • Otorite • Güvenilirlik)

Deneyim: Uygulama, üretim gerçekleri göz önünde bulundurularak tanımlanmaktadır - medya akışı, çevrimdışı önbelleğe alma, anında bildirimler ve uygulama mağazası oluşturma gereksinimleri, gerçek dünyadaki mobil LMS ihtiyaçlarını yansıtır.

Uzmanlık: Teknik yığın ve derleme adımları (Flutter v3, Android/iOS araç zincirleri, FCM, oynatma hususları) geliştiricilere uygulanabilir uygulama rehberliği sağlar.

Güvenilirlik: Menşei ve menşei belirtilir ve doğrulama için orijinal pazaryeri listesine başvurulur.

Güvenilirlik: Lisans (GPL) ve yeniden dağıtım yükümlülükleri açıkça açıklanmıştır; Uyumluluğun ve kullanıcı güveninin korunmasına yardımcı olmak için yapı ve gizlilik hususları vurgulanmıştır.