地図上の円 ジオフェンスの数学 (Circle Geofence Math On The Map)

地図上の円 ジオフェンスの数学

キロメートルをメートルに変換することは契約の一部です。円をメートル単位で描画します。API からキロメートルのメトリクスを変換し、オペレーターのポップアップに半径/面積を表示します。```text L.circle(center, { radius: km_metric * 1000 })

## 最初に説明した概念```text
📦 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.
```これらの概念を区別できないため、チームは UI と統合境界を混同しています。

## 問題の形式

円をメートル単位で描画します。API からキロメートルのメトリクスを変換し、オペレーターのポップアップに半径/面積を表示します。```text
L.circle(center, { radius: km_metric * 1000 })
```## 従業員の区別

キロメートルをメートルに変換することは契約の一部です。```text
L.circle(center, { radius: km_metric * 1000 })
        ↓
   explicit contract
```## 本番環境で位置が壊れている

契約または半径/アイデンティティ/展開の前提が曖昧な場合、インシデントは拡大します。目に見える契約、目に見える失効。

## このエピソードで最も混乱を招く対戦```text
❌ 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

独自のシステムのチェックリスト

1. このサーフェスの所有権境界を 1 文で書きます。
2. 誰がどの契約変更を展開しますか?
3. タイムアウトまたはベンダー遅延時に UI には何が表示されますか?
4. スタンドアロン シナリオと組み込みシナリオを別々にテストしますか?
5. 拒否リスト: コンテンツに企業/ベンダーのドメインの漏洩はありますか?

このセクションで覚えておくべきこと

1. コントラクトが表示される必要があります: パス、半径、チケットのステータス、またはリモート URL を公開します。
2. UI と外部システムの間のギャップは設計上の決定であり、バグではありません。
3. 独立したデプロイは、独立したロールバックを意味します。

非表示にした制限により、本番環境で見つかることになります。