Dokumentation: Spieleausleihe-System

⚡ Schnellstartanleitung

Der schnellste Weg zum ersten funktionierenden Event. Für die Details jedes Schritts einfach dem jeweiligen Link folgen.

1. Anmelden im Verwaltungstool. Kein Konto? → Registrieren mit Zugangscode (bei der Vereinsleitung erfragen).
2. Spiele erfassen: Im Tab ⚡ Schnellerfassung Zielsammlung(en) anhaken und einfach drauflos scannen — landet automatisch in Datenbank und Sammlung, Titel wird wo möglich automatisch erkannt. → Details
3. Event anlegen: Tab Events → Name eingeben, Sammlung(en) anhaken, optional gleich "Alle Spiele sofort bereitstellen" ankreuzen → "Event anlegen". → Details
4. Regal(e) anlegen im geöffneten Event-Fenster, falls nicht schon automatisch geschehen. → Details
5. Ausleihe- & Rückgabemeldung einstellen (manuell bestätigen oder Timer, je Aktion) — einmal pro Event. → Details
6. Am Tresen: "🖥️ Zum Tresen"-Link von der Event-Karte öffnen (oder direkt an einem zweiten Gerät) und dort scannen — läuft ohne Rückfragen, bei Mehrdeutigkeit poppt automatisch eine kurze Auswahl auf. → Details
7. Für Besucher: "👁️ Ansicht für Besucher:innen"-Link teilen oder als Einbett-Code auf der Vereins-Website einfügen. → Details
8. Nach dem Event: Tab Statistik → Auswertung ansehen, als CSV exportieren. → Details

Systemkonzept

Das System besteht aus vier aufeinander aufbauenden Ebenen. Wer das Prinzip einmal verstanden hat, findet sich in allen Tabs zurecht:

Zugriff & Anmeldung

• Verwaltungstool (spieleausleihe-verwaltung.html) und Ausleihe-Tresen (spieleausleihe-tresen.html) erfordern für alle Funktionen eine Anmeldung mit E-Mail und Passwort.
• Neue Konten können sich im Verwaltungstool über "Noch kein Konto? Registrieren" selbst anlegen — dafür ist ein Zugangscode nötig, den die Vereinsleitung ausgibt. Ein SuperAdmin-Konto kann den Code jederzeit über "🔑 Zugangscode" im Verwaltungstool-Header ändern (dahinter steckt die Tabelle app_config, Schlüssel registration_code — bei Bedarf auch direkt per phpMyAdmin einsehbar/änderbar).
• Das allererste Konto muss einmalig über das eigenständige Werkzeug first_account.html angelegt werden (kurz nach dem Einrichten der Datenbank einmal hochladen, aufrufen, Konto anlegen, danach wieder löschen) — es braucht ja selbst schon einen gültigen Zugangscode, den man beim allerersten Mal noch nirgends eingeben könnte.
• Die öffentliche Übersichtsseite (index.html) benötigt keine Anmeldung — sie zeigt nur, keine Bearbeitung möglich.

Typischer Ablauf vor und während eines Events

1. Vorbereitung zuhause: Neue Sammlung(en) anlegen, dann per Schnellerfassung durchscannen — landet automatisch in Datenbank und Sammlung, inkl. Titel-Erkennung über die GTNM-Referenz und automatischer BGG-Anreicherung im Hintergrund.
2. Event anlegen, Quell-Sammlungen wählen.
3. Regale für das Event anlegen (Regal A, B, C, …).
4. Direkt im Event-Fenster mit dem Schnellscan die Spiele ins jeweilige Regal einräumen (schnellster Weg beim Aufbau vor Ort).
5. Pro Event die Rückgabemeldung einstellen (manuell bestätigen oder Timer).
6. Event als aktiv setzen (optional, nur für die Ausleihe-Funktion im Verwaltungstool nötig).
7. Während der Veranstaltung: am Ausleihtresen die eigene Tresen-Seite für dieses Event öffnen und darüber scannen.
8. Einbett-Code auf der Vereins-Website einfügen, damit Besucher sehen, was verfügbar ist (aktualisiert sich automatisch alle 60 Sek.).
9. Nach dem Event: Statistik auswerten, als CSV exportieren und im Zeitverlaufs-Diagramm ansehen, für die nächste Planung.

Einstellungen (Ton, Anzeigedauer, Scan-Fokus)

Button "⚙️ Einstellungen" im Header — sowohl im Verwaltungstool als auch am Ausleihe-Tresen, für jeden angemeldeten Nutzer verfügbar. Die Einstellungen gelten pro Browser/Gerät (nicht pro Konto) — wer an einem anderen Rechner arbeitet, stellt sie dort separat ein. Sind Verwaltungstool und Tresen im selben Browser geöffnet, teilen sie sich automatisch dieselben Einstellungen.

• Anzeigedauer der Scan-Rückmeldung (Sekunden): Wie lange die große Rückmeldung in der Bildschirmmitte sichtbar bleibt, bevor sie von selbst verschwindet (z.B. "Catan erfasst"). Kürzer für zügiges Scannen im Stapel, länger falls mehr Zeit zum Lesen gewünscht ist.
• Ton bei erfolgreichem Scan: Ein kurzer Piepton bestätigt akustisch jeden erfolgreichen Scan — praktisch, wenn man nicht ständig auf den Bildschirm schauen kann. Ein-/ausschaltbar, standardmäßig an.
• Tonart: Drei auswählbare Varianten — "Hell & durchdringend" (Standard, setzt sich am besten gegen Gemurmel in einem vollen Raum durch), "Klassischer Zweiklang" (sanfter) und "Kurzer Klick" (sehr knapp). Mit "🔊 Testen" vorher reinhören. Die Auswahl steht zusätzlich als kompaktes Dropdown direkt neben jedem "Ton bei erfolgreichem Scan"-Häkchen (Schnellerfassung, Ausleihe-Tab, Event-Schnellscan) — alle Stellen sind synchron miteinander und mit diesem Einstellungen-Fenster.

Scan-Feld immer aktiv halten

Unter jedem Scan-Feld (Schnellerfassung, Ausleihe-Tab, Event-Schnellscan, Ausleihe-Tresen) gibt es einen eigenen Schieberegler "Scan-Feld immer aktiv halten" — standardmäßig aus, pro Feld einzeln einstellbar.

• USB-Barcodescanner tippen den Code dorthin, wo gerade der Bildschirm-Cursor steht — klickt man aus Versehen woanders hin, landet der nächste Scan im Leeren.
• Ist der Regler aktiviert, holt sich das Scan-Feld den Fokus automatisch zurück, sobald er verloren geht (z.B. nach einem Klick auf einen Button) — der nächste Scan trifft wieder zuverlässig ins richtige Feld.
• Ausnahme: Tippt man bewusst in ein anderes Textfeld (z.B. die Suche), wird der Fokus dort belassen — es wird also nicht mitten im Tippen weggeschnappt.

Spieledatenbank — Stufe 1: EAN erfassen

Tab Spieledatenbank. Hier werden neue Barcodes roh erfasst, bevor sie einen Titel haben.

• EANs nacheinander scannen (Scanner tippt automatisch in das Textfeld, eine Zeile pro Code) oder als Liste einfügen.
• Auf "Erfassen" klicken — die EANs werden sofort angelegt (zunächst ohne Titel).
• Das Tool gleicht jede neue EAN automatisch gegen die hinterlegte GTNM-Referenzliste ab (eine statische Titel-Datenbank mit ca. 18.500 Einträgen, Datei ean-referenz.json neben den Hauptseiten).
• Bei Treffern erscheint darunter ein Review-Panel: eine Zeile pro gefundenem Titel, jeweils in einem editierbaren Textfeld. Titel bei Bedarf korrigieren.
• Erst mit Klick auf "Übernehmen & bei BGG anreichern" werden die (ggf. korrigierten) Titel tatsächlich gespeichert (mit Quelle: GTNM-Referenz markiert) und automatisch bei BoardGameGeek (BGG) angereichert (Bild, Beschreibung, Spieleranzahl, Alter, Dauer, Bewertung, Komplexität). Das läuft mit Fortschrittsbalken, ca. 5 Sekunden pro Spiel (BGG-Rate-Limit).
• Alternativ "Schließen ohne Übernahme" — dann bleiben die betroffenen EANs einfach ohne Titel als "Offen" stehen, zur späteren Bearbeitung.

