================================================================
  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.
