[KAT-05] Katalogdaten laden und aktuell halten

cschlaefke commented

2026-11-02 13:39:10 +00:00

Owner

Story

Als Admin
möchte ich den Katalog manuell pflegen, Einträge ausblenden und zusammenführen sowie Meldungen bearbeiten – und später Daten aus zugelassenen Quellen importieren,
damit der Katalog vollständig und korrekt bleibt.

Akzeptanzkriterien

Quelle: requirements/20-r1-akzeptanzkriterien.md § KAT-05 (Referenz in Tests/PR: „KAT-05 Kriterium n“), Stand 2026-11-02 inkl. Klärungen und N11

In R1 wird der Katalog nur manuell gepflegt; ein Import kommt erst mit einer zugelassenen Quelle bzw. der BGG-Lizenz (Klärung 24). Der Admin pflegt Katalog und Meldungen über Supabase Studio/SQL; eine Admin-Oberfläche in der App gibt es bis QUE-08 (R4) nicht (Klärung 44). Das Datenmodell für den späteren Import entsteht trotzdem schon in R1 (Klärung 7).

1. Zurückgestellt bis zur Lizenz (Klärung 24): Gegeben eine zugelassene Quelle, wenn der Import läuft, dann werden neue Spiele angelegt und geänderte aktualisiert, ohne manuell gepflegte Felder zu überschreiben.
2. Gegeben ein Katalogeintrag, dann hat er eine eigene Shuffle-ID (F2). Zurückgestellt bis zur Lizenz (Klärung 24): optional die Kennung der Quelle (zum Beispiel BGG) samt Quellenangabe; die Felder dafür sind ab R1 im Datenmodell vorhanden (Klärung 7).
3. Zurückgestellt bis zur Lizenz (Klärung 24): Gegeben die Quelle ist nicht erreichbar oder liefert fehlerhafte Daten, dann bleibt der Katalog unverändert, der Fehler wird protokolliert und die App funktioniert normal weiter.
4. Gegeben der Admin bearbeitet, blendet aus oder führt Einträge zusammen (in R1 über Supabase Studio/SQL), dann sind ausgeblendete Einträge in der App nicht mehr auffindbar, und manuell gepflegte Felder sind als solche gekennzeichnet, damit ein späterer Import sie nicht überschreibt (Klärungen 7, 44).
5. Gegeben Meldungen aus KAT-04, dann kann der Admin sie über Supabase Studio/SQL freigeben, mit einem Eintrag zusammenführen oder ablehnen; Status (offen, freigegeben, abgelehnt, zusammengeführt) und gegebenenfalls der Zieleintrag werden gespeichert (Klärungen 6, 44).
6. Zurückgestellt bis zur Lizenz (Klärung 24): Gegeben Cover und Texte einer Quelle, dann werden sie nur angezeigt, wenn deren Nutzungsbedingungen es erlauben; die Erlaubnis ist je Quelle vermerkt. Das Feld für die Erlaubnis je Quelle ist ab R1 im Datenmodell vorhanden (Klärung 7).
7. Gegeben R1 geht live, dann enthält der Katalog einen manuell gepflegten Startbestand von etwa 200 Spielen, den der Admin (Chris) per Supabase Studio bzw. Seed einpflegt (Klärung 24, N11).
8. Gegeben die Admin-Pflege über Supabase Studio/SQL, dann ist der Ablauf für Bearbeiten, Ausblenden, Zusammenführen und das Bearbeiten von Meldungen im Repo dokumentiert (Klärung 44).
9. Gegeben ein Nutzer ohne Admin-Rolle, wenn er über die App oder direkt über die Schnittstelle Katalogeinträge oder fremde Meldungen ändern will, dann wird der Zugriff verweigert; die Admin-Rolle existiert in R1 nur als Datenbankrolle (Klärung 44).
10. (neu) Gegeben ein Spiel aus dem Startbestand, dann enthält es nur Fakten (Titel, Verlag, Erscheinungsjahr, Spielerzahl, Spieldauer, Mindestalter, Genre, Mechanik); fremde Cover und fremde Beschreibungstexte werden nicht übernommen, stattdessen zeigt die App ein Platzhalter-Cover und einen eigenen Kurztext (N11).

