PayCal Technologies Inc.

GoldMaster

GoldMaster è la guida interna di qualità di PayCal per esempi canonici. Mantiene codice, UI, test e architettura futuri allineati ai migliori pattern esistenti.

Pubblicato: · Ultimo aggiornamento:

Che cos’è

GoldMaster è la guida interna con nome proprio. La directory golden_masters contiene gli artefatti di riferimento: esempi curati che rispondono a “Prima di costruirlo, che aspetto dovrebbe avere?”

  • I golden master non sono codice di produzione.
  • Nella prima implementazione sono riferimenti in sola lettura.
  • Descrivono struttura, naming, validazione, accessibilità, test e comportamento UI preferiti.

Perché esiste

PayCal ha molti pattern sensibili alla sicurezza e all’accessibilità. GoldMaster rende espliciti gli esempi preferiti, così persone e agenti AI partono da un pattern noto e verificato invece di riscoprire le stesse regole in file sparsi.

Regole operative

  • Consulta il golden master più vicino prima di creare o modificare una funzionalità simile.
  • Replica la struttura dell’esempio solo quando è adatta alla funzionalità.
  • Segna gli esempi obsoleti come Needs Review prima di sostituirli.
  • Non eseguire codice dall’editor GoldMaster.
  • Non esporre pubblicamente l’editor amministrativo.

Primo riferimento

Il primo golden master attivo è il pattern del dialog Calendar. Definisce l’header modale di PayCal, l’ordine delle azioni nel footer, i dialoghi compatti di conferma e il comportamento del focus per Groups, Business Sites, personal Sites e dialog futuri.

  • L’azione primaria appare prima di Close o Cancel.
  • Archive, Restore, Delete e Unlink usano dialoghi PayCal, non conferme native del browser.
  • Il focus non deve restare dentro un dialog nascosto.

Ancoraggi di verifica

  • golden_masters/README.md documenta il concetto e le regole dei metadati.
  • golden_masters/ui/modal-dialog-pattern/metadata.json indicizza il primo esempio attivo.
  • html/src/Domain/GoldMasterCatalog.php carica metadati dal disco e mantiene le anteprime dentro golden_masters.
  • html/tests/Unit/Domain/GoldMasterCatalogTest.php verifica il comportamento del catalogo e dell’anteprima file.

Lettura correlata

GoldMaster ora fa parte dei sistemi interni nominati di PayCal. Vedi la Superheroes System Map per capire dove si colloca accanto a ShadowTalon, Guardian, Phantom Wing, Lens, EmailGarum ed Echo.