ID: STATUS_000001 | Version: 0.1.0 | Status: Final
By: Codex (GPT-5)

# Projekt-Status

## Vision
Sicheres, remote steuerbares System zum Sperren/Entsperren lokaler Nutzerkonten.

## Aktuelle Phase
✅ Stabilization

## Aktueller Fokus
1. Client-Update-Mechanik planen (EPIC_000008).
2. Dokumentierter Ist-Zustand der Module.
3. Pflege der Anforderungen bei neuen Features.

## Projekt-Tagebuch (Kurz, optional)
| Datum | Typ | Beschreibung |
|---|---|---|
| 28.12.2025 | 🏗️ Planning | Anforderungen als Epics und Stories dokumentiert. |

## Epic-Backlog (Uebersicht)
### EPIC_000001: Legacy CLI Account Control (sk.sh)
- [x] US_000001: Nutzerkonto per CLI deaktivieren
- [x] TASK_000001: Disable user countdown
- [x] US_000002: Nutzerkonto per CLI aktivieren
- [x] TASK_000002: Enable user account

### EPIC_000002: Backend API Service
- [x] US_000003: Health-Status abfragen
- [x] TASK_000003: Health response payload
- [x] US_000004: Verfuegbare Nutzer auflisten
- [x] TASK_000004: List users status
- [x] US_000005: Nutzer per API deaktivieren
- [x] TASK_000005: API disable action
- [x] US_000006: Nutzer per API aktivieren
- [x] TASK_000006: API enable action
- [x] US_000021: Konfiguration per ENV steuern
- [x] TASK_000021: ENV settings defaults

### EPIC_000003: Authentication & Sessions
- [x] US_000007: PAM-Login mit Token
- [x] TASK_000007: PAM login token
- [x] US_000008: OIDC-Login Flow
- [x] TASK_000008: OIDC auth callback
- [x] US_000009: Autorisierung und /me-Identitaet
- [x] TASK_000009: Authorization /me gate
- [ ] US_000025: OIDC End-to-End Validierung und Runbook
- [ ] TASK_000025: OIDC E2E validation
- [ ] TASK_000026: OIDC runbook update

### EPIC_000004: Web UI
- [x] US_000010: Index-Seite ausliefern
- [x] TASK_000010: Serve UI template
- [x] US_000022: Web-UI Aktionen ausfuehren
- [x] TASK_000022: UI login and actions
- [ ] US_000024: Watchtower Theme fuer Web-UI (zurueckgestellt)
- [ ] TASK_000024: Apply Watchtower theme (zurueckgestellt)

### EPIC_000005: Automation Scripts
- [x] US_000011: Virtualenv und Abhaengigkeiten erstellen
- [x] TASK_000011: Provision venv deps
- [x] US_000012: Service lokal starten
- [x] TASK_000012: Run uvicorn service
- [x] US_000013: Service installieren
- [x] TASK_000013: Install service setup
- [x] US_000014: Service aktualisieren
- [x] TASK_000014: Update service refresh
- [x] US_000015: Remote-Deployment durchfuehren
- [x] TASK_000015: Remote deploy package
- [x] US_000016: OIDC-Client registrieren
- [x] TASK_000016: OIDC client register
- [x] US_000020: Makefile-Automation bereitstellen
- [x] TASK_000020: Makefile ops targets

### EPIC_000006: Systemd & Deployment Artifacts
- [x] US_000017: Systemd-Unit im Repo
- [x] TASK_000017: Systemd unit template
- [x] US_000018: Konfigurations-Templates verfuegbar
- [x] TASK_000018: Config templates ready
- [x] US_000019: Deployment-Archiv vorhanden
- [x] TASK_000019: Deployment zip artifact

### EPIC_000007: Documentation & Runbook
- [x] US_000023: Runbook und Security-Hinweise dokumentieren
- [x] TASK_000023: README runbook notes

### EPIC_000008: Client-Side Update Mechanism
- [ ] US_000026: Client bezieht Updates (Pull)
- [ ] TASK_000027: Update endpoint config
- [ ] US_000027: Client verifiziert und wendet Updates an
- [ ] TASK_000028: Verify and apply update
- [ ] US_000028: Client meldet Update-Status
- [ ] TASK_000029: Report update status
- [ ] US_000029: Update-Status im Web-UI anzeigen
- [ ] TASK_000030: UI update status view
- [ ] US_000030: Update-Check im Web-UI ausloesen
- [ ] TASK_000031: UI update check trigger
- [ ] US_000031: Update im Web-UI anstossen
- [ ] TASK_000032: UI update apply action
- [ ] US_000032: Update-Logs im Web-UI anzeigen
- [ ] TASK_000033: UI update logs view
- [ ] US_000033: Rollback im Web-UI anstossen
- [ ] TASK_000034: UI rollback action

### EPIC_000009: Update Webservice (External Team)
- [ ] US_000026: Client bezieht Updates (Pull)
- [ ] US_000027: Client verifiziert und wendet Updates an
- [ ] US_000028: Client meldet Update-Status

## Offene Risiken / Abhaengigkeiten
- Betrieb erfordert Root/sudo und lokale System-Tools (notify-send, sound player, uvicorn).
- OIDC-Validierung blockiert bis IdP bereit und Service laeuft.
- Update-Service (update.wlkns.org) liegt ausserhalb des Kiddo-Scopes.

## Naechste Schritte
- Anforderungen beim naechsten Feature-Start erweitern.
- OIDC-Validierung abschliessen und US_000025 auf Done setzen.
- PR vorbereiten: feature/oidc-validation (Summary, Risiko, Testschritte).