Teknik doküman·23 Ekim 2026

Mimari ve iş akışı

[Kesin][Muhtemel][Tahmin]güven etiketleri

Önce can sıkıcı bulgular

1. "İçerik doğrudan MEB'den çekilsin" varsayımı çalışmaz. [Kesin]

OGM Materyal test sayfaları "tüm yayın hakları MEB'e aittir, hiçbir şekilde ticari amaçla kullanılamaz veya kullandırılamaz; aykırılık FSEK 36'ya göre suçtur" ibaresi taşıyor (OGM Materyal). EBA uygulamalarının kullanım şartları da içeriğin yazılı izin olmadan çoğaltılmasını yasaklıyor (EBA). FSEK 33-34'teki eğitim istisnası kazanç amacı gütmeyen kullanım içindir; ücretli platform bunun dışında kalır. Çözüm: müfredat yapısını (tema, öğrenme çıktısı kodları, saat dağılımı) MEB programından referans al — bunlar korunan eser değil, kamu düzenlemesi — ama anlatım ve soruları özgün üret ya da lisansla. MEB ÖDSGM'nin ücretli yayım izni mekanizması var; sözleşmede 3 yıllık süre ve zorunlu telif ibaresi yer alıyor (ÖDSGM sözleşme örneği). "Telifsiz platform" alternatifi de pratikte yok: Türkçe, Maarif Modeli'ne hizalı, ticari kullanıma açık (CC BY) bir matematik havuzu bulamadım [Muhtemel].

2. "5-11. sınıf, Maarif Modeli" kapsamı 8. sınıfta kırılıyor. [Kesin]

2026-27'de Maarif Modeli 5, 6, 7 ve hazırlık, 9, 10, 11'de uygulanıyor; 8 ve 12. sınıflar önceki programla devam ediyor ve 2027 LGS/YKS'ye eski programla giriyor (BBC Türkçe, MEB OGM). Bakan Tekin'e göre 2027-28'de tüm kademeler modele geçecek (AA). Sonuç: 8. sınıf için bu yıl eski programa göre ayrı bir içerik ağacı gerekir ve bu içeriğin ömrü tek yıldır. Öneri: 8. sınıfı ya 2027-28'e ertele ya da LGS odaklı ayrı bir ürün olarak konumlandır.

3. "Zoom gibi" ile "Zoom'un kendisi" maliyet ve deneyim olarak farklı. [Kesin]

Zoom Video SDK (markasız, platform içine gömülü) katılımcı-dakika başına 0,0035 USD, ayda 10.000 dakika ücretsiz; kayıt dakikası 0,01 USD ayrı (Zoom developer pricing, rate tablosu). Meeting SDK ise Zoom arayüzünü gömer, Zoom hesabı/host lisansı ister (Zoom karşılaştırma). Eğitim platformu için doğru seçim Video SDK; alternatif olarak LiveKit (self-host mümkün) veya Daily. Demo bu kararı yansıtır.

4. Yapay zekâ asistanı tek başına LLM ile güvenilir olmaz. [Muhtemel]

Matematikte LLM'ler akıcı ama yanlış doğrulama yapabilir. Üretimde her hesaplama adımı sembolik doğrulayıcıdan (SymPy/CAS) geçmeli; model yalnızca pedagojik dili üretmeli. Ayrıca 18 yaş altı kullanıcı için veli onayı, sohbet kaydı ve "model eğitiminde kullanılmaz" sözleşme maddesi şart (KVKK).

Katmanlı mimari

