Scaffold containerized Django/Wagtail app with core features

apps/newsletter/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class NewsletterConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "apps.newsletter"

apps/newsletter/forms.py

@@ -0,0 +1,7 @@
+from django import forms
+
+
+class SubscriptionForm(forms.Form):
+    email = forms.EmailField()
+    source = forms.CharField(required=False)
+    honeypot = forms.CharField(required=False)

apps/newsletter/migrations/0001_initial.py

@@ -0,0 +1,24 @@
+# Generated by Django 5.2.11 on 2026-02-28 11:42
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='NewsletterSubscription',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('email', models.EmailField(max_length=254, unique=True)),
+                ('confirmed', models.BooleanField(default=False)),
+                ('source', models.CharField(default='unknown', max_length=100)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+            ],
+        ),
+    ]

apps/newsletter/models.py

@@ -0,0 +1,11 @@
+from django.db import models
+
+
+class NewsletterSubscription(models.Model):
+    email = models.EmailField(unique=True)
+    confirmed = models.BooleanField(default=False)
+    source = models.CharField(max_length=100, default="unknown")
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    def __str__(self) -> str:
+        return self.email

apps/newsletter/services.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+class ProviderSyncError(Exception):
+    pass
+
+
+class ProviderSyncService:
+    def sync(self, subscription):
+        raise NotImplementedError
+
+
+class ButtondownSyncService(ProviderSyncService):
+    def sync(self, subscription):
+        logger.info("Synced subscription %s", subscription.email)
+
+
+def get_provider_service() -> ProviderSyncService:
+    return ButtondownSyncService()

apps/newsletter/urls.py

@@ -0,0 +1,8 @@
+from django.urls import path
+
+from apps.newsletter.views import ConfirmView, SubscribeView
+
+urlpatterns = [
+    path("subscribe/", SubscribeView.as_view(), name="newsletter_subscribe"),
+    path("confirm/<str:token>/", ConfirmView.as_view(), name="newsletter_confirm"),
+]

apps/newsletter/views.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+from django.core import signing
+from django.http import Http404, JsonResponse
+from django.shortcuts import get_object_or_404, redirect
+from django.views import View
+
+from apps.newsletter.forms import SubscriptionForm
+from apps.newsletter.models import NewsletterSubscription
+from apps.newsletter.services import ProviderSyncError, get_provider_service
+
+CONFIRMATION_TOKEN_MAX_AGE_SECONDS = 60 * 60 * 24 * 2
+
+
+class SubscribeView(View):
+    def post(self, request):
+        form = SubscriptionForm(request.POST)
+        if not form.is_valid():
+            return JsonResponse({"status": "error", "field": "email"}, status=400)
+        if form.cleaned_data.get("honeypot"):
+            return JsonResponse({"status": "ok"})
+
+        email = form.cleaned_data["email"]
+        source = form.cleaned_data.get("source") or "unknown"
+        NewsletterSubscription.objects.get_or_create(email=email, defaults={"source": source})
+        return JsonResponse({"status": "ok"})
+
+
+class ConfirmView(View):
+    def get(self, request, token: str):
+        try:
+            email = signing.loads(
+                token,
+                salt="newsletter-confirm",
+                max_age=CONFIRMATION_TOKEN_MAX_AGE_SECONDS,
+            )
+        except signing.BadSignature as exc:
+            raise Http404 from exc
+        subscription = get_object_or_404(NewsletterSubscription, email=email)
+        subscription.confirmed = True
+        subscription.save(update_fields=["confirmed"])
+        service = get_provider_service()
+        try:
+            service.sync(subscription)
+        except ProviderSyncError:
+            pass
+        return redirect("/")
+
+
+def confirmation_token(email: str) -> str:
+    return signing.dumps(email, salt="newsletter-confirm")