---
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 >}}