Ana içeriğe geç

Kitap Okuma Parkuru & Değerlendirme Sistemi - Proje ve Kurulum Rehberi

Bu doküman, ilkokul seviyesindeki 30 kitaplık okuma parkurunun dijital değerlendirme, canlandırma sergisi, rozet vitrini ve haftalık veli iletişim sistemini sıfırdan tek seferde kurmak isteyen eğitimciler için hazırlanmış kapsamlı bir uygulama rehberidir.

1. Sistemin Pedagojik Yapısı ve Temel İlkeleri

  1. Bireysel Gelişim Odaklı (Sıfır Kıyaslama / Sıralama Yok):
  2. Sınıf içi liderlik tablosu veya "en çok rozet toplayanlar" listesi kesinlikle bulunmaz.
  3. Her öğrenci yalnızca kendi okul numarasını girerek kendi kişisel başarı vitrinini (30 rozet albümü) ve kendi okuma istatistiğini görür.
  4. Çift Görev Rozet Kuralı:
  5. Bir kitabın özel rozetini açmak için iki şart gereklidir:
    1. Online değerlendirme testinden en az %80 başarı elde etmek.
    2. Kitapla ilgili haftalık canlandırma / rol yapma fotoğrafını sisteme yüklemek.
  6. Sürekli Açık Ekranlar & Öğrenme Fırsatı (2 Saat Kuralı):
  7. Hem online test çözme hem de fotoğraf yükleme ekranları son teslim tarihine kadar haftanın her günü 7/24 sürekli açıktır.
  8. Testte %80 altında kalan öğrenciye sistemi kapatmak yerine kitabı yeniden okuyup eksiklerini pekiştirmesi için 2 saatlik bekleme süresi (sayacı) verilir; süre bitince testi tekrar çözebilir.
  9. Haftalık Canlandırma Sergisi ve Adil Oylama:
  10. Yalnızca ilgili kitaba fotoğraf yüklemiş olan öğrenciler sergiyi görebilir ve oy kullanabilir.
  11. Fotoğraflar adil olması için her girişte rastgele sıralanır.
  12. Öğrenci kendi fotoğrafına oy veremez; arkadaşlarından en beğendiği 3 kişiyi 1. (3p), 2. (2p), 3. (1p) olarak seçer.

2. Proje Dosya Ağacı

Kitap Değerlendirme/
├── Code.gs                           # Google Apps Script arka uç kodu (Veritabanı, Drive, API)
├── Index.html                        # Google Apps Script için tek parça web uygulaması
├── index.html                        # Bağımsız web sunucuları / yerel kullanım için HTML
├── soru_bankasi.js                   # 30 kitap x 550 soru + öğrenci listesi verisi
├── soru_bankasi.json                 # Yapılandırılmış JSON soru bankası
├── ogrenci_listesi.json              # 35 öğrencinin adı, soyadı ve okul numaraları
├── EKSTRA_GOREVLER.md                # 30 kitabın tamamı için yaratıcı canlandırma görevleri
├── HAFTALIK_DUYURU_SABLONLARI.md     # WhatsApp / BİP haftalık veli duyuru şablonları
└── Test_Veritabanı/
    ├── cevap_anahtarlari.md          # 30 kitaba ait resmi yayınevi cevap anahtarları
    ├── 01_bilim_tayfasi.md           # 1. Set (10 Kitap, 200 soru)
    ├── 02_yine_recai.md              # 2. Set (10 Kitap, 200 soru)
    └── 03_vecihi.md                  # 3. Set (10 Kitap, 150 soru)

3. Adım Adım Kurulum Rehberi (5 Dakikada Yayında)

Bu sistemi çalıştırmak için sunucu kiralamanıza veya ücret ödemenize gerek yoktur. Google'ın ücretsiz sunduğu Google E-Tablolar (Sheets) ve Google Apps Script altyapısı yeterlidir.

1. Adım: Yeni Google E-Tablo Oluşturma

  1. Google Drive hesabınızı açın (drive.google.com).
  2. Yeni > Google E-Tablolar seçeneğine tıklayın.
  3. Dosyanın adını Kitap_Okuma_Parkuru_Veritabani olarak belirleyin.

