Files

T

HMS MediaEngine Agent 0922cc1d68 Phase 0: Repository-Initialisierung nach Bauplan v1.2

- Struktur gemäß §8 (Eigentumsgrenzen), PLAN.md als normative Basis
- Pflichtdokumente: STATUS.md, ERRORS.md, TEST_REPORT.md, CHANGELOG.md, ADRs
- ADR-0001 Python 3.13-Pin, ADR-0002 GStreamer 1.28.6-Pin (Windows),
  ADR-0003 IPC TCP+MessagePack v1
- Kernpakete: hms_protocol, hms_domain, hms_parameter, hms_artnet,
  hms_adaptive, hms_capabilities, hms_plugin_sdk
- Renderer-Spike: D3D11-Primärpfad + Dev-GL-Pfad (§36 Nr. 4-5)
- Control Core: FastAPI REST + WebSocket (§36 Nr. 9)
- Beispielplugins: Passthrough + Gaussian Blur (3 Adaptive-Quality-
  Varianten, HLSL/GLSL/GLES)
- Tools: Art-Net-Emulator, Fixture-Generator (Master32/Layer64-CSV),
  Capability-Probe
- JSON-Schemas: IPC, Plugin, Projekt, Cluster
- 121 Unit-/Integrationstests grün, Ruff grün

Gate 0 bleibt offen: Hardwaremessungen nur auf echter Windows-Referenz-
hardware gültig (§29.7, §33).

2026-09-11 00:36:59 +02:00

1.9 KiB

Raw Blame History

Architekturüberblick (Phase 0)

Verbindliche Referenz: PLAN.md. Diese Seite fasst Prozess- und Besitzgrenzen zusammen.

Prozesse (§6.1)

Prozess	Technologie	Aufgabe
Launcher/Supervisor	Python (Phase 1)	Start, Portwahl, portable Pfade, Heartbeat, kontrolliertes Beenden
Control Core	Python, asyncio, FastAPI, Pydantic, SQLite/WAL (ab Phase 1)	autoritativer Zustand, REST/WS, Art-Net, Persistenz
Render Worker	Python-Orchestrator + GStreamer + nativer Renderkern (ADR-0004 offen)	Decode, GPU-Compositing, Ausgabe, Telemetrie
Web-Frontend	TypeScript, Vite (Phase 5, ADR-0006 offen)	Bedienoberfläche; niemals Videoausgang (§3.2)

Besitzgrenzen (§8)

Jedes Paket hat eindeutige hms_*-Namen; kein Quereinbau zwischen packages/*.
Control Core und Renderer verbinden ausschließlich über das versionierte IPC (ADR-0003).
Der Renderer erhält pro Frame einen unveränderlichen Parametersnapshot (§11.4).

Kernregeln (§33, Auszug)

Python steuert, decodiert nicht und rendert keine Pixel.
Windows: D3D11Memory durchgängig; kein CPU-Rundweg im Normalpfad.
Plugins: versioniertes Manifest, kein Datei-/DB-Zugriff, Quarantäne bei Fehler.
Alle Steuerquellen (Browser, Art-Net, später Timeline/Audio/KI) laufen über die zentrale Parameter-Engine.

Steuerfluss Phase 0

Lichtpult/Emulator → ArtDMX (UDP 6454) → hms_artnet.receiver
    → Control Core (hms_parameter.engine: Priorität CONSOLE)
    → IPC-Snapshot → Renderer (GStreamer-D3D11) → Opacity/Parameter an Frame-Grenze

Browser → REST/WebSocket → derselbe Command-/Parameter-Pfad (Priorität WEB)

Beide Quellen adressieren denselben Parametersatz; es gibt genau eine autoritative Instanz (Control Core).

Phase-0-Spike

hms_renderer definiert die Pipelines als Launch-Strings; Ausführung und Messung erfolgen auf Referenz-Windows-Hardware (Gate 0). Messprotokoll: TEST_REPORT.md.

1.9 KiB Raw Blame History