Proje: OkulUp API · Hub: OkulUp API — Conventions

OkulUp API — Composer & Artisan Script’leri

Sık Kullanılan Scriptler

# API docs üret (commit öncesi ZORUNLU)
vendor/bin/sail composer api:generate
# veya:
vendor/bin/sail artisan l5-swagger:generate
 
# OpenAPI spec güncel mi kontrol et (CI'da kullanılır)
vendor/bin/sail composer api:check
 
# Static analysis (commit öncesi ZORUNLU, level 5)
vendor/bin/sail bin phpstan analyse --memory-limit=512M
 
# Pint formatter (commit öncesi)
vendor/bin/sail bin pint --dirty
 
# Dev ortamı (server + queue + logs + vite)
vendor/bin/sail composer dev

Commit Öncesi Zorunlu Checklist

1. php artisan l5-swagger:generate → storage/api-docs/api-docs.json commit’e dahil et
2. ./vendor/bin/phpstan analyse --memory-limit=512M → hatasız geçmeli
3. vendor/bin/sail bin pint --dirty → kod formatı

PHPStan Konfigürasyonu

Larastan v3, level 5.
Config: vendor/larastan/larastan/ — CLAUDE.md’de belgelenmiş.

Test Komutu

# Tek test dosyası:
vendor/bin/sail artisan test tests/Feature/Api/FeatureTest.php
 
# ASLA tam suite gereksiz yere çalıştırma (CI'da çalışır)

Related

• openapi-dokumantasyon — swagger generate detayı
• test-konvansiyonlari — test çalıştırma kuralları