HMS MediaEngine Agent
c4574927fd
- hms_cluster: ClusterMessage (§6.5: Pflichtfelder, Sequenzen, Revisionen, execute_at, Trace-ID), CommandTracker (idempotent, vorwärts-only: accepted->armed->executed/failed) - NodeRegistry: online/degraded/stale/offline über Schwellen, UI-Kategorien discovered/paired/unknown/incompatible/offline, Doppel-Node-ID blockiert, IP-Wechsel erhaelt node_id (§6.3, §6.5) - Pairing: PIN (TTL 120s, Versuchslimit), Fingerprint (SHA-256 gruppiert), Token nur als Hash, Scopes read/control/content_sync/admin, Ablauf + sofortiger Widerruf (§6.3, §27.1, ADR-0010) - Discovery-Modell: _hmsmedia._tcp.local. TXT ohne Secrets, Capability- Digest, persistente manuelle Fallback-Liste (ADR-0009) - ADR-0009 (mDNS + Fallback) und ADR-0010 (Paarung) dokumentiert - 25 Unit-Tests; Gesamtsuite 183 Tests gruen, Ruff gruen
29 lines
1.2 KiB
Markdown
29 lines
1.2 KiB
Markdown
# Architecture Decision Records
|
||
|
||
Vorlage: `_template.md`. Nummerierung fortlaufend. Abweichungen vom Bauplan nur
|
||
mit ADR und Freigabe (PLAN.md §1).
|
||
|
||
## Angenommen
|
||
|
||
- ADR-0001: Python-Version-Pin 3.13
|
||
- ADR-0002: GStreamer-Pin 1.28.6 (Windows)
|
||
- ADR-0003: IPC – lokales TCP + length-prefixed MessagePack v1
|
||
- ADR-0008: Build-first-Strategie – verzögerte Hardware-Validierung
|
||
(Auftraggeber-Freigabe 2026-09-11)
|
||
- ADR-0009: Node-Discovery – mDNS/DNS-SD mit manueller Fallback-Liste
|
||
- ADR-0010: Node-Paarung – PIN/Fingerprint, Token-Scopes, Widerruf
|
||
|
||
## Vorläufig angenommen (Bestätigung im Windows-Durchlauf, ADR-0008)
|
||
|
||
- ADR-0004: Nativer Renderkern – Rust auf dem GStreamer-D3D11-Elementpfad
|
||
- ADR-0005: Packaging – Nuitka Onefolder (Fallback PyInstaller)
|
||
|
||
## Offen
|
||
|
||
- ADR-0006: Frontend – React vs. Svelte (Entscheidung zu Beginn Phase 5)
|
||
- ADR-0007: Typprüfung – mypy vs. pyright
|
||
- weitere gemäß Bauplan §32 (Persistenz → erledigt in Phase 1 ohne eigene
|
||
ADR-Nummer, da §24-Vorgaben 1:1 umgesetzt; Preview, Show-Codec, Ownership,
|
||
Display-Abstraktion, Adaptive-Quality-Policy, Clusterprotokoll-Transport,
|
||
TLS-Details, Clock-Sync, UI-Design-Tokens)
|