Genel Amaç
Süper Kahramanlar adlandırma modeli, birçok özellikte çalışan platform düzeyinde güvenlik, gözlemlenebilirlik ve iletişim katmanları için kullanılır.
- Bu bileşenler, birden fazla sayfa ve API tarafından kullanılan korkuluklar, teşhisler veya teslimat garantileri sağlar.
- Riskli veya yüksek öneme sahip davranışları merkezileştirerek tekrarlanan mantığı azaltırlar.
- Kullanıcıların ve geliştiricilerin özellik davranışını somut uygulama noktalarıyla eşleştirebilmesi için bunlar kasıtlı olarak belgelenmiştir.
Sistem Dağılımı
| Süper kahraman | Birincil Rol | Özel Kullanım Durumu | Birincil Uygulama |
|---|---|---|---|
| ShadowTalon | Genel PHP hata koruyucusu | Yakalanmayan çalışma zamanı hatalarını güvenli JSON/HTML yanıtlarına dönüştürür ve korelasyon kimlikleriyle özel dönen hata günlükleri yazar. | html/src/Domain/ShadowTalon.php |
| Guardian | GüvenilirHTML DOM yazma koruması | XSS riskini azaltmak ve CSP uyumluluğunu korumak için ön uç modüllerine dinamik işaretlemeyi temizler ve güvenli bir şekilde ekler. | html/js/guardian.js |
| Phantom Wing | İstemci hatası harmanlama arka plan programı | Konsol hatalarını/uyarılarını ve işlenmeyen arızaları yakalar, ardından operatör hata ayıklaması için tanılamayı gruplandırır ve kullanıma sunar. | html/js/phantomwing/index.php |
| Lens | İstek kapsamlı tanılama arabelleği | Collects DEV-only events, counters, and timers; supports debug panels and API payload diagnostics via ?lens=1. |
html/src/Observability/Lens.php |
| EmailGarum | İşlemsel posta orkestratörü | Doğrulama, kurtarma ve hesap değişikliği iş akışları için akışa özel e-posta şablonlarını ve teslim davranışını koordine eder. | html/src/Domain/EmailGarum.php |
| Echo | ARIA tempo biçimlendirici | Echo, yardımcı yollar için içeriği yansıtır ve Cadence gücü, stratejik duraklamalar ve ritim ekleyerek anlatımın ekran okuyuculara, konuşma sentezine, braille ekranlara ve insan dinleyicilere net bir şekilde ulaşmasını sağlar. | html/src/Domain/AriaEcho.php |
| GoldMaster | Canonical reference examples for PayCal code, UI, tests, and architecture. | Guides humans and AI agents toward reviewed patterns before similar work starts. | golden_masters/, html/src/Domain/GoldMasterCatalog.php |
Birlikte Nasıl Çalışırlar?
- Runtime fault path: ShadowTalon, operatör teşhislerini özel günlüklerde korurken, işlenmeyen arızaları yakalar ve güvenli yanıtlar verir.
- Browser diagnostics path: Guardian, DOM yazmalarını korur; Phantom Wing, ön uç hatalarını toplar; Lens, geliştirme yüzeylerinde istek düzeyinde tanılama sağlar.
- Account communication path: EmailGarum, işlemsel posta kompozisyonunu standartlaştırır ve protokol dağıtımını EmailTransport'a devreder.
- Assistive narration path: Echo, semantiği sadık bir şekilde tekrarlarken Cadence, duraklamalar ve zamanlamayla ilerleme hızını geri kazandırır, böylece erişilebilirlik çıktısı aceleye getirilmek yerine anlaşılır hale gelir.
- Canonical reference path: GoldMaster records reviewed examples so future work starts from the correct PayCal pattern.
Mükemmel yansıma. Mükemmel ritim. Geride ses kalmadı.
Bu Adlandırma Modeli Neden Var?
Temalı adlar, yerel özellik mantığı yerine "kesişen sistem bileşenlerini" belirtmek için kullanılır.
- Yeni katkıda bulunanlar, platform temellerini sayfa düzeyindeki kodlara göre hızlı bir şekilde tanımlayabilir.
- Operasyonel olaylar, bileşen alanına (hatalar, istemci telemetrisi, DOM güvenliği, e-posta teslimi) göre tetiklenebilir.
- Dokümantasyon, uygulama ayrıntılarını değiştirmek yerine kararlı sistem adlarına referans verebilir.
Doğrulama Bağlantıları
html/tests/Unit/ShadowTalonTest.phpverifies fault response safety and route-shape behavior.html/tests/Unit/EmailTemplateRenderTest.phpverifies transactional template rendering across email flows.html/tests/Unit/Domain/GoldMasterCatalogTest.phpverifies golden master metadata and read-only file preview behavior.- Phantom Wing ve Lens davranışı DEV'de kontrol paneli tanılamaları ve istek hata ayıklama çıktısı aracılığıyla gözlemlenebilir.
Son güncelleme: June 21, 2026.