#!/usr/bin/env bash
# ============================================================================
# ORBIT Player — WLAN-Setup-CLI-Wrapper (Phase 15)
# Lumeon Media UG (haftungsbeschraenkt)
#
# Verwendung:
#   admin-wifi-setup          # Startet Backend + Xorg + Chromium-Kiosk auf TTY2
#
# Lifecycle (CONTEXT D-13):
#   1. Techniker: Ctrl+Alt+F2 -> TTY2 -> Login orbit
#   2. admin-wifi-setup
#   3. Script startet Flask-Backend auf 127.0.0.1:8081 (BG)
#   4. Wartet bis Backend bereit (max 10s)
#   5. Startet Xorg + Chromium per xinit -- :1 vt2
#   6. BLOCKIERT bis chromium endet ODER Ctrl+Alt+F1 (VT-Watcher beendet Session)
#   7. Cleanup-Trap: kill Backend, log; auf i915 verwaiste Kiosk-Reste abraeumen
#      (Player wird NICHT gestoppt/gestartet — V2 lebt durchgehend, holt den
#      DRM-Master bei F1 via VT_PROCESS selbst zurueck; Phase-30-V-08-Fix)
#
# x86/i915-Sonderfall (Phase 20 → Phase 30 V-08, 2026-06-12):
#   Auf dem Pi 5 (vc4) hat das System getrennte DRM-Karten (card0 v3d / card1
#   vc4-display) — der Player und Xorg nutzen verschiedene Karten, kein
#   Master-Konflikt. Auf x86/i915 (MINIX) gibt es nur EINE Karte (card0); der
#   laufende orbit-player haelt dort den DRM-Master und Xorg kann ihn nur
#   uebernehmen, wenn der Player ihn vorher freigibt.
#
#   ALT (Phase 20): es gab auf i915 noch keinen funktionierenden VT_PROCESS-
#   drop_master — daher stoppte dieses Skript den Player HART (systemctl stop)
#   und startete ihn im Cleanup wieder. Das hatte zwei Mechanismen fuer DIESELBE
#   DRM-Master-Uebergabe und tötete (Phase-30-V-08-Befund) den sauber via
#   VT_PROCESS pausierten V2-Player mitten in der TTY2-Session.
#
#   NEU (MINIX-V2, Phase 30): Der V2-Player gibt den DRM-Master bei Strg+Alt+F2
#   SELBST frei (VT_PROCESS-Release: pause_for_vt → clear_overlay → drop_master →
#   ack_release, V2/core/boot.py:299-320) und nimmt ihn bei Strg+Alt+F1
#   IN-PROZESS zurueck (Acquire: set_master → set_display_mode → resume, :321-373).
#   Dieses Skript laeuft AUF tty2 — d.h. F2 ist bereits passiert und der Player
#   hat den Master schon freigegeben, BEVOR diese Zeilen laufen. Daher: KEIN
#   Player-Stop/-Start mehr. Statt Blind-Stop nur eine kurze Warte-/Pruef-Phase,
#   damit drop_master sicher durch ist, bevor Xorg den Master greift. Der
#   Cleanup raeumt nur noch verwaiste Kiosk-Reste (Chromium/Xorg/at-spi2) ab,
#   damit der Player den Master bei F1 ungehindert zurueckbekommt — er startet
#   den Player NICHT neu (der Player lebt durchgehend).
#   Der vc4/Pi-Pfad bleibt unveraendert (Block wird auf vc4 nicht betreten).
# ============================================================================
set -euo pipefail

REPO=/opt/orbit-player
LOG=/var/log/orbit-wifi-setup.log
BACKEND_LOG=/var/log/orbit-wifi-setup-backend.log
TAG=orbit-wifi-setup
PORT=8081
PLAYER_UNIT=orbit-player.service

# Logger-Pattern (orbit-update.sh-Style)
ts() { date '+%Y-%m-%d %H:%M:%S'; }
log()  { local m; m="$(ts) [SETUP]  $*"; echo "$m" | tee -a "$LOG" >/dev/null;
         echo "[SETUP] $*"; logger -t "$TAG" "$*" 2>/dev/null || true; }
