Nedir
GoldMaster adlandırılmış internal guide’dır. golden_masters dizini reference artifact’leri içerir: “Bunu oluşturmadan önce nasıl görünmeli?” sorusunu yanıtlayan curated examples.
- Golden masters production code değildir.
- İlk uygulamada read-only reference olarak kullanılırlar.
- Preferred structure, naming, validation, accessibility, tests ve UI behavior tanımlarlar.
Neden var
PayCal’da security-sensitive ve accessibility-sensitive birçok pattern var. GoldMaster preferred examples’ı açık hale getirir; böylece humans ve AI agents dağınık dosyalarda aynı rules’u yeniden keşfetmek yerine known-good pattern’dan başlar.
İşletim kuralları
- Benzer bir feature oluşturmadan veya değiştirmeden önce en yakın golden master’a bak.
- Example yapısını yalnızca feature’a uyduğunda mirror et.
- Stale examples’ı değiştirmeden önce Needs Review olarak işaretle.
- GoldMaster editor içinden code execute etme.
- Admin editor’ü public olarak expose etme.
İlk referans
İlk active golden master Calendar dialog pattern’ıdır. PayCal modal header’ını, footer action order’ını, compact confirmation dialogs’ı ve Groups, Business Sites, personal Sites ve future dialogs için focus behavior’ı tanımlar.
- Primary action, Close veya Cancel’dan önce görünür.
- Archive, Restore, Delete ve Unlink native browser confirm yerine PayCal dialogs kullanır.
- Focus hidden dialog içinde kalmamalıdır.
Doğrulama dayanakları
golden_masters/README.mdconcept ve metadata rules’u belgeler.golden_masters/ui/modal-dialog-pattern/metadata.jsonilk active example’ı indexler.html/src/Domain/GoldMasterCatalog.phpmetadata’yı diskten yükler ve preview’larıgolden_mastersiçinde tutar.html/tests/Unit/Domain/GoldMasterCatalogTest.phpcatalog ve file preview behavior’ı doğrular.
İlgili okuma
GoldMaster artık PayCal’ın named internal systems parçasıdır. Bkz. Superheroes System Map ShadowTalon, Guardian, Phantom Wing, Lens, EmailGarum ve Echo yanında nerede durduğunu gösterir.