squad-manager/installer/HOCHLADEN.txt
danny 4d9e30bc90 1.6.0: Squad-Reiter, Anmeldung und Abgleich im Programm
- Neuer Hauptreiter SQUAD: Anmeldung und Registrierung; angemeldet alle
  Charaktere mit Zustand (KIA/MIA/WIA), Suche und Fraktionsfilter,
  fremde Akten als Dokument, Squads gruenden und verwalten, Einladungen
  annehmen, ablehnen, zurueckziehen; Konto abmelden oder loeschen
- Akten werden nach dem Anmelden, kurz nach jeder Aenderung und alle
  5 Minuten mit dem Server abgeglichen; Zustand unter der Aktenliste
- Dokumentansicht als dokument_zeichnen() fuer eigene und fremde Akten;
  ohne Portraet scheint "KEIN PORTRAET" nicht mehr durch den Stempel
- Release-Bau: Bezeichner wie "konto_loeschen" bekommen keine Umlaute
  mehr - sonst waeren vier Serveraktionen im Paket kaputt gewesen
- Tests koennen mit SM_PROGRAMM gegen das gebaute Paket laufen
- Datenschutz-Baustein fuer tyrveil.com, Anleitung und Doku auf 1.6.0

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-13 20:09:31 +02:00

163 lines
5.9 KiB
Text

