Communitygithub.com

Système d'Erreurs et de Statuts

Concevoir un cadre systématique pour les états d'erreur au niveau du site et les statuts système (404, 500, Maintenance, Hors ligne) afin de maintenir la confiance des utilisateurs et de fournir des voies de récupération claires.

Qu'est-ce que Système d'Erreurs et de Statuts ?

Ce skill propose une méthodologie complète pour la conception des « chemins non heureux » d'un site web — les moments où quelque chose ne fonctionne pas au niveau système. Contrairement aux validations de formulaire ou aux bannières contextuelles, ce système gère les états de page entière ou de site entier. Il garantit que les défaillances sont communiquées avec clarté, empathie et une « issue » claire, évitant ainsi la frustration et l'abandon des utilisateurs lors de problèmes techniques. Le skill détaille les cas d'utilisation (404, 500, maintenance, hors ligne, accès refusé), fournit des entrées et sorties spécifiques, et propose un workflow en cinq étapes incluant la catégorisation de la gravité, l'établissement de la voie de récupération, la conception visuelle, l'application de la règle de messagerie « Humain d'abord », et la planification de l'adaptation responsive. Il inclut également des règles de décision, des contraintes (accessibilité, réactivité, image de marque), des schémas d'échec courants et des critères de validation pour garantir des pages d'erreur efficaces et centrées sur l'utilisateur.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/error-and-status-system

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Système d'Erreurs et de Statuts ?

Objectif

Le Système d'Erreurs et de Statuts fournit une méthodologie pour concevoir les « chemins non heureux » d'un site web — les moments où quelque chose ne fonctionne pas au niveau système. Contrairement aux validations de formulaire ou aux bannières contextuelles, ce système gère les états de page entière ou de site entier. Il garantit que les défaillances sont communiquées avec clarté, empathie et une « issue » claire, évitant ainsi la frustration et l'abandon des utilisateurs lors de problèmes techniques.

Cas d'Utilisation

  • 404 Introuvable : Lorsqu'un utilisateur accède à une URL qui n'existe pas.
  • 500 Erreur Serveur : Lorsqu'une défaillance critique du backend empêche le chargement d'une page.
  • Mode Maintenance : Lorsqu'un site est intentionnellement mis hors ligne pour des mises à jour.
  • États Hors Ligne : Lorsqu'un utilisateur perd la connectivité dans une application web.
  • Accès Refusé (403) : Lorsqu'un utilisateur n'a pas les autorisations nécessaires pour voir une ressource spécifique.

Quand Ne PAS Utiliser

  • Validation de Formulaire : Utilisez système-de-conception-de-formulaires pour les erreurs au niveau des champs.
  • Notifications Contextuelles : Utilisez système-de-bannières-et-alertes pour les mises à jour non bloquantes ou les erreurs mineures.
  • Listes Vides : Utilisez système-d-état-vide lorsqu'une page se charge correctement mais ne contient aucune donnée.
  • États de Chargement : Utilisez système-d-état-squelette pour le chargement standard de contenu.

Entrées

  1. Type d'Erreur : Est-ce une erreur client (4xx), serveur (5xx) ou un état système (Maintenance) ?
  2. Contexte Technique : Le système peut-il expliquer pourquoi cela a échoué sans divulguer de données sensibles ?
  3. Chemins de Récupération : Quelles sont les étapes suivantes les plus probables pour l'utilisateur ?
  4. Ton de la Marque : La voix de la marque est-elle humoristique, professionnelle ou strictement technique ?
  5. Contraintes Système : L'état hors ligne doit-il prendre en charge des actions locales spécifiques ?

