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,20 @@
+---
+title: Features
+linkTitle: Features
+weight: 2
+---
+
+Die Bausteine von RAPPORT — Studio-Management für Schweizer Architekturbüros.
+
+## Module
+
+{{< cards >}}
+  {{< card link="zeiterfassung" title="Zeiterfassung" subtitle="Tages- & Wochenraster mit Drag & Drop." >}}
+  {{< card link="rechnungen" title="Rechnungen & Offerten" subtitle="QR-Einzahlungsscheine, SIA-Phasen, Akonto." >}}
+  {{< card link="projekte" title="Projekt- & Kundenverwaltung" subtitle="SIA 102, Budget, Phasen, Beteiligte." >}}
+  {{< card link="mitarbeiter" title="Mitarbeiter" subtitle="Ferien, Absenzen, Lohnabrechnung." >}}
+  {{< card link="spesen" title="Spesen & Bürobudget" subtitle="Belegupload, Jahresbudget, Internes." >}}
+  {{< card link="protokolle" title="Protokolle & Lieferscheine" subtitle="Sitzungsprotokolle, Briefe, Lieferscheine." >}}
+  {{< card link="auto-updater" title="Auto-Updater" subtitle="Signierte Updates via Tauri." >}}
+  {{< card link="system-tray" title="System-Tray" subtitle="Hide-on-Close, Quick-Open." >}}
+{{< /cards >}}
@@ -0,0 +1,49 @@
+---
+title: Auto-Updater
+linkTitle: Auto-Updater
+weight: 7
+toc: true
+---
+
+<span class="rapport-status new">Neu in 0.7.0</span>
+
+**Rapport prüft beim Start automatisch auf neue Versionen** und installiert Updates signiert über Tauri. Einzelne Versionen können übersprungen werden.
+
+## Funktionsweise
+
+Beim App-Start:
+
+1. Abfrage gegen `https://git.kgva.ch/karim/RAPPORT/releases/latest.json`
+2. Versionsvergleich mit lokaler `version` im Tauri-Bundle
+3. Bei neuer Version → Update-Dialog
+4. Bei Bestätigung → Download + Signaturprüfung + Installation + Neustart
+
+## Sicherheit
+
+- Updates werden mit dem **Tauri-Updater-Schlüssel** signiert
+- Manipulierte Downloads werden abgelehnt
+- Quellcode und Build sind reproduzierbar (Gitea CI, geplant)
+
+## Optionen
+
+- **Update installieren** — Download & Neustart
+- **Diese Version überspringen** — überspringt nur diese eine Version
+- **Später erinnern** — beim nächsten Start erneut fragen
+
+Updates können in den Einstellungen komplett deaktiviert werden.
+
+## Latest-Endpoint
+
+```json
+{
+  "version": "0.8.3",
+  "notes": "Rapport 0.8.3",
+  "pub_date": "2026-05-24T00:00:00Z",
+  "platforms": {
+    "darwin-aarch64": {
+      "signature": "…",
+      "url": "https://git.kgva.ch/karim/RAPPORT/releases/download/0.8.3/RAPPORT%20PRE-RELEASE.app.tar.gz"
+    }
+  }
+}
+```
@@ -0,0 +1,52 @@
+---
+title: Mitarbeiter
+linkTitle: Mitarbeiter
+weight: 4
+toc: true
+---
+
+<span class="rapport-status active">In Arbeit</span>
+
+**Ferienverwaltung, interne Stunden / Absenzen und Lohnabrechnung.** Jahresabschluss mit Überstundenausgleich.
+
+## Stammdaten
+
+Pro Mitarbeiter:
+
+- Name, Eintrittsdatum, Pensum (%)
+- Stundensatz (intern, für Rechnungen)
+- Ferienanspruch (Tage / Jahr)
+- Lohn (monatlich, brutto)
+
+## Ferienverwaltung
+
+- **Prorata-Berechnung** bei Eintritt unter Jahr
+- **Ferien-Saldo** in Tagen (live)
+- **Halbtage** unterstützt
+- **Übertrag** ins Folgejahr oder Auszahlung
+
+## Absenzen
+
+Krankheit, Militär, Mutterschaft, unbezahlter Urlaub — getrennt erfasst, mit Auswertung pro Mitarbeiter.
+
+## Lohnabrechnung
+
+Monatliche Abrechnung mit:
+
+- Grundlohn (basierend auf Pensum)
+- Überstunden-Vergütung
+- Spesen-Erstattung
+- Sozialabzüge (AHV, ALV, Pensionskasse)
+
+PDF-Export pro Mitarbeiter.
+
+## Jahresabschluss
+
+- Ferien-Restguthaben übertragen oder auszahlen
+- Überstunden ausgleichen oder vergüten
+- Lohnausweis vorbereiten (Export)
+
+## Verwandte Module
+
+- [Zeiterfassung](../zeiterfassung) — Pensum-Soll vs. Stunden-Ist
+- [Spesen](../spesen) — Spesen-Erstattung in der Lohnabrechnung
@@ -0,0 +1,53 @@
+---
+title: Projekt- & Kundenverwaltung
+linkTitle: Projekte
+weight: 3
+toc: true
+---
+
+<span class="rapport-status active">In Arbeit</span>
+
+**Projekte nach SIA 102** mit Budget, Phasen und Beteiligten. Erstellung aus einer Offerte mit Verknüpfung zu Zeiterfassung und Rechnungen.
+
+## Projektstruktur
+
+Jedes Projekt besitzt:
+
+- **Stammdaten** — Nummer, Bezeichnung, Standort, Bauschätzwert
+- **Kunde** — verknüpft mit Kundendatenbank
+- **Beteiligte** — Bauleitung, Fachplaner, Behörden
+- **Phasen** — SIA 102 (Vorprojekt, Bauprojekt, Ausschreibung, …)
+- **Budget** — Gesamthonorar, pro Phase aufgeteilt
+
+## SIA 102
+
+Standard-Phasenverteilung wird vorgeschlagen, kann pro Projekt überschrieben werden.
+
+| Phase | Anteil (Standard) |
+|---|---|
+| 31 — Vorprojekt | 9 % |
+| 32 — Bauprojekt | 21 % |
+| 33 — Bewilligung | 3 % |
+| 41 — Ausschreibung | 18 % |
+| 51 — Ausführung | 38 % |
+| 52 — Inbetriebnahme | 6 % |
+| 53 — Abschluss | 5 % |
+
+## Kundendatenbank
+
+- Adresse, Ansprechperson, Telefon, E-Mail
+- Honorartyp (Stundensatz / SIA / Pauschal)
+- Verknüpfung zu allen Projekten und Rechnungen des Kunden
+
+## Auswertung
+
+Pro Projekt:
+
+- Geleistete Stunden vs. Budget
+- Honorar-Saldo (verrechnet / Akonto / offen)
+- Phasen-Fortschritt
+
+## Verwandte Module
+
+- [Rechnungen](../rechnungen) — Offerte → Projekt
+- [Zeiterfassung](../zeiterfassung) — Stunden-Auswertung pro Phase
@@ -0,0 +1,44 @@
+---
+title: Protokolle & Lieferscheine
+linkTitle: Protokolle
+weight: 6
+toc: true
+---
+
+<span class="rapport-status active">In Arbeit</span>
+
+**Einfache Erstellung von Sitzungsprotokollen** mit Beschlüssen und Aufgaben. Briefe und Lieferscheine im gleichen Erscheinungsbild.
+
+## Sitzungsprotokolle
+
+Pro Sitzung:
+
+- Datum, Ort, Teilnehmer (aus Beteiligten-Liste)
+- **Traktanden** als nummerierte Liste
+- Pro Traktandum: Beschluss, Aufgabe, Verantwortlich, Frist
+- Anhänge
+
+PDF-Export mit Bürobriefbogen.
+
+## Briefe
+
+Brief-Editor mit:
+
+- Empfänger aus Kundendatenbank
+- Bezugszeile, Anrede, Text, Grussformel
+- Briefbogen-Vorlage mit Logo
+- PDF-Export
+
+## Lieferscheine
+
+Pro Lieferung:
+
+- Empfänger, Datum, Bezug
+- Positionen (Plan-Nummer, Bezeichnung, Anzahl, Massstab)
+- Unterschriftenfeld
+
+Konsistentes Erscheinungsbild über alle Dokumenttypen — eine Briefbogen-Vorlage, mehrere Verwendungen.
+
+## Verwandte Module
+
+- [Projekte](../projekte) — Beteiligte als Empfänger
@@ -0,0 +1,44 @@
+---
+title: Rechnungen & Offerten
+linkTitle: Rechnungen
+weight: 2
+toc: true
+---
+
+<span class="rapport-status active">In Arbeit</span>
+
+**QR-Einzahlungsscheine, SIA-Phasen, Akonto-, Teil- und Schlussrechnungen.** Offerten sind in Projekte und Rechnungen konvertierbar. PDF-Export.
+
+## Workflow
+
+1. **Offerte** erstellen — auf Basis SIA 102 oder pauschal
+2. Kunde nimmt an → **konvertieren in Projekt + Rechnung**
+3. **Akonto-Rechnungen** während der Projektlaufzeit
+4. **Schlussrechnung** mit Differenz zum bisher Akonto-bezahlten
+
+## QR-Einzahlungsschein
+
+Schweizer **QR-Rechnung** nach Norm — direkt eingebettet in die PDF.
+
+Ausgelesen aus:
+
+- **Bürodaten** — IBAN, Empfänger-Adresse
+- **Kundendaten** — Schuldner-Adresse
+- **Rechnungs-Daten** — Betrag, Referenz, Zusatzinformation
+
+## Honorarmodelle
+
+| Modell | Berechnung | Verwendung |
+|---|---|---|
+| **Stundensatz** | Aus Zeiterfassung × Mitarbeiter-Stundensatz | Kleinaufträge, Beratung |
+| **SIA-Phasen** | Bauschätzwert × Honorarsatz × Phasenanteil | Reguläre Architektur-Aufträge |
+| **Pauschal** | Fester Betrag | Auf Wunsch des Kunden |
+
+## PDF-Export
+
+Druckfertige Rechnung inkl. QR-Schein. Layout aus dem Büro-Briefbogen (mit Logo). Mehrsprachig DE/FR/IT (geplant).
+
+## Verwandte Module
+
+- [Projekte](../projekte) — Honorarstruktur stammt aus dem Projekt
+- [Zeiterfassung](../zeiterfassung) — Stundensatz-Rechnungen
@@ -0,0 +1,40 @@
+---
+title: Spesen & Bürobudget
+linkTitle: Spesen
+weight: 5
+toc: true
+---
+
+<span class="rapport-status active">In Arbeit</span>
+
+**Spesenerfassung mit Belegupload.** Jahresbudget mit Einnahmen und Ausgaben. Internes Rechnungswesen.
+
+## Spesenerfassung
+
+Pro Mitarbeiter:
+
+- Datum, Betrag, Kategorie
+- **Beleg-Upload** (PDF, JPG, PNG)
+- Projekt-Zuordnung (optional)
+- Status (offen / erstattet)
+
+Kategorien: Reise, Verpflegung, Material, Telefon, Sonstiges.
+
+## Jahresbudget
+
+Übersicht über:
+
+- **Einnahmen** — Rechnungsbeträge, sortiert nach Eingang
+- **Ausgaben** — Spesen, Bürokosten, Löhne, Sozialabzüge
+- **Saldo** pro Monat / Quartal / Jahr
+
+## Auswertung
+
+- Einnahmen pro Kunde / Projekt
+- Ausgaben pro Kategorie / Mitarbeiter
+- Erfolgsrechnung pro Geschäftsjahr (vereinfacht)
+
+## Verwandte Module
+
+- [Mitarbeiter](../mitarbeiter) — Spesen-Erstattung in der Lohnabrechnung
+- [Rechnungen](../rechnungen) — Einnahmen-Quelle
@@ -0,0 +1,40 @@
+---
+title: System-Tray
+linkTitle: System-Tray
+weight: 8
+toc: true
+---
+
+<span class="rapport-status new">Neu in 0.7.0</span>
+
+**Schnellzugriff über die Menüleiste mit Hide-on-Close.** Beim Schliessen läuft Rapport im Hintergrund weiter — Cmd+Q beendet die App vollständig.
+
+## Verhalten
+
+| Aktion | Verhalten |
+|---|---|
+| **Fenster schliessen** (⌘W oder rotes X) | App läuft im Tray weiter |
+| **Cmd+Q** | App wird vollständig beendet |
+| **Klick auf Tray-Icon** | Fenster nach vorne, oder zeigen |
+| **Rechtsklick auf Tray-Icon** | Menü mit Schnellzugriffen |
+
+## Tray-Menü
+
+- **Rapport zeigen** — Fenster nach vorne
+- **Neue Zeiterfassung** — direkt im Zeit-Modul
+- **Neue Rechnung** — direkt im Rechnungs-Modul
+- **Letzte Projekte** — Quick-Open der letzten 5 Projekte
+- **Einstellungen**
+- **Rapport beenden**
+
+## Konfiguration
+
+In den Einstellungen:
+
+- **Beim Systemstart starten** (Login-Item) — Standard: aus
+- **Beim Schliessen beenden** statt ins Tray — Standard: aus
+- **Tray-Icon ausblenden** — App läuft, aber kein Menüleisten-Icon
+
+## Verwandte Module
+
+- [Auto-Updater](../auto-updater) — prüft Updates im Hintergrund
@@ -0,0 +1,45 @@
+---
+title: Zeiterfassung
+linkTitle: Zeiterfassung
+weight: 1
+toc: true
+---
+
+<span class="rapport-status active">In Arbeit</span>
+
+**Tages- und Wochenraster** mit Drag & Drop. Auswertungen pro Mitarbeiter und Projekt. Ferienverwaltung mit Prorata und Jahresabschluss.
+
+## Konzept
+
+Die Zeiterfassung ist das **Kernmodul** von RAPPORT — alle anderen Module (Rechnungen, Auswertungen, Lohnabrechnung) greifen auf die hier erfassten Stunden zu.
+
+## Eingabe
+
+- **Wochenraster** mit den 5 (oder 7) Arbeitstagen
+- **Halbstunden-Slots** von 06:00 bis 22:00
+- **Klick** oder **Drag** über mehrere Slots
+- Jeder Eintrag wird einem **Projekt** zugewiesen (Pflichtfeld)
+- Mehrfacheinträge pro Slot möglich (z. B. parallele Telefonate)
+
+## Auswertungen
+
+Pro Mitarbeiter und pro Projekt:
+
+- Geleistete Stunden vs. Soll-Pensum
+- Ferienanspruch / -saldo (mit Prorata bei Eintritt unter Jahr)
+- Überstunden-Saldo
+- Stundenaufschlüsselung nach SIA-Phase pro Projekt
+
+## Jahresabschluss
+
+Am Jahresende:
+
+- Ferien-Restguthaben übertragen oder auszahlen
+- Überstunden ausgleichen oder vergüten
+- Neues Jahr automatisch initialisieren
+
+## Verwandte Module
+
+- [Rechnungen](../rechnungen) — Stundensatz-Rechnungen ziehen direkt aus der Zeiterfassung
+- [Projekte](../projekte) — Stunden-Auswertung pro SIA-Phase
+- [Mitarbeiter](../mitarbeiter) — Pensum, Ferienanspruch