PayCal Technologies Inc.

GoldMaster

GoldMaster es la guía interna de calidad de PayCal para ejemplos canónicos. Mantiene el código, la UI, las pruebas y la arquitectura futuras alineadas con los mejores patrones existentes.

Publicado: · Última actualización:

Qué es

GoldMaster es la guía interna con nombre propio. El directorio golden_masters contiene los artefactos de referencia: ejemplos curados que responden: “Antes de construir esto, ¿cómo debería verse?”

  • Los golden masters no son código de producción.
  • En la primera implementación son referencias de solo lectura.
  • Describen estructura, nombres, validación, accesibilidad, pruebas y comportamiento de UI preferidos.

Por qué existe

PayCal tiene muchos patrones sensibles a seguridad y accesibilidad. GoldMaster hace explícitos los ejemplos preferidos para que personas y agentes de IA comiencen desde un patrón conocido y revisado, en lugar de redescubrir las mismas reglas en archivos dispersos.

Reglas operativas

  • Consulta el golden master más cercano antes de crear o cambiar una función similar.
  • Replica la estructura del ejemplo solo cuando encaje con la función.
  • Marca los ejemplos obsoletos como Needs Review antes de reemplazarlos.
  • No ejecutes código desde el editor GoldMaster.
  • No expongas públicamente el editor administrativo.

Primera referencia

El primer golden master activo es el patrón del diálogo Calendar. Define el encabezado modal de PayCal, el orden de acciones del pie, los diálogos compactos de confirmación y el comportamiento de foco para Groups, Business Sites, personal Sites y diálogos futuros.

  • La acción primaria aparece antes de Close o Cancel.
  • Archive, Restore, Delete y Unlink usan diálogos de PayCal, no confirmaciones nativas del navegador.
  • El foco no debe permanecer dentro de un diálogo oculto.

Anclajes de verificación

  • golden_masters/README.md documenta el concepto y las reglas de metadatos.
  • golden_masters/ui/modal-dialog-pattern/metadata.json indexa el primer ejemplo activo.
  • html/src/Domain/GoldMasterCatalog.php carga metadatos desde disco y mantiene las vistas previas dentro de golden_masters.
  • html/tests/Unit/Domain/GoldMasterCatalogTest.php verifica el comportamiento del catálogo y de la vista previa de archivos.

Lectura relacionada

GoldMaster ahora forma parte de los sistemas internos con nombre de PayCal. Consulta el Superheroes System Map para ver dónde encaja junto a ShadowTalon, Guardian, Phantom Wing, Lens, EmailGarum y Echo.