2. Adım: Apps Script Kodunu Ekleyin

  1. Açılan E-Tablo menüsünden Uzantılar > Apps Script bölümüne tıklayın.
  2. Karşınıza gelen Kod.gs (veya Code.gs) dosyasındaki kodları tamamen silin.
  3. Projedeki Code.gs dosyasının tüm içeriğini kopyalayıp buraya yapıştırın ve kaydedin (Ctrl + S).
  4. Yukarıdaki fonksiyon seçici menüden setupDatabase fonksiyonunu seçip Çalıştır (Run) butonuna basın. (Gerekli izinleri onaylayın. Bu işlem Test_Sonuclari, Gorev_Fotograflari, Oylar ve Ayarlar sayfalarını ile Drive klasörünü otomatik oluşturur).

3. Adım: Web Arayüzünü (Index.html) Ekleyin

  1. Apps Script ekranının sol tarafındaki Dosyalar (+) butonuna tıklayın ve HTML seçeneğini seçin.
  2. Dosya adını tam olarak Index yazın (uzantısız).
  3. Açılan Index.html dosyasının içini tamamen temizleyin.
  4. Projedeki Index.html dosyasının tüm içeriğini kopyalayıp buraya yapıştırın ve kaydedin.

4. Adım: Web Uygulaması Olarak Dağıtım (Publish)

  1. Sağ üst köşedeki mavi Dağıt (Deploy) > Yeni Dağıtım (New deployment) butonuna tıklayın.
  2. Sol taraftaki dişli çark simgesinden Web uygulaması (Web app) türünü seçin.
  3. Ayarları şu şekilde yapın:
  4. Açıklama: Kitap Parkuru v1
  5. Farklı yürüt (Execute as): Ben (Hesabınız)
  6. Erişimi olanlar (Who has access): Herkes (Anyone) (Öğrencilerin ve velilerin Google hesabı girmeden doğrudan erişebilmesi için gereklidir).
  7. Dağıt butonuna basın ve üretilen Web Uygulaması URL'sini (URL) kopyalayın.

Artık sisteminiz hazırdır! Bu bağlantıyı velileriniz ve öğrencilerinizle paylaşabilirsiniz.

4. Haftalık Süreç ve İletişim Takvimi

Sistemin verimli işlemesi için haftalık döngü şu şekilde yürütülür:

1. Cumartesi Sabahı (Ana Görev ve Değerlendirme Duyurusu)

  • WhatsApp/BİP grubuna HAFTALIK_DUYURU_SABLONLARI.md dosyasındaki 1. Şablon gönderilir.
  • Geçen haftanın kitabı için: Test çözme linki ve fotoğraf yükleme alanı paylaşılır. Son tarihe kadar ekranın açık olduğu ve %80 altı puan alanların 2 saat sonra tekrar deneyebileceği belirtilir.
  • Yeni hafta için: Okunacak yeni kitap ve haftalık canlandırma görevi açıklanır.

2. Çarşamba Günü (Mini Test ve Görev Hatırlatması)

  • WhatsApp/BİP grubuna HAFTALIK_DUYURU_SABLONLARI.md dosyasındaki 2. Şablon gönderilir.
  • Öğrencilere 1. ve 2. set kitaplarının arkasındaki kısa etkinlikleri/testleri kitap üzerinde çözmeleri ve hafta sonunu beklemeden canlandırma fotoğraflarını yükleyebilecekleri hatırlatılır.

3. Cuma Günü (Canlandırma Sergisi ve Oylama)

  • WhatsApp/BİP grubuna HAFTALIK_DUYURU_SABLONLARI.md dosyasındaki 3. Şablon gönderilir.
  • Fotoğraf yükleyen öğrenciler sisteme girip arkadaşlarının çalışmalarını inceler ve 1., 2., 3. olarak oylarını verir.

