Charakterverwalter (westreiche_website) ergänzen, Website-Nav "Charaktere"
This commit is contained in:
parent
d107f90c93
commit
01dae01c7c
84 changed files with 8915 additions and 17 deletions
74
AGENTS.md
74
AGENTS.md
|
|
@ -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:
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue