GoldMaster

Ang GoldMaster ay internal quality guide ng PayCal para sa canonical examples. Pinapanatili nitong aligned ang future code, UI, tests, at architecture sa pinakamahuhusay na existing patterns.

Ano ito

Ang GoldMaster ang pinangalanang internal guide. Nasa golden_masters directory ang reference artifacts: curated examples na sumasagot sa “Bago ito gawin, ano dapat ang itsura nito?”

  • Ang golden masters ay hindi production code.
  • Sa unang implementation, read-only references ang mga ito.
  • Inilalarawan nila ang preferred structure, naming, validation, accessibility, tests, at UI behavior.

Bakit ito mayroon

Maraming security-sensitive at accessibility-sensitive patterns ang PayCal. Ginagawang explicit ng GoldMaster ang preferred examples para magsimula ang humans at AI agents sa known-good pattern sa halip na hanapin muli ang parehong rules sa magkakahiwalay na files.

Operating rules

  • Tingnan ang pinakamalapit na golden master bago gumawa o magbago ng katulad na feature.
  • I-mirror lang ang structure ng example kapag bagay ito sa feature.
  • Markahan ang stale examples bilang Needs Review bago palitan.
  • Huwag mag-execute ng code mula sa GoldMaster editor.
  • Huwag gawing public ang admin editor.

Unang reference

Ang unang active golden master ay ang Calendar dialog pattern. Dine-define nito ang PayCal modal header, footer action order, compact confirmation dialogs, at focus behavior para sa Groups, Business Sites, personal Sites, at future dialogs.

  • Nauuna ang primary action bago ang Close o Cancel.
  • Gumagamit ang Archive, Restore, Delete, at Unlink ng PayCal dialogs, hindi native browser confirms.
  • Hindi dapat maiwan ang focus sa loob ng hidden dialog.

Verification anchors

  • golden_masters/README.md ang nagdodokumento ng concept at metadata rules.
  • golden_masters/ui/modal-dialog-pattern/metadata.json ang nag-i-index ng unang active example.
  • html/src/Domain/GoldMasterCatalog.php ang naglo-load ng metadata mula sa disk at pinapanatili ang previews sa loob ng golden_masters.
  • html/tests/Unit/Domain/GoldMasterCatalogTest.php ang nagve-verify ng catalog at file preview behavior.

Related reading

Bahagi na ngayon ang GoldMaster ng named internal systems ng PayCal. Tingnan ang Superheroes System Map para makita kung saan ito nakapuwesto kasama ng ShadowTalon, Guardian, Phantom Wing, Lens, EmailGarum, at Echo.