Phase 1: Kern mit Plugin-System, Auth/Rollen, Migrations, Plugin-Stubs

- redaktionskern (src/): schlanker Kern — App-Fabrik, Plugin-Loader
  (Entry-Points + plugins/-Verzeichnis), Migrations-Laufzeit
  (schema_migrations pro Plugin, SQLite-/Postgres-portabel),
  Auth mit Argon2id + Session-Cookies, Rollen admin/redakteur/rezensent,
  Benutzerverwaltung für Admins
- plugins/: 8 ladbare Stubs (neuheiten, dedup, planung, archiv,
  erinnerung, benachrichtigung, audit-log, export) nach Plugin-Vertrag
- Frontend: Jinja2 + Tailwind (CDN) + HTMX + Alpine.js, UI deutsch
- Tests: 28 pytest-Fälle (Loader, Lifecycle, Entry-Points, Migrations-
  Idempotenz, Login/Logout, Rollen-Zugriff, Benutzerverwaltung)
- Docker/Podman: Compose (Traefik-Labels) + Dockerfile (uv)
- README.md mit Setup-Anleitung

plugins/__init__.py

@@ -0,0 +1,5 @@
+"""Lokale Plugins der Spiele-Redaktion.
+
+Jeder Unterordner ist ein Plugin gemäß redaktionskern.contracts.BasePlugin.
+Der Loader im Kern findet diese Ordner automatisch.
+"""

plugins/archiv/__init__.py

@@ -0,0 +1,41 @@
+"""Plugin „archiv“ — Platzhalter gemäß Plugin-Vertrag.
+
+Implementiert in einer späteren Phase. Der Stub zeigt den vollen Vertrag:
+eigene Route, eigenes Template, Lifecycle-Hooks, Migrations-Schnittstelle.
+"""
+from __future__ import annotations
+
+from fastapi import Depends, Request
+
+from redaktionskern.auth.deps import require_user
+from redaktionskern.auth.models import User
+from redaktionskern.contracts import BasePlugin, NavEntry
+
+
+class ArchivPlugin(BasePlugin):
+    name = "archiv"
+    title = "Archiv"
+    description = "Automatische Archivierung von Titeln älter als 12 Monate (Platzhalter)."
+
+    def __init__(self) -> None:
+        super().__init__()
+
+        @self.router.get("/archiv")
+        def seite(request: Request, user: User = Depends(require_user)):
+            """Platzhalterseite des Plugins."""
+            return self.context.templates.TemplateResponse(
+                request=request,
+                name="archiv/index.html",
+                context={
+                    "user": user,
+                    "titel": self.title,
+                    "name": self.name,
+                    "version": self.version,
+                },
+            )
+
+    def navigation(self) -> list[NavEntry]:
+        return [NavEntry(label=self.title, url="/archiv")]
+
+
+plugin = ArchivPlugin()

plugins/archiv/templates/archiv/index.html

@@ -0,0 +1,10 @@
+{% extends "base.html" %}
+{% block titel %}{{ titel }} — Spiele-Redaktion{% endblock %}
+{% block inhalt %}
+<h1 class="text-2xl font-bold mb-2">{{ titel }}</h1>
+<p class="text-slate-600 max-w-2xl">
+  Plugin <code class="bg-slate-200 rounded px-1 py-0.5 text-sm">{{ name }}</code>
+  in Version {{ version }} ist geladen.
+  Diese Seite ist ein Platzhalter &mdash; die Funktion wird in einer sp&auml;teren Phase implementiert.
+</p>
+{% endblock %}

plugins/audit-log/__init__.py

@@ -0,0 +1,41 @@
+"""Plugin „audit-log“ — Platzhalter gemäß Plugin-Vertrag.
+
+Implementiert in einer späteren Phase. Der Stub zeigt den vollen Vertrag:
+eigene Route, eigenes Template, Lifecycle-Hooks, Migrations-Schnittstelle.
+"""
+from __future__ import annotations
+
+from fastapi import Depends, Request
+
+from redaktionskern.auth.deps import require_user
+from redaktionskern.auth.models import User
+from redaktionskern.contracts import BasePlugin, NavEntry
+
+
+class AuditLogPlugin(BasePlugin):
+    name = "audit-log"
+    title = "Audit-Log"
+    description = "Wer hat was wann verschoben, eingetragen oder geändert (Platzhalter)."
+
+    def __init__(self) -> None:
+        super().__init__()
+
+        @self.router.get("/audit-log")
+        def seite(request: Request, user: User = Depends(require_user)):
+            """Platzhalterseite des Plugins."""
+            return self.context.templates.TemplateResponse(
+                request=request,
+                name="audit-log/index.html",
+                context={
+                    "user": user,
+                    "titel": self.title,
+                    "name": self.name,
+                    "version": self.version,
+                },
+            )
+
+    def navigation(self) -> list[NavEntry]:
+        return [NavEntry(label=self.title, url="/audit-log")]
+
+
+plugin = AuditLogPlugin()

