Ferhat RudvanoğullarıVeri Mühendisi
← Tüm işler

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. 1

    Önce envanter

    Bütün prosedürleri uygulamaya, HTTP metoduna ve taşıma zorluğuna göre listeledim.

  2. 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. 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. 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. 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