Plugins dedup + planung: Prüf-API, Verzahnung mit Benachrichtigung und Audit-Log

Plugin dedup:
- Öffentliche Prüf-API check_titel(titel, verlag, bgg_id, user) mit
  strukturiertem PruefErgebnis (Konflikte, Verlagsauswahl, Titel-Empfehlung)
- Vier Prüfungen: Verlags-Konflikt, Titel-Varianten (deutsche Version
  bevorzugt: Umlaut-/Wort-Heuristik + BGG Alternate-Names), Spiel oder
  Vorgänger bereits besprochen (BGG boardgameexpansion-Relation +
  rapidfuzz-Fuzzy-Match), Titel in fremder Planungsliste
- BGG-Hilfsclient mit Rate-Limit, netzwerkfrei testbar, degradiert defensiv
- Eigene Migration (Prüfprotokoll dedup_pruefungen) + Prüfseite /dedup
- Fremde Plugin-Tabellen werden nur lesend über die gemeinsame Metadata
  gelesen — keine Import-Abhängigkeiten zwischen Plugins

Plugin planung:
- Migration planungsliste: Titel, Verlag, Ausgabe, Rezensent, Status
  (offen/in_bearbeitung/abgeschlossen), Quelle, Prüf-Befund (JSON)
- Beide Eintragswege durch die dedup-Prüfung: Verschiebung aus den
  Neuheiten (Button „→ Zur Planung“, Neuheit wechselt auf Status planung)
  und händisches Nachtragen im Formular
- Bei Treffern: send_notification an den eintragenden Rezensenten
  (benachrichtigung-Plugin) + Audit-Log-Eintrag (audit-log-Plugin)
- Verlags-Konflikt → Auswahl-Dialog „Welcher Verlag wird geführt?“,
  Entscheidung wird auditiert
- Planungsliste mit Zuordnung, Statuswechsel, Bearbeiten/Löschen;
  Rezensenten nur eigene Einträge, Admin/Redakteur alle

Tests: 45 neue Tests (Heuristik, alle vier Prüfungen mit Fake-BGG-Client,
Protokoll, beide Eintragswege mit Stub-gemockten Abhängigkeiten, Rollen,
Integration mit echten Plugins) — 141 Tests grün.
This commit is contained in:
Flo Hartmann
2026-08-21 19:51:53 +00:00
parent 56cc5943b1
commit 0f12cd952b
21 changed files with 2838 additions and 53 deletions

66
plugins/planung/models.py Normal file
View File

@@ -0,0 +1,66 @@
"""Datenmodell des Plugins „planung“.
Ein Planungseintrag ordnet ein Spiel einem Rezensenten und einer Ausgabe
zu. Einträge entstehen auf zwei Wegen — beide laufen durch die dedup-
Prüfung des dedup-Plugins:
- Verschiebung aus der Neuheitenliste (`quelle = "neuheiten"`),
- händisches Nachtragen im Formular (`quelle = "manuell"`).
Bei Prüftreffern wird der Befund im JSON-Feld `pruefung` mitgespeichert.
"""
from __future__ import annotations
from datetime import datetime
from sqlalchemy import DateTime, ForeignKey, Integer, JSON, String, Text, func
from sqlalchemy.orm import Mapped, mapped_column
from redaktionskern.db import Base
#: Gültige Statuswerte in Ablaufreihenfolge.
STATUS_OFFEN = "offen"
STATUS_IN_BEARBEITUNG = "in_bearbeitung"
STATUS_ABGESCHLOSSEN = "abgeschlossen"
GUELTIGE_STATUS: tuple[str, ...] = (
STATUS_OFFEN,
STATUS_IN_BEARBEITUNG,
STATUS_ABGESCHLOSSEN,
)
#: Deutsche Anzeigenamen der Statuswerte.
STATUS_ANZEIGE: dict[str, str] = {
STATUS_OFFEN: "Offen",
STATUS_IN_BEARBEITUNG: "In Bearbeitung",
STATUS_ABGESCHLOSSEN: "Abgeschlossen",
}
class Planungseintrag(Base):
"""Ein Spiel in der Planungsliste, zugeordnet zu Rezensent und Ausgabe."""
__tablename__ = "planungsliste"
__table_args__ = {"extend_existing": True}
id: Mapped[int] = mapped_column(primary_key=True)
titel: Mapped[str] = mapped_column(String(300))
verlag: Mapped[str | None] = mapped_column(String(300))
autor: Mapped[str | None] = mapped_column(String(300))
#: BoardGameGeek-ID, sofern bekannt (Match-Kriterium der dedup-Prüfung).
bgg_id: Mapped[int | None] = mapped_column(Integer)
#: Magazin-Ausgabe, z. B. „3/2025“ (mehrere Ausgaben parallel möglich).
ausgabe: Mapped[str] = mapped_column(String(100), default="")
rezensent_id: Mapped[int] = mapped_column(ForeignKey("users.id"))
status: Mapped[str] = mapped_column(String(50), default=STATUS_OFFEN)
notizen: Mapped[str | None] = mapped_column(Text)
#: Woher stammt der Eintrag: "neuheiten" oder "manuell".
quelle: Mapped[str] = mapped_column(String(50), default="manuell")
#: Befund der dedup-Prüfung beim Anlegen (Liste von Konflikt-Dicts).
pruefung: Mapped[list | None] = mapped_column(JSON)
erstellt_am: Mapped[datetime] = mapped_column(DateTime, server_default=func.now())
aktualisiert_am: Mapped[datetime] = mapped_column(
DateTime, server_default=func.now(), onupdate=func.now()
)
def __repr__(self) -> str: # pragma: no cover - Debug-Hilfe
return f"<Planungseintrag {self.titel!r} ({self.status})>"