Zum Hauptinhalt springen

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)
  1. Secrets bleiben auf dem Server.
  2. Viewer-Id wandert bei viewer-scoped Calls mit (X-Plexon-User-Id).
  3. Upsert bleibt dünn: Binding speichern, kein zweites Projektmodell.

Schritte (kurz)​

  1. npm install @chbrdk/plexon-federation@0.2.1 (+ optional @chbrdk/dic-app).
  2. Header zentral mit buildFederationHeaders bauen.
  3. Mindestens Upsert, bei Bedarf Origin, plus Health implementieren — Bodies mit SDK-Zod prüfen.
  4. Nach Login Collection-Liste über den BFF verifizieren.
  5. 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​

SymptomFix
Zweites Projektmodell in der UIImmer Collection / platformProjectId
curl ok, Browser failCall hinter den BFF legen
Upsert 400Zod vor dem DB-Write