70 lines
2.8 KiB
Python
70 lines
2.8 KiB
Python
"""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)
|
|
#: URL des Coverbildes (aus der Neuheitenliste übernommen oder leer).
|
|
bild_url: Mapped[str | None] = mapped_column(String(500))
|
|
quellen_url: Mapped[str | None] = mapped_column(String(500))
|
|
#: 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})>"
|