squad-manager/Design-Briefing.md
danny d2513ea0d1 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>
2026-09-10 17:49:13 +02:00

9.4 KiB
Raw Permalink Blame History

Design-Briefing: Squad Manager

Zwei Aufgaben, in dieser Reihenfolge:

  • Teil A — ein Design System (Farben, Schrift, Abstände, Bausteine)
  • Teil B — die beiden Bildschirme des Programms, gebaut aus Teil A

Ausgangslage

Ein Windows-Desktop-Werkzeug für den Taktik-Shooter Squad. Es misst laufend den Mikrofonpegel und hält die Sprechtaste des Spiels automatisch gedrückt, solange der Spieler redet — Voice Activation für ein Spiel, das nur Push-to-Talk kennt.

Kein Overlay, kein Spielinhalt: ein eigenständiges Fenster neben dem Spiel. Es wird zum Einrichten geöffnet und im Betrieb nur kurz angeschaut, um einen Zustand abzulesen.

Nutzer: Squad-Spieler, überwiegend erwachsen, Mil-Sim-affin, technisch interessiert. Vertraut mit Begriffen wie Local, Squad Radio, Command Radio, WASAPI. Sie mögen nüchterne Werkzeuge und misstrauen verspielten Oberflächen.

Anmutung: Militärisch-funktional, nüchtern, dunkel. Nähe zur Bildsprache des Spiels — gedecktes Olivgrün, Sandtöne, dunkles Metall, Beschriftungen wie auf Gerätefronten. Kein Neon, keine Verläufe, keine Spielereien. Eher Feldfunkgerät als Consumer-App.

Oberstes Ziel: Ablesbarkeit. Der Nutzer kommt aus einem Vollbild-Spiel und muss den Zustand in einer halben Sekunde erfassen.


TEIL A — Design System

Gesucht ist ein kleines, konsequentes System für genau diese Art von Werkzeug. Bitte als benannte Gestaltungsmerkmale anlegen, damit sie in Teil B wiederverwendet werden können.

A1 Farben

Als Rollen definieren, nicht nur als Werte. Benötigt werden mindestens:

  • Fensterhintergrund (dunkelste Ebene)
  • Flächenfarbe für Eingabefelder und Kästen
  • gehobene Fläche für aktiven Reiter und Mauskontakt
  • Rahmen- und Trennlinienfarbe
  • Textfarbe, Nebentextfarbe
  • Akzentfarbe (Olivgrün) in normal und hell
  • Signalfarben: Bernstein (Hinweis, Schwelle), Grün (aktiv/sendet), Rot (gesperrt), Grau (untätig)

Bisher verwendete Werte als Ausgangspunkt, gern verbessern:

Rolle Wert
Fensterhintergrund #151814
Fläche #1e231b
Fläche gehoben #2a3125
Linie #3d4634
Text #c9cec0
Nebentext #7f8874
Akzent #6e8b3d
Akzent hell #8cb04d
Bernstein #d9a441
Rot #b4472f
Grün aktiv #9ed23f

A2 Schrift

Zwei Familien, klar getrennt in der Aufgabe:

  • Beschriftungen und Fließtext — serifenlos, gut lesbar (bisher Segoe UI)
  • Messwerte, Diagnose, Zustandsanzeige — dicktengleich (bisher Consolas)

Gesucht ist eine Skala mit etwa fünf Stufen: Fenstertitel, Kastenüberschrift, Beschriftung, Nebentext, Zustandsanzeige. Versalien sparsam einsetzen — bisher nur für Fenstertitel und die Knöpfe der Statusleiste.

A3 Raster und Abstände

Formularzeilen: links Beschriftung, rechts Bedienelement, konsistent ausgerichtet. Bitte eine Abstandsskala festlegen (Innenabstand von Kästen, Zeilenabstand, Abstand zwischen Gruppen) und durchhalten.

A4 Bausteine

