start.pyw prueft beim Laden, ob alle Pakete vorhanden sind. Fehlt eines, installiert es requirements.txt in die virtuelle Umgebung nach und zeigt dabei ein Hinweisfenster. Scheitert das, erscheint eine verstaendliche Meldung, und der Grund landet im Fehlerlog. Das liegt bewusst in start.pyw und nicht im Update-Helfer: Der Helfer stammt aus der alten Fassung, start.pyw aus der neuen. So bekommt auch ein 3.2-Client spaeter neue Abhaengigkeiten wie Pillow fuer die Akte. Getestet: leere Umgebung wird eingerichtet, kein sichtbares Konsolenfenster; nicht installierbares Paket fuehrt zu Meldung und Log. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
207 lines
7.8 KiB
Markdown
207 lines
7.8 KiB
Markdown
# 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.
|
||
|
||
**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 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** | Fehlende Pakete werden beim Start nachinstalliert — **erledigt in 3.3** | 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.
|