Executez des mutations gouvernees via le systeme de plans signes
3 min
En bref
Les opérations compatibles avec le système de plans utilisent un plan signé. Vérifiez la méthode et le chemin publiés avant de les employer depuis une intégration externe. Un plan est un descripteur d'intention : il declare ce qui va changer, qui l'a demande, et expire apres un delai lie au risque. Les garanties dépendent du contrat de l'opération ; ne supposez pas qu'une écriture quelconque est réversible.
Cycle de vie d'un plan
Consulter la description du schéma
flowchart LR
A[Dry-run] --> B[Plan signe]
B --> C{Verification}
C -->|Valide| D[Apply]
C -->|Expire/Revoque| E[Rejete]
D --> F[Resultat audite]
Dry-run - Simule l'action, retourne un plan signe avec les changements prevus
Verification - L'appelant (humain ou agent) inspecte le plan
Apply - Execute la mutation si le plan est valide et non expire
Audit - Chaque execution est tracee dans le journal d'audit
Dry-run (creer un plan)
SDK
const plan = await client.actions.dryRun('Contract.approve', {
targetId: 'uuid-du-contrat',
input: { approverNote: 'Valide par le directeur' },
});
console.log(plan.planId); // Identifiant unique
console.log(plan.expiresAt); // Date d'expiration
console.log(plan.risk); // low | medium | high
console.log(plan.changes); // Changements prevus
TTL base sur le risque (low: 7j, medium: 24h, high: 1h)
Idempotence
Un plan ne peut etre applique qu'une seule fois
Actor binding
Seul le principal qui a cree le plan peut l'appliquer
Schema check
Le plan est invalide si le schema a change depuis le dry-run
Lister les actions disponibles
// Decouvrir les actions executables sur une entite
const actions = await client.actions.describe('Contract', {
targetId: 'uuid-du-contrat',
});
// Retourne les actions disponibles avec leurs preconditions
for (const action of actions) {
console.log(action.name, action.available, action.risk);
}
Les actions declarent des conditions d'execution. Si une precondition n'est pas satisfaite, le dry-run retourne une erreur ACTION_PRECONDITION_FAILED :