feat: version for scores

highscore/scores/api/__init__.py

@@ -0,0 +1,3 @@
+from .views import router
+
+__all__ = ["router"]

highscore/scores/api/schemas.py

@@ -0,0 +1,25 @@
+from ninja import Schema
+
+from app.api_base import BaseSchema
+from scores.models import Score
+
+
+class ScoreIn(Schema, BaseSchema):
+    username: str
+    points: int
+
+
+class ScoreOut(Schema, BaseSchema):
+    id: int
+    username: str
+    points: int
+    version: str | None
+    created_at: str
+
+    @staticmethod
+    def resolve_version(obj: Score) -> str | None:
+        return obj.version.name if obj.version_id else None
+
+    @staticmethod
+    def resolve_created_at(obj: Score) -> str:
+        return obj.created_at.isoformat()

highscore/scores/api/views.py

@@ -0,0 +1,42 @@
+from typing import Annotated
+
+from django.http import HttpRequest
+from ninja import Header
+from ninja.pagination import PageNumberPagination, paginate
+
+from app.api_base import CamelCaseRouter
+from scores.models import Score, Version
+
+from .schemas import ScoreIn, ScoreOut
+
+router = CamelCaseRouter()
+
+
+def _resolve_version(name: str | None) -> Version:
+    if name:
+        version, _ = Version.objects.get_or_create(name=name)
+        return version
+    version = Version.objects.order_by("-created_at").first()
+    if version is None:
+        version = Version.objects.create(name="default")
+    return version
+
+
+@router.post("", response=ScoreOut)
+def submit_score(
+    request: HttpRequest,
+    payload: ScoreIn,
+    x_game_version: Annotated[str | None, Header(alias="X-Game-Version")] = None,
+) -> Score:
+    version = _resolve_version(x_game_version)
+    return Score.objects.create(username=payload.username, points=payload.points, version=version)
+
+
+@router.get("", response=list[ScoreOut])
+@paginate(PageNumberPagination, page_size=20)
+def list_scores(
+    request: HttpRequest,
+    x_game_version: Annotated[str | None, Header(alias="X-Game-Version")] = None,
+) -> list[Score]:
+    version = _resolve_version(x_game_version)
+    return Score.objects.filter(version=version).select_related("version")