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

208
PLAN-AKTE.md Normal file
View file

@ -0,0 +1,208 @@
# Plan: Modul „Akte"
Stand: 10. September 2026 · Entwurf, noch nicht umgesetzt
Eine Personalakte für den eigenen Squad-Charakter: Name, Callsign, Rang,
Porträt, Nation, Teilstreitkraft, Einheit, Werdegang. Reines Rollenspiel —
nichts davon beeinflusst das Spiel.
---
## 1. Was die Akte können soll
**Mehrere Akten pro Person.** Wer Rollenspiel betreibt, hat oft mehrere
Charaktere, etwa einen pro Fraktion. Eine Liste links, die gewählte Akte
rechts.
**Zwei Ansichten.** *Ansicht* zeigt die Akte als Dokument im Stil einer
Personalakte — das ist der eigentliche Reiz. *Bearbeiten* zeigt dieselben
Angaben als Formular. Umschalten per Knopf.
**Felder**, gruppiert wie in einer echten Akte:
| Abschnitt | Felder |
|---|---|
| I. Personalien | Vorname, Nachname, Callsign, Geburtsdatum, Herkunft, Porträt |
| II. Dienst | Nation/Fraktion, Teilstreitkraft, Einheit (Verband bis Gruppe), Rang, Verwendung, Dienstbeginn, Status |
| III. Beschreibung | Freitext: Hintergrund, Charakter, Aussehen |
| IV. Auszeichnungen | Liste: Bezeichnung, Datum, Anlass |
| V. Einsätze | Liste: Datum, Ort, Bericht |
| VI. Vermerke | Freitext |
**Vorschläge statt Pflicht.** Nation, Teilstreitkraft, Rang und Verwendung
sind Auswahllisten mit Vorbelegung — die Squad-Fraktionen, ihre Ränge, die
Kit-Rollen (Squad Leader, Medic, LAT …). Jedes Feld nimmt aber auch Freitext
an, damit erfundene Einheiten und Clans ohne Squad-Vorbild gehen.
**Status** mit Wirkung auf die Darstellung: *aktiv*, *verwundet*,
*vermisst*, *gefallen*, *außer Dienst*. Eine gefallene Akte bekommt einen
Stempel und gedämpfte Farben.
**Aktennummer** automatisch, etwa `SM-2026-0042` — reine Optik, aber sie
macht den Dokumentcharakter aus.
---
## 2. Die Voraussetzung, die vorher erledigt werden muss
> **Der Updater kann bisher keine neuen Pakete nachinstallieren.**
Er ersetzt nur Dateien. Das Porträt braucht aber **Pillow**: `tkinter` kann
ohne Pillow weder JPG lesen noch Bilder stufenlos skalieren, und die
meisten Porträts werden JPGs sein.
Kommt das Akten-Update, fehlt Pillow auf jedem Rechner, der per Updater
aktualisiert — das Programm startet dann nicht mehr, oder bestenfalls ohne
Porträts. Deinen Freunden bliebe nur die Neuinstallation.
**Deshalb gehört diese Fähigkeit in die erste veröffentlichte Fassung**,
also vor den Upload von 3.2:
- Der Update-Helfer führt nach dem Kopieren
`.venv\Scripts\python.exe -m pip install -r requirements.txt` aus.
Achtung: Das laufende Programm läuft unter der *echten* `pythonw.exe`
(Übergabe, Erkenntnis 1), `sys.executable` ist also **nicht** der
venv-Interpreter — der Pfad muss aus dem Programmordner gebildet werden.
- Beim Start prüft das Programm, ob alle Pakete da sind, und meldet
fehlende verständlich, statt abzustürzen.
Das ist klein, aber jede Woche, die 3.2 ohne das draußen ist, macht den
späteren Umstieg teurer.
---
## 3. Umbau vorher: ein zweites Modul braucht Platz
`squad_manager.py` hat rund 1600 Zeilen in einer Datei. Die Akte wird
ähnlich groß. Beides in eine Datei zu packen, macht jede spätere Änderung
riskant.
**Vorschlag: flach aufteilen, kein Paketordner.**
```
squad_manager.py Hauptfenster, Navigation, Funk-Modul (wie bisher)
theme.py Farben, Schriften, apply_tactical_theme(), LevelMeter
akte.py Datenmodell, Speicherung, Oberfläche der Akte
```
Flach bleibt es, weil Installer, Update-Paket und `start.pyw` heute flache
Dateien erwarten. Ein Unterordner hieße, alle drei anzupassen — machbar,
aber unnötiges Risiko. `theme.py` wird nötig, weil sonst `akte.py` die
Farben aus `squad_manager.py` importiert und `squad_manager.py` die Akte —
ein zirkulärer Import.
**Navigation:** Die bisherigen Reiter wandern unter einen Hauptreiter
*Funk*, daneben kommt *Akte*. Die Statusleiste mit STARTEN und der
Zustandsanzeige bleibt global sichtbar — die Sprachaktivierung läuft ja
weiter, während man an der Akte schreibt.
---
## 4. Datenmodell und Speicherung
Eine Akte ist ein Ordner mit JSON-Datei und Porträt:
```
%APPDATA%\SquadManager\akten\
3f2a…\
akte.json
portraet.png
```
```json
{
"schema": 1,
"id": "3f2a…",
"aktennummer": "SM-2026-0042",
"erstellt": "2026-09-10T20:15:00",
"geaendert": "2026-09-10T20:31:12",
"personalien": {
"vorname": "", "nachname": "", "callsign": "",
"geburtsdatum": "", "herkunft": ""
},
"dienst": {
"fraktion": "", "teilstreitkraft": "",
"einheit": { "verband": "", "bataillon": "", "kompanie": "", "zug": "", "gruppe": "" },
"rang": "", "verwendung": "", "dienstbeginn": "", "status": "aktiv"
},
"beschreibung": "",
"auszeichnungen": [ { "bezeichnung": "", "datum": "", "anlass": "" } ],
"einsaetze": [ { "datum": "", "ort": "", "bericht": "" } ],
"vermerke": ""
}
```
- **`schema`** erlaubt spätere Umbauten ohne Datenverlust — dieselbe Lehre
wie beim Umzug der Einstellungen.
- **Porträt wird kopiert** und auf höchstens 512 × 512 verkleinert. Die
Akte hängt dann nicht davon ab, dass die Originaldatei liegen bleibt.
- **Speichern automatisch**, verzögert wie bei den Einstellungen.
- **Löschen mit Rückfrage** und über einen Papierkorb-Ordner, nicht
endgültig. Eine über Stunden geschriebene Hintergrundgeschichte darf
nicht an einem Fehlklick hängen.
---
## 5. Umsetzung in Stufen
| Stufe | Inhalt | Umfang |
|---|---|---|
| **0** | Updater installiert Pakete nach, Startprüfung auf fehlende Pakete — **vor dem Upload von 3.2** | klein |
| **1** | `theme.py` auslagern, Hauptreiter *Funk* / *Akte*, Akte noch leer — Version 3.3 | mittel |
| **2** | Akte vollständig: Liste, Formular, Dokumentansicht, Porträt, Vorbelegungen — Version 4.0 | groß |
| **3** | Teilen: Akte als PNG-Karte für Discord, Export/Import als `.akte`-Datei | mittel |
Jede Stufe endet mit einem Release über den Updater. Stufe 1 ist bewusst
ohne neue Funktion: Wenn dabei etwas bricht, liegt es am Umbau und nicht an
der Akte.
**Später, eigenes Vorhaben:** Akten online auf `sva.tyrveil.com`, etwa als
Einheitsliste eines Clans. Das braucht einen Server mit Datenbank,
Anmeldung und eine Antwort auf die Frage, wer welche Akte sehen darf — das
ist ein eigenes Projekt, kein Zusatz.
---
## 6. Gestaltung
Die Dokumentansicht ist der Kern des Reizes und sollte zur bestehenden
Oberfläche passen:
- Kopf mit Aktennummer, Stempel „PERSONALAKTE" und, falls gewählt,
Fraktionswappen
- Porträt oben rechts mit Rahmen, darunter Callsign in großer Schrift
- Abschnitte mit römischen Nummern, Werte in dicktengleicher Schrift wie
von einer Schreibmaschine
- Statusstempel quer über dem Porträt bei *gefallen* oder *vermisst*
Umsetzbar auf einer Zeichenfläche wie die Pegelanzeige — dort sind
Stempel, Rahmen und gedrehte Schrift möglich, die `ttk` selbst nicht kann.
Das bestehende `Design-Briefing.md` lässt sich um diesen Bildschirm
erweitern, falls du dafür wieder Claude Design einsetzen willst.
---
## 7. Zu entscheiden
Mit meiner Empfehlung, damit Stufe 2 ohne Rückfragen durchlaufen kann:
1. **Mehrere Akten pro Person?** — Ja.
2. **Vorbelegungen für welche Nationen zuerst?** — Die Squad-Fraktionen.
Wenn eure Gruppe eine bestimmte Armee spielt, etwa die Bundeswehr, die
zusätzlich.
3. **Teilen mit Freunden wichtig?** — Stufe 3 als PNG-Karte ist der
einfachste Weg mit dem meisten Effekt, weil sie direkt in Discord landet.
4. **Online-Akten?** — Erst einmal nicht, siehe oben.
---
## 8. Risiken
- **Pillow als neue Abhängigkeit** — bewältigt durch Stufe 0.
- **Rang-Tabellen sind Fleißarbeit.** Jede Fraktion hat eigene Ränge und
Abkürzungen. Start mit wenigen, Freitext als Ausweg.
- **Datenverlust** — Papierkorb statt Löschen, Schema-Version, später
Export als Sicherung.
- **Norton** könnte beim Porträt-Import über den Dateidialog nichts
bemerken — unkritisch, aber beim ersten Test darauf achten, da Norton
hier schon mehrfach überrascht hat.