Proje: OkulUp API · Hub: OkulUp API — Domain

OkulUp API — Doküman Talep Modülü

feature:document_requests middleware ile korunur.

Doküman Türleri

TYPE_TRANSCRIPT           = 'transcript'           // Transkript
TYPE_HEALTH_REPORT        = 'health_report'        // Sağlık raporu
TYPE_ATTENDANCE_CERTIFICATE = 'attendance_certificate' // Devam sertifikası
TYPE_PERMISSION_FORM      = 'permission_form'      // İzin formu
TYPE_PROGRESS_REPORT      = 'progress_report'      // İlerleme raporu
TYPE_LESSON_PLAN          = 'lesson_plan'          // Ders planı
TYPE_APPROVAL_DOCUMENT    = 'approval_document'    // Onay belgesi
TYPE_OTHER                = 'other'                // Diğer

Durum Makinesi

[pending] --approve--> [approved] --upload--> [uploaded] --complete--> [completed]
         --reject-->   [rejected]
(herhangi yerden) --cancel--> [cancelled]

API Endpoint’leri

Method	Path	Açıklama
GET	/document-requests	Liste (sent/received/status filtre)
POST	/document-requests	Talep oluştur
GET	/document-requests/{id}	Detay
PUT	/document-requests/{id}	Güncelle
POST	/document-requests/{id}/approve	Onayla
POST	/document-requests/{id}/reject	Reddet
POST	/document-requests/{id}/upload	Dosya yükle
POST	/document-requests/{id}/complete	Tamamla
POST	/document-requests/{id}/cancel	İptal et
DELETE	/document-requests/{id}/attachments/{att}	Ek sil

Model Scopeları

scopeSent($query, int $userId)     // requester_id = userId
scopeReceived($query, int $userId) // receiver_id = userId
scopeByStatus($query, string)
scopeByType($query, string)

İlişkiler

• requester → talep oluşturan user
• receiver → talebi karşılayacak user (öğretmen/yönetici)
• attachments → DocumentRequestAttachment

Related

• feature-flag-sistemi — document_requests feature flag
• bildirim-sistemi — doküman talep bildirimleri