squad-manager/README.md
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

61 lines
2.3 KiB
Markdown

# squad-manager
Quellcode von **Squad Manager** — ein Windows-Werkzeug für den Taktik-Shooter
Squad. Kernfunktion: hält die Sprechtaste automatisch gedrückt, solange man
redet. Bis Version 3.2 hieß das Programm *Squad Voice Activation*.
Technische Dokumentation und alle bekannten Fallstricke:
**[PROJEKT-UEBERGABE.md](PROJEKT-UEBERGABE.md)** — dort anfangen.
## Inhalt
| Pfad | Zweck |
|---|---|
| `squad_manager.py` | Hauptfenster, Funk-Modul, Updater |
| `theme.py` | Farben, Schriften, Stil, Pegelanzeige |
| `akte.py` | Modul Akte: Oberfläche |
| `akte_modell.py` | Modul Akte: Datenmodell und Speicherung |
| `akte_vorlagen.py` | Modul Akte: Fraktionen, Dienstgrade, Verwendungen |
| `akte_karte.py` | Modul Akte: PNG-Karte zum Teilen |
| `konto.py` | Verbindung zum Server, Anmeldung |
| `abgleich.py` | Abgleich der Akten mit dem Server |
| `hintergrund.py` | Netzwerkarbeit im Hintergrund-Thread |
| `squad.py` | Hauptreiter SQUAD: Charaktere, Squads, Einladungen |
| `server/` | PHP-Server für Konten und Squads auf sva.tyrveil.com |
| `update_helfer.py` | spielt Updates ein, bei Bedarf mit Adminrechten |
| `start.pyw` | Startskript ohne Konsolenfenster |
| `make_icon.py` | erzeugt `icon.ico` aus `icon.png` |
| `icon.png`, `icon.ico` | Programmsymbol |
| `requirements.txt` | numpy, sounddevice, Pillow |
| `installer/` | Inno-Setup-Skript, Einrichtung nach der Installation, Server-Anleitung |
| `werkzeuge/` | Release-Bau und Testhilfen |
| `Design-Briefing.md` | Auftrag für die Gestaltung |
## Entwickeln
Die Laufzeitumgebung ist nicht im Repository, sie enthält feste Pfade:
```
py -3 -m venv .venv
.venv\Scripts\python.exe -m pip install -r requirements.txt
.venv\Scripts\python.exe squad_manager.py
```
Immer den Interpreter aus `.venv` verwenden. Auf dem Entwicklungsrechner
zeigt `python` auf die Microsoft-Store-Fassung, die `%APPDATA%`
virtualisiert.
## Release bauen
```
.venv\Scripts\python.exe werkzeuge\baue_release.py
```
Erzeugt in `dist/` das Update-Paket, den Installer und unter `dist/server/`
genau die Dateien für `https://sva.tyrveil.com`. Benötigt Inno Setup 6.
## Git auf diesem Rechner
Norton bricht HTTPS-Verbindungen zur Prüfung auf. Deshalb steht in der
Repository-Konfiguration `http.sslBackend=schannel` — Git verwendet damit
den Windows-Zertifikatsspeicher statt seiner eigenen Liste.