Konfiguration
Alle Umgebungsvariablen und Standardwerte.
Gateway
| Variable | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
DATABASE_URL | Ja | — | PostgreSQL-Verbindung |
REDIS_URL | Nein | — | Redis-URL |
PORT | Nein | 8080 | HTTP-Port |
BRAND_NAME | Nein | Palveron | White-Label-Markenname |
Dashboard
| Variable | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
DATABASE_URL | Ja | — | PostgreSQL-Verbindung |
KINDE_CLIENT_ID | Ja | — | Kinde Client ID |
KINDE_CLIENT_SECRET | Ja | — | Kinde Secret |
KINDE_ISSUER_URL | Ja | — | Kinde Domain |
Health-Endpoints
| Service | Pfad | Gesunde Antwort |
|---|---|---|
| Gateway | GET /health | 200 — reine Liveness (Prozess lebt; keine Dependency-Checks) |
| Gateway | GET /ready | 200, außer Postgres ist kritisch/ungeprobt (liest den gecachten Health-State, probt nie inline) |
| Dashboard | GET /api/health | 200 mit Build-Metadaten |
/health zeigt keine Readiness — für Load-Balancer-Probes während Deployments /ready verwenden. Ein vollständiger Subsystem-Snapshot liegt unter GET /health/detailed, geschützt durch den X-Palveron-Operator-Key-Header (503, wenn OPERATOR_API_KEY nicht gesetzt ist).
Observability
| Endpoint | Beschreibung |
|---|---|
GET /metrics | Prometheus-Exposition auf dem Gateway-Port — inkl. Governance-Availability-, Trace-Durability- und DLQ-Replay-p95-SLO-Gauges |
GET /api/v1/integrity/status | Kontinuierlicher Tamper-Detection-Status (API-Key-Auth) |
GET /api/v1/admin/system-health | System-Health für das Admin-Panel (Admin-Rolle erforderlich) |
Retry- & Rate-Limit-Verhalten
Die Gateway liefert:
429 Too Many RequestsmitRetry-After-Header und strukturiertem Body (limit_type:rpmodermonthly), wenn ein Rate-Limit greift503 Service Unavailable(leerer Body), wenn eine Governance-Entscheidung nicht dauerhaft aufgezeichnet werden konnte (DB und DLQ nicht verfügbar) — mit Backoff wiederholen
Die offiziellen SDKs respektieren Retry-After und wiederholen transiente 5xx-/Timeout-Fehler mit Exponential Backoff und Jitter. Eigene Clients sollten dasselbe Muster umsetzen.