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

Entscheidung E76, Plan, Changelog, README und CLAUDE.md: technische Zeichnungen

Kai-Jungsthoefeld327fa212c55
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 67ce10c..70e7454 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,10 @@ eigenen Abschnitt mit Datum und Git-Tag.
## [Unveröffentlicht]
+### Neu
+
+- Technische Zeichnungen: Der Agent beschreibt eine Zeichnung in `drawings/*.py` (`soma.drawing`) mit Ansichten, Schnitten, Einzelheiten, Maßen, Texten und Stückliste, `soma drawing build` schreibt PDF und DXF nach `output/drawings/` und ein Bild, mit dem der Agent sein Ergebnis prüft. Die Maße werden immer am Modell gemessen, eine Prüfung meldet Überschneidungen, Maße neben Kanten und getippte Zahlen. Dazu der Skill „Technical drawings“ mit den Regeln nach ISO (E76).
+
### Geändert
- Jede Zeile im Panel „Parameters“ zeigt den Bereich, den der Agent gesetzt hat, ohne Aufklappen („30–200 mm“, „3 options“), rot, wenn der Wert außerhalb liegt (E74).
diff --git a/CLAUDE.md b/CLAUDE.md
index fbe633b..fb19ee4 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -18,7 +18,7 @@ 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/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`), `soma render` (`render.py`, über die App), `soma env` (`env.py`, Projektumgebung `.soma/env` und `requirements.txt`, E67) |
+| `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`), `soma drawing` (`drawing.py`, `drawrun.py`, technische Zeichnungen, E76), `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 |
Details: `app/README.md`.
@@ -34,7 +34,7 @@ uv pip install --python "$LOCALAPPDATA/cadide-phase0/venv-full/Scripts/python.ex
npm install
npm start # baut und startet
npm run typecheck
-npm test # baut, dann alle Suiten (unit, smoke, versions, editor, measure, groups, section, explode, skills, params, fasteners, animation, fem, packages) parallel über test/run-all.mjs (echte App, unsichtbares Fenster)
+npm test # baut, dann alle Suiten (unit, smoke, versions, editor, measure, groups, section, explode, skills, params, fasteners, drawing, animation, fem, packages) parallel über test/run-all.mjs (echte App, unsichtbares Fenster)
node test/run-all.mjs smoke editor # einzelne Suiten parallel, nach npm run build
# soma direkt
diff --git a/DECISIONS.md b/DECISIONS.md
index 4a715ce..19b3a48 100644
--- a/DECISIONS.md
+++ b/DECISIONS.md
@@ -78,3 +78,4 @@
| 73 | App auf Englisch | **Die App ist komplett auf Englisch:** Oberfläche, Meldungen und Dialoge, Ausgaben und Fehlermeldungen von `soma`, Docstrings der öffentlichen API, Skills samt Titel, Beschreibung und Einstellungen, die Notizen an den Agenten (`[Markup: …]`, `[Selection: …]` …). Zahlen stehen mit Dezimalpunkt | Wunsch des Nutzers („Lass uns die App komplett auf englisch übersetzen“). Ersetzt die Sprachregel „Oberfläche deutsch“ (PLAN.md Abschnitt 11) und in E48 „Fehlermeldungen deutsch“. Auslegung (nicht ausdrücklich bestätigt): nur Englisch, keine Umschaltung. Deutsch bleiben Doku, Code-Kommentare, Commit-Nachrichten und Changelog. IDs und Dateinamen der Skills bleiben (`3d-druck.md`). Ältere Projekte (deutsche Commit-Betreffe und Trailer der App) werden weiter erkannt. Umsetzung in PLAN.md Abschnitt 10 |
| 74 | Parameter für den Nutzer | **Der Agent gibt mit `param()` im Code die Werte frei, die der Nutzer selbst ändern soll, nicht alle Konstanten** (etwa Kurbelwinkel des Modellmotors, Bauraum der CNC-Maschine). Die App zeigt sie im Parameter-Panel (Entwurf 2, Bild 6), Ändern baut neu. **Jedes Feld lässt sich auf den Wert des Agenten zurücksetzen** | Wunsch des Nutzers nach Brainstorming (Kommentare wie im OpenSCAD-Customizer, Funktionsaufruf, eigene Tabelle). Gewählt: Funktionsaufruf nach Vorbild Streamlit/Gradio. Wegen der Rücksetzung bleibt der Wert des Agenten im Code, die Werte des Nutzers stehen getrennt in `parameters.json`. Das ersetzt die Anmerkung im Entwurf, der Wert werde in den Code geschrieben. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 |
| 75 | Größe der ZIP | **`renders/` kommt nicht mehr in die ZIP** (im Verlauf schon seit E64 nicht). **Vor dem Schreiben der ZIP packt die App die Git-Objekte** (`git repack`), ähnliche Fassungen von `output/model.step` werden als Unterschied gespeichert. Commits und Hashes bleiben, nichts wird gelöscht | Wunsch des Nutzers nach Prüfung zweier ZIPs (Motor 153 MB, Hotwire 12.5 MB, Code jeweils unter 100 KB): „Ja wir lassen renders aus der git repack können wir auch machen wenn das keine probleme verursacht“. Verträgt sich mit E35, weil `repack` keine Historie umschreibt. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 |
+| 76 | Technische Zeichnungen | **Der Agent zeichnet selbst, soma liefert einen Werkzeugkasten statt automatischer Anordnung oder Bemaßung.** Eine Zeichnung ist eine Python-Datei `drawings/*.py`: Blatt mit Rahmen und Schriftfeld (abschaltbar), Ansichten aus beliebigen Formen (Bauteil, Gruppe, Zusammenbau, eigene CadQuery-Form) mit verdeckten Kanten, Schnitte, Einzelheiten, Maße an Modellpunkten mit gemessenem Wert, dazu freies Zeichnen direkt mit ezdxf. Ausgabe DXF, PDF und **ein** PNG in hoher Auflösung, Ausschnitte schneidet der Agent bei Bedarf selbst zu. `check` meldet nur. **Best Practices kommen in einen optionalen Skill** | Wunsch des Nutzers nach Brainstorming: „nicht zu viel automatisieren. Der Agent muss viel Spielraum haben … notfalls auch Sachen komplett selbst zeichnen“, dazu „auf jeden Fall einen Skill … für Best Practices“ und „ich glaube nicht, dass mehrere Exporte nötig sind“. Der erste Vorschlag (Ansichten und Maße legt soma selbst an) ist damit verworfen. Technik: verdeckte Kanten mit HLR aus OCP, DXF mit ezdxf, PDF und PNG aus derselben DXF über matplotlib, keine neuen Pakete. Umsetzung und Auslegungen in PLAN.md, Abschnitte 10 und 11 |
diff --git a/PLAN.md b/PLAN.md
index 02fd240..0c789fd 100644
--- a/PLAN.md
+++ b/PLAN.md
@@ -108,6 +108,7 @@ Das Paket `soma` liegt in der mitgelieferten **Basisumgebung**, nicht im Projekt
| `soma analyze overhang \| thickness \| clearance` | Wert an jeder Stelle der Oberfläche, Zusammenfassung je Bauteil, Ergebnis nach `.soma/results/` (E58) |
| `soma analyze fem analyses/<x>.py` | Festigkeit mit FEM: Lastfall als Python-Datei, Sicherheit, Spannung und Verschiebung je Stelle, Ergebnis nach `.soma/results/` (E65) |
| `soma render` | Bild, Übersicht oder Video über die App nach `renders/` (E58). Nur in den Terminals der App |
+| `soma drawing build \| list \| info` | Technische Zeichnungen aus `drawings/*.py` (`soma.drawing`) als PDF und DXF nach `output/drawings/`, dazu ein Bild zum Prüfen, Hinweise der Prüfung mit Zeile (E76) |
**Bauen (E20):** Auto-Build bei Änderung von `model.py` und `parts/` (Hintergrund, Debounce, abbrechbar). Er ist **abschaltbar**, weil große Modelle sonst die App bremsen. Dann baut der Nutzer per Knopf oder der Agent per Befehl.
@@ -301,7 +302,7 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben
*Skills (E17, E46, E55; 47 Prüfungen in `app/test/skills.mjs`, 14 Einheitentests):*
-- **Panel „Skills“** in der Leiste links: die mitgelieferten Skills mit Kurzbeschreibung, Umschalter für die Stufe und aufklappbar den Themen. Mitgeliefert sind 14 Skills in `app/resources/skills/` (siehe „Skill-Inhalte“ unten, zwei kamen mit E58 dazu). Inhalt und Kopf (Titel, Beschreibung, Themen, Einstellungen für die Oberfläche) sind auf Englisch, der Kopf war bis E73 deutsch. Die CadQuery-Befehle darin (Kollisionsprüfung, Abstand, Senkungen) sind gegen die Basisumgebung geprüft.
+- **Panel „Skills“** in der Leiste links: die mitgelieferten Skills mit Kurzbeschreibung, Umschalter für die Stufe und aufklappbar den Themen. Mitgeliefert sind 16 Skills in `app/resources/skills/` (siehe „Skill-Inhalte“ unten, zwei kamen mit E58 dazu, FEM mit E65, Technische Zeichnungen mit E76). Inhalt und Kopf (Titel, Beschreibung, Themen, Einstellungen für die Oberfläche) sind auf Englisch, der Kopf war bis E73 deutsch. Die CadQuery-Befehle darin (Kollisionsprüfung, Abstand, Senkungen) sind gegen die Basisumgebung geprüft.
- **Stufen (E55, Wunsch des Nutzers):** Jeder Skill steht je Modell auf **Aus**, **Bei Bedarf** oder **Immer** (Umschalter mit drei Feldern in der Karte, „Immer“ hebt die Karte orange hervor, „Aus“ nimmt sie zurück). Bei Bedarf und Immer kopieren den Skill nach `.soma/skills/<id>.md`, tragen ihn in `project.json` ein (`skills` für Immer wie bisher, `skills_on_demand` für Bei Bedarf, auch in der App-Kopie, E27) und listen ihn im Abschnitt am Ende der `AGENTS.md` (zwischen `<!-- soma:skills -->` und `<!-- /soma:skills -->`, bei älteren Projekten ohne diesen Abschnitt wird er angehängt). Der Abschnitt hat zwei Listen: „Always follow“ (vor jeder Änderung lesen und befolgen) und „Read when relevant“ (je Skill der Anlass aus dem neuen Kopffeld `when`, etwa „Read when the parts will be 3D printed on a filament printer (FDM)“, nicht alle vorab lesen). Die Kopie eines Skills „Bei Bedarf“ hat unter der Überschrift einen Hinweis: dem Skill folgen, solange das Thema gilt, das in `NOTES.md` unter `## Requirements` festhalten (sonst weiß eine spätere Sitzung nichts davon), die Werte sind Standardwerte der App (vom Nutzer eingestellte nennt er mit Namen), also nennen oder nachfragen, und in der App lässt er sich auf „Immer“ stellen. **Aus** entfernt Kopie und Eintrag. Jedes Umstellen zählt als ungespeicherte Änderung und wandert mit Snapshot, Git und ZIP. Ein Wechsel zwischen Bei Bedarf und Immer schreibt die Kopie neu, eine unveränderte ohne Sicherung.
- **Einstellungen (Wunsch des Nutzers):** Ein Skill erklärt im Kopf Variablen, etwa `var overhang: 45 | ° | Max. Überhangwinkel | 10..85` (Standard, Einheit, Bezeichnung, Bereich) oder eine Auswahl `var material: PLA | | Material | PLA, PETG, ABS, ASA, TPU` (Einträge auch als `wert=Anzeige`). Im Text stehen Platzhalter wie `{{overhang}}`. Im Panel stehen die Einstellungen im aufgeklappten Skill: Zahlenfelder (Komma oder Punkt, Enter übernimmt, Escape verwirft) und Auswahllisten, geänderte Werte orange mit Knopf „zurück auf den Standard“, darunter in der Karte „Eingestellt: …“. Die App prüft jeden Wert (Bereich, Auswahl) und lehnt Falsches mit Grund ab. Gespeichert werden nur abweichende Werte, in `project.json` unter `skill_settings`, auch für ausgeschaltete Skills (sie gelten beim Einschalten). Die Kopie im Projekt enthält die eingesetzten Werte, im Text und im Kopf, der Agent liest also konkrete Zahlen. Eine Änderung schreibt die Kopie eines eingeschalteten Skills neu, eine von Hand geänderte Kopie kommt vorher in die Sicherung. Welche Einstellungen die mitgelieferten Skills haben, steht unten. Ein Skill ohne Einstellungen ist erlaubt.
- **Agent:** Ein laufender Agent liest `AGENTS.md` nicht von selbst neu. Die Meldung nach dem Umstellen oder Einstellen sagt das, „An Agent geben“ fügt `[Skill: .soma/skills/<id>.md] ` ein, mit geänderten Einstellungen etwa `[Skill: .soma/skills/3d-druck.md, Einstellungen: Max. Überhangwinkel = 50°] `. `AGENTS.md` erklärt dem Agenten diese Notiz. Den Knopf gibt es bei Bedarf und Immer, bei Bedarf heißt er: jetzt anwenden.
@@ -329,8 +330,9 @@ Agenten befolgen `AGENTS.md` nicht zuverlässig. Sie können Dateien verschieben
| Analyse (E58) | `soma analyze` für Überhang, Wandstärke und Spalt, Grenzwerte aus den anderen Skills, Bild mit `soma render --result`, Grenzen der Auswertung | keine |
| Festigkeit mit FEM (E65) | Lastfall in `analyses/*.py`, Werkstoffe, Flächen wählen, Ergebnis lesen und prüfen (Lagerkräfte, Netzprüfung, Spitzen), Grenzen der linearen Rechnung | Sicherheitsfaktor |
| Animation und Video (E58) | Aufbau einer Datei in `animations/`, Gelenke, Zeitleiste, Kamera, Texte, prüfen mit `soma anim info` und `check`, ansehen als Übersicht, Video nur auf Wunsch | keine |
+| Technische Zeichnungen (E76) | Zweck klären und planen, Blatt und Maßstab, Ansichten und Projektionsmethode, Schnitte und Einzelheiten, Bemaßung nach ISO 129 (Funktionsmaße, jedes Maß einmal, nie tippen), Toleranzen und Hinweise, Zusammenbau mit Positionen und Stückliste, frei zeichnen mit ezdxf, bauen und das Bild ausschnittweise prüfen | Norm (ISO, ASME), Blattgröße, Allgemeintoleranz, Sprache auf der Zeichnung |
-Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuche, Mutternfalle, Tasche mit Innenradius, Blechwinkel mit gleicher Dicke in der Biegung, Bewegungsprüfung).
+Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuche, Mutternfalle, Tasche mit Innenradius, Blechwinkel mit gleicher Dicke in der Biegung, Bewegungsprüfung, Zeichnung einer Platte ohne Hinweise der Prüfung).
*Normteile (E48, Wunsch des Nutzers; 35 Prüfungen in `app/test/fasteners.mjs`):*
@@ -456,6 +458,17 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- **Packen vor der ZIP:** Nach dem Snapshot packt `GitRepo.pack()` die Objekte (`git repack -a -d --keep-unreachable -n`), ähnliche Fassungen werden als Unterschied gespeichert. Commits und Hashes bleiben, nichts wird gelöscht (E35), auch nicht Unerreichbares. Ohne lose Objekte passiert nichts. Scheitert es, kommt eine Warnung, und die ZIP wird trotzdem geschrieben. Verlauf am Motor 81 statt 35 MB (erstes Packen 8.9 s, danach 0.4 s), am Hotwire 5 statt 4 MB.
- **Grenzen:** Was ältere Projekte schon im Verlauf haben (Analyseergebnisse, Bilder), bleibt drin. Jeder Commit mit geändertem Modell legt weiter eine neue STEP-Fassung ab, gepackt nur kleiner. Getestet unter Windows.
+*Technische Zeichnungen (E76, Wunsch des Nutzers; Prüfungen in `app/test/drawing.mjs`):*
+
+- **Grundidee:** Der Agent zeichnet selbst, soma liefert Werkzeuge statt automatischer Ansichten und Maße. Eine Zeichnung ist eine Python-Datei `drawings/*.py` mit `soma.drawing.Sheet`, mehrere Blätter je Datei möglich. Wie bei den Animationen bekommt sie das eben gebaute Modell als Modul `model`.
+- **Bausteine (`python/soma/drawing.py`):** Blatt A4 bis A0 oder frei, Rahmen und Mittenmarken nach ISO 5457, Schriftfeld nach ISO 7200 (Felder englisch oder deutsch, Symbol der Projektionsmethode 1 oder 3), beides abschaltbar. `view()` projiziert ein Bauteil, eine Gruppe, mehrere, alle oder eine eigene CadQuery-Form in eine der sechs Ansichten, iso oder eine beliebige Richtung, mit eigenem Maßstab, `origin`, `up`, verdeckten Kanten, Tangentenkanten und Stil „phantom“. `section()` schneidet an einer Ebene oder mit einem beliebigen Körper (Halbschnitt, Ausbruch) und schraffiert die Schnittflächen je Teil im Wechsel 45/135°, Teile in `unhatched` bleiben ungeschnitten, mit `parent` entsteht der Schnittverlauf mit Pfeilen und Buchstaben. `detail()` schneidet einen Kreis aus einer Ansicht und vergrößert ihn. Maße an Modellpunkten (`dim` waagerecht, senkrecht, schräg, `diameter`, `radius`, `angle`), Werte immer gemessen, `<>` für den Messwert im Text, Toleranzen. Dazu Mittellinien, Mittenkreuze, Hinweislinien, Texte, Tabellen und `sh.msp` für alles Weitere direkt mit ezdxf.
+- **Technik:** verdeckte Kanten mit `HLRBRep_Algo` aus OCP (Kanten bekommen danach 3D-Kurven, sonst stürzen die Booleschen Operationen der Einzelheit ab), Kanten als LINE, ARC, CIRCLE, ELLIPSE oder Polylinie, echte DIMENSION-Objekte mit `dimlfac`, Layer und Linienarten nach ISO 128. PDF und PNG entstehen aus derselben DXF über das Zeichenmodul von ezdxf mit matplotlib, keine neuen Pakete. Schrift DejaVu Sans (liegt matplotlib bei). Zwei Fehler von ezdxf umgangen: Das Ø wurde in jeder Schrift zum Fleck (Löcher in Zeichen über Verschachtelung gesucht, für Text jetzt mit der Füllregel der Schrift), und Schraffurlinien bekamen einen Zufallsversatz (fester Startwert).
+- **Bytegleich:** Gleiche Zeichnung, gleiche Dateien (DXF mit festen Zeitstempeln und sortierten Klassen, PDF ohne Erstellungsdatum). Ein Neubau ohne Änderung ändert nichts im Verlauf. Das Datum im Schriftfeld ist der Tag des Baus, wenn der Agent keines angibt.
+- **Prüfung (meldet nur, E28):** Text außerhalb des Rahmens oder auf dem Schriftfeld, Ansichten übereinander, Texte und Maßzahlen übereinander, Texte auf Kanten, Maßpunkte auf keiner Kante (mit Hinweis auf gerundete Ecken) oder nur auf verdeckten, Durchmesser ohne passenden Kreis, getippte Zahlen, die vom Messwert abweichen, Text unter 2.5 mm, Maßstab nicht nach ISO 5455, leeres Blatt.
+- **Befehle:** `soma drawing build [Datei]` schreibt `output/drawings/<Name>.pdf` und `.dxf` (im Verlauf und in der ZIP wie `output/model.step`) und ein Bild `.soma/drawings/<Name>.png` mit 200 dpi (längste Seite höchstens 7000 px, nicht in Verlauf und ZIP). Fehler mit Datei und Zeile, Hinweise mit Zeile. `soma drawing list` mit „veraltet“, `soma drawing info` beschreibt Ansichten mit Lage auf dem Blatt, Kreise und Bögen je Ansicht und alle Maße mit Wert. PDF und DXF entfernter Blätter bleiben liegen, die Ausgabe nennt sie.
+- **Für den Agenten:** Skill „Technical drawings“ (`zeichnung.md`, Prüfen und Zeigen, bei Bedarf) mit Best Practices nach ISO 128, 129, 5455, 5456, 7200 und den Werkzeugen, Einstellungen Norm, Blattgröße, Allgemeintoleranz und Sprache. `AGENTS.md` nennt `drawings/` und den Befehl. Der Nutzer öffnet die PDF in der vorhandenen PDF-Ansicht und kann Seiten markieren.
+- **Grenzen:** Kein Agent-Test bisher. Text steht in der PDF als Pfad, „Zitat an Agent“ geht dort nicht. Keine automatische Stückliste (Daten muss der Agent zusammenstellen), keine Gewindedarstellung nach ISO 6410 (Normteile haben kein Gewinde), keine Rasterfelder am Rahmen, kein Eintrag im Umschalter des Viewers. Die Projektion großer Baugruppen ist ungetestet. Getestet unter Windows.
+
*Offen in Phase 1:* Auto-Start des Agenten ohne Resume, Agent-Test mit weiteren Agenten und längeren Sitzungen, Bündelung von Python und Installer, macOS und Linux.
**Danach:** Zukaufteile wie NEMA-17-Motoren und V-Slot-Profile (E48, Wunsch des Nutzers), Versions-Schieber, `soma check` und Projekt-Check, MCP-Server. **Später:** Volumen/Gewicht, Versionsvergleich, eigene Nutzer-Skills, maßhaltiger Sketcher (nur bei Bedarf).
@@ -560,6 +573,7 @@ Alle Codeblöcke der Skills sind gegen die Basisumgebung geprüft (Überhangsuch
- Explosionsansicht (E56, E57, E59): Start bei 50 % des Schiebers mit einer Lücke von 5 % der Modelldiagonale, bei 100 % dreifach, mindestens eine halbe Lücke je Teil. Das größte Teil bleibt stehen. Strahltest mit Punkten 1 ‰ der Diagonale (mindestens 0,1 mm) unter der Oberfläche, Berührung unter 0,4 % (mindestens 0,5 mm), etwa 600 Punkte je Teil. Gruppen aus `group=` zählen nicht mehr. Referenzen bleiben stehen und zählen nicht mit, ausgeblendete Teile zählen mit (sonst spränge die Explosion beim Ausblenden). Wege sind anfangs an und zeigen den eigenen Weg ab dem Elternteil. Messen und Explosion schließen sich aus, ebenso Animation und Explosion.
- Terminal: Strg+V fügt den Text der Zwischenablage selbst ein (bracketed paste), sonst kam bei OpenCode nichts an. Ohne Text (Bild) geht `^V` an das Programm weiter
- Parameter (E74): Dateiname `parameters.json` im Projektordner (sichtbar im Dateibaum, im Editor nur lesbar, Umbenennen gesperrt, Löschen erlaubt und gleichbedeutend mit „Reset all“). Ohne Werte verschwindet die Datei, damit ein Modell wie die Vorlage bleibt. Ein Wert gleich dem im Code wird nicht gespeichert, folgt also späteren Änderungen des Agenten. Fehler im Aufruf von `param()` (Startwert außerhalb des Bereichs, Startwert nicht unter den `options`) brechen den Build ab, Werte des Nutzers außerhalb des Bereichs nicht. Der Agent soll `parameters.json` nur auf Wunsch ändern, und wenn er einen vom Nutzer gesetzten Wert neu festlegen soll, im Code ändern und den Eintrag entfernen. Abgeleitete Werte zum Ansehen (ƒx im Entwurf), Varianten (benannte Wertesätze) und eine Prüfung der Bereichsgrenzen (`soma params check`) fehlen noch
+- Technische Zeichnungen (E76): PDF und DXF nach `output/drawings/` (Lieferdateien, deshalb im Verlauf und in der ZIP), das Bild für den Agenten nach `.soma/drawings/` (wie die Animationen nicht in Verlauf und ZIP). Ein Bild mit 200 dpi, längste Seite höchstens 7000 px. Schrift DejaVu Sans statt einer ISO-Schrift, weil sie überall mit matplotlib vorhanden ist. Schriftfeld mit festem Aufbau 180 mm breit, Felder Firma, Benennung, Gezeichnet, Datum (Standard heute), Zeichnungsnummer, Index, Werkstoff, Allgemeintoleranzen, Maßstab, Format, Projektion, Blatt. A4 hoch, A3 bis A0 quer. Verdeckte Kanten standardmäßig in den sechs Hauptansichten, nicht in iso und Schnitten. Schraffur 2.5 mm, Nachbarteile 45/135°, ab dem dritten Teil weiter. Skill-Kennung `zeichnung`, Kategorie „Check and present“ mit `order` 33, ab Werk „Bei Bedarf“, Einstellungen Norm (ISO/ASME), Blattgröße (A3), Allgemeintoleranz (ISO 2768-m) und Sprache (en). PDF und DXF entfernter Blätter bleiben liegen und werden nur genannt.
- `npm test` läuft über `test/run-all.mjs` mit vier Suiten gleichzeitig und freien Ports (5,5 bis 7 statt 8,5 Minuten, die Animation bestimmt die Dauer und wird unter Last 2 bis 3 Mal langsamer), Watchdog dann 15 Minuten. `soma` lädt cadquery erst in Befehlen, die es brauchen (`soma --version` 0,7 statt 4,4 s)
- Rolle `reference` und ihre Standardwerte (E34)
diff --git a/README.md b/README.md
index 3391d05..2f80afd 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,7 @@ Any CLI agent that can read files and run commands works: Claude Code, OpenCode,
- A model is a single ZIP file with code, result and history
- Every commit of the agent shows up on a timeline below the view, old states can be previewed and restored
- Export to STEP, STL, 3MF, glTF, DXF, SVG and more
+- Technical drawings as PDF and DXF: the agent writes them in Python with views, sections, details and dimensions measured from the model, and checks the result as an image
## Screenshots
diff --git a/app/README.md b/app/README.md
index 9b51a6d..8e33f2e 100644
--- a/app/README.md
+++ b/app/README.md
@@ -25,6 +25,7 @@ npm run test:section # Schnitt: X/Y/Z und an Fläche, Eingabe der Lage, Seite
npm run test:explode # Explosion: Demontage-Analyse (Richtung je Teil, Schrauben durch ihr Kernloch, Stift schräg aus seiner Bohrung, Baugruppe mit eingeschlossener Mutter, Elternteile), gleiche Lücke, Reihenfolge bei 100 %, Abspielen Schritt für Schritt, Reihenfolge an den Agenten, Auswahl in Einbaulage, Messen setzt zusammen, Schnitt dazu, neuer Build (39 Prüfungen)
npm run test:skills # Skills: Panel, Stufen Aus/Bei Bedarf/Immer (Kopie mit oder ohne Hinweis, project.json, zwei Listen in AGENTS.md), Einstellungen (Werte in der Kopie, Prüfung, Standard, vorab bei ausgeschaltetem Skill), Ansehen, An Agent geben, Sicherung geänderter Kopien, fehlende Dateien und falsche Listen nur gemeldet, Snapshot und ZIP, Kategorien, Stufen für neue Modelle (47 Prüfungen)
npm run test:fasteners # Normteile: Maße aus den Tabellen, Lage (at, direction, on, sunk), Bohrungen und Mutternfallen ohne Überschneidung, Einsätze, Fehlermeldungen, Rolle hardware, rotate/translate/moved, Codeblock des Skills „Normteile“, in der App Baum, Auswahl und export --all (37 Prüfungen)
+npm run test:drawing # Technische Zeichnungen (E76): Codeblock des Skills ohne Hinweise, Ansichten, Schnitt, Einzelheit, gemessene Maße, Kreise je Ansicht, DXF mit DIMENSION und Schraffur, bytegleich beim Neubau, Hinweise der Prüfung, Fehler mit Zeile, info und list, verwaiste PDF, kaputtes Modell, in der App PDF im Code-Panel und nichts ungespeichert (23 Prüfungen)
npm run test:animation # Animation, Analyse, soma render und Video: Bauen über den Watcher, Ablauf als Text, Kollisionsprüfung, Fehler mit Ort, Abspielen im Viewer (Lage, Hervorhebung, Kamera), Ausschluss mit Explosion und Messen, Verbindung mit Schlüssel, Bild, Übersicht, MP4 mit WebVTT, Video abspielen und Standbild markieren, Überhang, Wandstärke, Abstand mit Anzeige und Neu berechnen, Beispiel des Skills, ohne App Grenzwert mit Netzgenauigkeit, Teil vor Gruppe, Problemstellen, bessere Druckrichtung, kurze Schritte als eine Zeile, Modell nur einmal ausgeführt (52 Prüfungen)
npm run test:packages # Projektumgebung: klein, pip im Terminal installiert dorthin, Basispakete vorhanden und in der Version festgelegt, requirements.txt aus den Importen des Builds, nicht in Git und ZIP, alter Stand mit eigener Liste, anderer Rechner installiert vor dem Build, Paket ohne Quelle als Hinweis (26 Prüfungen, ohne Netz mit lokalen Wheels)
npm run test:params # Parameter (E74): Panel aus der Leiste, Werte in parameters.json statt im Code, Zurücksetzen einzeln und alle, Komma, Bereich (rot, trotzdem gebaut), Schieber, Sprung in den Code, An Agent geben, Typen (Stepper, Schalter, Auswahl, Text), Gruppen, unpassende Werte und Werte ohne Parameter, gescheiterter Build mit „Back to“, Syntaxfehler vor den Parametern, kaputte Datei, Snapshot und ZIP, leerer Zustand, Bereich des Agenten in der Zeile, Auswertungen mit den Werten des Nutzers und veraltet nach einer Änderung (46 Prüfungen)
@@ -51,8 +52,8 @@ node test/run-all.mjs smoke editor # nur diese, nach npm run build
| `resources/template/` | Vorlage für neue Projekte: `model.py`, `AGENTS.md`, `CLAUDE.md`, `NOTES.md`, `.gitignore` |
| `resources/skills/` | Mitgelieferte Skills (E17), je eine Markdown-Datei: Kopf mit `title`, `summary`, `topics`, `category` (deutsch, Oberfläche), `name` und `when` (englisch, für `AGENTS.md`: Name und Anlass), `order`, `default:` (Stufe bei neuen Modellen: `always`, `on-demand` oder `off`) und optional Einstellungen als `var name: Standard \| Einheit \| Bezeichnung \| 10..85` oder `\| a, b=Anzeige`, darunter die Regeln für den Agenten auf Englisch mit Platzhaltern `{{name}}` |
| `resources/icon.*` | App-Icon (E44) für Fenster und Taskleiste: `icon.svg` als Vorlage, `icon.ico` (16 bis 256 px) und `icon.png`. Neu erzeugen mit `python scripts/make-icon.py` (braucht Edge und Pillow, kleine Größen bekommen einen dickeren Strich) |
-| `../python/soma/` | Hilfsbibliothek und Kommandozeile (`soma build`, `soma export`, `soma glb` für Vorschauen, `soma serve` Messdienst, `soma warm` vorgewärmter Prozess der App, `soma env` und `env.py` Projektumgebung und `requirements.txt` (E67), `measure.py` exakte Werte mit OCC, `fasteners.py` Normteile mit Tabellen aus bd_warehouse in `data/fasteners/`, `anim.py` und `animrun.py` Animationen mit `soma anim`, `analysis.py` Auswertungen mit `soma analyze`, `fem.py` Festigkeit mit `soma analyze fem` (gmsh, pyamg), `render.py` Auftrag an die App für `soma render`, `gltf.py` GLB-Schreiber, `progress.py` Fortschritt langer Befehle) |
-| `test/` | `smoke.mjs`, `versions.mjs`, `editor.mjs`, `measure.mjs`, `groups.mjs`, `section.mjs`, `explode.mjs`, `skills.mjs`, `params.mjs`, `fasteners.mjs`, `animation.mjs` (Ende-zu-Ende), `unit.mjs` (ohne Electron), `harness.mjs` (App starten und steuern), `cdp.mjs` (kleiner DevTools-Client, puppeteer scheitert an Electron 44) |
+| `../python/soma/` | Hilfsbibliothek und Kommandozeile (`soma build`, `soma export`, `soma glb` für Vorschauen, `soma serve` Messdienst, `soma warm` vorgewärmter Prozess der App, `soma env` und `env.py` Projektumgebung und `requirements.txt` (E67), `measure.py` exakte Werte mit OCC, `fasteners.py` Normteile mit Tabellen aus bd_warehouse in `data/fasteners/`, `anim.py` und `animrun.py` Animationen mit `soma anim`, `analysis.py` Auswertungen mit `soma analyze`, `fem.py` Festigkeit mit `soma analyze fem` (gmsh, pyamg), `render.py` Auftrag an die App für `soma render`, `drawing.py` und `drawrun.py` technische Zeichnungen mit `soma drawing` (E76: HLR aus OCP, DXF mit ezdxf, PDF und PNG über matplotlib, Prüfung), `gltf.py` GLB-Schreiber, `progress.py` Fortschritt langer Befehle) |
+| `test/` | `smoke.mjs`, `versions.mjs`, `editor.mjs`, `measure.mjs`, `groups.mjs`, `section.mjs`, `explode.mjs`, `skills.mjs`, `params.mjs`, `fasteners.mjs`, `drawing.mjs`, `animation.mjs` (Ende-zu-Ende), `unit.mjs` (ohne Electron), `harness.mjs` (App starten und steuern), `cdp.mjs` (kleiner DevTools-Client, puppeteer scheitert an Electron 44) |
## Noch nicht enthalten (siehe PLAN.md, Abschnitt 10)