# Westreiche – Charakterverwalter Geschlossene Web-App für die Westreiche-Runde: Charakterbögen für OSE-alike Charaktere pflegen, Zauber und Liturgien aus dem Vault zuordnen, Inventar führen und den Bogen als PDF mitnehmen. Technische Basis wie beim Schwester-Repo `drink-it-cold`: PHP 8.1+, MariaDB, server-gerendertes HTML, kein Composer, keine Build-Tools. Theme analog `zauberturm.de` (Nachtblau/Schwarz/Gold, Pergament, Glutfunken, Cinzel/EB Garamond) mit Animationen. ## Funktionsumfang - **Geschlossene Benutzergruppe**: Der Spielleiter legt Konten an oder erzeugt eine **Einladung** (Link, 7 Tage gültig, einmal verwendbar) – der Eingeladene setzt sein Passwort selbst. Anmeldung mit **Benutzername oder E-Mail**. - **Rollen**: `admin` (Spielleiter, sieht und bearbeitet alle Bögen, verwaltet Konten und Kataloge) und `user` (eigene Bögen). - **Charaktere**: Name, Beiname, Klasse (12 Westreiche-Klassen), Stufe, EP, TP, Rüstungsklasse (aufsteigend), Angriff, Gold, die sechs Attribute mit automatischem Attributsbonus nach Hausregel V1.1, Rettungswürfe, Gottheit, Alter/Größe/Gewicht, Erscheinung, Hintergrund, Notizen, Status (im Spiel / gefallen / Ruhestand). - **Rettungswürfe**: kommen aus der Klassentabelle (`WS_SAVE_TABLES` in `app/rules.php`, OSE-SRD-Grundwerte) und werden bei Änderung von Klasse oder Stufe automatisch nachgezogen; einzelne Werte bleiben überschreibbar. - **Bewaffnung & Rüstung**: Waffe oder Rüstungsteil zunächst aus dem Katalog wählen (`weapons`/`armors`), danach ist jeder Eintrag frei änderbar (Name, Schadenswürfel, Trefferbonus, RK-Bonus, Notiz, geführt/angelegt). Daraus abgeleitet: **Trefferwurf** = Grundangriff + Attributsbonus (Nahkampf Stärke, Fernkampf Geschick) + Waffenbonus, **Schaden** = Würfel + Attributsbonus, **Rüstungsklasse** = 10 + Geschick + angelegte Rüstung (ein Eintrag im Feld „Rüstungsklasse“ überschreibt die Automatik). - **Fertigkeiten**: Katalog (`skills`) genau wie auf dem Charakterbogen (`RPG/6-Dokumente/Charakterbogen.pdf`) in den Gruppen **Körper, Wildnis, Sozial, Wissen** – Quelle ist `WS_SKILL_CATALOG` in `app/rules.php` (33 Fertigkeiten, Attribut + Gruppe). Anzeige und PDF führen je Gruppe eine Tabelle mit Fertigkeit · Attribut · **MOD** (Attributsbonus) · **Stufe** (Bonus) · Notiz. Freie Zusatzfertigkeiten sind weiterhin möglich. Beim Anlegen bekommt **jede** Katalogfertigkeit ihren Startwert (Fertigkeitsstufe = Attributsbonus des zugeordneten Attributs) und erscheint in der Gruppe seines Charakterbogens. Attributsänderungen ziehen diese Startwerte mit, solange sie nicht manuell gesteigert wurden; „Startwerte auffrischen“ erledigt das auf Wunsch auch für alle Werte. - **Zauber und Liturgien**: Katalog mit 147 arkanen Zaubern und 74 Liturgien aus `RPG/5-Regeln/Zauber/…` (Schule, Grad, Klasse, Dauer, Reichweite, Kurztext) und Zuordnung pro Charakter (keine Vorbereitungspflicht – die Hausregel kennt kein Vorbereiten von Zaubern). - **Inventar**: Gegenstände mit Anzahl, Art, Gewicht, Wert, Notiz und „angelegt“-Status. - **Porträt**: Upload per Formular (JPEG/PNG/WebP, max. 5 MB) – serverseitig über GD neu als JPEG kodiert (Metadaten weg, max. 900 px), gespeichert in `uploads/portraits/`. Ohne eigenes Bild greift ein gemaltes **Platzhalterporträt der Klasse** aus `assets/portraits/*.webp` (12 Klassen, per fal.ai erzeugt). Das Porträt steht auch auf dem PDF-Bogen. - **PDF-Export**: eigener kleiner PDF-Writer (kein Composer, kein GD) rendert ein A4-Pergamentblatt mit Goldrahmen, Attributkästen, Kampfblock, Rettungswürfen, Fertigkeiten, Zaubern nach Grad, Inventar und Notizen – bei Bedarf über mehrere Seiten. ## Installation ```bash # 1. Deployment (erzeugt app/config.local.php aus credentials.txt) ./tools/deploy_app.sh # oder --dry-run # 2. Im Browser öffnen https://zauberturm.de/westreiche_website/install.php?token= ``` Der Installer legt Tabellen, Zauber-/Fertigkeitengrundlage und das erste Admin-Konto an. Danach kann `install.php` stehen bleiben – bei vorhandenen Konten zeigt es nur noch einen Hinweis. ### Einladungen per E-Mail (SMTP) `app/mailer.php` ist ein eigener kleiner SMTP-Client (kein Composer): STARTTLS auf 587 oder SSL auf 465, AUTH PLAIN/LOGIN, Textmails UTF-8-kodiert. Die Werte kommen aus `credentials.txt` (`MAIL_HOST`, `MAIL_PORT`, `MAIL_SECURE`, `MAIL_USER`, `MAIL_PASSWORD`, `MAIL_FROM`, `MAIL_FROM_NAME`) und landen beim Deployment im Abschnitt `'mail'` von `app/config.local.php`. - Fehlt `MAIL_*` (oder `MAIL_PASSWORD`), gilt der Versand als nicht eingerichtet: Einladungslinks werden wie bisher nur angezeigt. - `MAIL_HOST` muss ein Name sein, der im Server-Zertifikat steht – bei Hetzner also `www19.your-server.de`; `mail.zauberturm.de` zeigt zwar auf denselben Server, passt aber nicht zum Zertifikat (`*.your-server.de`). - Fehler landen per `error_log` in `storage/logs/php.log`; die Admin-Maske meldet dann „Versand fehlgeschlagen – Link bitte kopieren“. ## Lokal entwickeln ```bash cp app/config.example.php app/config.local.php # DB-Zugang eintragen php -S 127.0.0.1:8099 -t . tools/router.php # http://127.0.0.1:8099/install.php?token= ``` ## Datenmodell | Tabelle | Zweck | |---|---| | `users` | Konten (Benutzername/E-Mail, Rolle, Status, `auth_epoch`) | | `user_invites` | Einladungstokens (nur SHA-256-Hash) | | `auth_tokens` | „Angemeldet bleiben“ (Selector/Validator) | | `login_attempts` | Ratenbegrenzung je IP und Konto | | `characters` | Charakterbogen-Basisdaten | | `skills`, `character_skills` | Fertigkeiten-Katalog und Zuordnung | | `spells`, `character_spells` | Zauber/Liturgien-Katalog und Zuordnung | | `character_items` | Inventar | | `weapons`, `armors` | Waffen- und Rüstungskatalog (Seed: `sql/seed_equipment.sql`) | | `character_weapons`, `character_armors` | geführte Waffen und Rüstungsteile | Porträts liegen als Datei in `uploads/portraits/` (gitignored); die Spalte `characters.portrait` hält nur den relativen Pfad. Sprache und Zeit: Zeitstempel in UTC, Anzeige in Europe/Berlin. ## Kataloge pflegen Der Zauberkatalog wird aus dem Vault erzeugt: ```bash python3 ../tools/build_spell_seed.py # schreibt sql/seed_spells.sql ``` Nach neuen Zauberdateien im Vault also den Seed neu bauen und die Datei hochladen; der Installer führt sie bei einer Neuinstallation aus. Der Seed schreibt mit `INSERT … ON DUPLICATE KEY UPDATE`, aktualisiert also bestehende Zeilen (Kurztext, Dauer, Reichweite, Klassen und den vollständigen Regeltext `body` aus „Wirkung“ + „Regelhinweisen“). Nach einem Vault-Update also einfach `seed_spells.sql` hochladen und einmal einspielen – z. B. ```bash .venv/bin/python tools/build_spell_seed.py # im Repo-Wurzelverzeichnis ``` Schema-Erweiterungen für **bestehende** Installationen stehen in `app/migrations.php` (`WS_MIGRATIONS`); sie laufen beim ersten `db()`-Aufruf automatisch und werden in `schema_migrations` vermerkt. Neue Änderung immer hinten mit neuer Versionsnummer anhängen. Fertigkeiten pflegt der Spielleiter direkt unter *Leitung → Fertigkeiten*. ## Sicherheit - Passwörter mit Argon2id (Fallback bcrypt), Rehash beim Login. - CSRF-Token in jedem Formular, Sessions mit `use_strict_mode` und SameSite=Lax, Session-Epoch-Erhöhung bei Passwortwechsel. - `app/`, `views/`, `sql/` und `storage/` per `.htaccess` gesperrt; in `uploads/` ist die PHP-Ausführung abgeschaltet (nur Bilder werden ausgeliefert); `config.local.php` liegt nur auf dem Server (in `.gitignore`). - CSP ohne externe Quellen, `X-Robots-Tag: noindex` (geschlossene Runde).