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

fupogfakta/admin.py

@@ -0,0 +1,57 @@
+from django.contrib import admin
+from .models import Category, Question, GameSession, Player, RoundConfig, RoundQuestion, LieAnswer, Guess, ScoreEvent
+
+
+@admin.register(Category)
+class CategoryAdmin(admin.ModelAdmin):
+    list_display = ("name", "slug", "is_active")
+    list_filter = ("is_active",)
+    search_fields = ("name", "slug")
+
+
+@admin.register(Question)
+class QuestionAdmin(admin.ModelAdmin):
+    list_display = ("id", "category", "is_active")
+    list_filter = ("category", "is_active")
+    search_fields = ("prompt", "correct_answer")
+
+
+class PlayerInline(admin.TabularInline):
+    model = Player
+    extra = 0
+
+
+@admin.register(GameSession)
+class GameSessionAdmin(admin.ModelAdmin):
+    list_display = ("code", "host", "status", "current_round", "created_at")
+    list_filter = ("status",)
+    inlines = [PlayerInline]
+    search_fields = ("code", "host__username")
+
+
+@admin.register(RoundConfig)
+class RoundConfigAdmin(admin.ModelAdmin):
+    list_display = ("session", "number", "category", "questions_count", "points_correct", "points_bluff")
+    list_filter = ("category",)
+
+
+@admin.register(RoundQuestion)
+class RoundQuestionAdmin(admin.ModelAdmin):
+    list_display = ("session", "round_number", "question")
+
+
+@admin.register(LieAnswer)
+class LieAnswerAdmin(admin.ModelAdmin):
+    list_display = ("round_question", "player", "text", "created_at")
+
+
+@admin.register(Guess)
+class GuessAdmin(admin.ModelAdmin):
+    list_display = ("round_question", "player", "selected_text", "is_correct", "fooled_player")
+    list_filter = ("is_correct",)
+
+
+@admin.register(ScoreEvent)
+class ScoreEventAdmin(admin.ModelAdmin):
+    list_display = ("session", "player", "delta", "reason", "created_at")
+    list_filter = ("reason",)

fupogfakta/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+
+class FupogfaktaConfig(AppConfig):
+    name = 'fupogfakta'

fupogfakta/migrations/0001_initial.py

@@ -0,0 +1,145 @@
+# Generated by Django 6.0.2 on 2026-02-27 10:47
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Category',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=120, unique=True)),
+                ('slug', models.SlugField(max_length=140, unique=True)),
+                ('is_active', models.BooleanField(default=True)),
+            ],
+            options={
+                'ordering': ['name'],
+            },
+        ),
+        migrations.CreateModel(
+            name='GameSession',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('code', models.CharField(max_length=8, unique=True)),
+                ('status', models.CharField(choices=[('lobby', 'Lobby'), ('lie', 'Løgnfase'), ('guess', 'Gættefase'), ('reveal', 'Reveal'), ('finished', 'Afsluttet')], default='lobby', max_length=16)),
+                ('current_round', models.PositiveIntegerField(default=1)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('host', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='hosted_sessions', to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'ordering': ['-created_at'],
+            },
+        ),
+        migrations.CreateModel(
+            name='Player',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('nickname', models.CharField(max_length=40)),
+                ('score', models.IntegerField(default=0)),
+                ('is_connected', models.BooleanField(default=True)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('session', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='players', to='fupogfakta.gamesession')),
+            ],
+            options={
+                'ordering': ['-score', 'nickname'],
+                'unique_together': {('session', 'nickname')},
+            },
+        ),
+        migrations.CreateModel(
+            name='Question',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('prompt', models.TextField()),
+                ('correct_answer', models.CharField(max_length=255)),
+                ('is_active', models.BooleanField(default=True)),
+                ('category', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='questions', to='fupogfakta.category')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='RoundConfig',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('number', models.PositiveIntegerField()),
+                ('questions_count', models.PositiveIntegerField(default=3)),
+                ('points_correct', models.IntegerField(default=5)),
+                ('points_bluff', models.IntegerField(default=2)),
+                ('lie_seconds', models.PositiveIntegerField(default=45)),
+                ('guess_seconds', models.PositiveIntegerField(default=30)),
+                ('category', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, to='fupogfakta.category')),
+                ('session', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='rounds', to='fupogfakta.gamesession')),
+            ],
+            options={
+                'ordering': ['number'],
+            },
+        ),
+        migrations.CreateModel(
+            name='RoundQuestion',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('round_number', models.PositiveIntegerField()),
+                ('correct_answer', models.CharField(max_length=255)),
+                ('question', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, to='fupogfakta.question')),
+                ('session', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='round_questions', to='fupogfakta.gamesession')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='LieAnswer',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('text', models.CharField(max_length=255)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('player', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='fupogfakta.player')),
+                ('round_question', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='lies', to='fupogfakta.roundquestion')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Guess',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('selected_text', models.CharField(max_length=255)),
+                ('is_correct', models.BooleanField(default=False)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('fooled_player', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='fooled_guesses', to='fupogfakta.player')),
+                ('player', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='fupogfakta.player')),
+                ('round_question', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='guesses', to='fupogfakta.roundquestion')),
+            ],
+        ),
+        migrations.CreateModel(
+            name='ScoreEvent',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('delta', models.IntegerField()),
+                ('reason', models.CharField(max_length=80)),
+                ('meta', models.JSONField(blank=True, default=dict)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('player', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='score_events', to='fupogfakta.player')),
+                ('session', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='score_events', to='fupogfakta.gamesession')),
+            ],
+        ),
+        migrations.AddIndex(
+            model_name='question',
+            index=models.Index(fields=['category', 'is_active'], name='fupogfakta__categor_358d00_idx'),
+        ),
+        migrations.AlterUniqueTogether(
+            name='roundconfig',
+            unique_together={('session', 'number')},
+        ),
+        migrations.AlterUniqueTogether(
+            name='lieanswer',
+            unique_together={('round_question', 'player')},
+        ),
+        migrations.AlterUniqueTogether(
+            name='guess',
+            unique_together={('round_question', 'player')},
+        ),
+    ]

