Ana içeriğe geç

🎲 Sınıf Katılım ve Adil Kura Sistemi

Sınıf Katılım ve Adil Kura Sistemi, sınıfta söz hakkı dağıtımını şansa veya öğretmen reflekslerine bırakmayan, öğrencilerin derse katılımını K27 Katı Makas (Strict Limit) Adalet Algoritması ile dengeleyen, Google E-Tablolar (Sheets) ve Google Apps Script (GAS) ile senkronize çalışan akıllı tahta ve yönetim platformudur.

🚀 Canlı Deneyim ve İndirme Bağlantıları

💡 Neden Geliştirildi? (Problem & Çözüm)

Geleneksel Parmak Kaldırma ve Kura Düzenindeki Çıkmazlar

  • Parmak Kaldırma Baskınlığı: Geleneksel sınıflarda genellikle en ön sıralarda oturan veya özgüveni yüksek 3-5 öğrenci sürekli parmak kaldırır. Düşünmek için zamana ihtiyaç duyan, içe dönük veya çekingen öğrenciler ise zamanla dersten tamamen koparak "nasılsa bana sıra gelmez" hissine kapılır.
  • Sübjektiflik ve "Hocam Bana Taktınız" Algısı: Öğretmen hafızasına güvenerek söz verdiğinde farkında olmadan bazı öğrencileri atlayabilir veya bazılarına daha sık söz verebilir. Bu durum öğrenciler arasında haksızlık ve ayrımcılık algısı doğurur.
  • Basit Kura Çarklarının Yetersizliği: Klasik rastgele kura araçları sınıfta o gün olmayan (devamsız) öğrencileri seçerek dersin akışını böler, art arda aynı kişileri getirebilir ve geçmişte hiç söz almamış öğrenci ile 10 kez söz almış öğrenciyi ayırt edemez.

Pedagojik ve Algoritmik Çözüm: K27 Katı Makas Felsefesi

  • ⚖️ K27 Katı Makas (Strict Limit = 1): Sınıfta en az söz almış öğrenci ile en çok söz almış öğrenci arasındaki fark asla 1'i geçemez. Örneğin sınıfta 4 kez söz almış öğrenciler varken 5 kez söz almış hiçbir öğrenci kuraya dahil edilmez. Makas ancak tüm sınıf eşitlendiğinde bir üst basamağa açılır.
  • 🛡️ Dinamik Ağırlıklı Şans Havuzu: Söz hakkı az olan öğrencinin kura torbasındaki şansı katlanarak artar (1 / (katılım + 1)). Devamsız, geç gelen veya dersten muaf olan öğrenciler anında havuzdan ayıklanır.
  • 🖥️ 68px Dev Dokunmatik Butonlar & PiP Modu: Akıllı tahtalarda tebeşir tozu veya uzaktan dokunma zorluğunu ortadan kaldıran 68px dev kontrol butonları; sunumu kapatmadan köşede yüzen Picture-in-Picture (PiP) tahta çubuğu.
  • 💌 Yapıcı ve Yargılamayan Veli İletişimi: Velilere "Çocuğunuz derste konuşmuyor" gibi suçlayıcı ifadeler yerine; "Bu hafta sunulan 6 söz hakkı fırsatının 5'ine aktif katılım sağladı" şeklinde somut, mikro gelişim odaklı karne ve WhatsApp mektupları üretilir.

🌟 Öne Çıkan Özellikler & Ekran/Kullanım Rehberi

flowchart LR
    subgraph Tahta ["🖥️ Akıllı Tahta Arayüzü (v20)"]
        KURA["🎯 K27 Katı Makas Kura"]
        DEV["🔲 68px Dev Butonlar"]
        PIP["🖼️ Picture-in-Picture"]
    end

    subgraph ArkaPlan ["⚙️ Google Apps Script (v16)"]
        CACHE["⚡ 5dk CacheService"]
        LOG["📜 0.2sn Log Motoru"]
        FLEX["🗺️ Esnek Sütun Haritası"]
    end

    subgraph Yonetim ["📊 Raporlama Paneli (v12)"]
        KARNE["📄 A4 Renkli Karne"]
        MEKTUP["💌 Veli WhatsApp Mektubu"]
        YOKLAMA["⏰ RFID Devamsızlık Takibi"]
    end

    Tahta <-->|Anlık Katılım & Pas| ArkaPlan
    ArkaPlan <-->|Konsolide Analiz| Yonetim

