proje detayları

TeklifRota — İhracat Teklifi ve Lojistik SaaS

İhracat tekliflerini, revizyonları, proforma ve çeki listesini, navlun, onay ve sevkiyat süreçlerini tek denetlenebilir akışta yöneten çok kiracılı B2B platform.

Müşteri

TeklifRota

Başlangıç

23 Aug 2026

Bitiş

Web Sitesi

teklifrota.com
TeklifRota ana sayfası: ihracatta alıcıdan sevkiyata tek rota
Açıklama

İhracat tekliflerini, revizyonları, proforma ve çeki listesini, navlun, onay ve sevkiyat süreçlerini tek denetlenebilir akışta yöneten çok kiracılı B2B platform.

Vaka çalışması

Zorluk

İhracat ekipleri aynı veriyi teklif, proforma, çeki listesi ve faturada tekrar tekrar yazıyor, navlun fiyatlarını kaynaksız tahminlerle veriyordu. Alıcı bulma ise CRM ve tekliften kopuk araçlarda yapılıyordu.

Yaklaşım

Fuar teklifi prototipini çok kiracılı bir SaaS çekirdeğiyle birleştirip tüm süreci tek kayıt üzerine kurduk. Belgeleri aynı veriden üç dilde türeten bir şablon sistemi, girdilerini saklayan sürümlü bir navlun motoru ve alıcı taramasını CRM'e bağlayan bir Radar çalışma alanı geliştirdik.

Sonuç

TeklifRota teklifrota.com'da canlı; 33 backend modülü, 200'ü aşkın tablo ve altı belge türüyle ihracat sürecini tekliften sevkiyata tek ekranda yönetiyor. İhracat büyüme modülü pilot kullanımda.

Araçlar

Next.js, React, TypeScript, Fastify, MySQL, Drizzle ORM, Docker, Nginx

Öne Çıkan Özellikler
  • Revizyon, onay motoru ve Incoterms 2020 ile teklif akışı

  • 6 belge türü, 19 şablon; TR/EN/DE PDF çıktısı

  • Alıcıya özel bağlantıdan kabul, ret ve revizyon talebi

  • Karayolu, deniz ve hava için kanıtlanabilir navlun motoru

  • Nakliyeci RFQ portalı ve yük borsası bağlayıcıları

  • Konteyner yükleme planı: 20DV, 40DV, 40HC ve tır

  • Gümrük kayıtlarından alıcı tarama ve Firma Aynası

  • İngilizce alıcı ürün sayfalarından CRM'e talep akışı

  • HMAC imzalı, webhook destekli ERP partner API

Kullanılan Teknolojiler
  • Next.js

  • React

  • TypeScript

  • Fastify

  • MySQL

  • Drizzle ORM

  • Docker

  • Nginx

Tasarım Öne Çıkanları
  • Tek kayıt ilkesi: müşteri ve ürün verisi tekliften faturaya bir kez girilir

  • Her navlun fiyatı girdileriyle saklanır ve yeniden üretilerek doğrulanır

  • Fuar standında hızlı kullanım için QR kodlu belge paylaşımı

  • 8 kademeli sabit tipografi ölçeği ve paket boyutu bütçesi testlerle korunur

  • Türkçe panel; belgeler müşterinin dilinde otomatik üretilir

Detaylar

TeklifRota, ihracat yapan üreticilerin ve KOBİ'lerin satış, lojistik ve finans ekipleri için geliştirilmiş çok kiracılı bir B2B SaaS platformudur. Ürün ve müşteri kartından başlayan süreç; teklif, revizyon, onay, proforma, çeki listesi, ticari fatura, navlun ve sevkiyatla tek kayıt üzerinde ilerler. Sloganı da bunu anlatır: tekliften teslimata tek rota.

Proje bağlamı ve ihtiyaç

İhracat ekipleri aynı müşteri ve ürün bilgisini teklifte, proformada, çeki listesinde ve faturada defalarca yeniden yazıyor. Navlun fiyatları çoğu zaman kaynağı belirsiz tahminlere dayanıyor; alıcı arama ise CRM ve tekliften kopuk ayrı araçlarda yapılıyor. Fuar standında hızlı teklif verme ihtiyacı da cabası. Proje, “Fuar Teklif” çalışma adıyla bir teklif prototipi olarak başladı; MOQ, koli/palet, CBM ve EXW/FOB/CIF hesaplarını taşıyan bu prototip ortak bir SaaS çekirdeğiyle birleştirilerek bugünkü platforma dönüştü.

Çözüm ve kapsam

Ürün, müşteri ve teklif

Ürün kartları kademeli fiyat, MOQ, koli katı ve paketleme bilgisini taşır; müşteri kartlarında iletişim kişileri, adresler ve belgeler tutulur. Teklifler bir durum makinesiyle yönetilir: revizyon geçmişi, kilitli sıra numaraları, süre dolumu ve Incoterms 2020'nin 11 teslim şekli bilgisiyle. Onay motoru belirli koşullarda teklifi bekletir. Alıcı, teklifi kendisine özel bir bağlantıdan görüntüleyip kabul edebilir, reddedebilir ya da revizyon isteyebilir. Paketleme hesabı 20DV, 40DV, 40HC konteyner ve tenteli tır için yükleme planı çıkarır.

Belge üretimi

Teklif, proforma fatura, çeki listesi, ticari fatura, yükleme talimatı ve navlun teklifi aynı kayıttan türetilir; altı belge türü için toplam 19 şablon varyantı bulunur. Belgeler sunucuda HTML olarak hazırlanıp PDF'e çevrilir, SHA-256 sağlama değeri ve şablon sürümüyle saklanır. Belge dili Türkçe, İngilizce veya Almanca olabilir; açık seçim yoksa müşterinin, ardından firmanın dili kullanılır. USD, EUR, GBP ve TRY para birimleri için banka hesabı otomatik seçilir. Belge setleri QR kodlu tek bir bağlantıyla ya da ZIP olarak paylaşılır, Excel dışa aktarımı formül enjeksiyonuna karşı korunur.

