Initial POC: Django + Vue 3 + Inertia.js webapp for devopsdays.org

Replaces the Hugo static site workflow with a database-backed web application.
City organizers can manage their event pages through a browser UI instead of
git, YAML, and pull requests.

Includes:
- Django backend with full data model (events, sponsors, speakers, talks, etc.)
- Public site with server-rendered Django templates + Tailwind CSS
- Organizer editing UI with Vue 3 + Inertia.js
- Django admin for core team
- GitHub OAuth via django-allauth
- Docker Compose for local dev (one command: docker compose up)
- Production Docker setup with GHCR + GitHub Actions CI/CD
- Pulumi program for EC2 provisioning
- Seed script that imports real data from the Hugo repo
- Full PRD documenting architecture, data model, and migration strategy

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: mattstratton

.dockerignore

@@ -0,0 +1,12 @@
+.git
+__pycache__
+*.pyc
+node_modules
+frontend/dist
+.env
+.env.*
+media/
+staticfiles/
+*.md
+deploy/
+.claude/

.github/workflows/deploy.yml

@@ -0,0 +1,55 @@
+name: Build & Deploy
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: devopsdays/devopsdays-web-app
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: Dockerfile.prod
+          push: true
+          tags: |
+            ghcr.io/devopsdays/devopsdays-web-app:latest
+            ghcr.io/devopsdays/devopsdays-web-app:${{ github.sha }}
+
+  deploy:
+    needs: build-and-push
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+
+    steps:
+      - name: Deploy to EC2
+        uses: appleboy/ssh-action@v1
+        with:
+          host: ${{ secrets.EC2_HOST }}
+          username: ec2-user
+          key: ${{ secrets.EC2_SSH_KEY }}
+          script: |
+            cd /opt/devopsdays-web-app
+            docker pull ghcr.io/devopsdays/devopsdays-web-app:latest
+            docker compose -f docker-compose.prod.yml up -d --force-recreate web
+            echo "Deploy complete!"

.gitignore

@@ -0,0 +1,46 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Django
+*.log
+local_settings.py
+db.sqlite3
+media/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Node
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Vite
+frontend/dist/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Docker
+docker-compose.override.yml
+
+# Static files collected by Django
+staticfiles/

CLAUDE.md

@@ -0,0 +1,50 @@
+# devopsdays-web-app
+
+## What is this?
+
+A Django + Vue 3 web application replacing the Hugo static site for devopsdays.org. City organizers manage their event pages through a browser-based UI instead of git/YAML/PRs.
+
+## Architecture
+
+- **Backend:** Django 5.x, PostgreSQL 16, Redis
+- **Public site:** Django templates + Tailwind CSS (server-rendered)
+- **Editing UI:** Inertia.js + Vue 3 (SPA experience, Django handles routing and auth)
+- **Admin:** Django admin with customizations (for core team)
+- **Auth:** django-allauth with GitHub and Google OAuth
+
+## Key Conventions
+
+- Django apps live in `apps/` (events, sponsors, people, users, pages)
+- Public site templates are in `templates/public/` — plain Django templates, no JS framework
+- Vue components for the editing UI are in `frontend/src/pages/` — these are Inertia pages
+- Manage views return `inertia_render()` instead of `render()` — they pass props to Vue components
+- URL patterns: public site at `/`, editing UI at `/manage/`, admin at `/admin/`
+- All models use `BigAutoField` as the primary key
+- Slugs are the primary human-readable identifiers (event slugs are `YYYY-city`)
+
+## Running Locally
+
+```bash
+docker compose up
+docker compose exec web python manage.py migrate
+docker compose exec web python manage.py shell < scripts/seed_data.py
+```
+
+## Data Model
+
+Core entities: City, Event, EventPage, TeamMember, ProgramEntry, Sponsor, SponsorLevel, EventSponsor, Speaker, Talk, User, EventPermission, BlogPost, StaticPage.
+
+See `apps/*/models.py` for full field definitions. The PRD at `../devopsdays-web/PRD-webapp-migration.md` has the complete data model documentation.
+
+## Testing
+
+```bash
+docker compose exec web python -m pytest
+```
+
+## Important Notes
+
+- This is a POC. Not all features from the PRD are implemented.
+- The seed script (`scripts/seed_data.py`) reads from the Hugo repo at `../devopsdays-web`
+- Tailwind is loaded via CDN in the public templates for the POC. Production should use Vite.
+- The Vite dev server runs in Docker alongside Django for HMR on Vue components.

Dockerfile

@@ -0,0 +1,27 @@
+FROM python:3.12-slim
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    libpq-dev \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Python dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy project
+COPY . .
+
+# Collect static files (skipped in dev, run manually in prod)
+# RUN python manage.py collectstatic --noinput
+
+EXPOSE 8000
+
+CMD ["gunicorn", "config.wsgi:application", "--bind", "0.0.0.0:8000", "--reload", "--workers", "2"]

Dockerfile.prod

@@ -0,0 +1,46 @@
+# Stage 1: Build frontend assets
+FROM node:22-alpine AS frontend-build
+
+WORKDIR /app
+COPY package.json package-lock.json* ./
+RUN npm install
+
+COPY vite.config.js tailwind.config.js postcss.config.js ./
+COPY frontend/ frontend/
+COPY templates/ templates/
+
+RUN npm run build
+
+
+# Stage 2: Python application
+FROM python:3.12-slim AS production
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    libpq-dev \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Python dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy project
+COPY . .
+
+# Copy built frontend assets from stage 1
+COPY --from=frontend-build /app/frontend/dist ./frontend/dist
+
+# Collect static files
+RUN DJANGO_SECRET_KEY=build-placeholder \
+    DATABASE_URL=sqlite:///tmp/build.db \
+    python manage.py collectstatic --noinput
+
+EXPOSE 8000
+
+CMD ["gunicorn", "config.wsgi:application", "--bind", "0.0.0.0:8000", "--workers", "3", "--timeout", "120"]