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
commit 0922cc1d68
133 changed files with 7939 additions and 0 deletions
@@ -0,0 +1,111 @@
+"""Portable Pfadregeln (PLAN.md §9, §9.1).
+
+- Alle Pfade relativ zum Anwendungsroot; keine Laufwerksbuchstaben.
+- Keine Abhängigkeit vom Working Directory.
+- Temporäre Dateien in userdata/cache, nicht im OS-Profil.
+- Schreibbarkeit wird beim Start geprüft (Read-only-Modus folgt Phase 1).
+"""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass(frozen=True)
+class AppPaths:
+    """Alle portablen Pfade je Anwendungsroot (§9-Struktur)."""
+
+    root: Path
+
+    @property
+    def app(self) -> Path:
+        return self.root / "app"
+
+    @property
+    def runtime(self) -> Path:
+        return self.root / "runtime"
+
+    @property
+    def gstreamer_bin(self) -> Path:
+        return self.runtime / "gstreamer" / "bin"
+
+    @property
+    def gstreamer_plugins(self) -> Path:
+        return self.runtime / "gstreamer" / "lib" / "gstreamer-1.0"
+
+    @property
+    def web(self) -> Path:
+        return self.root / "web"
+
+    @property
+    def projects(self) -> Path:
+        return self.root / "projects"
+
+    @property
+    def media(self) -> Path:
+        return self.root / "media"
+
+    @property
+    def userdata(self) -> Path:
+        return self.root / "userdata"
+
+    @property
+    def database(self) -> Path:
+        return self.userdata / "database"
+
+    @property
+    def cache(self) -> Path:
+        return self.userdata / "cache"
+
+    @property
+    def identity(self) -> Path:
+        return self.userdata / "identity" / "node_id"
+
+    @property
+    def config(self) -> Path:
+        return self.root / "config"
+
+    @property
+    def logs(self) -> Path:
+        return self.root / "logs"
+
+    def ensure_writable(self) -> bool:
+        """Prüft Schreibbarkeit des Roots (§9.1)."""
+        probe = self.root / ".write_probe"
+        try:
+            probe.write_text("ok", encoding="ascii")
+            probe.unlink()
+            return True
+        except OSError:
+            return False
+
+    def portable_environment(self) -> dict[str, str]:
+        """Umgebungsvariablen für gebündelte GStreamer-Runtime (§9.2, ADR-0002).
+
+        System-Plugins werden unterdrückt (leerer GST_PLUGIN_SYSTEM_PATH_1_0),
+        damit ausschließlich die gebündelte, manifestierte Untermenge lädt.
+        """
+        env = dict(os.environ)
+        gs_bin = self.gstreamer_bin
+        if gs_bin.is_dir():
+            path_var = "PATH"
+            existing = env.get(path_var, "")
+            env[path_var] = f"{gs_bin}{os.pathsep}{existing}" if existing else str(gs_bin)
+        env["GST_PLUGIN_PATH_1_0"] = str(self.gstreamer_plugins)
+        env["GST_PLUGIN_SYSTEM_PATH_1_0"] = ""
+        return env
+
+
+def resolve_app_root(start_from: Path | None = None) -> Path:
+    """Bestimmt den Anwendungsroot anhand der PORTABLE_MODE-Markierung (§9).
+
+    Sucht vom gegebenen Pfad (Default: dieses Paket) aufwärts nach der
+    Datei PORTABLE_MODE; im Entwickungsbaum ist das Repo-Root gemeint.
+    """
+    current = Path(start_from or __file__).resolve()
+    for candidate in [current, *current.parents]:
+        if (candidate / "PORTABLE_MODE").is_file() or (candidate / "pyproject.toml").is_file():
+            return candidate
+    raise RuntimeError("app root not found (PORTABLE_MODE or pyproject.toml missing)")