Spieledatenbank — Stufe 2: Titel-Liste importieren

Für EANs, die weder Scanner-Team noch GTNM-Referenz kennen (z.B. seltene/regionale Ausgaben), kann eine per Websuche recherchierte Titel-Liste importiert werden — egal ob die Recherche von Claude im Chat oder einer anderen KI stammt.

Erwartetes JSON-Format

Eine JSON-Liste (Array) mit einem Objekt pro Spiel, jedes Objekt mit genau den Feldern ean und title, beide als Text in doppelten Anführungszeichen:

[
  {"ean":"4001504494445","title":"e-Mission"},
  {"ean":"4002051684358","title":"Die Legenden von Andor - Die Bonus-Box"}
]

• Die EAN muss als Text in Anführungszeichen stehen (nicht als Zahl) — sonst gehen führende Nullen verloren.
• Nur die zwei Felder ean und title werden ausgewertet, weitere Felder stören nicht, sind aber unnötig.
• Liste einfügen, auf "Import starten" klicken. Für jeden Eintrag wird automatisch bei BGG gesucht (5 Sek. Abstand), das Ergebnis wird übernommen und mit Quelle: Recherche-Import markiert.
• Der Fortschrittsbalken und das Protokoll darunter zeigen, welche Einträge erfolgreich waren (✅) und welche nicht (⚠️).
• Button "Liste löschen" leert das Textfeld wieder, z.B. um eine neue Liste einzufügen.

Titel per KI recherchieren lassen

Für die Recherche selbst reicht jede KI mit Websuche-Fähigkeit (Claude, ChatGPT, Gemini, …). Einfach folgenden Text kopieren, die eigenen EAN-Codes darunter einfügen, und das gesamte Ergebnis danach eins zu eins in das Textfeld oben einfügen:

Ich brauche zu folgenden EAN-Codes von Gesellschaftsspielen die jeweiligen Spieltitel
(möglichst die deutsche Ausgabe, falls vorhanden). Bitte recherchiere jede EAN einzeln
per Websuche und gib mir ausschließlich ein valides JSON-Array in genau diesem Format
zurück, ohne jeglichen zusätzlichen Text davor oder danach:

[{"ean":"EAN1","title":"Titel1"},{"ean":"EAN2","title":"Titel2"}]

Wichtig:
- Die EAN immer als Text in Anführungszeichen, führende Nullen nicht weglassen.
- Findest du zu einer EAN keinen Titel, lass den Eintrag einfach weg, statt zu raten.
- Keine Erklärungen, keine Markdown-Codeblöcke, nur das reine JSON-Array.

Hier sind meine EAN-Codes:
[eigene EAN-Codes hier einfügen, eine pro Zeile]

Titel korrigieren & erneut bei BGG suchen

Manchmal findet BGG zu einem Titel keinen Treffer, obwohl das Spiel dort eigentlich gelistet ist — z.B. weil der erfasste Titel Zusätze, Sonderzeichen oder Schreibweisen enthält, die BGGs Suche nicht erkennt. Statt jedes betroffene Spiel einzeln von Hand zu öffnen und neu zu suchen, gibt es dafür den Button "✏️ Titel korrigieren & erneut bei BGG suchen" (oberhalb der Datenbank-Tabelle):

• Öffnet ein Fenster mit allen Spielen, die aktuell den Status Kein BGG-Treffer oder Fehler haben — EAN, bisheriger Titel, und ein Eingabefeld daneben zum Korrigieren.
• Titel wie gewünscht anpassen (z.B. Klammerzusätze entfernen, Tippfehler korrigieren), Spiele ohne sinnvollen Titel können auch unverändert bleiben.
• Button "Speichern & erneut suchen": schreibt die korrigierten Titel und läuft danach automatisch durch — mit derselben 5-Sek.-Pause je Spiel, Fortschrittsbalken und Protokoll wie bei Stufe 2, direkt im selben Fenster.
• Spiele ohne eingetragenen Titel werden beim Speichern übersprungen (BGG könnte ohnehin nichts finden).

Deutsche Titel

BGG selbst markiert seine Namenseinträge nicht zuverlässig nach Sprache — es gibt keinen sauberen "gib mir den deutschen Titel"-Aufruf, und teils liegt bei BGG ohnehin nur eine Sprachversion der Beschreibung vor (z.B. rein zufällig auf Deutsch, wenn ein Spiel ursprünglich in Deutschland populär wurde). Das System löst das für den Titel so: Der Titel, mit dem gesucht wird (aus GTNM-Referenz, Recherche-Liste oder eurer eigenen Eingabe — also praktisch immer schon Deutsch), bleibt immer als gespeicherter Titel bestehen. BGG liefert ausschließlich die Zusatzdaten (Bild, Beschreibung, Spieleranzahl, Alter, Dauer, Bewertung, Komplexität), nie den Titel selbst. Bei welcher Sprache die Beschreibung landet, entscheidet allein BGG — nicht steuerbar, aber im Formular jederzeit von Hand nachbearbeitbar (siehe unten).

Datenbank durchsuchen & bearbeiten

• Suchfeld filtert nach Name oder EAN, Status-Filter zeigt nur Offene / Fertige / Fehlerhafte Einträge.
• Die ganze Tabellenzeile ist anklickbar und öffnet die Spiel-Infos — nicht nur der "Bearbeiten"-Button.
• "(+) Spiel manuell anlegen" öffnet die Eingabemaske für Einzelfälle, inkl. eigener BGG-Suche mit Trefferauswahl.
• Im Formular gibt es ein eigenes, editierbares Feld "Beschreibung" — zeigt den von BGG übernommenen Text und lässt sich jederzeit von Hand anpassen oder ergänzen.
• Status-Badges: Offen (Stufe 1, noch kein Titel/BGG-Daten), Fertig (BGG-Daten vorhanden), Kein Treffer (Titel bekannt, aber BGG fand nichts), Fehler (technisches Problem beim Abgleich).
• Unter dem Namen steht klein die Titelquelle (GTNM-Referenz / manuell / Recherche-Import), damit immer nachvollziehbar bleibt, woher ein Titel kam.
• Button "🔄 Fehlende Beschreibungen nachholen": findet alle bereits "Fertig" angereicherten Spiele ohne Beschreibung (weil sie vor Einführung dieses Felds enzeichert wurden) und holt sie in einem Rutsch nach — gleicher 5-Sek.-Takt, Fortschrittsbalken.

EAN nachträglich korrigieren

Neuauflagen, überarbeitete Editionen oder ein anderer Vertrieb desselben Spiels bekommen häufig eine neue EAN, obwohl es inhaltlich dasselbe Spiel ist. Statt solche Fälle dauerhaft als Mehrfacheinträge stehen zu lassen, lässt sich die EAN eines bestehenden Spiels korrigieren.

• Im Bearbeiten-Formular eines Spiels ist die EAN standardmäßig gesperrt (Schreibschutz, da die EAN gleichzeitig die interne Datenbank-ID ist) — darunter die Checkbox "EAN korrigieren" aktivieren, um sie freizugeben.
• Neue EAN eintragen und speichern. Was dann passiert, hängt davon ab, ob diese EAN schon existiert:

