# OKURIM – Kurbağa Karşıda v0.4


## v0.4: Windows akıllı tahta akışı
Açılış ekranında Sınıf etkinliği veya Bireysel çalışma seçin, son öğrenilen sesi belirleyin. “Sesi dene” ile hoparlörü kontrol edin. “Derse başla” ile oyun açılır. Sade tahta görünümü varsayılandır; F11 veya Tam ekran kullanılabilir.

Sınıf ve bireysel bölümler ayrı yerel kayıt tutar. Sınıf bölümünde bireysel sözlü gözlem ve günlere yayılan tekrar kapalıdır; sonuçlar sınıf etkinliğine aittir. Bireysel bölümde önceki v0.3 kayıtları korunur. Eski kayıtların geçmişte ortak kullanılıp kullanılmadığı bilinmediği için bunlara yeni bir kimlik atanmaz. Yeni sınıf bölümü ilk açılışta önceki içerik ve ses ayarlarını devralır, eski yanıtları devralmaz. Bundan sonraki içerik/ayar değişiklikleri bölüme özeldir.

“Kaydetmeden dene” geçici bir kopya üzerinde çalışır. Yanıtlar, ayar değişiklikleri ve tekrar takvimi gerçek kayda yazılmaz. “Denemeden çık” asıl kaydı geri getirir. Deneme sırasında rapor/yedek indirme ve yedek aktarma kapalıdır.

“Ara ver” soruyu durdurur ve sesi keser; Devam et aynı soruya döner. Başlangıca dönmek turu onayla sonlandırır. Verilmiş yanıtlar korunur.

Dokunma güvenliği: Yeni soruda 350 ms, yanlış yanıttan sonra 500 ms seçim kilidi vardır. Doğru yanıttan sonra zıplama için 750 ms geçiş kilidi vardır. Bir tuşa basılı tutarak soruların istemeden geçilmesi de engellenir. Bunlar süre yarışı değildir; okumak için zaman sınırı yoktur.

Güncel Edge/Chrome hedeflenmiştir. 1920×1080 ve 1366×768 gibi yatay tahta ekranları için yükseklik tabanlı düzen yazılmıştır. Gerçek cihazda görünüm testi yapılmadı. Ekran yakınlaştırması çok yüksekse veya tarayıcı penceresi çok küçükse kaydırma gerekebilir.

## Hızlı başlangıç
Oyunu tarayıcıda açın. Öğretmen panelinde son öğrenilen sesi seçin: O → K → U → R → I → M. I noktasız ı'dır. İ/i içerikte kullanılmaz. 2/3/4 yaprak ve 6/10/15 soru seçebilirsiniz. Yeni ses otomatik açılmaz.

## Yedi görev, tek oyun
1. Oku ve eşleştir: büyük–küçük harf veya aynı hece/kelimeyi eşleştirme.
2. Resme bak, oku: ok, mum, kum çizimlerinden veya mor renk örneğinden kelimeyi bulma.
3. Heceleri birleştir: ör. ko + ru → koru.
4. Dinle ve bul: cihazda Türkçe ses varsa kelimeyi dinleyip seçme. Varsayılan kapalıdır.
5. Oku, resmi seç: kelimeyi okuyup doğru resmi seçme. En az iki uygun resimli kelime gerektirir.
6. İlk sesi bul: yazılı kelimenin ilk sesinin harfini seçme.
7. Son sesi bul: yazılı kelimenin son sesinin harfini seçme.

Resimli görevler okuma ile kelime bilgisini birlikte kullanır. İlk/son ses görevleri yazı desteklidir, saf işitsel ses farkındalığı ölçümü değildir. Aynısını eşleştirmek bağımsız okumayı tek başına kanıtlamaz.

Öğrenilmemiş ses içeren hedef ve seçenekler gösterilmez. Kapalı içerik etkinlik havuzundan çıkar. Yetersiz içerik varsa yaprak sayısı azalır. O aşamasında ikinci yaprak harf olmayan şekildir. Seçilen görevler kullanılamıyorsa harf eşleştirmesine dönülür. Arayüz yönergeleri normal Türkçedir ve yetişkin rehberliğine yöneliktir.

