Files
Flo Hartmann 0f12cd952b 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.
2026-08-21 19:51:53 +00:00

39 lines
1.5 KiB
Python

"""Datenmodell des Plugins „dedup“.
Das Plugin speichert ein Protokoll der durchgeführten Prüfungen: wer hat
wann welchen Titel prüfen lassen und was wurde befunden. Die Fachdaten der
geprüften Spiele liegen in den Plugin-Tabellen von „neuheiten“ und
„planung“ — dedup liest diese ausschließlich lesend über die gemeinsame
SQLAlchemy-Metadata und schreibt keine fremden Tabellen.
"""
from __future__ import annotations
from datetime import datetime
from sqlalchemy import JSON, DateTime, Integer, String, func
from sqlalchemy.orm import Mapped, mapped_column
from redaktionskern.db import Base
class Pruefung(Base):
"""Protokolleintrag einer durchgeführten dedup-Prüfung."""
__tablename__ = "dedup_pruefungen"
__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))
bgg_id: Mapped[int | None] = mapped_column(Integer)
#: Liste von Konflikt-Dicts ({art, beschreibung, details}) oder None.
konflikte: Mapped[list | None] = mapped_column(JSON)
geprueft_durch_id: Mapped[int | None] = mapped_column(Integer)
geprueft_durch: Mapped[str] = mapped_column(String(100), default="")
erstellt_am: Mapped[datetime] = mapped_column(
DateTime, server_default=func.now()
)
def __repr__(self) -> str: # pragma: no cover - Debug-Hilfe
return f"<Pruefung {self.titel!r}>"