Globale Schnellerfassung

Tab ⚡ Schnellerfassung — der schnellste Weg, viele Spiele auf einmal ins System zu bringen, ganz ohne Rückfragen pro Spiel.

• Einmal einstellen: Häkchen bei den Ziel-Sammlungen setzen, optional ein Regal des aktiven Events wählen.
• Danach nur noch scannen — jeder Scan trägt sofort ohne Rückfrage ein: neu in die Datenbank (mit automatischem GTNM-Titel-Vorschlag), in die angehakten Sammlungen, und falls ein Regal gewählt ist, direkt ins aktive Event.
• Nach jedem Scan erscheint kurz eine Bestätigung in der Bildschirmmitte ("✅ [Spielname] erfasst", optional mit Ton) und verschwindet von selbst wieder — Dauer und Ton einstellbar unter Einstellungen. Ideal beim zügigen Durchscannen einer ganzen Sammlung.
• Unter dem Scan-Feld der Schieberegler "Scan-Feld immer aktiv halten" (siehe Einstellungen) — hilfreich, falls der Fokus beim Scannen öfter mal verloren geht.
• BGG-Anreicherung läuft dabei im Hintergrund (5-Sek.-Takt, eigene Warteschlangen-Anzeige), damit das Scan-Tempo nicht ausgebremst wird.
• Scannst du eine EAN, die in der Sammlung/im Event schon existiert, wird der bestehende Datenbank-Eintrag nicht verändert — es wird lediglich die Stückzahl um 1 erhöht, genau der Mehrfach-Exemplare-Fall.
• Ein Protokoll unten zeigt zusätzlich jeden Scan mit Ergebnis im Verlauf.

Sammlungen verwalten

Tab Sammlungen. Eine Sammlung bündelt die Spiele, die eine bestimmte Person oder Gruppe besitzt.

• Neue Sammlung anlegen: Name (Pflicht) und Beschreibung (optional).
• Sammlung öffnen → Name und Beschreibung sind dort jederzeit editierbar (Felder + "Speichern").
• Spiele aus der Datenbank per Name/EAN-Suche hinzufügen. Nur Spiele, die bereits in der Datenbank stehen, können hinzugefügt werden.
• Dasselbe Spiel (gleiche EAN) kann in mehreren Sammlungen stehen, wenn mehrere Exemplare existieren.
• Pro Spiel in der Sammlung gibt es +/− Buttons für die Stückzahl — wie viele Exemplare besitzt diese Sammlung.
• Spiele lassen sich aus der Sammlung entfernen, ohne dass sie aus der Datenbank verschwinden.
• Sammlung löschen entfernt nur die Zuordnung, nicht die Spiele selbst.

Mengen & Mehrfach-Exemplare

Statt nur "verfügbar/ausgeliehen" gibt es echte Stückzahlen — sowohl in Sammlungen als auch in Events.

• In einer Sammlung: Stückzahl = wie viele Exemplare diese Sammlung besitzt.
• In einem Event: jeder Spiel-Eintrag hat eine Stückzahl (z.B. "2/3 verfügbar") statt nur Ja/Nein. +/− Buttons im Event-Fenster passen das an.
• Ein Spiel-Eintrag trägt technisch ein Regal-Feld — im Normalfall liegen alle Exemplare eines Spiels also im selben Regal. Bewusst möglich ist trotzdem, zwei Exemplare desselben Spiels auf zwei verschiedene Regale aufzuteilen (siehe Regal-Konflikt-Hinweis) — das System merkt sich dann nur noch eines der beiden Regale, bei der Rückgabe ist nicht mehr unterscheidbar, aus welchem Regal welches Exemplar kam.
• Untergrenze ist immer 0, nie negativ (auch technisch abgesichert, nicht nur über die deaktivierten Minus-Buttons).

Verlagstisch (permanent ausgestellte Exemplare)

Für Spiele, die während eines Events dauerhaft auf einem Verlagstisch aufgebaut sind und nicht regulär ausgeliehen werden — z.B. Demo-Exemplare eines Verlags.

• Markieren: In der Tabelle "Spiele bei diesem Event" (Event-Fenster) gibt es je Spiel-Eintrag ein Zahlenfeld "Verlagstisch": wie viele der insgesamt vorhandenen Exemplare permanent auf einem Verlagstisch stehen.
• Das ist bewusst eine Stückzahl, keine Ja/Nein-Checkbox: Hat ein Spiel z.B. 2 Exemplare und trägst du dort eine 1 ein, bleibt automatisch 1 Exemplar ganz normal ausleihbar (mit eigenem Verfügbar/Ausgeliehen-Status), während das andere fest dem Verlagstisch zugeteilt ist.
• Anzeige — zwei getrennte Zeilen: Ist ein Spiel sowohl auf dem Verlagstisch als auch normal ausleihbar, erscheint es in der Ansicht für Besucher:innen und am Ausleihe-Tresen als zwei eigene Tabellenzeilen — eine für die ausleihbaren Exemplare (mit normalem Verfügbar/Ausgeliehen-Status, ggf. Ausleihen/Rückgabe-Button) und eine für die Verlagstisch-Exemplare (Regal-Spalte zeigt "Verlagstisch", Status "🏢 X auf Verlagstisch", kein Button). Ist ein Spiel ausschließlich auf dem Verlagstisch, gibt es entsprechend nur die eine Zeile.
• Kann nicht regulär zurückgenommen werden: Ein Scan dieses Spiels am Ausleihe-Tresen betrifft ausschließlich die normal ausleihbaren Exemplare (falls vorhanden) — die Verlagstisch-Zeile hat gar keinen Ausleihen/Rückgabe-Button und reagiert nicht auf Scans. Sind alle Exemplare eines Spiels dem Verlagstisch zugeteilt, zeigt ein Scan stattdessen nur einen Hinweis.
• Entfernen: Nur im Verwaltungstool möglich — Zahlenfeld "Verlagstisch" bei diesem Spiel-Eintrag wieder auf 0 setzen (die Stückzahl reduziert sich nicht von selbst, auch nicht am Ende des Events).

Öffentlicher Link zur Sammlung

Im geöffneten Sammlungsfenster steht unter "Öffentlicher Link zu dieser Sammlung" eine fertige URL zur eigenständigen Seite sammlung-uebersicht.html?collection=SAMMLUNG_ID — Button "Kopieren" reicht. Diese Seite zeigt nur genau diese eine Sammlung, direkt einbettbar oder verschickbar, ganz ohne Login. Wird die Seite ohne ?collection=-Parameter aufgerufen, zeigt sie stattdessen ein Dropdown zur Auswahl unter allen vorhandenen Sammlungen.

BGStats-Import

Für Spieler:innen, die ihre eigene Sammlung bereits in der App BGStats pflegen. Im Sammlungen-Tab über "BGStats-JSON importieren".

• Export in BGStats: Einstellungen → Backup & Export → Export als JSON.
• Name für die neue Sammlung eingeben, JSON-Datei auswählen, "Datei analysieren" klicken. Die Datei wird ausschließlich lokal im Browser gelesen, nie irgendwohin hochgeladen — und Spielpartien (Plays) werden komplett ignoriert, es zählt nur, welche Spiele als "besessen" markiert sind.
• Wichtige Einschränkung: BGStats speichert grundsätzlich keine EAN-Codes. Der Abgleich läuft daher über die BoardGameGeek-ID (BGG-ID): Spiele, die in eurer Datenbank bereits mit derselben BGG-ID bekannt sind, werden automatisch der neuen Sammlung zugeordnet (mit BGStats-Stückzahl).
• Alle übrigen Spiele (in eurer Datenbank bisher unbekannt) erscheinen in einer Review-Tabelle mit einem leeren EAN-Feld pro Zeile — hier muss einmal das physische Exemplar gescannt werden. Enter im Feld übernimmt den Wert und springt automatisch zum nächsten noch leeren Feld, sodass sich der ganze Stapel am Stück durchscannen lässt.
• Zeilen ohne eingetragene EAN werden beim Import einfach übersprungen (kein Abbruch der übrigen Zeilen).
• Neu angelegte Spiele bekommen dabei bereits Titel, Bild und Spieleranzahl aus BGStats mit, sind aber als Offen markiert (kein vollständiger BGG-Abgleich mit Beschreibung/Bewertung/Komplexität) — anschließend ganz normal über die Spieledatenbank nachbearbeiten oder per BGG-Suche anreichern.

