Charakterverwalter (westreiche_website) ergänzen, Website-Nav "Charaktere"

This commit is contained in:
torsten 2026-11-21 04:02:29 +01:00
parent d107f90c93
commit 01dae01c7c
84 changed files with 8915 additions and 17 deletions

View file

@ -13,6 +13,19 @@ Zugangsdaten stehen in `credentials.txt` im Projektwurzelverzeichnis (per
- **Host:** `FTP_URL` aus `credentials.txt` (z. B. `www19.your-server.de`),
Login `FTP_USER`, Passwort `FTP_PASSWORD`.
### Weitere Schlüssel in `credentials.txt`
- **`APP_DIRECTORY`** (`westreiche_website`) – **ausschließlich** für die
geplante Web-App. Alle bestehenden Veröffentlichungen bleiben, wo sie sind:
Website/Protokolle/Regel-Changelog weiter nach `public_html/`, PDF-Handouts
(Spiel-Zusammenfassungen, Zauber-/Liturgie-Summarien, SL-Material) bleiben
lokal in `RPG/7-Prep/…` bzw. am bisherigen Ablageort. Nichts davon in
`APP_DIRECTORY` verschieben oder umleiten.
- **`DB_HOST`** (`mxzh.your-database.de`, Hetzner Managed MariaDB) + `DB_NAME`,
`DB_USER`, `DB_PASSWORD` – erreichbar über Port 3306 von außen, DB derzeit
ohne Tabellen. **Achtung:** In der Datei steht ein nachgestelltes Leerzeichen,
vor Nutzung trimmen (`tr -d '[:space:]'`). Nicht `FTP_URL` als DB-Host nutzen.
### Upload-Befehl
```bash
@ -39,6 +52,67 @@ lädt den Inhalt von `dir/` in das Zielverzeichnis.
`public_html`, `westreiche`, `www_logs`, `tippspiel_backup`, `vmail`,
`.phpversion`, `.tmp`.
## Web-App: Charakterverwalter (`westreiche_website/`)
Geschlossene PHP/MariaDB-App für Charakterbögen (OSE-alike), technische Basis
wie `../drink-it-cold` (kein Composer, server-gerendertes HTML). Theme analog
zauberturm.de: Nachtblau/Schwarz/Gold, Pergament, Animationen.
- **Ort:** `westreiche_website/` im Repo = `public_html/westreiche_website/`
auf dem Server (App-Wurzel, `base_path = /westreiche_website`).
- **Deploy:**
```bash
cd westreiche_website && ./tools/deploy_app.sh --dry-run # Vorschau
./tools/deploy_app.sh # hochladen
```
Das Skript liest `credentials.txt` und erzeugt `app/config.local.php`
(gitignored) mit `DB_HOST/DB_NAME/DB_USER/DB_PASSWORD`, `APP_DIRECTORY`
(als `base_path`) und `INSTALL_TOKEN`. `app/`, `views/`, `sql/`, `storage/`
sind per `.htaccess` gesperrt.
- **Installation / erster Admin:** `…/install.php?token=$INSTALL_TOKEN`
(legt Tabellen, Kataloge und das erste Admin-Konto an). Eingerichtet:
Benutzer `Torsten` mit Rolle `admin`. Danach zeigt `install.php` nur noch
einen Hinweis.
- **Login** mit Benutzername **oder** E-Mail; Konten nur durch den Admin,
entweder mit Startpasswort oder per Einladungslink (7 Tage, einmalig).
- **Datenmodell:** `users`, `user_invites`, `auth_tokens`, `login_attempts`,
`characters`, `skills` + `character_skills`, `spells` + `character_spells`,
`character_items`, `weapons`/`armors` (Katalog) + `character_weapons`/
`character_armors`. Attributsboni nach Hausregel V1.1.
- **Fertigkeitengruppen:** `WS_SKILL_CATALOG` in `app/rules.php` bildet den
Charakterbogen (`RPG/6-Dokumente/Charakterbogen.pdf`) 1:1 ab: 33 Fertigkeiten
in den Gruppen **Körper, Wildnis, Sozial, Wissen** (Reihenfolge =
`WS_SKILL_GROUPS`). `skills_sync_catalog()` gleicht die DB an diese Liste an –
nach Änderungen dort einmal aufrufen (Installer tut es automatisch), alte
Einträge landen unter „Sonstiges“.
- **Startwerte:** neue Bögen bekommen alle Katalogfertigkeiten mit
Fertigkeitsstufe = Attributsbonus; Rettungswürfe stammen aus
`WS_SAVE_TABLES` (`app/rules.php`, OSE-SRD-Werte, Westreiche-Klassen auf die
Grundklassen abgebildet) und werden bei Stufen-/Klassenwechsel neu gesetzt.
**Falls der SL eigene RW-Tabellen führt: dort in `app/rules.php` ändern**,
nicht in der DB.
- **Ableitungen im Bogen:** Trefferwurf = Grundangriff + Attributsbonus
(Nahkampf STR, Fernkampf DEX) + Waffenbonus; Schaden = Würfel + Bonus;
RK = 10 + DEX-Bonus + angelegte Rüstung (Feld `characters.ac` = manueller
Override, leer/0 = automatisch). Waffen-/Rüstungskatalog:
`sql/seed_equipment.sql`, Admin-Ansicht `/admin/equipment`.
- **Zauberkatalog** wird aus dem Vault erzeugt:
`python3 tools/build_spell_seed.py` → `westreiche_website/sql/seed_spells.sql`
(147 arkane Zauber, 74 Liturgien). Nach neuen Zauberdateien erneut bauen,
hochladen und in einer frischen Installation einspielen.
- **PDF-Export:** eigener kleiner PDF-Writer (`app/pdf.php` + `app/sheet.php`),
A4-Pergamentbogen mit Goldrahmen – kein Composer, keine externen Dienste.
JPEG-Bilder werden als XObject eingebettet.
- **Porträts:** Upload im Bogen (`POST /characters/{id}/portrait`), serverseitig
per GD neu als JPEG kodiert (max. 900 px) nach `uploads/portraits/`
(gitignored, PHP-Ausführung dort gesperrt). Ohne Upload greift
`assets/portraits/<klasse>.webp` – 12 gemalte Platzhalter, mit fal.ai
(`flux/schnell`) erzeugt; Skript-Idee: Prompts im Chat dokumentiert.
- **Website-Nav:** `tools/build_site.py` hat `APP_CHARACTERS_URL`
(`https://zauberturm.de/westreiche_website/`) – Nav-Punkt „Charaktere“ auf
allen Seiten plus Karte auf der Startseite. Nach Änderungen dort
`build_site.py` + `deploy_web.sh` laufen lassen.
## Website (zauberturm.de)
Statischer Auftritt, aus dem Vault generiert: