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.
|