🎮 KUMPIR
KUMPIR ist ein browserbasiertes Partyspiel nach dem Prinzip der „heißen Kartoffel".
Eine Lobby, mehrere Spieler, ein unsichtbarer Timer – wer die Kartoffel beim Explodieren hält, verliert die Runde.
Fokus: einfach erklärt, gemeinsam gespielt, schnell gestartet.
🧠 Projektstruktur
Monorepo, npm workspaces.
apps/web → Web-Spiel (Next.js 16 + React 19 + Supabase + TypeScript)apps/discord-bot → Discord-Bot für Preview-Notificationsgame-logic/ → Spielregeln in Klartext & Content (questions_de.json) — siehe game-logic/README.md
Web und Logic sind klar getrennt und werden nicht vermischt.
🚀 Schnellstart
# Einmalig: Dependencies installieren
npm install
# Erstes Setup: legt .env.local an und startet Dev-Server
cd apps/web
npm run play
Die play-Befehl fragt nach deinen Supabase-Werten (URL + Anon Key), schreibt apps/web/.env.local und startet anschließend next dev. Du brauchst die Werte nur einmal — sie liegen unter Supabase → Project Settings → API.
Schon eingerichtet? Einfach npm run dev (root) oder npm --workspace apps/web run dev.
🧪 Tests, Lint, Build
cd apps/web
npm test # Vitest, alle Unit-Tests
npm run lint # ESLint
npm run build # Next-Production-Build
npx tsc --noEmit # TypeScript strict check
npm run e2e # Browser-Tests der Hauptwege (Playwright; lokal z. B. E2E_CHANNEL=msedge, langer Spiel-Test mit E2E_FLOW=1)
CI läuft auf jedem Push/PR (siehe .github/workflows/ci.yml) und checkt Typen, Lint, Tests, Build und die Browser-Tests.
👥 Team & Zuständigkeiten
- Medo – Web / Game Lead → arbeitet in
apps/web
- Sero – Logic / Balance → arbeitet in
game-logic
Jeder bleibt in seinem Ordner, main ist die gemeinsame Wahrheit.
🌿 Git-Workflow
Branches
main → gemeinsame Wahrheit (nie direkt bearbeiten)web → Web-Entwicklung (Vercel-Preview hängt hier dran)logic → Logic-Entwicklung
Grundregeln
- Nie auf
main arbeiten
- Vor dem Arbeiten:
git pull
- Vor dem Merge in
main: git pull auf main
- Jeder bleibt in seinem Workspace (
apps/web bzw. game-logic/)
🧾 Commit-Konvention
Deutsche, einfache Konvention für einen sauberen Verlauf.
Format
typ(bereich): beschreibung
Beispiel
feat(host): lobby erstellen
fix(setup): play-Script auf Windows fixen
Commit-Typen
- chore – Setup & Organisation
- feat – Neue Funktion
- fix – Fehlerbehebung
- refactor – Code umstrukturieren
- docs – Dokumentation
- style – Optik / Formatierung
- test – Tests
Bereiche (optional)
setup · db · host · join · lobby · players · game · ui · realtime · auth
Regeln
- Deutsch, Präsens, kurz & klar
- 1 Commit = 1 Thema
- Keine Emojis im Commit-Text
🔐 Auth-Modus
Login ist aktiv (Konto optional – spielen geht immer auch als Gast). Konto-Einstellungen unter /profile (Migration 077).
NEXT_PUBLIC_GUEST_ONLY=1 schaltet einen reinen Gast-Modus ein: Login/Register/Profil/Bestenliste werden vom Proxy (src/proxy.ts) auf / umgeleitet. Standard (nicht gesetzt oder 0): Login an.- Der Schalter hieß früher
NEXT_PUBLIC_AUTH_DISABLED. Auf Vercel stand der alte Name noch auf 1 und hat den Login in der Produktion unbemerkt abgeschaltet – der alte Name wird nicht mehr beachtet und kann in Vercel gelöscht werden.
- Status-Check:
/api/health zeigt, ob Anmelden per Benutzername serverseitig eingerichtet ist (usernameLogin: true).
🚀 Ziel des Projekts
Erst ein stabiles Basisspiel.
Danach Modi, Achievements, soziale Features.
Kein Overengineering, kein Chaos – Spaß zuerst.
