Newsletter SDLC Process

Process Type: Email Newsletter System Parent Process: BBWS SDLC v1

---

Overview

This process is for creating email newsletter systems including templates, subscriber management, and automated sending.

Applicable Stages

Backend (API)

Stage	Name	Required
1	Requirements	Yes
4	API Tests	Yes
5	API Implementation	Yes
7	Infrastructure	Yes
8	CI/CD	Yes

Frontend (Management UI)

Stage	Name	Required
F1	UI/UX Design	Yes
F3	React Implementation	Yes
F6	Deployment	Yes

Technology Stack

• Email Service: AWS SES
• Subscriber DB: DynamoDB
• Templates: MJML (responsive emails)
• Scheduling: EventBridge
• Analytics: CloudWatch + Custom

Components

Newsletter API

POST /newsletters           # Create newsletter
GET  /newsletters           # List newsletters
GET  /newsletters/{id}      # Get newsletter
POST /newsletters/{id}/send # Send newsletter

Subscriber API

POST /subscribers           # Subscribe
DELETE /subscribers/{id}    # Unsubscribe
GET  /subscribers           # List (admin)

Project Template

newsletter_service/
├── src/
│   ├── handlers/
│   │   ├── newsletter_handlers.py
│   │   ├── subscriber_handlers.py
│   │   └── send_handlers.py
│   ├── services/
│   │   ├── ses_service.py
│   │   └── template_service.py
│   └── templates/
│       └── email/
├── frontend/
│   └── newsletter-admin/
├── terraform/
└── CLAUDE.md

Email Template Structure

<!-- templates/newsletter.mjml -->
<mjml>
  <mj-body>
    <mj-section>
      <mj-column>
        <mj-text>{{HEADER}}</mj-text>
        <mj-image src="{{HERO_IMAGE}}"/>
        <mj-text>{{CONTENT}}</mj-text>
        <mj-button href="{{CTA_LINK}}">{{CTA_TEXT}}</mj-button>
      </mj-column>
    </mj-section>
  </mj-body>
</mjml>

Estimated Duration

Mode	Duration
Agentic	6 hours
Manual	24 hours

Examples

• Marketing Newsletter
• Product Updates
• Weekly Digest
• Promotional Campaigns

---

Quick Start: Use API stages 4-8 + Frontend stages F1, F3, F6.