wpp/weirsoe-party-protocol
8
0
Fork 0
Code Issues 19 Pull Requests Actions Packages Projects Releases Wiki Activity
Page: Roadmap TODO
Pages
Architecture PO Beslutninger Quality Gates Roadmap TODO
Clone
2
Roadmap TODO
Asger Geel Weirsoee edited this page 2026-02-27 17:56:19 +01:00
Table of Contents

TODO — Weirsøe Party Protocol (Django)

Projektmål

Byg Weirsøe Party Protocol: en dansk party-webapp platform ala Jackbox, hvor spil vises på storskærm/web, og spillere deltager via mobil.

Navne

  • Platform/repo: weirsoe-party-protocol
  • Spil 1 (inspireret af Fibbage): Fup og Fakta (django-app slug: fupogfakta)

Teknologivalg (besluttet)

  • Backend: Django 6.0.2
  • Realtid: Django Channels + Redis (websocket til host + telefoner)
  • DB: MySQL (test + prod databaser i samme MySQL LXC)
  • Deployment: Proxmox LXC (ikke Docker)

Midlertidige defaults (kan finjusteres senere)

  • Spillere: min 3, max 5
  • Løgntid (X): 45 sek
  • Gættetid (Z): 30 sek
  • Login: username/password for host/admin
  • Join i kørende spil: session-kode

Arbejdsaftale (kommunikation)

  • Giv korte progress updates intermitterende under udvikling (ikke spam).
  • Hvis der opdages nice-to-have eller need-to-have, skriv dem ind i TODO.md med tydelig markering.

Faseplan

Fase 0 — Scope + regler

  • Fastlæg MVP for Spil 1 (Fup og Fakta)
  • Midlertidige defaults sat (X/Z, spillerantal)
  • Fastlæg anti-cheat regler (fx ingen identiske løgne)

Fase 1 — Monorepo + Django skelet

  • Opret Django-projekt (partyhub)
  • Opret apps:
    • core_admin (global administration)
    • fupogfakta (Spil 1)
    • lobby (room/session/player join flow)
    • realtime (channels events, game state broadcast)
    • voice (fælles voice-acting interface)
  • Miljøfiler (.env.test, .env.prod skabeloner)
  • Konfig for MySQL test/prod

Fase 2 — Domænemodel (MVP)

  • GameSession (kode, host, status)
  • Player (nickname, session, score)
  • RoundConfig (kategori, K spørgsmål, point korrekt, point bluff)
  • Category
  • Question (prompt + korrekt svar + kategori)
  • LieAnswer (spillers løgn)
  • Guess (hvilket svar spiller valgte)
  • ScoreEvent (auditérbar pointslog)

Fase 3 — Spilflow Fup og Fakta

  • Lobby: host opretter session, spillere joiner via kode
  • Runde starter med kategori
  • Spørgsmål vises -> alle skriver løgn inden X sek
  • System blander korrekt svar + løgne
  • Guessfase: alle gætter inden Z sek
  • Pointudregning (konfigurerbar pr. runde)
  • Scoreboard + næste spørgsmål/runde
  • Slutresultat

Fase 4 — Voice-acting (platformkrav)

  • Definér TTS provider-interface
  • Voice-queue pr. game session
  • Per-spil hooks for voice lines
  • Konfigurerbare stemmer/sprog/hastighed

Fase 5 — Admin & content management

  • Django admin til kategorier/spørgsmål (grundregistrering)
  • Bulk-import spørgsmål (CSV/JSON)
  • Validering af spørgsmål
  • Rundeopsætning i admin (Y/K/point)

Fase 6 — Drift/admin-app (core_admin)

  • Miljø-checks (DB, Redis, websockets)
  • Port/host sanity checks (read-only)
  • DB indeks-checks
  • Brugeroprettelse (username/password)

Fase 7 — Test og kvalitet

  • Enhedstests for scoring/rules engine
  • Integrationstest for fuld runde
  • Reconnect-scenarier for mobilklient

Fase 8 — Dokumentation (Gitea wiki)

  • Arkitektur-overblik
  • Setup guide (test/prod)
  • Spilflow for Fup og Fakta
  • Driftsguide + fejlsøgning

Fase 9 — Secrets og DB-oprettelse

  • Opret databaser + brugere (wpp_test, wpp_prod)
  • Gem credentials i https://gitea.weircon.dk/agw/Secrets/src/branch/main/secrets.csv
  • Verificér least-privilege

Fase 10 — Deployment i Proxmox LXC

  • Opret dedikeret LXC
  • Installér Python/venv + services
  • Reverse proxy/NPM + TLS
  • Migrations + static + health checks

Backlog — Need-to-have / Nice-to-have

  • (Need-to-have) Rate limiting på join/submit endpoints
  • (Need-to-have) Session-kode brute-force beskyttelse
  • (Need-to-have) Audit-log for host-handlinger (start/stop/skip)
  • (Nice-to-have) Runde-tema musik/lyd-cues
  • (Nice-to-have) Hurtig onboarding-skærm for nye spillere

Fase 11 — i18n (email-manager model)

  • Sæt LANGUAGES op med dev (jank-english), en, da
  • Tilføj LocaleMiddleware + LOCALE_PATHS
  • Brug {% load i18n %} i templates + gettext i Python
  • Opret .po for en og da (dev beholdes som udviklingssprog)
  • Tilføj make-targets/kommandoer for makemessages og compilemessages
  • Tilføj test der sikrer i18n tags i templates (inspireret af email-manager)

Fase 12 — CI/CD og merge-gates (Gitea)

  • Opret CI-workflow i .gitea/workflows/ci.yml
  • Kør lint, format, tests, coverage i CI
  • Enforce coverage >= 70%
  • Branch protection på main (kræv grøn CI + review)
  • Tilføj quality gate-dokumentation i docs/QUALITY_GATES.md