Ana içeriğe geç

🎲 Hermes Sınıf İçi Katılım ve Takip Sistemi

Hermes Katılım Sistemi, sınıf içi parmak kaldırma ve söz hakkı dağıtımını şansa bırakmayan, öğrencilerin derse katılımını 3'lü Adalet Algoritması ile dengeleyen, Google E-Tablolar (Sheets) ve Google Apps Script (GAS) ile senkronize çalışan modern bir akıllı tahta uygulamasıdır.

Tek Dosyalı Web Uygulaması & Tam Çevrimdışı / Hibrit Desteği

Hermes, tarayıcıda tek bir HTML dosyası (Sinif_Katilim_Sistemi_v15.html) olarak çalışır. İster çevrimdışı (yerel localStorage tabanlı), ister Google Sheets bulut veritabanına bağlı olarak çalıştırılabilir.

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

  • Sınıf Katılım Sistemi v15 (Canlı Çalıştır)

    Tek tıkla tarayıcıda açın, örnek öğrenci sınıfı ve kura motorunu hemen deneyin.

    Canlı Uygulamayı Aç (v15) HTML İndir

  • Haftalık Ders Programı Görünümü

    Sınıfın haftalık ders ve etüt saatlerini şık bir dijital pano olarak sunar.

    Programı Canlı Aç HTML İndir

  • Google Apps Script Arka Plan Kodu (Kod_v9.gs)

    E-Tablo sayfaları, log kaydı ve artımlı günlük özet (checkpoint) motorunu içerir.

    Kod_v9.gs İndir

  • Örnek Haftalık Program CSV

    Ders saatleri, oturumlar ve ders kalemlerini içeren şablon CSV dosyası.

    Örnek CSV İndir

⚖️ 3'lü Adalet Kalkanı Algoritması

Hermes, rastgele bir zar atma aracı değildir. Sınıftaki her öğrencinin eşit ve adil biçimde derse dahil olmasını sağlamak için üç katmanlı bir koruma uygular:

flowchart TD
    A[🎯 Kura Talebi] --> B{Öğrenci Durumu?}
    B -->|Devamsız / Yok| C[🛑 Havuzdan Hariç Tut]
    B -->|Muaf / Raporlu| C
    B -->|Aktif Katılımcı| D[📊 Ağırlıklı Puan Kontrolü]
    D --> E[🛡️ 1. Devamsızlık Telafisi]
    E --> F[🛡️ 2. Yeni Kayıt / Etüt Eşitlemesi]
    F --> G[🛡️ 3. Maksimum Makas Tavan Koruma]
    G --> H[🏆 En Az Söz Alanlar Arasından Adaletli Seçim]
  1. Devamsız Gün Telafisi: Öğrenci okula gelmediği günlerde diğer öğrenciler söz aldığında aradaki makas açılmaz. Sisteme dönüşünde sanal denge puanı uygulanır.
  2. Yeni Kayıt / Etüt Başlangıç Eşitlemesi: Sınıfa sonradan katılan veya belirli bir etüt dersini yeni almaya başlayan öğrenciler doğrudan sınıf ortalamasından başlatılır.
  3. Maksimum Makas Tavan Koruması: Sınıfın en çok kalkan öğrencisi ile en az kalkan öğrencisi arasındaki fark belirlenen tavanı (örn. 2 puan) geçemez. En geride kalan öğrencilere kura motorunda öncelik verilir.

🖥️ Arayüz Özellikleri ve Akıllı Tahta Uyumu

  • Picture-in-Picture (PiP) Desteği: Öğretmen YouTube'da video izletirken, Morpa Kampüs veya Okulistik gibi eğitim portallarında ders işlerken Hermes penceresini küçük bir yüzen kutu (PiP) olarak ekranın köşesine sabitleyebilir.
  • Yatay ve Dikey Görünüm: Akıllı tahtalarda ekranın yanına veya altına yerleşecek şekilde tek tıkla yatay/dikey formata geçiş yapabilir.
  • Hızlı Pas ve Puan: Öğrenci doğru cevap verdiğinde +1 Katılım, cevapsız kaldığında veya hakkını devrettiğinde Pas tuşuna basılarak kayıt tutulur.
  • Ders Bazlı Kapsam: Türkçe, Matematik, Fen Bilimleri gibi ana derslerin yanı sıra yalnızca belirli öğrencilerin katıldığı Destek / Etüt derslerini otomatik filtreler.

🛠️ Adım Adım Google Sheets + Apps Script Kurulumu

Kendi Google E-Tablonuzu arka plan veritabanı olarak kullanmak için şu adımları takip edin:

1. Yeni Bir Google E-Tablo Oluşturun

  1. Google Drive'da yeni bir Google E-Tablo (Spreadsheet) açın.
  2. Üst menüden Uzantılar (Extensions) > Apps Script yolunu izleyin.

2. Kodu Ekleyin

  1. Açılan script editöründeki mevcut Code.gs içeriğini silin.
  2. Yukarıdan indirdiğiniz Kod_v9.gs dosyasının tüm içeriğini yapıştırın.
  3. Projeyi kaydedin (Ctrl + S).

3. Web Uygulaması Olarak Dağıtın (Deploy)

  1. Sağ üstteki mavi Dağıt (Deploy) > Yeni dağıtım (New deployment) butonuna tıklayın.
  2. Tür olarak Web uygulaması (Web app) seçin.
  3. Ayarları şu şekilde yapın:
  4. Açıklama: Hermes Katılım API
  5. Farklı yürüt (Execute as): Ben (Hesabınız)
  6. Erişimi olanlar (Who has access): Herkes (Anyone) (Veri gönderebilmesi için gereklidir)
  7. Dağıt butonuna basın ve Google hesabınız için istenen yetkileri onaylayın.
  8. Size verilen Web Uygulaması URL'sini (Web app URL) kopyalayın (https://script.google.com/macros/s/.../exec).

4. HTML Arayüzüne Bağlama

İndirdiğiniz Sinif_Katilim_Sistemi_v15.html dosyasını tarayıcınızda açarken iki yöntemle bağlayabilirsiniz:

  • 1. Kolay Yöntem (URL Parametresi ile): Tarayıcınızda dosyayı açarken adresin sonuna ?gas_url=SİZİN_URLNİZ ekleyin: 
    file:///.../Sinif_Katilim_Sistemi_v15.html?gas_url=https://script.google.com/macros/s/AKfy.../exec
  • 2. Kalıcı Yöntem (Dosya İçinde Düzenleme): Sinif_Katilim_Sistemi_v15.html dosyasını herhangi bir metin düzenleyiciyle açıp en baştaki VARSAYILAN_GAS_URL satırına kendi URL'nizi yapıştırın: 
    const VARSAYILAN_GAS_URL = 'https://script.google.com/macros/s/BURAYA_KENDİ_URLNİZİ_YAZIN/exec';

Artık akıllı tahtanızda veya dizüstü bilgisayarınızda yaptığınız her kura ve katılım puanı anlık olarak Google Sheets tablonuza yazılacaktır!