Gesamtzweck
Das Benennungsmuster „Superheroes“ wird für Sicherheits-, Beobachtbarkeits- und Kommunikationsebenen auf Plattformebene verwendet, die über viele Funktionen hinweg funktionieren.
- Diese Komponenten stellen Leitplanken, Diagnosen oder Zustellungsgarantien bereit, die von mehreren Seiten und APIs verwendet werden.
- Sie reduzieren wiederholte Logik, indem sie riskantes oder wichtiges Verhalten zentralisieren.
- Sie werden bewusst dokumentiert, damit Benutzer und Entwickler das Funktionsverhalten konkreten Implementierungspunkten zuordnen können.
Systemausfall
| Superheld | Primäre Rolle | Spezifischer Anwendungsfall | Primäre Implementierung |
|---|---|---|---|
| ShadowTalon | Globaler PHP-Fehlerwächter | Konvertiert nicht erfasste Laufzeitfehler in sichere JSON/HTML-Antworten und schreibt dedizierte rotierende Fehlerprotokolle mit Korrelations-IDs. | html/src/Domain/ShadowTalon.php |
| Guardian | TrustedHTML DOM-Schreibschutz | Bereinigt dynamisches Markup und fügt es sicher in Frontend-Module ein, um das XSS-Risiko zu reduzieren und die CSP-Kompatibilität zu wahren. | html/js/guardian.js |
| Phantom Wing | Daemon für die Clientfehler-Sammlung | Erfasst Konsolenfehler/Warnungen und nicht behandelte Fehler, gruppiert sie und stellt Diagnosen für das Debuggen durch den Bediener bereit. | html/js/phantomwing/index.php |
| Lens | Anforderungsbezogener Diagnosepuffer | Collects DEV-only events, counters, and timers; supports debug panels and API payload diagnostics via ?lens=1. |
html/src/Observability/Lens.php |
| EmailGarum | Transaktions-Mail-Orchestrator | Koordiniert flussspezifische E-Mail-Vorlagen und Zustellverhalten für Verifizierungs-, Wiederherstellungs- und Kontoänderungs-Workflows. | html/src/Domain/EmailGarum.php |
| Echo | ARIA-Trittfrequenzformatierer | Echo spiegelt Inhalte für unterstützende Pfade und ihre Trittfrequenzfunktion fügt strategische Pausen und Rhythmen hinzu, sodass die Erzählung für Screenreader, Sprachsynthese, Braillezeilen und menschliche Zuhörer klar ankommt. | 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 |
Wie sie zusammenarbeiten
- Runtime fault path: ShadowTalon erkennt unbehandelte Fehler und gibt sichere Antworten zurück, während die Bedienerdiagnosen in dedizierten Protokollen gespeichert werden.
- Browser diagnostics path: Guardian schützt DOM-Schreibvorgänge; Phantom Wing sammelt Frontend-Fehler; Lens bietet Diagnosen auf Anforderungsebene in Entwicklungsoberflächen.
- Account communication path: EmailGarum standardisiert die Erstellung transaktionaler E-Mails und delegiert die Protokollzustellung an EmailTransport.
- Assistive narration path: Echo wiederholt die Semantik originalgetreu, während Cadence das Tempo mit Pausen und Timing wiederherstellt, sodass sich die Eingabehilfen verständlich und nicht überstürzt anfühlen.
- Canonical reference path: GoldMaster records reviewed examples so future work starts from the correct PayCal pattern.
Perfekte Reflexion. Perfekter Rhythmus. Keine Stimme bleibt zurück.
Warum dieses Benennungsmuster existiert
Themenbezogene Namen werden verwendet, um „übergreifende Systemkomponenten“ zu signalisieren und nicht auf merkmalslokale Logik.
- Neue Mitwirkende können Plattformprimitive schnell von Code auf Seitenebene unterscheiden.
- Betriebsvorfälle können nach Komponentenbereich selektiert werden (Fehler, Client-Telemetrie, DOM-Sicherheit, E-Mail-Zustellung).
- Die Dokumentation kann auf stabile Systemnamen verweisen, anstatt Implementierungsdetails zu verschieben.
Verifizierungsanker
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.- Das Verhalten von Phantom Wing und Lens kann in DEV durch Dashboard-Diagnose und Anforderungs-Debug-Ausgabe beobachtet werden.
Letzte Aktualisierung: June 21, 2026.