Umbenennung in Squad Manager, Installer-Korrekturen, Plan fuer Akte

- Programm heisst jetzt Squad Manager, Hauptdatei squad_manager.py
- Einstellungen ziehen nach %APPDATA%\SquadManager um; alte werden beim
  ersten Start kopiert, nicht verschoben
- Installer: Verknuepfung liegt in {userprograms}, der Deinstallierer
  raeumte bisher im falschen Ordner ab; doppelte Verknuepfung entfernt
- Deinstallierer fragt per SuppressibleMsgBox mit Vorgabe Nein, damit
  stille Deinstallationen keine Einstellungen loeschen
- HOCHLADEN.txt liegt jetzt in der Quelle und wird beim Bau kopiert
- Plan fuer das Modul Akte (PLAN-AKTE.md)
- Version 3.3

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-09-10 17:49:13 +02:00
parent f986c3ad11
commit d2513ea0d1
12 changed files with 353 additions and 91 deletions

View file

@ -1,10 +1,14 @@
# Projektübergabe: Squad Voice Activation
# Projektübergabe: Squad Manager
Stand: 10. September 2026 · Version 3.2 · 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.
Das Projekt heißt seit 3.2 **Squad Manager** (vorher „Squad Voice
Activation"). Repository: `github.com/DannyShepard312/squad-manager`
(privat). Geplant ist ein zweites Modul „Akte" für Rollenspiel-Charaktere.
Dieses Dokument richtet sich an eine neue Claude-Sitzung ohne Vorwissen.
Es beschreibt, was das Projekt ist, wie es aufgebaut ist und vor allem:
welche Fallstricke bereits teuer gelernt wurden. Die Abschnitte
@ -34,28 +38,30 @@ und aller Dokumente ist Deutsch.
Es gibt drei getrennte Orte. Das zu verwechseln war bereits mehrfach die
Fehlerquelle.
### `C:\Users\danie\Downloads\Squad_Local_Voice_Activation_v2\` — Quelle
### `C:\Users\danie\Downloads\squad-manager\` — Quelle
Arbeitsverzeichnis. Hier wird entwickelt. Der Code enthält hier
**Kommentare**, und Texte stehen teils in Ersatzschreibung („Haelt").
```
squad_voice_activation.py Hauptprogramm, rund 1200 Zeilen, eine Datei
squad_manager.py Hauptprogramm, rund 1600 Zeilen, eine Datei
start.pyw Startskript ohne Konsolenfenster
make_icon.py erzeugt icon.ico aus icon.png
icon.png / icon.ico Programmsymbol (vom Nutzer geliefert)
requirements.txt numpy, sounddevice
werkzeuge/ Hilfsskripte für den Paketbau, siehe Abschnitt 4
README.md kurze Orientierung im Ordner
installer/ Inno-Setup-Skript, Einrichtung, Server-Anleitung
werkzeuge/ Release-Bau und Testhilfen, siehe Abschnitt 4
README.md kurze Orientierung
PROJEKT-UEBERGABE.md dieses Dokument
Design-Briefing.md Auftrag für Claude Design, siehe Offene Punkte
```
**Aufteilung der Pflege:** Nur die drei Python-Dateien werden hier
gepflegt und für das Paket aufbereitet. Die Skripte `Setup.bat`,
`Update.bat`, `Deinstallieren.bat`, `Fehlersuche.bat` und `Starter.vbs`
durchlaufen keine Aufbereitung und werden **direkt im Paket** gepflegt —
es gibt bewusst keine zweite Kopie in der Quelle.
**Aufteilung:** Die Python-Dateien werden beim Release aufbereitet
(Kommentare raus, Umlaute rein). Alles unter `installer/` wird unverändert
übernommen: `setup.iss`, `einrichten.bat`, `HOCHLADEN.txt` und in
`installer/paketdateien/` die Skripte `Starter.vbs` und `Fehlersuche.bat`.
`Setup.bat`, `Update.bat` und `Deinstallieren.bat` gehören zum alten
Paketweg und sind nicht im Repository.
### `C:\Users\danie\Downloads\Squad Voice Activation 3.1\` — altes Paket
@ -81,10 +87,15 @@ Programm/
Dazu `Downloads\SquadVoiceActivation-3.1.zip` als Versandfassung.
### `%LOCALAPPDATA%\Programs\SquadVoiceActivation\` — Installation
### `%LOCALAPPDATA%\Programs\SquadManager\` — Installation
Zielverzeichnis. Enthält zusätzlich `.venv\`. Konfiguration und Fehlerlog
liegen getrennt davon in `%APPDATA%\SquadVoiceActivation\`.
Standardziel des Installers, frei wählbar. Enthält zusätzlich `.venv\`.
Konfiguration und Fehlerlog liegen getrennt davon in
`%APPDATA%\SquadManager\`. Beim ersten Start werden Einstellungen aus
`%APPDATA%\SquadVoiceActivation\` übernommen — kopiert, nicht verschoben
(`alte_einstellungen_uebernehmen()`). Die eigene Installation des Nutzers
unter `…\Programs\SquadVoiceActivation\` stammt noch von 3.1 (Setup.bat)
und hat keinen Updater.
---
@ -134,10 +145,10 @@ Ein Befehl erzeugt alles:
.venv\Scripts\python.exe werkzeuge\baue_release.py
```
Die Version kommt aus `VERSION` in `squad_voice_activation.py`. Ergebnis in
Die Version kommt aus `VERSION` in `squad_manager.py`. Ergebnis in
`dist/` (nicht im Repository): aufbereitete Programmdateien, das
Update-Paket `SquadVoiceActivation-<v>.zip`, der Installer
`SquadVoiceActivation-Setup-<v>.exe` und `dist/server/` mit genau den
Update-Paket `SquadManager-<v>.zip`, der Installer
`SquadManager-Setup-<v>.exe` und `dist/server/` mit genau den
Dateien zum Hochladen samt `version.json` (Prüfsumme wird eingetragen).
**Installer:** Inno Setup 6.7.3 unter
@ -255,6 +266,24 @@ verwenden: `.venv\Scripts\python.exe`.
Mit `side="bottom"`. Sonst nimmt das Notebook (`expand=True`) allen Platz
und die Knöpfe fallen aus dem Fenster. Genau das ist einmal passiert.
**13 — Norton bricht HTTPS auf.**
Verbindungen kommen mit einem Zertifikat „Norton Web/Mail Shield Root" an.
Windows vertraut ihm, Git mit seiner eigenen OpenSSL-Liste nicht
(`SSL peer certificate … was not OK`). Deshalb steht in der
Repository-Konfiguration `http.sslBackend=schannel` — Git nutzt dann den
Windows-Zertifikatsspeicher, die Prüfung bleibt aktiv. `winget` braucht
aus demselben Grund `--source winget`.
**14 — Der Projektordner gehört den Administratoren, nicht dem Nutzer.**
Git verweigert dann die Arbeit (`dubious ownership`). Abhilfe:
`git config --global --add safe.directory <Pfad>` für genau diesen Ordner.
Nach einem Umbenennen des Ordners muss der Eintrag neu gesetzt werden.
**15 — Inno-Setup-Konstanten genau lesen.**
`{userstartmenu}` ist der Startmenü-Stamm, `{userprograms}` der Ordner
„Programme" darin. Die Verknüpfung liegt in letzterem; der Deinstallierer
räumte deshalb eine Zeit lang daneben ab.
---
## 6. Umgebung