170 lines
7.0 KiB
Markdown
170 lines
7.0 KiB
Markdown
ID: STATUS_000001 | Version: 0.2.3 | Status: Final
|
|
By: Codex (GPT-5)
|
|
|
|
# Projekt-Status
|
|
|
|
## Vision
|
|
Sicheres, remote steuerbares System zum Sperren/Entsperren lokaler Nutzerkonten.
|
|
|
|
## Aktuelle Phase
|
|
✅ Stabilization
|
|
|
|
## Aktueller Fokus
|
|
1. OIDC-Validierung abschliessen (EPIC_000003 / US_000025).
|
|
2. Client-Update-Mechanik pflegen (EPIC_000008).
|
|
3. Anforderungen bei neuen Features sauber dokumentieren.
|
|
|
|
## Projekt-Tagebuch (Kurz, optional)
|
|
| Datum | Typ | Beschreibung |
|
|
|---|---|---|
|
|
| 28.12.2025 | 🏗️ Planning | Anforderungen als Epics und Stories dokumentiert. |
|
|
| 15.01.2026 | 📝 Req | Doku und ENV-Beispiele an Code-Stand angepasst. |
|
|
| 15.01.2026 | 📝 Req | Doku-Overhaul mit neuer Struktur und Archivierung. |
|
|
| 15.01.2026 | 📝 Req | Externe Service-Links in der Doku ergaenzt. |
|
|
| 15.01.2026 | 📝 Req | Makefile als Einstieg in Doku aufgenommen. |
|
|
| 15.01.2026 | ⚙️ Code | Makefile restart-Target hinzugefuegt. |
|
|
|
|
## 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
|
|
- [x] US_000024: Watchtower Theme fuer Web-UI
|
|
- [x] TASK_000024: Apply Watchtower theme
|
|
|
|
### 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
|
|
- [x] US_000026: Client bezieht Updates (Pull)
|
|
- [x] TASK_000027: Update endpoint config
|
|
- [x] US_000027: Client verifiziert und wendet Updates an
|
|
- [x] TASK_000028: Verify and apply update
|
|
- [x] US_000028: Client meldet Update-Status
|
|
- [x] TASK_000029: Report update status
|
|
- [x] US_000029: Update-Status im Web-UI anzeigen
|
|
- [x] TASK_000030: UI update status view
|
|
- [x] US_000030: Update-Check im Web-UI ausloesen
|
|
- [x] TASK_000031: UI update check trigger
|
|
- [x] US_000031: Update im Web-UI anstossen
|
|
- [x] TASK_000032: UI update apply action
|
|
- [x] US_000032: Update-Logs im Web-UI anzeigen
|
|
- [x] TASK_000033: UI update logs view
|
|
- [x] US_000033: Rollback im Web-UI anstossen
|
|
- [x] TASK_000034: UI rollback action
|
|
- [x] US_000043: Enrollment-Token per Script abrufen
|
|
- [x] TASK_000049: Script fuer Enrollment-Flow erstellen
|
|
- [x] US_000046: Update-Service Erreichbarkeit anzeigen
|
|
- [x] TASK_000055: Endpoint und UI fuer Update-Service Status
|
|
- [x] US_000047: Update-Config auslagern
|
|
- [x] TASK_000056: Update-ENV separieren
|
|
- [x] US_000048: Release-Upload automatisieren
|
|
- [x] TASK_000057: Script fuer Release-Upload erstellen
|
|
- [x] US_000049: Lokale deployment.env fuer Update-Uploads
|
|
- [x] TASK_000058: deployment.env Beispiel und Script-Anpassungen
|
|
|
|
### EPIC_000009: Update Webservice (External Team)
|
|
- [x] US_000026: Client bezieht Updates (Pull)
|
|
- [x] US_000027: Client verifiziert und wendet Updates an
|
|
- [x] US_000028: Client meldet Update-Status
|
|
|
|
### EPIC_000010: Update-Service v1 Migration (Major Release)
|
|
- [x] US_000034: Enrollment fuer Langzeit-Token
|
|
- [x] TASK_000040: Enrollment-Flow implementieren
|
|
- [x] US_000035: v1 Update-Endpoints und Status-Schema
|
|
- [x] TASK_000041: v1 Endpunkte im Update-Client umstellen
|
|
|
|
### EPIC_000011: Documentation and Configuration Alignment
|
|
- [x] US_000036: Doku-Versionen auf VERSION synchronisieren
|
|
- [x] US_000037: Update-API-Doku mit /update/enroll abgleichen
|
|
- [x] US_000038: ENV-Beispiele und Healthcheck-Auth angleichen
|
|
- [x] US_000039: Doku-Audit fuer verbleibende Abweichungen
|
|
- [x] TASK_000042: Doku-Audit verbleibender Dateien
|
|
|
|
### EPIC_000012: Dokumentations-Overhaul
|
|
- [x] US_000040: Doku-Struktur und Inhalte erstellen
|
|
- [x] TASK_000043: Neue Doku-Dateien erstellen und verlinken
|
|
- [x] TASK_000044: Altdoku archivieren
|
|
- [x] US_000041: Einbindung externer Services dokumentieren
|
|
- [x] TASK_000045: Einbindung externer Services dokumentieren
|
|
- [x] US_000042: Consumer-Perspektive und Audience-Split ergaenzen
|
|
- [x] TASK_000046: Consumer-Doku erstellen (FOR_USERS.md)
|
|
- [x] TASK_000047: README und Audience-Split anpassen
|
|
- [x] TASK_000048: External Dependencies und Audience-Ergaenzungen
|
|
|
|
### EPIC_000013: System Telemetry im Dashboard
|
|
- [x] US_000044: Systemmetriken im Dashboard anzeigen
|
|
- [x] TASK_000050: Backend-Endpoint fuer Systemmetriken
|
|
- [x] TASK_000051: UI-Kacheln im Dashboard (System Information)
|
|
|
|
### EPIC_000014: Login-Zeitfenster und Parent-Control Regeln
|
|
- [ ] US_000045: Regeln fuer Login-Zeitfenster definieren und durchsetzen
|
|
- [ ] TASK_000052: Regelmodell und Speicherung definieren
|
|
- [ ] TASK_000053: Login-Pruefung und Enforcement
|
|
- [ ] TASK_000054: Admin-UI fuer Regeln und Scheduler
|
|
|
|
## 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.
|
|
- Doku-Audit fuer weitere Abweichungen priorisieren (wenn Zeitfenster frei).
|