Bootstrap Weirsøe Party Protocol with initial game model and workflow

This commit is contained in:
2026-02-27 12:09:21 +01:00
commit fa1c951c8c
6010 changed files with 762251 additions and 0 deletions

27
docs/ARCHITECTURE.md Normal file
View File

@@ -0,0 +1,27 @@
# Arkitektur (MVP)
## Moduler
- `core_admin`: global drift/admin, health, valideringer
- `lobby`: session creation/join, player presence
- `fupogfakta`: game rules, rounds, scoring (spil 1)
- `realtime`: websocket events + state sync
- `voice`: fælles voice-acting/TTS interface
## Auth & sessions
- Login (username/password) kræves for at oprette/hoste spil
- Deltagelse i kørende spil sker via session-kode
## Voice-acting (platformkrav)
- Alle spil skal kunne afspille voice lines via fælles interface
- Voice er modulært pr. spil (ikke hardcoded)
## Realtidsmodel
- Host-screen og mobilklienter forbinder via websocket
- Autoritativ game state ligger server-side
- Klienter sender intents (`submit_lie`, `submit_guess`)
- Server broadcaster state transitions
## Datamodel-principper
- Score beregnes server-side
- Hver scoreændring gemmes i `ScoreEvent`
- Runde-konfiguration gemmes per session (points ikke hardcoded)

17
docs/GIT_WORKFLOW.md Normal file
View File

@@ -0,0 +1,17 @@
# Git workflow
## Branches
- `main`: stabil baseline
- `feature/<name>`: løbende udvikling
- `release/vX.Y.Z`: release-klargøring
## Commit-strategi
- Commit often, små commits med klare budskaber.
## Release-flow
1. Arbejd i `feature/*`
2. Merge til `main`
3. Opret `release/vX.Y.Z` fra `main`
4. Opdater `VERSION` + `CHANGELOG.md`
5. Tag: `vX.Y.Z`
6. Push branch + tag til Gitea