## İpucu ve gözlem
Yanlış yanıtta küçük ipucu gelir; tekrar yanlışta öğretmen desteği istenir. İpucu düğmesiyle destek istemek mümkündür. İpucu veya öğretmen desteği kullanılmışsa ilk doğru seçim yardımsız başarı sayılmaz.
“Sözlü okuma gözlemi” seçeneği açıkken yazılı kelime / hece birleştirme görevlerinde yapraklar önce gizlenir. Öğretmen öğrenciyi dinler ve “Yardımsız okudu”, “Destekle çalıştı” veya “Gözlem yapmadan aç” seçer. Gözlem oyun puanından ayrı saklanır. Mikrofon kaydı ve otomatik okuma değerlendirmesi yapılmaz.
“Geç”, onaydan sonra soruyu tekrar listesine alır. Geçme, yanlış yanıt değildir. Yanıt vermeden Devam et ile soru atlanamaz.

## Tekrar takvimi
İlk yanlış veya geçilen soru oturum içi listeye girer. Yeterli farklı hedef ve turda yer varsa araya en az iki başka hedef konularak yeniden sorulur. Tur en fazla dört ek soruyla uzar. Uygun olmayan tekrar sonraki tura taşınır. Sadece O gibi tek hedefli aşamada farklı içerik uydurulmaz.
Gecikmeli tekrar açıkken zamanı gelmiş en fazla üç görev yeni turun başlarına katılır. İlk başarılı çalışmadan sonra 1 gün, sonraki gecikmeli yardımsız başarıdan sonra 3 gün, ardından 7 gün aralık kullanılır. Aynı gün art arda başarı aralığı büyütmez. Destekle veya yanlışla sonuçlanan çalışma bir gün sonraya planlanır. Sonraki aralık 7 günde kalır.
Bu süreler uygulama tasarım tercihidir. Otomatik öğrenmiş sayma, ses aşaması yükseltme veya standartlaştırılmış değerlendirme yoktur. Uygulama açıkken cihaz saatine göre çalışır; bildirim göndermez. Görev veya ses kapatılırsa ilgili tekrar açılana kadar bekler.

## Öğretmen paneli
- Etkinlikleri arayın, açıp kapatın, düzenleyin, kendi kelimenizi ekleyin. O harfi korunur.
- Toplu ekleme: her satıra bir kelime, en çok 30 satır. Geçersiz ses varsa hiçbir satır eklenmez. Yinelenenler atlanır.
- Metin denetimi ses kapsamını ve uzunluğu kontrol eder; anlamlılık ve yaş uygunluğu öğretmen onayı gerektirir.
- Özel kelimeler eşleştirme, ilk/son ses ve destekleniyorsa dinlemeye katılır. Resim ve hece birleştirme hazır eşlemelere bağlıdır.
- İçerik düzenlemek o içeriğin eski tekrar takvimini temizler; önceki yanıt geçmişi raporda kalır.
- Renk tanıma örneğini kapatabilirsiniz. Bu, “mor” sözcüğünü diğer yazılı görevlerden silmez.
- “Benzer çeldiriciler” açıkken yazılışı yakın seçenekler önceliklidir; kapalıyken uygun havuzdan rastgele seçilir.
- Ayarlar değişince yeni tur başlar; toplam kayıtlar korunur. Panel şifreli değildir.

## Rapor ve kayıt
Üst sayaçlar toplam doğru, yanlış deneme ve ilk denemede yardımsız doğruyu gösterir. Görev tablosu, zorlanılan kelimeler ve son yanıtlar son 500 yanıt üzerinden hesaplanır. Panelde son 30 yanıtın seçilen seçeneği de görünür. Sözlü gözlemler ayrıdır.
Eski sürümün kayıtları korunur; eski kayıtlarda bulunmayan ipucu ayrıntısı geriye dönük tahmin edilmez. “İlk denemede yardımsız” sayacının eski bölümü önceki sürümün tanımına dayanır. Temiz bir v0.3 ölçümü için önce rapor ve tam yedek alıp geçmişi sıfırlayabilirsiniz.
Her bölüm ayrı bir çalışma kaydı tutar. Bireysel bölüm birden fazla öğrenciyle paylaşılırsa kullanımları birleşir; kişisel öğrenci profili yoktur. Bireysel takip gerekiyorsa her öğrencinin anonim yedeğini ayrı saklayın veya cihazları ayırın.
Tarayıcı verileri silinirse kayıtlar da silinir. Gizli sekme veya yerel dosya politikası kaydı engelleyebilir. Kayıt başarısızsa ekranda uyarı görünür. Anlık tur yenilemede baştan başlar; aşama, ayarlar ve geçmiş korunur.

