Sanal Yoklama Sistemi

Nallıhan Meslek Yüksekokulu kız öğrenci yurdunda kâğıt üzerinde yürütülen akşam yoklamasını dijital ortama taşıyan web tabanlı uygulama. Yurt görevlisinin bilgisayarı ekranda belirli aralıklarla yenilenen dinamik bir QR kod gösterir; öğrenci kendi telefonuyla bu kodu okutur, açılan formda okul numarası ile ad soyadını yazar ve bilgiler yurt kayıtlarıyla eşleşirse yoklamada "mevcut" olarak işaretlenir.

Öğrenciler sisteme giriş yapmaz. Öğrenci hesapları parolasızdır; kimlik, yoklama anında girilen okul numarası + ad soyad ikilisiyle doğrulanır. Sisteme yalnızca yurt görevlisi ve yönetici giriş yapar.

---

1. Hızlı Başlangıç (Windows)

cd C:\Users\msipc\Desktop\sanalyoklama

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

copy .env.example .env          :: isteğe bağlı, ayarları düzenlemek için

set FLASK_APP=run.py
flask init-db                   :: tabloları oluşturur + yönetici hesabı açar
python seed.py                  :: (isteğe bağlı) örnek öğrenci ve yoklama verisi

python run.py

Tarayıcıdan http://localhost:5000 adresini açın.

Kolaylık olması için kurulum.bat (ilk kurulum) ve baslat.bat (çalıştırma) dosyaları da hazırlanmıştır; çift tıklamanız yeterlidir.

Varsayılan hesaplar

Rol	Kullanıcı adı	Parola
Yönetici	admin	Admin1234!
Yurt görevlisi	gorevli	Gorevli1234! (seed.py ile)
Öğrenci	—	Giriş yapmaz (parolasız kayıt)

Gerçek kullanımda bu parolaları ilk girişten sonra mutlaka değiştirin (Profil > Parola Değiştir veya flask reset-password <kullanıcı> <parola>).

Linux / macOS

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
export FLASK_APP=run.py
flask init-db
python seed.py
python run.py

---

2. Kullanım Akışı

0. Yönetici öğrencileri sisteme tanıtır: Kullanıcılar > Yeni Öğrenci ekranından okul numarası ve ad soyad girilir. Çok sayıda öğrenci için Listeyle Ekle ekranına her satıra bir öğrenci yazılır (202300101 ; Ayşe Yılmaz ; 101).
1. Yurt görevlisi Yoklama panelinden gün, saat aralığı ve QR yenileme süresini seçip oturumu başlatır.
2. Açılan canlı ekranda QR kod 10–60 saniyede bir yenilenir; altında aynı kodun 6 haneli metin karşılığı ve kapanışa kalan süre görünür. Sağdaki liste okutma yapıldıkça kendiliğinden güncellenir.
3. Öğrenci telefonunun kamera uygulamasıyla ekrandaki QR kodu okutur. Açılan sayfa kodu doğrular ve okul numarası ile ad soyad ister. Bilgiler kayıtla eşleşirse yoklama "Mevcut" olarak işlenir; eşleşmezse okutma reddedilir ve deneme günlüğe yazılır. Öğrencinin giriş yapması gerekmez.
4. Oturum, tanımlanan bitiş saatinde otomatik kapanır; okutma yapmamış öğrenciler "Yok" olarak tamamlanır.
5. Görevli; izinli, raporlu veya geç gelen öğrencileri manuel olarak düzenleyip açıklama ekleyebilir. Her düzenleme günlüğe yazılır.
6. Yönetici, istatistik panelinden devamsızlık oranlarını grafiklerle izler; dönemlik raporları Excel ve PDF olarak indirir.

Okutma bileti (kod süresi hakkında)

QR kod 10–60 saniyede bir yenilendiği için, öğrenci formu doldururken koddaki süre dolar. Bu yüzden kod yalnızca QR'ın açtığı ilk istekte doğrulanır; ardından forma, okutan cihaza bağlı ve kısa ömürlü (varsayılan 3 dakika, SCAN_TICKET_MAX_AGE) imzalı bir okutma bileti verilir. Form bu biletle gönderilir. Bilet başka bir telefona iletilirse çerez eşleşmeyeceği için geçersiz sayılır.

Yönetici ekranından yapılabilenler

Kullanıcılar sayfasında (yalnızca yönetici rolü):

İşlem	Nasıl
Öğrenci ekleme	Yeni Öğrenci — okul numarası + ad soyad (parola yok)
Toplu öğrenci ekleme	Listeyle Ekle — her satıra numara ; ad soyad ; oda
Öğrenci düzenleme / silme	Satırdaki kalem ve çöp kutusu düğmeleri
Görevli / yönetici ekleme	Yeni Görevli/Yönetici — kullanıcı adı + parola
Parola sıfırlama	Satırdaki kilit düğmesi (görevli ve yönetici hesapları)
Hesabı pasife alma	Güç düğmesi — kayıt silinmeden yoklama dışı bırakılır
Kendi parolasını değiştirme	Sağ üst menü → Parola Değiştir

Silme kuralları: öğrenci silindiğinde o öğrenciye ait tüm yoklama kayıtları da silinir (onay sorulur). Yoklama oturumu veya izin kaydı açmış bir görevli silinemez — geçmiş kayıtların sahibi kaybolmasın diye; bunun yerine pasife alınır. Yöneticinin kendi hesabını ve sistemdeki son yönetici hesabını silmesi engellidir.

Kamera çalışmazsa

Öğrenci, telefonun kendi kamera uygulamasını kullandığı için tarayıcı kamera izni gerekmez. Kamera hiç okumuyorsa /yoklama adresinden ekrandaki 6 haneli kod, okul numarası ve ad soyad tek formda girilebilir (kod yenilenmeden gönderilmelidir).

Yerel ağda test: QR'daki adres

QR kodun içine, görevli panelinin açıldığı adres yazılır. Panel http://localhost:5000 ile açılırsa QR da localhost gösterir ve telefon okuyamaz. Yerel ağda test ederken paneli bilgisayarın ağ adresiyle açın (http://192.168.x.x:5000) veya .env dosyasına PUBLIC_BASE_URL=http://192.168.x.x:5000 yazın. Yayına alındığında bu ayar gerekmez; kendi alan adı otomatik kullanılır.

---

以上為 README 的開頭部分。其餘內容請閱讀原文。 檢視完整 README ↗