docs: define update service url

This commit is contained in:
2025-12-28 22:57:37 +01:00
parent 2d1ca05bf0
commit 3caff1f6e2
3 changed files with 62 additions and 0 deletions

View File

@ -0,0 +1,41 @@
ID: EPIC_000008 | Version: 0.1.0 | Status: Draft
By: Codex (GPT-5)
# EPIC_000008: Client-Side Update Mechanism
## Beschreibung
Der Kiddo-Client kann Updates aus einer zentralen Quelle beziehen, verifizieren und anwenden.
## Ziel / Business Value
Schnelle, sichere Aktualisierung ohne SSH-Zugriff auf Zielgeraete.
## Mission Statement
Ermoegliche einen robusten Client-Update-Flow mit Verifikation und Rollback.
## Business Value & Metriken
- Reduzierter manueller Update-Aufwand.
- Erfolgsmetrik: Update kann automatisiert und nachvollziehbar erfolgen.
## In-Scope
- Client zieht Update-Artefakte (Pull-Modell).
- Verifikation (Checksum/Signatur).
- Atomare Anwendung und Rollback bei Fehlern.
- Statusreporting vom Client.
## Out-of-Scope
- Aufbau/Betrieb des zentralen Update-Webservice.
- Release-Publishing/CI/CD und Artefakt-Hosting.
- Service-Monitoring und Verfuegbarkeit des Update-Backends.
## High-Level Akzeptanzkriterien
- Client kann Updates erkennen, verifizieren und anwenden.
- Fehler fuehren zu Rollback und klarer Statusmeldung.
## Technische Constraints & Risiken
- Abhaengigkeit von Update-Backend und Netzverfuegbarkeit.
- Update-Service wird unter `update.wlkns.org` erwartet.
## Zugeordnete User Stories
- US_000026: Client bezieht Updates (Pull)
- US_000027: Client verifiziert und wendet Updates an
- US_000028: Client meldet Update-Status

View File

@ -0,0 +1,18 @@
ID: US_000026 | Version: 0.1.0 | Status: Draft
By: Codex (GPT-5)
# US_000026: Client bezieht Updates (Pull)
Status: Draft
Als Betreiber moechte ich, dass der Client Updates per Pull von einem Update-Service bezieht, damit Deployments ohne SSH moeglich sind.
## Akzeptanzkriterien
- Given eine konfigurierte Update-URL (`https://update.wlkns.org`) und Auth-Credentials
- When der Client nach Updates fragt
- Then erhaelt er ein JSON-Manifest mit Version, Artefakt-URL und Checksumme
- And das Artefakt ist ein `tar.gz`
- And die Update-Quelle ist austauschbar per Konfiguration
## Task-Platzhalter
- TASK_000027: Update endpoint config (Details bei Story-Start)