Tahıl Ticaret Platformu

Tahıl emtia pazarı için full-stack dijital pazar yeri. Platform, tüm anlaşma yaşam döngüsünü otomatikleştirir — otomatik fiyat keşfinden karşı taraf doğrulamasına, sözleşme imzalamadan navlun yönlendirmesine ve belge üretimine kadar — tarımsal üreticilere, emtia alıcılarına ve lojistik sağlayıcılara hizmet eder.

Sistem, ortak bir backend’i paylaşan üç istemci uygulamasından oluşur: satıcılar ve alıcılar için bir web portalı, saha lojistiği için bir nakliyeci mobil uygulaması ve hareket halinde anlaşma yönetimi için bir satıcı mobil uygulaması.

Backend — her biri farklı bir iş alanına sahip 15 mikroservis: Registration Service — kullanıcı kayıt, KYC, tüzel kişi doğrulama. Deal Service — anlaşma yaşam döngüsü yönetimi, sözleşme oluşturma, durum takibi. Account Service — şirket profili, gereksinimler, API anahtar yönetimi. Freight Forwarding Service — navlun iş akışı, belge oluşturma (irsaliyeler, sefer raporları). Best Price Search — baz dönüştürme, navlun maliyet tahmini, otomatik fiyat eşleştirme. Carrier Uberization — mevsimsel talep modelleme ile ML tabanlı navlun maliyet hesaplaması; taşıma siparişi ve gönderi takibi için lojistik platformlarla entegrasyon. Counterparty Accreditation — belge hazırlama ve otomatik akreditasyon iş akışı. Financial Partner Service — anlaşma izleme ve aşama takibi için finans kuruluşlarıyla entegrasyon.

Servisler Apache Kafka üzerinden asenkron iletişim kurar. Uzun süreli iş süreçleri — anlaşma imzalama, navlun yönlendirme — Camunda BPMN ile orkestre edilir; güvenilir yürütme, hata kurtarma ve süreç düzeyinde gözlemlenebilirlik sağlanır.

Kimlik doğrulama ve rol yönetimi kendi barındırılan Keycloak örneğinde çalışır. Sırlar HashiCorp Vault’ta merkezi olarak yönetilir. Gözlemlenebilirlik, Spring Cloud Sleuth ile dağıtık izleme ve Telegram kanallarına gerçek zamanlı uyarılar ile OpenSearch üzerine inşa edilmiştir.

Web Portalı — Angular 17 / TypeScript. Temel özellikler: otomatik en iyi fiyat arama, anlaşma oluşturma ve yönetimi, birincil belge oluşturma.

Nakliyeci Uygulaması — Capacitor + Angular + TypeScript. iOS ve Android. Üç bölüm: açık navlun talepleri, aktif seferler (belge oluşturma ve arka plan senkronizasyonu ile çevrimdışı mod), tamamlanmış iş arşivi.

Satıcı Uygulaması — Capacitor + Angular + TypeScript. iOS ve Android. Temel alıcı bazlarında fiyat panosu, mobilden tek dokunma ile anlaşma yürütme, anlaşma durum takibi. Tarımsal işletme yöneticilerine yönelik.

Her üç istemci uygulamasında paylaşılan Angular/TypeScript kod tabanı, tekrarı önemli ölçüde azalttı ve ekibi tek bir bileşen kütüphanesi üzerinde hizalı tuttu.

Üç mühendis, standart ekip yapısı. Bu projede AI orkestrasyonu yok — saf mühendislik uygulaması. Sonuç, mimari kararlar baştan alındığında ve alan sınırları temiz bir şekilde tanımlandığında odaklı, iyi yapılandırılmış bir ekibin ne teslim ettiğini gösterir.

Tahıl Ambarı Kaydı ile doğrudan karşılaştırma noktası olarak hizmet eder: AI orkestrasyonu ile tek bir mühendis 12 günde 13 servis teslim etti. AI olmadan üç mühendis 3 ayda 15 servis teslim etti. Farklı ekipler, farklı bağlamlar — ancak her iki sonuç da doğrulanabilir.

15 bağımsız mikroservis, bir web portalı ve iki çapraz platform mobil uygulama, 3 kişilik bir ekip tarafından 3 ayda teslim edildi. Portal ve her iki mobil uygulamada paylaşılan Angular/TypeScript stack’i, hız ve tutarlılıkta karşılığını bulan bilinçli bir mimari karardı.

Uzun süreli iş süreçleri için Camunda BPMN vazgeçilmez oldu: anlaşma imzalama ve navlun yönlendirme, basit bir durum makinesi için çok fazla hata modu içerir. Görsel süreç tanımları ve yerleşik yeniden deneme/kurtarma mekanizması, sistemi ilk günden dayanıklı kıldı.