Für jeden Baustein die Zustände normal, Mauskontakt, Fokus und deaktiviert mitdenken:

  1. Knopf, primär — nur einmal pro Fenster (STARTEN)
  2. Knopf, sekundär — normale Aktionen, deaktivierbar
  3. Auswahlliste — auch mit sehr langen Einträgen wie [WASAPI] Analogue 1 + 2 (Focusrite USB Audio); zusätzlich eine schmale Variante für Tastenauswahl
  4. Textfeld — einzeilig
  5. Zahlenfeld mit Schrittpfeilen
  6. Schieberegler mit Zahlenanzeige daneben
  7. Kontrollkästchen mit ein- und zweizeiliger Beschriftung
  8. Reiter — genau zwei, aktiver deutlich abgesetzt
  9. Gerahmter Kasten mit Überschrift in der Rahmenlinie
  10. Diagnosefeld — mehrzeilig, dicktengleich, gerahmt
  11. Pegelanzeige — siehe A5
  12. Zustandsanzeige — siehe A6
  13. Statuszeile — dezente, mitlaufende Textzeile unter einem Element
  14. Hinweistext — mehrzeilig, gedämpft

A5 Pegelanzeige — Kernstück

Kein gewöhnlicher Fortschrittsbalken. Etwa 40 schmale senkrechte Segmente in einem Rahmen. Gefüllte Segmente zeigen den aktuellen Pegel, leere bleiben dunkel. Eine senkrechte bernsteinfarbene Marke steht an der Position der Auslöseschwelle.

Der Nutzen: Man sieht sofort, ob die eigene Stimme über die Schwelle kommt. Bleiben die gefüllten Segmente links der Marke, löst nichts aus. Genau daran scheitern Nutzer beim Einrichten — deshalb ist das der wichtigste Blickfang des Fensters.

Bitte auch entwerfen, wie die Anzeige im aktiven Zustand (es wird gerade gesendet) anders aussieht als im horchenden.

A6 Zustandsanzeige

Vier sich ausschließende Zustände, jeweils Punkt plus Text:

Zustand Text Farbe Bedeutung
gestoppt ● BEREITSCHAFT grau läuft nicht
bereit ● HORCHT bernstein läuft, wartet auf Stimme
aktiv ● SENDET grün Taste wird gerade gehalten
blockiert ● GESPERRT rot pausiert, Grund steht daneben

Muss aus zwei Metern Abstand erkennbar sein. Farbe allein darf nicht das einzige Unterscheidungsmerkmal sein.


TEIL B — Die Bildschirme

Ein Fenster, Standardgröße 700 × 780 px, verkleinerbar bis etwa 660 × 480. Aufbau von oben nach unten: Kopfbereich, zwei Reiter, Statusleiste am unteren Rand (immer sichtbar, auch bei kleinem Fenster).

Kopfbereich

  • Titel SQUAD MANAGER
  • Untertitel „Hält die Sprechtaste, solange du redest."
  • Trennlinie darunter

Bildschirm 1 — Reiter „Mikrofon"

Formularzeilen:

Beschriftung Bedienelement Anmerkung
Mikrofon Auswahlliste + Knopf „Neu laden" lange Einträge, Präfix [WASAPI] / [MME]
Schwelle Schieberegler + Zahlenwert 0.002 bis 0.100, dreistellig angezeigt
Pegel Pegelanzeige + Zahlenwert das Kernstück aus A5
Nachlaufzeit Zahlenfeld + „ms nach dem letzten Wort" 100 bis 2000

Darunter zwei gerahmte Kästen:

„Warum sendet es (nicht)?" — Diagnosefeld, zwei bis vier Zeilen. Beispielinhalt:

Pegel 0.0413 / Schwelle 0.0250   -> über Schwelle
Blockiert: Squad nicht im Vordergrund
  -> Squad anklicken, oder den Haken im
     Reiter 'Tasten und Verhalten' entfernen.

„Eingabetest" — Knopf „PTT-Taste testen (1 Sekunde halten)" plus Ergebnistext daneben.