Event anlegen

Tab Events. Name, Datum, und Häkchen bei den Sammlungen setzen, aus denen bei diesem Event Spiele ausgewählt werden dürfen. Ein Event ganz ohne Sammlung ist ebenfalls möglich — dann werden Spiele stattdessen direkt aus der gesamten Spieledatenbank hinzugefügt (siehe Spiele zum Event hinzufügen).

Zusätzliche Checkbox "Alle Spiele der ausgewählten Sammlung(en) sofort bereitstellen": direkt beim Anlegen wird automatisch ein Regal namens "Hauptregal" erstellt und mit sämtlichen Spielen der angehakten Sammlung(en) inkl. korrekter Stückzahl befüllt — praktisch, wenn beim Event ohnehin die komplette Sammlung zur Verfügung steht und keine feinere Regal-Aufteilung nötig ist.

Regale je Event

Jedes Event hat seine eigenen Regale (Regal A, B, C, …) — Regale werden nicht zwischen Events geteilt, da sich der Aufbau von Veranstaltung zu Veranstaltung unterscheiden kann. Ein "Regal" ist dabei ganz bewusst allgemein gemeint — genauso gut ein Karton, wenn ein Teil der Sammlung in Kartons statt in Regalen gelagert wird. Einfach entsprechend benennen (z.B. "Karton 3").

• Event öffnen → Regal-Name eingeben → "Regal anlegen".
• Ein Regal mit zugeordneten Spielen kann nicht gelöscht werden — zuerst die Spiele umlagern oder entfernen.
• Button "Umbenennen" auf jeder Regal-Karte: Spiele im Event verweisen nur auf die Regal-ID, nie auf den Namen selbst — eine Umbenennung wirkt daher sofort überall (Dropdowns, Ausleihe-Tresen, Rückgabe-Hinweise, Preisträger-Abgleich), ohne dass einzelne Spiel-Einträge angefasst werden müssen.
• Wird beim Umbenennen ein Name gewählt, den in diesem Event bereits ein anderes Regal trägt, erscheint statt einer stillen Umbenennung eine Rückfrage: Sollen wirklich alle Spiele aus dem umbenannten Regal dem bestehenden gleichnamigen Regal zugeordnet werden (= zusammenführen)? Erst nach Bestätigung werden die betroffenen Spiele umgehängt und das jetzt leere Regal automatisch gelöscht.
• Button "🏷️ Etikett": erzeugt ein druckfertiges A4-PDF für dieses Regal/diesen Karton — großer Name oben, Gesamtzahl der Spiele, darunter die vollständige, alphabetisch sortierte Liste (bei mehreren Exemplaren eines Spiels mit "(Nx)"-Vermerk). Schriftgröße und ggf. zwei Spalten passen sich automatisch an, damit die Liste die Seite wirklich ausfüllt, egal ob 5 oder 50 Spiele drin stehen. Zum Aufkleben auf den Karton ausdrucken.
• Button "📦 Als Sammlung": legt aus dem aktuellen Inhalt dieses Regals eine neue Sammlung an (Name frei wählbar, Vorschlag aus Regal- und Eventname) — mit exakt denselben Spielen und Stückzahlen. Praktisch, um einen fertig gepackten Karton für ein späteres Event komplett wiederzuverwenden: die neue Sammlung taucht danach ganz normal bei "Ganze Sammlung ins Event laden" auf.

Regal-Konflikt-Hinweis

Relevant vor allem im Mehrgeräte-Betrieb (mehrere EAN-Scanner gleichzeitig im Einsatz beim Aufbau eines Events): Ohne Absprache kann es passieren, dass ein Spiel in Regal A schon eingeräumt ist, während an einem anderen Gerät dasselbe Spiel gerade für Regal C gescannt wird. Ziel ist dabei immer, Spiele möglichst an einem einzigen Ort zu sammeln.

Ein Regal pro Spiel erzwingen (Standard bei neuen Events)

• Im Event-Fenster unter den Event-Einstellungen: Checkbox "Ein Regal pro Spiel erzwingen" — bei neu angelegten Events standardmäßig aktiv. Bereits bestehende, ältere Events haben sie nicht automatisch aktiv (Rückwärtskompatibilität) und müssten sie bei Bedarf manuell einschalten.
• Jedes Spiel bleibt dabei fix in dem Regal, in dem es zuerst eingeräumt wurde — dem Basisregal. Wird es für ein anderes Regal gescannt (egal ob über manuelle Suche, Schnellerfassung oder Schnellscan), erscheint eine Rückfrage mit einem einzigen Button "Bestätigen": "[Spiel] ist bereits in Regal [Basisregal] — bitte dort einräumen." — inklusive Warnton. Es gibt bewusst keine Zeitautomatik und keine Alternative dazu: Ein Aufteilen auf mehrere Regale ist in diesem Modus schlicht nicht möglich, die Stückzahl wird trotzdem erhöht.
• Vorteil: Am Ausleihe-Tresen ist danach immer eindeutig, aus welchem Regal ein Exemplar stammt — die zusätzliche Rückfrage beim Ausleihen (siehe unten) entfällt komplett, weil es gar nicht erst zu einem Spiel in zwei Regalen kommen kann.

Alternative: nur warnen, Aufteilen auf mehrere Regale bleibt möglich

Wird "Ein Regal pro Spiel erzwingen" für ein Event deaktiviert, erscheinen darunter die bisherigen, flexibleren Einstellungen:

• Checkbox "Stattdessen nur warnen, wenn ein Spiel in diesem Event schon einem anderen Regal zugeordnet ist" — standardmäßig aus.
• Bei aktivierter Checkbox erscheint bei Konflikt dieselbe Rückfrage wie oben, aber jetzt mit einem zweiten Button: "Trotzdem in [C] umräumen" — das Spiel wird dann bewusst in zwei Regalen geführt.
• Wie lange auf eine Reaktion gewartet wird, legt eine zweite Einstellung fest — dasselbe Muster wie bei der Ausleihe-/Rückgabemeldung:

• "Bestätigen": keine Änderung am Eintrag, die Stückzahl wird trotzdem um 1 erhöht — die Erwartung ist, dass das physische Exemplar ins bestehende Regal A wandert.
• "Trotzdem umräumen" (oder Zeit abgelaufen): der bestehende Eintrag bleibt im alten Regal, die Stückzahl wird ebenfalls erhöht — zusätzlich merkt sich das System "steht auch in Regal C" und zeigt das als kleinen Zusatz überall an, wo das Regal angezeigt wird (Verwaltungstool, Ausleihe-Tresen, Ansicht für Besucher:innen) — ohne Stückzahl-Aufteilung, nur als Hinweis. Wird das Regal später manuell über das Dropdown geändert, gilt das als bewusste Konsolidierung — der Zusatz-Hinweis wird dabei gelöscht.
• Bei einem so aufgeteilten Spiel fragt der Ausleihe-Tresen beim Ausleihen jetzt aktiv nach, aus welchem der beiden Regale das Exemplar entnommen wird (siehe Ausleihe/Rückgabe-Logik) — die Rückgabe-Meldung nennt danach exakt das richtige Regal statt nur "oder".
• Bei Bulk-Importwegen (BGStats-Import, ganze Sammlung ins Event laden) erscheint diese Rückfrage bewusst nie, unabhängig vom gewählten Modus — dort läuft niemand interaktiv mit, der sie beantworten könnte.

