マップ UI (ユーザー インターフェイス) とベンダー API (アプリケーション プログラミング インターフェイス) の間の信頼境界 (UI API)

マップ UI (ユーザー インターフェイス) とベンダー API (アプリケーション プログラミング インターフェイス) の間の信頼境界

ブラウザにベンダー キーを提供しないでください。特権フィードを取得するためにブラウザから直接テレマティクス ベンダーを呼び出さないでください。 API エッジでの信頼を維持します。```text browser map ← your API ← telematics vendor

## 最初に説明した概念```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
browser map ← your API ← telematics vendor
```## 従業員の区別

ブラウザにベンダー キーを提供しないでください。```text
browser map ← your API ← telematics vendor
        ↓
   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. 独立したデプロイは、独立したロールバックを意味します。

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