İstemcilerweb + mobil + tablet
Next.js / React (PWA)Capacitor kabuğu → iOS/Android mağazaResponsive tasarım (bu demo)Offline önbellek: ders metni + son testler
API katmanıBFF
Node/NestJS veya FastAPIREST + WebSocketRol: öğrenci / veli / öğretmen / adminOran sınırlama (asistan kotası)
Kimlik & ödemeabonelik
Auth: e-posta/telefon OTP, veli onayı akışıiyzico veya PayTR (TL, taksit, abonelik)e-Fatura/e-Arşiv entegrasyonuDeneme süresi, kardeş indirimi, iptal
İçerik & müfredatLMS çekirdeği
Müfredat grafı: sınıf → tema → öğrenme çıktısıDers (MDX + video) · Soru bankası (JSON, KaTeX)Sürümleme ve editör onay akışıYanlış-tekrar algoritması (aralıklı tekrar)
Canlı dersgerçek zamanlı
Zoom Video SDK (web + native)Oturum sunucusu: JWT üretimi, webhooksTahta, anket, söz sırası (kendi UI)Kayıt → S3 uyumlu depolama → HLS
Yapay zekâ asistanıSokratik
LLM API (fonksiyon çağrısı destekli)RAG: yalnız seçili kazanımın ders metniSembolik doğrulayıcı (SymPy) — her adımPolitika katmanı: "cevabı verme", kapsam dışı reddiDenetim günlüğü → veli/öğretmen
Veri & analitik
PostgreSQL (ana veri)Redis (oturum, kota)Olay akışı: ders görüntüleme, test, asistanVeli raporu (haftalık iş)
Altyapı & uyum
Türkiye bölgesi/veri yerleşimi (KVKK)Yedekleme, günlükler, WAFVERBİS kaydı, aydınlatma metinleriErişilebilirlik (WCAG AA)

İçerik üretim iş akışı

Telif sorunu olmadan ölçeklenebilir tek yol. Müfredat yapısı MEB programından, içerik platformun kendisinden.

1. Müfredat haritasıtymm.meb.gov.tr'den tema ve öğrenme çıktısı kodları (ör. MAT.6.1) ve ders saati dağılımı alınır; veritabanına "kazanım düğümü" olarak işlenir.
2. Ders yazımıMatematik öğretmeni her kazanım için 8-12 dk'lık ders yazar (MDX şablonu: tanım, çözümlü örnek, kendini dene, sık hata).
3. Soru üretimiKazanım başına ≥30 özgün soru; zorluk ve çeldirici açıklaması zorunlu. LLM taslak üretir, öğretmen onaylar, CAS doğrular.
4. Pedagojik incelemeİkinci öğretmen kontrolü + çocuk-uygunluk kontrol listesi. Sürüm etiketi ve yayın tarihi.
5. Yayın & ölçümYayınlanır; soru bazlı doğru oranı ve ayırt edicilik izlenir, zayıf sorular geri çağrılır.
Kapsam (ilk yıl)AdetÜretim tahminiGüven
Sınıf (5, 6, 7, 9, 10, 11)6—[Kesin]
Öğrenme çıktısı (kazanım) toplamı≈ 180–240Sınıf başına 30-40[Tahmin]
Ders videosu (8-12 dk)≈ 200Öğretmen başına haftada 4-5 ders[Tahmin]
Soru bankası≈ 6.000–7.000Kazanım başına 30; 3 öğretmen, 6 ay[Tahmin]

Alternatif kısayol: ÖDSGM'den çıkmış sınav sorularını ücretli lisanslamak. Sözleşme 3 yıl süreli ve yayım biçimi başına ayrı ücret içeriyor; eski program sorularının Maarif Modeli'ne uyumu ayrıca kontrol edilmeli.

Canlı ders akışı

PlanlamaÖğretmen takvimden oturum açar; grup, kazanım ve kapasite seçer. Sunucu Zoom Video SDK oturum adı üretir.
HatırlatmaT-24s ve T-15dk bildirim (push + e-posta). Veliye de kopya.
KatılımÖğrenci "Katıl"a basar; sunucu kısa ömürlü JWT verir, SDK web bileşeni odaya bağlanır. Yoklama otomatik.
DersÖğretmen ekran paylaşır/tahta kullanır; anket ve söz sırası platform UI'ında; sohbet öğretmen onaylı.
SonrasıKayıt webhook'u → depolama → HLS; anket sonuçları kazanım takibine işlenir; ders özeti veli raporuna.
SenaryoHesapAylık maliyet (USD)Güven
200 öğrenci · haftada 2 ders · 50 dk · 15 kişilik gruplar200 × 2 × 50 × 4,3 = 86.000 kat.-dk(86.000 − 10.000) × 0,0035 ≈ 266 + kayıt ≈ 70[Muhtemel]
1.000 öğrenci, aynı yoğunluk430.000 kat.-dk≈ 1.470 + kayıt ≈ 350[Muhtemel]