1. 🔲 Akıllı Tahta Uygulaması (Sinif_Katilim_Sistemi_v20.html)

  • K27 Katı Makas Dağıtımı: Kura motoru her basıldığında sınıftaki minimum ve maksimum katılım farkını inceler; tavanı aşan öğrencileri geçici olarak dinlendirir.
  • 68px Dev Dokunmatik Tuşlar: Öğretmenin akıllı tahta başında hızla tıklayabileceği büyük, yüksek kontrastlı ve dokunmatik optimize edilmiş butonlar.
  • Seçenek B RFID Sadakati: Fiziksel turnike veya RFID kart yoklamasından gelen saat sınırlarına (08:40 / 08:59 / 12:00 / 14:30) tam uyum sağlayarak geç kalan veya yarım gün gelen öğrencileri otomatik yönetir.
  • Çevrimdışı Kuyruk (Offline Queue): Okul interneti kesilse bile ders aksamaz; verilen tüm söz hakları tarayıcıda birikir, internet geldiğinde otomatik Google Sheets'e aktarılır.

2. ⚡ Google Apps Script Arka Plan Motoru (Kod_v16.gs)

  • 5 Dakikalık CacheService Önbellek: Sayfa yenilendiğinde Google E-Tablo'yu gereksiz yere yormaz; verileri LOG_VERILERI_V16 önbelleğinde tutarak anında döner.
  • 30.000 Satırda 0.2sn Log İşleme: Log sayfasını tek doğruluk kaynağı (Single Source of Truth) olarak kabul eder; append-only iptal kayıtlarını saniyeler içinde süzer.
  • getLogBaslikHaritasi ile Esnek Başlık Desteği: Tablonuzdaki sütunların yerleri değişse veya çift başlıklı olsa bile başlıkları otomatik tanır ve veri kaybını önler.

3. 📊 8 Sekmeli Yönetim ve Analiz Paneli (Index_v12.html)

  • Canlı Katılım Göstergesi: Canlı E-Tablo (35 Öğrenci · 8 Gün · 144 Söz) şeklinde gerçek zamanlı katılım hacmi.
  • Bireysel Öğrenci Karnesi: Öğrencinin ders bazlı katılım yüzdesini ve sınıf ortalamasına göre konumunu gösteren A4 çıktı.
  • Tek Tıkla Veli WhatsApp Mektubu: Velinin telefonuna doğrudan gidebilecek, çocuğun güçlü yönlerini vurgulayan nezaketli iletişim şablonları.
  • 10sn Güvenlik Ağı: Yavaş internet bağlantılarında beyaz ekran donmasını önleyen yükleme animasyonu ve kurtarma mekanizması.

🔧 Kurulum / Entegrasyon Adımları

  1. Google Drive üzerinde yeni bir Google E-Tablo açın.
  2. Üst menüden Uzantılar > Apps Script bölümüne girin.
  3. Editördeki varsayılan kodları silip Kod_v16.gs dosyasının içeriğini yapıştırın ve kaydedin.
  4. Dağıt > Yeni dağıtım > Web uygulaması adımlarını izleyin:
  5. Şu kullanıcı olarak çalıştır: Ben
  6. Erişimi olanlar: Herkes
  7. Alınan Web Uygulaması URL'sini kopyalayın.
  8. Sinif_Katilim_Sistemi_v20.html ve Index_v12.html dosyalarındaki BURAYA_GOOGLE_APPS_SCRIPT_WEB_APP_URL_GIRIN alanına yapıştırın (veya tarayıcıda adres sonuna ?gas_url=URL ekleyerek anında çalıştırın).

📁 Proje Dosya Yapısı

Dosya Tür Açıklama
Sinif_Katilim_Sistemi_v20.html Akıllı Tahta HTML K27 Katı Makas kura motoru, 68px dev butonlar, PiP ve RFID Seçenek B uyumu.
Index_v12.html Yönetim Paneli HTML 8 sekmeli karne, veli WhatsApp mektupları ve devamsızlık analiz merkezi.
Kod_v16.gs Apps Script (Sunucu) 5dk CacheService, 0.2sn log motoru ve esnek sütun haritası.