BGG-Suche: Treffer nach Relevanz sortiert

Die BGG-Such-API liefert Treffer nicht nach Relevanz, sondern in einer internen, nicht dokumentierten Reihenfolge zurück. Bei kurzen, häufigen Titeln (z.B. "Odin") kann der eigentlich gesuchte Treffer dadurch unter vielen Titeln verschwinden, die den Suchbegriff nur enthalten, und sogar aus den ersten angezeigten Ergebnissen herausfallen.

• Sowohl die manuelle "🎲 BGG suchen"-Trefferliste im Spiel-Formular als auch der automatische Hintergrund-Abgleich (Scan-Warteschlange, Stufe-2-Übernahme, BGStats-Import) sortieren Treffer jetzt nach Relevanz: 1) exakte Namensübereinstimmung, 2) Titel beginnt mit dem Suchbegriff als eigenes Wort, 3) Suchbegriff kommt als eigenes Wort im Titel vor, 4)/5) sonstige Teilübereinstimmungen.
• Betrifft insbesondere den automatischen Hintergrund-Abgleich: dort wurde vorher unsortiert einfach der erste BGG-Treffer übernommen, jetzt der relevanteste.

Spiele zum Event hinzufügen (manuelle Suche)

• Im Event-Fenster unter "Spiele manuell suchen" zuerst das gewünschte Regal auswählen (steht oben, direkt über dem Suchfeld) — bleibt eingestellt, solange das Event-Fenster offen ist, auch über mehrere Suchen hinweg. So lässt sich zügig hintereinander weg mehrfach suchen und hinzufügen, ohne das Regal jedes Mal neu wählen zu müssen.
• Danach nach Name oder EAN suchen.
• Die Suche prüft zuerst die für dieses Event verknüpften Sammlungen (Treffer zeigen den Sammlungsnamen dazu), und zusätzlich immer auch die gesamte Spieledatenbank (Treffer sind mit "aus Gesamtdatenbank, keine Sammlung" gekennzeichnet) — praktisch für Events ganz ohne verknüpfte Sammlung, oder um gezielt ein einzelnes Spiel zu ergänzen, das in keiner verknüpften Sammlung steckt.
• Klick auf einen Treffer fügt das Spiel dem gewählten Regal hinzu. Ist das Spiel schon in einem anderen Regal dieses Events, greift derselbe Regal-Konflikt-Hinweis wie beim Scannen (falls für dieses Event aktiviert). Ist es schon im selben Regal, zeigt der Button "+1 Exemplar" und erhöht nur die Stückzahl.
• Alternativ mehrere Treffer per Kontrollkästchen markieren und über "X ausgewählte Spiele hinzufügen" auf einmal übernehmen — landen alle im oben gewählten Regal.
• Das Regal eines bereits hinzugefügten Spiels lässt sich jederzeit über die Dropdown-Auswahl in der Tabelle "Spiele bei diesem Event" ändern.
• Ein Spiel entfernen ist nur möglich, solange kein Exemplar davon gerade ausgeliehen ist.

Filtern, sortieren & Tabelle mit begrenzter Höhe

Über der Tabelle "Spiele bei diesem Event" lässt sich nach Name suchen sowie nach Regal und Status (Alle / Verfügbar / Ausgeliehen / Verlagstisch) filtern, dazu eine Sortierung wählen (Name, Regal, Status). Die Tabelle selbst scrollt bei vielen Einträgen innerhalb eines begrenzten Bereichs (Kopfzeile bleibt dabei sichtbar), statt das ganze Event-Fenster beliebig in die Länge zu ziehen.

Verknüpfte Sammlungen nachträglich ändern

Die Sammlungen eines Events müssen nicht mehr bei der Erstellung endgültig feststehen. Im Event-Fenster ganz oben unter "Verknüpfte Sammlungen" lassen sich die Häkchen jederzeit anpassen — Button "Sammlungen speichern" übernimmt die Änderung sofort, ohne das Fenster neu öffnen zu müssen. Praktisch, wenn beim Anlegen versehentlich keine oder die falsche Sammlung gewählt wurde.

Ganze Sammlung / Datenbank ins Event laden

Im Event-Fenster unter "📦 Ganze Sammlung ins Event laden" — überträgt auf einen Schlag viele Spiele in ein Regal, statt sie einzeln zu suchen.

• Dropdown zeigt alle mit dem Event verknüpften Sammlungen, plus immer zusätzlich die Option "🗄️ Gesamte Spieledatenbank (alle Spiele)" — unabhängig davon, ob überhaupt eine Sammlung verknüpft ist.
• Regal wählen, "Sammlung laden" klicken.
• Bei einer echten Sammlung wird die jeweilige Stückzahl aus der Sammlung übernommen; bei der gesamten Datenbank bekommt jedes Spiel 1 Exemplar.
• Bereits im Event vorhandene Spiele werden nicht doppelt angelegt, sondern in der Stückzahl passend erhöht.
• Bei der "Gesamte Spieledatenbank"-Option erscheint ab 30 Spielen eine Sicherheitsabfrage, damit das nicht versehentlich ausgelöst wird.

Schnellscan im Event-Fenster

Der schnellste Weg, ein Event physisch aufzubauen: direkt im geöffneten Event-Fenster unter "⚡ Schnellscan direkt ins Regal".

• Regal auswählen (Dropdown mit den Regalen dieses Events).
• Danach einfach scannen — jedes Spiel landet sofort ohne Rückfrage in der Datenbank, in den für dieses Event gewählten Sammlungen und im gewählten Regal.
• Scannst du eine schon vorhandene EAN nochmal, erhöht sich einfach die Stückzahl.
• Läuft komplett unabhängig vom oben im Tool gewählten "aktiven Event" — bezieht sich immer genau auf das gerade geöffnete Event.

Einbett-Code & Tresen-Link

Jedes Event hat im geöffneten Event-Fenster zwei fertige Links:

• Einbettungs-Code für die Website: ein <iframe>-Schnipsel, "Code kopieren" und in die Vereins-Website einfügen — zeigt Besuchern den Ausleihstatus dieses Events (alle 60 Sek. automatisch aktualisiert, plus manueller "Jetzt aktualisieren"-Button), ganz ohne Login.
• Ausleihe-Tresen für dieses Event: direkter Link zur eigenen Tresen-Seite (siehe unten), zum Kopieren oder direkt "Öffnen".

Ausleihe- & Rückgabemeldung einstellen

Im Event-Fenster legst du getrennt für Ausleihe und Rückgabe fest, wie sich die große Bestätigungskarte am Ausleihe-Tresen verhält:

• "Rückgabe-Meldung am Tresen": gilt für die Karte bei Rückgaben (zeigt zusätzlich, in welches Regal einzuräumen ist).
• "Ausleihe-Meldung am Tresen": gilt für die Karte bei Ausleihen (zeigt, aus welchem Regal das Spiel stammt, sowie "Viel Spaß!").
• Für beide jeweils: Manuell bestätigen (bleibt stehen, bis jemand auf "OK" klickt) oder Automatisch ausblenden nach X Sekunden (verschwindet von selbst, Sekundenzahl frei einstellbar) — unabhängig voneinander wählbar.

Das kleine, immer sichtbare Ergebnis-Feld unter dem Scan-Feld (siehe Ausleihe-Tresen) bleibt von beiden Einstellungen unberührt und zeigt weiterhin dauerhaft die letzte Aktion.

Ausleihdauer anzeigen

