PayCal Technologies Inc.

GoldMaster

GoldMaster canonical examples के लिए PayCal की internal quality guide है. यह future code, UI, tests और architecture को best existing patterns के साथ aligned रखता है.

प्रकाशित: · अंतिम अपडेट:

यह क्या है

GoldMaster named internal guide है. golden_masters directory में reference artifacts होते हैं: curated examples जो जवाब देते हैं, “इसे बनाने से पहले यह कैसा दिखना चाहिए?”

  • Golden masters production code नहीं हैं.
  • पहले implementation में वे read-only references हैं.
  • वे preferred structure, naming, validation, accessibility, tests और UI behavior बताते हैं.

यह क्यों मौजूद है

PayCal में कई security-sensitive और accessibility-sensitive patterns हैं. GoldMaster preferred examples को explicit बनाता है ताकि humans और AI agents scattered files में वही rules दोबारा खोजने के बजाय known-good pattern से शुरू करें.

Operating rules

  • Similar feature बनाने या बदलने से पहले nearest golden master देखें.
  • Example की structure को तभी mirror करें जब वह feature के लिए सही हो.
  • Stale examples को replace करने से पहले Needs Review mark करें.
  • GoldMaster editor से code execute न करें.
  • Admin editor को publicly expose न करें.

पहला reference

पहला active golden master Calendar dialog pattern है. यह Groups, Business Sites, personal Sites और future dialogs के लिए PayCal modal header, footer action order, compact confirmation dialogs और focus behavior define करता है.

  • Primary action Close या Cancel से पहले आती है.
  • Archive, Restore, Delete और Unlink native browser confirms के बजाय PayCal dialogs use करते हैं.
  • Focus hidden dialog के अंदर नहीं रहना चाहिए.

Verification anchors

  • golden_masters/README.md concept और metadata rules document करता है.
  • golden_masters/ui/modal-dialog-pattern/metadata.json पहले active example को index करता है.
  • html/src/Domain/GoldMasterCatalog.php disk से metadata load करता है और previews को golden_masters के भीतर रखता है.
  • html/tests/Unit/Domain/GoldMasterCatalogTest.php catalog और file preview behavior verify करता है.

Related reading

GoldMaster अब PayCal के named internal systems का हिस्सा है. देखें Superheroes System Map जहां यह ShadowTalon, Guardian, Phantom Wing, Lens, EmailGarum और Echo के साथ बैठता है.