5. Öğrenci Kimlik Doğrulama ve Güvenlik

  • Sisteme yabancı kişilerin veya rastgele isimlerin giriş yapmasını engellemek için açılır listeden öğrencinin adı seçildikten sonra Okul Numarası girilmesi zorunludur.
  • Okul numarası öğrenciye özel bir PIN şifresi gibi çalışır.
  • Doğrulama sağlandığında oturum tarayıcıda (localStorage) saklanır; öğrenci sayfayı yenilese dahi tekrar giriş yapmak zorunda kalmaz.
  • Oylama sırasında öğrencinin kendi fotoğrafını seçmesi sistem tarafından engellenmiştir.

6. Projede Kullanılan 30 Kitap ve Set Listesi

  1. 1. Set: Bilim Tayfası: Geleceğe Dönüş (Analiz Çocuk - 10 Kitap)
    1. Albert Einstein, 2. Marie Curie, 3. Mimar Sinan, 4. Nikola Tesla, 5. Louis Pasteur, 6. İbn-i Sina, 7. Nene Hatun, 8. Galileo Galilei, 9. Ali Kuşçu, 10. Leonardo Da Vinci.
  3. 2. Set: Yine Recai (Analiz Çocuk - 10 Kitap)
    1. Dondurmalı Gözlük Meselesi, 2. El mi Yaman Recai mi?, 3. Ah Nerede Vah Nerede, 4. Dedemi Vermem, 5. Yolun Sonu Almanya, 6. Düğüm Çözülürse, 7. Paşa Karıştı, 8. Kayıp Aranıyor, 9. Virüs Geliyorum Dedi, 10. Balonu Kim Söndürdü?.
  5. 3. Set: Vecihi'nin Maceraları (Mutlu Yayıncılık - 10 Kitap)
    1. Böyle Ceza Olur mu?, 2. Kötü Adamlar Peşimizde!, 3. Ne Olacak Bu Okul Takımının Hâli?, 4. Yaramaz Keçiyle Nasıl Barıştık?, 5. Babam da Bir Zamanlar Çocukmuş!, 6. Kim Korkar Farelerden?, 7. Sokağımızın Kahramanı Aslan Tekir!, 8. Ava Giden Avlanır!, 9. Çılgın Proje Havalanıyor!, 10. Gökyüzü Bizi Bekliyor!.

7. Öğretmen / Yönetici Paneli & Tam Yetki (God Mode)

  • Öğretmen Şifresi (PIN): 2291
  • Giriş Yöntemi: Giriş ekranındaki alt bağlantıdan 🔑 Öğretmen Girişi (Şifre: 2291) tıklanarak PIN girilir.
  • Zuhal (Test Öğrencisi): ZUHAL (TEST) (No: 2291) kullanıcısı SADECE öğrenci sınırlılıklarıyla çalışır; öğretmenin öğrenci gözüyle kilitleri, testleri ve rozetleri test etmesini sağlar.
  • Canlı Geri Sayım Sayacı: Sayfanın en üstünde sürekli sabit kalan sayaç, aktif haftanın görev/fotoğraf teslimine veya oylama bitişine kalan süreyi saniye saniye gösterir.
  • Öğretmen Yetkileri (Öğrencilerin Göremediği Her Şey):
  • 🌟 30 Rozet Vitrini: 30 kitaba ait özel vektörel rozetler Altın, Gümüş veya Yan Yana modunda tek tıkla incelenebilir.
  • 🏆 Rozet Sarayım Önizleme: Rozet Sarayım ekranında öğretmen kontrol çubuğundan tek tıkla tüm rozetler Altın veya Gümüş olarak açılır.
  • 📚 Gizli Görevler & Cevap Anahtarları: 30 kitabın 550 değerlendirme sorusu, doğru şıklar yeşil onay ikonuyla (✓ Doğru Cevap) açıkça görünür ve gizli haftalık yaratıcı görevler incelenebilir.
  • 📝 Kilit & Bekleme Süresi Muafiyeti: Öğretmen modu tüm kilitli haftaları çözer; bekleme süresi olmadan her testi görüntüleyebilir.
  • ⚙️ Aktif Hafta Belirleme: Aktif seti, kitabı ve haftalık oylama durumunu tek tıkla E-Tabloya kaydeder.
  • 📊 Sınıf İlerleme Raporu: Çözülen testler, yüklenen fotoğraflar ve öğrenci puan çizelgesi canlı takip edilir.