update

.planer/einheiten/backend__tft__paths.py.md

@@ -0,0 +1,50 @@
+# Einheiten: backend/tft/paths.py
+stand: f41ac76b5789
+
+## backend/tft/paths.py::static_dir
+beschreibung: Liefert den Pfad zum Verzeichnis der statischen Daten für ein bestimmtes Set und einen Patch.
+input: `set_number: int`, `patch: str`
+output: Pfad zu `STATIC / f"set{set_number}_{patch}"`.
+entscheidungen:
+- Der Verzeichnisname kombiniert Set-Nummer und Patch durch einen Unterstrich.
+  beleg: "return STATIC / f\"set{set_number}_{patch}\""
+- Der Pfad wird relativ zum vordefinierten STATIC-Wurzelverzeichnis gebildet.
+  beleg: "STATIC = DATA / \"static\""
+kanten:
+- nutzt: backend/tft/paths.py::STATIC
+
+## backend/tft/paths.py::latest_static_pointer
+beschreibung: Liefert den Pfad zur Pointer-Datei, die auf den aktuellsten statischen Datenstand verweist.
+input: keine Parameter
+output: Pfad zu `STATIC / "latest.json"`.
+entscheidungen:
+- Der aktuellste Datenstand wird über eine zentrale `latest.json`-Datei markiert.
+  beleg: "return STATIC / \"latest.json\""
+- Die Funktion kapselt den Pfad zur Latest-Pointer-Datei als eigene Einheit.
+  beleg: "def latest_static_pointer() -> Path:"
+kanten:
+- nutzt: backend/tft/paths.py::STATIC
+
+## backend/tft/paths.py::artifact_dir
+beschreibung: Liefert den Pfad zum Artefakt-Verzeichnis eines Sets zu einem bestimmten Build-Datum.
+input: `set_number: int`, `build_date: str`
+output: Pfad zu `ARTIFACTS / f"set{set_number}" / build_date`.
+entscheidungen:
+- Artefakte werden zweistufig organisiert: erst nach Set-Nummer, dann nach Build-Datum.
+  beleg: "return ARTIFACTS / f\"set{set_number}\" / build_date"
+- Der Pfad wird relativ zum vordefinierten ARTIFACTS-Wurzelverzeichnis gebildet.
+  beleg: "ARTIFACTS = DATA / \"artifacts\""
+kanten:
+- nutzt: backend/tft/paths.py::ARTIFACTS
+
+## backend/tft/paths.py::latest_artifact_pointer
+beschreibung: Liefert den Pfad zur Pointer-Datei des aktuellsten Artefakt-Builds für ein bestimmtes Set.
+input: `set_number: int`
+output: Pfad zu `ARTIFACTS / f"set{set_number}" / "latest.json"`.
+entscheidungen:
+- Pro Set existiert eine eigene `latest.json` als Pointer auf den aktuellsten Build.
+  beleg: "return ARTIFACTS / f\"set{set_number}\" / \"latest.json\""
+- Der Set-spezifische Latest-Pointer liegt innerhalb des Set-Unterordners.
+  beleg: "ARTIFACTS / f\"set{set_number}\""
+kanten:
+- nutzt: backend/tft/paths.py::ARTIFACTS