plugins/audit-log/templates/audit-log/index.html

@@ -0,0 +1,10 @@
+{% extends "base.html" %}
+{% block titel %}{{ titel }} — Spiele-Redaktion{% endblock %}
+{% block inhalt %}
+<h1 class="text-2xl font-bold mb-2">{{ titel }}</h1>
+<p class="text-slate-600 max-w-2xl">
+  Plugin <code class="bg-slate-200 rounded px-1 py-0.5 text-sm">{{ name }}</code>
+  in Version {{ version }} ist geladen.
+  Diese Seite ist ein Platzhalter &mdash; die Funktion wird in einer sp&auml;teren Phase implementiert.
+</p>
+{% endblock %}

plugins/benachrichtigung/__init__.py

@@ -0,0 +1,41 @@
+"""Plugin „benachrichtigung“ — Platzhalter gemäß Plugin-Vertrag.
+
+Implementiert in einer späteren Phase. Der Stub zeigt den vollen Vertrag:
+eigene Route, eigenes Template, Lifecycle-Hooks, Migrations-Schnittstelle.
+"""
+from __future__ import annotations
+
+from fastapi import Depends, Request
+
+from redaktionskern.auth.deps import require_user
+from redaktionskern.auth.models import User
+from redaktionskern.contracts import BasePlugin, NavEntry
+
+
+class BenachrichtigungPlugin(BasePlugin):
+    name = "benachrichtigung"
+    title = "Benachrichtigungen"
+    description = "E-Mail, Telegram und In-App per Adapter-Muster (Platzhalter)."
+
+    def __init__(self) -> None:
+        super().__init__()
+
+        @self.router.get("/benachrichtigung")
+        def seite(request: Request, user: User = Depends(require_user)):
+            """Platzhalterseite des Plugins."""
+            return self.context.templates.TemplateResponse(
+                request=request,
+                name="benachrichtigung/index.html",
+                context={
+                    "user": user,
+                    "titel": self.title,
+                    "name": self.name,
+                    "version": self.version,
+                },
+            )
+
+    def navigation(self) -> list[NavEntry]:
+        return [NavEntry(label=self.title, url="/benachrichtigung")]
+
+
+plugin = BenachrichtigungPlugin()

plugins/benachrichtigung/templates/benachrichtigung/index.html

@@ -0,0 +1,10 @@
+{% extends "base.html" %}
+{% block titel %}{{ titel }} — Spiele-Redaktion{% endblock %}
+{% block inhalt %}
+<h1 class="text-2xl font-bold mb-2">{{ titel }}</h1>
+<p class="text-slate-600 max-w-2xl">
+  Plugin <code class="bg-slate-200 rounded px-1 py-0.5 text-sm">{{ name }}</code>
+  in Version {{ version }} ist geladen.
+  Diese Seite ist ein Platzhalter &mdash; die Funktion wird in einer sp&auml;teren Phase implementiert.
+</p>
+{% endblock %}

plugins/dedup/__init__.py

@@ -0,0 +1,41 @@
+"""Plugin „dedup“ — Platzhalter gemäß Plugin-Vertrag.
+
+Implementiert in einer späteren Phase. Der Stub zeigt den vollen Vertrag:
+eigene Route, eigenes Template, Lifecycle-Hooks, Migrations-Schnittstelle.
+"""
+from __future__ import annotations
+
+from fastapi import Depends, Request
+
+from redaktionskern.auth.deps import require_user
+from redaktionskern.auth.models import User
+from redaktionskern.contracts import BasePlugin, NavEntry
+
+
+class DedupPlugin(BasePlugin):
+    name = "dedup"
+    title = "Dedup-Prüfung"
+    description = "Prüfungen bei Import und händischem Eintrag (Platzhalter)."
+
+    def __init__(self) -> None:
+        super().__init__()
+
+        @self.router.get("/dedup")
+        def seite(request: Request, user: User = Depends(require_user)):
+            """Platzhalterseite des Plugins."""
+            return self.context.templates.TemplateResponse(
+                request=request,
+                name="dedup/index.html",
+                context={
+                    "user": user,
+                    "titel": self.title,
+                    "name": self.name,
+                    "version": self.version,
+                },
+            )
+
+    def navigation(self) -> list[NavEntry]:
+        return [NavEntry(label=self.title, url="/dedup")]
+
+
+plugin = DedupPlugin()

