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:
66
plugins/planung/models.py
Normal file
66
plugins/planung/models.py
Normal 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})>"
|
||||
Reference in New Issue
Block a user