# Voice-Agent — LXC-Frontend

FastAPI + statisches HTML/JS. Läuft im LXC-Container, stellt die Weboberfläche, verwaltet Jobs (SQLite) und ruft den Mac-Worker per HTTP an. Macht selbst **keine** AI-Verarbeitung.

## Lokal starten (Entwicklung)

```bash
cd lxc-frontend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# Für lokalen Test ohne Mac kann der Mac-Worker mit WHISPER_ENGINE=mock laufen
uvicorn app.main:app --reload --port 8000
```

Öffnen: http://localhost:8000

## Auf LXC deployen

`deploy/install.sh` macht alles: Repo klonen, venv anlegen, systemd-Service und Nginx einrichten. Siehe Haupt-`README.md`.

## API

| Methode | Pfad | Zweck |
|---|---|---|
| GET | `/` | Web-UI |
| GET | `/health` | LXC-Health |
| GET | `/api/mac/health` | Mac-Worker-Erreichbarkeit |
| GET | `/api/profiles` | Verfügbare Verarbeitungs-Profile (Cache 60 s) |
| POST | `/api/auth/login` / `logout` / `setup` | Cookie-Session-Auth |
| GET / PATCH | `/api/auth/me` | Eigener User + Standard-Profil |
| GET / POST / DELETE | `/api/admin/users[...]` | User-Verwaltung (admin) |
| POST | `/api/jobs` | multipart: `audio`, `title`, `profile` → Job anlegen |
| GET | `/api/jobs` | Liste aller Jobs (Owner-gefiltert; Admin sieht alle) |
| GET | `/api/jobs/{id}` | Job-Detail |
| POST | `/api/jobs/{id}/retry` | Verarbeitung neu anstoßen (Transkript bleibt) |
| GET | `/api/jobs/{id}/download/{kind}` | `kind` ∈ `docx`, `transcript`, `summary`, `protocol` |

## Benutzer- und Passwort-Verwaltung per CLI

Nach dem Deploy ist `/usr/local/bin/voice-agent-admin` verfügbar — ein Wrapper auf das Python-Modul `app.cli`. Funktioniert vom Root-Login aus jedem Verzeichnis.

```bash
# Alle User auflisten
sudo voice-agent-admin list

# Passwort eines Users zurücksetzen (z. B. Admin-Passwort vergessen)
sudo voice-agent-admin reset admin 'NeuesPasswort123'

# Neuen User anlegen
sudo voice-agent-admin create maria 'StartPasswort123'
sudo voice-agent-admin create chefin 'Geheim12345' --admin

# User zum Admin machen
sudo voice-agent-admin promote maria

# User löschen (geht nicht für den letzten Admin oder den eigenen Account)
sudo voice-agent-admin delete maria

# Passwort prüfen ohne Browser (für Debug)
sudo voice-agent-admin verify admin 'NeuesPasswort123'
# → "OK — Passwort für 'admin' stimmt." oder "NEIN — ..."
```

Mindest-Passwortlänge: 8 Zeichen. Der letzte Admin kann nicht gelöscht werden.

### Initialer Admin

Beim allerersten Web-Aufruf zeigt die UI das **Setup-Formular** statt des Logins (weil noch kein User existiert). Username + Passwort eingeben → erster Admin wird angelegt + alle bestehenden Jobs werden ihm zugeordnet.

Falls du den Erst-Admin lieber per CLI anlegen willst (z. B. Skript-gesteuert):

```bash
sudo voice-agent-admin create admin 'StartPasswort123' --admin
```

Danach im Browser direkt einloggen.

## Datenfluss

```
Upload → SQLite-Job → BackgroundTask
  → Mac: /api/transcribe (multipart)
  → Mac: /api/summarize (JSON)
  → Mac: /api/protocol (JSON)
  → Mac: /api/export/docx (JSON) → DOCX
→ Ergebnisse landen in /var/lib/voice-agent/results/{job_id}/
```