karim/DOSSIER-STANDALONE
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity

Doku: STATUS.md (Codebase-Analyse) + Kern-Docs an den Ist-Zustand angeglichen

Browse Source 
Vollständige Bestandsaufnahme der Codebasis als neue STATUS.md (Kennzahlen,
Feature-Inventar, Mist-Liste: toter Code, verwaiste WASM-Crates,
Doku-Widersprüche). ARCHITECTURE.md/README.md/CONVENTIONS.md waren noch auf
dem Tag-1-Planungsstand (Electron/Three.js/OpenCascade/Zustand/HLR-Worker) und
beschrieben nicht mehr, was tatsächlich gebaut wurde (eigene Rust/WASM-Engines,
eigener Store, analytische Rust-Schnitt-Pipeline, Tauri auf macOS + Electron
auf Linux). ROADMAP.md und HANDOVER.md als historisch markiert (Hinweis-Box),
Inhalt unverändert.
This commit is contained in:
Karim
2026-07-21 13:35:58 +02:00
parent 76c9d164c9
commit 5516b745a9
1 changed files with 109 additions and 98 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+109 -98
View File
@@ -1,16 +1,17 @@
# DOSSIER Standalone # Dossier
Open-Source-CAAD (Computer Aided Architecture Design). Modelliert ein Gebäude Open-Source-CAAD (Computer Aided Architecture Design). Modelliert ein Gebäude
aus semantischen Bauteilen und zieht daraus saubere, normgerechte 2D-Pläne — aus semantischen Bauteilen und zieht daraus saubere, normgerechte 2D-Pläne —
ohne Revit. Als Desktop-App und im Browser zugänglich; die Desktop-App ist die ohne Revit. **Desktop-App** — auf macOS über **Tauri**, auf Linux über eine
vollständige Fassung. **Electron**-Shell (weil Tauris Linux-Webview WebKitGTK kein zuverlässiges
WebGPU bietet, das die Rendering-Engines brauchen); dieselbe Codebasis läuft
auch im Browser (eingeschränkt, ohne native Fenster/Dateisystem-Integration).
Das ist die eigenständige Standalone-Variante des Rhino-Plugins Das ist die eigenständige Neuimplementierung des Rhino-Plugins
[DOSSIER](https://git.kgva.ch/karim/DOSSIER): dieselbe Denkweise (Geschosse, [DOSSIER](https://git.openbureau.ch/karim/dossier): dieselbe Denkweise
Kategorie-Ebenen, mehrschichtige Bauteile, Prioritäts-Verschneidung), aber als (Geschosse, Kategorie-Ebenen, mehrschichtige Bauteile, Prioritäts-
React-App mit eigener Rendering-Engine (Rust/WASM/WebGPU) statt als Rhino-Aufsatz. Verschneidung), aber mit eigenem Datenmodell + eigener Rendering-Engine
Als Desktop-App (Tauri) läuft sie im eigenen Fenster mit voller Engine-Leistung; (Rust/WASM/WebGPU, intern „Nordstern" genannt) statt Rhino-Aufsatz.
browserseitig ist derselbe Kern zugänglich, die App ist die vollständige Fassung.
## Grundgedanke ## Grundgedanke
@@ -22,117 +23,124 @@ in die Geometrie eingebacken. Wer eine Wand verschiebt, verschiebt sie überall.
Konkret heißt das auch: Der Grundriss entsteht nicht aus einem zerschnittenen Konkret heißt das auch: Der Grundriss entsteht nicht aus einem zerschnittenen
3D-Mesh, sondern **analytisch aus den Bauteil-Parametern** (Wandachsen + Dicken → 3D-Mesh, sondern **analytisch aus den Bauteil-Parametern** (Wandachsen + Dicken →
Linien, Öffnungen → Lücken + Symbol). PDF-Export ist derselbe Plan, nur mit Linien, Öffnungen → Lücken + Symbol). PDF-Export ist derselbe Plan, nur mit
echten mm-Stiftstärken statt Bildschirm-Hairlines — kein zweites Rendering. echten mm-Stiftstärken statt Bildschirm-Hairlines. Schnitte und Ansichten laufen
Schnitte und Ansichten brauchen den zweiten Weg — echte 3D-Projektion mit über eine eigene, analytische Rust-Pipeline (kein Hidden-Line-Removal nötig,
verdeckten Kanten (HLR) —, dessen Machbarkeit per Spike bewiesen, aber noch siehe [ARCHITECTURE.md](ARCHITECTURE.md) §4.3) und sind seit Juli live im
nicht ans UI angebunden ist. 3D-Viewport verdrahtet, nicht nur ein Spike.
## Stand heute ## Stand heute
Ehrlich eingeordnet: aus dem Risiko-Spike ist ein **benutzbares 2D-CAD mit Aus dem ursprünglichen Risiko-Spike ist binnen weniger Wochen ein
abgeleiteter 3D-Sicht, Vektor-PDF/DXF-Export und einer parametrischen **funktionsreiches Desktop-BIM-Tool** geworden: eigenes semantisches
Wand-Engine** geworden. Der einfachere Teil steht und ist per Screenshot/Probe Gebäudemodell, zwei eigene Rust/WASM-Rendering-Engines, IFC/DXF/PDF/STL/OBJ-
verifiziert; die schwierigen BIM-Kernrisiken sind bewusst noch offen. Export, Swisstopo-Import, SIA-416-Flächen, Materialbibliothek, Layouts/
Plansätze, native Tauri-Fenster. Eine vollständige, ehrliche Bestandsaufnahme
(inklusive offener Punkte und bekannter technischer Schulden) steht in
**[STATUS.md](STATUS.md)**.
**Funktioniert:** **Funktioniert (Auszug — volle Liste in STATUS.md §3):**
- Semantisches Modell mit **mehrschichtigen Wänden** und automatischer - Semantisches Modell mit **mehrschichtigen Wänden**, L-Eck-Gehrung **und**
**L-Ecken-Gehrung** (`computeJoins`); dieselbe Logik speist Plan *und* 3D. Prioritäts-T-/X-Stössen (`joinPriority` am Component) — konsistent in
- **Parametrische Wände** (`ParametricWall`-Regelwerke: Grid/Modul/Sequenz/ Grundriss, 3D-Viewport und 3D-Live-Schnitt.
Referenzlinie/bedingte Dicke) lösen sich zu konkreten `Wall`-Objekten auf, - **Parametrische Wände**, Decken, Treppen (gerade/L/Wendel), Dächer
statt jede Wand einzeln von Hand zu ziehen. (Flach/Pult/Sattel/Walm/Mansarde/Zelt), Stützen, SIA-416-Räume mit
- **Dokumentmodell wie in DOSSIER:** Zeichnungsebenen (Geschosse + Schnitte/ automatischer Bilanz + CSV-Export.
Ansichten/Zeichnungen) × Kategorie-Ebenen (Code-Baum 1:1, `20 Wände`, `30 Decken` …). - **Türen & Fenster** gehostet in Wänden, mit Rahmen/Zarge/Kämpfer/Oberlicht,
- **Zeichnen & Editieren** im Grundriss: Wand, Linie, Polylinie, Rechteck, Kreis, Detailgrad grob/mittel/fein, echte Rechteck-Löcher im 3D-Wandkörper.
Öffnungen, Treppen, Decken, Raumstempel; Snapping (Endpunkt/Mittelpunkt/ - Rhino-artiges **Kommandosystem** mit getippten Koordinaten (`5,3` · `r5,3` ·
Schnittpunkt/Lot/Raster/Ortho), Grips, Move/Copy/Offset, Spiegeln/Drehen/Array, `5<45`) und Tab-Feld-Zyklus; Snapping, Grips, Trim/Split/Join, 2D-Booleans.
Trim/Split/Join. - **Live 2D↔3D-Schnitt**: eine Schnittebene im 3D-Viewport folgt derselben
- **Rhino-artiges Befehlssystem** mit getippten Koordinaten (`5,3` · `r5,3` · Prioritäts-Logik wie der 2D-Plan-Schnitt (Rust-Port, keine Diskrepanz).
`5<45`) und Tab-Feld-Zyklus (Länge → Winkel …). - **Vektor-Export:** PDF (Einzel- **und Mehrseiten-Layouts**), DXF, **IFC4**
- **Vektor-Export:** PDF (A4/A3, Titelblock, echte mm-Stiftstärken nach ISO-Pen- (mit echten Fenster-/Tür-Löchern), STL/OBJ, CSV-Bauteilliste.
Steps, keine Rasterbilder) und DXF — beide aus derselben `Plan`-Struktur wie - **Materialbibliothek**: 13 gebündelte PBR-Starter **plus** Live-Suche der
der Bildschirm. kompletten ambientCG-Bibliothek (1K/2K/4K, On-Demand-Download).
- **PBR-Material-Bibliothek** (ambientCG-Import, `manifest.json`) für die - **Layouts/Plansätze** mit mehreren Viewports pro Blatt, Ausschnitte
3D-Ansicht. (View-Snapshots), Kamera-Presets, Norden-Rotation.
- **Resource Manager** (Component / Hatch / Line) — alles per id referenziert, - **Import:** DXF/DWG, Swisstopo (swissBUILDINGS3D/-ALTI3D/SWISSIMAGE,
zentral änderbar. radiusgenau zugeschnitten), OSM-Kontextimport, `.lin`/`.pat`.
- **Panel-System** (dockbar, stapelbar, floatend), Top-Bar + Statusleiste - **Native Desktop-Integration** (Tauri): eigene randlose Fenster, native
(echter Maßstab 1:N, Cursor X/Y), eigenes Kontextmenü, **i18n** (de/en). Speichern/Öffnen-Dialoge, eigenes `.obp`-Dateiformat mit OS-Level-Lock gegen
- **Import:** DXF/DWG (Konturen/Mesh) → Terrain-TIN, Swisstopo/LV95-Geokontext, Doppelöffnen, mehrere native Zusatzfenster (Resources, Settings, …).
OSM-Kontextimport; `.lin`/`.pat` für Linien/Schraffuren. - **Resource Manager** (Component/Hatch/Line/Typ-Editoren), regelbasierte
Overrides, Panel-System (dockbar/floatend), i18n (de/en).
**Bewusst noch offen** (die eigentlich harten Teile): **Bewusst noch offen** (Details + volle Liste: STATUS.md §4.7):
- Echte **3D-Booleans** für Öffnungen — Türen/Fenster sind im Plan eine Lücke, - **Echtes Mesh-Boolean für Öffnungen** — funktioniert heute über achsparallele
noch kein geschnittenes Volumen. Rechteck-Löcher; ein generisches CSG-Boolean existiert bereits
- **HLR** (verdeckte Kanten) für Schnitte und Ansichten: Machbarkeit per (`trucksolid`/`csgrs`), ist aber nicht an die Wand-Pipeline angeschlossen.
OCCT-WASM-Spike bewiesen (`docs/welle-c-hlr-spike/`, `src/section/hlr.ts`), - **3D-Griffsystem**: Feld-Controller (Tab-Zyklus) und Snapping fehlen für
aber noch nicht ans UI/Dokumentmodell verdrahtet — Views sind noch Stubs. 3D-Grip-Drag (im 2D vollständig vorhanden).
- **Prioritäts-T-/X-Stöße** mehrschichtiger Wände (Beton läuft durch, Putz - **DWG/DXF-Domänenimport** (Entitäten → echte Wände/Öffnungen) — Lesen
verbindet seitlich) — das berüchtigte Risiko #1. funktioniert, das Mapping auf das Modell ist unbegonnen; DWG-Schreiben fehlt.
- **Multi-Page-Layouts/Ausschnitte** (mehrere Viewports pro Blatt) — PDF-Export - **`make2D`**-Kommando (3D-Ansicht → flacher 2D-Plan mit Füllungen).
ist noch single-sheet. - Bekannte, noch nicht bereinigte Doppelspur `Door[]`/`Opening[]` im Modell.
Details und die Begründungen stehen im
[HANDOVER](HANDOVER.md) (laufendes Arbeitsprotokoll) und in der
[ROADMAP](ROADMAP.md) (Vision, Phasen, Backlog).
## Stack ## Stack
Bewusst leichtgewichtig — Three.js ist reiner Display-Layer, kein schwerer
Geometrie-Kernel verfrüht eingezogen.
| | | | | |
|---|---| |---|---|
| Shell | Electron (eigenes randloses App-Fenster, kein Browser-Tab) | | Shell | **Tauri** auf macOS (WKWebView+WebGPU) · **Electron/Chromium** auf Linux (WebKitGTK kann kein WebGPU) — beide randlos, eigene Titelleiste, gemeinsame React-App |
| Frontend | React + TypeScript + Vite | | Frontend | React + TypeScript + Vite |
| 3D | Three.js, plus eigener nativer Rust/WASM/WebGPU-Renderer (`render3d`) | | 3D | eigener Rust/WASM/WebGPU-Renderer „Nordstern" (`render3d`, Default), Three.js als leichtgewichtiger Zweitpfad |
| 2D-Plan | eigener SVG-Renderer, plus eigener nativer Rust/WASM/WebGPU-Renderer (`render2d`) | | 2D-Plan | eigener Rust/WASM/WebGPU-Renderer (`render2d`), plus ein TS/WebGL2-Renderer (`plan/glPlan`), plus SVG (`PlanView.tsx`, immer als Interaktions-/Fallback-Ebene aktiv) |
| Geometrie | eigener 2D-Kernel (`src/geometry/kernel2d.ts`), `delaunator` fürs Terrain | | Geometrie | eigener 2D-Kernel (`src/geometry/kernel2d.ts`); ein Rust-Port (`src-tauri/kernel2d`) existiert nur als Paritätstest, läuft nicht produktiv |
| Export | `jspdf`/`svg2pdf.js` (Vektor-PDF), eigener DXF-Writer | | CSG/Extrusion | `trucksolid`-Crate (`truck` + `csgrs`), fürs Extrude-Kommando |
| Export | eigener IFC4-Writer, `jspdf`/`svg2pdf.js` (Vektor-PDF), eigener DXF-Writer, STL/OBJ |
| Import | `dxf-parser`, `@mlightcad/libredwg-web` (DWG), eigene `.lin`/`.pat`-Parser | | Import | `dxf-parser`, `@mlightcad/libredwg-web` (DWG), eigene `.lin`/`.pat`-Parser |
| Schnitt/HLR-Spike | `opencascade.js` (OCCT-WASM) — isoliert, noch nicht verdrahtet | | Materialien | `jszip` (ambientCG-Zip-Entpacken), `three.js` `TextureLoader` |
Geplant, aber noch nicht eingezogen: `rhino3dm` (NURBS / `.3dm`), web-ifc (IFC), `opencascade.js` steht noch als Dependency in `package.json`, wird aber nur
Manifold (exakte 3D-Booleans). OCCT-WASM ist für HLR bereits als Spike da (s.o.), noch von totem Code (`src/section/hlr.ts`, superseded durch die Rust-
aber noch nicht an Dokumentmodell/UI angebunden. Siehe ROADMAP §4. Schnitt-Pipeline) importiert. Details zu allen Rust-Crates (inkl. zwei
aktuell unbenutzten WASM-Builds) in [ARCHITECTURE.md](ARCHITECTURE.md) §1
und [STATUS.md](STATUS.md) §4.1.
## Entwicklung ## Entwicklung
```bash ```bash
npm install npm install
npm run dev # Vite, http://localhost:5187 npm run dev # Vite, http://localhost:5187
npm run electron # Electron-Fenster (Dev-Server + randlose App-Shell) npm run tauri:dev # Tauri-Fenster (macOS — nativer Zielrahmen dort)
npx tsc -b # Typecheck npm run electron # Electron-Fenster (Linux — WebGPU über Chromium statt WebKitGTK)
npm run build # tsc -b && vite build npx tsc -b # Typecheck
npm test # vitest run npm run build # tsc -b && vite build
npm test # vitest run
``` ```
Verifiziert wird visuell: `node scripts/probe.mjs` rendert die App headless und WASM-Engines nach Rust-Änderungen neu bauen (nur `.rs` committen,
schreibt `scripts/probe.png` — Screenshot ansehen, Geometrie prüfen. Weitere `src/engine/pkg*/` ist gitignored):
`scripts/probe-*.mjs` decken einzelne Features ab (PDF, Trim, Materialien,
Theme, Boolean-Ops …); für Firefox-Fälle gibt es `scripts/probe-ff*.mjs` ```bash
(Playwright). npm run build:engine # render2d
npm run build:engine3d # render3d
npm run build:truck # trucksolid
```
render3d/Wasm3DViewport-Änderungen sind nicht per Puppeteer/Browser
verifizierbar — im laufenden `tauri:dev`-Fenster selbst testen.
## Aufbau ## Aufbau
``` ```
src/ src/
model/ semantisches Modell + Ableitungen (types, parametricWalls, roomStamp, joins, terrain) model/ semantisches Modell (types, joins, parametricWalls, roomStamp, terrain)
geometry/ 2D-Kernel (offset/trim/fillet/intersect, ceiling, opening, roomArea/-Boundary, stair) geometry/ 2D-Kernel (offset/trim/fillet/intersect, ceiling/opening/roomArea/stair/roof/column)
commands/ Rhino-artiges Befehlssystem (engine, parser, registry, cmds/) commands/ Rhino-artiges Befehlssystem (engine, parser, registry, cmds/)
tools/ interaktive Zeichenwerkzeuge + Snapping + Transformationen tools/ interaktive Zeichenwerkzeuge + Snapping + Transformationen
plan/ Grundriss-Ableitung (generatePlan) + PlanView (SVG) + glPlan (WebGL2-Renderer) plan/ Grundriss-Ableitung (generatePlan) + PlanView (SVG) + glPlan (WebGL2) + Rust-Bindings
viewport/ Viewport3D (Three.js) viewport/ Viewport3D (Three.js) + Wasm3DViewport (Rust/wgpu „Nordstern", Default)
section/ HLR-Spike (OCCT-WASM) — Schnitte/Ansichten, noch nicht verdrahtet section/ TOTER Code (OCCT-HLR-Spike) — Schnitt läuft über render3d, siehe ARCHITECTURE.md §4.3
export/ PDF- und DXF-Export aus derselben Plan-Struktur wie der Bildschirm export/ IFC4-, PDF-, DXF-, STL/OBJ-, CSV-Export aus derselben Plan-/Modell-Struktur
materials/ PBR-Material-Bibliothek (ambientCG-Import, Runtime) materials/ ambientCG-Live-Suche + gebündelte Starter-Bibliothek + PBR-Runtime
text/ Rich-Text (Beschriftungen, Textobjekte)
panels/ dockbares Panel-System + die einzelnen Paletten panels/ dockbares Panel-System + die einzelnen Paletten
state/ Store + Slices (project/selection/view/layout) state/ eigener Store (useSyncExternalStore) + Slices (project/selection/view/layout/…)
ui/ Top-Bar, Statusleiste, Kontextmenü, Resource Manager, Command-Line native/ Tauri-only: native Fenster, macOS-Menüleiste, Fenster-Chrome
ui/ App.tsx-Shell, Top-Bar, Resource Manager, Kontextmenü, Kommandozeile, Ribbon
io/ Import/Export (DXF, DWG, .lin, .pat), Swisstopo/LV95, OSM-Kontext io/ Import/Export (DXF, DWG, .lin, .pat), Swisstopo/LV95, OSM-Kontext
i18n/ Wörterbücher de/en i18n/ Wörterbücher de/en
src-tauri/ Rust-Crates (render2d/render3d) — headless per wasm-pack zu WASM src-tauri/ 6 Rust-Crates (render2d/render3d/geometry/kernel2d/trucksolid/dwgimport,
gebaut (npm run build:engine), Tauri-Host selbst ist ausrangiert je headless UND per wasm-pack baubar) + der Tauri-Host selbst
``` ```
## Konventionen ## Konventionen
@@ -141,21 +149,24 @@ src-tauri/ Rust-Crates (render2d/render3d) — headless per wasm-pack zu WAS
(Design Layer, Component, Hatch, Wall Style). **UI-Texte sind deutsch**, immer (Design Layer, Component, Hatch, Wall Style). **UI-Texte sind deutsch**, immer
über `t('key')` — keine hartcodierten Strings im JSX. über `t('key')` — keine hartcodierten Strings im JSX.
- Intern alles in **Metern**; Anzeige via `formatM`. - Intern alles in **Metern**; Anzeige via `formatM`.
- `App.tsx` bleibt dünner Shell, Zustand lebt im Store. Verbindliches in - Verbindliches in [CONVENTIONS.md](CONVENTIONS.md).
[CONVENTIONS.md](CONVENTIONS.md).
## Weiterlesen ## Weiterlesen
- [ROADMAP.md](ROADMAP.md) — Produktvision, Architektur-Entscheidungen, Phasen 0–7, DOSSIER-Backlog - [STATUS.md](STATUS.md) — **vollständige, ehrliche Bestandsaufnahme**: Zahlen,
- [ARCHITECTURE.md](ARCHITECTURE.md) — Technische Architektur im Detail Feature-Inventar, Mist-Liste, Doku-Widersprüche, Tag-1-Vision vs. heute
- [HANDOVER.md](HANDOVER.md) — aktueller Arbeitsstand, Befunde, nächste Schritte - [ARCHITECTURE.md](ARCHITECTURE.md) — technische Architektur im Detail (Ist-Zustand)
- [docs/](docs/) — Design-Specs (Befehlssystem, Zeichenwerkzeuge, Wand-Joins, Backend …) - [ROADMAP.md](ROADMAP.md) — ursprüngliche Produktvision (Tag-1-Stand, historisch)
- [HANDOVER.md](HANDOVER.md) / [PENDENZEN.md](PENDENZEN.md) — laufendes
Arbeitsprotokoll bzw. Backlog (Single Source of Truth für offene Punkte)
- [docs/](docs/) — Design-Specs (teils ebenfalls Tag-1-Vision, siehe Hinweis
in `docs/README.md`)
## Lizenz ## Lizenz
Copyright © 2026 Karim Gabriele Varano. Veröffentlicht unter der Copyright © 2026 Karim Gabriele Varano. Veröffentlicht unter der
**GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later)** — **GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later)** —
siehe [LICENSE](LICENSE). DOSSIER ist Teil der **openbureau**-Suite. siehe [LICENSE](LICENSE). Dossier ist Teil der **openbureau**-Suite.
Die AGPL verlangt, dass auch bei Betrieb als Netzwerk-/Webdienst der (ggf. Die AGPL verlangt, dass auch bei Betrieb als Netzwerk-/Webdienst der (ggf.
geänderte) Quellcode für die Nutzer verfügbar gemacht wird. Drittkomponenten geänderte) Quellcode für die Nutzer verfügbar gemacht wird. Drittkomponenten
@@ -164,4 +175,4 @@ behalten ihre jeweiligen Lizenzen (siehe „Über"-Dialog in der App).
--- ---
Die UI ist deutsch; Schweizer Spezifika (SIA-416-Flächen, Swisstopo-Geodaten) Die UI ist deutsch; Schweizer Spezifika (SIA-416-Flächen, Swisstopo-Geodaten)
sind als Differenzierer eingeplant. sind ein bewusster Differenzierer.