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

@ -0,0 +1,166 @@
<?php
/*
* Schnittstelle fuer das Programm.
*
* Alle Aufrufe: POST /api/ mit JSON {"aktion": "...", ...}. Angemeldete
* Aufrufe schicken das Sitzungstoken im Kopf X-SM-Token - nicht in
* Authorization, das Plesk-Konfigurationen gern verschlucken. Antwort immer
* JSON: {"ok": true, ...} oder {"ok": false, "fehler": "code", "meldung": "Text"}.
*/
declare(strict_types=1);
final class Api
{
private const OHNE_ANMELDUNG = ['status', 'registrieren', 'anmelden', 'bestaetigung_erneut', 'passwort_vergessen'];
private const MAX_ANFRAGE_BYTES = 12 * 1024 * 1024;
private static function senden(array $daten, int $http = 200): never
{
http_response_code($http);
header('Content-Type: application/json; charset=utf-8');
header('Cache-Control: no-store');
header('X-Content-Type-Options: nosniff');
echo json_encode($daten, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
exit;
}
private static function text(array $anfrage, string $feld, int $max = 1000): string
{
$wert = $anfrage[$feld] ?? '';
if (!is_string($wert) && !is_int($wert)) {
throw new SmFehler('feld_ungueltig', "Feld $feld ist ungültig.");
}
return mb_substr((string) $wert, 0, $max);
}
private static function zahl(array $anfrage, string $feld): int
{
$wert = $anfrage[$feld] ?? null;
if (!is_int($wert) && !(is_string($wert) && ctype_digit($wert))) {
throw new SmFehler('feld_ungueltig', "Feld $feld fehlt oder ist keine Zahl.");
}
return (int) $wert;
}
public static function behandeln(): never
{
try {
if (($_SERVER['REQUEST_METHOD'] ?? '') !== 'POST') {
throw new SmFehler('methode', 'Nur POST.', 405);
}
$roh = file_get_contents('php://input', false, null, 0, self::MAX_ANFRAGE_BYTES + 1);
if ($roh === false || strlen($roh) > self::MAX_ANFRAGE_BYTES) {
throw new SmFehler('anfrage_zu_gross', 'Die Anfrage ist zu groß.', 413);
}
$anfrage = json_decode($roh, true);
if (!is_array($anfrage) || !is_string($anfrage['aktion'] ?? null)) {
throw new SmFehler('anfrage_ungueltig', 'Ungültige Anfrage.');
}
$aktion = $anfrage['aktion'];
$nutzer = null;
if (!in_array($aktion, self::OHNE_ANMELDUNG, true)) {
$nutzer = Sicherheit::sitzung((string) ($_SERVER['HTTP_X_SM_TOKEN'] ?? ''));
if ($nutzer === null) {
throw new SmFehler('nicht_angemeldet', 'Bitte melde dich an.', 401);
}
}
self::senden(['ok' => true] + self::ausfuehren($aktion, $anfrage, $nutzer));
} catch (SmFehler $fehler) {
self::senden(['ok' => false, 'fehler' => $fehler->fehlercode, 'meldung' => $fehler->getMessage()]
+ $fehler->extra, $fehler->http);
} catch (Throwable $fehler) {
sm_log('API: ' . $fehler::class . ': ' . $fehler->getMessage() . ' in '
. $fehler->getFile() . ':' . $fehler->getLine());
self::senden(['ok' => false, 'fehler' => 'serverfehler',
'meldung' => 'Auf dem Server ist ein Fehler aufgetreten.'], 500);
}
}
private static function ausfuehren(string $aktion, array $a, ?array $nutzer): array
{
switch ($aktion) {
case 'status':
return ['api' => SM_API_VERSION, 'zeit' => DB::jetzt()];
// -- Konto ------------------------------------------------------
case 'registrieren':
Konten::registrieren(self::text($a, 'benutzername', 64), self::text($a, 'email', 250),
self::text($a, 'passwort', 500));
return ['meldung' => 'Konto angelegt. Wir haben dir eine Mail zur Bestätigung geschickt.'];
case 'bestaetigung_erneut':
Konten::bestaetigungErneut(self::text($a, 'email', 250));
return ['meldung' => 'Falls ein unbestätigtes Konto zu dieser Adresse gehört, ist die Mail unterwegs.'];
case 'anmelden':
return Konten::anmelden(self::text($a, 'login', 250), self::text($a, 'passwort', 500),
self::text($a, 'geraet', 100));
case 'passwort_vergessen':
Konten::passwortVergessen(self::text($a, 'email', 250));
return ['meldung' => 'Falls ein Konto zu dieser Adresse gehört, ist die Mail unterwegs.'];
case 'abmelden':
Konten::abmelden($nutzer);
return [];
case 'ich':
return ['nutzer' => Konten::oeffentlich($nutzer)];
case 'konto_loeschen':
Konten::kontoLoeschen($nutzer, self::text($a, 'passwort', 500));
return [];
// -- Eigene Charaktere -------------------------------------------
case 'charaktere_eigene':
return ['charaktere' => Charaktere::eigene($nutzer)];
case 'charakter_speichern':
$basis = $a['basis_version'] ?? null;
return ['charakter' => Charaktere::speichern($nutzer, self::text($a, 'lokale_id', 64),
$a['daten'] ?? null, is_int($basis) ? $basis : null, ($a['erzwingen'] ?? false) === true)];
case 'charakter_loeschen':
Charaktere::loeschen($nutzer, self::text($a, 'lokale_id', 64));
return [];
case 'portraet_hochladen':
return ['charakter' => Charaktere::portraetSetzen($nutzer, self::text($a, 'lokale_id', 64),
self::text($a, 'bild', self::MAX_ANFRAGE_BYTES))];
case 'portraet_entfernen':
return ['charakter' => Charaktere::portraetEntfernen($nutzer, self::text($a, 'lokale_id', 64))];
// -- Alle Charaktere ---------------------------------------------
case 'charaktere_alle':
return ['charaktere' => Charaktere::alle($nutzer, self::text($a, 'suche', 64),
self::text($a, 'fraktion', 80))];
case 'charakter_ansehen':
return ['charakter' => Charaktere::ansehen($nutzer, self::zahl($a, 'id'))];
// -- Squads -------------------------------------------------------
case 'squads':
return ['squads' => Squads::liste($nutzer)];
case 'squad_ansehen':
return ['squad' => Squads::details($nutzer, self::zahl($a, 'squad_id'))];
case 'squad_gruenden':
return ['squad' => Squads::gruenden($nutzer, self::zahl($a, 'charakter_id'),
self::text($a, 'name', 100), self::text($a, 'beschreibung', 2000))];
case 'squad_einladen':
return ['einladung' => Squads::einladen($nutzer, self::zahl($a, 'squad_id'),
self::zahl($a, 'charakter_id'))];
case 'einladungen':
return Squads::einladungen($nutzer);
case 'einladung_beantworten':
Squads::beantworten($nutzer, self::zahl($a, 'einladung_id'), ($a['annehmen'] ?? false) === true);
return [];
case 'einladung_zurueckziehen':
Squads::zurueckziehen($nutzer, self::zahl($a, 'einladung_id'));
return [];
case 'squad_verlassen':
Squads::verlassen($nutzer, self::zahl($a, 'charakter_id'));
return [];
case 'squad_entfernen':
Squads::entfernen($nutzer, self::zahl($a, 'squad_id'), self::zahl($a, 'charakter_id'));
return [];
case 'squad_fuehrung_uebergeben':
Squads::fuehrungUebergeben($nutzer, self::zahl($a, 'squad_id'), self::zahl($a, 'charakter_id'));
return [];
case 'squad_aufloesen':
Squads::aufloesen($nutzer, self::zahl($a, 'squad_id'));
return [];
}
throw new SmFehler('aktion_unbekannt', 'Unbekannte Aktion.', 404);
}
}