Navlun motoru

Karayolu, denizyolu ve havayolu için deterministik ve sürümlü bir navlun motoru geliştirildi; karayolunda beş araç tipi desteklenir. Motor; Avrupa Merkez Bankası döviz kurları, AB haftalık akaryakıt bülteni, OpenStreetMap tabanlı yol mesafeleri ve ölçülmüş otoyol/geçiş ücretleriyle çalışır. Kaydedilen her navlun hesabı girdileriyle birlikte saklanır ve yeniden çalıştırılarak “yeniden üretildi”, “saptı” veya “manuel” olarak sınıflandırılır; böylece fiyatın nereden geldiği her zaman kanıtlanabilir. Nakliyecilerden teklif toplamak için RFQ akışı ve tokenlı nakliyeci teklif portalı, yük borsaları için TIMOCOM, Trans.eu ve Teleroute bağlayıcı altyapısı bulunur. 51 ülkenin resmî tatil takvimi teslim tarihlerine yansıtılır.

Alıcı bulma, CRM ve ihracat büyüme

Radar çalışma alanı gümrük ve dış ticaret kayıtlarında alıcı/tedarikçi eşleştirmesi, ticaret trendleri ve sevkiyat detayı sunar; “Firma Aynası” sektör ve rakip görünümü verir. Fuar ve katılımcı kataloğu, firma zenginleştirme, karar verici bulma ve resmî kaynaklardan (GLEIF, UN Comtrade, Ticaret Bakanlığı ihracatçı endeksi) firma profili aynı akışa bağlanır. Bulunan firmalar kota kontrollü olarak CRM'e aktarılır; CRM firmalar, fırsatlar, görevler, e-posta kampanyaları ve kural tabanlı bir “müşteri koçu” içerir. İhracat Büyüme modülü tedarikçiye İngilizce, indekslenebilir ürün sayfaları açar; bu sayfalardan gelen alıcı talepleri doğrudan mevcut CRM ve teklif akışına düşer.

Yönetim paneli

Ana pano, tarama, ihracat büyüme, CRM, ticari kayıtlar, navlun hesaplama, siparişler, sevkiyatlar ve raporlar ana menüde yer alır. Ayarlarda firma profili, skorlama ağırlıkları, paketleme sabitleri, navlun fiyat kaynakları, entegrasyonlar, plan ve kullanım, API ve webhook, oturumlar, gizlilik ve veri sağlığı yönetilir. Superadmin tarafında kiracılar, navlun parametreleri, geçiş koridorları, veri beslemeleri, fuar havuzu, site/SEO/GEO ayarları ve bulut maliyetleri izlenir. Navlun parametrelerindeki her değişiklik kaynak gösterilerek denetim kaydına yazılır.

Teknik mimari

Bun çalışma alanlarıyla kurulmuş monorepoda backend Fastify 5, TypeScript ve MySQL üzerinde, ham SQL migration'larıyla çalışır; public site, onboarding ve panel tek bir Next.js ve React 19 uygulamasında birleşir. Navlun hesabı ve paketleme mantığı ayrı paketlerde tutulur, böylece sunucu ve arayüz aynı hesabı kullanır. Backend 33 modül ve 200'ü aşkın tablodan oluşur. Her iş tablosu kiracı anahtarıyla kapsanır; bunu denetleyen guard her derlemede ve sürekli entegrasyonda çalışır. Firma rolleri sahip, yönetici, satış müdürü, satış, lojistik, finans ve izleyici olarak ayrılmıştır; en az bir sahip kuralı ve kendi rolünü yükseltememe kısıtı vardır. Panel arayüzü Türkçedir; belgeler üç dilde, alıcı ürün sayfaları İngilizce üretilir. Public sayfalar yapılandırılmış veri, dinamik site haritası, llms.txt ve yapay zekâ tarayıcılarına açık robots kurallarıyla yayınlanır; masaüstü Lighthouse ölçümünde performans 100 alındı.

Entegrasyonlar ve güvenlik

  • Ödeme ve abonelik: iyzico, Stripe Checkout ve superadmin onaylı havale tek bir aktivasyon yolunda birleşir; deneme, başlangıç, pro ve kurumsal planlar kota bazlı çalışır.
  • Partner API: ERP sistemleri için OpenAPI tanımlı REST API; kapsamlı anahtarlar, HMAC imza, idempotency ve webhook desteğiyle ürün, müşteri, teklif, sipariş ve navlun uçları.
  • E-posta ve takvim: SMTP gönderimi, abonelikten çıkma ve engelleme listesi, Google Takvim ve Google Tasks bağlantısı, Telegram bildirimleri.
  • Güvenlik: argon2 parola özeti, yalnızca httpOnly çerezde tutulan ve yeniden kullanımda tüm oturumları kapatan dönen refresh token, AES-256-GCM ile şifreli kiracı sırları, CSRF köken kontrolü, sıkı güvenlik başlıkları ve KVKK talep yaşam döngüsü.

Bugün

TeklifRota teklifrota.com adresinde canlıdır ve ihracat büyüme modülüyle pilot kullanım sürmektedir. Yol haritasında e-fatura/e-arşiv entegrasyonu, çok faktörlü kimlik doğrulama ve lisanslı navlun endeksleriyle karşılaştırma bulunuyor; bunlar henüz planlama aşamasında.