squad-manager/README.md
danny a200987237 Updater: geschuetzte Programmordner, Installer nur pro Benutzer
Lag das Programm unter C:\Program Files (Installer-Wahl "fuer alle
Benutzer"), scheiterte das Kopieren beim Update still und die alte
Fassung startete neu. Neu:

- update_helfer.py ersetzt die Batchdatei. Wartet per Prozess-ID auf das
  Programmende, prueft den Ordner per Schreibprobe und kopiert bei Bedarf
  in einem zweiten Prozess mit Adminrechten. Fehler werden gemeldet und
  protokolliert, mit Link zum Installer.
- Das Programm kuendigt die Windows-Abfrage vor dem Download an.
- Der Helfer aus dem neuen Paket hat Vorrang.
- Installer ohne die Wahl "fuer alle Benutzer"; eine alte Installation
  fuer alle Benutzer wird vorher entfernt.
- version.json fuehrt die Installer-Adresse.

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

55 lines
2 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 |
| `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.