OkulUp API
Claude’un bu proje için kalıcı hafızası. Session’lar arası unutmayacağın bilgileri buraya yazarsın.
Proje Özeti
OkulUp mobil uygulaması için Laravel 12 tabanlı REST API. Multi-tenant okul yönetim sistemi.
- 31 controller, ~35 model, 15 job, 5 observer, 13 policy, 5 broadcast event
- 11 feature flag (assignments varsayılan KAPALI, diğerleri açık)
- 5 rol: admin, manager, teacher, parent, student
- CI: GitHub Actions — testleri lokalde çalıştırma!
- Commit öncesi:
l5-swagger:generate+phpstan analysezorunlu
KRITIK: FK Tipi Kuralı
school_id / user_id → unsignedInteger() // NOT foreignId()
class_id → unsignedBigInteger() // NOT foreignId()Klasörler (Hub’lar)
- OkulUp API — Decisions — neden X yerine Y seçildi (ADR)
- OkulUp API — Architecture — sistem haritası, data flow, servisler
- OkulUp API — Domain — iş mantığı, terminoloji, kurallar
- OkulUp API — Conventions — kod stili, pattern’ler, naming
- OkulUp API — Incidents — çözülmüş buglar + root cause
- OkulUp API — People — paydaşlar, kim neyle ilgileniyor
Hızlı Başvuru
| Soru | Not |
|---|---|
| Rol-bazlı yetki nasıl? | rol-ve-yetki-mimarisi |
| Feature aktif mi? | feature-flag-sistemi |
| Yeni migration FK? | veritabani-sema |
| Controller pattern? | api-kod-konvansiyonlari |
| Assignment akışı? | odev-akisi |
| Mesajlaşma? | mesajlasma-sistemi |
| Dashboard cache? | dashboard-cache-pattern |
Repo
/Users/furkannamli/Desktop/project/kampusapi