plugins/dedup/templates/dedup/index.html

@@ -0,0 +1,10 @@
+{% extends "base.html" %}
+{% block titel %}{{ titel }} — Spiele-Redaktion{% endblock %}
+{% block inhalt %}
+<h1 class="text-2xl font-bold mb-2">{{ titel }}</h1>
+<p class="text-slate-600 max-w-2xl">
+  Plugin <code class="bg-slate-200 rounded px-1 py-0.5 text-sm">{{ name }}</code>
+  in Version {{ version }} ist geladen.
+  Diese Seite ist ein Platzhalter &mdash; die Funktion wird in einer sp&auml;teren Phase implementiert.
+</p>
+{% endblock %}

plugins/erinnerung/__init__.py

@@ -0,0 +1,41 @@
+"""Plugin „erinnerung“ — Platzhalter gemäß Plugin-Vertrag.
+
+Implementiert in einer späteren Phase. Der Stub zeigt den vollen Vertrag:
+eigene Route, eigenes Template, Lifecycle-Hooks, Migrations-Schnittstelle.
+"""
+from __future__ import annotations
+
+from fastapi import Depends, Request
+
+from redaktionskern.auth.deps import require_user
+from redaktionskern.auth.models import User
+from redaktionskern.contracts import BasePlugin, NavEntry
+
+
+class ErinnerungPlugin(BasePlugin):
+    name = "erinnerung"
+    title = "Erinnerungen"
+    description = "Erinnerungen vor Redaktionsschluss pro Ausgabe (Platzhalter)."
+
+    def __init__(self) -> None:
+        super().__init__()
+
+        @self.router.get("/erinnerung")
+        def seite(request: Request, user: User = Depends(require_user)):
+            """Platzhalterseite des Plugins."""
+            return self.context.templates.TemplateResponse(
+                request=request,
+                name="erinnerung/index.html",
+                context={
+                    "user": user,
+                    "titel": self.title,
+                    "name": self.name,
+                    "version": self.version,
+                },
+            )
+
+    def navigation(self) -> list[NavEntry]:
+        return [NavEntry(label=self.title, url="/erinnerung")]
+
+
+plugin = ErinnerungPlugin()

plugins/erinnerung/templates/erinnerung/index.html

@@ -0,0 +1,10 @@
+{% extends "base.html" %}
+{% block titel %}{{ titel }} — Spiele-Redaktion{% endblock %}
+{% block inhalt %}
+<h1 class="text-2xl font-bold mb-2">{{ titel }}</h1>
+<p class="text-slate-600 max-w-2xl">
+  Plugin <code class="bg-slate-200 rounded px-1 py-0.5 text-sm">{{ name }}</code>
+  in Version {{ version }} ist geladen.
+  Diese Seite ist ein Platzhalter &mdash; die Funktion wird in einer sp&auml;teren Phase implementiert.
+</p>
+{% endblock %}

plugins/export/__init__.py

@@ -0,0 +1,41 @@
+"""Plugin „export“ — Platzhalter gemäß Plugin-Vertrag.
+
+Implementiert in einer späteren Phase. Der Stub zeigt den vollen Vertrag:
+eigene Route, eigenes Template, Lifecycle-Hooks, Migrations-Schnittstelle.
+"""
+from __future__ import annotations
+
+from fastapi import Depends, Request
+
+from redaktionskern.auth.deps import require_user
+from redaktionskern.auth.models import User
+from redaktionskern.contracts import BasePlugin, NavEntry
+
+
+class ExportPlugin(BasePlugin):
+    name = "export"
+    title = "Export"
+    description = "Listen als CSV und PDF (Platzhalter)."
+
+    def __init__(self) -> None:
+        super().__init__()
+
+        @self.router.get("/export")
+        def seite(request: Request, user: User = Depends(require_user)):
+            """Platzhalterseite des Plugins."""
+            return self.context.templates.TemplateResponse(
+                request=request,
+                name="export/index.html",
+                context={
+                    "user": user,
+                    "titel": self.title,
+                    "name": self.name,
+                    "version": self.version,
+                },
+            )
+
+    def navigation(self) -> list[NavEntry]:
+        return [NavEntry(label=self.title, url="/export")]
+
+
+plugin = ExportPlugin()

plugins/export/templates/export/index.html

