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
@@ -1,41 +1,529 @@
|
||||
"""Plugin „planung“ — Platzhalter gemäß Plugin-Vertrag.
|
||||
"""Plugin „planung“ — Planungsliste mit Zuordnung an Rezensenten.
|
||||
|
||||
Implementiert in einer späteren Phase. Der Stub zeigt den vollen Vertrag:
|
||||
eigene Route, eigenes Template, Lifecycle-Hooks, Migrations-Schnittstelle.
|
||||
Zwei Eintragswege, beide laufen automatisch durch die dedup-Prüfung des
|
||||
dedup-Plugins:
|
||||
|
||||
1. **Verschiebung aus der Neuheitenliste** — Button „Zur Planung“ in der
|
||||
Neuheitenliste ruft `POST /planung/uebernehmen/<neuheit_id>` auf; der
|
||||
Neuheiten-Eintrag wechselt dabei in den Status „planung“.
|
||||
2. **Händisches Nachtragen** über das Formular auf `/planung`.
|
||||
|
||||
Bei einem Prüftreffer wird eine Benachrichtigung an den eintragenden
|
||||
Rezensenten verschickt (Plugin „benachrichtigung“, `send_notification`)
|
||||
und ein Audit-Log-Eintrag geschrieben (Plugin „audit-log“, `log`). Bei
|
||||
einem Verlags-Konflikt erscheint zuerst ein Auswahl-Dialog, welcher Verlag
|
||||
geführt wird; erst nach der Bestätigung wird der Eintrag angelegt.
|
||||
|
||||
Rezensenten sehen die komplette Liste (mit Zuordnung), dürfen aber nur
|
||||
ihre eigenen Einträge bearbeiten; Admins und Redakteure alle.
|
||||
|
||||
Beide Partner-Plugins werden über die Registry geholt (`registry.get(...)`);
|
||||
fehlen sie, entfallen Benachrichtigung/Audit bzw. die Prüfung, ohne dass
|
||||
der Eintrage-Vorgang bricht.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
from fastapi import Depends, Request
|
||||
import logging
|
||||
from urllib.parse import quote
|
||||
|
||||
from redaktionskern.auth.deps import require_user
|
||||
from redaktionskern.auth.models import User
|
||||
from redaktionskern.contracts import BasePlugin, NavEntry
|
||||
from fastapi import Depends, Form, Request
|
||||
from fastapi.responses import RedirectResponse
|
||||
from sqlalchemy import select, update
|
||||
from sqlalchemy.orm import Session
|
||||
|
||||
from redaktionskern.auth.deps import AccessDenied, get_db, require_user
|
||||
from redaktionskern.auth.models import Role, User
|
||||
from redaktionskern.contracts import BasePlugin, Migration, NavEntry
|
||||
from redaktionskern.db import Base
|
||||
|
||||
from .models import (
|
||||
GUELTIGE_STATUS,
|
||||
STATUS_ANZEIGE,
|
||||
Planungseintrag,
|
||||
)
|
||||
|
||||
_logger = logging.getLogger("plugins.planung")
|
||||
|
||||
REDAKTION = (Role.ADMIN.value, Role.REDAKTEUR.value)
|
||||
|
||||
#: Konflikt-Anzeigenamen für UI/Benachrichtigung (bewusst als Kopie ohne
|
||||
#: Import-Abhängigkeit zum dedup-Plugin).
|
||||
KONFLIKT_ANZEIGE = {
|
||||
"verlag": "Verlags-Konflikt",
|
||||
"titel": "Titel-Variante",
|
||||
"besprochen": "Bereits besprochen",
|
||||
"planung": "Schon in Planung",
|
||||
}
|
||||
|
||||
|
||||
def _planungs_tabelle(conn) -> None:
|
||||
"""Migration 0001: legt die Tabelle `planungsliste` an."""
|
||||
Planungseintrag.__table__.create(conn, checkfirst=True)
|
||||
|
||||
|
||||
def _neuheiten_tabelle():
|
||||
"""Neuheiten-Tabelle über die gemeinsame Metadata (nur lesend/schreibend
|
||||
auf den Status — kein Import des neuheiten-Pakets nötig)."""
|
||||
return Base.metadata.tables.get("neuheiten")
|
||||
|
||||
|
||||
class PlanungPlugin(BasePlugin):
|
||||
name = "planung"
|
||||
title = "Planung"
|
||||
description = "Planungsliste mit Zuordnung an Rezensenten (Platzhalter)."
|
||||
description = (
|
||||
"Planungsliste mit Zuordnung an Rezensenten — Verschiebung aus den "
|
||||
"Neuheiten und händisches Nachtragen, automatisch durch die "
|
||||
"dedup-Prüfung."
|
||||
)
|
||||
|
||||
def __init__(self) -> None:
|
||||
super().__init__()
|
||||
self._routen_registrieren()
|
||||
|
||||
# ---------- Plugin-Vertrag ----------
|
||||
|
||||
def migrations(self) -> list[Migration]:
|
||||
return [Migration(version="0001_planungsliste", up=_planungs_tabelle)]
|
||||
|
||||
def navigation(self) -> list[NavEntry]:
|
||||
return [NavEntry(label=self.title, url="/planung")]
|
||||
|
||||
# ---------- Hilfsfunktionen ----------
|
||||
|
||||
@staticmethod
|
||||
def _darf_bearbeiten(user: User, eintrag: Planungseintrag) -> bool:
|
||||
return user.role in REDAKTION or eintrag.rezensent_id == user.id
|
||||
|
||||
@classmethod
|
||||
def _pruefe_bearbeitbar(cls, user: User, eintrag: Planungseintrag) -> None:
|
||||
if not cls._darf_bearbeiten(user, eintrag):
|
||||
raise AccessDenied(
|
||||
"Rezensenten dürfen nur ihre eigenen Planungseinträge ändern."
|
||||
)
|
||||
|
||||
@staticmethod
|
||||
def _hole_dedup(request: Request):
|
||||
return request.app.state.registry.get("dedup")
|
||||
|
||||
@staticmethod
|
||||
async def _benachrichtige(
|
||||
request: Request, user: User, titel: str, ergebnis
|
||||
) -> None:
|
||||
"""Versendet bei Prüftreffern eine Nachricht an den Eintragenden."""
|
||||
benachrichtigung = request.app.state.registry.get("benachrichtigung")
|
||||
if benachrichtigung is None:
|
||||
return
|
||||
zeilen = [
|
||||
f"Die Dedup-Prüfung für „{titel}“ hat {len(ergebnis.konflikte)} Treffer:"
|
||||
]
|
||||
for konflikt in ergebnis.konflikte:
|
||||
anzeige = KONFLIKT_ANZEIGE.get(konflikt.art, konflikt.art)
|
||||
zeilen.append(f"• [{anzeige}] {konflikt.beschreibung}")
|
||||
try:
|
||||
await benachrichtigung.send_notification(
|
||||
user,
|
||||
f"Dedup-Hinweis: {titel}",
|
||||
"\n".join(zeilen),
|
||||
"dedup",
|
||||
)
|
||||
except Exception:
|
||||
# Eine fehlgeschlagene Benachrichtigung darf den Eintrag nicht blockieren.
|
||||
_logger.exception("Benachrichtigung über Dedup-Treffer fehlgeschlagen.")
|
||||
|
||||
@staticmethod
|
||||
async def _audit(
|
||||
request: Request,
|
||||
actor,
|
||||
action: str,
|
||||
objekt_id,
|
||||
details: dict | None = None,
|
||||
) -> None:
|
||||
"""Schreibt einen Audit-Log-Eintrag (best effort, wenn Plugin geladen)."""
|
||||
audit = request.app.state.registry.get("audit-log")
|
||||
if audit is None:
|
||||
return
|
||||
try:
|
||||
await audit.log(actor, action, "planungseintrag", objekt_id, details)
|
||||
except Exception:
|
||||
_logger.exception("Audit-Log-Eintrag für Planung fehlgeschlagen.")
|
||||
|
||||
@staticmethod
|
||||
def _meldung(url: str, text: str, art: str = "meldung") -> RedirectResponse:
|
||||
return RedirectResponse(f"{url}?{art}={quote(text)}", status_code=303)
|
||||
|
||||
def _dialog_antwort(
|
||||
self,
|
||||
request: Request,
|
||||
user: User,
|
||||
*,
|
||||
titel: str,
|
||||
ergebnis,
|
||||
aktion: str,
|
||||
versteckt: dict[str, str],
|
||||
abbrechen_url: str = "/planung",
|
||||
):
|
||||
"""Auswahl-Dialog bei Verlags-Konflikt: Welcher Verlag wird geführt?"""
|
||||
return self.context.templates.TemplateResponse(
|
||||
request=request,
|
||||
name="planung/pruefung.html",
|
||||
context={
|
||||
"user": user,
|
||||
"titel_headline": f"Dedup-Prüfung — {titel}",
|
||||
"spiel_titel": titel,
|
||||
"konflikte": ergebnis.konflikte,
|
||||
"konflikt_anzeige": KONFLIKT_ANZEIGE,
|
||||
"titel_empfehlung": ergebnis.titel_empfehlung,
|
||||
"verlags_optionen": ergebnis.verlags_optionen,
|
||||
"aktion": aktion,
|
||||
"versteckt": versteckt,
|
||||
"abbrechen_url": abbrechen_url,
|
||||
},
|
||||
)
|
||||
|
||||
# ---------- Routen ----------
|
||||
|
||||
def _routen_registrieren(self) -> None:
|
||||
|
||||
@self.router.get("/planung")
|
||||
def seite(request: Request, user: User = Depends(require_user)):
|
||||
"""Platzhalterseite des Plugins."""
|
||||
def liste(
|
||||
request: Request,
|
||||
db: Session = Depends(get_db),
|
||||
user: User = Depends(require_user),
|
||||
status: str = "",
|
||||
meldung: str = "",
|
||||
fehler: str = "",
|
||||
):
|
||||
"""Planungsliste: alle Einträge mit Zuordnung und Statuswechsel."""
|
||||
abfrage = select(Planungseintrag)
|
||||
if status in GUELTIGE_STATUS:
|
||||
abfrage = abfrage.where(Planungseintrag.status == status)
|
||||
eintraege = db.scalars(
|
||||
abfrage.order_by(
|
||||
Planungseintrag.aktualisiert_am.desc(), Planungseintrag.id.desc()
|
||||
)
|
||||
).all()
|
||||
namen = {
|
||||
benutzer.id: (benutzer.display_name or benutzer.username)
|
||||
for benutzer in db.scalars(select(User)).all()
|
||||
}
|
||||
return self.context.templates.TemplateResponse(
|
||||
request=request,
|
||||
name="planung/index.html",
|
||||
context={
|
||||
"user": user,
|
||||
"titel": self.title,
|
||||
"name": self.name,
|
||||
"version": self.version,
|
||||
"eintraege": eintraege,
|
||||
"namen": namen,
|
||||
"status_anzeige": STATUS_ANZEIGE,
|
||||
"status_filter": status if status in GUELTIGE_STATUS else "",
|
||||
"status_optionen": GUELTIGE_STATUS,
|
||||
"kann_bearbeiten": lambda eintrag: self._darf_bearbeiten(user, eintrag),
|
||||
"ist_redaktion": user.role in REDAKTION,
|
||||
"meldung": meldung[:300],
|
||||
"fehler": fehler[:300],
|
||||
"anzahl": len(eintraege),
|
||||
},
|
||||
)
|
||||
|
||||
def navigation(self) -> list[NavEntry]:
|
||||
return [NavEntry(label=self.title, url="/planung")]
|
||||
@self.router.post("/planung/neu")
|
||||
async def neu_anlegen(
|
||||
request: Request,
|
||||
db: Session = Depends(get_db),
|
||||
user: User = Depends(require_user),
|
||||
titel: str = Form(""),
|
||||
verlag: str = Form(""),
|
||||
ausgabe: str = Form(""),
|
||||
bgg_id: str = Form(""),
|
||||
verlag_wahl: str = Form(""),
|
||||
verlag_bestaetigt: str = Form(""),
|
||||
):
|
||||
"""Händisches Nachtragen eines Titels (durchläuft die dedup-Prüfung)."""
|
||||
roh_titel = titel.strip()
|
||||
if not roh_titel:
|
||||
return self._meldung("/planung", "Bitte einen Spieltitel angeben.", "fehler")
|
||||
try:
|
||||
id_wert = int(bgg_id.strip()) if bgg_id.strip() else None
|
||||
except ValueError:
|
||||
return self._meldung("/planung", "Die BGG-ID muss eine Zahl sein.", "fehler")
|
||||
|
||||
dedup = self._hole_dedup(request)
|
||||
ergebnis = (
|
||||
await dedup.check_titel(roh_titel, verlag.strip() or None, id_wert, user=user)
|
||||
if dedup is not None
|
||||
else None
|
||||
)
|
||||
hat_verlagskonflikt = bool(ergebnis and ergebnis.hat_verlagskonflikt)
|
||||
|
||||
# Verlags-Konflikt → Auswahl-Dialog statt sofortigem Anlegen.
|
||||
if hat_verlagskonflikt and verlag_bestaetigt != "1":
|
||||
return self._dialog_antwort(
|
||||
request,
|
||||
user,
|
||||
titel=roh_titel,
|
||||
ergebnis=ergebnis,
|
||||
aktion="/planung/neu",
|
||||
versteckt={
|
||||
"titel": roh_titel,
|
||||
"ausgabe": ausgabe.strip(),
|
||||
"bgg_id": bgg_id.strip(),
|
||||
"verlag_bestaetigt": "1",
|
||||
},
|
||||
)
|
||||
|
||||
gewaehlter_verlag = (verlag_wahl.strip() or verlag.strip()) or None
|
||||
eintrag = Planungseintrag(
|
||||
titel=roh_titel,
|
||||
verlag=gewaehlter_verlag,
|
||||
ausgabe=ausgabe.strip(),
|
||||
bgg_id=id_wert,
|
||||
rezensent_id=user.id,
|
||||
status="offen",
|
||||
quelle="manuell",
|
||||
pruefung=(ergebnis.als_liste() or None) if ergebnis is not None else None,
|
||||
)
|
||||
db.add(eintrag)
|
||||
db.commit()
|
||||
|
||||
details = {
|
||||
"titel": eintrag.titel,
|
||||
"verlag": eintrag.verlag,
|
||||
"ausgabe": eintrag.ausgabe,
|
||||
"quelle": eintrag.quelle,
|
||||
"rezensent_id": eintrag.rezensent_id,
|
||||
}
|
||||
if ergebnis is not None and ergebnis.hat_konflikte:
|
||||
details["dedup_konflikte"] = ergebnis.als_liste()
|
||||
await self._audit(request, user, "erstellt", eintrag.id, details)
|
||||
|
||||
if ergebnis is not None and ergebnis.hat_konflikte:
|
||||
await self._benachrichtige(request, user, eintrag.titel, ergebnis)
|
||||
meldung = (
|
||||
f"„{eintrag.titel}“ wurde eingetragen. Die Dedup-Prüfung hatte "
|
||||
"Treffer — du hast eine Benachrichtigung erhalten."
|
||||
)
|
||||
else:
|
||||
meldung = f"„{eintrag.titel}“ wurde eingetragen."
|
||||
return self._meldung("/planung", meldung)
|
||||
|
||||
@self.router.post("/planung/uebernehmen/{neuheit_id}")
|
||||
async def uebernehmen(
|
||||
request: Request,
|
||||
neuheit_id: int,
|
||||
db: Session = Depends(get_db),
|
||||
user: User = Depends(require_user),
|
||||
verlag_wahl: str = Form(""),
|
||||
verlag_bestaetigt: str = Form(""),
|
||||
):
|
||||
"""Verschiebung Neuheiten → Planung (durchläuft die dedup-Prüfung)."""
|
||||
tabelle = _neuheiten_tabelle()
|
||||
if tabelle is None:
|
||||
return self._meldung(
|
||||
"/planung",
|
||||
"Neuheitenliste nicht verfügbar — Verschiebung nicht möglich.",
|
||||
"fehler",
|
||||
)
|
||||
zeile = db.execute(
|
||||
select(tabelle).where(tabelle.c.id == neuheit_id)
|
||||
).first()
|
||||
if zeile is None:
|
||||
return self._meldung(
|
||||
"/neuheiten", "Dieser Neuheiten-Eintrag existiert nicht mehr.", "fehler"
|
||||
)
|
||||
if zeile.status != "neuheit":
|
||||
return self._meldung(
|
||||
"/neuheiten",
|
||||
f"„{zeile.titel}“ ist nicht mehr als Neuheit verfügbar.",
|
||||
"fehler",
|
||||
)
|
||||
|
||||
dedup = self._hole_dedup(request)
|
||||
ergebnis = (
|
||||
await dedup.check_titel(zeile.titel, zeile.verlag, zeile.bgg_id, user=user)
|
||||
if dedup is not None
|
||||
else None
|
||||
)
|
||||
hat_verlagskonflikt = bool(ergebnis and ergebnis.hat_verlagskonflikt)
|
||||
|
||||
# Verlags-Konflikt → Auswahl-Dialog statt sofortiger Übernahme.
|
||||
if hat_verlagskonflikt and verlag_bestaetigt != "1":
|
||||
return self._dialog_antwort(
|
||||
request,
|
||||
user,
|
||||
titel=zeile.titel,
|
||||
ergebnis=ergebnis,
|
||||
aktion=f"/planung/uebernehmen/{neuheit_id}",
|
||||
versteckt={"neuheit_id": str(neuheit_id), "verlag_bestaetigt": "1"},
|
||||
abbrechen_url="/neuheiten",
|
||||
)
|
||||
|
||||
gewaehlter_verlag = (verlag_wahl.strip() or (zeile.verlag or "")) or None
|
||||
eintrag = Planungseintrag(
|
||||
titel=zeile.titel,
|
||||
verlag=gewaehlter_verlag,
|
||||
autor=zeile.autor,
|
||||
bgg_id=zeile.bgg_id,
|
||||
ausgabe="",
|
||||
rezensent_id=user.id,
|
||||
status="offen",
|
||||
quelle="neuheiten",
|
||||
pruefung=(ergebnis.als_liste() or None) if ergebnis is not None else None,
|
||||
)
|
||||
db.add(eintrag)
|
||||
db.execute(
|
||||
update(tabelle)
|
||||
.where(tabelle.c.id == neuheit_id)
|
||||
.values(status="planung")
|
||||
)
|
||||
db.commit()
|
||||
|
||||
details = {
|
||||
"titel": eintrag.titel,
|
||||
"verlag": eintrag.verlag,
|
||||
"ausgabe": eintrag.ausgabe,
|
||||
"quelle": eintrag.quelle,
|
||||
"rezensent_id": eintrag.rezensent_id,
|
||||
"von": "neuheiten",
|
||||
"neuheit_id": neuheit_id,
|
||||
}
|
||||
if ergebnis is not None and ergebnis.hat_konflikte:
|
||||
details["dedup_konflikte"] = ergebnis.als_liste()
|
||||
await self._audit(request, user, "verschoben", eintrag.id, details)
|
||||
|
||||
if ergebnis is not None and ergebnis.hat_konflikte:
|
||||
await self._benachrichtige(request, user, eintrag.titel, ergebnis)
|
||||
meldung = (
|
||||
f"„{eintrag.titel}“ wurde in deine Planungsliste übernommen. "
|
||||
"Die Dedup-Prüfung hatte Treffer — du hast eine Benachrichtigung erhalten."
|
||||
)
|
||||
else:
|
||||
meldung = f"„{eintrag.titel}“ wurde in deine Planungsliste übernommen."
|
||||
return self._meldung("/planung", meldung)
|
||||
|
||||
@self.router.post("/planung/{eintrag_id}/status")
|
||||
async def status_wechseln(
|
||||
request: Request,
|
||||
eintrag_id: int,
|
||||
db: Session = Depends(get_db),
|
||||
user: User = Depends(require_user),
|
||||
status: str = Form(""),
|
||||
):
|
||||
"""Statuswechsel (offen → in Bearbeitung → abgeschlossen)."""
|
||||
eintrag = db.get(Planungseintrag, eintrag_id)
|
||||
if eintrag is None:
|
||||
return self._meldung("/planung", "Eintrag nicht gefunden.", "fehler")
|
||||
self._pruefe_bearbeitbar(user, eintrag)
|
||||
if status not in GUELTIGE_STATUS:
|
||||
return self._meldung("/planung", "Unbekannter Status.", "fehler")
|
||||
alt = eintrag.status
|
||||
eintrag.status = status
|
||||
db.commit()
|
||||
await self._audit(
|
||||
request,
|
||||
user,
|
||||
"geaendert",
|
||||
eintrag.id,
|
||||
{"alt": {"status": alt}, "neu": {"status": status}},
|
||||
)
|
||||
return self._meldung(
|
||||
"/planung",
|
||||
f"Status von „{eintrag.titel}“: {STATUS_ANZEIGE.get(status, status)}.",
|
||||
)
|
||||
|
||||
@self.router.get("/planung/{eintrag_id}/bearbeiten")
|
||||
def bearbeiten_formular(
|
||||
request: Request,
|
||||
eintrag_id: int,
|
||||
db: Session = Depends(get_db),
|
||||
user: User = Depends(require_user),
|
||||
):
|
||||
eintrag = db.get(Planungseintrag, eintrag_id)
|
||||
if eintrag is None:
|
||||
return self._meldung("/planung", "Eintrag nicht gefunden.", "fehler")
|
||||
self._pruefe_bearbeitbar(user, eintrag)
|
||||
return self.context.templates.TemplateResponse(
|
||||
request=request,
|
||||
name="planung/bearbeiten.html",
|
||||
context={
|
||||
"user": user,
|
||||
"titel_headline": f"Eintrag bearbeiten — {eintrag.titel}",
|
||||
"eintrag": eintrag,
|
||||
"abbrechen_url": "/planung",
|
||||
},
|
||||
)
|
||||
|
||||
@self.router.post("/planung/{eintrag_id}/bearbeiten")
|
||||
async def bearbeiten_speichern(
|
||||
request: Request,
|
||||
eintrag_id: int,
|
||||
db: Session = Depends(get_db),
|
||||
user: User = Depends(require_user),
|
||||
titel: str = Form(""),
|
||||
verlag: str = Form(""),
|
||||
ausgabe: str = Form(""),
|
||||
notizen: str = Form(""),
|
||||
):
|
||||
eintrag = db.get(Planungseintrag, eintrag_id)
|
||||
if eintrag is None:
|
||||
return self._meldung("/planung", "Eintrag nicht gefunden.", "fehler")
|
||||
self._pruefe_bearbeitbar(user, eintrag)
|
||||
roh_titel = titel.strip()
|
||||
if not roh_titel:
|
||||
return self._meldung("/planung", "Bitte einen Spieltitel angeben.", "fehler")
|
||||
|
||||
alt = {
|
||||
"titel": eintrag.titel,
|
||||
"verlag": eintrag.verlag,
|
||||
"ausgabe": eintrag.ausgabe,
|
||||
"notizen": eintrag.notizen,
|
||||
}
|
||||
eintrag.titel = roh_titel
|
||||
eintrag.verlag = verlag.strip() or None
|
||||
eintrag.ausgabe = ausgabe.strip()
|
||||
eintrag.notizen = notizen.strip() or None
|
||||
neu = {
|
||||
"titel": eintrag.titel,
|
||||
"verlag": eintrag.verlag,
|
||||
"ausgabe": eintrag.ausgabe,
|
||||
"notizen": eintrag.notizen,
|
||||
}
|
||||
geaendert = [k for k in alt if alt[k] != neu[k]]
|
||||
db.commit()
|
||||
if geaendert:
|
||||
# Nur geänderte Felder, im alt/neu-Format des Audit-Log-Plugins.
|
||||
await self._audit(
|
||||
request,
|
||||
user,
|
||||
"geaendert",
|
||||
eintrag.id,
|
||||
{
|
||||
"alt": {k: alt[k] for k in geaendert},
|
||||
"neu": {k: neu[k] for k in geaendert},
|
||||
},
|
||||
)
|
||||
return self._meldung("/planung", f"„{eintrag.titel}“ wurde gespeichert.")
|
||||
|
||||
@self.router.post("/planung/{eintrag_id}/loeschen")
|
||||
async def loeschen(
|
||||
request: Request,
|
||||
eintrag_id: int,
|
||||
db: Session = Depends(get_db),
|
||||
user: User = Depends(require_user),
|
||||
):
|
||||
eintrag = db.get(Planungseintrag, eintrag_id)
|
||||
if eintrag is None:
|
||||
return self._meldung("/planung", "Eintrag nicht gefunden.", "fehler")
|
||||
self._pruefe_bearbeitbar(user, eintrag)
|
||||
snapshot = {
|
||||
"titel": eintrag.titel,
|
||||
"verlag": eintrag.verlag,
|
||||
"ausgabe": eintrag.ausgabe,
|
||||
"status": eintrag.status,
|
||||
"rezensent_id": eintrag.rezensent_id,
|
||||
}
|
||||
db.delete(eintrag)
|
||||
db.commit()
|
||||
await self._audit(request, user, "geloescht", eintrag_id, snapshot)
|
||||
return self._meldung("/planung", f"„{snapshot['titel']}“ wurde gelöscht.")
|
||||
|
||||
|
||||
plugin = PlanungPlugin()
|
||||
|
||||
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})>"
|
||||
41
plugins/planung/templates/planung/bearbeiten.html
Normal file
41
plugins/planung/templates/planung/bearbeiten.html
Normal file
@@ -0,0 +1,41 @@
|
||||
{% extends "base.html" %}
|
||||
{% block titel %}{{ titel_headline }} — Spiele-Redaktion{% endblock %}
|
||||
{% block inhalt %}
|
||||
<h1 class="text-2xl font-bold mb-2">Eintrag bearbeiten</h1>
|
||||
<p class="text-slate-600 mb-4">„{{ eintrag.titel }}“ · Rezensent:
|
||||
{% if user.id == eintrag.rezensent_id %}du{% else %}{{ user.display_name }}{% endif %}
|
||||
</p>
|
||||
|
||||
<form method="post" action="/planung/{{ eintrag.id }}/bearbeiten"
|
||||
class="bg-white border border-slate-200 rounded-xl shadow-sm p-4 max-w-2xl space-y-4">
|
||||
<div>
|
||||
<label for="titel" class="block text-xs font-medium text-slate-500 mb-1">Spieltitel *</label>
|
||||
<input type="text" id="titel" name="titel" required value="{{ eintrag.titel }}"
|
||||
class="w-full border border-slate-300 rounded-lg px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-emerald-500">
|
||||
</div>
|
||||
<div class="grid md:grid-cols-2 gap-4">
|
||||
<div>
|
||||
<label for="verlag" class="block text-xs font-medium text-slate-500 mb-1">Verlag</label>
|
||||
<input type="text" id="verlag" name="verlag" value="{{ eintrag.verlag or '' }}"
|
||||
class="w-full border border-slate-300 rounded-lg px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-emerald-500">
|
||||
</div>
|
||||
<div>
|
||||
<label for="ausgabe" class="block text-xs font-medium text-slate-500 mb-1">Ausgabe</label>
|
||||
<input type="text" id="ausgabe" name="ausgabe" value="{{ eintrag.ausgabe }}" placeholder="z. B. 3/2025"
|
||||
class="w-full border border-slate-300 rounded-lg px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-emerald-500">
|
||||
</div>
|
||||
</div>
|
||||
<div>
|
||||
<label for="notizen" class="block text-xs font-medium text-slate-500 mb-1">Notizen</label>
|
||||
<textarea id="notizen" name="notizen" rows="3"
|
||||
class="w-full border border-slate-300 rounded-lg px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-emerald-500">{{ eintrag.notizen or '' }}</textarea>
|
||||
</div>
|
||||
<div class="flex items-center gap-3">
|
||||
<button type="submit"
|
||||
class="bg-emerald-600 hover:bg-emerald-700 text-white font-medium px-4 py-2 rounded-lg text-sm">
|
||||
Speichern
|
||||
</button>
|
||||
<a href="{{ abbrechen_url }}" class="text-sm text-slate-500 hover:text-slate-800 underline">Abbrechen</a>
|
||||
</div>
|
||||
</form>
|
||||
{% endblock %}
|
||||
@@ -2,9 +2,139 @@
|
||||
{% 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 — die Funktion wird in einer späteren Phase implementiert.
|
||||
<p class="text-slate-600 mb-4">
|
||||
Planungsliste der Redaktion: wer reviewt welches Spiel für welche Ausgabe.
|
||||
Jede Eintragung — aus den Neuheiten verschoben oder händisch nachgetragen —
|
||||
wird automatisch durch die Dedup-Prüfung geprüft.
|
||||
</p>
|
||||
|
||||
{% if meldung %}
|
||||
<div class="mb-4 px-4 py-3 rounded-lg border bg-emerald-50 border-emerald-200 text-emerald-800 text-sm">{{ meldung }}</div>
|
||||
{% endif %}
|
||||
{% if fehler %}
|
||||
<div class="mb-4 px-4 py-3 rounded-lg border bg-red-50 border-red-200 text-red-700 text-sm">{{ fehler }}</div>
|
||||
{% endif %}
|
||||
|
||||
<div class="bg-white border border-slate-200 rounded-xl shadow-sm p-4 mb-6">
|
||||
<h2 class="font-semibold mb-3">Titel händisch nachtragen</h2>
|
||||
<form method="post" action="/planung/neu" class="flex flex-wrap items-end gap-3">
|
||||
<div>
|
||||
<label for="titel" class="block text-xs font-medium text-slate-500 mb-1">Spieltitel *</label>
|
||||
<input type="text" id="titel" name="titel" required
|
||||
class="border border-slate-300 rounded-lg px-3 py-2 text-sm w-72 focus:outline-none focus:ring-2 focus:ring-emerald-500">
|
||||
</div>
|
||||
<div>
|
||||
<label for="verlag" class="block text-xs font-medium text-slate-500 mb-1">Verlag</label>
|
||||
<input type="text" id="verlag" name="verlag"
|
||||
class="border border-slate-300 rounded-lg px-3 py-2 text-sm w-52 focus:outline-none focus:ring-2 focus:ring-emerald-500">
|
||||
</div>
|
||||
<div>
|
||||
<label for="ausgabe" class="block text-xs font-medium text-slate-500 mb-1">Ausgabe</label>
|
||||
<input type="text" id="ausgabe" name="ausgabe" placeholder="z. B. 3/2025"
|
||||
class="border border-slate-300 rounded-lg px-3 py-2 text-sm w-32 focus:outline-none focus:ring-2 focus:ring-emerald-500">
|
||||
</div>
|
||||
<div>
|
||||
<label for="bgg_id" class="block text-xs font-medium text-slate-500 mb-1">BGG-ID (optional)</label>
|
||||
<input type="text" id="bgg_id" name="bgg_id"
|
||||
class="border border-slate-300 rounded-lg px-3 py-2 text-sm w-32 focus:outline-none focus:ring-2 focus:ring-emerald-500">
|
||||
</div>
|
||||
<button type="submit"
|
||||
class="bg-emerald-600 hover:bg-emerald-700 text-white font-medium px-4 py-2 rounded-lg text-sm whitespace-nowrap">
|
||||
Prüfen & eintragen
|
||||
</button>
|
||||
</form>
|
||||
</div>
|
||||
|
||||
<div class="flex items-center mb-3 gap-3">
|
||||
<form method="get" action="/planung" class="flex items-center gap-2">
|
||||
<select name="status" class="border border-slate-300 rounded-lg px-3 py-2 text-sm bg-white"
|
||||
onchange="this.form.submit()">
|
||||
<option value="">Alle Status</option>
|
||||
{% for wert in status_optionen %}
|
||||
<option value="{{ wert }}" {% if wert == status_filter %}selected{% endif %}>{{ status_anzeige[wert] }}</option>
|
||||
{% endfor %}
|
||||
</select>
|
||||
<noscript><button type="submit" class="bg-slate-200 hover:bg-slate-300 px-3 py-2 rounded-lg text-sm">Filtern</button></noscript>
|
||||
</form>
|
||||
<p class="text-xs text-slate-400 ml-auto">{{ anzahl }} Einträge</p>
|
||||
</div>
|
||||
|
||||
<div class="overflow-x-auto bg-white rounded-xl border border-slate-200 shadow-sm">
|
||||
<table class="w-full text-sm">
|
||||
<thead class="bg-slate-50 text-left text-slate-500">
|
||||
<tr>
|
||||
<th class="px-4 py-3 font-medium">Spieltitel</th>
|
||||
<th class="px-4 py-3 font-medium">Verlag</th>
|
||||
<th class="px-4 py-3 font-medium">Ausgabe</th>
|
||||
<th class="px-4 py-3 font-medium">Rezensent</th>
|
||||
<th class="px-4 py-3 font-medium">Status</th>
|
||||
<th class="px-4 py-3 font-medium">Aktualisiert</th>
|
||||
<th class="px-4 py-3 font-medium">Aktionen</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody class="divide-y divide-slate-100">
|
||||
{% for eintrag in eintraege %}
|
||||
<tr class="hover:bg-slate-50">
|
||||
<td class="px-4 py-3 font-medium">
|
||||
{{ eintrag.titel }}
|
||||
{% if eintrag.bgg_id %}
|
||||
<a href="https://boardgamegeek.com/boardgame/{{ eintrag.bgg_id }}" target="_blank" rel="noopener"
|
||||
class="ml-1 text-[10px] text-slate-400 hover:text-emerald-700 align-super">BGG {{ eintrag.bgg_id }}</a>
|
||||
{% endif %}
|
||||
{% if eintrag.pruefung %}
|
||||
<span class="ml-1 inline-block px-2 py-0.5 rounded-full bg-amber-100 text-amber-800 text-xs"
|
||||
title="Die dedup-Prüfung hatte beim Eintragen Treffer.">⚠ Prüfhinweis</span>
|
||||
{% endif %}
|
||||
</td>
|
||||
<td class="px-4 py-3">{{ eintrag.verlag or '—' }}</td>
|
||||
<td class="px-4 py-3 whitespace-nowrap">{{ eintrag.ausgabe or '—' }}</td>
|
||||
<td class="px-4 py-3 whitespace-nowrap">{{ namen.get(eintrag.rezensent_id, '—') }}</td>
|
||||
<td class="px-4 py-3 whitespace-nowrap">
|
||||
{% if eintrag.status == 'offen' %}
|
||||
<span class="inline-block px-2 py-0.5 rounded-full bg-slate-200 text-slate-700 text-xs">{{ status_anzeige[eintrag.status] }}</span>
|
||||
{% elif eintrag.status == 'in_bearbeitung' %}
|
||||
<span class="inline-block px-2 py-0.5 rounded-full bg-sky-100 text-sky-800 text-xs">{{ status_anzeige[eintrag.status] }}</span>
|
||||
{% else %}
|
||||
<span class="inline-block px-2 py-0.5 rounded-full bg-emerald-100 text-emerald-800 text-xs">{{ status_anzeige[eintrag.status] }}</span>
|
||||
{% endif %}
|
||||
</td>
|
||||
<td class="px-4 py-3 whitespace-nowrap text-slate-500">
|
||||
{{ eintrag.aktualisiert_am.strftime('%d.%m.%Y %H:%M') if eintrag.aktualisiert_am else '—' }}
|
||||
</td>
|
||||
<td class="px-4 py-3">
|
||||
{% if kann_bearbeiten(eintrag) %}
|
||||
<div class="flex flex-wrap items-center gap-1.5">
|
||||
{% if eintrag.status == 'offen' %}
|
||||
<form method="post" action="/planung/{{ eintrag.id }}/status">
|
||||
<input type="hidden" name="status" value="in_bearbeitung">
|
||||
<button type="submit" class="text-xs bg-sky-600 hover:bg-sky-700 text-white px-2 py-1 rounded-lg whitespace-nowrap">In Bearbeitung</button>
|
||||
</form>
|
||||
{% endif %}
|
||||
{% if eintrag.status != 'abgeschlossen' %}
|
||||
<form method="post" action="/planung/{{ eintrag.id }}/status">
|
||||
<input type="hidden" name="status" value="abgeschlossen">
|
||||
<button type="submit" class="text-xs bg-emerald-600 hover:bg-emerald-700 text-white px-2 py-1 rounded-lg whitespace-nowrap">Abgeschlossen</button>
|
||||
</form>
|
||||
{% endif %}
|
||||
<a href="/planung/{{ eintrag.id }}/bearbeiten"
|
||||
class="text-xs border border-slate-300 hover:border-emerald-600 hover:text-emerald-700 px-2 py-1 rounded-lg whitespace-nowrap">Bearbeiten</a>
|
||||
<form method="post" action="/planung/{{ eintrag.id }}/loeschen">
|
||||
<button type="submit" class="text-xs border border-red-200 text-red-600 hover:bg-red-50 px-2 py-1 rounded-lg whitespace-nowrap">Löschen</button>
|
||||
</form>
|
||||
</div>
|
||||
{% else %}
|
||||
<span class="text-xs text-slate-400">nur {{ namen.get(eintrag.rezensent_id, '') }}</span>
|
||||
{% endif %}
|
||||
</td>
|
||||
</tr>
|
||||
{% else %}
|
||||
<tr>
|
||||
<td colspan="7" class="px-4 py-8 text-center text-slate-400">
|
||||
Noch keine Einträge — schiebe einen Titel aus den Neuheiten hierher oder trage ihn oben händisch nach.
|
||||
</td>
|
||||
</tr>
|
||||
{% endfor %}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
{% endblock %}
|
||||
|
||||
55
plugins/planung/templates/planung/pruefung.html
Normal file
55
plugins/planung/templates/planung/pruefung.html
Normal file
@@ -0,0 +1,55 @@
|
||||
{% extends "base.html" %}
|
||||
{% block titel %}{{ titel_headline }} — Spiele-Redaktion{% endblock %}
|
||||
{% block inhalt %}
|
||||
<h1 class="text-2xl font-bold mb-2">{{ titel_headline }}</h1>
|
||||
<p class="text-slate-600 mb-4">
|
||||
Die automatische Dedup-Prüfung hat Treffer ergeben. Bitte prüfen, bevor
|
||||
der Eintrag angelegt wird.
|
||||
</p>
|
||||
|
||||
<div class="bg-amber-50 border border-amber-300 rounded-xl p-4 mb-6 text-sm">
|
||||
<p class="font-medium text-amber-800 mb-2">⚠ {{ konflikte|length }} Treffer für „{{ spiel_titel }}“</p>
|
||||
<ul class="list-disc list-inside space-y-1 text-slate-700">
|
||||
{% for konflikt in konflikte %}
|
||||
<li>
|
||||
<span class="inline-block px-2 py-0.5 rounded-full text-xs mr-1
|
||||
{% if konflikt.art == 'verlag' %}bg-orange-200 text-orange-900
|
||||
{% elif konflikt.art == 'titel' %}bg-sky-200 text-sky-900
|
||||
{% elif konflikt.art == 'besprochen' %}bg-violet-200 text-violet-900
|
||||
{% else %}bg-amber-200 text-amber-900{% endif %}">
|
||||
{{ konflikt_anzeige.get(konflikt.art, konflikt.art) }}
|
||||
</span>
|
||||
{{ konflikt.beschreibung }}
|
||||
</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
{% if titel_empfehlung and titel_empfehlung != spiel_titel %}
|
||||
<p class="mt-2 text-slate-600">Empfohlener Titel: <span class="font-medium">{{ titel_empfehlung }}</span></p>
|
||||
{% endif %}
|
||||
</div>
|
||||
|
||||
<form method="post" action="{{ aktion }}" class="bg-white border border-slate-200 rounded-xl shadow-sm p-4">
|
||||
{% for name, wert in versteckt.items() %}
|
||||
<input type="hidden" name="{{ name }}" value="{{ wert }}">
|
||||
{% endfor %}
|
||||
|
||||
<h2 class="font-semibold mb-3">Welcher Verlag soll geführt werden?</h2>
|
||||
<div class="space-y-2 mb-4 text-sm">
|
||||
{% for option in verlags_optionen %}
|
||||
<label class="flex items-center gap-2 cursor-pointer">
|
||||
<input type="radio" name="verlag_wahl" value="{{ option }}" required
|
||||
class="accent-emerald-600">
|
||||
<span>{{ option }}</span>
|
||||
</label>
|
||||
{% endfor %}
|
||||
</div>
|
||||
|
||||
<div class="flex items-center gap-3">
|
||||
<button type="submit"
|
||||
class="bg-emerald-600 hover:bg-emerald-700 text-white font-medium px-4 py-2 rounded-lg text-sm">
|
||||
Mit gewähltem Verlag übernehmen
|
||||
</button>
|
||||
<a href="{{ abbrechen_url }}" class="text-sm text-slate-500 hover:text-slate-800 underline">Abbrechen</a>
|
||||
</div>
|
||||
</form>
|
||||
{% endblock %}
|
||||
Reference in New Issue
Block a user