HMS MediaEngine Agent
9536e08748
- ADR-0008: Build-first, gesammelte Windows-Validierung (Auftraggeber-Freigabe) - ADR-0004 vorläufig: Rust auf GStreamer-D3D11-Elementpfad - ADR-0005 vorläufig: Nuitka Onefolder - hms_protocol: IpcServer/IpcClient mit Handshake (hello/welcome), Capabilities-Austausch, Heartbeat 500 ms bidirektional, Snapshot/Delta, Loopback-only-Enforcement, Re-Sync nach Reconnect, Version-Mismatch-Fehler - 9 Integrationstests: echter TCP-Loopback, kein Mock
54 lines
2.2 KiB
Markdown
54 lines
2.2 KiB
Markdown
# ADR-0008: Build-first-Strategie – verzögerte Hardware-Validierung
|
||
|
||
- **Status:** Angenommen (Auftraggeber-Freigabe)
|
||
- **Datum:** 2026-09-11
|
||
- **Phase:** 0/1 (übergreifend)
|
||
- **Bauplan:** §1, §1.1 Nr. 1/9/10, §29.7, §36 Nr. 16
|
||
|
||
## Kontext
|
||
|
||
Die Entwicklungsumgebung ist ein CPU-only-Linux-Container ohne Windows-GPU.
|
||
Der Auftraggeber wünscht am 2026-09-11 ausdrücklich: „erst fertig bauen und dann
|
||
auf Windows testen". PLAN.md §1 erlaubt Abweichungen vom normativen Ablauf,
|
||
wenn sie per ADR dokumentiert, technisch begründet und vom Auftraggeber
|
||
freigegeben werden. Diese Freigabe liegt mit der Anfrage vor.
|
||
|
||
## Entscheidung
|
||
|
||
1. Die Phasen 1–5 werden **plattformneutral vollständig gebaut** (Code, Tests
|
||
auf CPU-Ebene, Schemas, Dokumentation), bevor Hardwaremessungen stattfinden.
|
||
2. Gate 0 und alle renderer-nahen Abnahmen werden **gesammelt in einem
|
||
Windows-Durchlauf** nachgeholt (reverse validation). Reihenfolge dort:
|
||
Portabilität → Decode/Residenz → Framezeit/DMX-Latenz → Adaptive Quality →
|
||
Golden Images → Onefolder-Build.
|
||
3. Kein Gate wird vorher als grün gemeldet; STATUS.md führt die ausstehende
|
||
Hardware-Validierung offen als Checkliste.
|
||
|
||
## Alternativen
|
||
|
||
- Streng planmäßig (Gate 0 zuerst): sicherer, aber ohne Windows-Zugang blockiert;
|
||
vom Auftraggeber verworfen.
|
||
- Windows-Cloud-VM in der Entwicklungsumgebung: hier nicht verfügbar.
|
||
|
||
## Folgen und Risiken
|
||
|
||
- ADR-0004/0005 müssen ohne Messdaten vorläufig entschieden werden →
|
||
ausdrücklicher Bestätigungsvorbehalt für den Windows-Durchlauf.
|
||
- Der D3D11-Elementpfad bleibt bis dahin unvalidiert. Absicherung: der
|
||
Backend-Vertrag (§12.6) hält Korrekturen im Adapter lokal; Projekt-,
|
||
Parameter-, DMX- und Web-API ändern sich nicht.
|
||
- Shader werden nur statisch bereitgestellt; Compile- und Golden-Image-Tests
|
||
entstehen im Windows-Durchlauf.
|
||
- Fällt Gate 0 rot aus: gezielte Sanierung nach §1.1 Nr. 9 mit ERRORS.md-Eintrag;
|
||
kein Architektur-Neubau erforderlich (Vertragsabsicherung).
|
||
|
||
## Messwerte / Nachweise
|
||
|
||
- CPU-Ebene: pytest/Ruff grün je Etappe (TEST_REPORT.md, fortlaufend).
|
||
- Hardware: ausstehend; Checkliste in STATUS.md.
|
||
|
||
## Freigabe
|
||
|
||
Auftraggeber: per Chat-Anfrage 2026-09-11 („erst fertig bauen und dann auf
|
||
Windows testen") – hiermit dokumentiert.
|