info() { local m; m="$(ts) [INFO]   $*"; echo "$m" | tee -a "$LOG" >/dev/null;
         echo "[INFO]  $*"; logger -t "$TAG" "$*" 2>/dev/null || true; }
warn() { local m; m="$(ts) [WARN]   $*"; echo "$m" | tee -a "$LOG" >/dev/null;
         echo "[WARN]  $*" >&2; logger -t "$TAG" "WARN: $*" 2>/dev/null || true; }
err()  { local m; m="$(ts) [FEHLER] $*"; echo "$m" | tee -a "$LOG" >/dev/null;
         echo "[FEHLER] $*" >&2; logger -t "$TAG" "FEHLER: $*" 2>/dev/null || true; }

# ---------- GPU-Treiber erkennen (vc4 vs i915) ----------
# Liest /sys/class/drm/card*/device/driver (Symlink-Ziel) — pykms-/X-frei,
# identisch zur Logik in orbit-player/drm_manager._find_drm_device.
# Echo: "i915" | "vc4" | "" (unbekannt/keine Karte).
detect_gpu_driver() {
    local link drv
    for link in /sys/class/drm/card*/device/driver; do
        [[ -L "$link" ]] || continue
        drv="$(basename "$(readlink -f "$link")")"
        case "$drv" in
            i915)    echo "i915"; return 0 ;;
            vc4|vc4-drm) echo "vc4"; return 0 ;;
        esac
    done
    echo ""
}

log "=== Setup-Session start ==="
info "Repo: $REPO"
info "TTY:  $(tty 2>/dev/null || echo unbekannt)"
info "User: $(whoami)"

GPU_DRIVER="$(detect_gpu_driver)"
info "GPU-Treiber: ${GPU_DRIVER:-unbekannt}"

# ---------- Backend-Modul nach Plattform waehlen (Kiosk-Seam, Phase 30 V-10) ----------
# Der i915-Stick (MINIX) faehrt den geforkten V2-Player und braucht die
# V2-wifi_setup-UI (Enterprise-802.1X + rotation=270). Der Pi/vc4 (DieFabrik)
# faehrt unveraendert das V1-Backend — er hat kein minix_player.V2-Paket. Die
# Modulwahl ist daher GPU-getrieben: i915 -> V2, sonst -> V1. So bleibt der
# vc4-Pfad funktional byte-identisch (startet weiter wifi_setup.backend) und der
# Stick bekommt automatisch das V2-Backend, ohne dass eine zweite on-device-Datei
# noetig ist. SUBDIR = das Verzeichnis fuer den Repo-Existenz-Pre-Check unten.
if [[ "$GPU_DRIVER" == "i915" ]]; then
    BACKEND_MODULE="minix_player.V2.wifi_setup.backend"
    BACKEND_SUBDIR="minix_player/V2/wifi_setup"
else
    BACKEND_MODULE="wifi_setup.backend"
    BACKEND_SUBDIR="wifi_setup"
fi
info "Backend-Modul: $BACKEND_MODULE (Subdir $BACKEND_SUBDIR)"

# ---------- Pre-Check 1: Port frei? ----------
if ss -lnt 2>/dev/null | grep -q "127.0.0.1:${PORT}"; then
    err "Port $PORT ist schon belegt (lokales Backend laeuft bereits?)."
    err "Bitte beende den anderen Prozess und versuche es erneut."
    exit 1
fi

# ---------- Pre-Check 2: Repo-Pfad existiert ----------
if [[ ! -d "$REPO/$BACKEND_SUBDIR" ]]; then
    err "Backend-Verzeichnis nicht gefunden unter $REPO/$BACKEND_SUBDIR"
    err "Deploy fehlt? Pruefe scripts/15-deploy-wifi-setup.sh (vc4) bzw. scripts/deploy-minix-v2.sh (i915)"
    exit 1
fi

# ---------- Backend starten (Background) ----------
log "Starte Flask-Backend auf 127.0.0.1:${PORT} (BG) ..."
# Wichtig: cwd = REPO damit Python 'wifi_setup' und 'orbit-player' findet.
# venv-Python verwenden, wenn vorhanden (enthaelt Flask/requests/websocket-client/boto3).
if [[ -x "$REPO/venv/bin/python3" ]]; then
    PY="$REPO/venv/bin/python3"
