31 lines
845 B
Markdown
31 lines
845 B
Markdown
ID: DOC_000005 | Version: 0.2.2 | Status: Draft
|
||
Archived – superseded by new documentation.
|
||
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.
|