Zeigt an, wie lange ein Spiel-Exemplar schon draußen ist (h:mm), am Ausleihe-Tresen und in der Ansicht für Besucher:innen.

• Im Event-Fenster unter den Event-Einstellungen die Checkbox "Ausleihdauer (h:mm) am Tresen und in der Ansicht für Besucher:innen anzeigen" aktivieren — standardmäßig aus.
• Nutzt die ohnehin schon vorhandene loans-Sammlung (ein Dokument pro Ausleihvorgang mit Zeitstempel) — kein zusätzliches Datenmodell nötig, kein eigenes Feld wird dafür gespeichert. Die Anzeige wird bei jedem Laden aus dem gespeicherten Zeitpunkt neu berechnet ("jetzt − Ausleihzeitpunkt"), nicht als fixer Wert abgelegt.
• Sind von einem Spiel gerade mehrere Exemplare gleichzeitig draußen, wird die am längsten laufende Ausleihe angezeigt.
• Die Spalte zeigt in der Ansicht für Besucher:innen Werte, sobald der active_loans-Endpunkt Daten liefert — ist bei dieser Version bereits öffentlich zugänglich (siehe Zugriffsrechte der API).

Aktives Event setzen/deaktivieren

Oben im Verwaltungstool wählt eine Dropdown-Liste das aktive Event. Alle Aktionen im Tab "Ausleihe/Rückgabe" und in der globalen Schnellerfassung beziehen sich ausschließlich auf dieses Event. Die Auswahl wird lokal im Browser gespeichert — jeder Rechner/jedes Gerät muss sein eigenes aktives Event setzen.

• Setzen: über das Dropdown, oder im geöffneten Event-Fenster über den Button (zeigt "Als aktiv setzen").
• Deaktivieren: eigener "Deaktivieren"-Button direkt neben dem Dropdown, oder im Event-Fenster wechselt derselbe Button automatisch zu "Deaktivieren (aktuell aktiv)", solange dieses Event aktiv ist.

Ausleihe-Tresen

Datei spieleausleihe-tresen.html — eine schlanke, eigenständige Seite speziell für den Betrieb am Ausleihtisch während der Veranstaltung, ohne den restlichen Verwaltungstrubel.

• Aufruf über den Link aus dem Event-Fenster bzw. der Event-Karte ("🖥️ Zum Tresen", ?event=EVENT_ID in der URL) oder ohne Parameter mit Event-Auswahl beim Start.
• Login erforderlich (dieselben Konten wie im Verwaltungstool). Im Header außerdem das BGG-Logo (verlinkt zu boardgamegeek.com) sowie "⚙️ Einstellungen" (siehe Einstellungen) und "📖 Dokumentation".
• Immer sichtbar: eine Zeile mit der Anzahl gerade ausgeliehener Spiel-Exemplare.
• Darunter eingeklappt der Button "📊 Statistik anzeigen" — öffnet bei Bedarf die volle Kennzahlen-Übersicht. Bewusst nicht permanent sichtbar, um am Tresen nicht abzulenken.
• Großes Scan-Feld, darunter der Schieberegler "Scan-Feld immer aktiv halten" (siehe Einstellungen). Scannen läuft ohne Rückfrage in den allermeisten Fällen (siehe Ausleihe/Rückgabe-Logik) — bei Erfolg piepst es kurz (falls aktiviert) und in der Bildschirmmitte erscheint eine Rückmeldung.
• Bei Rückgabe erscheint zusätzlich die große Regal-Hinweis-Karte, Verhalten je nach Einstellung dieses Events. Die Bestätigen-Buttons (Regal-Hinweis-Karte, Ausleihen/Rückgabe-Auswahl bei mehrdeutigen Scans) sind deutlich größer dargestellt, um sie in hektischen Momenten leichter treffen zu können.
• Spieleliste: zeigt immer alle Spiele des Events (nicht nur ausgeliehene), mit Bild-Thumbnail pro Zeile — Klick auf Bild oder Namen öffnet dieselbe Detailansicht wie in der Ansicht für Besucher:innen (größeres Bild, Beschreibung, BGG-Link). Suchfeld und einklappbares "🔍 Filter & Sortierung"-Panel — Spielerzahl, Komplexität, Bewertung, Regal, Sortierung, Status (Alle / Nur verfügbar / Nur ausgeliehen). Der Regal-Filter eignet sich z.B. für eine schnelle Regal-Kontrolle vor Ort: nach dem gewünschten Regal filtern und abgleichen, ob wirklich alles da steht, was das System dafür führt. Damit lassen sich auch Besucherfragen wie "Spiel für 2 Personen?" direkt am Tresen beantworten. Ein-Klick-Rückgabe-Button erscheint dort, wo etwas ausgeliehen ist. Ist Ausleihdauer anzeigen für dieses Event aktiviert, erscheint zusätzlich eine Spalte "Ausgeliehen seit"; ist bei einem Spiel eine Verlagstisch-Stückzahl gesetzt, erscheint der Hinweis "🏢 X auf Verlagstisch" (siehe Verlagstisch).
• Manuelle Suche als Fallback, falls der Scanner ausfällt.
• Unbekannte Scans: Wird eine EAN gescannt, die diesem Event nicht zugeordnet ist, erscheint sie zusätzlich in einem eigenen Panel "❓ Unbekannte Scans (diese Sitzung)" — mit Filterfeld und einem "📋 Liste kopieren"-Button, um die gesammelten EANs z.B. direkt in eine KI-Recherche (siehe Stufe 2: Titel-Liste importieren) einzufügen. Diese Liste lebt nur im Browser der aktuellen Sitzung auf diesem einen Gerät, wie das Aktivitäts-Protokoll — sie wird beim Neuladen der Seite geleert und nicht zwischen mehreren gleichzeitig genutzten Tresen-Geräten abgeglichen.
• Kein Zugriff auf Datenbank-Verwaltung, Sammlungen o.ä. — bewusst reduziert auf den reinen Tresen-Betrieb.

Ausleihe/Rückgabe-Logik

Sowohl am Ausleihe-Tresen als auch im Verwaltungstool gilt dieselbe Logik, damit ein Scan möglichst nie erklärt werden muss:

• Hat ein Spiel nur ein Exemplar, ist der nächste Scan eindeutig: verfügbar → wird ausgeliehen, ausgeliehen → wird zurückgegeben. Kein Klicken, keine Rückfrage.
• Hat ein Spiel mehrere Exemplare, aber gerade sind alle verfügbar oder alle draußen, ist es ebenfalls eindeutig und läuft automatisch.
• Nur wenn ein Spiel mehrere Exemplare hat und gleichzeitig manche verfügbar und manche draußen sind, ist ein Scan wirklich mehrdeutig — dann erscheint ein kurzes Pop-up mit zwei Buttons ("📖 Ausleihen" / "↩️ Rückgabe"), einmal antippen, fertig.
• Ist "Ein Regal pro Spiel erzwingen" für dieses Event deaktiviert und das Spiel dadurch tatsächlich auf zwei Regale aufgeteilt (siehe Regal-Konflikt-Hinweis), fragt der Ausleihe-Tresen beim Ausleihen zusätzlich per kleinem Auswahl-Popup nach: "Aus welchem Regal wird dieses Exemplar entnommen?" — Dropdown mit den beiden (oder mehr) Regalen zur Auswahl. Erst nach Bestätigung wird die Ausleihe gebucht; "Abbrechen" bricht die ganze Ausleihe ab. Bei nur einem Regal entfällt dieser Schritt, wie gehabt, komplett.
• Diese Auswahl wird im Ausleihe-Log (loans) mitgespeichert — die Rückgabe-Meldung nennt später deshalb exakt das richtige Regal statt nur eine "oder"-Vermutung.

Ausleihe im Verwaltungstool

