Bestehendes Backend anbinden
Ziel: Deine Domain-API bleibt, du ergänzt nur eine dünne DIC-Kante für Login, Collections und Mirror.
Wann dieser Weg passt
- Routen, Datenbank und eigenes Auth existieren schon.
- Du brauchst Collections und Suite-Handoffs ohne Rewrite.
- Du kannst serverseitige Routes ergänzen, die den Federation-Vertrag sprechen.
Neu von null? → Lane-A-Quickstart.
Architektur
Browser → dein BFF (Session) → DIC Control Plane
↓
deine Domain-API (unverändert)
- Secrets bleiben auf dem Server.
- Viewer-Id wandert bei viewer-scoped Calls mit (
X-Plexon-User-Id). - Upsert bleibt dünn: Binding speichern, kein zweites Projektmodell.
Schritte (kurz)
npm install @chbrdk/plexon-federation@0.2.1(+ optional@chbrdk/dic-app).- Header zentral mit
buildFederationHeadersbauen. - Mindestens Upsert, bei Bedarf Origin, plus Health implementieren — Bodies mit SDK-Zod prüfen.
- Nach Login Collection-Liste über den BFF verifizieren.
- Optional Shell aus dem App Framework.
Fertig, wenn…
- Upsert speichert
platformProjectId - Origin (falls genutzt) bindet die Collection
- BFF listet accessible Collections
- Revoke greift — siehe Revoke-Rezept
Was oft schiefgeht
| Symptom | Fix |
|---|---|
| Zweites Projektmodell in der UI | Immer Collection / platformProjectId |
| curl ok, Browser fail | Call hinter den BFF legen |
| Upsert 400 | Zod vor dem DB-Write |