QR Kod Yoklama SistemiQR code attendance system
Fırat Üniversitesi'nde derslerde yoklama artık QR kodla alınıyor. Öğrenci kodu üniversitenin uygulaması Fırat Mobil'den okutuyor. Sistemin yönetim panelini, sunucu tarafını ve Fırat Mobil'in kullandığı API'leri ben yazdım. Şubat 2026'dan beri kullanımda, bakımını ve yeni özelliklerini de ben yapıyorum.
Fırat University now takes attendance in class with a QR code. Students scan it in Fırat Mobil, the university's app. I wrote the admin panel, the back end and the APIs Fırat Mobil uses. It has been in use since February 2026, and I still maintain it and add features.
- RolümMy role
- Web paneli, sunucu tarafı ve Fırat Mobil'in kullandığı API'lerWeb panel, back end and the APIs Fırat Mobil uses
- EkipTeam
- Fırat Mobil'in ekranlarını mobil ekip yazdı, gerisini tek başımaThe mobile team built Fırat Mobil's screens; the rest was me
- DönemWhen
- Şubat 2026'dan beriSince February 2026
- DurumStatus
- qr.firat.edu.tr
- ÖnceBefore
- İmza listesi sınıfta elden ele dolaşıyordu. Gelmeyen arkadaşının yerine imza atmak kolaydı, listeyi sonradan saymak da ayrı bir işti.A sign-in sheet went round the room. It was easy to sign for a friend who wasn't there, and counting the sheet afterwards took time.
- ŞimdiNow
- Hoca QR kodu tahtaya yansıtıyor, kod 10 saniyede bir yenileniyor. Öğrenci kendi kayıtlı telefonundan Fırat Mobil ile okutuyor ve listeye ekleniyor.The lecturer puts the QR code on screen and it renews every 10 seconds. Students scan it with Fırat Mobil on their own registered phone and get added to the list.
Öğrenci nasıl katılıyorHow a student checks in
- Hoca yoklamayı başlatıyor. QR tahtaya yansıyor ve 10 saniyede bir yenileniyor.The lecturer starts attendance. The QR code goes on screen and renews every 10 seconds.
- Öğrenci Fırat Mobil'i açıp uygulamadaki okuyucuyla kodu okutuyor.The student opens Fırat Mobil and scans the code with the reader inside the app.
- API kodun süresi geçmiş mi, öğrenci bu derse kayıtlı mı, telefon onun kayıtlı telefonu mu diye kontrol ediyor.The API checks that the code is still valid, the student is enrolled in the course, and the phone is the one registered to them.
- Sorun yoksa öğrenci hocanın ekranındaki listeye ekleniyor.If all is well, the student is added to the list on the lecturer's screen.
Ekran görüntülerinde demo veri var, isimler gerçek kişilere ait değil.The screenshots use demo data, so the names aren't real people.
SorunThe problem
Ekrana QR kod koymak işin kolay kısmıydı. Asıl uğraştıran, kodun fotoğrafını çekip WhatsApp grubuna atan ya da cebinde arkadaşlarının telefonunu taşıyan öğrenciydi. Bunu engelleyemesek sistemin kâğıt listeden pek farkı olmayacaktı.
Showing a QR code on a screen was the easy part. The real work was dealing with students who take a photo of it and post it in a group chat, or who bring their friends' phones to class. Without stopping that, the system wouldn't be much better than the paper sheet.
Ayrıca öğrenci ve ders bilgileri öğrenci işleri sisteminde (OBS) tutuluyor, giriş de üniversitenin ortak oturum açma sistemiyle yapılıyor. Yeni sistemin ikisiyle de çalışması gerekiyordu.
Student and course data also live in the university's student information system, and everyone logs in through the university's single sign-on, so the new system had to work with both.
Ne yaptımWhat I did
- QR kod 10 saniyede bir yenileniyor. Biri fotoğrafını çekip gruba atsa bile, arkadaşı açıp okutana kadar kodun süresi geçmiş oluyor.
- Öğrenci sisteme tek telefondan girebiliyor. İlk girişte telefonu hesabına bağlanıyor, başka telefondan giriş yapamıyor. Telefonunu değiştirirse talep açıyor, yönetici onaylıyor.
- Fırat Mobil için REST API'leri yazdım: üniversite hesabıyla giriş, cihaz kaydı, cihaz değişikliği talebi, ders listesi ve QR doğrulama.
- Öğrenci ve ders listeleri her gün OBS'ten otomatik çekiliyor, elle liste yüklemek gerekmiyor.
- Öğrenciler ve hocalar webde de mobilde de üniversite hesaplarıyla giriş yapıyor.
- Tıp Fakültesi dönem yerine ders kurullarıyla çalışıyor. Onların kurallarına göre işleyen ayrı bir modül ve iki yönetim paneli yazdım.
- Canlı veriyi etkileyen her değişikliği önce canlı veritabanının bir kopyasında deniyorum.
- The QR code renews every 10 seconds. If someone posts a photo of it in a group chat, it has usually expired before a friend can scan it.
- Students can only sign in from one phone. The phone is linked to their account the first time they sign in, and other phones can't sign in. If they change phones, they send a request and an admin approves it.
- I wrote the REST APIs for Fırat Mobil: university sign-in, device registration, device change requests, course lists and QR verification.
- Student and course lists are pulled from the student information system every day, so nobody has to upload them by hand.
- Students and lecturers sign in with their university account on both web and mobile.
- The medical school uses course boards instead of semesters. I wrote a separate module that follows their rules, and two admin panels for them.
- I try every change that affects live data on a copy of the production database first.
Bugüne kadarSo far
- yoklama kaydı, 5.000'den fazla öğrencidencheck-ins from more than 5,000 students
- 100.000+100,000+
- yoklama alındısessions recorded
- 1.100+1,100+
- derste kullanıldıcourses use it
- 377+
- öğretim üyesi yoklama aldılecturers have taken attendance
- 180+
- öğrenci telefonunu kaydettistudents registered a phone
- 6.400+6,400+
- kullanıcı ve 16.000'den fazla ders OBS'ten otomatik geliyorusers and 16,000+ courses synced from the student information system
- 56.000+56,000+
Teknik ayrıntılarTechnical detailsAraçlar ve nasıl kurulduğuTools and how it's built
- Laravel 10
- PHP 8.1
- MySQL
- Blade
- Bootstrap 5
- Sanctum
- SOAP/WSDL
- CAS
- Queue
- OBS SOAP servisleriyle kuyruk tabanlı senkronizasyon; tam senkronizasyon zamanlanmış işlerle parçalara bölünüyor.
- CAS SSO web paneline doğrudan, mobil uygulamaya Sanctum token'ı üzerinden bağlı. Mobil ekip için REST API tasarladım.
- Dönen QR token, cihaz kaydı ve yalnızca kayıtlı cihazdan oturum açma birlikte çalışıyor; cihaz değişikliği yönetici onaylı bir talep akışından geçiyor.
- Tıp Fakültesi modülü: idempotent Excel içe aktarma, OBS'ten paket kodu çözümleme, haftalık ders saati kredisi ve lab-teori bağı gibi fakülteye özel kurallar.
- Migration'lar canlı veritabanının kopyasında prova edilip öyle yayına alınıyor.
- Queue-based sync with the student information system's SOAP services; full syncs are split into scheduled jobs.
- CAS SSO on the web panel directly and on mobile through Sanctum tokens. I designed the REST API for the mobile team.
- A rotating QR token, device registration and registered-device-only sign-in work together; device changes go through an admin-approved request flow.
- Medical school module: idempotent Excel import, package code resolution from the student information system, and faculty rules such as weekly credit hours and lab–theory pairing.
- Migrations are rehearsed on a copy of the production database before release.