OkulUp Yoklama Sistemi

Proje: OkulUp · Hub: OkulUp — Domain

Yoklama Sistemi

Statüsler

Statü	Türkçe	Renk
present	MEVCUT	22C55E (yeşil)
absent	YOK	DC2626 (kırmızı)
late	GEÇ KALDI	F59E0B (turuncu)
excused	İZİNLİ	2563EB (mavi)

Veri Modeli

Attendance:
- school_id, class_id, student_id, teacher_id
- attendance_date (YYYY-MM-DD)
- status: AttendanceStatus
- check_in_time, note, parent_notified_at

Özellikler

• Bulk entry: BulkAttendanceRequest — sınıfın tamamını tek seferde girebilir
• Bireysel: CreateAttendanceRequest — tekil öğrenci
• Güncelleme: UpdateAttendanceRequest — status, check_in_time, note
• ClassAttendanceResponse — sınıf yoklama response’unda recorded + missing öğrenciler

Raporlama

AttendanceReport:

• group_by: 'summary' | 'student' | 'day'
• statistics: present/absent/late/excused sayıları + attendance_rate
• students: öğrenci bazlı breakdown (opsiyonel)
• daily_breakdown: günlük breakdown (opsiyonel)

Dashboard İpuçları

Teacher dashboard’unda pending_actions: [{ type: 'attendance', class_id }] — bugün yoklama alınmamış sınıflar listesi. “Bugün yoklama alındı mı?” today_attendance_taken flag’ı ile kontrol ediliyor.

Yetki

• Görüntüleme (attendance.view): tüm roller, attendance_reports feature flag
• Kaydetme (attendance.record): STAFF (admin/manager/teacher)

Related

• permission-system — attendance permission’ları
• user-roles — teacher scope (kendi sınıfları)