Neuer Knopf "Teilen ..." in der Akte. akte_karte.py zeichnet mit Pillow eine Karte 1200 x 675 fuer Discord: Portraet, Callsign, Dienstgrad, Fraktion, Einheit, Status mit Stempel, Auszeichnungen. Kopieren legt sie als DIB und als PNG in die Zwischenablage (Strg+V in Discord), alternativ Speichern als PNG-Datei. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
212 lines
8.2 KiB
Markdown
212 lines
8.2 KiB
Markdown
# Plan: Modul „Akte"
|
||
|
||
Stand: 11. September 2026 · Stufe 0 bis 3 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.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**, Release 4.0 folgt | groß |
|
||
| **3** | Teilen: Akte als PNG-Karte für Discord — **umgesetzt**, kommt mit 4.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.
|