Patterns d'erreur plateforme & authentification
Guide de référence pour les 8 patterns d'erreur courants de b.connect. Composants utilisés : BcAlert, BcEmptyState, boutons d'action.
Règles de rédaction des messages d'erreur
- Contexte — Expliquer QUE s'est-il passé (ex: "La connexion au service KYB a expiré")
- Cause — Expliquer POURQUOI si possible (ex: "Le délai de 30 secondes a été dépassé")
- Action — Proposer QUOI faire (ex: "Cliquez sur Relancer pour retenter")
- Ton — Factuel et calme — pas de "Oups !" ni de "Désolé pour la gêne"
- Codes — Afficher le code HTTP (409, 503…) uniquement dans les détails techniques, pas dans le message principal
Erreurs plateforme
Timeout fournisseur
Déclenché quand un appel API externe dépasse 30 secondes sans réponse.
Le délai de 30 secondes a été dépassé. Le service tiers ne répond pas.
<BcAlert variant="warning" icon="bi-hourglass-split">
<strong>Connexion au service KYB expirée</strong>
<p>Le délai de 30 secondes a été dépassé.</p>
<bc-button variant="warning" size="sm" @click="retry">Relancer</bc-button>
</BcAlert>Conflit 409
Déclenché quand les données soumises entrent en conflit avec l'état serveur.
Le dossier Corp Alpha a été modifié par m.dupont pendant que vous travailliez dessus. Vos modifications n'ont pas été enregistrées.
Service indisponible
Déclenché sur une 503 ou une panne détectée.
Le service de vérification d'identité est en maintenance. Reprise prévue à 14h30.
Retry épuisé
Après N tentatives sans succès.
3 tentatives de connexion ont échoué pour le service de scoring. Veuillez contacter le support b.connect.
Erreurs d'authentification
Token expiré
Pour des raisons de sécurité, votre session est limitée à 8 heures d'inactivité.
Scope insuffisant
Déclenché quand l'action requiert un scope OAuth manquant (ex: kyb.write).
Votre compte ne dispose pas des droits nécessaires pour modifier les dossiers KYB. Demandez l'accès à votre administrateur b.connect.
Consentement manquant
Déclenché lors d'un flux OIDC quand le consentement n'a pas été accordé.
Pour accéder à cette fonctionnalité, Corp Alpha doit autoriser l'accès à ses données KYB via le portail partenaire.
MFA requise
Cette action est protégée. Veuillez valider votre identité avec votre application d'authentification.
Récapitulatif des variantes
| Pattern | Variante BcAlert | Icône |
|---|---|---|
| Timeout | warning | bi-hourglass-split |
| Conflit 409 | danger | bi-exclamation-triangle |
| Service indisponible | danger | bi-cloud-slash |
| Retry épuisé | danger | bi-x-circle |
| Token expiré | info | bi-clock-history |
| Scope insuffisant | warning | bi-shield-lock |
| Consentement | info | bi-person-check |
| MFA requise | warning | bi-shield-exclamation |