# Organisationen und Workspaces

Wie Tokenlane Personen, Guthaben und Keys gruppiert: Die Organisation hält Mitglieder und Geld, Workspaces trennen Projekte.

## Organisation

Die Organisation besitzt Guthaben, Aufladungen, Rechnungsdaten und die Mitgliederliste. Jeder Workspace und jeder Key gehört zu genau einer Organisation. Ein Organisationswechsel wechselt den gesamten Kontext, das Guthaben wandert nicht mit. Wählbar sind nur Organisationen mit aktueller Mitgliedschaft; nach einer erneuten Anmeldung stellt Tokenlane die zuletzt gewählte Organisation wieder her.

Rollen: **Inhaber** verwalten die Organisation einschließlich Guthaben und Inhabern. **Admins** verwalten alle Workspaces, Einstellungen, Keys und Mitglieder, aber nur Inhaber verwalten Inhaber. **Mitglieder** nutzen die zugewiesenen Workspaces mit den dort vergebenen Rechten. Personen kommen per E-Mail-Einladung dazu.

Inhaber und Admins öffnen im Organisationsmenü **Organisation verwalten** für Name, Logo, eine Zwei-Faktor-Pflicht für alle Mitglieder (API-Keys und Gateway-Anfragen bleiben unberührt), die automatische Aufnahme neuer Mitglieder in den Standard-Workspace und Benachrichtigungen bei niedrigem Guthaben. Das Logo (PNG, JPEG, WebP oder einfaches SVG, bis 2 MiB) sehen nur Mitglieder.

## Workspace

Ein Workspace bündelt Keys, Aktivität und Logs eines Projekts, Teams oder einer Umgebung. Jeder Key gehört zu einem Workspace, und die Ansichten zeigen einen Workspace oder **Alle Workspaces**. Ein Workspace hat kein Guthaben: Seine Keys werden dem gemeinsamen Guthaben der Organisation belastet.

Workspaces haben Mitglieder mit eigenen Rollen. **Betrachter** lesen Übersicht, Aktivität und Logs ohne gespeicherte Inhalte. **Entwickler** verwalten zusätzlich eigene Keys. **Workspace-Admins** verwalten alle Keys, Einstellungen und Mitglieder. Inhaber und Admins der Organisation erreichen jeden Workspace. Jede Organisation beginnt mit einem Standard-Workspace, dem neue Mitglieder bei aktiver automatischer Aufnahme als Entwickler beitreten.

Das Verzeichnis zählt Organisationsinhaber und Admins mit implizitem Zugriff sowie ausdrücklich zugewiesene Workspace-Mitglieder. Inhaber und Admins legen Workspaces über das Workspace-Menü oder die Seite Workspaces an. Ein Management-Key kann Workspaces lesen, aber nicht anlegen.

## Wo Guthaben, Personen und Regeln liegen

| | Organisation | Workspace | Key |
| --- | --- | --- | --- |
| Guthaben | Kontostand, Aufladungen, Rechnungen | Keines, wird der Organisation belastet | Optionales Limit in EUR |
| Personen | Inhaber, Admin, Mitglied | Betrachter, Entwickler, Workspace-Admin | Einem Mitglied oder dem Workspace zugeordnet |
| Regeln | Modell-, Provider- und Datenschutzregeln | Geerbte Regeln und gemeinsames Ausgabenbudget | Geerbte Regeln plus Key-Einschränkungen |

Organisations-, Workspace- und Key-Policies werden geschnitten. Eine untergeordnete Ebene oder ein Request kann den Zugriff nur weiter einschränken. Ein optionales Workspace-Budget begrenzt die gemeinsamen Ausgaben seiner Inferenz-Keys einschließlich paralleler Reservierungen. Reicht es für eine geschätzte Reservierung nicht aus, folgt `402 workspace_budget_exceeded`; Organisationsguthaben und Key-Limits gelten zusätzlich. Ablaufdatum, positives `capture` und Server-Tool-Freigaben gehören zum Key; geerbtes `forbid_capture` kann die Inhaltsspeicherung verbieten. Siehe [Authentifizierung](https://tokenlane.de/docs/guides/authentication.md?lang=de) und [Datenschutz und Compliance](https://tokenlane.de/docs/guides/privacy-and-compliance.md?lang=de).

## Als Nächstes

- [Schnellstart](https://tokenlane.de/docs/guides/quickstart.md?lang=de): einen Key im richtigen Workspace anlegen
- [Kosten und Limits](https://tokenlane.de/docs/guides/costs-and-limits.md?lang=de): wie das gemeinsame Guthaben verbraucht wird