@@ -0,0 +1,10 @@
+{% extends "base.html" %}
+{% block titel %}{{ titel }} — Spiele-Redaktion{% endblock %}
+{% block inhalt %}
+<h1 class="text-2xl font-bold mb-2">{{ titel }}</h1>
+<p class="text-slate-600 max-w-2xl">
+  Plugin <code class="bg-slate-200 rounded px-1 py-0.5 text-sm">{{ name }}</code>
+  in Version {{ version }} ist geladen.
+  Diese Seite ist ein Platzhalter &mdash; die Funktion wird in einer sp&auml;teren Phase implementiert.
+</p>
+{% endblock %}

plugins/neuheiten/__init__.py

@@ -0,0 +1,41 @@
+"""Plugin „neuheiten“ — Platzhalter gemäß Plugin-Vertrag.
+
+Implementiert in einer späteren Phase. Der Stub zeigt den vollen Vertrag:
+eigene Route, eigenes Template, Lifecycle-Hooks, Migrations-Schnittstelle.
+"""
+from __future__ import annotations
+
+from fastapi import Depends, Request
+
+from redaktionskern.auth.deps import require_user
+from redaktionskern.auth.models import User
+from redaktionskern.contracts import BasePlugin, NavEntry
+
+
+class NeuheitenPlugin(BasePlugin):
+    name = "neuheiten"
+    title = "Neuheiten"
+    description = "KI-gestützte Neuheitenliste aus der BoardGameGeek-API (Platzhalter)."
+
+    def __init__(self) -> None:
+        super().__init__()
+
+        @self.router.get("/neuheiten")
+        def seite(request: Request, user: User = Depends(require_user)):
+            """Platzhalterseite des Plugins."""
+            return self.context.templates.TemplateResponse(
+                request=request,
+                name="neuheiten/index.html",
+                context={
+                    "user": user,
+                    "titel": self.title,
+                    "name": self.name,
+                    "version": self.version,
+                },
+            )
+
+    def navigation(self) -> list[NavEntry]:
+        return [NavEntry(label=self.title, url="/neuheiten")]
+
+
+plugin = NeuheitenPlugin()

plugins/neuheiten/templates/neuheiten/index.html

@@ -0,0 +1,10 @@
+{% extends "base.html" %}
+{% block titel %}{{ titel }} — Spiele-Redaktion{% endblock %}
+{% block inhalt %}
+<h1 class="text-2xl font-bold mb-2">{{ titel }}</h1>
+<p class="text-slate-600 max-w-2xl">
+  Plugin <code class="bg-slate-200 rounded px-1 py-0.5 text-sm">{{ name }}</code>
+  in Version {{ version }} ist geladen.
+  Diese Seite ist ein Platzhalter &mdash; die Funktion wird in einer sp&auml;teren Phase implementiert.
+</p>
+{% endblock %}

plugins/planung/__init__.py

@@ -0,0 +1,41 @@
+"""Plugin „planung“ — Platzhalter gemäß Plugin-Vertrag.
+
+Implementiert in einer späteren Phase. Der Stub zeigt den vollen Vertrag:
+eigene Route, eigenes Template, Lifecycle-Hooks, Migrations-Schnittstelle.
+"""
+from __future__ import annotations
+
+from fastapi import Depends, Request
+
+from redaktionskern.auth.deps import require_user
+from redaktionskern.auth.models import User
+from redaktionskern.contracts import BasePlugin, NavEntry
+
+
+class PlanungPlugin(BasePlugin):
+    name = "planung"
+    title = "Planung"
+    description = "Planungsliste mit Zuordnung an Rezensenten (Platzhalter)."
+
+    def __init__(self) -> None:
+        super().__init__()
+
+        @self.router.get("/planung")
+        def seite(request: Request, user: User = Depends(require_user)):
+            """Platzhalterseite des Plugins."""
+            return self.context.templates.TemplateResponse(
+                request=request,
+                name="planung/index.html",
+                context={
+                    "user": user,
+                    "titel": self.title,
+                    "name": self.name,
+                    "version": self.version,
+                },
+            )
+
+    def navigation(self) -> list[NavEntry]:
+        return [NavEntry(label=self.title, url="/planung")]
+
+
+plugin = PlanungPlugin()

plugins/planung/templates/planung/index.html

@@ -0,0 +1,10 @@
+{% extends "base.html" %}
+{% block titel %}{{ titel }} — Spiele-Redaktion{% endblock %}
+{% block inhalt %}
+<h1 class="text-2xl font-bold mb-2">{{ titel }}</h1>
+<p class="text-slate-600 max-w-2xl">
+  Plugin <code class="bg-slate-200 rounded px-1 py-0.5 text-sm">{{ name }}</code>
+  in Version {{ version }} ist geladen.
+  Diese Seite ist ein Platzhalter &mdash; die Funktion wird in einer sp&auml;teren Phase implementiert.
+</p>
+{% endblock %}