Skymoon GPA — Not Ortalaması Hesaplama & Projeksiyon

Koç Üniversitesi öğrencileri için GPA (CGPA) hesaplama ve "what-if" projeksiyon aracı. "Bu dönem şu dersten A, şu dersten B alırsam ortalamam kaça çıkar?" sorusunu anında yanıtlar.

Not: Gayriresmî bir araçtır, Koç Üniversitesi ile bağlantısı yoktur. Sonuçlar tahminidir; resmî ortalama için transkript ve Öğrenci İşleri esas alınmalıdır.

Girdiğin hiçbir veri sunucuya gitmez. Backend yok; her şey tarayıcında hesaplanır ve localStorage'da kalır. Uygulama içindeki "Verilerimi sil" düğmesi kayıtlı her şeyi temizler.

Özellikler

• 📋 Transkript yapıştır — KUSIS tablosunu ya da PDF transkripti kopyalayıp yapıştır; dersler, krediler, notlar ve dönemler otomatik okunur. İçe aktarmadan önce önizleme gösterilir: okunamayan satırlar listelenir, yanlış okunan satırlar tek tıkla çıkarılır.
• 📈 Simülasyon — Mevcut GPA + toplam krediye planlanan dersleri ekleyip yeni CGPA'yı görme. Ders tekrarı (retake) desteği: kural seçilebilir (en yüksek / son / hepsi sayılsın).
• 🧮 Sıfırdan Hesapla — Tüm dersleri girip ortalamayı baştan hesaplama; çift anadal (ÇAP) için ayrı ortalamalar.
• 📊 Dönemler — Dönem dönem giriş, dönem ortalaması (SPA) ve kümülatif GPA grafiği.
• 🎯 Hedef GPA — İstenen ortalamaya ulaşmak için gereken dönem ortalamasını, minimum harf notunu ve örnek not kombinasyonlarını bulma.
• TR / EN dil desteği, açık/koyu tema, çevrimdışı çalışma (PWA), localStorage ile kalıcılık.

Teknik yığın

Vite + React 19 + TypeScript + Tailwind CSS v4. Test: Vitest. Lint: oxlint.

npm install
npm run dev       # geliştirme sunucusu (http://localhost:5173)
npm run build     # tsc + production build
npm run test      # hesaplama motoru + doğrulayıcı birim testleri
npm run lint

Mimari

src/
  lib/                 # saf, framework'ten bağımsız çekirdek
    grades.ts          # Koç harf notu skalası (katsayılar, GPA'ya giren/girmeyen notlar)
    gpa.ts             # Hesaplama motoru: calcGpaFromCourses / projectGpa / requiredTermGpa
    semesters.ts       # Dönem serisi: SPA + kümülatif GPA
    standing.ts        # "Mevcut durum" çözümlemesi (basit / detaylı giriş)
    transcript.ts      # Yapıştırılan transkript metnini ayrıştıran sezgisel parser
    validate.ts        # Kalıcı veriyi doğrulayan parser'lar (güvenlik sınırı)
    storage.ts         # Sürümlü localStorage + clearAppData()
    config.ts          # Alan adı, kaynaklar, doğrulama tarihi
    i18n.tsx           # TR/EN sözlük + provider
    *.test.ts          # 44 birim testi (kritik — önce burayı çalıştır)
  components/
    tabs/              # ProjectionTab, ScratchTab, SemestersTab, TargetTab
    ui.tsx, CourseList, CurrentStanding, GradeSelect, GpaVisual, GpaTrendChart,
    ResultParts, MobileResultBar, Header, InfoPanel, PrivacyFooter, ErrorBoundary
public/
  fonts/               # self-host edilmiş Inter + Fraunces (latin + latin-ext)
  theme.js             # ilk boyamadan önce temayı uygular (FOUC yok)
  sw.js                # service worker (çevrimdışı)

Hesaplama mantığı UI'dan tamamen ayrıdır (src/lib/), böylece test edilebilir ve ileride başka üniversiteler / bir API için yeniden kullanılabilir.

Kalıcı veri bir güvenlik sınırıdır

localStorage'dan okunan her şey güvenilmeyen girdi olarak ele alınır: eski bir sürümden kalmış, yarım yazılmış veya elle değiştirilmiş olabilir. validate.ts içindeki parser'lar tanımadıkları her değeri reddeder ve varsayılana döner. Bu olmadan tek bir bozuk kayıt her render'da hata fırlatır, "yenile" aynı kaydı tekrar okur ve uygulama kalıcı olarak kilitlenir. Şema değiştiğinde storage.ts içindeki STORAGE_VERSION'ı artır.

Koç Üniversitesi hesaplama kuralları

Not	Katsayı	Not	Katsayı
A+ / A	4.0	C	2.0
A-	3.7	C-	1.7
B+	3.3	D+	1.3
B	3.0	D	1.0
B-	2.7	F	0.0
C+	2.3

• GPA'ya girmeyen notlar: S, U, P, W (idari notlar). F → 0.00 olarak ortalamaya girer.
• Ağırlık: Koç kredisi ile (ECTS değil).
• GPA = Σ(katsayı × kredi) / Σ(kredi) — yalnızca harf notlu (A+…F) dersler.
• Ders tekrarı: Varsayılan "en yüksek harf notu sayılır, krediler bir kez sayılır". Ancak notun değiştirilmesi her durumda otomatik değildir (bazı durumlarda dilekçe gerekir), bu yüzden kural arayüzden seçilebilir ve uygulama kullanıcıyı Öğrenci İşleri'ne yönlendirir.
• Eşikler: Mezuniyet ≥ 2.00 (kümülatif).
• Onur listeleri dönem ortalamasına (SPA) göre belirlenir, kümülatife göre değil: Vehbi Koç Onur Listesi SPA ≥ 3.75 · Dekan Şeref Listesi SPA ≥ 3.25 ve kümülatif ≥ 3.25.

Kurallar en son 26 Eylül 2026 tarihinde resmî kaynaklarla karşılaştırıldı (RULES_VERIFIED_ON, src/lib/config.ts). Kaynak listesi aynı dosyada ve uygulama içindeki bilgi panelinde görünür.

Kaynaklar

• Koç University — Grading Scale (Academic Council 2020/07)
• Koç University — Registrar's and Student Affairs Directorate

Yapılandırma

Tüm ayarlar .env içinde; hepsi herkese açık, sır değil.

Değişken	Ne işe yarar
VITE_SITE_URL	canonical, hreflang, OG, JSON-LD ve sitemap adreslerinin tek kaynağı. Yalnızca sahibi olduğun alan adını yaz. Boşsa bu etiketler hiç basılmaz.
VITE_PLAUSIBLE_DOMAIN	Boş = analytics kapalı, üçüncü taraf istek yok. Doldurunca Plausible (çerezsiz) yüklenir.
VITE_FEEDBACK_URL	Footer'daki geri bildirim bağlantısı. Boşsa bağlantı gizlenir.

This is the beginning of the README. Read the rest at the original. Read the full README ↗