Initial commit: Rapport Website (Hugo + Hextra)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-26 11:52:03 +02:00
commit e007bdd4e7
480 changed files with 41697 additions and 0 deletions
@@ -0,0 +1,62 @@
+---
+title: Erste Schritte
+linkTitle: Erste Schritte
+weight: 1
+toc: true
+---
+
+Von der Installation bis zur ersten Rechnung — in sechs Schritten.
+
+## 01 · Installation
+
+DMG von [Gitea Releases](https://git.kgva.ch/karim/RAPPORT/releases) herunterladen. Rapport in den **Programme-Ordner** ziehen. Beim ersten Start: *Systemeinstellungen → Datenschutz & Sicherheit* öffnen und Rapport zulassen.
+
+Die Pre-Release-Builds sind **signiert über Tauri**, aber (noch) nicht über die Apple-Notarisierung gegangen — daher der manuelle Freigabe-Schritt.
+
+## 02 · Einrichtung
+
+In den **Einstellungen** hinterlegen:
+
+- **Bürodaten** — Name, Adresse, IBAN, Logo
+- **Mitarbeiter** — Namen, Pensum, Stundensatz, Ferienanspruch
+- **Kunden** — Adresse, Ansprechperson, Honorartyp
+- **Projekte** — SIA-102-Phasen, Budget, Beteiligte
+
+Danach ist die Zeiterfassung bereit.
+
+## 03 · Zeiterfassung
+
+Im Modul **Zeit**:
+
+1. Mitarbeiter wählen
+2. Woche navigieren
+3. Stunden per **Klick** oder **Drag** erfassen
+4. Jedem Eintrag ein Projekt zuweisen
+
+Auswertungen pro Mitarbeiter und pro Projekt sind unter *Zeit → Auswertungen* abrufbar. Halbe Tage und Mehrfacheinträge pro Slot werden unterstützt.
+
+## 04 · Rechnungen
+
+Aus einer **Offerte** oder **direkt** erstellen:
+
+- SIA-Phasen, Stundensatz oder Pauschal wählen
+- Akonto-, Teil- oder Schlussrechnung
+- Mit *PDF exportieren* wird die fertige Rechnung inkl. **QR-Einzahlungsschein** generiert
+
+Offerten lassen sich nahtlos in Projekte und Rechnungen konvertieren.
+
+## 05 · Backup
+
+In der Desktop-App liegen alle Daten als **JSON** im Applikationsordner:
+
+```text
+~/Library/Application Support/com.rapport.app/
+```
+
+Für ein Backup reicht es, diesen Ordner zu kopieren — z. B. auf einen externen Datenträger oder in die Cloud. Empfohlen: regelmässig (wöchentlich oder via Time Machine). Im Server-Modus läuft das Backup über Postgres-Dumps — siehe [Rapport Server § Backup](../../server/#backup).
+
+## 06 · Probleme melden
+
+Ein [Issue auf Gitea](https://git.kgva.ch/karim/RAPPORT/issues) erstellen — mit kurzer Beschreibung, was passiert ist. **Screenshots helfen.** Bitte die Rapport-Version (links unten in der App) angeben.
+
+> **Tipp:** Wenn die App nicht mehr startet, hilft oft, den Cache-Ordner zu sichern und neu zu starten. Die JSON-Daten selbst bleiben unverändert.