Plaene

Module zu Plaenen (Abo-Stufen) buendeln — nur fuer den Superadmin.

---

Uebersicht

Wie in calServer V1 koennen Module (Berechtigungsgruppen) zu Plaenen zusammengefasst werden, um Abstufungen einer Installation abzubilden (z. B. basic, premium). Die Verwaltung ist — wie in V1 — ausschliesslich dem verborgenen Superadmin (hidden_super_admin) vorbehalten und findet unter Administration → Benutzer & Zugriff → Plaene statt.

Plan --> Module (Berechtigungsgruppen) --> Operationen

Funktionsweise

• Ein Plan ist eine benannte Stufe mit Titel, Beschreibung und Sortierung.
• Jedem Plan werden Module zugeordnet (Aktion „Module zuordnen"). Die Zuordnung wird V1-kompatibel als kommagetrennte Token in authitem_group.subscriptions gespeichert — bestehende V1-Zuordnungen funktionieren nach der Migration unveraendert.
• Aktiv geschaltet wird ein Plan pro Installation ueber die Umgebungsvariable SUBSCRIPTION (identisch zu V1). Ist sie leer, findet keinerlei Einschraenkung statt.

Wirkung eines aktiven Plans

Ist SUBSCRIPTION gesetzt, stehen Benutzern nur die Operationen jener Module zur Verfuegung, die dem aktiven Plan zugeordnet sind. Der Superadmin und direkt zugewiesene Berechtigungen sind ausgenommen; using_API (Basiszugriff auf die V2-API) wird bewusst nie gesperrt.

Mehrere Token = UND-Verknuepfung

Enthaelt SUBSCRIPTION mehrere kommagetrennte Werte, muss ein Modul alle Werte tragen, um aktiv zu sein (V1-Verhalten).

Modul-Inhalte (Operationen)

Was ein Modul enthaelt, ist ueber den Dialog „Module & Operationen" auf der Plaene-Seite einsehbar: Pro Modul werden alle zugehoerigen RBAC-Operationen mit lesbarem Titel und Beschreibung angezeigt. Einzelne Operationen koennen dort in ein anderes Modul verschoben werden (entspricht der V1-Operationsverwaltung, authitem.group_uID).

Operationen ohne Modul

Operationen, die keinem Modul zugeordnet sind, werden im Dialog unter „Ohne Modul" gesammelt. Bei aktivem Plan sind sie fuer Benutzer gesperrt (V1-Verhalten) — sie sollten daher einem Modul zugeordnet werden.

Auch im Zuordnungs-Dialog eines Plans zeigt jedes Modul seine Anzahl an Operationen; ein Tooltip listet die enthaltenen Operationen auf.

Migration aus V1

Beim V1→V2-Import werden vorhandene Subscription-Token aus authitem_group.subscriptions automatisch als Plaene angelegt (ausgenommen das V1-interne QRCODE-Token des QR-Portals). Es ist keine manuelle Nacharbeit erforderlich.

API

Endpunkt	Methode	Beschreibung
/api/v2/plans	GET	Plaene inkl. Modul-Zuordnung und aktivem Plan (Meta)
/api/v2/plans	POST	Plan anlegen (optional direkt mit module_ids)
/api/v2/plans/{id}	PUT	Plan aendern (Umbenennen zieht die Token mit um)
/api/v2/plans/{id}	DELETE	Plan loeschen (Token wird aus allen Modulen entfernt)
/api/v2/plans/{id}/modules	PUT	Modul-Zuordnung setzen
/api/v2/plans/modules	GET	Module inkl. ihrer Operationen (+ nicht zugeordnete)
/api/v2/plans/operations/{name}	PUT	Operation in ein anderes Modul verschieben

Alle Endpunkte erfordern die Rolle hidden_super_admin.