Sihirli Sayı Yerine Yapılandırılabilir Yarıçap (Sihirli Sayi Yerine Yapilandirilabilir Yaricap)

Sihirli Sayı Yerine Yapılandırılabilir Yarıçap

5 km örnek kuraldır; kod sabiti değil. A five-kilometer example rule must still be data-driven so yards and corridors can differ.

km_metric from API, not const RADIUS = 5

5 km örnek kuraldır; kod sabiti değil.

Kavramlar ilk geçtiği yerde

📦 Geofence
Haritada tanımlı coğrafi sınır; daire için merkez + yarıçap.

📦 Telematics Feed
Araç konum/ignition verisini sağlayan dış telemetri kaynağı.

📦 km_metric
API'den gelen kilometre cinsinden yarıçap; haritada metreye çevrilir.

📦 Operational State
Operatörün karar verdiği bekleme durumu; ham GPS'ten farklıdır.

Bu kavramları ayırt edemeyen ekip, UI ile entegrasyon sınırını karıştırır.

Problemin şekli

A five-kilometer example rule must still be data-driven so yards and corridors can differ.

km_metric from API, not const RADIUS = 5

Çalışan ayrım

5 km örnek kuraldır; kod sabiti değil.

km_metric from API, not const RADIUS = 5
        ↓
   explicit contract

Üretimde kırılan yer

Sözleşme veya yarıçap/kimlik/deploy varsayımları gizlendiğinde incident büyür. Görünür sözleşme, görünür geri alma.

Bu bölümde en çok karışan eşleştirmeler

❌ Her şey tek uygulamada daha güvenli
✓ Sınırlar net değilse tek uygulama daha kırılgandır

❌ Konfigürasyon kodda hardcoded kalsın
✓ Yarıçap, remote URL ve expose path operasyonel kontratlardır

❌ Vendor/API gerçeği UI state'tir
✓ Vendor feed kanıt, ops state karardır

Kendi sisteminizi denetleme listesi

1. Bu yüzeyin sahiplik sınırını bir cümleyle yazın.
2. Hangi kontrat değişirse kim deploy eder?
3. Timeout veya vendor gecikmesinde UI ne gösterir?
4. Standalone ve gömülü senaryoları ayrı test ediyor musunuz?
5. Deny-list: içerikte firma/vendor domain sızıntısı var mı?

Bu bölümden aklında kalması gerekenler

1. Sözleşme görünür olmalıdır: expose path, yarıçap, ticket durumu veya remote URL.
2. UI ile dış sistem arasındaki boşluk tasarım kararıdır, bug değil.
3. Bağımsız deploy, bağımsız geri alma demektir.

Gizlediğiniz sınır, üretimde sizi bulur.