Skip to content

0005-email-sending-options.md

Latest commit

 

History

History
357 lines (280 loc) · 7.97 KB

0005-email-sending-options.md

File metadata and controls

357 lines (280 loc) · 7.97 KB

Email Sending Options for POS2 System

Proton Mail Analysis

✅ What Proton Mail Offers

SMTP Support Available:

  • ✅ SMTP server: smtp.protonmail.ch
  • ✅ Port: 587 (STARTTLS)
  • ✅ Authentication: SMTP tokens (app-specific passwords)
  • ✅ Zero-access encryption (emails encrypted at rest)
  • ✅ Privacy-focused (Swiss-based, no tracking)

⚠️ Limitations for Transactional Emails

  1. Requires Paid Plan

    • Free accounts don't have SMTP access
    • Need Proton Mail Plus or Business plan (~€4-8/month)

  2. Requires Custom Domain

    • Must have your own domain configured
    • Need to set up SPF, DKIM, DMARC records

  3. No API Access

    • Only SMTP (not REST API)
    • Slower than API-based services
    • No webhooks or real-time analytics

  4. Sending Limits

    • Lower limits than dedicated transactional services
    • Not optimized for high-volume sending

  5. No Email Templates

    • Must build templates yourself
    • No template management system

  6. No Delivery Analytics

    • Limited tracking of delivery, opens, clicks
    • No bounce/complaint handling

📋 Setup Requirements

If using Proton Mail SMTP:

  1. Proton Account Setup:

    - Sign up for Proton Mail Plus/Business
- Add custom domain (e.g., pos2.yourdomain.com)
- Configure DNS records (SPF, DKIM, DMARC)

  2. Generate SMTP Token:

    Settings > IMAP/SMTP > SMTP tokens > Generate token
- Name: "POS2 System"
- Email: your-email@yourdomain.com
- Save the token (this is your SMTP password)

  3. Configuration:

    SMTP_HOST=smtp.protonmail.ch
SMTP_PORT=587
SMTP_USER=your-email@yourdomain.com
SMTP_PASSWORD=<generated_smtp_token>
SMTP_USE_TLS=true
EMAIL_FROM=noreply@yourdomain.com

Alternative Solutions

Option 1: Dedicated Transactional Email Services ⭐ RECOMMENDED

Best for: Production systems, high reliability, analytics

A. SendGrid (Twilio)

  • Free Tier: 100 emails/day forever
  • Paid: $19.95/month for 50,000 emails
  • Features:
    • REST API + SMTP
    • Email templates
    • Delivery analytics
    • Webhooks
    • Bounce handling
  • Setup: Simple API key
  • Best for: High volume, analytics needed

B. Mailgun

  • Free Tier: 5,000 emails/month (first 3 months), then 1,000/month
  • Paid: $35/month for 50,000 emails
  • Features:
    • REST API + SMTP
    • Email validation
    • Webhooks
    • Good deliverability
  • Best for: Developer-friendly, good API

C. AWS SES (Simple Email Service)

  • Free Tier: 62,000 emails/month (if on EC2)
  • Paid: $0.10 per 1,000 emails
  • Features:
    • Very cheap at scale
    • Integrates with AWS
    • SMTP + API
  • Best for: Already using AWS, high volume

D. Resend

  • Free Tier: 3,000 emails/month
  • Paid: $20/month for 50,000 emails
  • Features:
    • Modern API
    • React email templates
    • Good developer experience
  • Best for: Modern apps, React-based

Option 2: SMTP with Gmail/Outlook

Gmail SMTP:

SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your-email@gmail.com
SMTP_PASSWORD=<app_password>  # Not regular password!
SMTP_USE_TLS=true

Limitations:

  • ⚠️ Gmail: 500 emails/day limit
  • ⚠️ Requires app password (2FA needed)
  • ⚠️ Can be marked as spam
  • ⚠️ Not ideal for production

Outlook SMTP:

SMTP_HOST=smtp-mail.outlook.com
SMTP_PORT=587
SMTP_USER=your-email@outlook.com
SMTP_PASSWORD=<password>
SMTP_USE_TLS=true

Option 3: Self-Hosted SMTP (Postfix/Sendmail)

Pros:

  • ✅ Full control
  • ✅ No per-email costs
  • ✅ Privacy

Cons:

  • ❌ Complex setup
  • ❌ Deliverability issues (spam filters)
  • ❌ Maintenance required
  • ❌ IP reputation management

Not recommended for production unless you have email expertise.

Recommendation for POS2 System