## Tablet–tahta arasında taşıma
1. Öğretmen panelinde “Tam yedek indir” seçin.
2. JSON dosyasını flash bellek veya kendi seçtiğiniz yöntemle diğer cihaza taşıyın.
3. Diğer cihazda “Yedeği içe aktar” alanından dosyayı seçin.
4. Değiştirme onayını verin. Bu cihazın mevcut kaydı yedekle değiştirilir.

“Kayıtları indir” rapor içindir; tam yedek değildir. İçe aktarma v0.3 ve v0.4 tam yedeklerini kabul eder. v0.3 yedeği bireysel bölümde, v0.4 yedeği ait olduğu bölümde açılır. Veriler doğrulanır; geçersiz yedek uygulanmaz. En fazla 1,5 MB yedek ve 500 içerik desteklenir.

## Tahta ve erişilebilirlik
Tam ekran düğmesi destekleyen tarayıcıda çalışır. Sade tahta görünümü çevre metnini azaltır. Yüksek karşıtlık ve hareketi azaltma ayarları vardır. Klavyede Tab ve Enter kullanılabilir; seçimden sonra odak Devam et'e gider. Dokunma hedefleri büyüktür. Can, süre yarışı veya başarısızlık cezası yoktur.
Eski akıllı tahtalarda güncel Chrome/Edge/Firefox gerekir. Gerçek cihaz denemesi yapılmadığından ders öncesinde dokunma, ses ve tam ekranı deneyin. Bu özellikler tam erişilebilirlik uygunluk sertifikası anlamına gelmez.

## Flash bellek / internet olmadan
ZIP'i çıkarın. Üstteki OYUNU-AC.html dosyasını tarayıcıda açın. Bu dosya tüm oyun kodunu, çizimleri ve efektleri içerir. Tek başına kopyalanırsa oyun çalışır; rehber bağlantıları için paketin tamamını saklayın. dist/index.html aynı oyunun web sürümüdür.
Oyun internet, kurulum veya CDN gerektirmez. Dinleme cihazın Türkçe konuşma motoruna bağlıdır; bazı sesler çevrimiçi olabilir. Tam yerel kullanım için dinlemeyi kapatın veya yerel Türkçe sesi seçin. Efektler internet istemez.
Telefonda/tablette HTML dosyası açma ve USB bellek desteği işletim sistemine göre değişir. Web bağlantısı da herkese açıktır; okul internet filtresi erişimi yine etkileyebilir.

## Kaynaklar ve geliştirme
src/core.js: ses filtresi, içerik, görev üretimi, yedek doğrulama, tekrar takvimi.
src/app.js: oyun akışı, SVG çizimler, ses, ipucu, gözlem.
src/panel.js: öğretmen paneli, rapor, yedekleme, görünüm.
src/classroom.js: başlangıç, sınıf/bireysel kayıt ayrımı, deneme ve ara verme.
src/template.html: sayfa ve CSS.
node build.cjs: tek dosyalı web sürümünü üretir.
node tests/check.cjs: kapsamlı testleri çalıştırır.
python3 package.py: Windows ZIP paketini yeniden üretir.
node tests/check.cjs --flows: yalnızca hızlı akış kontrollerini çalıştırır.

Araştırma gerekçeleri, örnekler ve kaynak bağlantıları ARASTIRMA.html dosyasındadır. Uygulama kaynaklara dayalı tasarlanmıştır; uygulamanın kendisinin öğrenme etkisi için sınıf pilotu yapılmamıştır. Gerçek tarayıcı ve akıllı tahta görsel/dokunmatik/ses doğrulaması bu ortamda yapılamadı.