Collections und Zugriff
Die wichtigste Regel:
Die Collection ist das einzige Projekt, in dem Menschen arbeiten. Produkt-Apps sind Capabilities dieser Collection.
Warum Collections?
Ohne gemeinsames Projektmodell erfindet jedes Produkt sein eigenes „Workspace“. Nutzer:innen springen zwischen fünf Pickern, die nicht dasselbe bedeuten.
Eine Collection gehört zu einer Company, hat Members und Rollen und kann viele Produkte binden. Deine App speichert vor allem platformProjectId — und erfindet keine parallele ACL.
Access Model B
Für viewer-scoped Routes brauchst du:
X-Service-Secret— das Produkt darf die Control Plane rufenX-Plexon-Contract-Version: 2026-05-plexon-federation-v3X-Plexon-User-Id— der Mensch, dessen Grants gelten
Ohne User-Id dürfen Collection-Listen und GraphQL me dich ablehnen. Das ist Absicht.
Ablauf
Browser-Session
→ dein BFF (Secret + Viewer-Id)
→ DIC Control Plane (Membership)
→ optional Upsert an Geschwister-Produkte
Was oft schiefgeht
| Fehler | Folge |
|---|---|
| Produkte als eigene „Projekte“ in der UX | Orientierung und Federation kaputt |
| Nur Service-Secret auf Viewer-Routes | 401 / Block |
| Grants cachen ohne Revoke-Check | Sicherheitsbug |