Ana içeriğe geç

📚 Kitap Tavsiye Kürsüsü — Akran Destekli Okuma ve Sunum Portalı

Kitap Tavsiye Kürsüsü, öğrencilerin okudukları kitapları akranlarına tanıtmasını sağlayan, akıllı tahtada tam ekran Sahne / Sunum Modu ile interaktif gösterim sunan, sunucusuz (serverless) mimariye sahip modern bir web uygulamasıdır. Google E-Tablolar (veritabanı), Google Drive (kapak deposu) ve Google Apps Script (API) ile sıfır maliyetle çalışır.

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

  • Kitap Tavsiye Kürsüsü (Canlı Portalı Aç)

    Tek tıkla tarayıcınızda açın. Sınıf seviyesi süzgeçlerini, mini hikaye haritasını ve Sahne Modunu hemen test edin.

    Canlı Uygulamayı Aç HTML Dosyasını İndir

  • Google Apps Script API Kodu (Code.gs)

    Google E-Tablo ve Google Drive ile tam entegre çalışan, görsel yükleme ve veri okuma/yazma motoru.

    Code.gs İndir

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

Geleneksel Okuma Takibindeki Pedagojik Çıkmaz

  • Zoraki Kitap Özetlerinin Okuma Zevkini Öldürmesi: İlkokul ve ortaokulda öğrencilere verilen "1 sayfa deftere kitap özeti çıkarma" ödevleri, okumayı keşif dolu bir zevk olmaktan çıkarıp bitirilmesi gereken kuru bir angaryaya dönüştürür. Çocuklar kitaptan tat almak yerine sayfaları saymaya başlar.
  • Öğretmen Dayatmasına Karşı Akran Güveni: Çocuklar bir öğretmenin veya ebeveynin "Bu klasiği mutlaka okumalısın" yönlendirmesine karşı doğal bir direnç geliştirir. Buna karşın sıra arkadaşının "Bu kitapta kahkaha krizine girdim, Tesla'nın deney yaptığı bölüm efsaneydi!" şeklindeki samimi tavsiyesine koşulsuz güvenir ve o kitabı okumak için kütüphanede sıraya girer.
  • Dağınık ve Yüzeysel Değerlendirme: Öğrenciye "Kitap nasıldı?" diye sorulduğunda genellikle sadece "Çok güzeldi" cevabı alınır. Çocuğun olay örgüsünü, mekan-zaman algısını ve ana çatışmayı zihninde yapılandırmasını sağlayacak pratik bir iskelet bulunmaz.

Pedagojik ve Teknolojik Çözüm

  • 🗺️ 4 Soruluk Mini Hikaye Haritası: Çocukları uzun paragraflarla boğmadan eleştirel düşünmeye yönelten 4 temel odak soru:
    1. 🦸‍♂️ Ana Kahraman Kim? (Karakter analizi)
    2. 🗺️ Olay Nerede / Ne Zaman Geçiyor? (Mekan ve atmosfer algısı)
    3. ⚡ Kahramanların Karşılaştığı Sorun / Macera Neydi? (Olay örgüsü ve ana çatışma)
    4. 🌟 En Sevdiğin / En Güldüğün An Neydi? (Duygusal bağ ve akılda kalıcılık)
  • 🎤 Akıllı Tahtada Dev Sahne / Sunum Modu: Öğrenci kürsüye çıktığında akıllı tahta tek tıkla dev sunum moduna geçer. Altın yıldızlar (⭐⭐⭐⭐⭐), büyük kitap kapağı ve hikaye haritası kutuları ekrana yansır. Öğrenci bir eleştirmen ve konuşmacı özgüveniyle kitabını arkadaşlarına tanıtır.
  • 📸 Tek Tıkla Kamera & Kapak Optimizasyonu: Çocuklar telefon veya tabletten kitabın kapağını doğrudan çeker. Tarayıcı görseli anında optimize eder (~35-40 KB) ve Google Drive klasörüne kaydeder. Fotoğraf çekilmediğinde ise sistem otomatik renkli sanal bir kapak üretir.
  • 🔐 PIN Korumalı Öğretmen Konsolu (2291): Öğretmen sağ üstteki kilit ikonuna basıp 2291 şifresini girdiğinde doğrudan arayüz üzerinden düzenleme ve silme yetkisine sahip olur; uygunsuz içerikler anında ayıklanabilir.

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

flowchart TD
    subgraph Kullanici ["👥 Kullanıcı Arayüzü"]
        A["Akıllı Tahta / Öğrenci Telefonu<br>(index.html)"]
        S["🎤 Sahne / Sunum Modu"]
        Y["🔐 Öğretmen Konsolu (PIN: 2291)"]
    end

    subgraph BulutServisi ["☁️ Google Apps Script (Web App)"]
        GAS["Code.gs API Katmanı<br>doGet() & doPost()"]
    end

    subgraph Depolama ["📦 Google Bulut Depolama"]
        DRIVE[("📁 Google Drive<br>Kitap_Kapaklari")]
        SHEET[("📊 Google E-Tablo<br>Sayfa1 (15 Sütun)")]
    end

    A -->|Kitap Kaydı / Kapak Görseli| GAS
    GAS -->|Base64 Görseli Kaydet| DRIVE
    GAS -->|Kayıt Ekle / Güncelle / Sil| SHEET
    SHEET -->|Kitap Listesi JSON| GAS
    GAS -->|Canlı Veri Beslemesi| A
    A --> S
    A --> Y

