Calcademy

Calculate. Visualize. Optimize. Learn.

Calcademy; matematik, istatistik, finans ve yöneylem araştırması problemlerini tek bir çevrimdışı çalışma alanında birleştiren, Flutter ile geliştirilmiş akademik hesaplama platformudur. Uygulama; güvenilir sayısal sonuç, açık yöntem bilgisi, responsive kullanım ve cihaz içi veri gizliliğine odaklanır.

Android release identity: com.aligundogan.calcademy · Publisher: Ali Gündoğan

Aktif çalışma alanları

Kategori	Modüller
Matematik	Bilimsel Hesap Makinesi, Grafik Çizici, Matrisler ve Lineer Cebir, Denklem Çözücü, Calculus
Optimizasyon ve Yöneylem Araştırması	Lineer Programlama, Tam Sayılı Programlama, Operations Research
Veri ve İstatistik	Statistics
Finans	Financial Calculator
Çalışma Alanı	Saved Calculations

Home ekranı modülleri bu bilgi mimarisine göre gruplar. Lokalize arama; modül adı, açıklaması ve kategori üzerinden çalışır. Telefonlarda tek sütun, tablet ve masaüstünde responsive grid kullanılır.

Öne çıkan yetenekler

• Bilimsel ifade değerlendirme, DEG/RAD, Ans, geçmiş ve haptic/key sound ayarları
• Adaptif örnekleme, pan/zoom ve cihaz içi grafik çalışma alanları
• Matris işlemleri, Gauss/Gauss-Jordan adımları ve lineer sistem sınıflandırması
• Analitik ve sayısal denklem çözümü; türev, integral ve fonksiyon analizi
• Betimsel istatistik, olasılık dağılımları ve güven aralıkları
• TVM, nakit akışı, kredi amortismanı ve başabaş analizi
• Simpleks tabanlı LP, Branch-and-Bound tabanlı IP
• Transportation, Assignment, Weighted Goal Programming ve CPM/PERT
• Modüller arası ortak, sürümlenmiş ve boyut limitli Saved Calculations kayıtları
• Home ve Ayarlar üzerinden erişilebilen, lokalize Hakkında ve Yasal Bilgiler alanı
• Türkçe/İngilizce, Material 3 light/dark tema ve çevrimdışı çalışma

Mimari

Proje feature-first düzeni kullanır. Matematiksel modeller ve çözücüler UI katmanından ayrıdır; Riverpod controller/state akışını, repository katmanı ise yerel kalıcılığı yönetir.

lib/
├── app/                    # Uygulama, router, navigation ve design token'ları
├── core/                   # Ortak servisler ve yeniden kullanılabilir UI
├── features/
│   ├── calculator/
│   ├── graph/
│   ├── matrix/
│   ├── equation_solver/
│   ├── calculus/
│   ├── statistics/
│   ├── financial_calculator/
│   ├── linear_programming/
│   ├── integer_programming/
│   ├── operations_research/
│   └── saved_calculations/
└── l10n/                   # TR/EN kullanıcı metinleri

Tasarım sistemi

Material 3 ColorScheme, ortak spacing/radius/breakpoint değerleri ve tema türevi yüzeyler kullanılır. Ortak section header, empty state, status banner ve result action bar bileşenleri; light/dark temada tutarlı hiyerarşi sağlar. Ana etkileşimler en az 48 dp dokunma alanını, 320 px genişliği ve %200 metin ölçeğini hedefler.

Teknoloji

• Flutter / Dart
• Riverpod
• go_router
• SharedPreferences
• fl_chart
• flutter_svg
• share_plus

Matematik ifadeleri eval kullanmadan kontrollü lexer/parser katmanlarında işlenir. Büyük veya sayısal olarak riskli problemler merkezi limit ve toleranslarla sınırlandırılır.

Saved Calculations

