Objetivo Geral
O padrão de nomenclatura Superheroes é usado para segurança, observabilidade e camadas de comunicação em nível de plataforma que operam em muitos recursos.
- Esses componentes fornecem proteções, diagnósticos ou garantias de entrega usadas por várias páginas e APIs.
- Eles reduzem a lógica repetida centralizando comportamentos arriscados ou de alta importância.
- Eles são documentados intencionalmente para que usuários e desenvolvedores possam mapear o comportamento dos recursos para pontos de implementação concretos.
Quebra do sistema
| Super-herói | Função principal | Caso de uso específico | Implementação Primária |
|---|---|---|---|
| ShadowTalon | Guardião global de falhas de PHP | Converte falhas de tempo de execução não detectadas em respostas JSON/HTML seguras e grava logs de falhas rotativos dedicados com IDs de correlação. | html/src/Domain/ShadowTalon.php |
| Guardian | Proteção contra gravação TrustedHTML DOM | Limpa e insere com segurança marcação dinâmica em módulos de front-end para reduzir o risco de XSS e preservar a compatibilidade do CSP. | html/js/guardian.js |
| Phantom Wing | Daemon de agrupamento de erros do cliente | Captura erros/avisos do console e falhas não tratadas e, em seguida, agrupa e expõe diagnósticos para depuração do operador. | html/js/phantomwing/index.php |
| Lens | Buffer de diagnóstico com escopo de solicitação | Collects DEV-only events, counters, and timers; supports debug panels and API payload diagnostics via ?lens=1. |
html/src/Observability/Lens.php |
| EmailGarum | Orquestrador de correio transacional | Coordena modelos de e-mail específicos de fluxo e comportamento de entrega para fluxos de trabalho de verificação, recuperação e alteração de conta. | html/src/Domain/EmailGarum.php |
| Echo | Formatador de cadência ARIA | Echo espelha o conteúdo para caminhos de assistência, e seu poder de cadência adiciona pausas estratégicas e ritmo para que a narração seja clara para leitores de tela, síntese de fala, linhas braille e ouvintes humanos. | 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 |
Como eles funcionam juntos
- Runtime fault path: ShadowTalon detecta falhas não tratadas e retorna respostas seguras, preservando o diagnóstico do operador em logs dedicados.
- Browser diagnostics path: Guardian protege gravações de DOM; Phantom Wing agrupa falhas de frontend; O Lens fornece diagnósticos em nível de solicitação em superfícies de desenvolvimento.
- Account communication path: EmailGarum padroniza a composição de correio transacional e delega a entrega de protocolo ao EmailTransport.
- Assistive narration path: O Echo repete a semântica fielmente, enquanto o Cadence restaura o ritmo com pausas e tempo para que a saída de acessibilidade pareça inteligível em vez de apressada.
- Canonical reference path: GoldMaster records reviewed examples so future work starts from the correct PayCal pattern.
Reflexão perfeita. Ritmo perfeito. Nenhuma voz deixada para trás.
Por que esse padrão de nomenclatura existe
Nomes temáticos são usados para sinalizar "componentes transversais do sistema" em vez de lógica local de recursos.
- Novos colaboradores podem identificar rapidamente os primitivos da plataforma em comparação com o código no nível da página.
- Os incidentes operacionais podem ser triados por área componente (falhas, telemetria do cliente, segurança do DOM, entrega de e-mail).
- A documentação pode fazer referência a nomes de sistemas estáveis, em vez de alterar detalhes de implementação.
Âncoras de verificação
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.- O comportamento do Phantom Wing e Lens pode ser observado no DEV por meio de diagnósticos do painel e solicitação de saída de depuração.
Última atualização: June 21, 2026.