Birim fiyatlar Zoom'un yayımladığı oranlardır; Zoom katılımcı başına dakika sayar ve kesirli dakikayı yukarı yuvarlar. Öğrenci başına ≈ 1,3-1,8 USD/ay; abonelik fiyatının içinde taşınabilir.

Yapay zekâ asistanı tasarımı

İstek akışı

  1. Öğrenci kazanım seçer; bağlam yalnızca o kazanımın ders metni + ön koşullarıyla sınırlanır (RAG).
  2. Politika katmanı: "cevabı doğrudan verme", kapsam dışı soruyu nazikçe reddet, kişisel veri isteme.
  3. Model Sokratik soru üretir; öğrenci cevaplar.
  4. Cevap, sembolik doğrulayıcıya (SymPy) gider; model yalnızca doğrulayıcı sonucunu yorumlar.
  5. 2 yanlış denemeden sonra açıklama; olay "tekrar listesi" ve veli raporuna yazılır.

Maliyet ve kota

Öğrenci başına günde 60 mesaj sınırı; ortalama 1.500 token/mesaj varsayımıyla aylık öğrenci başı ≈ 0,5-2 USD [Tahmin] — model seçimine çok bağlı. Küçük/hızlı model + doğrulayıcı kombinasyonu hem ucuz hem daha güvenli.

Ölçüm: adım başına doğrulama oranı, "cevabı söyle" isteklerinin reddi, kazanım tamamlama süresi.

Ödeme, KVKK ve çocuk kullanıcılar

  • Hesap veli tarafından açılır; öğrenci profili veli onayıyla etkinleşir. 18 yaş altı için açık rıza velide.
  • Ödeme: iyzico/PayTR abonelik (tekrarlayan tahsilat), e-Arşiv fatura otomatik. Mağaza uygulamasında dijital içerik satışı Apple/Google komisyonuna tabidir; web'de satış, uygulamada giriş modeli tercih edilmeli [Muhtemel].
  • Veri Türkiye'de tutulur; VERBİS kaydı, aydınlatma metni, çerez politikası. Sohbet kayıtları şifreli, 1 yıl saklama, model eğitiminde kullanılmaz.
  • Mesafeli satış ve cayma hakkı: dijital içerikte anında ifa onayı alınır.

Yol haritası ve bu demonun kapsamı

FazKapsamÇıktı
0 · Bu demoStatik, tıklanabilir prototip: panel, konu, test, canlı ders odası (simüle), asistan (kurallı), mimariAkış ve arayüz kararlarını revize etmek için
1 · MVP (8-10 hafta)Tek sınıf (6), 1 tema tam içerik, gerçek LLM+doğrulayıcı, Zoom Video SDK, iyzico deneme aboneliği, veli onayı50 öğrencilik pilot
2 · Ölçek5-7 ve 9-11 tüm temalar, mağaza uygulamaları, öğretmen paneli, veli raporu, kayıt arşiviÜcretli lansman
3 · 2027-288 ve 12. sınıf Maarif Modeli'ne geçince kapsam genişletmeTam K5-12 (matematik)

Demoda neler gerçek, neler simüle? Gerçek: tüm sayfa akışları, test motoru (puanlama, süre, inceleme), konu içi kontrol, Sokratik asistan mantığı (kurallı), responsive düzen. Simüle: video akışı, kullanıcı verileri, ödeme, LLM.