Tab Ausleihe/Rückgabe — dieselbe Funktion und dieselbe Logik wie am Tresen, aber innerhalb des vollständigen Verwaltungstools und immer bezogen auf das oben gewählte aktive Event. Praktisch, wenn ohnehin schon im Tool gearbeitet wird und kein separates Tresen-Gerät nötig ist.

• Scannen: EAN ins obere Feld scannen (oder eintippen + Enter). Darunter der Schieberegler "Scan-Feld immer aktiv halten" (siehe Einstellungen).
• Manuelle Suche: Falls der Scanner ausfällt, Spielname im zweiten Feld eintippen, Treffer anklicken.
• Unbekannte EAN: Ist das Spiel gar nicht in der Datenbank, bietet das Tool an, es direkt anzulegen. Ist es in der Datenbank, aber diesem Event noch nicht zugeordnet, bietet es an, es dem Event hinzuzufügen.
• Die Tabelle "Aktuell ausgeliehen" zeigt alle offenen Ausleihen mit Regal und Stückzahl draußen, inkl. direktem Rückgabe-Button.

Statistik, CSV-Export & Diagramm

Tab Statistik. Event auswählen, um Kennzahlen zu sehen: Gesamtzahl Ausleihen, Anzahl verschiedener ausgeliehener Spiele, aktuell noch nicht zurückgegebene Spiele, sowie eine Rangliste der am häufigsten ausgeliehenen Spiele.

CSV-Export

• Button "⬇️ Als CSV exportieren" lädt eine Datei mit einer Zeile pro Ausleihvorgang herunter (Ausleihe und zugehörige Rückgabe zusammen in derselben Zeile, nicht mehr getrennt). Derselbe Export steht auch direkt im Event-Fenster als "⬇️ Ausleihe-Log als CSV" zur Verfügung, ohne den Umweg über den Statistik-Tab.
• Spalten: Datum, Uhrzeit (Ausleihe), Spiel, Regal, Rückgabe-Datum, Rückgabe-Uhrzeit, Dauer.
• Dauer wird automatisch aus Ausleih- und Rückgabezeitpunkt berechnet (Format h:mm). Ist ein Exemplar zum Exportzeitpunkt noch nicht zurückgegeben, bleiben Rückgabe-Datum/Rückgabe-Uhrzeit leer und in Dauer steht "noch ausgeliehen".
• Am Ende der Datei folgt ein eigener Abschnitt "Zusammenfassung — Gesamtausleihen je Spiel" mit der Gesamtzahl an Ausleihen pro Spiel, absteigend sortiert. Spiele, die nie ausgeliehen wurden, tauchen dort naturgemäß nicht auf.
• Datenquelle ist die loans-Sammlung — ein Dokument pro Ausleihvorgang mit Ausleih- und (sobald erfolgt) Rückgabezeitpunkt. Das ist derselbe vollständige, dauerhaft in der Datenbank gespeicherte Ausleihe-Log, den auch das kleine, nur sitzungslokale "📝 Letzte Aktionen"-Protokoll am Ausleihe-Tresen ergänzt (dieses zeigt nur die letzten 10 Einträge des aktuellen Geräts, rein als Gedächtnisstütze — für die vollständige, dauerhafte Historie ist immer der CSV-Export die richtige Quelle).

Zeitverlaufs-Diagramm

• Button "📈 Diagramm anzeigen" — standardmäßig eingeklappt, öffnet ein Balkendiagramm (Plotly) über den zeitlichen Verlauf.
• Zeitraster einstellbar: 5 Minuten / 15 Minuten / 1 Stunde / 4 Stunden.
• Ausleihen werden als positive Balken, Rückgaben als negative Balken dargestellt — auf einen Blick sichtbar, wann viel Betrieb war und wann eher Ruhe.
• Damit lässt sich im Nachhinein einschätzen, wie viele Mitarbeiter:innen zu welcher Uhrzeit am Tresen nötig gewesen wären, und wie gut besucht ein Event tatsächlich war.

Öffentliche Übersicht (index.html)

• Aufruf mit ?event=EVENT_ID in der URL zeigt direkt dieses Event (so ist auch der Einbett-Code aufgebaut).
• Ohne Event-Parameter zeigt die Seite ein Dropdown zur Auswahl unter allen vorhandenen Events.
• Oben neben dem Titel das BGG-Logo (verlinkt zu boardgamegeek.com) als Herkunftsnachweis der Spieledaten.
• Nicht mehr live, sondern periodisch aktuell: Die Seite lädt sich automatisch alle 60 Sekunden neu, plus ein Button "🔄 Jetzt aktualisieren" für sofortiges Nachladen. Eine kleine Anzeige ("Stand: HH:MM Uhr") zeigt, wie aktuell der gezeigte Stand ist. Details und Hintergrund dazu unter Architektur-Prinzipien dieser Version.
• Standardmäßig sichtbar ist nur das Suchfeld plus ein Button "🔍 Filter & Sortierung" — Platz sparend, besonders wichtig, wenn die Seite schmal eingebettet ist.
• Klick auf den Button öffnet ein kompaktes Panel mit den für Besucher:innen wichtigsten Fragen: Spielerzahl, Komplexität ("Leicht", "Mittel", "Anspruchsvoll"), Status (Alle / Nur verfügbar / Nur ausgeliehen), Regal sowie einer einfachen Sortierung (Name oder Beliebtheit). Ein Bewertungs-Filter wurde bewusst weggelassen, um die Auswahl übersichtlich zu halten — die Bewertung selbst steht aber weiterhin als Spalte in der Tabelle.
• Der Button zeigt eine kleine Zahl, sobald Filter aktiv sind, auch wenn das Panel gerade eingeklappt ist. Ein "Filter zurücksetzen"-Button im Panel setzt alles auf Standard zurück.
• Die Tabelle zeigt neben Spieleranzahl, Alter, Dauer, Bewertung und Komplexität auch das Regal — beides weiterhin sichtbar, auch ohne eigenen Filter dafür.
• Pagination: Bei mehr als 50 Treffern erscheinen "← Zurück"/"Weiter →"-Pfeile sowohl oberhalb als auch unterhalb der Tabelle — praktisch bei langen Listen, damit nicht erst nach oben gescrollt werden muss. Betrifft nur die Anzeige im Browser, nicht die Lesevorgänge — Suche und Filter laufen weiterhin über die komplette geladene Liste, damit sie zuverlässig alles finden.
• Jede Zeile der Ergebnistabelle ist anklickbar und öffnet eine Detailkarte mit größerem Bild, Beschreibung, Kategorie und einem direkten Link zur BGG-Seite des Spiels.
• Bei Mehrfach-Exemplaren zeigt der Status z.B. "verfügbar (2/3)". Ist bei einem Spiel eine Verlagstisch-Stückzahl gesetzt, erscheint zusätzlich "🏢 X auf Verlagstisch" (siehe Verlagstisch). Ist Ausleihdauer anzeigen für dieses Event aktiviert, zeigt eine zusätzliche Spalte "Ausgeliehen seit" (h:mm) für gerade ausgeliehene Spiele.
• Kein Login nötig, keine Bearbeitung möglich.

Öffentliche Übersicht für Sammlungen (sammlung-uebersicht.html)

Eigenständige Seite nach demselben Prinzip wie die Event-Übersicht, aber für einzelne Spielesammlungen statt Events — z.B. um die private Sammlung eines Mitglieds oder eine Vereinssammlung als Ganzes zu präsentieren.

