Skip to content

armgit / SOMA

Public Imported from GitHub
0

Desktop app for designing parametric 3D models in CadQuery together with the coding agent of your choice

Doku: neue Entwicklungsumgebung, Ergebnisse von Phase 0 unter docs/

Kai-Jungsthoefel67154bf1d4b8
diff --git a/CLAUDE.md b/CLAUDE.md
index 585b77c..b67ffd1 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -18,18 +18,17 @@ Eine Desktop-App (Electron, TypeScript), in der ein Nutzer mit einem CLI-Agenten
| `design/ui-entwurf-2.html` | Freigegebener Oberflächenentwurf 2 „Aufgeräumt“ (E62), im Browser öffnen, Pfeiltasten blättern. Maßstab für Aufbau, Farben und Texte der Oberfläche. Bild 6 ist das Parameter-Panel (umgesetzt mit E74, Werte des Nutzers getrennt vom Code) |
| `design/strukturbaum-entwurf.html` | Freigegebener Entwurf für den Strukturbaum im Viewer und die Reiter Analysis und Animation (E82), umgesetzt. Ersetzt in Entwurf 2 den Reiter Bauteile und den Umschalter oben links, enthält den ruhigen Bericht der Analyse. Maßstab für Baum, Reiter und Bericht |
| `design/ui-entwurf.html` | Erster Oberflächenentwurf (E38), Farben und Bausteine gelten weiter, der Aufbau ist durch Entwurf 2 ersetzt |
-| `design/icon-vorschlaege.html` | Die fünf Icon-Entwürfe, aus denen „Dialog“ gewählt wurde (E44). Nur noch Referenz |
| `python/soma/` | Hilfsbibliothek und CLI: `add_part` (mit `group=` und `role=`), `param` (`params.py`, Werte für das Parameter-Panel, E74), `import_step`, `import_assembly`, `fasteners.py` (Normteile, Maßtabellen aus bd_warehouse in `data/fasteners/`), `soma build`, `soma export`, `soma glb`, `soma serve` (Messdienst, `measure.py`), `soma anim` (`anim.py`, `animrun.py`), `soma analyze` (`analysis.py`, FEM in `fem.py`, gerechnet mit CalculiX über `ccx.py`, E84), `soma drawing` (`drawing.py`, `drawrun.py`, technische Zeichnungen, E76), `soma dxfview` (`dxfview.py`, DXF für die Ansicht der App, E80), `soma render` (`render.py`, über die App), `soma env` (`env.py`, Projektumgebung `.soma/env` und `requirements.txt`, E67) |
-| `prototype/phase0/` | Abgeschlossener technischer Prototyp mit `ERGEBNISSE.md`. Nur noch Referenz |
+| `python/scripts/` | `setup_env.ps1` (Entwicklungsumgebung aus `python/requirements-base.txt`), `fetch_ccx.py` (CalculiX, E84) |
+| `docs/` | `images/` für die README, `phase0-ergebnisse.md` (Ergebnisse des abgeschlossenen Prototyps, sein Code liegt im Git-Verlauf bis `v0.5.0`) |
Details: `app/README.md`.
## Befehle
```
-# einmalig: Python-Umgebung (lokal) und soma darin, das Skript holt auch CalculiX (python/scripts/fetch_ccx.py nach venv-full/ccx)
-powershell -File prototype/phase0/setup_env.ps1
-uv pip install --python "$LOCALAPPDATA/cadide-phase0/venv-full/Scripts/python.exe" -e python
+# einmalig: Python-Umgebung (lokal unter %LOCALAPPDATA%\soma-dev\venv) mit soma darin, holt auch CalculiX (fetch_ccx.py nach venv/ccx)
+powershell -File python/scripts/setup_env.ps1
# App (in app/)
npm install
@@ -39,7 +38,7 @@ npm test # baut, dann alle Suiten (unit, smoke, versions, editor,
node test/run-all.mjs smoke editor # einzelne Suiten parallel, nach npm run build
# soma direkt
-"$LOCALAPPDATA/cadide-phase0/venv-full/Scripts/soma.exe" build --project <ordner>
+"$LOCALAPPDATA/soma-dev/venv/Scripts/soma.exe" build --project <ordner>
```
## Grundsätze für den Code
@@ -66,9 +65,9 @@ node test/run-all.mjs smoke editor # einzelne Suiten parallel, nach npm run bu
## Entwicklung unter Windows
-- **Netzlaufwerke:** Liegt das Repo auf einem Netzlaufwerk, starten die sandboxed Prozesse von Electron nicht (schwarzes Fenster, `launch-failed` Code 18). Electron läuft deshalb aus einer lokalen Kopie (`app/scripts/electron-local.mjs`). Nie `node_modules/electron/dist/electron.exe` direkt starten. Die Python-Umgebung liegt lokal unter `%LOCALAPPDATA%\cadide-phase0\venv-full`.
+- **Netzlaufwerke:** Liegt das Repo auf einem Netzlaufwerk, starten die sandboxed Prozesse von Electron nicht (schwarzes Fenster, `launch-failed` Code 18). Electron läuft deshalb aus einer lokalen Kopie (`app/scripts/electron-local.mjs`). Nie `node_modules/electron/dist/electron.exe` direkt starten. Die Python-Umgebung liegt lokal unter `%LOCALAPPDATA%\soma-dev\venv`.
- **Proxy:** Hinter einem Proxy brauchen Node-Downloads (Electron-Binary, dugite) `NODE_USE_ENV_PROXY=1`.
-- **Ports:** Feste Ports können von anderen Programmen belegt sein. Eigene Ports: 8791 (Phase 0), 9333 (Tests einzeln ohne `SOMA_TEST_PORT`; `run-all.mjs` holt freie Ports). Laufen mehrere Sessions gleichzeitig, braucht jede eigene Ports, und Testprozesse nur die eigenen beenden.
+- **Ports:** Feste Ports können von anderen Programmen belegt sein. Eigene Ports: 9333 (Tests einzeln ohne `SOMA_TEST_PORT`; `run-all.mjs` holt freie Ports). Laufen mehrere Sessions gleichzeitig, braucht jede eigene Ports, und Testprozesse nur die eigenen beenden.
- Prozesse nur gezielt beenden (Pfad des Repos oder `soma-dev` in der Kommandozeile), nie pauschal alle `electron.exe` oder `node.exe`.
## Stolpersteine beim Bearbeiten
diff --git a/PLAN.md b/PLAN.md
index 3e9bc6f..bd5569f 100644
--- a/PLAN.md
+++ b/PLAN.md
@@ -1,6 +1,6 @@
# Plan: SOMA (CAD mit KI-Agenten)
-> Stand: 2026-09-30 · Status: **Phase 0 abgeschlossen** ([Ergebnisse](prototype/phase0/ERGEBNISSE.md)), **Phase 1 läuft** (Schritte 1 bis 5 erledigt, Messen vorgezogen, siehe Abschnitt 10 und [app/README.md](app/README.md))
+> Stand: 2026-09-30 · Status: **Phase 0 abgeschlossen** ([Ergebnisse](docs/phase0-ergebnisse.md)), **Phase 1 läuft** (Schritte 1 bis 5 erledigt, Messen vorgezogen, siehe Abschnitt 10 und [app/README.md](app/README.md))
> Ursprung: [IDEA.md](IDEA.md) · Begründungen und Historie: [DECISIONS.md](DECISIONS.md)
> Zahlen in Klammern, z. B. (E12), verweisen auf Entscheidungen im Log.
@@ -184,7 +184,7 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben
## 10. Phasen
-**Phase 0: technischer Prototyp ohne App (E13, E14). Abgeschlossen**, alle Punkte bestanden. Details und Zahlen in [ERGEBNISSE.md](prototype/phase0/ERGEBNISSE.md), Code und Tests in `prototype/phase0/`:
+**Phase 0: technischer Prototyp ohne App (E13, E14). Abgeschlossen**, alle Punkte bestanden. Details und Zahlen in [phase0-ergebnisse.md](docs/phase0-ergebnisse.md), Code und Tests im Git-Verlauf (zuletzt im Tag `v0.5.0` unter `prototype/phase0/`):
1. **STEP mit Namen und Farben:** `cq.Assembly.export` genügt, kein eigener XCAF-Export nötig. Nicht-ASCII-Namen werden beim Export zerstört, daher ASCII-Namen in der STEP.
2. **GLB mit Flächen-IDs:** eigener Mesher (rund 150 Zeilen), alle IDs gegen OCC verifiziert. Die IDs gelten nur für einen Build. Der Python-Anteil ist nicht der Engpass, das Meshen in OCC ist es.
@@ -398,7 +398,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- **Im Viewer:** Die Karte „Analyse“ zeigt bei FEM die Verformung überhöht (unverformt, echte Größe oder so, dass die größte Verschiebung 5 % der Modellgröße ist, auf eine runde Zahl), den Lastfall in Blau (Einspannungen kräftig, Lastflächen schwach, Kräfte als Pfeile vor dem Modell, ein- und ausblendbar), Zeilen für Lastfall und Hinweise. Unter dem Zeiger stehen Sicherheit, Spannung und Verschiebung, die Stelle gilt im unverformten Modell. Der Schnitt füllt und umrandet die verformten Netze, die Kontur folgt einer geänderten Überhöhung. „An Agent geben“ nennt alle drei. `soma render --result` zeigt die Verformung wie der Viewer und nennt die Überhöhung in der Legende. Veraltet ist ein Ergebnis auch, wenn die Studie neuer ist, „Neu berechnen“ nimmt die Studie wieder.
- **Farbskala (Wunsch des Nutzers):** Bei FEM wählt man die gezeigte Größe, Sicherheit oder Vergleichsspannung nach von Mises (Grenze ist die zulässige Spannung, Festigkeit durch geforderte Sicherheit, bei mehreren Werkstoffen die des schwächsten, kritisch darüber). Bei jeder Auswertung lässt sich die Spanne der Färbung wählen: automatisch (wie bisher, am Grenzwert ausgerichtet), Min bis Max der Werte im Modell, oder selbst gewählt (zwei Zahlenfelder, gilt beim Tippen, ungültig rot umrandet). Bei Min bis Max und selbst gewählt läuft die Farbe gleichmäßig über die Spanne von Grau bis Rot, die Legende sagt das dazu. Eigene Grenzen bleiben für dasselbe Ergebnis und dieselbe Größe, auch nach „Neu berechnen“. `soma render --result` zeigt weiter die automatische Skala der Sicherheit.
- **Für den Agenten:** Skill „Festigkeit mit FEM“ (Prüfen und Zeigen, bei Bedarf, Einstellung Sicherheitsfaktor), `AGENTS.md` nennt `analyses/` und den Befehl, „Festigkeit“ und „Analyse“ verweisen darauf. Das Beispiel im Skill rechnet im Test so, wie es dasteht.
-- **Pakete:** gmsh 4.15 (GPL 2 oder später) und pyamg 5.3 (MIT) in der Basisumgebung, gepinnt in `prototype/phase0/requirements-phase0.txt`. scikit-fem war kurz installiert und ist wieder entfernt. gmsh läuft nur im Python-Prozess von `soma`, nicht in der App. Seit E71 steht SOMA selbst unter GPL-3.0, gmsh passt damit in die Auslieferung.
+- **Pakete:** gmsh 4.15 (GPL 2 oder später) und pyamg 5.3 (MIT) in der Basisumgebung, gepinnt in `python/requirements-base.txt`. scikit-fem war kurz installiert und ist wieder entfernt. gmsh läuft nur im Python-Prozess von `soma`, nicht in der App. Seit E71 steht SOMA selbst unter GPL-3.0, gmsh passt damit in die Auslieferung.
- **Grenzen:** linear-elastisch, kein Kontakt, kein Gleiten, kein Knicken, keine Vorspannung von Schrauben, keine Ermüdung. Teile sind verschmolzen, nicht gefügt. Werkstoffe gleichmäßig (keine Schichtrichtung, kein Infill, kein Holzfaserverlauf). Werte nur an der Oberfläche. Getestet unter Windows.
*Wartezeiten (E66, Wunsch des Nutzers; Prüfungen in `app/test/versions.mjs` und `unit.mjs`):*
@@ -549,7 +549,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
*Verbesserungen aus der Kritik eines Agenten (E85, Wunsch des Nutzers; Prüfungen in `app/test/animation.mjs` und `drawing.mjs`):*
-- **PDFs:** pdfplumber 0.11 (MIT, mit pdfminer.six und pypdfium2) in der Basisumgebung (`prototype/phase0/requirements-phase0.txt`). `AGENTS.md` nennt es in der Zeile zu `inputs/`, mit `page.to_image()` für ein Bild. Die Projektumgebung übernimmt die Versionen wie die übrigen Basispakete.
+- **PDFs:** pdfplumber 0.11 (MIT, mit pdfminer.six und pypdfium2) in der Basisumgebung (`python/requirements-base.txt`). `AGENTS.md` nennt es in der Zeile zu `inputs/`, mit `page.to_image()` für ein Bild. Die Projektumgebung übernimmt die Versionen wie die übrigen Basispakete.
- **Achse:** Regel 6 in `AGENTS.md`: „Z is up, the front faces −Y (the front view looks from −Y), X points right.“ So wie Viewer, `soma render` und Zeichnungen „front“ verstehen.
- **soma render:** `--view` nimmt auch eine Richtung `x,y,z` vom Modell zur Kamera (mit führendem Minus als `--view=-1,0,0`, argparse hält es sonst für eine Option). `--hide` und `--only` (mehrfach) blenden Teile oder Gruppen aus, zusätzlich zu dem, was eine Animation ausblendet. `--fit` passt auf Teile ein, `--zoom` (0.05 bis 50) rückt näher. Mit einer Animation ersetzen Richtung, `--fit` und `--zoom` ihre Kamera wie bisher `--view`. Die Namen löst das Render-Fenster auf (Teil, Gruppe mit allem darunter, „Gruppe/Teil“), Unbekanntes ist ein Fehler mit der Liste der Teile und Gruppen. Im Viewer neu `viewFrom(dir, ids, zoom)`, `setView` nutzt es.
- **Animation:** `"Gruppe/Teil"` spricht ein Teil mit seiner Gruppe an. Der Skill sagt in einem Satz, dass große Bewegungen die Teile klein machen und `fit` oder `zoom` helfen.
@@ -582,6 +582,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- `AGENTS.md` und die Kommentare der Vorlage sind **auf Englisch** (Agenten befolgen englische Anweisungen zuverlässiger). Seit E73 ist auch die Oberfläche englisch
- App auf Englisch (E73): nur Englisch, keine Umschaltung der Sprache. IDs und Dateinamen der Skills bleiben deutsch (`3d-druck.md`), sonst müssten bestehende Projekte umziehen. Begriffe: „Mark up“/„Markup“ für Markieren, „Explode“ und „Exploded view“, „Section“, „Send to agent“, „issues“ für die Hinweise zum Projekt, Skill-Stufen Off, On demand, Always. „Show in Explorer“ und „Recycle Bin“ passen nur zu Windows
- App-Daten liegen unter Windows in `%LOCALAPPDATA%\soma`, nicht im Roaming-Profil (Arbeitsordner und Caches gehören nicht ins Netz)
+- Vor der Veröffentlichung (2026-10-10): Der Prototyp aus Phase 0 und die Icon-Entwürfe sind aus dem Repo (im Git-Verlauf bis `v0.5.0`). Die Entwicklungsumgebung heißt `%LOCALAPPDATA%\soma-dev\venv` statt `cadide-phase0\venv-full`, gebaut von `python/scripts/setup_env.ps1` aus `python/requirements-base.txt`. Eine schon eingerichtete alte Umgebung lässt sich per Junction unter dem neuen Pfad einhängen
- Beim Öffnen eines Projekts wird sofort gebaut, damit der Viewer nicht leer ist, außer der letzte Build gilt noch (E66), dann wird er gezeigt. Beim Anlegen läuft vor dem Startcommit ein Build (im vorgewärmten Prozess unter 1 s)
- Der Modellname folgt dem Dateinamen der Modelldatei
- Speichern baut vorher neu, wenn der Quelltext neuer ist als das letzte Ergebnis, und wartet auf laufende Builds
diff --git a/README.md b/README.md
index bb83182..8d18e15 100644
--- a/README.md
+++ b/README.md
@@ -108,8 +108,7 @@ Early prototype, version 0.5.0. See [CHANGELOG.md](CHANGELOG.md).
Requirements: Windows, Node.js 22, Python 3.12 and [uv](https://github.com/astral-sh/uv).
```
-powershell -File prototype/phase0/setup_env.ps1
-uv pip install --python "$env:LOCALAPPDATA/cadide-phase0/venv-full/Scripts/python.exe" -e python
+powershell -File python/scripts/setup_env.ps1
cd app
npm install
npm start
diff --git a/app/README.md b/app/README.md
index 10b867c..84b6a29 100644
--- a/app/README.md
+++ b/app/README.md
@@ -5,7 +5,7 @@ Electron-App (TypeScript) für 3D-Modelle mit einem Coding-Agenten im Terminal.
## Voraussetzungen
- Node.js 22 oder neuer, Python 3.12 mit CadQuery (Basisumgebung), `soma` darin installiert.
-- Entwicklung: die Umgebung aus Phase 0 (`prototype/phase0/setup_env.ps1`, enthält seit E67 auch pip und holt seit E84 CalculiX mit `python/scripts/fetch_ccx.py` nach `venv-full\ccx`) und darin `uv pip install -e ../python`. Die App findet sie unter `%LOCALAPPDATA%\cadide-phase0\venv-full` oder über `SOMA_PYTHON`. Jedes Modell bekommt daneben eine kleine Projektumgebung unter `.soma/env` für Zusatzpakete (E67).
+- Entwicklung: `powershell -File ../python/scripts/setup_env.ps1` baut die Basisumgebung aus `python/requirements-base.txt` (mit pip, E67), installiert `soma` darin editierbar und holt CalculiX mit `python/scripts/fetch_ccx.py` nach `venv\ccx` (E84). Die App findet sie unter `%LOCALAPPDATA%\soma-dev\venv` oder über `SOMA_PYTHON`. Jedes Modell bekommt daneben eine kleine Projektumgebung unter `.soma/env` für Zusatzpakete (E67).
- Hinter einem Proxy lädt Node den Electron-Download nur mit `NODE_USE_ENV_PROXY=1`:
`NODE_USE_ENV_PROXY=1 node node_modules/electron/install.js` (falls `npm install` das Binary nicht geholt hat).
diff --git a/docs/phase0-ergebnisse.md b/docs/phase0-ergebnisse.md
new file mode 100644
index 0000000..dc0fa31
--- /dev/null
+++ b/docs/phase0-ergebnisse.md
@@ -0,0 +1,112 @@
+# Phase 0: Ergebnisse des technischen Prototyps
+
+> Stand: 2026-09-29 · Plan: [PLAN.md](../PLAN.md), Abschnitt 10 · Alles gemessen auf **Windows 11**, Python 3.12.0, CadQuery 2.8.0, OCP 7.9.3.1.1, three.js 0.180, Edge (headless).
+> Der Code des Prototyps (die unten genannten Skripte und Tests) ist nicht mehr im Repo. Er liegt im Git-Verlauf, zuletzt im Tag `v0.5.0` unter `prototype/phase0/`.
+
+## Kurzfassung
+
+Alle sechs Punkte sind bestanden. Die Kernidee trägt: **Bauteil registrieren → STEP mit Namen und Farben → GLB mit Flächen-IDs → Klick im Viewer → Datei und Zeile in `model.py`**, dazu exaktes Messen über dieselben IDs. Gegen den Plan haben sich vier Dinge verschoben (siehe „Folgen für den Plan").
+
+| # | Punkt | Ergebnis | Nachweis |
+|---|---|---|---|
+| 1 | STEP mit Namen und Farben | **bestanden**, kein eigener XCAF-Export nötig | `p1_step_names.py` |
+| 2 | GLB mit Flächen-IDs (eigener Mesher) | **bestanden** | `mesher.py`, `p4_measure_test.py`, `p2_mesher_perf.py` |
+| 3 | Klick im Viewer → Datei und Zeile | **bestanden** (echter Browser) | `p3_click_test.mjs`, `screenshots/` |
+| 4 | Fremd-STEP, Messen, Aussparung, Referenz | **bestanden** (mit synthetischer Platine) | `p4_measure_test.py`, `p3b_basic_test.mjs` |
+| 5 | Umgebung ohne VTK, Größe | **VTK ist nicht wegzubekommen.** Größe gemessen | `dll_closure.py`, `count_loaded.py` |
+| 6 | Exportformate | **12 Formate**, davon 2 mit eigenem Code | `p6_export_formats.py` |
+
+## 1. STEP mit Namen und Farben
+
+Der normale `cq.Assembly.export(...)` (Modus „default") genügt. Ein eigener Export über OCP ist **nicht nötig**, das größte Risiko aus dem Plan ist damit erledigt. Geprüft wurde mit einem **eigenen, unabhängigen XCAF-Leser** (`xcaf_tools.py`), der die Datei liest und nicht CadQuerys Deutung.
+
+- Erhalten bleiben: 5 Bauteilnamen, sRGB-Farben, Transparenz (Alpha 0,5), verschachtelter Ast „Referenz".
+- **Compound mit mehreren Körpern:** Die Farbe steht in der Datei auf den Einzelkörpern (5 `STYLED_ITEM`, 1 `COLOUR_RGB`), nicht am Compound. Ein Leser muss dort suchen. Das betrifft auch importierte Platinen.
+- **Verschachtelte Baugruppe:** Der Name steht im `PRODUCT`, die Instanz (`NEXT_ASSEMBLY_USAGE_OCCURRENCE`) hat nur eine Nummer. Ein Leser muss für Baugruppen den Produktnamen nehmen.
+- **Nicht-ASCII-Namen sind kaputt:** Die Datei enthält doppelt kodiertes UTF-8 (`Größe` steht als `GröÃ\x9fe`). `ä ö ü` überleben den Reimport zufällig, `ß`, `×` und CJK nicht. **Lösung im Prototyp:** `add_part` schreibt einen ASCII-Namen in die STEP (`Schraube links` → `Schraube_links`, `ä` → `ae`), der Anzeigename bleibt in `model.map.json`.
+- **Doppelte Namen** lehnt CadQuery mit klarer Meldung ab (`Unique name is required`). `add_part` prüft zusätzlich den ASCII-Namen, sonst kollidieren `Größe` und `Groesse`.
+- Nicht getestet: der Modus „fused" (verliert laut Doku Namen, wird nicht gebraucht).
+
+## 2. GLB mit Flächen-IDs
+
+`mesher.py` (rund 150 Zeilen) erzeugt pro Bauteil ein Mesh, pro Fläche einen zusammenhängenden Dreiecksbereich (`triStart`, `triCount`) und pro Kante einen Linienbereich. Die Tabellen liegen in `node.extras.cadide` des GLB.
+
+- **Konsistenz geprüft:** 197 Flächen und Kanten des Beispiels wurden gegen die OCC-Objekte verglichen (Fläche, Schwerpunkt, Länge), 0 Abweichungen. Damit kann der Python-Dienst „Fläche f27" exakt vermessen.
+- **Die IDs gelten nur für einen Build.** Ändert der Agent das Modell, können sich die Nummern verschieben (Topological-Naming-Problem). Das ist für Klick und Messen im selben Stand unkritisch, aber Auswahlen dürfen nicht über Builds hinweg gespeichert werden.
+- Koordinaten sind Z-oben in mm (kein Y-oben-Umbau), der Viewer setzt `camera.up = Z`. Farben werden von sRGB nach linear umgerechnet, wie glTF es verlangt.
+- **Leistung** (Wert schwankt je nach Last, zwei Läufe):
+
+| Modell | Flächen | Dreiecke | OCC-Mesh | Python-Mesher | GLB |
+|---|---|---|---|---|---|
+| Platte, 961 Löcher, Toleranz 0,05 | 967 | 165 000 | 4,1 bis 4,8 s | 1,7 bis 3,2 s | 7,7 MB |
+| Dieselbe, Toleranz 0,01 | 967 | 488 000 | 18 bis 30 s | 3,9 bis 7,7 s | 19 MB |
+| Platte + 480 Zapfen | 968 | 81 000 | 1,7 bis 2,2 s | 0,8 bis 1,5 s | 3,9 MB |
+| Kugel R50, Toleranz 0,005 | 1 | 100 000 | 1,2 bis 1,9 s | 0,3 bis 0,7 s | 2,4 MB |
+
+Der Python-Anteil ist **nicht der Engpass**, das Meshen in OCC ist es. Hinzu kommt die Bauzeit des Modells selbst (2,3 s für die Platte). Ein großes Modell braucht damit schnell 8 bis 10 s pro Build, das stützt die Entscheidung, den Auto-Build abschaltbar zu machen (E20). Eine feste Toleranz von 0,01 mm ist zu fein, sie sollte sich an der Bauteilgröße orientieren.
+
+## 3. Klick im Viewer → Datei und Zeile
+
+Getestet in **echtem Browser** (Edge headless mit WebGL über SwiftShader, gesteuert per puppeteer-core), nicht nur per Raycast im Skript. Der Test klickt auf die Bildschirmposition von drei Flächen und prüft Bauteil, Flächen-ID, Datei und Zeile.
+
+- Deckel-Oberseite → `Deckel`, Fläche f2, `model.py:34`. Taster-Kuppe → `Taster`, `model.py:35–39`. Außenwand des Bodens → `Boden`, `model.py:33`.
+- `add_part` erfasst den **Zeilenbereich** des Aufrufs (`inspect` mit `positions`, Python ab 3.11). Ein mehrzeiliger Aufruf wird ganz markiert.
+- Der Viewer hebt die geklickte **Fläche** orange hervor, zeigt Fläche, Typ, Flächeninhalt und den Code mit markierter Zeile. Ein-/Ausblenden über den Baum funktioniert, Referenzteile sind halbtransparent (Screenshot `p3_viewer_offen.png`).
+- **Grenze:** Verknüpft wird der **`add_part`-Aufruf**, nicht die Zeile, in der die Fläche entsteht (also nicht „diese Bohrung kommt von Zeile 22"). Das entspricht E10 (zunächst nur Bauteilebene).
+- Kanten waren zuerst kaum sichtbar (Tiefenkonflikt mit den Flächen). Behoben mit `polygonOffset` auf den Flächen, sonst fällt das im Viewer auf.
+
+## 4. Fremd-STEP, Messen, Aussparung, Referenz
+
+Das Beispielprojekt (`example/model.py`) importiert `inputs/board.step` (Platine mit USB-Buchse, Modul und zwei Stiftleisten, Ursprung in der Ecke), setzt sie ins Gehäuse und schneidet eine Aussparung mit 0,3 mm Luft.
+
+- Exakt gemessen (OCC): Abstand Boden–Platine **0,300000 mm**, Deckel–Platine **2,400000 mm**, Schnittvolumen Boden ∩ Platine 0, Radius der Montagelöcher **1,4 mm** aus den Kanten-IDs, Höhenabstand über zwei Flächen-IDs.
+- Referenz: `role="reference"` legt das Teil in den Ast „Referenz" der STEP, Alpha 0,45 in STEP und GLB, halbtransparent im Viewer.
+- **Basismodus** (Plan Abschnitt 7): `basic_view.py` wandelt eine beliebige STEP in GLB um (Namen und Farben aus der STEP, kein Mapping). Der Viewer zeigt 5 benannte Teile, ein Klick liefert das Bauteil ohne Code-Bezug, ohne Fehler.
+- **Grenze:** Die Platine ist **synthetisch** (`make_board_step.py`), keine echte Herstellerdatei. Echte Dateien haben oft viele Einzelteile, andere Einheiten, Stücklistenstruktur und Encoding-Eigenheiten. Das ist in Phase 1 mit echten Dateien (KiCad-Export, Modul-Hersteller) nachzuholen.
+
+## 5. Umgebung und Größe
+
+- **VTK ist nicht wegzubekommen.** Das Wheel `cadquery-ocp` verlangt `vtk==9.6.2`, und `OCP/__init__.py` bricht ohne den Ordner `vtk.libs` ab. `import OCP` lädt 47 der 209 VTK-DLLs plus alle 71 OCP-DLLs (zusammen 200 MB), `import cadquery` danach alle 209 VTK-DLLs (zusammen 342 MB). Eine Umgebung ohne VTK gibt es damit nicht, und Löschen ungenutzter DLLs bringt nichts.
+- Größen (Windows, Python 3.12):
+
+| Variante | Installiert | Anmerkung |
+|---|---|---|
+| **Voll** (`pip install cadquery`) | **1043 MB** | VTK 312 MB, casadi 220 MB, llvmlite 115 MB, scipy 83 MB … |
+| Schlank (`--no-deps` + 9 Pakete) | 761 MB | ohne scipy, numba, llvmlite, matplotlib, trame; als ZIP rund 199 MB |
+
+- In der schlanken Variante **nötig** sind: `cadquery`, `cadquery-ocp`, `cadquery-ocp-proxy`, `vtk`, `casadi` (wird beim Import gebraucht, `solver.py`), `ezdxf`, `numpy`, `nlopt`, `multimethod`, `runtype`, `pyparsing`, `typing-extensions`, `fonttools`. **Nicht nötig**: `scipy`, `numba`, `matplotlib`, `trame*` (nur NURBS-Werkzeuge und Notebook-Ansicht).
+- **Entscheidung (E37):** Größe ist vorerst egal, es wird die volle Umgebung genommen. Der Prototyp läuft damit in `venv-full`.
+- **Stolperstein beim Pinnen:** Ein ungepinnter Install zieht `cadquery-ocp` 8.0.1, das nicht zu `cadquery` 2.8.0 passt (verlangt `<8.0`), und `multimethod` 2.1 (verlangt `<2.0`). Die App muss die Versionen fest pinnen (`requirements-phase0.txt`).
+- Ein Netzlaufwerk taugt nicht für die Umgebung (Tausende kleine Dateien), sie liegt lokal unter `%LOCALAPPDATA%`. Für die App heißt das: Arbeitsordner und Umgebung in den lokalen App-Daten, nie neben der ZIP auf dem Netz.
+
+## 6. Exportformate
+
+Einzelexport je registriertem Bauteil (Grundlage für `cadide export`), alle 6 Bauteile, jeweils unter 0,15 s:
+
+| Format | Weg | Prüfung |
+|---|---|---|
+| STEP, BREP | CadQuery | Reimport-Volumen identisch (3678,551 mm³) |
+| STL, 3MF, AMF, VRML | CadQuery | STL 184 Dreiecke, 3MF gültiges ZIP mit `3dmodel.model` |
+| GLB, GLTF | CadQuery (Assembly) | Datei erzeugt |
+| DXF (Schnitt in Bauteilmitte), SVG (Projektion) | CadQuery | **2D**, andere Bedeutung als die 3D-Formate |
+| **IGES** | **eigener Code über OCP** | Reimport-Volumen identisch |
+| **OBJ** | **eigener Code aus unserem Mesh** | 194 Vertices, 184 Dreiecke |
+| PLY, Parasolid (X_T) | nicht verfügbar | X_T ist proprietär |
+
+Für 3D-Druck reichen STL und 3MF. **3MF** kann Farben, das ist für Mehrfarbdruck interessant, wurde hier aber nur auf Gültigkeit geprüft.
+
+## Folgen für den Plan
+
+1. **Risiko „STEP-Namen" erledigt.** Der Rückfall auf eigenen XCAF-Export entfällt. Die Regel „STEP-Namen ASCII, Anzeigename in `model.map.json`" kommt neu hinzu.
+2. **Installationsgröße** ist gemessen (0,76 bis 1,04 GB) und vorerst hingenommen (E37). Die Einschränkung „ohne VTK" aus dem Plan ist gegenstandslos.
+3. **Flächen-IDs gelten pro Build.** Für Messen und Auswählen reicht das, gespeicherte Auswahlen und Verweise des Agenten müssen Bauteilname plus Geometrieangaben statt reiner Flächennummern nutzen.
+4. **Exportformate** stehen fest (Tabelle oben). PLY und X_T entfallen.
+
+## Nicht geprüft (bewusst offen)
+
+- **macOS und Linux.** Alles lief nur unter Windows. Bundling, DLL-/Bibliothekspfade und Wheels sind auf den anderen Systemen ungetestet, obwohl E2 alle drei verlangt.
+- **Echte Fremddateien** (Herstellerplatinen, große Baugruppen mit Stückliste).
+- **Rendering mit echter GPU** und sehr großen Modellen (getestet nur mit Software-Renderer und kleinen Bauteilen). Die 165 000 Dreiecke des Benchmarks wurden gemessen, aber nicht im Viewer dargestellt.
+- **Das Zusammenspiel mit einem echten Agenten** (Phase 1, Agent-Test).
+- Kanten- und Punktauswahl im Viewer, Schnittansicht, Messwerkzeug im Viewer (die exakten Werte über IDs stehen, die Oberfläche dafür nicht).
+- Python-Dienst als langlebiger Prozess und Build-Abbruch (der Prototyp baut im selben Prozess).