E-Planung -> Layout: e_planning.py, scl_skeleton --eplan, Kapitel Daten

- doc/Klassenhierarchie.md: Kapitel "Daten" - alle Daten der SCL-Referenzen
  nach Quelle (Layout, E-Planung, Namenskonvention, Parameter)
- doc/E-Planung_Bruecke.md: Bruecke ueber *_positionsdraw.json des
  Kabellaengen-Tools, Befunde an Mubea
- lib/e_planning.py + cfg/e_planning.ini + bin/e_planning.bat/.sh:
  Lagebezug E-Zeichnung -> CSV, Zuordnung BMK -> Layout-Bauteil nach Regeln
  (Abstand, Sollabstand, Nummernregel MB = BG + 1), <csv>_eplan.json + Bericht
- scl_skeleton --eplan: Separator-Sensor und Stopperventil eingesetzt,
  ohne Schalter unveraenderte Ausgabe (Golden-Files gleich)
- tests/test_e_planning.py

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

lib/scl_context.py

@@ -16,8 +16,11 @@ Schichten:
 
 Namen (Separator-, Weichen-, MainTro-Nummer, Adressen ...) sind ein
 :class:`SclName`: Wert plus Merker, ob er noch aus der E-Planung kommen muss.
-Heute sind alle Platzhalter mit ``todo=True``; die Namensregeln aus Schritt 4
-(cfg/scl_naming.ini) ersetzen dann nur den Wert und loeschen den Merker.
+Ohne E-Planung sind alle Platzhalter ``todo=True``. Mit einer Zuordnung aus
+lib/e_planning.py (``eplan``) werden Separator-Sensor und Stopperventil der
+zugeordneten Separatoren eingesetzt und ``todo`` geloescht; alles andere
+bleibt offen. Die Namensregeln aus Schritt 4 (cfg/scl_naming.ini) arbeiten
+spaeter genauso: Wert ersetzen, Merker loeschen.
 """
 
 from __future__ import annotations
@@ -25,12 +28,16 @@ from __future__ import annotations
 import re
 from collections import deque
 from datetime import datetime
+from typing import TYPE_CHECKING
 
 from pydantic import BaseModel, ConfigDict, Field
 
 from model import TroBase, TroDocument
 from tro_catalog import TroItem
 
+if TYPE_CHECKING:
+    from e_planning import EplanDocument
+
 __all__ = [
     "TODO",
     "SclName",
@@ -65,6 +72,16 @@ def _offen(platzhalter: str) -> SclName:
     return SclName(value=platzhalter, todo=True)
 
 
+def _bekannt(wert: str) -> SclName:
+    return SclName(value=wert, todo=False)
+
+
+# Rolle in e_planning.ini -> wie der Name in der SCL geschrieben wird
+# (Sensor als Konstante der DB_Inputs-Sensorliste, Ventil als Variable)
+_SENSOR = "cIn{bmk}"
+_VENTIL = "{bmk}"
+
+
 class SclSeparator(BaseModel):
     """Ein stInSeparator<n>-Block."""
 
@@ -183,6 +200,8 @@ class SclFile(BaseModel):
     created: str
     start_reason: str
     tros: list[SclTro] = Field(default_factory=list)
+    # Zuordnung zur E-Planung, aus der Namen eingesetzt wurden ("" = keine)
+    eplan_source: str = ""
 
 
 # ---------------------------------------------------------------------------
@@ -282,7 +301,21 @@ def _nummer(tro_id: str) -> str:
 # Kontext bauen
 # ---------------------------------------------------------------------------
 
-def _tro_context(tro: TroBase, alle: dict[str, TroBase]) -> SclTro:
+def _separator(i: int, layout: str, eplan: EplanDocument | None) -> SclSeparator:
+    rollen = eplan.for_layout(layout) if eplan is not None and layout != "?" else {}
+    sensor = rollen.get("sensor")
+    stopper = rollen.get("stopper")
+    return SclSeparator(
+        n=i,
+        layout=layout,
+        no=_offen("cSep_____"),
+        sensor=_bekannt(_SENSOR.format(bmk=sensor.bmk)) if sensor else _offen("cInBG____"),
+        stopper=_bekannt(_VENTIL.format(bmk=stopper.bmk)) if stopper else _offen("MB____"),
+    )
+
+
+def _tro_context(tro: TroBase, alle: dict[str, TroBase],
+                 eplan: EplanDocument | None = None) -> SclTro:
     items = tro.items
     n_sep = items.get(TroItem.SEPARATOR, 1)
     n_swi = items.get(TroItem.SWITCH, 0)
@@ -291,13 +324,7 @@ def _tro_context(tro: TroBase, alle: dict[str, TroBase]) -> SclTro:
     jam_db = '"DB_JamArea____".stJam____'
 
     separators = [
-        SclSeparator(
-            n=i,
-            layout=tro.separators[i - 1] if i <= len(tro.separators) else "?",
-            no=_offen("cSep_____"),
-            sensor=_offen("cInBG____"),
-            stopper=_offen("MB____"),
-        )
+        _separator(i, tro.separators[i - 1] if i <= len(tro.separators) else "?", eplan)
         for i in range(1, n_sep + 1)
     ]
     switches = [
@@ -371,13 +398,20 @@ def _tro_context(tro: TroBase, alle: dict[str, TroBase]) -> SclTro:
 
 
 def build_context(document: TroDocument, source: str, start_id: str = "",
-                  created: str | None = None) -> SclFile:
-    """TroDocument -> SclFile (TROs in Fliessrichtung)."""
+                  created: str | None = None,
+                  eplan: EplanDocument | None = None) -> SclFile:
+    """TroDocument -> SclFile (TROs in Fliessrichtung).
+
+    eplan: Zuordnung Layout -> E-Planung (e_planning.py); ohne sie bleiben
+    alle Namen offen und die Ausgabe ist die bisherige.
+    """
     alle = {t.tro_id: t for t in document.tros}
     geordnet, startgrund = flow_order(document.tros, start_id)
     return SclFile(
         source=source,
         created=created or datetime.now().strftime("%Y-%m-%d %H:%M"),
         start_reason=startgrund,
-        tros=[_tro_context(t, alle) for t in geordnet],
+        tros=[_tro_context(t, alle, eplan) for t in geordnet],
+        eplan_source=(f"{eplan.eplan_file} (Zuordnung vom {eplan.created})"
+                      if eplan is not None else ""),
     )