Algemeen doel
Het Superheroes-naamgevingspatroon wordt gebruikt voor veiligheid, zichtbaarheid en communicatie op platformniveau die voor veel functies gelden.
- Deze componenten bieden vangrails, diagnostiek of leveringsgaranties die door meerdere pagina's en API's worden gebruikt.
- Ze verminderen herhaalde logica door risicovol of belangrijk gedrag te centraliseren.
- Ze zijn opzettelijk gedocumenteerd, zodat gebruikers en ontwikkelaars het gedrag van functies kunnen toewijzen aan concrete implementatiepunten.
Systeemstoring
| Superheld | Primaire rol | Specifiek gebruiksscenario | Primaire implementatie |
|---|---|---|---|
| ShadowTalon | Globale PHP-foutbewaker | Converteert niet-opgevangen runtimefouten naar veilige JSON/HTML-reacties en schrijft speciale roterende foutlogboeken met correlatie-ID's. | html/src/Domain/ShadowTalon.php |
| Guardian | TrustedHTML DOM-schrijfbeveiliging | Reinigt en voegt op veilige wijze dynamische markup in frontend-modules in om het XSS-risico te verminderen en de CSP-compatibiliteit te behouden. | html/js/guardian.js |
| Phantom Wing | Verzameldaemon voor clientfout | Registreert consolefouten/waarschuwingen en onverwerkte fouten, groepeert en stelt vervolgens diagnostische gegevens beschikbaar voor foutopsporing door de operator. | html/js/phantomwing/index.php |
| Lens | Op aanvragen gerichte diagnostische buffer | Collects DEV-only events, counters, and timers; supports debug panels and API payload diagnostics via ?lens=1. |
html/src/Observability/Lens.php |
| EmailGarum | Transactionele mailorkestrator | Coördineert stroomspecifieke e-mailsjablonen en bezorggedrag voor workflows voor verificatie, herstel en accountwijzigingen. | html/src/Domain/EmailGarum.php |
| Echo | ARIA-cadansformatter | Echo weerspiegelt inhoud voor ondersteunende trajecten, en haar cadanskracht voegt strategische pauzes en ritme toe, zodat de vertelling duidelijk terechtkomt voor schermlezers, spraaksynthese, brailleleesregels en menselijke luisteraars. | 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 |
Hoe ze samenwerken
- Runtime fault path: ShadowTalon spoort onverwerkte fouten op en retourneert veilige reacties, terwijl de operatordiagnostiek in speciale logboeken wordt bewaard.
- Browser diagnostics path: Guardian beschermt DOM-schrijfbewerkingen; Phantom Wing verzamelt frontend-fouten; Lens biedt diagnostiek op verzoekniveau op ontwikkelingsoppervlakken.
- Account communication path: EmailGarum standaardiseert de samenstelling van transactionele post en delegeert de protocollevering aan EmailTransport.
- Assistive narration path: Echo herhaalt de semantiek getrouw, terwijl Cadence het tempo herstelt met pauzes en timing, zodat de toegankelijkheidsuitvoer begrijpelijk aanvoelt in plaats van gehaast.
- Canonical reference path: GoldMaster records reviewed examples so future work starts from the correct PayCal pattern.
Perfecte reflectie. Perfect ritme. Geen stem achtergelaten.
Waarom dit naamgevingspatroon bestaat
Thematische namen worden gebruikt om "transversale systeemcomponenten" aan te duiden in plaats van functie-lokale logica.
- Nieuwe bijdragers kunnen platformprimitieven snel identificeren versus code op paginaniveau.
- Operationele incidenten kunnen worden beoordeeld per componentgebied (fouten, clienttelemetrie, DOM-veiligheid, e-mailbezorging).
- Documentatie kan verwijzen naar stabiele systeemnamen in plaats van naar veranderende implementatiedetails.
Verificatieankers
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.- Het gedrag van Phantom Wing en Lens kan in DEV worden waargenomen via dashboarddiagnostiek en foutopsporingsuitvoer.
Laatst bijgewerkt: June 21, 2026.