Oyun Kitabı
Limite de confiance entre l'interface utilisateur de la carte (interface utilisateur) et l'API du fournisseur (interface de programmation d'applications) (Limite DE Confiance Entre Linterface Utilisateur DE La Carte Interface Utilisateur Et Lapi Du Fournisseur Interface DE Programmation Dapplications)
Limite de confiance entre Map UI et l'API du fournisseur - une leçon de fabrication sur les opérations logistiques.
Clôture géographique permanente pour flotte (Geofence)
Partie 8 de 8
Série établissant la réalité de l'attente des véhicules avec flux télémétrique et géofence circulaire sur la carte.
Limite de confiance entre l'interface utilisateur de la carte (interface utilisateur) et l'API du fournisseur (interface de programmation d'applications)
Ne fournissez pas de clé de fournisseur au navigateur. N'appelez jamais le fournisseur de télématique directement depuis le navigateur pour des flux privilégiés ; gardez la confiance à la périphérie de votre API.```text browser map ← your API ← telematics vendor
## Concepts à la première mention```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.
```Incapable de distinguer ces concepts, l’équipe confond l’interface utilisateur et la limite d’intégration.
## Forme du problème
N'appelez jamais le fournisseur de télématique directement depuis le navigateur pour des flux privilégiés ; gardez la confiance à la périphérie de votre API.```text
browser map ← your API ← telematics vendor
```## Distinction des employés
Ne fournissez pas de clé de fournisseur au navigateur.```text
browser map ← your API ← telematics vendor
↓
explicit contract
```## Emplacement cassé en production
L’incident est amplifié lorsque les hypothèses de contrat ou de rayon/identité/déploiement sont obscurcies. Contrat visible, révocation visible.
## Les confrontations les plus déroutantes de cet épisode```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
Liste de contrôle de votre propre système
- Écrivez la limite de propriété de cette surface en une phrase.
- Qui déploie quelles modifications du contrat ?
- Qu'est-ce que l'interface utilisateur affiche en cas d'expiration ou de retard du fournisseur ?
- Testez-vous séparément les scénarios autonomes et intégrés ?
- Liste de refus : y a-t-il une fuite de domaine d'entreprise/fournisseur dans le contenu ?
Choses à retenir de cette section
- Le contrat doit être visible : chemin d'exposition, rayon, statut du ticket ou URL distante.
- L'écart entre l'interface utilisateur et le système externe est une décision de conception et non un bug.
- Un déploiement indépendant signifie une restauration indépendante.
La limite que vous cachez vous retrouvera en production.
FAQ
Frequently asked questions
Qu’est-ce que le géofencing ?
Frontière géographique définie sur la carte ; centre + rayon pour le cercle.
Qu’est-ce que le flux télématique ?
Source de télémétrie externe fournissant des données de localisation/allumage du véhicule.
Est-il vrai que « tout est plus sûr dans une seule application » ?
Une application unique est plus fragile si les limites ne sont pas claires
Que corrige cette section ?
Ne fournissez pas de clé de fournisseur au navigateur. Ne fournissez pas de clé de fournisseur au navigateur. N'appelez jamais le fournisseur de télématique directement depuis le navigateur pour des flux privilégiés ; gardez la confiance à la périphérie de votre API.
Principes d'ingénierie appris
- Les limites de propriété et de publication sont aussi réelles que le modèle de domaine.
- Le système externe produit des preuves ; La situation opérationnelle est décidée par vous.
- Gérer le contrat comme un sever ; libérer les détails intérieurs.
Continuer la lecture
Continuer la lecture
Suivant en série
Tableau de bord KPI (Key Performance Indicators) de la flotte en attente
KPI du tableau de bord pour la flotte de secours – une leçon de production sur les opérations logistiques.
Même série
Heatmap, clustering et Draw pour les opérations
Heatmap, Cluster et Draw for Ops – une leçon de production sur les opérations logistiques.
Même série
Contact (allumage), motifs d'attente et classification (taxonomie)
Contact (Ignition), Raisons d'attente et Taxonomie — cours de production en opérations logistiques.