Files
DOSSIER-WEBSITE/content/docs/erste-schritte.md
T
karim c0a5de194f Refresh site copy to reflect current Dossier state
- Move Display-Mode "Dossier Plan" to shipped; describe walls as multilayer
  with T-/L-/X-joints and Sturz/Brüstung openings; expand stairs depth and
  configurable 2D plan display
- Drop BIM framing and identity-by-negation throughout
- Replace named CAD product comparisons with generic phrasing
- Remove unsupported "6+ months in production" claim
- Use "Python 3.9" instead of "CPython 3.9" in user-facing copy
- Rename "Tauri-Launcher" card to "Launcher" and drop sparkles icon

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-29 01:33:38 +02:00

112 lines
3.5 KiB
Markdown

---
title: Erste Schritte
linkTitle: Erste Schritte
weight: 1
next: docs/architektur
---
DOSSIER in **5 Minuten** zum Laufen bringen.
## Voraussetzungen
| Tool | Version |
|--------|------------------------------------------|
| Rhino | 8 (Mac · Windows getestet, primär Mac) |
| Python | 3.9 (Rhino 8 Script-Editor-Engine) |
| Node | ≥ 20 (nur für UI-Builds — fertige Distribution braucht das nicht) |
Optional — für den Standalone-Launcher:
| Tool | Version |
|---------------|------------------------------------------------|
| Rust toolchain| ≥ 1.77 (`rustup`) |
| Build-Tools | siehe [Tauri Prerequisites](https://v2.tauri.app/start/prerequisites/) |
## Installation
{{% steps %}}
### Repository klonen
```bash
git clone https://git.kgva.ch/karim/DOSSIER.git
cd DOSSIER
npm install
```
### Frontend bauen
```bash
npm run build # → dist/index.html (inline-fähig)
```
### Plugin in Rhino starten
In Rhino 8 den Initialisierer über `_ScriptEditor` öffnen — die Datei `rhino/startup.py` laden und auf **Run** klicken. Sie liest die `dossier.project.json` neben der `.3dm` und lädt nur die dort gelisteten Module (oder alle, falls keine Projekt-Datei vorhanden).
Für automatisches Laden bei jedem Rhino-Start: Rhino-Optionen → *General**Run these commands every time a model is opened*:
```text
_-RunPythonScript "<DOSSIER_PFAD>/rhino/startup.py"
```
{{< callout type="info" >}}
**`<DOSSIER_PFAD>`** durch den absoluten Pfad zum geklonten Repository ersetzen — z.B. `/Users/dein_user/STUDIO/DOSSIER` auf macOS oder `C:\Users\dein_user\STUDIO\DOSSIER` auf Windows. Rhino expandiert `~` in diesem Kontext nicht.
{{< /callout >}}
Der Launcher trägt diesen Eintrag automatisch mit dem korrekten Pfad ein.
### Auto-Reset nach Änderungen
Bei Python-Änderungen die Panels neu laden:
```text
_RunPythonScript <DOSSIER_PFAD>/rhino/_reset_panels.py
```
{{% /steps %}}
## Erster Workflow
{{% steps %}}
### Projekt anlegen
In Rhino `DossierInit` aufrufen. Bürodaten, Projektnummer und Phasenbezeichnung werden im `.3dm` hinterlegt und in jedem Plankopf eingesetzt.
### Geschosse definieren
Im **EBENEN**-Panel Geschosse mit Name (`EG`, `1OG`, …), Höhe und OKFF anlegen. Dossier baut daraus die Layer-Hierarchie:
```text
10_GRUNDRISSE
└── EG
├── 20_WAENDE
├── 30_DECKEN
├── 31_DAECHER
└── 40_TREPPEN
└── 1OG (gleiche Sublayer)
```
### Smart-Elemente platzieren
Im **ELEMENTE**-Panel das gewünschte Bauteil wählen — Wand, Decke, Öffnung, Treppe, Tragwerk oder Raum. Source-Geometrie zeichnen (Achse, Outline, Punkt), Volumen wird automatisch generiert.
### Plan generieren
**Named Views** für Grundrisse, Schnitte und Axonometrien speichern. Im **LAYOUTS**-Panel Vorlage wählen, Views auf das Blatt ziehen, Plannummer vergeben. Dossier erzeugt das Layout mit Titelblock und passt den Massstab automatisch an.
### Export
Stapelexport aller Pläne als PDF oder PNG aus dem **LAYOUTS**-Panel. Optional mit Plannummer-Suffix im Dateinamen und Vektordaten für die Druckfreigabe.
{{% /steps %}}
## Wo geht's weiter?
{{< cards >}}
{{< card link="../features" title="Features" subtitle="Alle Panels im Detail." >}}
{{< card link="architektur" title="Architektur" subtitle="Module, Bridges, Sticky-Storage." >}}
{{< card link="../faq" title="FAQ" subtitle="Häufige Fragen." >}}
{{< /cards >}}