Uygulama geliştirme
API Migrasyonu
Yönetim paneli API'sini tRPC'den katmanlı REST'e taşıdım ve her endpoint'i eskisiyle otomatik karşılaştırdım; en yavaş çağrı 14 saniyeden 0,9 saniyeye indi.
Backend geliştirici
Mayıs–Haziran 2026
Rakamlarla
- yönetim endpoint'i taşındı (551 prosedürlük envanterden)
- 43
- yönetim endpoint'i taşındı (551 prosedürlük envanterden)
- eskisiyle birebir aynı cevap veren endpoint
- 90 → 142
- eskisiyle birebir aynı cevap veren endpoint
- farklı cevap veren endpoint
- 130 → 77
- farklı cevap veren endpoint
- en yavaş endpoint
- 14 sn → 0,9 sn
- en yavaş endpoint
Durum
Uygulamaların API'si tRPC ile yazılmıştı. tRPC, frontend ve backend'i aynı TypeScript projesinde sıkıca bağlıyor; mobil uygulama ya da dış entegrasyon gibi farklı istemciler için engel oluyor. Taşınacak 551 prosedür vardı ve hiçbirinin davranışı değişmemeliydi.
Yaptıklarım
- 1
Önce envanter
Bütün prosedürleri uygulamaya, HTTP metoduna ve taşıma zorluğuna göre listeledim.
- 2
Dört katman
Yönetim paneli endpoint'lerini 4 katmanlı bir REST yapısına taşıdım: route (adres), controller (istek/cevap), service (iş mantığı), repository (veritabanı). Hepsini yönetici yetkisi kontrolüyle korudum.
- 3
Eşlik testi
Her endpoint'i eski ve yeni haliyle aynı istekle çağırıp cevapları karşılaştıran bir test kurdum. Farklı çıkanları tek tek düzelttim; her turda birebir uyumlu endpoint sayısı arttı: 90, 100, 119, 142.
- 4
Yavaş endpoint
Taksonomi ağacını döndüren endpoint 14 saniyede zaman aşımına düşüyordu. Sorguyu düzelttim; 2.745 kategorilik, 10,7 MB'lık ağaç 0,9 saniyede gelmeye başladı.
- 5
Frontend geçişi
Yönetim panelini tRPC yerine yeni REST endpoint'lerini çağıran TanStack Query kancalarına geçirdim.
Sonuç
Yönetim paneli tamamen yeni API üzerinden çalışır hale geldi. Eskisiyle birebir aynı çalışan endpoint sayısı 90'dan 142'ye çıktı, farklı davranan sayısı 130'dan 77'ye indi.
Ne öğrendim
Migrasyonda "çalışıyor" yetmez, "eskisiyle aynı çalışıyor" gerekir. Otomatik karşılaştırma testi olmadan ilerlemek kör uçuş olurdu.
Stack
- Node.js
- Express
- PostgreSQL
- React
- TanStack Query