• Aufruf mit ?collection=SAMMLUNG_ID zeigt direkt diese eine Sammlung (Link dazu im Sammlungsfenster, siehe Öffentlicher Link zur Sammlung).
• Ohne Parameter: Dropdown zur Auswahl unter allen vorhandenen Sammlungen.
• Oben neben dem Titel ebenfalls das BGG-Logo mit Link zu boardgamegeek.com.
• Ebenfalls periodische Aktualisierung (alle 60 Sekunden) statt Live-Listener, plus "🔄 Jetzt aktualisieren"-Button und "Stand: HH:MM Uhr"-Anzeige — siehe Architektur-Prinzipien dieser Version.
• Gleiches Suchfeld, gleiches einklappbares Filter-&-Sortierungs-Panel wie bei der Event-Übersicht, ebenfalls auf das Nötigste reduziert: Spielerzahl, Komplexität, Sortierung nach Name, Beliebtheit oder Stückzahl. Kein Bewertungs-Filter mehr, kein Status-/Regal-Filter (Sammlungen kennen keine Verfügbarkeit im Ausleihsinn).
• Die Tabelle zeigt je Spiel die Stückzahl ("2×" usw.) statt eines Ausleihstatus.
• Pagination: ab mehr als 50 Treffern "← Zurück"/"Weiter →" oberhalb der Tabelle, wie bei der Event-Übersicht.
• Zeile anklicken öffnet dieselbe Detailkarte wie bei der Event-Übersicht (Bild, Beschreibung, BGG-Link).
• Kein Login nötig, keine Bearbeitung möglich.

Preisträger-Übersicht (preistraeger.html)

Eigenständige Seite mit allen Gewinnern von Spiel des Jahres, Kennerspiel des Jahres, Kinderspiel des Jahres, Sonderpreis Kinderspiel (bis 2000), Deutschem und Österreichischem Spielepreis — 164 Einträge insgesamt, Quelle ist das separate "Spiel des Jahres"-Projekt (statisch eingebettet, keine eigene Datenbank-Anbindung dafür nötig).

Gehostet unter: https://spielothek.spieleversum.at/preistraeger.html

• Aufruf mit ?event=EVENT_ID zeigt direkt dieses Event; auch über den Link "🏆 Preisträger" auf jeder Event-Karte im Verwaltungstool erreichbar.
• Ohne Parameter: Dropdown zur Event-Auswahl, wie bei den anderen öffentlichen Seiten.
• Sortierung standardmäßig nach Jahr absteigend (neuestes zuerst), umstellbar auf aufsteigend oder Titel A–Z.
• Filter: Kategorie (alle sechs Auszeichnungen einzeln wählbar) und Verfügbarkeit (Alle / Nur verfügbar / Vorhanden — egal ob ausgeliehen / Nicht in der Sammlung).
• Abgleich per Titel: Für jeden Preisträger wird geprüft, ob ein gleichnamiges (oder unter bekanntem Alternativtitel geführtes) Spiel bei diesem Event vorhanden ist — Status wird als Badge angezeigt (Verfügbar/grün, Ausgeliehen/rot, Nicht in der Sammlung/grau), plus Regal bei Treffer.
• Der Abgleich ist ein Best-Effort-Titelvergleich (normalisiert, Groß-/Kleinschreibung und Sonderzeichen ignoriert) — bei stark abweichenden Editionsnamen kann er im Einzelfall daneben liegen; stichprobenartige Kontrolle empfohlen.
• Periodische Aktualisierung (60 Sek.) + "Jetzt aktualisieren"-Button, Pagination ab 50 Treffern — dieselben Prinzipien wie bei den anderen öffentlichen Seiten.
• Kein Login nötig, keine Bearbeitung möglich.

Zugriffsrechte der API

Diese Version läuft über eine eigene PHP-API (api.php) auf einer MySQL-Datenbank statt über Firestore — der Zugriffsschutz funktioniert deshalb anders als bei der privaten/GitHub-Pages-Version: nicht über Firestore-Sicherheitsregeln, sondern direkt im PHP-Code.

Architektur-Prinzipien dieser Version

Diese Version übernimmt bewusst dieselben Grundprinzipien, die schon bei der privaten Firestore-Version aus Kostengründen eingeführt wurden — bei MySQL geht es nicht um Kosten pro Lesevorgang, sondern schlicht um Serverlast und Antwortzeit, dieselben Prinzipien bleiben aber sinnvoll:

1. Datenbank-Änderungen weitergeben, statt bei jedem Aufruf live nachzulesen

Sammlungs- und Event-Einträge (collection_items, event_games) tragen von Anfang an alle Anzeige-Daten vollständig in sich (Titel, Bild, Spieleranzahl, Alter, Dauer, Bewertung, Komplexität, Kategorie, Beschreibung) — nicht nur EAN und Menge. Bearbeitet ein Admin ein Spiel im Verwaltungstool (Titel korrigieren, BGG neu abgleichen, Beschreibung nachtragen, …), schreibt der Server (game_propagate-Endpunkt) die aktuellen Daten automatisch in alle Sammlungs- und Event-Einträge zurück, die auf diese EAN verweisen — einmalig, im Hintergrund, ohne dass Besucher:innen etwas davon merken.

Ergebnis: Die öffentlichen Seiten müssen pro Aufruf nur eine einzige, gezielte Abfrage stellen (die Sammlung bzw. das Event) — kein zusätzlicher Join oder Nachschlag pro Spiel, egal wie viele Besucher:innen gleichzeitig zuschauen.

2. Periodische Aktualisierung statt dauerhaftem Live-Listener

MySQL/PHP kennt von Haus aus keine "Live-Listener" wie Firestore — alle Seiten fragen deshalb regelmäßig per fetch() neu ab: die öffentlichen Seiten (index.html, sammlung-uebersicht.html, preistraeger.html) alle 60 Sekunden, zusätzlich über den Button "🔄 Jetzt aktualisieren" jederzeit sofort. Der Ausleihe-Tresen und das Verwaltungstool fragen für den Mehrgeräte-Betrieb deutlich schneller ab (Tresen alle 3 Sekunden, Verwaltungstool alle 5 Sekunden). Eine kleine Anzeige ("Stand: HH:MM Uhr") zeigt Besucher:innen, wie aktuell der gezeigte Stand gerade ist.

3. Abfragen begrenzen, Listen paginieren und Filter aufs Nötigste reduzieren

• Gezielt statt vollständig: Die meisten API-Endpunkte akzeptieren einen event_id- bzw. collection_id-Filter und geben ohne diesen Filter (z.B. fürs Verwaltungstool) alles zurück — die öffentlichen Seiten nutzen konsequent die gefilterte Variante.
• UI-Pagination bei großen Listen: Sowohl die öffentlichen Übersichten (50 Spiele pro Seite, Pfeile oberhalb der Tabelle) als auch die Spieledatenbank-Tabelle im Verwaltungstool zeigen nur einen Ausschnitt gleichzeitig — spart vor allem Browser-Rechenleistung; Suche und Filter laufen weiterhin über den kompletten, bereits geladenen Datenbestand, damit sie zuverlässig alles finden (siehe Datenbank durchsuchen & bearbeiten).
• Filter aufs Wesentliche reduziert: Für Besucher:innen zählen in der Praxis vor allem zwei Fragen — "Wie viele sind wir?" und "Ist es leicht genug?". Die öffentlichen Übersichten bieten deshalb bewusst nur noch Spielerzahl, Komplexität, (bei Events) Status, Regal und eine einfache Sortierung an. Für die Administration (Verwaltungstool) bleiben alle Filter erhalten, die dort für den Betrieb nötig sind.
• Bewusste Ausnahme: Das Verwaltungstool selbst lädt beim Login weiterhin die komplette Spieledatenbank und alle Sammlungseinträge unbegrenzt — das ist nötig, damit Team-Mitglieder per Volltext über die ganze Datenbank suchen können. Das ist unkritisch, weil nur angemeldete Team-Mitglieder das Tool öffnen (nicht beliebige Besucher:innen) und die Zugriffszahl klein bleibt, unabhängig vom Besucherstrom eines Events.

Glossar

Häufige Probleme