Server fuer Konten, Akten und Squads

PHP 8 ohne Framework unter server/: oeffentliche Einstiege fuer
sva.tyrveil.com (Schnittstelle, Konto-Links, Verwaltung, Einrichtung) und
die Logik in sva-privat neben dem Dokumentenstamm.

- Konten mit E-Mail-Bestaetigung, Anmeldung per Token, Passwort
  vergessen, Konto loeschen
- Akten auf dem Server mit serververgebener Aktennummer und
  Versionspruefung; Portraets werden neu als PNG gespeichert
- Squads mit Einladungen, Fuehrung uebergeben, Aufloesen
- Verwaltung fuer info@tyrveil.com: Nutzer, Charaktere, Squads
- Bremsen gegen Durchprobieren, Token nur als Hash, CSRF-Schutz

werkzeuge/server_test.py prueft alles lokal mit SQLite (91 Faelle).
Der Release-Bau legt dist/server und dist/sva-privat an, ohne config.php.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-09-13 17:50:33 +02:00
parent 58a3573fd6
commit 6e4d4afc1d
23 changed files with 2872 additions and 1 deletions

View file

@ -51,6 +51,7 @@ akte_modell.py Akte: Datenmodell und Speicherung, ohne tkinter
akte_vorlagen.py Akte: Fraktionen, Dienstgrade, Verwendungen
akte_karte.py Akte: PNG-Karte zum Teilen, Zwischenablage
update_helfer.py spielt Updates ein, bei Bedarf mit Adminrechten
server/ PHP-Server für Konten und Squads, siehe Abschnitt 4
start.pyw Startskript ohne Konsolenfenster
make_icon.py erzeugt icon.ico aus icon.png
icon.png / icon.ico Programmsymbol (vom Nutzer geliefert)
@ -281,6 +282,56 @@ auf.
---
### Server für Konten und Squads (ab 1.6.0)
PHP 8 ohne Framework in `server/`, getrennt nach Sichtbarkeit:
```
server/sva.tyrveil.com/ → /sva.tyrveil.com (Dokumentenstamm, öffentlich)
api/index.php Schnittstelle fürs Programm (POST, JSON)
api/bild.php Porträts, nur mit Token
konto/ Links aus Mails: bestätigen, Passwort, vergessen
verwaltung/ Admin-Oberfläche
einrichten.php Ersteinrichtung, nur mit Schlüssel aus config.php
server/sva-privat/ → /sva-privat, NEBEN dem Dokumentenstamm
app/ gesamte Logik
config.beispiel.php Vorlage; config.php liegt nur auf dem Server
daten/ Porträts, Fehlerlog (nicht im Repository)
```
Plesk: PHP 8.5, Dokumentenstamm `/sva.tyrveil.com`, Datenbank und Benutzer
`214729_sva` (MySQL/MariaDB). Das Datenbank-Passwort steht nur in
`sva-privat/config.php` auf dem Server — nie ins Repository, nie in den
Chat. Mails verschickt `mail()` über den Plesk-Mailserver mit Absender
`info@tyrveil.com`, ohne Postfach-Passwort. Verwaltungszugang:
`info@tyrveil.com`, Passwort über den Link aus `einrichten.php`.
**Schnittstelle:** `POST /api/` mit `{"aktion": …}`, Token im Kopf
`X-SM-Token` (nicht `Authorization`, das verschlucken Plesk-Setups gern).
Antwort `{"ok": true, …}` oder `{"ok": false, "fehler": code, "meldung":
Text}`. Die Aktionen stehen gesammelt in `app/api.php`.
**Regeln, die der Server durchsetzt:** Aktennummern vergibt der Server
(`SM-<Jahr>-<id>`), weil lokale Nummern bei allen Spielern mit 0001
beginnen. Speichern mit `basis_version`: Weicht sie ab, kommt `konflikt`
(409) mit dem Serverstand zurück. Ein Charakter ist in höchstens einem
Squad; Einladungen muss der Besitzer annehmen; nimmt er an, verfallen seine
anderen offenen Einladungen. Der Führer kann nur gehen, wenn er allein ist
oder die Führung übergeben hat; wird er gelöscht, übernimmt das
dienstälteste Mitglied. Porträts werden mit GD neu als PNG (≤ 512 px)
gespeichert, das Original verworfen. Token liegen nur als SHA-256 in der
Datenbank. Bremsen: Anmelden 10 je 15 min pro IP und Name, Registrieren 5
je Stunde pro IP, Verwaltung 8 je 15 min.
**Testen:** `werkzeuge/server_test.py` kopiert `server/` in einen
Testordner, nutzt SQLite und Mails als Dateien und spielt über 90 Fälle
durch — Einrichtung, Konten, Akten, Porträts, Squads, Verwaltung, Sperren,
Bremsen. Braucht `php` im Suchpfad (auf dem Entwicklungsrechner PHP 8.4 aus
winget). MySQL selbst ist lokal nicht testbar; `DB::sperre()` und
`DB::schemaAnlegen()` enthalten die Unterschiede.
---
## 5. Hart erkaufte Erkenntnisse
Diese Punkte wurden durch Fehlschläge gefunden. Wer sie „aufräumt", baut