Aller au contenu

Integrations

Guide d’architecture d’intégration

Établissez la responsabilité des systèmes et les frontières opérationnelles.

Version 1.0

Matrice des responsabilités

Définissez l’autorité, le sens, les identifiants et le comportement en cas d’échec pour chaque frontière avant de choisir un modèle d’API, d’événement ou de traitement par lots.
Frontière du systèmeResponsabilité de la source de référenceTransfert type
CRM ou OSS/BSSIdentifiants des clients, services, commandes et données commerciales.Transmettez le contexte de service approuvé vers l’intérieur et renvoyez les références réseau acceptées vers l’extérieur.
Gestion des équipes terrainPersonnes, disponibilité, affectation et état des équipes.Échangez le travail attribué et son état d’achèvement sans dupliquer la décision réseau.
SIG ou inventaire du réseauGéométrie convenue ou référentiel opérationnel des actifs, selon l’architecture du client.Associez les identifiants stables et ne transférez que les modifications examinées à travers la frontière.
Entrepôt de donnéesCopies analytiques et modèles de reporting gouvernés.Publiez les faits et événements acceptés ; ne laissez pas le reporting écraser l’état de production.

Exemple pratique : service aval indisponible

Séquence en cas d’échec

Un lot de travaux accepté est prêt à mettre à jour un système d’inventaire en aval, mais ce service est indisponible. Weezie conserve la décision acceptée, les identifiants sources, la version du payload et l’état de livraison, au lieu de considérer le transfert comme terminé ou de créer une seconde vérité opérationnelle.

L’intégration réessaie conformément à la politique convenue, expose la livraison non résolue à un opérateur et effectue le rapprochement à partir des identifiants de référence lorsque le service revient. La reprise est explicite, observable et idempotente.

Téléchargement de la feuille sur les frontières

Feuille de travail sur les frontières des systèmes