ईमेल सिद्धांत
PayCal लेन-देन संबंधी ईमेल को खाता सुरक्षा और खाते की निरंतरता के हिस्से के रूप में मानता है, न कि मार्केटिंग बुनियादी ढांचे के रूप में।
- प्रवाह-विशिष्ट टेम्पलेट्स का उपयोग सत्यापन, पुनर्प्राप्ति, खाता-परिवर्तन और संपर्क समर्थन पथों के लिए किया जाता है।
- नियंत्रकों के बीच भिन्न संदेश तर्क से बचने के लिए ईमेल संरचना को केंद्रीकृत किया गया है।
- डिलीवरी विफलताएं स्पष्ट परिणाम लौटाती हैं इसलिए कॉलिंग प्रवाह सुरक्षित रूप से विफल हो सकता है और उपयोगकर्ताओं को स्पष्ट रूप से सूचित कर सकता है।
हम क्या भेजते हैं
| प्रवाह | प्रयोजन | टेम्पलेट परिवार |
|---|---|---|
| ईमेल सत्यापन | खाता जीवनचक्र घटनाओं के दौरान स्वामित्व की पुष्टि करें | email-verification-* |
| पुनर्प्राप्ति ईमेल सत्यापन | संवेदनशील पुनर्प्राप्ति कार्रवाइयों से पहले गंतव्य स्वामित्व साबित करें | email-recovery-email-code-* |
| पुनर्प्राप्ति कुंजी वितरण | खाता पुनर्प्राप्ति सामग्री प्रदान करें | email-recovery-key-* |
| खाता पुनर्प्राप्ति लेनदेन | खाता-पुनर्प्राप्ति सत्यापन कोड जारी करें | email-account-recovery-code-* |
| ईमेल परिवर्तन (पुराना/नया इनबॉक्स) | खाता ईमेल उत्परिवर्तन के लिए दोहरी इनबॉक्स पुष्टिकरण | email-change-code-* and email-change-confirmation-* |
| समर्थन रिले से संपर्क करें | सामान्यीकृत सामग्री के साथ इनबॉक्स का समर्थन करने के लिए समर्थन अनुरोध अग्रेषित करें | contact-email-* |
डिलिवरी पाइपलाइन
PayCal दो-परत ईमेल स्टैक का उपयोग करता है:
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.
सत्यापन लिंक अनुरोध होस्ट रिज़ॉल्यूशन का उपयोग करके पर्यावरण-स्थानीयकृत होते हैं ताकि लिंक वर्तमान परिनियोजन संदर्भ से जुड़े रहें।
ईमेल टेलीमेट्री और ऑडिटेबिलिटी का समर्थन करें
संपर्क-समर्थन सबमिशन में सर्वोत्तम प्रयास वाली टेलीमेट्री शामिल है ताकि उपयोगकर्ता सबमिशन को अवरुद्ध किए बिना डिलीवरी स्वास्थ्य की निगरानी की जा सके।
- Aggregate counters are recorded under
telemetry:contact:*keys. - JSONL event records are appended to rotated logs via
PayCal\Domain\ContactSupportTelemetry. - यदि टेलीमेट्री स्टोरेज खराब हो जाता है तो सपोर्ट-फॉर्म यूएक्स को संरक्षित करने के लिए लॉग राइटिंग नॉन-ब्लॉकिंग है।
सत्यापन और विश्वसनीयता जांच
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
दायरा सीमा
यह पृष्ठ PayCal उत्पाद संचालन के लिए लेन-देन और समर्थन ईमेल व्यवहार का दस्तावेजीकरण करता है। यह मार्केटिंग ऑटोमेशन का दस्तावेजीकरण नहीं करता है क्योंकि PayCal इस कोडबेस में मार्केटिंग ईमेल फ़नल का उपयोग नहीं करता है।
अंतिम अद्यतन: March 21, 2026.