Querschnitt

Es gelten alle Querschnittskriterien aus 20-r1-akzeptanzkriterien.md § „Querschnitt für R1“ (Datenschutz QUE-04, Sicherheit der Daten, Sprachen QUE-05, Barrierefreiheit QUE-06, Zustände/Fehler/Netz, Plattformen).
Besonders relevant: Sicherheit der Daten Kriterium 2 (Katalog ohne Anmeldung lesbar, nie durch Nutzer veränderbar; Entscheidung O6), Sicherheit der Daten Kriterium 3.

Nicht im Scope

Admin-Oberfläche in der App (QUE-08, R4; Klärung 44)
Admin-Bereich für News-Quellen und Verifizierung (QUE-08, R4)
Import-Job aus BGG oder einer anderen Quelle in R1 (Klärung 24) – Kriterien 1, 2 (Quellenteil), 3, 6 erst mit Lizenz
Fremde Cover und Beschreibungstexte im Startbestand (N11)

Klärungen

Verbindlich laut requirements/r1-klaerungen.md (2026-11-02):

6: Neue Tabelle für Meldungen (Status offen/freigegeben/abgelehnt/zusammengeführt, Link, Verweis auf Zieleintrag) → Kriterium 5.
7: Flag „ausgeblendet“, Kennzeichnung manuell gepflegter Felder und Erlaubnis je Quelle schon in R1 modellieren → Kriterien 2, 4, 6.
24: Katalog zum Start nur manuell gepflegt, kein Import-Job bis BGG-Lizenz; R1.1 braucht manuelle Pflege und Startbestand → Kriterien 1–3, 6 zurückgestellt, Kriterium 7 neu.
25/44: Keine Admin-Story; Pflege über Supabase Studio/SQL, Admin-Rolle nur als DB-Rolle (RLS); Ablauf im Repo dokumentieren → Kriterien 4, 5, 8, 9.
N11: Startbestand ca. 200 Spiele, von Chris per Supabase Studio/Seed gepflegt; nur Fakten (Titel, Verlag, Jahr, Spielerzahl, Dauer, Alter, Genre, Mechanik); keine fremden Cover oder Beschreibungstexte – Platzhalter-Cover und eigene Kurztexte → Kriterien 7, 10.

Offene Fragen

Keine.

Planung

Epic: KAT Spielekatalog
Priorität: Must
Größe: XL (durch Zurückstellung des Imports in R1 voraussichtlich kleiner; Neubewertung in der Spec)
Etappe: R1.1 Fundament (Datenmodell, Startbestand, Kriterien 2, 7, 9, 10); Admin-Pflege und Meldungen (Kriterien 4, 5, 8) in R1.2 Sammlung; Import erst mit Lizenz
Abhängigkeiten: keine (Fundament)

Mögliche Schnitte für die Spec

KAT-05a Datenmodell inkl. Import-Vorbereitung, Rechte/Admin-Rolle und Startbestand (Kriterien 2, 7, 9, 10)
KAT-05b Admin-Pflege per Studio: bearbeiten, ausblenden, zusammenführen, Dokumentation (Kriterien 4, 8)
KAT-05c Meldungen bearbeiten (Kriterium 5)
später: KAT-05d Import aus einer Quelle (Kriterien 1, 3, 6), sobald Lizenz vorliegt

Referenzen

Akzeptanzkriterien: requirements/20-r1-akzeptanzkriterien.md § KAT-05
Klärungen: requirements/r1-klaerungen.md (inkl. N11)
Story-Entwurf: requirements/r1-story-entwurf.md (freigegeben 2026-11-02)
Backlog: requirements/backlog.md