Sorties

  1. Anatomie de la Page de Statut : Une mise en page définie pour le message d'erreur, l'ancrage visuel et les actions de récupération.
  2. Hiérarchie de la Messagerie : Normes pour le titre (ce qui s'est passé) et la description (que faire ensuite).
  3. Plan de Récupération : Une carte de liens, de champs de recherche ou de ressources d'aide adaptée à l'erreur spécifique.
  4. Spécification UI Hors Ligne : Règles pour la manière dont l'interface change lorsque la connectivité est perdue.

Workflow

1. Catégoriser la Gravité de la Défaillance

Déterminer l'impact de l'erreur :

  • Faible (404/403) : Localisé à une URL. Le site est sain. Se concentrer sur la Redirection.
  • Élevé (500) : Système ou page entièrement cassée. Le site est en difficulté. Se concentrer sur la Réassurance et le Support.
  • Systémique (Maintenance) : Temps d'arrêt intentionnel. Se concentrer sur la Gestion des Attentes (ex. « De retour à 14h »).
  • Connectivité (Hors Ligne) : Défaillance environnementale. Se concentrer sur la Préservation de l'État (ex. « Modifications enregistrées localement »).

2. Établir le Chemin de Récupération

Chaque page d'erreur doit avoir une « Issue » :

  • Le Bouton « Accueil » : L'exigence minimale absolue.
  • Suggestions Intelligentes : Pour les 404, fournir des liens vers des pages populaires ou une barre de recherche.
  • Le Déclencheur « Actualiser » : Pour les erreurs 5xx, fournir un moyen visible de réessayer la requête.
  • Liens de Support : Pour les problèmes persistants, fournir un chemin direct vers un centre d'aide ou une page de statut.

3. Concevoir l'Anatomie Visuelle

Appliquer le système-de-hiérarchie-visuelle à la vue d'erreur :

  • Ancrage Visuel : Utiliser une illustration ou une icône alignée sur la marque pour atténuer l'impact de la défaillance.
  • Titre Clair : Utiliser un titre « humain » (ex. « Nous ne trouvons pas cette page ») au lieu du simple code de statut (« Erreur 404 »).
  • Métadonnées Subtiles : Garder les codes techniques (ex. ID d'erreur : 12345) petits et à faible contraste, destinés aux équipes de support plutôt qu'à l'utilisateur.

4. Appliquer la Règle de Messagerie « Humain d'Abord »

Éviter le jargon technique qui aliène les utilisateurs :

  • Mauvais : « 500 Erreur Interne du Serveur : Connexion réinitialisée par le pair. »
  • Bon : « Quelque chose s'est mal passé de notre côté. Nous travaillons à le réparer maintenant. »
  • Mauvais : « 404 Ressource non localisée. »
  • Bon : « On dirait que cette page a pris un mauvais virage. »

5. Planifier l'Adaptation Responsive

  • Pleine Page vs. Modale : Décider si l'erreur doit occuper toute la zone d'affichage (standard pour 404/500) ou apparaître comme une bannière fixe (courante pour les états Hors Ligne).
  • Mise en Page Centrée : Centrer le contenu est souvent préférable pour les pages d'erreur car cela minimise l'effort de balayage visuel et met l'accent sur la « Pause » dans le parcours utilisateur.

Règles de Décision

  • La Règle du « Chemin Direct » : Ne jamais laisser une page d'erreur être une impasse. S'il n'y a pas de suggestions spécifiques, inclure toujours une option « Retour à l'Accueil » et « Rechercher ».
  • Recherche sur 404 : Si un site a plus de 100 pages, la page 404 DOIT inclure une barre de recherche.
  • Transparence de la Maintenance : En mode maintenance, fournir toujours une heure estimée de retour ou un lien vers une page de statut.
  • Persistance Hors Ligne : En mode hors ligne, « griser » ou désactiver visuellement les actions non fonctionnelles (ex. boutons « Envoyer ») pour éviter la perte de données.

Contraintes

  • Accessibilité : Les pages d'erreur doivent conserver la navigation globale et le pied de page du site (dans la mesure du possible) pour offrir un repère familier. Pour les changements dynamiques de statut (comme le passage hors ligne), utiliser une région aria-live="assertive" pour annoncer immédiatement le changement.
  • Réactivité : Les pages d'erreur doivent être aussi résilientes que possible. Éviter les ressources lourdes qui pourraient ne pas se charger si le système est déjà en difficulté.
  • Image de Marque : Les pages d'erreur doivent ressembler à une partie du site, et non à une page générique de navigateur ou de serveur par défaut.

Schémas d'Échec Courants

  • L'« Impasse » : Une page 404 sans aucun lien, forçant l'utilisateur à utiliser le bouton « Précédent » du navigateur ou à quitter.
  • Le « Mur de Jargon » : Afficher des traces de pile brutes ou des erreurs de base de données qui confondent les utilisateurs et divulguent potentiellement des informations de sécurité.
  • Le « Jeu de Blâme » : Un message qui sous-entend que l'utilisateur a fait quelque chose de mal (ex. « Vous avez saisi une URL invalide ») au lieu d'assumer la responsabilité de l'échec de la découverte.
  • Décalage de Style : Une page d'erreur qui utilise des polices/couleurs différentes du reste du site, la faisant paraître cassée ou malveillante.

Critères de Validation

  • Chaque état d'erreur (404, 500, etc.) a un titre clair et lisible par un humain.
  • Au moins une action de récupération principale (ex. « Retour à l'Accueil ») est présente.
  • Pour les pages 404, une barre de recherche ou des liens populaires sont fournis pour la découverte.
  • Les métadonnées techniques (ID d'erreur) sont présentes mais subordonnées dans la hiérarchie.
  • Les changements de connectivité (Hors Ligne) sont annoncés via des régions ARIA live.
  • Le style visuel reste cohérent avec le système de conception/de marque principal.
  • Les pages de maintenance fournissent un lien « Retour prévu » ou « Page de statut ».

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Skills associés