GoldMaster

GoldMaster est le guide qualité interne de PayCal pour les exemples canoniques. Il garde le code, l’interface, les tests et l’architecture futurs alignés sur les meilleurs modèles existants.

Publié : 2026-06-21 · Dernière mise à jour : 2026-06-21

Ce que c’est

GoldMaster est le guide interne nommé. Le répertoire golden_masters contient les artefacts de référence : des exemples sélectionnés qui répondent à la question « Avant de construire ceci, à quoi cela doit-il ressembler ? »

Les golden masters ne sont pas du code de production.
Dans la première version, ce sont des références en lecture seule.
Ils décrivent la structure, le nommage, la validation, l’accessibilité, les tests et le comportement d’interface préférés.

Pourquoi il existe

PayCal possède de nombreux modèles sensibles à la sécurité et à l’accessibilité. GoldMaster rend les exemples préférés explicites afin que les humains et les agents IA commencent avec un modèle éprouvé plutôt que de redécouvrir les mêmes règles dans des fichiers dispersés.

Règles de fonctionnement

Consulter le golden master le plus proche avant de créer ou modifier une fonctionnalité similaire.
Reprendre la structure de l’exemple seulement lorsqu’elle convient à la fonctionnalité.
Marquer les exemples périmés comme Needs Review avant de les remplacer.
Ne pas exécuter de code depuis l’éditeur GoldMaster.
Ne pas exposer publiquement l’éditeur administrateur.

Première référence

Le premier golden master actif est le modèle de dialogue Calendar. Il définit l’en-tête modal de PayCal, l’ordre des actions de pied de dialogue, les confirmations compactes et le comportement du focus pour Groups, Business Sites, personal Sites et les futurs dialogues.

L’action principale apparaît avant Close ou Cancel.
Archive, Restore, Delete et Unlink utilisent des dialogues PayCal, pas des confirmations natives du navigateur.
Le focus ne doit pas rester dans un dialogue masqué.

Ancrages de vérification

golden_masters/README.md documente le concept et les règles de métadonnées.
golden_masters/ui/modal-dialog-pattern/metadata.json indexe le premier exemple actif.
html/src/Domain/GoldMasterCatalog.php charge les métadonnées depuis le disque et garde les aperçus dans golden_masters.
html/tests/Unit/Domain/GoldMasterCatalogTest.php vérifie le catalogue et le comportement d’aperçu des fichiers.

Lecture associée

GoldMaster fait maintenant partie des systèmes internes nommés de PayCal. Voir le Superheroes System Map pour comprendre sa place aux côtés de ShadowTalon, Guardian, Phantom Wing, Lens, EmailGarum et Echo.