Files
clean-architecture-backend-…/docs/notification/provider-runbooks.md
T

1.5 KiB

Provider runbooks

SMTP

Symptom Classification Action
Final 2xx after DATA CONFIRMED_ACCEPTED / PROVIDER_ACCEPTED None; this is acceptance, not inbox delivery
4yz TRANSIENT_PROVIDER Retry under budget and deadline
5yz PERMANENT_PROVIDER or INVALID_RECIPIENT Stop, or invalidate the contact point
Connection lost after DATA AMBIGUOUS_SUBMISSION Reconcile or escalate; do not resend automatically

Connection, read, write and pool-acquire timeouts are all finite. There is no unbounded timeout.

Amazon SES

MessageId is acceptance evidence. SES itself documents that it can accept a request and then not send, so MessageId is never mapped to DELIVERED.

Event Normalized
Send reinforces PROVIDER_ACCEPTED
Delivery DELIVERY_CONFIRMED / NETWORK_OR_CARRIER_ACCEPTED
DeliveryDelay delay fact
Bounce (permanent) BOUNCED_HARD plus hard-bounce suppression
Bounce (transient) BOUNCED_SOFT; retry policy input, not a suppression reason
Complaint complaint fact plus suppression
Reject PROVIDER_REJECTED
RenderingFailure TEMPLATE_FAILURE

Removed provider families

Twilio, FCM, APNs, Web Push and Webhook adapters were removed because nothing assembled them; their runbooks went with them. The last commit that had both is named in docs/capability-status.md (제거된 코드). A deployment that adds one of these providers back writes its runbook here with it.