ATS: U-ETDS Zorunlu Bildirim Entegrasyonu
Tarifeli ve tarifesiz yolcu taşımacılığı yapan şirketlerin araç konum verilerini Ulaştırma Bakanlığı'nın U-ETDS sistemine otomatik olarak bildiren entegrasyon servisi.
Görseller
Proje Detayları
Proje Hakkında
Türkiye'de tarifeli ve tarifesiz yolcu taşımacılığı yapan şirketler, araç konum verilerini Ulaştırma Bakanlığı'nın **U-ETDS** (Ulusal Elektronik Takograf Veri Sistemi) altyapısına periyodik olarak bildirmekle yükümlüdür. Bu servis söz konusu yükümlülüğü tamamen otomatikleştirir: Wialon'daki araç verileri düzenli aralıklarla çekilir, işlenir ve Bakanlık sistemine iletilir.
Coğrafi Konum İşleme
U-ETDS bildirimi için araç koordinatlarının il ve ilçe kodlarına dönüştürülmesi gerekir. Bunun için **PostGIS** tabanlı bir hibrit sistem geliştirildi.
Birincil yöntemde araç koordinatı, spatial sorgu ile en yakın idari bölgeye eşlenir. Eşlemenin başarısız olduğu durumlarda Türkçe karakter normalizasyonu ve kısmi eşleme desteği içeren bir yedek yöntem devreye girer. Sonuç her iki durumda da MERNIS il ve ilçe koduna dönüştürülür ve bildirime dahil edilir.
Wialon Entegrasyonu
Servis, çoklu müşteri hesaplarını destekler. Her hesap için token tabanlı kimlik doğrulama ve otomatik oturum yenileme yönetilir. Araç listesi ve konum verileri Wialon REST API üzerinden çekilir.
U-ETDS Bildirimi
Bakanlık sistemi SOAP protokolüyle çalışır. Her araç için gerekli XML paketi otomatik oluşturulur ve HTTP Basic Auth kimlik doğrulamasıyla servise iletilir. Test ve production ortamları ayrı yapılandırmalarla yönetilir. Her müşterinin U-ETDS kimlik bilgileri bağımsız tutulur.
Mimari
**Worker Service** — tüm hesapları ve araçları koordine eden ana döngü, düzenli aralıklarla çalışır
**Hibrit konum servisi** — PostGIS spatial sorgu birincil, fuzzy string matching yedek katman
**SOAP servis katmanı** — XML envelope üretimi ve Bakanlık servisine iletim
**Docker** — non-root kullanıcı, health check, Dev/Prod ortam ayrımı ile production-ready konteyner