30 lines
799 B
Markdown
30 lines
799 B
Markdown
ID: DOC_000005 | Version: 0.2.1 | Status: Draft
|
|
By: Codex (GPT-5)
|
|
|
|
# Update Status Reporting
|
|
|
|
## Purpose
|
|
Definiert das Status-Schema fuer Update-Resultate und den Uebertragungsweg.
|
|
|
|
## Status Schema (JSON)
|
|
```json
|
|
{
|
|
"project_id": "safe-kiddo-control",
|
|
"client_id": "<hostname>",
|
|
"version": "0.2.1",
|
|
"status": "success|failed|in_progress",
|
|
"timestamp": "2025-12-28T12:34:56Z",
|
|
"duration_ms": 1234,
|
|
"error_code": "<optional>",
|
|
"reason": "<optional>"
|
|
}
|
|
```
|
|
|
|
## Transport
|
|
- HTTP POST an `${SKD_UPDATE_SERVICE_URL}/v1/projects/${SKD_UPDATE_PROJECT_ID}/status`
|
|
- Auth: Bearer Token (`SKD_UPDATE_TOKEN` oder `SKD_UPDATE_TOKEN_FILE`)
|
|
|
|
## Notes
|
|
- Statusmeldungen sind best-effort; Fehler beim Senden blockieren kein Update.
|
|
- Reporting wird nur gesendet, wenn ein Update-Token vorhanden ist.
|