Proje: OkulUp API · Hub: OkulUp API — Domain
OkulUp API — Akademik Özet Raporu
GET /students/{student}/academic-summary — feature:academic_reports middleware ile korunur.
Döndürdüğü Bloklar
Tüm bloklar opsiyonel — include_* query parametreleri ile kontrol edilir.
Hiç include_* gönderilmezse → tüm bloklar gelir.
| Block | Query Param | İçerik |
|---|---|---|
| attendance | include_attendance | present/absent/late/excused sayıları + attendance_rate % |
| payments | include_payments | pending_total, overdue_total, paid_total, count’lar |
| tracking_summary | include_tracking | meal_entries, sleep_entries, mood_entries, activity_entries |
| assignments | include_assignments | total, submitted, pending, late sayıları |
| recent_assignments | (assignments ile gelir) | Son 10 ödev: title, due_date, status, grade |
Öğretmen Ödeme Görünürlüğü
Öğretmen raporu istediğinde ödeme bloğu allow_teacher_payment_visibility policy’e göre gelir.
Default: false → öğretmene 0 dönülür (veri gizlenir, hata vermez).
Export
GET /students/{student}/academic-summary/export → format=csv parametresiyle CSV export.
CSV response application/json içinde base64 değil, raw CSV string olarak döner.
Date Filtering
date_from + date_to parametreleri — tüm bloklar bu aralığa göre filtrelenir.
Feature Flag
feature:academic_reports — varsayılan ON.
Related
- odev-akisi — assignment summary kaynağı
- gunluk-takip-modulu — tracking summary kaynağı
- rol-ve-yetki-mimarisi — canAccessStudent kullanımı