Abschließend ein vierzeiliger Hinweistext in gedämpfter Farbe.

Bildschirm 2 — Reiter „Tasten und Verhalten"

  • Zeile Sprechtaste: schmale Auswahlliste (Zusatztaste), ein „+", schmale Auswahlliste (Taste), dahinter grauer Hinweis

  • Gerahmter Kasten „Andere Sprechtasten — Automatik pausiert, solange eine gehalten wird" mit drei gleich aufgebauten Zeilen:

    Beschriftung Zusatztaste Taste Hinweis
    Squad Radio (kein) + B meist B
    Command Radio (kein) + G meist G
    Weitere Taste (kein) + (keine) optional
  • Dreizeiliger Erklärtext

  • Gerahmter Kasten „Verhalten":

    • Kontrollkästchen „Alles nur aktiv, solange dieses Programm im Vordergrund ist:" — darunter eingerückt ein Textfeld mit dem Prozessnamen und eine mitlaufende Statuszeile („gerade im Vordergrund: SquadGame-Win64-Shipping.exe")
    • Kontrollkästchen „Pausieren, solange ein Mauszeiger sichtbar ist (Deploy-Screen, Menü, Karte)" — darunter mitlaufende Statuszeile („Mauszeiger gerade ausgeblendet")
    • Zeile „Stummschalt-Hotkey (nur im Spiel)" + schmale Auswahlliste
    • Kontrollkästchen „Signalton beim Umschalten (hoch = aktiv, tief = stumm)"
  • Zum Abschluss eine dezente Zeile „Alle Änderungen werden sofort gespeichert." mit Zeitstempel der letzten Speicherung

Statusleiste

Über die volle Breite, oben abgetrennt durch eine Linie.

  • Links: STARTEN (der einzige primäre Knopf im ganzen Fenster) und STOPPEN (sekundär, im Ruhezustand deaktiviert)
  • Rechts: Detailtext (etwa „Funk aktiv (B)" oder „WASAPI @ 48000 Hz") und daneben die Zustandsanzeige aus A6

Bitte zusätzlich zeigen

Die Zustandsanzeige und die Pegelanzeige sind die einzigen Elemente, die im laufenden Betrieb wirklich abgelesen werden. Deshalb wären hilfreich:

  1. Bildschirm 1 im Zustand SENDET — Pegel über der Schwelle
  2. Bildschirm 1 im Zustand GESPERRT — Pegel über der Schwelle, aber blockiert, mit Grund im Diagnosefeld
  3. Die vier Zustände der Zustandsanzeige nebeneinander

Technische Rahmenbedingungen

Die Oberfläche ist mit Python und Tkinter/ttk gebaut. Das begrenzt, was sich unmittelbar umsetzen lässt:

Gut machbar: freie Farben für Flächen, Text und Rahmen; eigene Schriftarten und -größen; Rahmen und Trennlinien; beliebige Grafik auf einer Zeichenfläche (die Pegelanzeige ist bereits so gebaut — dort ist gestalterisch fast alles möglich); Bilder als Symbole.

Nicht oder nur mit erheblichem Aufwand: abgerundete Ecken an Standardelementen, Schlagschatten, Verläufe hinter Bedienelementen, Transparenz, weiche Animationen, Platzhaltertexte in Eingabefeldern.

Ein Entwurf darf gern darüber hinausgehen. Dann bitte kenntlich machen, welche Teile über den Standardumfang hinausgehen — sie müssten dann als selbstgezeichnete Flächen entstehen oder ein anderes Oberflächen-Werkzeug erfordern.

Woran der Entwurf gemessen wird

  1. Der Zustand ist auf einen Blick erfassbar, auch aus zwei Metern.
  2. Die Beziehung zwischen Pegel und Schwelle wird sofort verständlich — das ist die häufigste Hürde beim Einrichten.
  3. Der zweite Reiter mit seinen vielen Auswahlfeldern wirkt geordnet, nicht überladen.
  4. Es sieht nach Werkzeug aus, nicht nach Spielerei.