================================================================
Was auf sva.tyrveil.com muss - Version __VERSION__
================================================================
Lade den Inhalt dieses Ordners in das Wurzelverzeichnis der Subdomain,
außer dieser Anleitung selbst:
SquadManager-__VERSION__.zip
SquadManager-Setup-__VERSION__.exe
icon.png
index.html die Downloadseite
version.json als Letztes
Ändert sich auch der Server (dann liegt dist\sva-privat bei), zuerst im
Ordner sva-privat den Unterordner app durch dist\sva-privat\app ersetzen.
config.php und daten dabei nicht anfassen.
Die Reihenfolge ist wichtig: version.json zuletzt. Solange sie noch auf
die alte Version zeigt, bekommt niemand einen Link auf eine Datei, die
noch gar nicht oben liegt.
Danach müssen diese Adressen erreichbar sein:
https://sva.tyrveil.com/
https://sva.tyrveil.com/version.json
https://sva.tyrveil.com/SquadManager-__VERSION__.zip
https://sva.tyrveil.com/SquadManager-Setup-__VERSION__.exe
ALTE DATEIEN ENTFERNEN
----------------------
Nach dem Hochladen die Zip- und Setup-Dateien früherer Fassungen vom
Server löschen, also alle SquadManager-*.zip und SquadManager-Setup-*.exe
mit einer anderen Nummer als __VERSION__, und falls noch vorhanden:
SquadVoiceActivation-3.2.zip
SquadVoiceActivation-Setup-3.2.exe
Solange sie online liegen, kann jemand mit einer alten Fassung anfangen.
KONTEN UND SQUADS: EINMALIG EINRICHTEN
--------------------------------------
Seit 1.6.0 gibt es Konten, Akten auf dem Server und Squads. Dafür liegt
neben diesem Ordner zusätzlich dist\sva-privat. Einmalig:
1. Den Ordner sva-privat in das Hauptverzeichnis des Webspace laden,
NEBEN den Ordner sva.tyrveil.com - nicht hinein. Im Plesk-Dateimanager
ist das die Ebene, auf der auch sva.tyrveil.com und httpdocs liegen.
Dort ist er aus dem Internet nicht erreichbar.
2. In sva-privat die Datei config.beispiel.php kopieren und die Kopie
config.php nennen. Darin eintragen:
'passwort' das Datenbank-Passwort aus Plesk
'einrichtungs_schluessel' eine lange Zufallszeichenkette,
mindestens 24 Zeichen
3. Den Inhalt von dist\server wie oben nach sva.tyrveil.com laden. Neu
dabei sind die Ordner api, konto, verwaltung und einrichten.php.
4. https://sva.tyrveil.com/einrichten.php öffnen und den Schlüssel
eingeben. Die Seite prüft PHP, legt die Tabellen an und schickt an
info@tyrveil.com einen Link, mit dem du das Passwort für die
Verwaltung festlegst.
5. In config.php den einrichtungs_schluessel wieder leeren: ''
Damit ist einrichten.php abgeschaltet.
6. Die Verwaltung liegt unter https://sva.tyrveil.com/verwaltung/
Zeigt einrichten.php "config.php fehlt", obwohl sie oben liegt: In Plesk
unter PHP-Einstellungen muss open_basedir das Hauptverzeichnis des
Webspace erlauben. Die Voreinstellung {WEBSPACEROOT}{/}{:}{TMP}{/} tut das.
Bei späteren Updates nur sva-privat\app ersetzen. config.php und den
Ordner daten (Porträts) nie überschreiben oder löschen.
ZUM VERTEILEN
-------------
Deinen Freunden gibst du nur noch diesen Link. Er ändert sich nie:
https://sva.tyrveil.com
Die Seite liest beim Öffnen version.json und bietet immer den neuesten
Installer an. Sie erklärt auch die Windows-Warnung beim ersten Start
("Der Computer wurde durch Windows geschützt" -> Weitere Informationen
-> Trotzdem ausführen).
NGINX
-----
Meist genügt die vorhandene Konfiguration. Hilfreich im server-Block:
location ~* \.(zip|exe)$ {
add_header Content-Disposition "attachment";
}
location = /version.json {
add_header Cache-Control "no-cache";
default_type application/json;
}
location = /index.html {
add_header Cache-Control "no-cache";
}
Die Zeile zu version.json ist die wichtigste: Ohne sie kann ein
zwischengeschalteter Zwischenspeicher noch die alte Versionsnummer
ausliefern, nachdem du längst eine neue hochgeladen hast.
Zeigt https://sva.tyrveil.com/ trotz hochgeladener index.html weiter
"403 Forbidden", fehlt im server-Block die Zeile
index index.html;
WIE DAS UPDATE FUNKTIONIERT
---------------------------
Das Programm ruft beim Start version.json ab. Steht dort eine höhere
Versionsnummer als die installierte, erscheint unten im Fenster ein
Hinweisbalken mit einer Schaltfläche. Ein Klick lädt die ZIP, prüft die
Prüfsumme, ersetzt die Programmdateien und startet neu.
Ist der Server nicht erreichbar, passiert schlicht nichts - das
Programm läuft dann ganz normal ohne Hinweis weiter.
NEUE VERSION VERÖFFENTLICHEN
----------------------------
1. In squad_manager.py VERSION anpassen und BUILD um eins erhöhen.
Der Bau vergleicht BUILD mit dem Server und warnt, wenn es nicht
höher ist - dann bekäme niemand das Update.
2. Im Quellordner ausführen:
.venv\Scripts\python.exe werkzeuge\baue_release.py
3. Den Inhalt von dist\server\ hochladen, wie oben beschrieben
Der Bauvorgang berechnet die Prüfsumme selbst und trägt sie in
version.json ein. Diese Datei niemals von Hand bearbeiten: Stimmt die
Prüfsumme nicht mit der ZIP überein, verweigert das Programm das
Update - genau so ist es gedacht.
In version.json steht "version" immer auf 4.1, die echte Nummer unter
"anzeige". Das ist Absicht: Programme bis 4.0 lesen nur "version" und
bekommen so das Update auf die neue Zählung ab 1.5.0.
Das Feld "hinweis" darfst du füllen, es erscheint im Hinweisbalken des
Programms und auf der Downloadseite:
"hinweis": "Mikrofonliste aufgeräumt"
Halte es kurz, es steht neben der Schaltfläche.
WARUM HTTPS PFLICHT IST
-----------------------
Das Programm lädt ausschließlich über HTTPS und lehnt http:// ab. Ein
Updater, der Programmcode über eine unverschlüsselte Verbindung holt,
ließe sich in einem fremden WLAN umleiten - dann käme fremder Code auf
die Rechner deiner Freunde. Die Prüfsumme allein schützt davor nicht,
weil ein Angreifer auch sie mitliefern könnte.