O que é
GoldMaster é o guia interno nomeado. O diretório golden_masters contém os artefatos de referência: exemplos curados que respondem: “Antes de construir isto, como deveria ser?”
- Golden masters não são código de produção.
- Na primeira implementação, são referências somente leitura.
- Eles descrevem estrutura, nomenclatura, validação, acessibilidade, testes e comportamento de UI preferidos.
Por que existe
A PayCal tem muitos padrões sensíveis a segurança e acessibilidade. GoldMaster torna explícitos os exemplos preferidos para que humanos e agentes de IA comecem por um padrão conhecido e revisado, em vez de redescobrir as mesmas regras em arquivos espalhados.
Regras operacionais
- Consulte o golden master mais próximo antes de criar ou alterar uma funcionalidade semelhante.
- Replique a estrutura do exemplo apenas quando ela se encaixar na funcionalidade.
- Marque exemplos desatualizados como Needs Review antes de substituí-los.
- Não execute código a partir do editor GoldMaster.
- Não exponha publicamente o editor administrativo.
Primeira referência
O primeiro golden master ativo é o padrão do diálogo Calendar. Ele define o cabeçalho modal da PayCal, a ordem das ações no rodapé, diálogos compactos de confirmação e comportamento de foco para Groups, Business Sites, personal Sites e diálogos futuros.
- A ação primária aparece antes de Close ou Cancel.
- Archive, Restore, Delete e Unlink usam diálogos da PayCal, não confirmações nativas do navegador.
- O foco não deve permanecer dentro de um diálogo oculto.
Âncoras de verificação
golden_masters/README.mddocumenta o conceito e as regras de metadados.golden_masters/ui/modal-dialog-pattern/metadata.jsonindexa o primeiro exemplo ativo.html/src/Domain/GoldMasterCatalog.phpcarrega metadados do disco e mantém prévias dentro degolden_masters.html/tests/Unit/Domain/GoldMasterCatalogTest.phpverifica o comportamento do catálogo e da prévia de arquivos.
Leitura relacionada
GoldMaster agora faz parte dos sistemas internos nomeados da PayCal. Veja o Superheroes System Map para entender onde ele se encaixa ao lado de ShadowTalon, Guardian, Phantom Wing, Lens, EmailGarum e Echo.