fupogfakta/models.py

@@ -0,0 +1,118 @@
+from django.db import models
+from django.contrib.auth import get_user_model
+
+User = get_user_model()
+
+
+class Category(models.Model):
+    name = models.CharField(max_length=120, unique=True)
+    slug = models.SlugField(max_length=140, unique=True)
+    is_active = models.BooleanField(default=True)
+
+    class Meta:
+        ordering = ["name"]
+
+    def __str__(self):
+        return self.name
+
+
+class Question(models.Model):
+    category = models.ForeignKey(Category, on_delete=models.PROTECT, related_name="questions")
+    prompt = models.TextField()
+    correct_answer = models.CharField(max_length=255)
+    is_active = models.BooleanField(default=True)
+
+    class Meta:
+        indexes = [models.Index(fields=["category", "is_active"])]
+
+    def __str__(self):
+        return f"{self.category.name}: {self.prompt[:60]}"
+
+
+class GameSession(models.Model):
+    class Status(models.TextChoices):
+        LOBBY = "lobby", "Lobby"
+        LIE = "lie", "Løgnfase"
+        GUESS = "guess", "Gættefase"
+        REVEAL = "reveal", "Reveal"
+        FINISHED = "finished", "Afsluttet"
+
+    host = models.ForeignKey(User, on_delete=models.PROTECT, related_name="hosted_sessions")
+    code = models.CharField(max_length=8, unique=True)
+    status = models.CharField(max_length=16, choices=Status.choices, default=Status.LOBBY)
+    current_round = models.PositiveIntegerField(default=1)
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        ordering = ["-created_at"]
+
+    def __str__(self):
+        return f"{self.code} ({self.status})"
+
+
+class Player(models.Model):
+    session = models.ForeignKey(GameSession, on_delete=models.CASCADE, related_name="players")
+    nickname = models.CharField(max_length=40)
+    score = models.IntegerField(default=0)
+    is_connected = models.BooleanField(default=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        unique_together = (("session", "nickname"),)
+        ordering = ["-score", "nickname"]
+
+    def __str__(self):
+        return f"{self.nickname} ({self.session.code})"
+
+
+class RoundConfig(models.Model):
+    session = models.ForeignKey(GameSession, on_delete=models.CASCADE, related_name="rounds")
+    number = models.PositiveIntegerField()
+    category = models.ForeignKey(Category, on_delete=models.PROTECT)
+    questions_count = models.PositiveIntegerField(default=3)
+    points_correct = models.IntegerField(default=5)
+    points_bluff = models.IntegerField(default=2)
+    lie_seconds = models.PositiveIntegerField(default=45)
+    guess_seconds = models.PositiveIntegerField(default=30)
+
+    class Meta:
+        unique_together = (("session", "number"),)
+        ordering = ["number"]
+
+
+class RoundQuestion(models.Model):
+    session = models.ForeignKey(GameSession, on_delete=models.CASCADE, related_name="round_questions")
+    round_number = models.PositiveIntegerField()
+    question = models.ForeignKey(Question, on_delete=models.PROTECT)
+    correct_answer = models.CharField(max_length=255)
+
+
+class LieAnswer(models.Model):
+    round_question = models.ForeignKey(RoundQuestion, on_delete=models.CASCADE, related_name="lies")
+    player = models.ForeignKey(Player, on_delete=models.CASCADE)
+    text = models.CharField(max_length=255)
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        unique_together = (("round_question", "player"),)
+
+
+class Guess(models.Model):
+    round_question = models.ForeignKey(RoundQuestion, on_delete=models.CASCADE, related_name="guesses")
+    player = models.ForeignKey(Player, on_delete=models.CASCADE)
+    selected_text = models.CharField(max_length=255)
+    is_correct = models.BooleanField(default=False)
+    fooled_player = models.ForeignKey(Player, on_delete=models.SET_NULL, null=True, blank=True, related_name="fooled_guesses")
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        unique_together = (("round_question", "player"),)
+
+
+class ScoreEvent(models.Model):
+    session = models.ForeignKey(GameSession, on_delete=models.CASCADE, related_name="score_events")
+    player = models.ForeignKey(Player, on_delete=models.CASCADE, related_name="score_events")
+    delta = models.IntegerField()
+    reason = models.CharField(max_length=80)
+    meta = models.JSONField(default=dict, blank=True)
+    created_at = models.DateTimeField(auto_now_add=True)

fupogfakta/tests.py

@@ -0,0 +1,3 @@
+from django.test import TestCase
+
+# Create your tests here.

fupogfakta/views.py

@@ -0,0 +1,3 @@
+from django.shortcuts import render
+
+# Create your views here.