IPS: Araç Filo Entegrasyon Servisi
Harici filo yönetim sisteminden alınan araç konum verilerini Wialon IPS protokolüne çevirerek araçların Wialon üzerinden gerçek zamanlı takibini sağlayan arka plan servisi.
Görseller
Proje Detayları
Proje Hakkında
Farklı sistemlerin konuşturulması gereken entegrasyon projelerinin temel zorluğu protokol uyumsuzluğudur. Bu servis tam olarak bu sorunu çözer: harici bir filo yönetim sisteminin ürettiği konum verilerini alır, **Wialon'un protokol standardına** dönüştürür ve TCP üzerinden platforma iletir. Sonuç olarak harici sistem araçları Wialon haritasında anlık olarak görünür hale gelir.
Veri Akışı
Servis, harici API'den periyodik aralıklarla araç konum paketleri alır. Her araç için konum, hız ve yön bilgisi Wialon'un NMEA tabanlı protokol formatına çevrilerek, kalıcı TCP bağlantıları üzerinden Wialon sunucusuna iletilir. Tüm araçlar bu döngüyü **paralel** olarak yürütür.
Protokol Katmanı
Wialon IPS protokolü ham TCP üzerinde çalışır. Her araç için bağımsız bir soket bağlantısı kurulur ve oturum boyunca ayakta tutulur. Login akışı, periyodik keepalive mesajları ve sunucu yanıt doğrulaması protokol standardının gerektirdiği şekilde uygulandı. Eş zamanlı bağlantı sayısı semaphore mekanizmasıyla kontrol altında tutulur.
Hata Toleransı
**Polly** ile exponential backoff uygulandı: başarısız istekler artan bekleme aralıklarıyla yeniden denenir. Bağlantı koptuğunda servis otomatik olarak yeniden bağlanır. Graceful shutdown desteğiyle kapatma sırasında açık bağlantılar düzgün sonlandırılır.
Mimari
**Worker Service** — ana takip döngüsü arka planda kesintisiz çalışır
**HttpClientFactory** — harici API istemcisi, bağlantı havuzu yönetimi dahil
**Arayüz tabanlı DI** — servisler interface üzerinden bağımlı, test edilebilir yapı
**Docker** — non-root kullanıcı, health check ve log volume mount ile production-ready; Dev/Prod ortamları ayrı yapılandırmayla yönetilir