Objectif général
Le modèle de dénomination Superheroes est utilisé pour les couches de sécurité, d’observabilité et de communication au niveau de la plate-forme qui fonctionnent sur de nombreuses fonctionnalités.
- Ces composants fournissent des garde-fous, des diagnostics ou des garanties de livraison utilisés par plusieurs pages et API.
- Ils réduisent les logiques répétées en centralisant les comportements à risque ou de grande importance.
- Ils sont intentionnellement documentés afin que les utilisateurs et les développeurs puissent mapper le comportement des fonctionnalités à des points de mise en œuvre concrets.
Panne du système
| Super-héros | Rôle principal | Cas d'utilisation spécifique | Implémentation primaire |
|---|---|---|---|
| ShadowTalon | Gardien global des pannes PHP | Convertit les erreurs d'exécution non détectées en réponses JSON/HTML sécurisées et écrit des journaux d'erreurs rotatifs dédiés avec des ID de corrélation. | html/src/Domain/ShadowTalon.php |
| Guardian | Garde en écriture TrustedHTML DOM | Assainit et insère en toute sécurité le balisage dynamique dans les modules frontend pour réduire le risque XSS et préserver la compatibilité CSP. | html/js/guardian.js |
| Phantom Wing | Démon de classement des erreurs client | Capture les erreurs/avertissements de la console et les échecs non gérés, puis regroupe et expose les diagnostics pour le débogage de l'opérateur. | html/js/phantomwing/index.php |
| Lens | Tampon de diagnostic à l'échelle de la requête | Collects DEV-only events, counters, and timers; supports debug panels and API payload diagnostics via ?lens=1. |
html/src/Observability/Lens.php |
| EmailGarum | Orchestrateur de courrier transactionnel | Coordonne les modèles d'e-mails spécifiques au flux et le comportement de livraison pour les workflows de vérification, de récupération et de modification de compte. | html/src/Domain/EmailGarum.php |
| Echo | Formateur de cadence ARIA | Echo reflète le contenu des parcours d'assistance, et son pouvoir Cadence ajoute des pauses et un rythme stratégiques afin que la narration atterrisse clairement pour les lecteurs d'écran, la synthèse vocale, les afficheurs braille et les auditeurs humains. | html/src/Domain/AriaEcho.php |
| GoldMaster | Canonical reference examples for PayCal code, UI, tests, and architecture. | Guides humans and AI agents toward reviewed patterns before similar work starts. | golden_masters/, html/src/Domain/GoldMasterCatalog.php |
Comment ils travaillent ensemble
- Runtime fault path: ShadowTalon détecte les pannes non gérées et renvoie des réponses sûres tout en préservant les diagnostics de l'opérateur dans des journaux dédiés.
- Browser diagnostics path: Guardian protège les écritures DOM ; Phantom Wing rassemble les échecs du frontend ; Lens fournit des diagnostics au niveau de la requête dans les surfaces de développement.
- Account communication path: EmailGarum standardise la composition du courrier transactionnel et délègue la livraison du protocole à EmailTransport.
- Assistive narration path: Echo répète fidèlement la sémantique, tandis que Cadence rétablit le rythme avec des pauses et un timing afin que la sortie d'accessibilité semble intelligible au lieu d'être précipitée.
- Canonical reference path: GoldMaster records reviewed examples so future work starts from the correct PayCal pattern.
Reflet parfait. Rythme parfait. Aucune voix n’est laissée pour compte.
Pourquoi ce modèle de dénomination existe
Les noms thématiques sont utilisés pour signaler les « composants transversaux du système » plutôt que la logique locale des fonctionnalités.
- Les nouveaux contributeurs peuvent rapidement identifier les primitives de la plateforme par rapport au code au niveau de la page.
- Les incidents opérationnels peuvent être triés par domaine de composant (défauts, télémétrie client, sécurité DOM, envoi d'e-mails).
- La documentation peut faire référence à des noms de systèmes stables plutôt que de modifier les détails de mise en œuvre.
Ancres de vérification
html/tests/Unit/ShadowTalonTest.phpverifies fault response safety and route-shape behavior.html/tests/Unit/EmailTemplateRenderTest.phpverifies transactional template rendering across email flows.html/tests/Unit/Domain/GoldMasterCatalogTest.phpverifies golden master metadata and read-only file preview behavior.- Le comportement de Phantom Wing et de Lens peut être observé dans DEV via les diagnostics du tableau de bord et la sortie de débogage des demandes.
Dernière mise à jour : June 21, 2026.