api-extranetwork/todo.md

Laravel 12 Geçiş Todo

Yapıldı

• Geçiş yönü netleştirildi: big-bang rewrite yerine kontrollü ve sözleşme odaklı geçiş yapılacak.
• Öncelik netleştirildi: önce mevcut API davranışı dokümante edilecek, sonra Laravel 12 taşıma başlayacak.

Devam Eden

• Mevcut API sözleşmesini çıkar.
  • openapi.yml içinde endpoint, auth tipi, header, request body, response body ve hata kodlarını tamamla.
  • Route envanteri çıkar: path | controller | middleware | auth | domain | not.
  • Ortak response ve error formatını belgeye bağla.

Sıradaki Adımlar

• Laravel 12'de yeni API skeleton aç.

  • API klasör yapısını kur.
  • Temel config, environment ve ortak paketleri belirle.
  • Eski sistemle aynı response sözleşmesini koruyacak altyapıyı hazırla.

• Auth ve ortak altyapıyı taşı.

  • Login / refresh / logout akışlarını tasarla.
  • Middleware zincirini Laravel 12'ye uyarla.
  • Validation, exception handling ve base response yapısını kur.

• Domain bazlı geçiş yap.

  • Property domaini
  • Booking domaini
  • Payment domaini
  • Channel domaini

• Eski Lumen projeyi referans sistem olarak tut.

  • Kritik akışlarda eski ve yeni sistemi karşılaştır.
  • Parity sağlanana kadar Lumen davranışını referans kabul et.