Propósito general
El patrón de nomenclatura Superheroes se utiliza para las capas de seguridad, observabilidad y comunicación a nivel de plataforma que operan en muchas funciones.
- Estos componentes proporcionan barreras de seguridad, diagnósticos o garantías de entrega utilizadas por múltiples páginas y API.
- Reducen la lógica repetida al centralizar comportamientos riesgosos o de alta importancia.
- Están documentados intencionalmente para que los usuarios y desarrolladores puedan asignar el comportamiento de las funciones a puntos de implementación concretos.
Avería del sistema
| superhéroe | Rol principal | Caso de uso específico | Implementación primaria |
|---|---|---|---|
| ShadowTalon | Guardián de fallas globales de PHP | Convierte fallas de tiempo de ejecución no detectadas en respuestas JSON/HTML seguras y escribe registros de fallas rotativos dedicados con ID de correlación. | html/src/Domain/ShadowTalon.php |
| Guardian | Protección contra escritura DOM TrustedHTML | Desinfecta e inserta de forma segura marcas dinámicas en los módulos frontales para reducir el riesgo de XSS y preservar la compatibilidad con CSP. | html/js/guardian.js |
| Phantom Wing | Demonio de intercalación de errores del cliente | Captura errores/advertencias de la consola y fallas no controladas, luego agrupa y expone diagnósticos para la depuración del operador. | html/js/phantomwing/index.php |
| Lens | Búfer de diagnóstico con ámbito de solicitud | Collects DEV-only events, counters, and timers; supports debug panels and API payload diagnostics via ?lens=1. |
html/src/Observability/Lens.php |
| EmailGarum | Orquestador de correo transaccional | Coordina plantillas de correo electrónico de flujo específico y comportamiento de entrega para flujos de trabajo de verificación, recuperación y cambio de cuenta. | html/src/Domain/EmailGarum.php |
| Echo | Formateador de cadencia ARIA | Echo refleja el contenido de las vías de asistencia y su poder de cadencia agrega pausas estratégicas y ritmo para que la narración llegue claramente a los lectores de pantalla, la síntesis de voz, las pantallas braille y los oyentes 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 |
Cómo trabajan juntos
- Runtime fault path: ShadowTalon detecta fallas no controladas y devuelve respuestas seguras mientras preserva los diagnósticos del operador en registros dedicados.
- Browser diagnostics path: Guardian protege las escrituras DOM; Phantom Wing recopila fallas en la interfaz; Lens proporciona diagnósticos a nivel de solicitud en superficies de desarrollo.
- Account communication path: EmailGarum estandariza la composición del correo transaccional y delega la entrega del protocolo a EmailTransport.
- Assistive narration path: Echo repite fielmente la semántica, mientras que Cadence restablece el ritmo con pausas y sincronización para que los resultados de accesibilidad se sientan inteligibles en lugar de apresurados.
- Canonical reference path: GoldMaster records reviewed examples so future work starts from the correct PayCal pattern.
Reflexión perfecta. Ritmo perfecto. No queda ninguna voz atrás.
Por qué existe este patrón de nombres
Los nombres temáticos se utilizan para señalar "componentes transversales del sistema" en lugar de una lógica local de características.
- Los nuevos contribuyentes pueden identificar rápidamente las primitivas de la plataforma frente al código a nivel de página.
- Los incidentes operativos se pueden clasificar por área de componentes (fallas, telemetría del cliente, seguridad DOM, entrega de correo electrónico).
- La documentación puede hacer referencia a nombres de sistemas estables en lugar de cambiar los detalles de implementación.
Anclas de verificación
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.- El comportamiento de Phantom Wing y Lens se puede observar en DEV a través de diagnósticos del panel y solicitar resultados de depuración.
Última actualización: June 21, 2026.