Investor statement email delivery with DKIM/DMARC alignment and bounce tracking

[thlpkee20-wq]

Description

Statement emails today lack DMARC alignment monitoring and bounce tracking, hiding delivery issues. Instrument delivery with per-domain alignment metrics and bounce feedback loop ingestion.

Requirements and context

• Must be secure, tested, and documented
• Should be efficient and easy to review
• Relevant code: src/services/emailService.ts
• Bounce ingestion secured

Suggested execution

• Fork the repo and create a branch
• git checkout -b feat/email-deliverability-observability
• Implement changes
  • Ingest provider bounce webhooks
  • Emit email.bounce_ratio gauge per domain
  • Alarm on alignment failures
• Validate security and correctness assumptions

Test and commit

• Run tests
  • npm test
• Cover edge cases
  • Suppression list respected on retry
• Include test output and notes

Example commit message

feat: DMARC alignment and bounce tracking for statements

Guidelines

• Minimum 95 percent test coverage
• Clear documentation
• Timeframe: 96 hours