PayCal Technologies Inc.

GoldMaster

GoldMaster ist PayCals interne Qualitätsanleitung für kanonische Beispiele. Sie hält künftigen Code, UI, Tests und Architektur an den besten bestehenden Mustern ausgerichtet.

Veröffentlicht: · Zuletzt aktualisiert:

Was es ist

GoldMaster ist die benannte interne Anleitung. Das Verzeichnis golden_masters enthält die Referenzartefakte: kuratierte Beispiele, die beantworten: „Wie sollte das aussehen, bevor wir es bauen?“

  • Golden Masters sind kein Produktionscode.
  • In der ersten Umsetzung sind sie schreibgeschützte Referenzen.
  • Sie beschreiben bevorzugte Struktur, Benennung, Validierung, Barrierefreiheit, Tests und UI-Verhalten.

Warum es existiert

PayCal hat viele sicherheits- und barrierefreiheitssensible Muster. GoldMaster macht die bevorzugten Beispiele ausdrücklich, damit Menschen und KI-Agenten mit einem geprüften Muster beginnen, statt dieselben Regeln in verstreuten Dateien neu zu entdecken.

Betriebsregeln

  • Konsultiere den nächstliegenden Golden Master, bevor du eine ähnliche Funktion erstellst oder änderst.
  • Spiegle die Struktur des Beispiels nur, wenn sie zur Funktion passt.
  • Markiere veraltete Beispiele als Needs Review, bevor du sie ersetzt.
  • Führe keinen Code aus dem GoldMaster-Editor aus.
  • Mache den Admin-Editor nicht öffentlich zugänglich.

Erste Referenz

Der erste aktive Golden Master ist das Calendar-Dialogmuster. Es definiert PayCals Modal-Header, die Reihenfolge der Footer-Aktionen, kompakte Bestätigungsdialoge und das Fokusverhalten für Groups, Business Sites, persönliche Sites und künftige Dialoge.

  • Die primäre Aktion steht vor Close oder Cancel.
  • Archive, Restore, Delete und Unlink verwenden PayCal-Dialoge, keine nativen Browserbestätigungen.
  • Der Fokus darf nicht in einem ausgeblendeten Dialog verbleiben.

Verifikationsanker

  • golden_masters/README.md dokumentiert Konzept und Metadatenregeln.
  • golden_masters/ui/modal-dialog-pattern/metadata.json indiziert das erste aktive Beispiel.
  • html/src/Domain/GoldMasterCatalog.php lädt Metadaten von der Festplatte und hält Vorschauen innerhalb von golden_masters.
  • html/tests/Unit/Domain/GoldMasterCatalogTest.php prüft Katalog- und Dateivorschauverhalten.

Weiterführende Lektüre

GoldMaster gehört jetzt zu PayCals benannten internen Systemen. Siehe die Superheroes System Map um zu sehen, wo es neben ShadowTalon, Guardian, Phantom Wing, Lens, EmailGarum und Echo steht.