docs: define update status reporting
This commit is contained in:
@ -42,3 +42,7 @@ Beispiel:
|
||||
## Constraints
|
||||
- Update-Service ist extern (update.wlkns.org).
|
||||
- Service muss als root stoppen/starten koennen.
|
||||
|
||||
## Status Reporting
|
||||
- Status wird per HTTP POST an `https://update.wlkns.org/status` gemeldet.
|
||||
- Schema siehe `docs/update-status.md`.
|
||||
|
||||
25
docs/update-status.md
Normal file
25
docs/update-status.md
Normal file
@ -0,0 +1,25 @@
|
||||
ID: DOC_000005 | Version: 0.1.0 | Status: Draft
|
||||
By: Codex (GPT-5)
|
||||
|
||||
# Update Status Reporting
|
||||
|
||||
## Purpose
|
||||
Definiert das Status-Schema fuer Update-Resultate und den Uebertragungsweg.
|
||||
|
||||
## Status Schema (JSON)
|
||||
```json
|
||||
{
|
||||
"device_id": "<hostname>",
|
||||
"version": "0.1.2",
|
||||
"status": "success|failed",
|
||||
"error": "<optional message>",
|
||||
"timestamp": "2025-12-28T12:34:56Z"
|
||||
}
|
||||
```
|
||||
|
||||
## Transport
|
||||
- HTTP POST an `https://update.wlkns.org/status`
|
||||
- Auth: Bearer Token (`SKD_UPDATE_TOKEN`)
|
||||
|
||||
## Notes
|
||||
- Statusmeldungen sind best-effort; Fehler beim Senden blockieren kein Update.
|
||||
Reference in New Issue
Block a user