Selamlar,
Mevcut çalışan bir transfer operasyon ERP sistemimiz var. Proje; Next.js, TypeScript, Prisma ve PostgreSQL üzerinde koşuyor. Şu aşamada, global bir OTA / transfer marketplace yapısına entegre olacak bir "Supplier API" modülü geliştireceğiz.
Firma ismini ve detaylı teknik dokümanları uygun gördüğümüz adaylarla ayrıca paylaşacağım. Şimdilik temel kapsam şu şekilde:



İstediğimiz İşin Özeti


1. API Entegrasyonu: Temel POST metodları (/search, /book, /status, /cancel) uçtan uca yazılacak.
  • Search yapısı: Rota, tarih, kişi sayısı ve araç tipine göre dinamik teklif dönecek. Kârsız veya riskli işlerde hata fırlatmak yerine boş liste dönecek şekilde kurgulanmalı. Hız burada kritik.
  • Fiyat Motoru: Sabit fiyatla çalışmıyoruz. Rota bazlı (whitelist/blacklist), gün/saat aralığı, bölge katsayısı, çocuk koltuğu durumu ve operasyonel limitler (günlük/aylık limit, nakit akışı kontrolü, blackout günler vb.) gibi kuralları yöneten esnek bir motor lazım.
2. Offer & Booking Mantığı:
  • Search sırasında üretilen teklifler hem PostgreSQL’de loglanmalı hem de Redis (Upstash) üzerinde cache’lenmeli.
  • Book aşamasına geçildiğinde fiyatı tekrar hesaplamaya çalışmayacağız; cache'deki teklif geçerli olacak.
  • ExternalBooking ve iç Reservation/Job kayıtları mutlaka atomik (transactional) şekilde atılmalı. İdempotency tarafı çok önemli; aynı istek mükerrer rezervasyon oluşturmamalı.

3. Mimari ve Temizlik:
  • Mevcut repo içinde modüler ilerleyeceğiz (app/api/supplier/v1/ ve lib/supplier-api/ yapısında).
  • Admin paneliyle vs. iş mantığını birbirine karıştırmayalım; ileride projeyi mikroservise çevirebilecek kadar izole bir domain kurmanızı bekliyorum.
  • Canlı Google Maps çağrısı yok; zone/route matrix ve cache mantığıyla optimize çalışacağız.



Ne İstiyoruz?


İlk etapta komple rewrite istemiyoruz; sadece bu entegrasyonun teknik analizini, klasör yapısını, schema taslağını ve endpoint stub’larını içeren bir mimari tasarım bekliyoruz. Ardından /search ile başlayıp süreci tamamlayacağız.



Teklif verirken lütfen şunlara değinin

  • Transfer/Tourism API veya benzeri entegrasyon tecrüben var mı?
Önemli Not: Bu iş sadece birkaç endpoint yazıp bırakmak değil; işin içinde yüksek trafik, anlık fiyatlama ve veri tutarlılığı var. Konuya hakim olmayan arkadaşlar lütfen vakit kaybetmesin.
İlgilenenler info@surfintravel.com adresine kısa bir tanıtım ve portfolyo ile mail atabilirler.