Kurseinteilung
Instruktoren und Praxisanleiter tragen sich selbst für Kurs-Termine ein. Ein Admin legt Kurse und Termine an (je Termin, wie viele Instruktoren und Praxisanleiter gebraucht werden), verschickt einen Einladungslink und sieht auf einen Blick, wo noch jemand fehlt. Wer sich nach den fixen Plätzen einträgt, ist Backup und rückt bei Ausfällen nach.
Lokale Entwicklung
Voraussetzungen: Node 22+, pnpm, Docker.
pnpm install
pnpm sb:start # lokales Supabase in Docker
pnpm exec supabase status -o env # Werte für .env.local
cp .env.example .env.local # und ausfüllen (siehe Kommentare)
pnpm db:migrate # Tabellen im Schema "app" anlegen
pnpm dev # http://localhost:3000
- Login-Mails landen lokal in Mailpit: http://127.0.0.1:54324
- Benachrichtigungs-Mails werden lokal (ohne
RESEND_API_KEY) in der Konsole ausgegeben.
- Die E-Mail in
ADMIN_EMAILS kann sich direkt unter /login anmelden und ist Admin.
- Den Einladungslink für weitere Personen findest du als Admin unter Personen.
Weitere Befehle: pnpm typecheck, pnpm lint, pnpm format, pnpm db:generate (nach Änderungen an lib/db/schema.ts), pnpm sb:stop.
Deployment
Alles läuft in den Gratis-Tarifen. Diese Schritte kann nur der Eigentümer der Accounts machen.
1. Domain (Cloudflare Registrar)
Domain bei Cloudflare kaufen, z. B. kurseinteilung.org. Den Namen „Rotes Kreuz“ und das Emblem nicht verwenden (gesetzlich geschützt).
2. Resend (E-Mail-Versand)
- Account auf resend.com anlegen, Domains → Add Domain (am besten eine Subdomain wie
mail.<domain>).
- Die angezeigten DNS-Einträge (SPF, DKIM, ggf. MX) in Cloudflare unter DNS anlegen und verifizieren lassen.
- Unter API Keys einen Key erstellen. Er wird zweimal gebraucht: als SMTP-Passwort in Supabase und als
RESEND_API_KEY in Vercel.
3. Supabase-Projekt
- Neues Projekt auf supabase.com anlegen und über Integrations → Vercel mit dem Vercel-Projekt verbinden. Die Integration legt in Vercel u. a.
POSTGRES_URL (App), POSTGRES_URL_NON_POOLING (Migrationen), SUPABASE_URL, SUPABASE_PUBLISHABLE_KEY und SUPABASE_SECRET_KEY an. Die Region muss zu regions in vercel.json passen (derzeit dub1 ↔ Supabase eu-west-1).
- Authentication → Sign In / Providers: „Allow new users to sign up“ aus. Den Provider Email eingeschaltet lassen (sonst gehen keine Magic Links).
- Authentication → Emails → SMTP Settings: Custom SMTP an, Host
smtp.resend.com, Port 465, User resend, Passwort = Resend-API-Key, Absender z. B. noreply@mail.<domain>.
- Authentication → Emails → Templates → Magic Link: Betreff
Dein Login-Link für die Kurseinteilung, Inhalt aus supabase/templates/magic-link.html kopieren.
- Authentication → URL Configuration: Site URL
https://<domain>, Redirect URL https://<domain>/auth/confirm.
- Authentication → Rate Limits: E-Mail-Limit auf z. B. 100 pro Stunde erhöhen.
- Data API in den Projekteinstellungen ausschalten (die App greift direkt auf Postgres zu; die Tabellen liegen ohnehin im nicht freigegebenen Schema
app).
Migrationen laufen bei jedem Vercel-Build automatisch (buildCommand in vercel.json).
4. Vercel
- Auf vercel.com Add New → Project, das GitHub-Repo importieren (Framework: Next.js).
- Zusätzlich zu den Variablen der Supabase-Integration setzen (siehe
.env.example):
RESEND_API_KEY, EMAIL_FROM (z. B. Kurseinteilung <noreply@mail.<domain>>), APP_URL (https://<domain>), ADMIN_EMAILS, CRON_SECRET (beliebiger langer Zufallswert, als „Sensitive“).
- Deployen. Jeder Push auf
main deployt automatisch.
- Settings → Domains:
<domain> hinzufügen und den angezeigten DNS-Eintrag in Cloudflare anlegen, mit Proxy-Status DNS only (graue Wolke).
- Der tägliche Cron-Job aus
vercel.json ruft /api/keepalive auf. Vercel schickt CRON_SECRET automatisch mit.
Demo-Instanz
Eine eigene Instanz zum Vorführen, z. B. für Entscheider:innen: dieselbe App mit erfundenen Personen und Kursen, ohne Login. Unter /demo gibt es drei Wege hinein:
- Schaufenster (
/demo/schaufenster): Laptop (Anna, Koordination) und Handy (Ben, Clara, eine neue Person) nebeneinander, beide live. Eine Tour spielt die Geschichte von selbst ab: Lücken sehen, Kurs anlegen, per Link registrieren, eintragen, kurzfristig austragen (Platz wird ausgeschrieben), Backup übernimmt, E-Mails, Lücke schließen, Verlauf. Ein Klick in ein Gerät hält sie an, nach 90 Sekunden ohne Klick beginnt sie von vorn. ?modus=schritte startet Schritt für Schritt.
- Rundgang in der App: dieselbe Tour in einem Fenster, passt aufs Handy.
- Selbst ausprobieren: als Anna, Ben oder Clara; oben in der Demo-Leiste wechselt man die Person.
E-Mails werden nicht verschickt, sondern landen im Demo-Postfach der jeweiligen Person (mit Banner, wenn eine neue ankommt). Die Daten (lib/demo-data.ts, Termine relativ zu heute) werden bei jedem Start von Schaufenster oder Rundgang, über „Zurücksetzen“ und jede Nacht per Cron neu angelegt. Wer gleichzeitig dieselbe Demo benutzt, sieht die Änderungen der anderen.
DEMO_MODE=true nur in einer eigenen Instanz mit eigener Datenbank setzen. Damit kann jede:r als jede Person auftreten, und das Zurücksetzen löscht alle Personen, Kurse und Termine.
Lokal
Eine eigene Datenbank im lokalen Supabase-Postgres, damit die Entwicklungsdaten bleiben:
docker exec supabase_db_kurseinteilung psql -U postgres -c "create database kurseinteilung_demo"
docker exec -i supabase_db_kurseinteilung psql -U postgres -d kurseinteilung_demo < supabase/demo-database.sql
DATABASE_URL=postgresql://postgres:[email protected]:54322/kurseinteilung_demo pnpm db:migrate
DEMO_MODE=true DATABASE_URL=postgresql://postgres:[email protected]:54322/kurseinteilung_demo pnpm dev
Dann http://localhost:3000/demo öffnen.
Gehostet
Ein zweites Supabase-Projekt und ein zweites Vercel-Projekt aus demselben Repo, wie unter Deployment beschrieben, aber ohne Domain-, Resend- und Auth-Einstellungen (die Demo verschickt nichts und nutzt Supabase Auth nicht). Zusätzlich DEMO_MODE=true setzen, ADMIN_EMAILS leer lassen, APP_URL auf die Demo-URL, EMAIL_FROM und CRON_SECRET auf beliebige Werte. Die Demo legt ihre Personen direkt in auth.users an; die Tabelle bringt jedes Supabase-Projekt mit.
Hinweise
- Supabase pausiert Gratis-Projekte nach 7 Tagen ohne Aktivität. Der tägliche Keepalive-Cron verhindert das.
- Vercel Hobby ist nur für nicht-kommerzielle Nutzung erlaubt. Ein ehrenamtliches Projekt für einen gemeinnützigen Verein, an dem niemand verdient, passt. Wird die Arbeit bezahlt, auf Vercel Pro wechseln oder auf Cloudflare Workers (OpenNext) umziehen; der Code funktioniert in beiden Fällen.
