Owlibou Tavern

Ein flexibles Management-Tool für Tabletop-RPGs (TTRPG), mit dem du Kampagnen-, Welt- und Spieldaten zentral verwaltest. Im Frontend kannst du Daten aus der Datenbank komfortabel anlegen, bearbeiten, importieren und exportieren – ideal für Spielleitungen, Weltbauer:innen und Orga-Teams.

Ziele und Nutzen

• Einheitliche Verwaltung von TTRPG-Daten wie Charaktere, NSCs, Orte, Items, Quests, Regeln und Sessions.
• Datenpflege direkt im Browser mit validierten Formularen und Listenansichten.
• Revisionssichere Änderungen sowie Import/Export für Backups, Systemwechsel oder öffentliche Datenpakete.
• Erweiterbar und systemagnostisch: nutzbar für verschiedene TTRPG-Systeme und Hausregeln.

Hauptfunktionen (geplant/initial)

• Datenverwaltung
  • CRUD für zentrale Entitäten (z. B. Charaktere, Orte, Items, Quests, Sessions)
  • Tagging, Relationen und Referenzen (z. B. Item gehört zu Charakter, Quest findet in Ort statt)
  • Versionierung/Änderungshistorie (optional)
• Import/Export
  • JSON- und CSV-Importe mit Mapping/Validierung
  • JSON- und CSV-Exporte (vollständig oder gefiltert)
  • Vorlagen für gängige Datenstrukturen
• Qualität und Sicherheit
  • Validierungen, Duplikat-Erkennung, Konfliktauflösungen beim Import
  • Rollen-/Rechtekonzept für Lesende/Schreibende (optional)
• UX
  • Filter, Suche, Sortierung, Paginierung
  • Bulk-Aktionen (z. B. Massen-Tagging, Sammellöschung mit Undo)

Architekturüberblick

• Frontend
  • Web-App zur Verwaltung, Visualisierung und zum Import/Export von Daten
  • Formulare mit Validierung, Listenansichten, Detailseiten
• API/Backend
  • Endpunkte für CRUD, Batch-Operationen, Import/Export und Authentifizierung
  • Datenvalidierung serverseitig und konfliktarme Merges bei Importen
• Datenbank
  • Relational oder dokumentenorientiert, je nach finalem Design
  • Migrationskonzept, Seeds und Beispiel-Datasets
• Authentifizierung/Autorisierung (optional)
  • Nutzerkonten, Rollen, API-Tokens

Hinweis: Die konkrete Technologieauswahl kann projektabhängig variieren. Dieses README bleibt bewusst technologie-agnostisch.

Datenmodell (Beispiel-Ideen)

• Kern-Entitäten: Character, NPC, Location, Item, Quest, Session, Faction, Rule
• Relationen: Character—Item (1:n), Location—Quest (n:m), Session—Participant (n:m)
• Metadaten: Tags, Notizen, Quellenangaben, Zeitstempel, Besitzer:in

Import/Export

• Formate
  • JSON: vollständige Strukturen inkl. Relationen
  • CSV: tabellarische Views je Entität
• Import-Workflow
  • Vorschau mit Validierungsfehlern und Warnungen
  • Mapping-Assistent (z. B. Spaltenzuordnung bei CSV)
  • Konflikt-Strategien: Überschreiben, Zusammenführen, Duplikate überspringen
• Export-Workflow
  • Auswahl von Entitäten/Filtern, optional Anonymisierung bestimmter Felder
  • Versionierte Exporte als Backup

Entwicklungs-Setup

• Voraussetzungen
  • Git, eine aktuelle Laufzeitumgebung für Frontend/Backend, Paketmanager, Datenbank-Server
• Quickstart (generisch)
  1. Repository klonen
  2. Umgebungsvariablen konfigurieren (z. B. DB-URL, Ports, Auth-Secret)
  3. Abhängigkeiten installieren
  4. Datenbank migrieren und Seed-Daten einspielen (optional)
  5. Entwicklungsserver starten (Frontend und Backend)
• Skripte (Platzhalter)
  • start-dev: Startet Frontend und Backend im Watch-Modus
  • migrate: Führt Datenbankmigrationen aus
  • seed: Spielt Beispiel-/Demo-Daten ein
  • test: Führt Tests aus
  • build: Erzeugt produktionsfertige Artefakte

Füge konkrete Befehle hinzu, sobald die Technologie-Stacks final sind.

Deployment (Beispielfluss)

• Konfiguration über Umgebungsvariablen/Secrets
• Datenbank bereitstellen und Migrationen ausführen
• Backend deployen
• Frontend als statische App oder über denselben Server ausliefern
• Optional: Containerisierung und Orchestrierung

Qualitätssicherung

• Tests: Unit-, Integrations- und E2E-Tests für Import/Export und CRUD
• Linting/Formatting und CI-Pipelines
• Backups: regelmäßige Exporte und DB-Snapshots

Roadmap (Entwurf)

• M0: Basis-CRUD für zentrale Entitäten, einfache JSON-Exporte
• M1: CSV-Importe mit Mapping + Validierung, Filter/Suche im UI
• M2: Relationen-Management im UI, Konfliktauflösung beim Import
• M3: Rollen/Rechte, Änderungsverlauf, Bulk-Aktionen
• M4: Plugins/Erweiterungen für system-spezifische Felder und Regelwerke

Beitragen

• Issues eröffnen: Bugreports, Featurewünsche, Fragen
• Pull Requests: Bitte mit kurzer Beschreibung, Repro-Schritten und Tests
• Coding Guidelines: Einheitlicher Stil, aussagekräftige Commits

Lizenz

• AGPLv3

Kontakt

• Projektpflege: bitte Kontaktmethode/Team hinzufügen
• Diskussionen/Ideen: Issue-Tracker oder Diskussionsforum verwenden

Viel Spaß beim Bauen deiner TTRPG-Welt mit Owlibou Tavern!