1. 🎤 Akıllı Tahtada Sahne ve Sunum Deneyimi

  • Kürsü Sunumu: Akıllı tahtada tarayıcıyı açıp F11 ile tam ekrana geçin. Sağ üstteki "🎤 Sahne / Sunum Modu" butonuna basın.
  • Akıcı Geçiş: Klavyenin Sağ / Sol Ok tuşlarını veya ekrandaki okları kullanarak her kitabın dev kapağını, puanını ve mini hikaye haritasını sınıfa gösterin.
  • Akran Tartışması: Öğrenci sunumunu tamamlarken sınıf arkadaşları kitabı oylayabilir veya soru sorabilir.

2. 📱 Mobil & Evden Katılım (Kamera Optimizasyonu)

  • Hafif Görsel Yükleme: Öğrenciler kendi telefonlarından veya evdeki tabletten kapağı çektiğinde, istemci tarafında otomatik sıkıştırma uygulanır (35-40 KB).
  • Yapay Zeka Alternatifi: Kamera kullanılmadığında kitap adı ve yazar bilgisine göre modern CSS degradeleriyle otomatik kapak üretilir.

3. 🔐 Yönetici ve Moderasyon Güvenliği

  • PIN Koruması (2291): Sağ üstteki kilit butonuna tıklayıp öğretmen şifresini girdiğinizde yönetim moduna geçilir.
  • Hızlı Düzeltme: Yazım hatası veya uygunsuz içerik barındıran kayıtlar tek tıkla silinebilir veya düzenlenebilir.

🔧 Kurulum / Entegrasyon Adımları

İsteyen her öğretmen aşağıdaki adımları uygulayarak 5-10 dakika içerisinde sınıfına özel sistemi devreye alabilir.

1. Adım: Google E-Tabloyu Hazırlama

  1. Google E-Tablolar adresine giderek yeni bir boş tablo oluşturun.
  2. Tablo adını örneğin Kitap_Tavsiye_Sistemi yapın.
  3. Sekme adının Sayfa1 olduğundan emin olun.
  4. 1. Satıra (Başlık Satırı) sırasıyla aşağıdaki 15 sütun başlığını eksiksiz yapıştırın:
Sütun Başlık Adı Açıklama
A1 id Benzersiz kayıt ID'si (Örn: b_12345)
B1 title Kitabın Adı
C1 author Yazarı / Yayınevi
D1 student Tavsiye Eden Öğrenci (Örn: Ayşe (4-A))
E1 grade Sınıf Seviyesi (Örn: 4. Sınıf)
F1 rating Verilen Puan (1 - 5)
G1 format İçerik Biçimi (text, video, both)
H1 videoUrl Varsa YouTube / Tanıtım Videosu Linki
I1 text Arkadaşlarına Tavsiye Cümlesi
J1 cover Kapak Görseli Kalıcı URL'si
K1 date Eklenme Tarihi (YYYY-AA-GG)
L1 hero Hikaye Haritası: Ana Kahraman
M1 place Hikaye Haritası: Mekan ve Zaman
N1 conflict Hikaye Haritası: Karşılaşılan Sorun / Macera
O1 favoriteMoment Hikaye Haritası: En Sevilen / En Güldüren An

2. Adım: Google Apps Script Kodunu Ekleyin

  1. E-Tablo menüsünden Uzantılar > Apps Script seçeneğine tıklayın.
  2. Açılan editördeki Kod.gs dosyasının içini tamamen silin.
  3. Proje klasöründeki Code.gs dosyasının içeriğini yapıştırın ve Ctrl + S ile kaydedin.

[!NOTE] Code.gs kodu, yüklenen kapak resimleri için Google Drive ana dizininizde otomatik olarak Kitap_Kapaklari isimli bir klasör oluşturur ve görselleri bu klasöre herkese açık görünüm izniyle kaydeder.

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

  1. Apps Script ekranının sağ üst köşesindeki mavi Dağıt (Deploy) > Yeni dağıtım (New deployment) butonuna tıklayın.
  2. Sol kısımdaki dişli simgesinden Web uygulaması (Web app) türünü seçin.
  3. Yapılandırma ayarlarını yapın:
    • Açıklama: Kitap Tavsiye API
    • Şu kullanıcı olarak çalıştır: Ben (kendi gmail hesabınız)
    • Erişimi olanlar: Herkes (Anyone) (Tüm öğrencilerin şifresiz giriş yapabilmesi için zorunludur)
  4. Dağıt butonuna basın. İlk kurulumda Google sizden hesap izinlerini onaylamanızı ister ("Gelişmiş > İzin ver" diyerek onaylayın).
  5. Size verilen Web Uygulaması URL'sini (https://script.google.com/macros/s/.../exec) kopyalayın.

4. Adım: Arayüz ile API Bağlantısını Kurma

  1. İndirdiğiniz index.html dosyasını bir metin düzenleyiciyle açın.
  2. Aşağıdaki satırı bularak kopyaladığınız Web Uygulaması URL'sini yapıştırın: 
    const API_URL = "https://script.google.com/macros/s/BURAYA_ALDIĞINIZ_URL_GELECEK/exec";
  3. Dosyayı kaydedin. Artık index.html dosyası doğrudan sizin Google E-Tablonuza bağlanacaktır.

📁 Proje Dosya Yapısı

Dosya Tür Açıklama
index.html Single-File Web App Sınıf filtreleri, kamera optimizasyonu, 4 soruluk mini hikaye haritası ve Sahne modu.
Code.gs Google Apps Script E-Tablo veri okuma/yazma motoru ve Google Drive resim depolama servisi.