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,227 @@
+---
+title: Rapport Server
+linkTitle: Server
+weight: 4
+toc: true
+---
+
+<span class="rapport-status new">Self-Hosting</span>
+
+**Rapport Server** — der vollständige Selfhost-Stack für Rapport. Eigene Daten, eigene Domain, eigener Server. Komplett Open-Source, Docker-Compose, AGPL-3.0.
+
+## Wann brauchst du Rapport Server?
+
+| Szenario | Lösung |
+|---|---|
+| **Ein Mensch, ein Mac** | Desktop-App reicht — [Installation](../docs/installation) |
+| **Mehrere Personen im Studio** | Rapport Server auf einem Mac Mini oder Linux-Server |
+| **Verteiltes Team, Home-Office, Mobile-Zugriff** | Rapport Server mit Reverse-Proxy + SSL |
+| **Cloud-Hosting bei einem Anbieter** | Rapport Server auf VPS/Hetzner/etc. |
+
+> Die Desktop-App speichert lokal als JSON. Rapport Server bringt **Postgres + Multi-User + Realtime-Sync** — für alle, die zu zweit oder im Team arbeiten.
+
+## Architektur
+
+Rapport Server bündelt sechs Open-Source-Komponenten zu einem stimmigen Stack:
+
+```text
+┌──────────────────────────────────────────────────────┐
+│  Browser / Desktop-App                                │
+└──────────────┬───────────────────────┬───────────────┘
+               │                       │
+               ▼                       ▼
+        ┌──────────┐            ┌──────────┐
+        │  nginx   │            │   Kong   │  ← API-Gateway
+        │  (app)   │            │          │
+        └──────────┘            └──────────┘
+                                      │
+                  ┌───────────────────┼─────────────────────┐
+                  ▼                   ▼                     ▼
+              ┌────────┐         ┌──────────┐          ┌─────────┐
+              │ GoTrue │         │PostgREST │          │ Realtime│
+              │ (Auth) │         │  (API)   │          │  (WS)   │
+              └────────┘         └──────────┘          └─────────┘
+                  │                   │                     │
+                  └───────────────────┼─────────────────────┘
+                                      ▼
+                            ┌─────────────────┐
+                            │   PostgreSQL    │
+                            └─────────────────┘
+                                      │
+                                      ▼
+                            ┌─────────────────┐
+                            │     Storage     │  ← Belege, Logos
+                            └─────────────────┘
+```
+
+| Komponente | Funktion |
+|---|---|
+| **PostgreSQL** | Datenbank — alle Rapport-Daten |
+| **GoTrue** | Authentication — Email/Passwort, JWT-Tokens |
+| **PostgREST** | REST-API direkt aus dem Postgres-Schema |
+| **Realtime** | WebSocket-Sync für Live-Updates |
+| **Storage** | Object-Storage für Belege & Logos |
+| **Kong** | API-Gateway, routet alle Calls |
+| **app** (nginx) | Liefert das Rapport-Frontend (React-Build) |
+
+Alles in **einem Docker-Compose**. Keine Cloud-Abhängigkeit, keine Telemetrie.
+
+## Voraussetzungen
+
+| OS | Container-Runtime |
+|---|---|
+| **Linux** (Ubuntu 22.04+, Debian 12+, …) | Docker Engine + Compose v2 |
+| **macOS** (Mac Mini etc.) | [Colima](https://github.com/abiosoft/colima) + Docker CLI — voll OSS |
+
+> Auf macOS funktionieren auch OrbStack oder Docker Desktop, beide sind aber proprietär. **Colima** ist die OSS-Alternative und für Selfhost vollkommen ausreichend.
+
+**Plus:** ein DNS-Name für TLS (z. B. `rapport.studio.ch`), und optional ein Reverse-Proxy wie [Nginx Proxy Manager](https://nginxproxymanager.com/) oder [Caddy](https://caddyserver.com/).
+
+## Setup in 5 Schritten
+
+### 1 · Repo klonen
+
+```bash
+git clone https://git.kgva.ch/karim/rapport-server.git
+cd rapport-server
+```
+
+### 2 · `.env` erstellen
+
+```bash
+cp .env.example .env
+```
+
+In `.env` müssen mindestens diese Werte ersetzt werden:
+
+| Variable | Was |
+|---|---|
+| `POSTGRES_PASSWORD` | DB-Passwort (≥ 32 Zeichen, zufällig) |
+| `JWT_SECRET` | JWT-Signatur (≥ 32 Zeichen, zufällig) |
+| `ANON_KEY` / `SERVICE_ROLE_KEY` | aus JWT-Secret abgeleitet |
+| `SITE_URL` | Public-URL der Instanz (z. B. `https://app.rapport.studio.ch`) |
+
+Zufallswerte generieren:
+
+```bash
+openssl rand -hex 32   # für POSTGRES_PASSWORD und JWT_SECRET
+node scripts/generate-keys.mjs   # ANON_KEY + SERVICE_ROLE_KEY aus JWT_SECRET
+```
+
+### 3 · Migrations holen
+
+Die SQL-Migrations stammen aus dem App-Repo. Einmal initial holen:
+
+```bash
+./scripts/sync-migrations.sh
+```
+
+Bei späteren Rapport-Updates erneut ausführen, dann `docker compose down && docker compose up -d`.
+
+### 4 · Stack starten
+
+```bash
+docker compose up -d
+```
+
+Erststart dauert ~1 Minute (Postgres initialisiert sich, Migrations laufen, Container starten).
+
+### 5 · Health-Check
+
+```bash
+docker compose ps
+```
+
+Alle Container sollten `healthy` zeigen. Frontend ist dann erreichbar unter `http://localhost:8080`.
+
+## Reverse-Proxy + HTTPS
+
+Für Production-Setups mit eigener Domain — **Caddy** ist die einfachste Variante (config-as-code, Let's-Encrypt automatisch):
+
+```caddy
+app.rapport.studio.ch {
+  reverse_proxy localhost:8080
+}
+
+api.rapport.studio.ch {
+  reverse_proxy localhost:8000
+}
+```
+
+In `.env` dann:
+
+```env
+SITE_URL=https://app.rapport.studio.ch
+API_EXTERNAL_URL=https://api.rapport.studio.ch
+```
+
+Alternativ über **Nginx Proxy Manager** mit Web-UI — siehe [Troubleshooting](../docs/troubleshooting).
+
+## Updates
+
+```bash
+git pull
+./scripts/sync-migrations.sh   # falls neue SQL-Migrationen
+docker compose pull             # neueste Container-Versionen
+docker compose up -d            # neu starten
+```
+
+Daten bleiben erhalten — das Volume `postgres-data` wird nicht angetastet.
+
+## Backup
+
+### Postgres-Dump
+
+```bash
+docker compose exec -T db pg_dumpall -U postgres > backup-$(date +%Y%m%d).sql
+```
+
+Empfohlen: per `cron` täglich + auf externe Disk / S3 / Backblaze sichern.
+
+### Storage (Belege, Logos)
+
+```bash
+docker compose exec storage tar -czf - /var/lib/storage > storage-$(date +%Y%m%d).tar.gz
+```
+
+### Restore
+
+```bash
+docker compose down
+docker volume rm rapport-server_postgres-data
+docker compose up -d db
+sleep 10
+cat backup-YYYYMMDD.sql | docker compose exec -T db psql -U postgres
+docker compose up -d
+```
+
+## Bezug Rapport ↔ Rapport Server
+
+| Komponente | Wo | Lizenz |
+|---|---|---|
+| **Rapport Desktop-App** | [git.kgva.ch/karim/RAPPORT](https://git.kgva.ch/karim/RAPPORT) | AGPL-3.0 |
+| **Rapport Server** | [git.kgva.ch/karim/rapport-server](https://git.kgva.ch/karim/rapport-server) | AGPL-3.0 |
+
+Die Desktop-App kann **wahlweise** im Lokal-Modus (JSON, kein Server nötig) oder im Cloud-Modus (gegen Rapport Server) betrieben werden. Wechsel erfolgt im Login-Bildschirm der App.
+
+## Häufige Fragen
+
+### Brauche ich Supabase Cloud?
+
+**Nein.** Rapport Server ist die Selfhost-Variante derselben Komponenten (Postgres + GoTrue + PostgREST + Realtime + Storage), aber komplett auf eigener Infrastruktur. Kein Supabase-Account, keine externe Abhängigkeit.
+
+### Kann ich von der Desktop-App auf Rapport Server migrieren?
+
+Im Login der Desktop-App auf **Cloud** wechseln, Server-URL eingeben, Account erstellen, Daten manuell wieder anlegen (Bürodaten, Mitarbeiter, Kunden). Ein direkter localStorage → Postgres-Import ist [geplant](https://git.kgva.ch/karim/RAPPORT/issues).
+
+### Was kostet das?
+
+Nichts — Rapport Server ist Open-Source (AGPL-3.0). Du brauchst nur einen Server (Mac Mini, NAS, VPS) und ggf. eine Domain.
+
+### Wieviel Server-Resourcen?
+
+Ein Mac Mini M1 (8 GB RAM) reicht problemlos für ein 5-Personen-Studio. Linux-VPS mit 2 GB RAM + 2 CPU reicht auch.
+
+## Quellcode
+
+[git.kgva.ch/karim/rapport-server](https://git.kgva.ch/karim/rapport-server) — Issues, Pull Requests und Forks willkommen.