else
    PY=python3
fi
info "Python-Interpreter: $PY"
(
    cd "$REPO"
    "$PY" -m "$BACKEND_MODULE"
) >>"$BACKEND_LOG" 2>&1 &
BACKEND_PID=$!
info "Backend PID=$BACKEND_PID, Log=$BACKEND_LOG"

# ---------- DRM-Master-Freigabe abwarten (NUR i915; Player wird NICHT gestoppt) ----------
# MINIX-V2 (Phase 30, V-08): Der V2-Player gibt den DRM-Master bei Strg+Alt+F2
# SELBST frei (VT_PROCESS-Release in V2/core/boot.py). Dieses Skript laeuft auf
# tty2 — F2 ist also schon passiert. Wir stoppen den Player NICHT mehr (das war
# die Phase-20-Altlast, die den sauber pausierten V2-Player tötete). Stattdessen
# geben wir dem VT_PROCESS-Release einen kurzen Moment, sicher durch zu sein,
# bevor Xorg den Master auf card0 greift. Faengt der Player den Master nicht
# rechtzeitig frei (z.B. V1-Player ohne VT_PROCESS oder Switch noch nicht
# vollzogen), scheitert Xorg unten am belegten Master und wir loggen das klar —
# OHNE den Player zu stoppen (der hart-stoppende Pfad ist bewusst entfernt).
if [[ "$GPU_DRIVER" == "i915" ]]; then
    if systemctl is-active --quiet "$PLAYER_UNIT"; then
        info "i915: $PLAYER_UNIT laeuft — Player gibt DRM-Master via VT_PROCESS (F2) selbst frei."
        info "i915: warte kurz, bis drop_master auf card0 durch ist (KEIN Player-Stop) ..."
        # Best-effort-Wartefenster: der VT-Release-Tick (V2 boot.py VT_LOOP_TICK_MS)
        # liegt deutlich unter 1s; bis zu ~3s tolerant warten, falls der Switch
        # gerade erst kam. Nicht blockierend laenger — Xorg meldet selbst, falls
        # der Master noch belegt ist.
        sleep 2
        info "i915: Wartefenster fuer DRM-Master-Freigabe abgelaufen — starte Xorg."
    else
        info "i915: $PLAYER_UNIT laeuft nicht — card0-Master ohnehin frei, kein Warten noetig."
    fi
fi

# ---------- Verwaiste Kiosk-Reste abraeumen (DRM-Master fuer Player-Reacquire frei) ----------
# Bug blackscreen-f1-cli-haengt (2026-06-06): xinit/dbus-launch + chromium forken
# langlebige Enkel (dbus-daemon, chrome_crashpad_handler --monitor-self, Zygotes),
# die NICHT direkte Kinder dieser bash sind. Nach X-Ende koennen sie weiterleben und
# — kritischer — den DRM-Master auf card0 weiterhalten. MINIX-V2 (Phase 30): der
# durchgehend laufende Player nimmt den Master bei Strg+Alt+F1 via VT_PROCESS
# (set_master) zurueck — ein ueberlebender Kiosk-Enkel, der den Master haelt, laesst
# dieses set_master() scheitern. Vor dem (Re)Start der X-Session und im Cleanup daher
# gezielt abraeumen, damit der Player den Master ungehindert zurueckbekommt.
# Best-effort, nie blockierend.
reap_kiosk_leftovers() {
    local why="$1"
    # In aufsteigender Haerte: chromium (Kiosk), dann der von xinit gestartete
    # X-Server auf :1, dann der at-spi2-dbus-daemon dieser Setup-Session.
    # at-spi2-Pattern (on-device verifiziert 2026-06-06): die Session-Leiche ist
    # "dbus-daemon --config-file=/usr/share/defaults/at-spi2/..." — NICHT den
    # systemd-User-dbus ("--address=systemd:") oder den System-dbus treffen!
    pkill -TERM -u "$(id -u)" -f "user-data-dir=/tmp/orbit-wifi-setup-chrome-profile" 2>/dev/null || true
    pkill -TERM -u "$(id -u)" -f "Xorg(.real)? :1\b" 2>/dev/null || true
    pkill -TERM -u "$(id -u)" -f "X :1\b" 2>/dev/null || true
    pkill -TERM -u "$(id -u)" -f "dbus-daemon --config-file=/usr/share/defaults/at-spi2" 2>/dev/null || true
    sleep 1
    pkill -KILL -u "$(id -u)" -f "user-data-dir=/tmp/orbit-wifi-setup-chrome-profile" 2>/dev/null || true
    pkill -KILL -u "$(id -u)" -f "Xorg(.real)? :1\b" 2>/dev/null || true
    pkill -KILL -u "$(id -u)" -f "X :1\b" 2>/dev/null || true
    pkill -KILL -u "$(id -u)" -f "dbus-daemon --config-file=/usr/share/defaults/at-spi2" 2>/dev/null || true
    info "Kiosk-Reste abgeraeumt ($why)."
}

