Proje: OkulUp API · Hub: OkulUp API — Domain

OkulUp API — Ödev Akışı

Durum Makinesi

[draft] --publish--> [published] --close--> [closed]

Öğretmen POST /assignments/{id}/publish çağırdığında:

Assignment status: draft → published
Sınıftaki her öğrenci için AssignmentSubmission kaydı oluşturulur (status: pending)
Öğrencilere + velilere assignment_published bildirimi gönderilir (kuyruk job)

Status	Açıklama
`pending`	Publish ile otomatik oluşturulur
`submitted`	Öğrenci/veli zamanında teslim etti
`late`	Due date geçtikten sonra teslim
`reviewed`	Öğretmen inceledi, not verdi

Method	Path	Açıklama
GET	`/assignments`	Listele (rol bazlı filtre)
POST	`/assignments`	Oluştur (draft)
GET	`/assignments/{id}`	Detay
PUT	`/assignments/{id}`	Güncelle
POST	`/assignments/{id}/publish`	Yayınla + submissions oluştur
GET	`/assignments/{id}/submissions`	Submission listesi
POST	`/assignments/{id}/submit`	Öğrenci teslim
POST	`/assignments/{id}/parent-submit`	Veli adına teslim
POST	`/assignments/{id}/review`	Öğretmen not/feedback
POST	`/assignments/{id}/attachments`	Dosya ekle
POST	`/assignments/{id}/close`	Kapat

Oluşturma: teacher (kendi sınıfı) + admin/manager
Publish/Close/Review: AssignmentPolicy@manage (teacher of class + admin/manager)
Submit: student (kendi submission’ı)
Parent Submit: parent (çocuğu için)
Görme:
- teacher: kendi sınıfları
- student: kendi sınıflarının published ödevleri
- parent: çocuklarının sınıflarının published ödevleri

feature:assignments middleware — varsayılan OFF. Okulun school_settings.features.assignments = true olmalı.