Mehrere Akten mit Liste, Formular und Dokumentansicht, Portraet, Statusstempel bei gefallen und vermisst, Vorschlagslisten fuer 22 Fraktionen samt Dienstgraden. Datenmodell in akte_modell.py ohne tkinter, Vorlagen in akte_vorlagen.py. Speichern atomar mit Sicherung, Loeschen ueber einen Papierkorb-Ordner. Neue Abhaengigkeit Pillow. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
8.1 KiB
Plan: Modul „Akte"
Stand: 10. September 2026 · Stufe 0 bis 2 umgesetzt, Release 4.0 nach dem Update-Test von 3.4
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.
Umgesetzt in 3.3, und zwar in start.pyw statt im Update-Helfer:
start.pywwird bei jedem Update ersetzt und danach als Erstes ausgeführt. Fehlt beim Laden ein Paket, installiert sierequirements.txtin die virtuelle Umgebung nach und zeigt dabei ein Hinweisfenster. Weil die neuestart.pywdas erledigt, greift es auch bei Updates von 3.2 aus — deren Update-Helfer weiß davon nichts, muss es aber auch nicht.- Der venv-Interpreter wird aus dem Programmordner gebildet:
sys.executableist die echtepythonw.exe(Übergabe, Erkenntnis 1). - Scheitert die Nachinstallation, etwa ohne Internet, erscheint eine verständliche Meldung statt eines stillen Absturzes.
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 Oberfläche der Akte
akte_modell.py Datenmodell und Speicherung, ohne tkinter
akte_vorlagen.py Fraktionen, Dienstgrade, Verwendungen
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
{
"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": ""
}
schemaerlaubt 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 | Fehlende Pakete werden beim Start nachinstalliert — erledigt in 3.3 | klein |
| 1 | theme.py auslagern, Hauptreiter Funk / Akte, Akte noch leer — erledigt in 3.4 |
mittel |
| 2 | Akte vollständig: Liste, Formular, Dokumentansicht, Porträt, Vorbelegungen — umgesetzt, Release 4.0 folgt | 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. Entscheidungen (10. September 2026)
- Mehrere Akten pro Person — ja.
- Vorbelegungen für Fraktion und Rang: alle Squad-Fraktionen, dazu Bundeswehr, Frankreich, Spanien, Italien und Island. Freitext bleibt überall möglich. Island hat keine Armee, nur Küstenwache (Landhelgisgæslan) und die Krisenreaktionseinheit. Vorbelegt werden die Dienstgrade der Küstenwache, sofern die Gruppe kein fiktives Island spielt.
- Teilen: PNG-Karte für Discord (Stufe 3). Keine Import-Datei.
- Gestaltung: im bestehenden Stil, ohne vorherigen Entwurf in Claude Design.
- Online-Akten: vorerst nicht.
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.