karim
6290475ea3
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>
83 lines
2.6 KiB
Markdown
83 lines
2.6 KiB
Markdown
# 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).
|