## Story **Als** Admin **möchte ich** den Katalog manuell pflegen, Einträge ausblenden und zusammenführen sowie Meldungen bearbeiten – und später Daten aus zugelassenen Quellen importieren, **damit** der Katalog vollständig und korrekt bleibt. ## Akzeptanzkriterien Quelle: `requirements/20-r1-akzeptanzkriterien.md` § KAT-05 (Referenz in Tests/PR: „KAT-05 Kriterium n“), Stand 2026-11-02 inkl. Klärungen und N11 In R1 wird der Katalog nur manuell gepflegt; ein Import kommt erst mit einer zugelassenen Quelle bzw. der BGG-Lizenz (Klärung 24). Der Admin pflegt Katalog und Meldungen über **Supabase Studio/SQL**; eine Admin-Oberfläche in der App gibt es bis QUE-08 (R4) nicht (Klärung 44). Das Datenmodell für den späteren Import entsteht trotzdem schon in R1 (Klärung 7). - **1.** *Zurückgestellt bis zur Lizenz (Klärung 24):* Gegeben eine zugelassene Quelle, wenn der Import läuft, dann werden neue Spiele angelegt und geänderte aktualisiert, ohne manuell gepflegte Felder zu überschreiben. - [ ] **2.** Gegeben ein Katalogeintrag, dann hat er eine eigene Shuffle-ID (F2). *Zurückgestellt bis zur Lizenz (Klärung 24):* optional die Kennung der Quelle (zum Beispiel BGG) samt Quellenangabe; die Felder dafür sind ab R1 im Datenmodell vorhanden (Klärung 7). - **3.** *Zurückgestellt bis zur Lizenz (Klärung 24):* Gegeben die Quelle ist nicht erreichbar oder liefert fehlerhafte Daten, dann bleibt der Katalog unverändert, der Fehler wird protokolliert und die App funktioniert normal weiter. - [ ] **4.** Gegeben der Admin bearbeitet, blendet aus oder führt Einträge zusammen (in R1 über Supabase Studio/SQL), dann sind ausgeblendete Einträge in der App nicht mehr auffindbar, und manuell gepflegte Felder sind als solche gekennzeichnet, damit ein späterer Import sie nicht überschreibt (Klärungen 7, 44). - [ ] **5.** Gegeben Meldungen aus KAT-04, dann kann der Admin sie über Supabase Studio/SQL freigeben, mit einem Eintrag zusammenführen oder ablehnen; Status (offen, freigegeben, abgelehnt, zusammengeführt) und gegebenenfalls der Zieleintrag werden gespeichert (Klärungen 6, 44). - **6.** *Zurückgestellt bis zur Lizenz (Klärung 24):* Gegeben Cover und Texte einer Quelle, dann werden sie nur angezeigt, wenn deren Nutzungsbedingungen es erlauben; die Erlaubnis ist je Quelle vermerkt. Das Feld für die Erlaubnis je Quelle ist ab R1 im Datenmodell vorhanden (Klärung 7). - [ ] **7.** Gegeben R1 geht live, dann enthält der Katalog einen manuell gepflegten Startbestand von etwa 200 Spielen, den der Admin (Chris) per Supabase Studio bzw. Seed einpflegt (Klärung 24, N11). - [ ] **8.** Gegeben die Admin-Pflege über Supabase Studio/SQL, dann ist der Ablauf für Bearbeiten, Ausblenden, Zusammenführen und das Bearbeiten von Meldungen im Repo dokumentiert (Klärung 44). - [ ] **9.** Gegeben ein Nutzer ohne Admin-Rolle, wenn er über die App oder direkt über die Schnittstelle Katalogeinträge oder fremde Meldungen ändern will, dann wird der Zugriff verweigert; die Admin-Rolle existiert in R1 nur als Datenbankrolle (Klärung 44). - [ ] **10.** *(neu)* Gegeben ein Spiel aus dem Startbestand, dann enthält es nur Fakten (Titel, Verlag, Erscheinungsjahr, Spielerzahl, Spieldauer, Mindestalter, Genre, Mechanik); fremde Cover und fremde Beschreibungstexte werden nicht übernommen, stattdessen zeigt die App ein Platzhalter-Cover und einen eigenen Kurztext (N11). ## Querschnitt Es gelten alle Querschnittskriterien aus `20-r1-akzeptanzkriterien.md` § „Querschnitt für R1“ (Datenschutz QUE-04, Sicherheit der Daten, Sprachen QUE-05, Barrierefreiheit QUE-06, Zustände/Fehler/Netz, Plattformen). Besonders relevant: **Sicherheit der Daten Kriterium 2** (Katalog ohne Anmeldung lesbar, nie durch Nutzer veränderbar; Entscheidung O6), Sicherheit der Daten Kriterium 3. ## Nicht im Scope - Admin-Oberfläche in der App (QUE-08, R4; Klärung 44) - Admin-Bereich für News-Quellen und Verifizierung (QUE-08, R4) - Import-Job aus BGG oder einer anderen Quelle in R1 (Klärung 24) – Kriterien 1, 2 (Quellenteil), 3, 6 erst mit Lizenz - Fremde Cover und Beschreibungstexte im Startbestand (N11) ## Klärungen Verbindlich laut `requirements/r1-klaerungen.md` (2026-11-02): - **6:** Neue Tabelle für Meldungen (Status offen/freigegeben/abgelehnt/zusammengeführt, Link, Verweis auf Zieleintrag) → Kriterium 5. - **7:** Flag „ausgeblendet“, Kennzeichnung manuell gepflegter Felder und Erlaubnis je Quelle schon in R1 modellieren → Kriterien 2, 4, 6. - **24:** Katalog zum Start nur manuell gepflegt, kein Import-Job bis BGG-Lizenz; R1.1 braucht manuelle Pflege und Startbestand → Kriterien 1–3, 6 zurückgestellt, Kriterium 7 neu. - **25/44:** Keine Admin-Story; Pflege über Supabase Studio/SQL, Admin-Rolle nur als DB-Rolle (RLS); Ablauf im Repo dokumentieren → Kriterien 4, 5, 8, 9. - **N11:** Startbestand ca. 200 Spiele, von Chris per Supabase Studio/Seed gepflegt; nur Fakten (Titel, Verlag, Jahr, Spielerzahl, Dauer, Alter, Genre, Mechanik); keine fremden Cover oder Beschreibungstexte – Platzhalter-Cover und eigene Kurztexte → Kriterien 7, 10. ## Offene Fragen Keine. ## Planung - Epic: KAT Spielekatalog - Priorität: Must - Größe: XL (durch Zurückstellung des Imports in R1 voraussichtlich kleiner; Neubewertung in der Spec) - Etappe: R1.1 Fundament (Datenmodell, Startbestand, Kriterien 2, 7, 9, 10); Admin-Pflege und Meldungen (Kriterien 4, 5, 8) in R1.2 Sammlung; Import erst mit Lizenz - Abhängigkeiten: keine (Fundament) ## Mögliche Schnitte für die Spec - KAT-05a Datenmodell inkl. Import-Vorbereitung, Rechte/Admin-Rolle und Startbestand (Kriterien 2, 7, 9, 10) - KAT-05b Admin-Pflege per Studio: bearbeiten, ausblenden, zusammenführen, Dokumentation (Kriterien 4, 8) - KAT-05c Meldungen bearbeiten (Kriterium 5) - später: KAT-05d Import aus einer Quelle (Kriterien 1, 3, 6), sobald Lizenz vorliegt ## Referenzen - Akzeptanzkriterien: `requirements/20-r1-akzeptanzkriterien.md` § KAT-05 - Klärungen: `requirements/r1-klaerungen.md` (inkl. N11) - Story-Entwurf: `requirements/r1-story-entwurf.md` (freigegeben 2026-11-02) - Backlog: `requirements/backlog.md`