Başarılı sonuçlar desteklenen modüllerden ortak Saved Calculations repository’sine kaydedilebilir. Kayıtlar; modül, hesaplama tipi, giriş/sonuç özeti, küçük sürümlenmiş payload, zaman damgası ve favori durumunu içerir. Arama, modül filtresi, sıralama, favori, kopyalama ve silme cihaz içinde çalışır. Bulut senkronizasyonu veya kullanıcı hesabı yoktur.

Operations Research

• Transportation: North-West Corner, Least Cost ve MODI/U-V; dengeli/dengesiz problem desteği
• Assignment: Hungarian algoritması; kare/dikdörtgen ve min/max modeller
• Weighted Goal Programming: hard constraint, hedef ilişkisi ve sapma ağırlıkları
• CPM/PERT: activity-on-node ağları, forward/backward pass, bolluk ve kritik yol

Başlangıç feasible transportation çözümü optimal olarak etiketlenmez; dummy satır/sütun ve limit durumları kullanıcıya açıkça bildirilir.

Çalıştırma

Gereksinimler: Flutter 3.44 veya uyumlu kararlı sürüm, Dart 3.12+, Android SDK.

flutter pub get
flutter run

Test ve kalite kapısı

Unit testler domain servislerini, solver sonuçlarını, validation ve kayıt adapter’larını; widget testleri navigasyon, form/result akışları, copy/save eylemleri, dark mode ve responsive geometrileri kapsar. Release-readiness tabanında 441 test geçmektedir.

dart format --set-exit-if-changed .
flutter analyze
flutter test --concurrency=1
flutter build apk --debug
git diff --check

Gizlilik ve release yaklaşımı

Bu sürüm hesap, backend, reklam veya analytics kullanmaz. Hesaplamalar ve ayarlar cihazda saklanır; lokalize Hakkında ve Yasal Bilgiler ekranı bu yaklaşımı uygulama içinde açıklar ve yayınlanmış gizlilik politikasını harici tarayıcıda açabilir. Android adaptive/monochrome launcher kaynakları mevcut Calcademy işaretinden türetilmiştir; final 512×512 store icon ve feature graphic ayrıca görsel onay gerektirir. Debug APK CI/yerel kalite kapısından üretilebilir; Play Store imzalama ve mağaza metadata’sı ayrı release adımlarıdır.

Release hazırlık belgeleri:

• Android release signing
• Privacy policy taslağı
• Google Play store listing taslağı
• Screenshot checklist
• Release smoke test
• Monetization stratejisi
• 1.0.0 release notes taslağı
• Play Store final karar checklist
• Package name karar belgesi
• Play App Signing karar rehberi
• Final release build checklist
• Play Console App Content checklist
• Data Safety taslağı
• Store asset checklist
• Screenshot capture plan
• Screenshot sample data
• Content rating checklist
• Target audience checklist
• CI ve quality gate rehberi

Release build, repoya eklenmeyen özel bir upload keystore ve android/key.properties gerektirir. R8 ve resource shrinking release varyantında etkindir; debug varyantı bu ayarlardan etkilenmez.

Bilinen sınırlamalar

• Kompleks sayı ve tam sembolik CAS desteği yoktur.
• Sayısal motorlar double hassasiyeti ve modüle özel toleranslarla çalışır.
• Grafik Çizici gerçek, tek değişkenli Kartezyen fonksiyonlarla sınırlıdır.
• Büyük matris/optimizasyon/OR problemleri güvenli merkezi limitlerle sınırlandırılır.
• Saved Calculations için bulut senkronizasyonu ve tüm modüllerde full restore yoktur.
• PDF/CSV dışa aktarma ve üretim mağaza dağıtımı bu sürümün kapsamı dışındadır.

Yol haritası

• Release signing, mağaza görselleri ve erişilebilirlik saha doğrulaması
• Saved Calculations restore kapsamının kontrollü genişletilmesi
• Sembolik matematik için güvenilir, ayrı bir mimari değerlendirme
• OR için EOQ, Decision Analysis ve kaynak kısıtlı proje planlama
• Profiling tabanlı performans ve APK boyutu iyileştirmeleri