# ---------- Cleanup-Trap (immer) ----------
VT_WATCHER_PID=""
cleanup() {
    local rc=$?
    # VT-Watcher beenden (falls gestartet), sonst bleibt seine Poll-Schleife zurueck.
    [[ -n "$VT_WATCHER_PID" ]] && kill "$VT_WATCHER_PID" 2>/dev/null || true
    log "Cleanup: stoppe Backend (PID=$BACKEND_PID) ..."
    kill -TERM "$BACKEND_PID" 2>/dev/null || true
    # Bis 5s warten, dann KILL
    local i=0
    while kill -0 "$BACKEND_PID" 2>/dev/null && [[ $i -lt 10 ]]; do
        sleep 0.5; i=$((i+1))
    done
    if kill -0 "$BACKEND_PID" 2>/dev/null; then
        warn "Backend reagiert nicht auf SIGTERM, sende SIGKILL"
        kill -KILL "$BACKEND_PID" 2>/dev/null || true
    fi
    wait "$BACKEND_PID" 2>/dev/null || true
    # MINIX-V2 (Phase 30, V-08): Der Player wird NICHT mehr gestoppt/gestartet —
    # er lebt durchgehend und nimmt den DRM-Master bei Strg+Alt+F1 IN-PROZESS via
    # VT_PROCESS-Acquire (set_master) zurueck. Wir muessen hier nur sicherstellen,
    # dass keine verwaisten Kiosk-/X-/at-spi2-Reste den Master auf card0 weiter
    # halten — sonst scheitert das set_master() des Players bei F1. Daher auf i915
    # die Reste abraeumen (Best-effort), aber KEIN systemctl start.
    if [[ "$GPU_DRIVER" == "i915" ]]; then
        reap_kiosk_leftovers "Cleanup (i915: Master fuer Player-Reacquire bei F1 freiraeumen)"
        info "Cleanup: $PLAYER_UNIT NICHT neu gestartet (V2 lebt durchgehend, holt Master via F1/VT_PROCESS zurueck)."
    fi
    log "=== Setup-Session end (exit $rc) ==="
    exit $rc
}
trap cleanup EXIT INT TERM HUP

# ---------- Warten bis Backend bereit (Health-Check) ----------
info "Warte auf Backend-Health-Check ..."
for i in {1..20}; do
    if curl -fsS "http://127.0.0.1:${PORT}/api/health" >/dev/null 2>&1; then
        info "Backend bereit nach ${i} Versuchen"
        break
    fi
    sleep 0.5
done
if ! curl -fsS "http://127.0.0.1:${PORT}/api/health" >/dev/null 2>&1; then
    err "Backend nicht erreichbar nach 10s. Abbruch."
    err "Pruefe $BACKEND_LOG fuer Details."
    exit 1
fi

