Ana içeriğe geç

📚 ODS V3 — Öğrenci Değerlendirme ve Karne Sistemi

ODS V3 (Öğrenci Değerlendirme Sistemi); ilkokul ve ortaokul öğretmenlerinin sınav kâğıtlarını dijitalleştirip saniyeler içinde puanlamasını, kazanım analizleri çıkarmasını ve MEB uyumlu renkli A4 Veli Geri Bildirim Karnesi üretmesini sağlayan açık kaynaklı, bağımsız ve yerel bir masaüstü/web uygulamasıdır.

Veri Gizliliği ve Çevrimdışı Çalışma

ODS V3 verilerinizi hiçbir uzak bulut sunucusuna göndermez. Tüm SQLite veritabanı, sınav kâğıtları ve öğrenci kayıtları yerel bilgisayarınızda (VERI/ klasöründe) şifreli veya izole olarak saklanır. İnternet bağlantısı olmadan da tam kapasite çalışır.

🎯 Temel Özellikler

flowchart LR
    A[📄 Taranmış Kâğıtlar / PDF] --> B[📐 Şablon & Kırpma]
    B --> C[📝 Odak Modu ile Puanlama]
    C --> D[📊 Kazanım Analizi]
    D --> E[🖨️ MEB Uyumlu A4 Veli Karnesi]

1. 📐 Akıllı Şablon & Soru Koordinat Sistemi

  • Öğretmenin hazırladığı tek bir master cevap anahtarı veya sınav kâğıdı taranır.
  • Görsel arayüz üzerinden fare ile sürükle-bırak yapılarak her sorunun kâğıt üzerindeki koordinatları (ROI) belirlenir.
  • Her soruya kazanım kodu, soru metni ve soru puanı (barem) atanır.

2. 📝 Odak Modu (Hızlı Kâğıt Okuma Motoru)

  • Sınıfın tüm kâğıtları toplu PDF veya fotoğraf olarak yüklenir.
  • Sistem her kâğıdı öğrenciyle eşleştirir ve öğretmene sadece o an okunan sorunun kırpılmış görüntüsünü gösterir.
  • Klavyeden tek tuşla (tam puan, sıfır veya barem basamakları) puanlama yapılır.
  • Saatler süren kâğıt okuma süreci 15-20 dakikaya iner.

3. 📊 Otomatik Sınıf ve Kazanım Analizleri

  • Soru bazlı ve kazanım bazlı sınıf başarı yüzdeleri anında hesaplanır.
  • Hangi kazanımın sınıfta tam anlaşılamadığı, hangi soruların zorlayıcı olduğu renkli ısı haritaları ve grafiklerle sunulur.

4. 🖨️ MEB Uyumlu Renkli A4 Veli Karnesi Çıktısı

  • Her öğrenci için tek tıkla A4 formatında veli bilgilendirme karnesi üretilir.
  • Öğrencinin aldığı puan, sınıf ortalaması, her ders/kazanımdaki gelişim düzeyi ve öğretmenin öğrenciye özel rehberlik notları şık bir tasarımda yer alır.
  • Tek sayfada yazdırma ve PDF olarak kaydetme desteği bulunur.

🏗️ Modül Mimarisi

Uygulama modern Streamlit çekirdeği ve özel CSS tasarım sistemi üzerine kurulmuştur:

Modül Menü Adı Görev ve İşlev
v_anasayfa 🏠 Ana Sayfa Sınıfın okuma ilerleme çubuğu, son sınavlar, genel başarı özeti.
v_sinifyonetimi 👥 Sınıf Yönetimi Öğrenci listesi, okul numaraları, toplu Excel/CSV içe aktarma.
v_tanimlamalar 📋 Tanımlamalar Kurum adı, sınıf şubesi, dersler ve MEB müfredat kazanım havuzu.
v_sablon 📐 Şablon Master kâğıt yükleme, soru kutucuklarını çizme, barem belirleme.
v_odakmodu 📝 Odak Modu Soru odaklı akıcı okuma ekranı, klavye kısayolları ile puan girişi.
v_raporlar 📊 Raporlar Sınıf başarı grafikleri, karne önizleme ve toplu A4 yazdırma.

💻 Kurulum ve Çalıştırma Rehberi

ODS V3; Linux (Pardus, Ubuntu, Debian, CachyOS, Arch) ve Windows (10/11) için tek tıkla çalışacak başlatma betikleriyle hazırlanmıştır.

🐧 Linux (Pardus, Ubuntu, Debian, Arch)

  1. İndirdiğiniz kaynak paketi bir klasöre çıkarın: 
    unzip ods_v3_kaynak_paket.zip -d ods_v3
cd ods_v3
  2. PDF kâğıt taramalarını görselleştirmek için sisteminize poppler-utils aracını kurun:
  3. Pardus / Debian / Ubuntu: 
    sudo apt update && sudo apt install -y poppler-utils python3-venv
  4. Arch / CachyOS / Manjaro: 
    sudo pacman -S poppler python
  5. Tek komutla başlatın: 
    ./BASLAT_LINUX.sh
    İlk çalıştırmada otomatik olarak izole bir Python sanal ortamı (venv) kurulur, gerekli kütüphaneler yüklenir ve tarayıcınızda http://localhost:8501 adresi açılır.
  6. Masaüstü Simgesi Eklemek İçin: 
    ./KISAYOL_OLUSTUR_LINUX.sh
  7. Uygulamayı Kapatmak İçin: 
    ./DURDUR_LINUX.sh

🪟 Windows (10 / 11)

  1. İndirdiğiniz ods_v3_kaynak_paket.zip dosyasını sağ tıklayıp bir klasöre ayıklayın.
  2. Bilgisayarınızda Python 3.10+ kurulu olduğundan emin olun ("Add Python to PATH" seçeneğini işaretlemeyi unutmayın).
  3. Klasördeki BASLAT_WINDOWS.bat dosyasına çift tıklayın. Sistem otomatik olarak ortamı hazırlar ve varsayılan tarayıcınızı açar.
  4. İşi bitirip portu temiz kapatmak için DURDUR_WINDOWS.bat dosyasına çift tıklayın.
  5. İsteğe bağlı olarak KISAYOL_OLUSTUR_WINDOWS.bat ile masaüstünüze kısayol oluşturabilirsiniz.

📥 İndirilebilir Kaynak Paketi

ODS V3'ün kaynak kodlarını, başlatma ve durdurma betiklerini ve CSS bileşenlerini içeren temiz geliştirici paketini aşağıdaki bağlantıdan indirebilirsiniz:

  • ODS V3 Kaynak Kod Paketi (ZIP)

    Python kaynak kodları, Streamlit UI bileşenleri, Linux bash ve Windows bat başlatıcıları içerir.

    Paketi İndir (.zip)

Paket İçeriği

  • app/: Tüm Streamlit Python kaynak dosyaları (app.py, veritabanı motoru, UI şablonları, CSS tasarım sistemi).
  • BASLAT_LINUX.sh & BASLAT_WINDOWS.bat: İzole sanal ortam kurucu ve otomatik başlatıcılar.
  • DURDUR_LINUX.sh & DURDUR_WINDOWS.bat: Bellek sızıntısı ve açık port bırakmayan temiz kapatıcılar.
  • KISAYOL_OLUSTUR_*: Sistem menüsü ve masaüstü entegrasyon betikleri.
  • BENI_OKU.md: Detaylı yerel kullanım kılavuzu.