Proje: OkulUp API · Hub: OkulUp API — Domain

OkulUp API — Kayıt ve Enrollment Akışı

Kullanıcı Kayıt Akışı

1. POST /register → user oluşturulur, Sanctum token döner
2. school_id opsiyonel — kayıtta okul seçilebilir veya sonradan enrollment request ile ilişkilendirilebilir
3. Kayıtta is_active: true set edilir

Okul Kayıt Talebi (EnrollmentRequest)

Kullanıcı kayıtlandıktan sonra bir okula bağlanmak için enrollment request açar.

[pending] --approve--> user.school_id set edilir
         --reject-->   kullanıcı onaysız kalır

API Endpoint’leri

Method	Path	Kim Kullanır
POST	/school-enrollment-requests	Kullanıcı (parent self-registration)
GET	/school-enrollment-requests/me	Kullanıcı kendi taleplerini görür
GET	/school-enrollment-requests	Admin/Manager bekleyen talepleri görür
PUT	/school-enrollment-requests/{id}	Admin/Manager onay/ret

EnrollmentRequest Model Scopeları

scopePending($query)           // status = 'pending'
scopeByUser($query, $userId)   // belirli kullanıcının talepleri

Veli-Öğrenci İlişkisi

// Parent bağlama
POST /users/{user}/children     // parent_id olan user'a student bağla
DELETE /users/{user}/children/{student}  // bağı kaldır
 
// student_parent pivot: parent_id, student_id, relationship

Sosyal Login

POST /auth/social → Google/Apple OAuth ile giriş (Laravel Socialite). Kullanıcı yoksa oluşturulur, varsa token üretilir.

Şifremi Unuttum

POST /forgot-password (throttled) — email gönderir, password_reset_tokens tablosu.

Related

• rol-ve-yetki-mimarisi — manager enrollment onaylayabilir
• api-authentication-pattern — Sanctum token kullanımı