# ---------- VT-Watcher: Ctrl+Alt+F1 beendet die Setup-Session ----------
# Bug blackscreen-f1-cli-haengt, Schicht 2 (2026-06-06): Ctrl+Alt+F1 wechselt nur
# den VT — Xorg suspendiert lediglich (AIGLX "Suspending ... for VT switch") und
# laeuft mit Chromium auf vt2 einfach WEITER. xinit endet also nie von selbst ->
# cleanup unerreichbar -> der Kiosk haelt den DRM-Master, der durchgehend laufende
# Player (MINIX-V2) kann ihn bei F1 nicht via set_master() zuruecknehmen (Blackscreen).
# Chromium ignoriert auf dem suspendierten VT sogar SIGTERM (haengt beim X-Shutdown-
# Flush) — erst SIGKILL wirkt (on-device belegt). Daher: aktiven VT beobachten;
# sobald tty1 wieder aktiv ist, Kiosk-Session beenden (TERM->KILL via
# reap_kiosk_leftovers) -> xinit kehrt zurueck -> cleanup raeumt den Master frei ->
# der Player holt ihn via VT_PROCESS-Acquire (F1) IN-PROZESS zurueck.
ACTIVE_VT=/sys/class/tty/tty0/active
watch_vt_for_exit() {
    # Scharf erst, wenn die X-Session wirklich auf vt2 aktiv ist (xinit/Xorg
    # macht VT_ACTIVATE auf vt2) — sonst Fehlfeuer bei SSH-Start (aktiver VT
    # ist dann noch tty1) oder wenn X gar nicht hochkommt.
    local i=0
    while [[ $i -lt 60 ]]; do
        [[ "$(cat "$ACTIVE_VT" 2>/dev/null)" == "tty2" ]] && break
        sleep 1; i=$((i+1))
    done
    [[ "$(cat "$ACTIVE_VT" 2>/dev/null)" == "tty2" ]] || return 0
    while sleep 1; do
        if [[ "$(cat "$ACTIVE_VT" 2>/dev/null)" == "tty1" ]]; then
            log "Ctrl+Alt+F1 erkannt (tty1 aktiv) — beende Setup-Session."
            reap_kiosk_leftovers "F1/VT-Wechsel"
            return 0
        fi
    done
}
watch_vt_for_exit &
VT_WATCHER_PID=$!
info "VT-Watcher aktiv (PID=$VT_WATCHER_PID): Ctrl+Alt+F1 beendet das Setup."

# ---------- Xorg + Chromium starten (BLOCKIEREND) ----------
log "Starte Xorg + Chromium-Kiosk (xinit -- :1 vt2) ..."
info "TV-Display sollte in 5-15s die WLAN-Setup-Seite zeigen."
info "Zurueck zum Player: Ctrl+Alt+F1 (beendet das Setup automatisch)."

# WICHTIG: :1 = neue Display-Nummer, vt2 = explizite VT (Pitfall #2)
# -nolisten tcp = X11-Security (kein TCP-Listening), -keeptty = TTY nach Exit
#
# Ausgabe NICHT ueber `| tee` leiten (Bug blackscreen-f1-cli-haengt, 2026-06-06):
# xinit/dbus-launch + chromium forken langlebige Enkel (dbus-daemon,
# chrome_crashpad_handler --monitor-self, Zygotes). Diese erben das Schreib-Ende
# einer Vordergrund-Pipe und halten es nach X-Ende offen -> `tee` bekommt nie EOF
# -> die Vordergrund-Pipe kehrt NIE zurueck -> Cleanup/Player-Restart wird nie
# erreicht (Blackscreen auf tty1, Player bleibt gestoppt, bash haengt
# SIGTERM-fest in der blockierenden Pipe, weil der TERM-Trap erst nach Rueckkehr
# des Vordergrund-Befehls laufen kann). Ein direkter Datei-Redirect hat keinen
# Pipe-Partner, auf den gewartet wird: ueberlebende Enkel halten dann nur noch
# das geerbte FD der LOG-DATEI offen (blockiert nichts). xinit selbst kehrt
# zurueck, sobald sein direktes Kind (chromium via exec) endet.
xinit "$REPO/scripts/wifi-setup-kiosk.sh" -- :1 vt2 -nolisten tcp -keeptty \
    >>"$LOG" 2>&1 || true

# Wenn xinit endet, faellt das Script in die Cleanup-Trap (oben)
log "Chromium-Kiosk beendet. Bitte Ctrl+Alt+F1 zum Player zurueck."
