États et modes des entités et des systèmes

⚠️ Vous consultez la documentation pour la version API 2025-08-12. La dernière version est 2026-05-04. Les principaux changements incluent la terminologie mise à jour (Asset → Organization, Entity → Taxpayer/Location).

Cette section fournit un aperçu du state et du mode qui définissent le cycle de vie et le comportement opérationnel des ressources Entities et Systems. Le diagramme ci-dessous illustre les transitions entre ces états et modes, 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 les ressources efficacement, assurer des opérations fluides et résoudre des problèmes tels que des identifiants invalides ou des pauses temporaires.

États

• Acquired : État initial de la ressource lors de sa création. Les opérations ne peuvent pas être effectuées dans cet état.
• Commissioned : La ressource est prête et entièrement opérationnelle (à condition que le mode soit opératif).
• Decommissioned : La ressource n’est plus opérationnelle et ne peut effectuer aucune tâche. Cet état est irréversible.

Modes

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

📘Note

Chaque transition est déclenchée soit par un appel API externe, soit se produit automatiquement selon la logique système interne. 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.

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 utilisée. Ce changement d’état est irréversible.

Transitions de mode

• Inactive → Operative : La transition se produit automatiquement si l’état est mis à jour à Commissioned via un appel API.
• Operative → Suspended : Peut être effectuée activement via l’API, par ex. pour suspendre temporairement les opérations lors de la mise à jour des identifiants.
• Operative → Degraded (pas encore implémenté) : La transition 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 résolution des problèmes, par ex. en mettant à jour les identifiants.
• Degraded → Operative (pas encore implémenté) : Peut passer automatiquement lorsque les problèmes avec la ressource sont résolus en interne.