Files
dxfmakros/doc/todo/linienzug-ohne-gui.md
T
m.stangl 8db446ce0f feat: Linienzug-Batch-Konvertierung headless, alter Block bleibt bis zum Erfolg
- vfl-konvertiere-ent laeuft unter *vfl-headless* (Wizard/GUI aus): reicht
  ein Journal nicht, Abbruch mit Fundstelle statt Live-Rueckfrage im Batch
- alter VF_n-Block wird erst nach erfolgreichem Neubau geloescht; bei
  Fehlschlag raeumt vfl-konvert-aufraeumen die Teil-Geometrie weg
- SSG_DIM_ALL_2D/_3D listet fehlgeschlagene Bloecke am Ende auf und
  konvertiert jetzt auch Modus-3-Bloecke (linienzug3 wurde uebersprungen)
- statischer Headless-Test: vfl-menu-strwert/vflw-radio-wahl-impl erlaubt
- TODO: Stufe 2 und Spec-Uebersetzer Modus 2/3 in eigene Dateien ausgelagert

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 10:22:30 +01:00

4.6 KiB

TODO: VF-Linienzug ohne GUI/Konsole - Stufe 2 (Funktionstrennung)

Stand: 2026-10-26 · Prioritaet: niedrig - bringt Architektur, keine neue Funktion.

Herausgeloester Arbeitsauftrag aus dem Gesamtplan plan-vf-interactive.md (Teil 5 "Stufe 2: echte Funktionstrennung"). Dort stehen die ausfuehrliche Begruendung, die Knotenform und die Risikoliste; diese Datei ist die Abarbeitungsliste.

Ausgangslage (Stufe 1, fertig)

Linienzug-Ketten lassen sich bereits ohne Dialog bauen (VF_SPEC_BAU, vf_spec.lsp) - allerdings ueber einen Umweg:

  1. Die Spec (Kette in Domaenenwerten) wird von vsp-journal in ein Eingabe-Journal uebersetzt - also in die Antworten, die ein Anwender gegeben haette.
  2. vsp-bau-journal startet per vfl-journal-replay-start den ganz normalen interaktiven Bau vf-linienzug-modus (vf_linienzug.lsp).
  3. Jede Frage wird aus der Replay-Queue beantwortet.

Das funktioniert und ist per TEST_HUNDM05 im CAD verifiziert - der Bau selbst "weiss" aber nichts von Daten, er fragt weiter, nur antwortet die Queue.

Ziel (Stufe 2)

Die Funktionen in vf_linienzug.lsp mischen Fragen und Geometrie bauen. Stufe 2 trennt das:

  • reiner Bauteil (Suffix -bauen bzw. -setzen): nimmt Parameter, baut Geometrie, fragt nichts;
  • die Frage-Schale behaelt den bisherigen Namen und ruft den Bauteil auf
    • dadurch aendert sich keine Aufrufstelle in Modus 1/2/3.

Am Ende ruft vfl-spec-ausfuehren die Bauteile direkt mit den Spec-Werten auf, ohne Journal-Replay.

Stand der Schritte

Zeilennummern Stand 2026-10-26 (die :NNNN-Angaben im Gesamtplan sind veraltet).

Schritt Inhalt Stand
0 vfl-ziel-report (vf_linienzug.lsp:7864) aus zwei identischen Bloecken gezogen erledigt
1 Winkelwahl vfl-winkel-gueltige (:3071) / vfl-winkel-nach-index + Kanal *vfl-winkel-idx-vorgabe* erledigt
2 vfl-es-masse-setzen (:7557) erledigt
3 vfl-hor-koerper-bauen (:5989), Schale vfl-baue-horizontal-koerper (:6152) erledigt
4 vfl-body-abschluss-bauen (:6502) erledigt
5a/5b VF-Einheit Eingang/Ausgang: vfl-vf-eingang-bauen (:6728), vfl-vf-ausgang-bauen (:6742) erledigt
5c Schleifenrumpf von vfl-vf-einheit (:6772) - die Sub-Stuecke der VF-Einheit als Bauteil offen
6 Daten-Executor fuer die VF-Einheit (baut sie direkt aus Daten) offen
7 Spec + Serializer + Assertion: vsp-journal-diff (vf_spec.lsp:900) prueft Spec-Journal gegen das beim Bau aufgezeichnete Token fuer Token Assertion erledigt
8 Einheit-Abschluss: vfl-vf-einheit-abschluss (:7889) offen
9 Kettenebene, ein Glied-Zweig pro Commit: GF-Bogen -> ES -> Horizontal-VF -> Linie-GF -> Linie-VF -> Linie offen
10 vfl-spec-ausfuehren - der direkte Daten-Pfad (existiert noch nicht) offen
11 Dasselbe fuer Modus 2 zurueckgestellt, bis 2-3 echte Modus-2-Journale als Referenz vorliegen

Warum es heikel ist

Bei den offenen Schritten ist die Reihenfolge selbst Geometrie (Gesamtplan, Abschnitt "Wo Geometrie still kippen kann"), u.a.:

  • die dL-Subtraktionskette ist je Schritt mit (max *vfk-restlaenge-min-clamp* ...) geklammert, also reihenfolgeabhaengig;
  • die vfl-acc-*-Aufrufe muessen an derselben Stelle in derselben Reihenfolge bleiben, sonst vertauschen sich L_VF_m/L_GF_m/GF_WINKEL
    • in der Zeichnung unsichtbar, im Sivas-Export falsch;
  • *vfl-as-winkel*/*vfl-es-winkel* werden lazy von den Blocknamen-Bauern gelesen - spaeter gesetzt heisst falscher Block;
  • ziel-gf2 vs. L_GF2-bau im Ausgang - geht es verloren, entsteht still die falsche GF2 hinter dem Motor.

Ausdruecklich nicht anfassen: siehe Gesamtplan, Abschnitt "Ausdruecklich nicht anfassen" (u.a. alle Journal-Konsumenten, vfl-in-*-Wrapper, Wizard-Schicht, Abbruch-Pfad).

Ablauf je Schritt

  1. Umbauen (Frage-Schale behaelt Namen, Bauteil wortwoertlich umziehen, keine Umsortierung).
  2. CAD-Lauf: TEST_HUNDM05 (save dxf), TEST_VF_SPEC, TEST_LINIENZUG.
  3. pytest tests/test_vf_geometrie.py gegen tests/reference/hundm05_attribute.json - nennt bei Abweichung Kette und Feld. Referenz nur nach geprueftem Lauf auffrischen (lib/dxf_vf_abbild.py --schreibe-referenz).
  4. Nach Geometrie-Schritten (5c, 9) zusaetzlich DXF-Diff und Sivas-Export-Vergleich.
  5. Ein Schritt pro Commit - sonst ist ein Fehler keinem Schritt mehr zuzuordnen.

Wann angehen

Erst bei konkretem Bedarf: einzelne Bauteile ohne Journal aufrufen, oder der Replay-Umweg wird zu langsam bzw. zu fehleranfaellig. Bis dahin genuegt Stufe 1.