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>
This commit is contained in:
danny 2026-09-13 20:09:31 +02:00
parent 0c7aae5b93
commit 4d9e30bc90
12 changed files with 1590 additions and 146 deletions

View file

@ -1,6 +1,6 @@
# Projektübergabe: Squad Manager
Stand: 13. September 2026 · Version 1.5.1 (Build 2) · Git-Repository im Quellordner
Stand: 13. September 2026 · Version 1.6.0 (Build 3) · Git-Repository im Quellordner
Seit 3.2 wird über einen Inno-Setup-Installer und einen eingebauten
Auto-Updater verteilt (Server: https://sva.tyrveil.com), siehe Abschnitt 4.
@ -50,6 +50,10 @@ akte.py Akte: Oberfläche (Liste, Formular, Dokumentansicht
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
konto.py Verbindung zum Server, Anmeldung (Token per DPAPI)
abgleich.py Abgleich lokaler Akten mit dem Server, ohne tkinter
hintergrund.py Netzwerkarbeit im Thread, Ergebnis im Tk-Hauptthread
squad.py Hauptreiter SQUAD: Anmeldung, Charaktere, Squads
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
@ -150,8 +154,8 @@ gerade nicht gesendet werden darf, oder einen leeren String. Reihenfolge:
| `set_dark_titlebar()` | Fenstertitelleiste dunkel |
| `arm_autosave()` | speichert Einstellungen 600 ms nach jeder Änderung |
**Oberfläche:** Zwei Hauptreiter, *FUNK* (mit den Unterreitern „Mikrofon"
und „Tasten und Verhalten") und *AKTE*. Darunter für alle Module die
**Oberfläche:** Drei Hauptreiter, *FUNK* (mit den Unterreitern „Mikrofon"
und „Tasten und Verhalten"), *AKTE* und seit 1.6.0 *SQUAD*. Darunter für alle Module die
Statusleiste mit den Knöpfen und der Zustandsanzeige (BEREITSCHAFT /
HORCHT / SENDET / GESPERRT) — die Sprachaktivierung läuft weiter, während
man in einem anderen Modul arbeitet. Der zuletzt gewählte Hauptreiter
@ -179,6 +183,35 @@ Dienst-Abschnitt — nicht still korrigieren. Island hat nur die vier
Bereiche der Küstenwache, die Bundeswehr Heer, Luftwaffe und Marine mit
eigenen Marine-Dienstgraden.
**Squad-Reiter und Abgleich (seit 1.6.0):** Ohne Konto zeigt *SQUAD* die
Anmeldung und Registrierung; alles andere läuft ohne Konto wie vorher.
Angemeldet: Unterreiter *Charaktere* (alle Spieler, Zustand KIA/MIA/WIA,
Suche, Fraktionsfilter, fremde Akte als Dokument), *Squads* (gründen,
Mitglieder, Führung übergeben, verlassen, auflösen) und *Einladungen*.
Konto → Abmelden oder Konto löschen. Alle Serveraufrufe über
`hintergrund.Hintergrund`, nie im Tk-Hauptthread.
Die lokalen Akten bleiben Arbeitskopie. `squad.AbgleichSteuerung` stößt
`abgleich.abgleichen()` an: nach dem Anmelden, 4 s nach jeder Änderung
(`AkteSeite.bei_gespeichert`) und alle 5 min. Neben jeder Akte liegt
`server.json` mit Server-ID, Version, Prüfwert des Inhalts und
Porträt-Kennung des letzten Abgleichs. Nur lokal geändert → hochladen, nur
Server → herunterladen, beides → Konflikt: Serverfassung als
`konflikt-<Zeit>.json` neben die Akte, lokale Fassung gewinnt. Auf dem
Server gelöschte Akten wandern lokal in den Papierkorb. Der Papierkorb im
Programm merkt Akten in `akten/_abgleich_loeschen.json` zum Löschen auf dem
Server vor. Die Aktennummer vergibt der Server; der Abgleich schreibt sie
lokal zurück (`modell.speichern(zeit_setzen=False)`). Danach lädt
`AkteSeite.nach_abgleich()` geänderte Akten neu, die offene nur, wenn sie
selbst betroffen ist.
Tests: `werkzeuge/abgleich_test.py` (zwei Rechner als eigene Prozesse mit
eigenem `%APPDATA%`, 34 Fälle) und `werkzeuge/oberflaeche_test.py`
(Programm gegen den Testserver, Anmeldung, Einladung annehmen, fremde
Akte, Konto löschen, mit Bildschirmfotos). Beide nutzen den Testserver aus
`server_test.py`; `konto.py` liest die Serveradresse aus `SM_SERVER`
(nur `http://127.0.0.1` ist neben HTTPS erlaubt).
**Teilen:** Knopf „Teilen …" in der Leiste der Akte. `akte_karte.karte()`
zeichnet mit Pillow eine Karte 1200 × 675 (Discord zeigt das groß) —
bewusst kein Bildschirmfoto, damit sie überall gleich aussieht. Inhalt:
@ -473,6 +506,30 @@ Programme ohne `build` in der Datei vergleichen gegen
`LETZTE_ALTE_VERSION = "4.0"`. Der Bau warnt, wenn `BUILD` nicht höher ist
als online. Getestet mit dem echten `pruefe_update()` aus 3.3 und 4.0.
**21 — `php -S` hängt unter Windows nach vielen Verbindungen.**
Der eingebaute Entwicklungsserver nahm nach einigen hundert schnellen
Anfragen keine Verbindung mehr an, obwohl der Prozess lief – im Test sah das
aus wie „offline". Der Testserver in `server_test.py` startet deshalb für
jede Anfrage ein eigenes `php-cgi` hinter einem Python-`ThreadingHTTPServer`.
Bei rätselhaften Zeitüberschreitungen im Test zuerst das Protokoll
`php-server.log` im Testordner ansehen.
**22 — Änderungen nie am Zeitstempel erkennen.**
`geaendert` in der Akte ist nur sekundengenau. Der erste Abgleich verglich
ihn und übersah Änderungen in derselben Sekunde wie ein Abgleich – der
Zwei-Rechner-Test fand es. Seitdem vergleicht `abgleich.inhalt_hash()` den
Inhalt.
**23 — Der Release-Bau darf keine Bezeichner umschreiben.**
Der Bau setzt in Zeichenketten echte Umlaute ein. In 1.6.0 machte er so
aus der Aktion `"konto_loeschen"` ein `"konto_löschen"` – der Server hätte
„unbekannte Aktion" geantwortet. Alle Tests liefen gegen die Quelle und
waren grün. Seitdem überspringt `baue_release.ist_bezeichner()`
Zeichenketten aus Kleinbuchstaben, Ziffern und `_ . - /`. **Vor jedem
Release die Tests auch gegen das Paket laufen lassen:**
`SM_PROGRAMM=dist\paket\Programm` für `abgleich_test.py` und
`oberflaeche_test.py`.
---
## 6. Umgebung
@ -512,6 +569,14 @@ zu löschen: `SquadManager-3.3.*` und `SquadVoiceActivation-3.2.*`. Offen,
ob bei den Freunden die Nachinstallation von Pillow über `start.pyw`
geklappt hat (erstes Update mit neuem Paket).
**Stand 1.6.0:** Server eingerichtet und erreichbar (Tabellen bestätigt,
`einrichten.php` gelöscht). Vor dem Hochladen von 1.6.0 zuerst
`sva-privat/app` ersetzen – `charaktere.php` liefert neu die
`portraet_kennung`. Den Text aus `installer/DATENSCHUTZ-BAUSTEIN.md` muss der
Nutzer selbst in tyrveil.com/rechtliches einbauen (Laravel-Seite, kein
Zugriff). Offen: Unbestätigte Konten werden nicht automatisch gelöscht;
Konfliktdateien meldet das Programm nur in der Statuszeile.
**Installationen unter „Programme" (Erkenntnis 19).** Wer 3.x für alle
Benutzer installiert hat, kommt per Updater nicht weiter und muss 4.0 einmal
mit dem Installer einspielen. Der entfernt die alte Installation dabei