E-posta İlkeleri
PayCal, işlemsel e-postayı pazarlama altyapısı olarak değil, hesap güvenliği ve hesap sürekliliğinin bir parçası olarak ele alır.
- Akışa özel şablonlar doğrulama, kurtarma, hesap değiştirme ve destek ekibine başvurma yolları için kullanılır.
- Denetleyiciler arasında farklı mesaj mantıklarını önlemek için e-posta kompozisyonu merkezileştirilmiştir.
- Teslimat başarısızlıkları açık sonuçlar döndürür, böylece çağrı akışları güvenli bir şekilde başarısız olabilir ve kullanıcıları net bir şekilde bilgilendirebilir.
Ne Gönderiyoruz
| Akış | Amaç | Şablon Ailesi |
|---|---|---|
| E-posta doğrulaması | Hesabın yaşam döngüsü etkinlikleri sırasında sahipliği doğrulayın | email-verification-* |
| Kurtarma e-postası doğrulaması | Hassas kurtarma eylemlerinden önce hedefin sahipliğini kanıtlayın | email-recovery-email-code-* |
| Kurtarma Anahtarı Teslimatı | Hesap kurtarma materyali sağlayın | email-recovery-key-* |
| Hesap kurtarma işlemi | Hesap kurtarma doğrulama kodunu verin | email-account-recovery-code-* |
| E-posta değişikliği (eski/yeni gelen kutusu) | Hesap e-postasının değiştirilmesi için ikili gelen kutusu onayı | email-change-code-* and email-change-confirmation-* |
| Destek rölesiyle iletişime geçin | Destek isteklerini normalleştirilmiş içeriğe sahip destek gelen kutusuna iletin | contact-email-* |
Teslimat Boru Hattı
PayCal iki katmanlı bir e-posta yığını kullanır:
PayCal\Domain\EmailGarum: workflow-level orchestration and template selection.PayCal\Domain\EmailTransport: SMTP protocol transport (connect, STARTTLS, AUTH, send, close).
Template rendering is performed via PayCal\Domain\Render::template(), with both HTML and text bodies built for each flow.
Doğrulama bağlantıları, istek ana bilgisayar çözünürlüğü kullanılarak ortamda yerelleştirilir, böylece bağlantılar geçerli dağıtım bağlamıyla aynı hizada kalır.
E-posta Telemetrisini ve Denetlenebilirliği Destekleyin
İletişim desteği gönderimleri, en iyi çaba telemetrisini içerir, böylece teslimat durumu, kullanıcı gönderimlerini engellemeden izlenebilmektedir.
- Aggregate counters are recorded under
telemetry:contact:*keys. - JSONL event records are appended to rotated logs via
PayCal\Domain\ContactSupportTelemetry. - Telemetri depolaması bozulursa destek formu UX'ini korumak için günlük yazma işlemi engellemez.
Doğrulama ve Güvenilirlik Kontrolleri
html/tests/Unit/EmailTemplateRenderTest.phpverifies all supported templates render with expected placeholder substitution.html/tests/Integration/LiveEmailTemplateSweepTest.phpprovides opt-in live SMTP end-to-end template coverage.html/tests/Integration/EmailSendTest.phpprovides opt-in single-message verification for SMTP, DKIM, DMARC, and Message-ID health.
# Opt-in live template sweep cd html PAYCAL_RUN_LIVE_EMAIL_SWEEP=1 PAYCAL_LIVE_EMAIL_RECIPIENT=you@example.com \ ./vendor/bin/phpunit --configuration phpunit.xml tests/Integration/LiveEmailTemplateSweepTest.php # Opt-in single email stack verification cd html PAYCAL_RUN_LIVE_EMAIL=1 PAYCAL_LIVE_EMAIL_RECIPIENT=you@example.com \ ./vendor/bin/phpunit --configuration phpunit.xml tests/Integration/EmailSendTest.php
Kapsam Sınırı
Bu sayfa, PayCal ürün işlemlerine ilişkin işlem ve destek e-posta davranışını belgelemektedir. PayCal bu kod tabanında bir pazarlama e-postası hunisi kullanmadığı için pazarlama otomasyonunu belgelemez.
Son güncelleme: March 21, 2026.