PayCal Technologies Inc.

GoldMaster

GoldMaster is PayCals interne kwaliteitsgids voor canonieke voorbeelden. Het houdt toekomstige code, UI, tests en architectuur afgestemd op de beste bestaande patronen.

Gepubliceerd: · Laatst bijgewerkt:

Wat het is

GoldMaster is de benoemde interne gids. De map golden_masters bevat de referentieartefacten: samengestelde voorbeelden die beantwoorden: “Hoe moet dit eruitzien voordat we het bouwen?”

  • Golden masters zijn geen productiecode.
  • In de eerste implementatie zijn ze alleen-lezen referenties.
  • Ze beschrijven voorkeursstructuur, naamgeving, validatie, toegankelijkheid, tests en UI-gedrag.

Waarom het bestaat

PayCal heeft veel beveiligings- en toegankelijkheidsgevoelige patronen. GoldMaster maakt de voorkeursvoorbeelden expliciet, zodat mensen en AI-agenten starten met een bewezen patroon in plaats van dezelfde regels in verspreide bestanden opnieuw te ontdekken.

Werkregels

  • Raadpleeg de dichtstbijzijnde golden master voordat je een vergelijkbare feature maakt of wijzigt.
  • Spiegel de structuur van het voorbeeld alleen wanneer die bij de feature past.
  • Markeer verouderde voorbeelden als Needs Review voordat je ze vervangt.
  • Voer geen code uit vanuit de GoldMaster-editor.
  • Maak de admin-editor niet publiek toegankelijk.

Eerste referentie

De eerste actieve golden master is het Calendar-dialogpatroon. Het definieert PayCals modale header, footer-actievolgorde, compacte bevestigingsdialogen en focusgedrag voor Groups, Business Sites, personal Sites en toekomstige dialogen.

  • De primaire actie verschijnt vóór Close of Cancel.
  • Archive, Restore, Delete en Unlink gebruiken PayCal-dialogen, geen native browserbevestigingen.
  • Focus mag niet in een verborgen dialoog blijven.

Verificatieankers

  • golden_masters/README.md documenteert het concept en de metadataregels.
  • golden_masters/ui/modal-dialog-pattern/metadata.json indexeert het eerste actieve voorbeeld.
  • html/src/Domain/GoldMasterCatalog.php laadt metadata vanaf schijf en houdt previews binnen golden_masters.
  • html/tests/Unit/Domain/GoldMasterCatalogTest.php verifieert catalogus- en bestandsvoorbeeldgedrag.

Gerelateerde lectuur

GoldMaster maakt nu deel uit van PayCals benoemde interne systemen. Zie de Superheroes System Map voor waar het naast ShadowTalon, Guardian, Phantom Wing, Lens, EmailGarum en Echo staat.