États et modes du contribuable, du site et du système

Cette section fournit une vue d’ensemble de l’state et du mode qui définissent le cycle de vie et le comportement opérationnel des ressources Taxpayer, Location et System. Le diagramme ci-dessous illustre les transitions entre les états et les modes, en détaillant comment la ressource évolue de la création à la mise hors service et comment ses modes opérationnels s’adaptent en fonction d’événements internes ou d’appels API externes.

Comprendre ces transitions est essentiel pour gérer efficacement les ressources, assurer des opérations fluides et résoudre les problèmes tels que les identifiants invalides ou les pauses temporaires.

📘Note

Chaque transition est déclenchée soit par un appel API externe, soit automatiquement selon la logique interne du système :

• PATCH indique qu’un appel API externe est requis pour initier la transition.
• INTERNAL indique que la transition est déclenchée automatiquement au sein du système.

Les flèches bidirectionnelles indiquent que la transition peut se produire dans les deux sens.

États

• Acquired (Acquis) : État initial de la ressource lors de sa création. Aucune opération ne peut être effectuée dans cet état.
• Commissioned (En service) : La ressource est prête et pleinement opérationnelle (à condition que le mode soit opératif).
• Decommissioned (Hors service) : La ressource n’est plus opérationnelle et ne peut effectuer aucune tâche. Cet état est irréversible.

Modes

• Inactive (Inactif) : La ressource est inactive et non opérationnelle.
• Operative (Opératif) : La ressource est entièrement fonctionnelle et fonctionne comme prévu.
• Suspended (Suspendu) : Temporairement mis en pause, ce qui peut être initié via un appel API, par exemple lorsque des identifiants doivent être mis à jour.
• Degraded (Dégradé) (pas encore implémenté) : La ressource est opérationnelle mais temporairement indisponible, par exemple en raison d’identifiants invalides ou d’erreurs.

Transitions d’état

• Acquired → Commissioned : Nécessite un appel API (PATCH) pour mettre à jour la ressource.
• Commissioned → Decommissioned : Géré via un appel API (PATCH) pour marquer la ressource comme n’étant plus en usage. Ce changement d’état est irréversible.

Transitions de mode

• Inactive → Operative : Se produit automatiquement si l’état est mis à jour à Commissioned via un appel API.
• Operative → Suspended : Peut être effectué activement via l’API, par exemple pour suspendre temporairement les opérations lors de la mise à jour des identifiants.
• Operative → Degraded (pas encore implémenté) : Se produit automatiquement si les identifiants sont invalides ou qu’une erreur se produit.
• Degraded → Suspended (pas encore implémenté) : Doit être mis à jour activement via l’API pour résoudre des problèmes tels que des identifiants invalides.
• Suspended → Operative : Peut être mis à jour via l’API après la résolution des problèmes, par exemple après la mise à jour des identifiants.
• Degraded → Operative (pas encore implémenté) : Peut passer automatiquement lorsque les problèmes avec la ressource sont résolus en interne.