Document checklist and dialog workflow

README.md

@@ -3,6 +3,9 @@
 Interaktives Skript fuer einen **Proxmox-Host**. Es installiert fehlende Tailscale-
 und Wazuh-Komponenten in ausgewaehlten LXCs, verbindet neue Tailscale-Clients mit
 Headscale und kann **Tailscale SSH** samt Linux-Nutzer und Sudo einrichten.
+Alle interaktiven Abfragen verwenden eine Dialogoberflaeche mit `whiptail`
+oder alternativ `dialog`: LXC-Checkliste, Ja/Nein-Schaltflaechen, Eingabefelder
+und verdeckte Felder fuer Schluessel und Passwoerter.
 
 ## Starten
 
@@ -29,6 +32,29 @@ geplanten Aenderungen. Beide installieren nichts, starten nichts neu und speiche
 keine Einstellungen. Fuer interaktive Eingaben muss ein Terminal vorhanden sein;
 die Eingaben werden ueber `/dev/tty` gelesen, auch beim Start per curl.
 
+## Bedienung der Dialoge
+
+- **Pfeiltasten:** zwischen Containern oder Optionen wechseln.
+- **Leertaste:** einen LXC markieren oder abwaehlen; mehrere sind moeglich.
+- **Tab:** zwischen Liste/Eingabe und Schaltflaechen wechseln.
+- **Enter:** die aktuelle Auswahl oder Schaltflaeche bestaetigen.
+- **Abbrechen/Escape:** den Ablauf abbrechen. Beim Ja/Nein-Dialog bedeutet
+  **Nein** nur die Ablehnung dieser Einstellung; Escape bricht ab.
+
+Die Checkliste zeigt CTID, Namen und vorhandene/fehlende Komponenten. Zunaechst
+ist kein Container markiert. Vollstaendig installierte Container bleiben
+ausgeblendet. Gespeicherte Ja/Nein-Vorgaben werden als Standard ausgewaehlt;
+ein vorhandener SSH-Nutzername ist im Eingabefeld vorbelegt. Vor der Installation
+erscheint eine Uebersicht der geplanten Aenderungen. `INSTALL` und gegebenenfalls
+`NEUSTART` muessen weiterhin ausdruecklich eingetippt werden.
+
+Wenn beide Dialogprogramme fehlen, `TERM=dumb` gesetzt oder das Terminal kleiner
+als 60 Spalten / 16 Zeilen ist, verwendet das Skript die bisherige Texteingabe.
+Es installiert dafuer keine Pakete auf dem Host. Fuer die Dialogoberflaeche bei
+fehlendem Werkzeug auf dem Proxmox-Host einmal `apt-get install whiptail` nutzen.
+`--select 'CTID CTID'` ueberspringt nur die Checkliste; die anderen Abfragen bleiben
+Dialoge. `--list` bleibt eine reine Textausgabe ohne Abfragen.
+
 ### Nach einer unterbrochenen Tailscale-Anmeldung
 
 Wenn Tailscale bereits installiert wurde, die erste Anmeldung aber scheiterte,
@@ -55,7 +81,8 @@ Vollstaendig installierte Container bleiben aus der normalen Auswahl ausgeblende
 3. Vorherige Einstellungen auf Wunsch laden. Tailscale SSH ist beim ersten Lauf
    standardmaessig aktiviert. Linux-Nutzername, Sudo und optional passwortloses
    Sudo werden abgefragt. Es wird kein OpenSSH-Server installiert.
-4. CTIDs auswaehlen. Nur diese Container werden bearbeitet.
+4. LXCs in der Checkliste mit der Leertaste auswaehlen und bestaetigen.
+   Nur diese Container werden bearbeitet.
 5. Wazuh-Manager-Adresse und Headscale-HTTPS-URL abfragen. Falls genau ein laufender
    lokaler Wazuh-Manager gefunden wird, dessen Paketversion automatisch verwenden;
    andernfalls die exakte Manager-Paketversion abfragen. Bei einer Manager-
@@ -152,5 +179,6 @@ kann temporaere Dateien in `/run/lxc-enroll.*` hinterlassen; dann entfernen.
 
 Syntax und simulierte Auswahl-/Installationsablaeufe sind lokal geprueft,
 einschliesslich Debian-Systemdaten und Wiederaufnahme nach fehlgeschlagener
-Anmeldung. Die aktuelle Korrektur und eine Tailscale-SSH-Anmeldung muessen
-auf dem echten Proxmox-System noch bestaetigt werden.
+Anmeldung. Ein echter Enrollment-Lauf samt Tailscale SSH wurde bestaetigt.
+Die neue Dialogoberflaeche ist mit simulierten Dialogaufrufen geprueft;
+Darstellung und Tastaturbedienung auf dem Proxmox-Terminal stehen noch aus.