Principi di posta elettronica
PayCal tratta la posta elettronica transazionale come parte della sicurezza e della continuità dell'account, non come un'infrastruttura di marketing.
- I modelli specifici del flusso vengono utilizzati per i percorsi di verifica, ripristino, modifica dell'account e contatto con l'assistenza.
- La composizione dell'e-mail è centralizzata per evitare logiche di messaggio divergenti tra i controller.
- Gli errori di recapito restituiscono risultati espliciti in modo che i flussi di chiamata possano fallire in modo sicuro e informare chiaramente gli utenti.
Cosa inviamo
| Flusso | Scopo | Famiglia di modelli |
|---|---|---|
| Verifica e-mail | Conferma la proprietà durante gli eventi del ciclo di vita dell'account | email-verification-* |
| Verifica dell'e-mail di recupero | Dimostrare la proprietà della destinazione prima di azioni di recupero sensibili | email-recovery-email-code-* |
| Consegna della chiave di ripristino | Fornire materiale per il recupero dell'account | email-recovery-key-* |
| Operazione di recupero del conto | Emetti il codice di verifica per il recupero dell'account | email-account-recovery-code-* |
| Modifica email (vecchia/nuova casella di posta) | Conferma della doppia casella di posta per la mutazione dell'e-mail dell'account | email-change-code-* and email-change-confirmation-* |
| Contattare il relè di supporto | Inoltra le richieste di supporto alla casella di posta con contenuto normalizzato | contact-email-* |
Conduttura di consegna
PayCal utilizza uno stack di posta elettronica a due livelli:
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.
I collegamenti di verifica sono localizzati nell'ambiente utilizzando la risoluzione dell'host della richiesta in modo che i collegamenti rimangano allineati al contesto di distribuzione corrente.
Supporta la telemetria e la verificabilità della posta elettronica
Gli invii al supporto dei contatti includono la telemetria best-effort in modo che lo stato della consegna possa essere monitorato senza bloccare gli invii degli utenti.
- Aggregate counters are recorded under
telemetry:contact:*keys. - JSONL event records are appended to rotated logs via
PayCal\Domain\ContactSupportTelemetry. - La scrittura del log non è bloccante per preservare l'esperienza utente del modulo di supporto se l'archiviazione della telemetria è ridotta.
Verifica e controlli di affidabilità
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
Confine dell'ambito
Questa pagina documenta il comportamento delle e-mail transazionali e di supporto per le operazioni del prodotto PayCal. Non documenta l'automazione del marketing perché PayCal non utilizza una canalizzazione di posta elettronica di marketing in questa codebase.
Ultimo aggiornamento: March 21, 2026.