# Plan: Modul „Akte" Stand: 11. September 2026 · Stufe 0 bis 3 umgesetzt · Stufe 2 online als 4.0, Stufe 3 folgt als 1.5.0 (neue Zählung, siehe Übergabe, Erkenntnis 20) 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.pyw` wird bei jedem Update ersetzt und danach als Erstes ausgeführt. Fehlt beim Laden ein Paket, installiert sie `requirements.txt` in die virtuelle Umgebung nach und zeigt dabei ein Hinweisfenster. Weil die *neue* `start.pyw` das 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.executable` ist die *echte* `pythonw.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 akte_karte.py Akte als PNG-Karte zum Teilen ``` 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** | 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**, online als 4.0 | groß | | **3** | Teilen: Akte als PNG-Karte für Discord — **umgesetzt**, kommt mit 1.5.0 (Export/Import als `.akte`-Datei entfällt, siehe Abschnitt 7) | 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) 1. **Mehrere Akten pro Person** — ja. 2. **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. 3. **Teilen:** PNG-Karte für Discord (Stufe 3). Keine Import-Datei. 4. **Gestaltung:** im bestehenden Stil, ohne vorherigen Entwurf in Claude Design. 5. **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.