Initial: RAPPORT-HOST Iteration 1 (proprietär)

Kommerzielle Hosting-/Abo-Plattform für Rapport-Instanzen.

- React-Frontend (Vite/JSX): Landing, Register, Login, Plans, Dashboard
- Node/Express-Backend: Auth (bcrypt+JWT), Stripe-Billing, Provisioning
- HOST-Postgres-Schema: accounts, subscriptions, instances
- Provisioning-Interface + Modell-A-Adapter (Studio im geteilten Stack)
- MOCK-Modus: voller End-to-End-Flow ohne Stripe/Rapport-Stack testbar
- Idempotentes Fulfillment (Upsert auf stripe_subscription_id)
- docker-compose für lokale host-db; identisch auf Hetzner deploybar

E2E lokal verifiziert: Register -> Checkout(mock) -> Instanz -> Idempotenz.

Lizenz: proprietär (kein AGPL-Code eingebunden, nur Netzwerk-API zur Familie).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

README.md

@@ -0,0 +1,82 @@
+# RAPPORT-HOST
+
+> ⚠️ **Proprietär & kommerziell** — im Gegensatz zur restlichen Rapport-Familie (AGPL). Siehe [LICENSE](LICENSE). Niemals AGPL-Code direkt einbinden.
+
+Die Hosting- und Abo-Plattform für Rapport. Kunden registrieren sich, wählen ein Abo (Stripe), und bekommen automatisch eine eigene Rapport-Instanz freigeschaltet.
+
+Teil der Rapport-Familie:
+
+| Repo | Rolle | Lizenz |
+|---|---|---|
+| `APP` | Desktop-/Web-Client | AGPL |
+| `SERVER-CONTAINER` | Self-Host Docker-Stack | AGPL |
+| `SERVER-APP` | Mac-Doppelklick-Server | AGPL |
+| `SERVER-PROXMOX-LXC` | Proxmox-Installer | AGPL |
+| **`RAPPORT-HOST`** | **Kommerzielle Hosting-Plattform** | **Proprietär** |
+
+---
+
+## Status: Iteration 1
+
+End-to-End-Flow lokal testbar (auch **ohne** Stripe/Rapport-Stack dank MOCK-Modus):
+
+1. Registrierung + Login (HOST-Konten, JWT)
+2. Abo-Plan wählen → Stripe-Checkout (oder Mock-Sofortfreischaltung)
+3. Webhook → Instanz provisionieren (Modell A: Studio im geteilten Stack)
+4. Kunden-Dashboard mit Abo-Status + Link zur Instanz
+
+Noch offen: Super-Admin, QR-Rechnung, echtes Rapport-Provisioning-RPC, Modell B (eigener Container).
+
+---
+
+## Architektur in einem Satz
+
+React-Frontend (`src/`) spricht über `/api` mit einem Node/Express-Backend (`server/`), das HOST-Konten + Abos in einer **eigenen** Postgres hält und bei bezahltem Abo eine Rapport-Instanz provisioniert. Details: [ARCHITECTURE.md](ARCHITECTURE.md).
+
+---
+
+## Lokal starten
+
+```bash
+# 1. HOST-Datenbank (Container)
+docker compose up -d host-db
+
+# 2. Backend-Dependencies + Schema
+cd server && npm install && cd ..
+npm run server:migrate
+
+# 3. .env anlegen
+cp .env.example .env          # Defaults reichen für den MOCK-Modus
+
+# 4. Frontend-Dependencies
+npm install
+
+# 5. In zwei Terminals:
+npm run server                # Backend  → :8787
+npm run dev                   # Frontend → :5273
+```
+
+Öffne http://localhost:5273 → registrieren → Plan wählen. Ohne Stripe-Keys
+schaltet der MOCK-Modus die Instanz sofort frei, und das Dashboard zeigt den
+(simulierten) Instanz-Link.
+
+### Mit echtem Stripe (Test-Mode)
+
+`.env` mit `STRIPE_SECRET_KEY=sk_test_…` + `STRIPE_PRICE_*` füllen. Webhook lokal
+weiterleiten:
+
+```bash
+stripe listen --forward-to localhost:8787/api/billing/webhook
+# das ausgegebene whsec_… in STRIPE_WEBHOOK_SECRET eintragen
+```
+
+Test-Karte: `4242 4242 4242 4242`, beliebiges Zukunftsdatum + CVC.
+
+---
+
+## Deploy (Hetzner, später)
+
+Identischer Code — nur `.env` mit Live-Werten (`sk_live_…`, echte
+`DATABASE_URL`, `PUBLIC_BASE_URL=https://…`, `RAPPORT_API_URL`/`SERVICE_KEY`
+für echtes Provisioning). Das `app`-Image in `docker-compose.yml` ist dafür
+vorbereitet (auskommentiert).