For Development/Testing:

Use Gmail SMTP (free, easy setup):

SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your-email@gmail.com
SMTP_PASSWORD=<app_password>
EMAIL_FROM=your-email@gmail.com

For Production:

Use SendGrid or Resend (best balance of features/price):

SendGrid:

  • Free tier: 100 emails/day
  • Good for starting out
  • Easy migration later

Resend:

  • Free tier: 3,000 emails/month
  • Modern API
  • Better developer experience

If Privacy is Critical:

Use Proton Mail SMTP:

  • Requires paid plan (~€4-8/month)
  • Requires custom domain setup
  • More complex but privacy-focused

Implementation Comparison

Proton Mail SMTP

# Using aiosmtplib
import aiosmtplib

await aiosmtplib.send(
    message,
    hostname="smtp.protonmail.ch",
    port=587,
    username="your-email@yourdomain.com",
    password="<smtp_token>",
    use_tls=True
)

SendGrid API (Recommended)

# Using sendgrid library
from sendgrid import SendGridAPIClient
from sendgrid.helpers.mail import Mail

message = Mail(
    from_email='noreply@yourdomain.com',
    to_emails='guest@yourrestaurant.com',
    subject='Verify your email',
    html_content='<p>Your verification code: 123456</p>'
)

sg = SendGridAPIClient(api_key=settings.sendgrid_api_key)
response = sg.send(message)

Resend API

# Using resend library
from resend import Resend

resend = Resend(api_key=settings.resend_api_key)

resend.emails.send({
    "from": "noreply@yourdomain.com",
    "to": "guest@yourrestaurant.com",
    "subject": "Verify your email",
    "html": "<p>Your verification code: 123456</p>"
})

Cost Comparison

Service Free Tier Paid (50k emails) Best For
SendGrid 100/day $19.95/mo Production, analytics
Resend 3,000/mo $20/mo Modern apps
Mailgun 1,000/mo $35/mo Developer-friendly
AWS SES 62k/mo* $5/mo AWS users, scale
Proton Mail None €4-8/mo Privacy-focused
Gmail 500/day Free Development only

*If running on EC2

Decision Matrix

Choose SendGrid/Resend if:

  • ✅ You want easy setup
  • ✅ You need analytics
  • ✅ You want reliable delivery
  • ✅ You're building for production

Choose Proton Mail if:

  • ✅ Privacy is top priority
  • ✅ You have custom domain
  • ✅ You're okay with SMTP only
  • ✅ You don't need high volume

Choose Gmail SMTP if:

  • ✅ Just for development/testing
  • ✅ Low volume (< 500/day)
  • ✅ Quick setup needed

Recommended Implementation Plan

Phase 1: Development

# config.env
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your-dev-email@gmail.com
SMTP_PASSWORD=<gmail_app_password>
EMAIL_FROM=your-dev-email@gmail.com

Phase 2: Production (Choose One)

Option A: SendGrid (Recommended)

SENDGRID_API_KEY=SG.xxxxx
EMAIL_FROM=noreply@yourdomain.com
EMAIL_FROM_NAME=POS2 System

Option B: Resend

RESEND_API_KEY=re_xxxxx
EMAIL_FROM=noreply@yourdomain.com

Option C: Proton Mail

SMTP_HOST=smtp.protonmail.ch
SMTP_PORT=587
SMTP_USER=your-email@yourdomain.com
SMTP_PASSWORD=<proton_smtp_token>
EMAIL_FROM=noreply@yourdomain.com

Questions for You

  1. Priority:

    • Privacy (choose Proton Mail)
    • Ease of use (choose SendGrid/Resend)
    • Cost (choose AWS SES or Gmail for dev)

  2. Volume:

    • Low (< 1,000/month) - Any service works
    • Medium (1,000-10,000/month) - SendGrid/Resend
    • High (> 10,000/month) - AWS SES

  3. Custom Domain:

    • Yes, have domain ready - Can use Proton Mail
    • No, need to set up - Use SendGrid/Resend first

  4. Analytics Needed:

    • Yes - SendGrid/Resend
    • No - Proton Mail OK

Final Recommendation

For POS2 System:

  1. Start with SendGrid (free tier, easy setup)
  2. Migrate to Proton Mail later if privacy becomes critical
  3. Use Gmail SMTP for local development

This gives you:

  • ✅ Easy start (SendGrid free tier)
  • ✅ Good deliverability
  • ✅ Analytics
  • ✅ Option to switch to Proton Mail later if needed

Which email service would you like to use?