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:
parent
f986c3ad11
commit
d2513ea0d1
12 changed files with 353 additions and 91 deletions
208
PLAN-AKTE.md
Normal file
208
PLAN-AKTE.md
Normal 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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue