マジックナンバーの代わりに構成可能な半径 (Configurable Radius Instead Of Magic Numbers)

マジックナンバーの代わりに構成可能な半径

5 km はルールの例です。コード定数ではありません。 5 キロメートルのルールの例でも、ヤードと廊下が異なる可能性があるため、データ駆動型である必要があります。```text km_metric from API, not const RADIUS = 5

## 最初に説明した概念```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 と統合境界を混同しています。

## 問題の形式

5 キロメートルのルールの例でも、ヤードと廊下が異なる可能性があるため、データ駆動型である必要があります。```text
km_metric from API, not const RADIUS = 5
```## 従業員の区別

5 km はルールの例です。コード定数ではありません。```text
km_metric from API, not const RADIUS = 5
        ↓
   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. 独立したデプロイは、独立したロールバックを意味します。

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