For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /de/docs/web/organizations.md (or send Accept: text/markdown).
Organisationen und Einladungen
Implementieren Sie den Demo-Ablauf für Organisationen: erstellen, wechseln, einladen, Rollen verwalten, verlassen und im Gefahrenbereich löschen.
Einrichtung und Konfiguration
Lesen Sie vor jedem Schritt Bevor Sie beginnen und Terminal-Grundlagen. Bei diesen Anweisungen wird davon ausgegangen, dass Sie das vollständige Supastack-Monorepo in VS Code geöffnet haben. Sein Stamm package.json markiert den Repository-Stamm. In pnpm-Befehlen ist ein Arbeitsbereichspaket eine App oder ein Ordner mit gemeinsam genutztem Code. Im Produkt ist ein Arbeitsbereich der Datencontainer und die Sicherheitsgrenze eines Teams. corepack pnpm --filter ... wählt ein Paket aus dem Monorepo aus, während Befehle von seinem Stammverzeichnis aus ausgeführt werden. Wenn Sie nur einen synchronisierten Mobil- oder Desktop-Ordner geöffnet haben, enthält dieser weder das Web-Backend, Docker-Setup noch Root-Skripte: Führen Sie das Backend von diesem Monorepo oder einem erreichbaren gehosteten Server aus und verwenden Sie die eigenen Skripte des Plattformordners. Eine Umgebungsvariable ist eine benannte Einstellung, die in einer lokalen .env-Datei oder Ihrem Hosting-Dashboard gespeichert ist; Starten Sie die entsprechende App neu, nachdem Sie sie geändert haben, und halten Sie Servergeheimnisse von den Werten NEXT_PUBLIC_ und EXPO_PUBLIC_ fern.
1. Starten Sie die Web-App im Repository-Stammverzeichnis mit corepack pnpm --filter @supastack/web dev und erstellen Sie ein Testkonto.
2. Öffnen Sie den Einrichtungsbildschirm der Organisation, erstellen Sie einen Testarbeitsbereich und laden Sie dann über Einstellungen → Mitglieder eine zweite Test-E-Mail ein. Ein Arbeitsbereich ist die Teamgrenze, die Mitglieder und Datensätze besitzt.
3. Nehmen Sie die Einladung an, während Sie mit derselben E-Mail-Adresse angemeldet sind. Erwartet: Das zweite Konto kann mit der ihm zugewiesenen Rolle den eingeladenen Arbeitsbereich betreten, aber keine Nur-Eigentümer-Aktionen verwalten.
Organisations-Workspaces sind in packages/db von persönlichen Workspaces getrennt. Nach der Anmeldung leiten Onboarding-Sperren (/onboarding, /new-organization, /select-organization, /choose-plan) den Benutzer in eine aktive Organisation, bevor Produktabrechnung und Einstellungen verfügbar sind.
Einladungen legen eine ausstehende Zeile in workspace_invitation an und versenden eine Transaktions-E-Mail mit einem Annahmelink unter /invite/[token]. Für die Annahme muss die angemeldete E-Mail-Adresse übereinstimmen. Mitgliederliste, Rollenänderungen und Verlassen liegen unter /settings/members; Umbenennen, Löschen und Verlassen sind auch unter /organization/settings verfügbar.
Routes
/new-organization
/select-organization
/invite/[token]
/settings/members
/organization/settings
Server actions
createOrganizationAction
createWorkspaceInviteAction
acceptWorkspaceInviteAction
updateMemberRoleAction
leaveOrganizationAction
renameOrganizationAction
deleteOrganizationActionBefehle zum Kopieren
Befolgen Sie die Kommentare, um zu sehen, in welchem Ordner ein Befehl ausgeführt wird. Wenn zwei Terminals gekennzeichnet sind, öffnen Sie zwei Terminalfenster und lassen Sie den ersten Befehl laufen, während Sie den zweiten verwenden.
corepack pnpm --filter @supastack/web devImplementierungsablauf
Lösen Sie den aktiven Workspace in dieser Reihenfolge auf: Cookie → Benutzereinstellung → Mitgliedschaft. Prüfen Sie bei jedem Schreibzugriff die Mitgliedschaft. Owner und Admins verwalten Einladungen und Rollen; der letzte Owner kann die Organisation weder verlassen noch sich selbst herabstufen.
Verwenden Sie vor Änderungen an Mitgliedschaften bevorzugt evaluateLeaveOrganization und evaluateMemberRoleUpdate aus @supastack/db. Senden Sie nach erfolgreichen Änderungen die In-App-Benachrichtigungen member.left oder member.role_changed, wenn inAppProduct aktiviert ist.
Die Plattformverwaltung bildet eine eigene ausgelieferte Grenze: Nur Plattform-Admins dürfen Benutzer, Sperren und Impersonation verwalten. Die Owner- oder Admin-Rolle eines Workspace gewährt keinen Plattformzugriff. Die dokumentierten Organisationsrollen sind owner, admin und member.
Überprüfung und Fehlerbehebung
Meldet der Einladungslink, dass die E-Mail-Adresse nicht passt, melden Sie sich mit genau der Adresse an, die die Einladung erhalten hat. Fehlt die Einladungs-E-Mail, prüfen Sie den lokalen E-Mail-Vorgang, bevor Sie erneut senden. Sieht ein Mitglied eine Organisation nicht, wechseln Sie zum richtigen Workspace und prüfen Sie die Mitgliedschaft. Beheben Sie das niemals, indem Sie eine andere workspaceId aus dem Browser übergeben.
Fokussierte Vitest-Prüfungen: Workspace-Hilfsfunktionen zum Verlassen und Ändern von Rollen, Annahme von Einladungen und Onboarding-Sperren für Organisationen. Manuell: Organisation erstellen → einladen → mit einem zweiten Konto annehmen → Rolle ändern → als Nicht-Owner verlassen → als Owner nach Bestätigung des Löschens entfernen.