Scopo generale
Il modello di denominazione Superheroes viene utilizzato per livelli di sicurezza, osservabilità e comunicazione a livello di piattaforma che operano su molte funzionalità.
- Questi componenti forniscono guardrail, diagnostica o garanzie di consegna utilizzate da più pagine e API.
- Riducono la logica ripetuta centralizzando comportamenti rischiosi o di grande importanza.
- Sono documentati intenzionalmente in modo che utenti e sviluppatori possano mappare il comportamento delle funzionalità su punti di implementazione concreti.
Guasto del sistema
| Supereroe | Ruolo primario | Caso d'uso specifico | Implementazione primaria |
|---|---|---|---|
| ShadowTalon | Guardiano globale degli errori PHP | Converte gli errori di runtime non rilevati in risposte JSON/HTML sicure e scrive log di errori rotanti dedicati con ID di correlazione. | html/src/Domain/ShadowTalon.php |
| Guardian | Protezione da scrittura TrustedHTML DOM | Sanifica e inserisce in modo sicuro il markup dinamico nei moduli frontend per ridurre il rischio XSS e preservare la compatibilità CSP. | html/js/guardian.js |
| Phantom Wing | Demone di confronto degli errori del client | Acquisisce errori/avvisi della console ed errori non gestiti, quindi raggruppa ed espone la diagnostica per il debug dell'operatore. | html/js/phantomwing/index.php |
| Lens | Buffer di diagnostica con ambito richiesta | Collects DEV-only events, counters, and timers; supports debug panels and API payload diagnostics via ?lens=1. |
html/src/Observability/Lens.php |
| EmailGarum | Orchestratore di posta transazionale | Coordina i modelli di posta elettronica specifici del flusso e il comportamento di consegna per i flussi di lavoro di verifica, recupero e modifica dell'account. | html/src/Domain/EmailGarum.php |
| Echo | Formattatore di cadenza ARIA | Echo rispecchia i contenuti per percorsi assistivi e il suo potere Cadence aggiunge pause e ritmo strategici in modo che la narrazione sia chiara per lettori di schermo, sintesi vocale, display Braille e ascoltatori umani. | 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 |
Come lavorano insieme
- Runtime fault path: ShadowTalon rileva gli errori non gestiti e restituisce risposte sicure preservando la diagnostica dell'operatore in registri dedicati.
- Browser diagnostics path: Guardian protegge le scritture DOM; Phantom Wing raccoglie gli errori del frontend; Lens fornisce diagnostica a livello di richiesta nelle superfici di sviluppo.
- Account communication path: EmailGarum standardizza la composizione della posta transazionale e delega la consegna del protocollo a EmailTransport.
- Assistive narration path: Echo ripete fedelmente la semantica, mentre Cadence ripristina il ritmo con pause e tempismo in modo che l'output sull'accessibilità sembri intelligibile anziché affrettato.
- Canonical reference path: GoldMaster records reviewed examples so future work starts from the correct PayCal pattern.
Riflessione perfetta. Ritmo perfetto. Nessuna voce lasciata indietro.
Perché esiste questo modello di denominazione
I nomi a tema vengono utilizzati per segnalare "componenti di sistema trasversali" anziché la logica locale delle funzionalità.
- I nuovi contributori possono identificare rapidamente le primitive della piattaforma rispetto al codice a livello di pagina.
- Gli incidenti operativi possono essere classificati in base all'area dei componenti (guasti, telemetria del client, sicurezza DOM, consegna di e-mail).
- La documentazione può fare riferimento a nomi di sistema stabili anziché spostare i dettagli di implementazione.
Ancore di verifica
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.- Il comportamento dell'ala fantasma e dell'obiettivo può essere osservato in DEV tramite la diagnostica del dashboard e richiedendo l'output di debug.
Ultimo aggiornamento: June 21, 2026.