MTG Commander Deck Builder — Project State

Overview

Self-hosted, AI-powered Magic: The Gathering Commander deck builder. Runs as a Docker Compose stack managed via Portainer, exposed externally via Cloudflare Tunnel + Traefik.

Stack: FastAPI (Python 3.12) · React/Vite (TypeScript) · PostgreSQL 16 · Redis 7 · Nginx · Docker Compose

Build Progress

✅ Step 1 — Project scaffold

✅ Step 2 — Database schema

✅ Step 3 — Auth + user management

✅ Step 4 — Collection import

✅ Step 5 — Claude AI integration

✅ Step 6 — React frontend

✅ Step 7 — First deployment

App is live at http://commander.bussenet.ca

Deployment Architecture

Cloudflare Tunnel → Traefik (port 80) → nginx container
Portainer stack ID: 52 (commander-forge)
Backend container manually created outside Portainer — needs reconciliation
Admin login: busse.daniel@gmail.com / Admin1234

Known fixes applied

passlib replaced with bcrypt==4.1.3
npm ci replaced with npm install in frontend Dockerfile
package-lock.json added to repo
nginx baked into image via nginx/Dockerfile
docker-compose.yml uses Traefik labels, no port 80 binding
DATABASE_URL and REDIS_URL passed explicitly as env vars
UserRole enum uses values_callable for lowercase storage
Portainer git source caches aggressively — use --no-cache --pull for rebuilds

Infrastructure

Gitea: http://192.168.0.62:3001 / https://gitea.bussenet.ca
GitHub mirror: https://github.com/danbusse/Commander-Deck-App (private)
Portainer MCP: fixed, using custom mcp-portainer:latest image with -- entrypoint fix
Cloudflare tunnel: degraded (region2 unreachable, ISP routing issue), region1 stable

Environment Variables (Portainer stack env)

SECRET_KEY: changeme (needs replacing)
POSTGRES_PASSWORD: changeme (needs replacing)
DATABASE_URL: postgresql+asyncpg://mtg:changeme@db:5432/mtgdb
REDIS_URL: redis://cache:6379
ANTHROPIC_API_KEY: in Vault at secret/anthropic
ADMIN_EMAIL: busse.daniel@gmail.com
ADMIN_PASSWORD: Admin1234

Next Session — Start Here

Priority 1 — Portainer housekeeping: Backend container was manually created outside Portainer stack. Needs clean redeploy.

Priority 2 — Harden credentials:

SECRET_KEY → openssl rand -hex 32
POSTGRES_PASSWORD → strong password
DATABASE_URL → update to match

Priority 3 — Test end to end:

Try building a deck via Generate mode
Test collection import with Archidekt export
Verify admin approval flow

Priority 4 — GitHub mirror sync: When committing from Windows: push to both Gitea and GitHub git push origin master git push github master Or set up automatic mirror push from Gitea.

2.7 KiB Raw Blame History