> [← open.SERVICE](<open.SERVICE Plugin Overview.md>)
# Berechtigungen
open.SERVICE kennt zwölf Berechtigungen. Der Server registriert sie beim Start je
Mandant; **zugewiesen** werden sie in der Rechteverwaltung von open.DASH.
Dazu kommt eine zweite Ebene, die nicht über Berechtigungen läuft: wer einen
**einzelnen** Wartungsplan oder ein einzelnes Ticket sehen und ändern darf,
entscheidet der Datensatz selbst über seinen Ersteller und seine Zuweisungen —
siehe unten.
## Zugänge
Drei Keys entscheiden, ob ein Bereich für einen Benutzer überhaupt existiert.
Fehlt einer, ist der Bereich weder im Menü noch über die Adresse erreichbar.
| Key | Bezeichnung in der Rechteverwaltung | Öffnet |
| ------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------- |
| `openservice-schedule:can-access-schedule-plugin` | Wartungen - Zugang zum Wartungsplugin | Wartungspläne, Kalender, Durchführungen |
| `openservice-ticket:can-access-ticket-plugin` | Tickets - Zugang zum Ticketsystem | Ticketübersicht, Ansichten, Ticketdetails |
| `openservice-core:can-access-admin` | Service - Administration öffnen | Stammdaten, Kontakte, Dienstleister, Verwaltungstabellen |
## Wartung
| Key | Bezeichnung | Erlaubt |
| --------------------------------------------- | ---------------------------------------- | -------------------------------------------------------------- |
| `openservice-schedule:can-create-schedule` | Wartungen - Wartungspläne erstellen | Neue Wartungspläne anlegen; einem Dienstleister einen Zugang einrichten |
| `openservice-schedule:can-delete-schedule` | Wartungen - Wartungspläne löschen | Pläne archivieren; Durchführungen bleiben erhalten |
| `openservice-schedule:can-perform-execution` | Wartungen - Wartungen durchführen | Durchführung starten, ausfüllen, abschließen |
| `openservice-schedule:can-manage-template` | Wartungen - Vorlagen verwalten | Wartungsvorlagen anlegen, bearbeiten, löschen |
| `openservice-schedule:can-view-analytics` | Wartungen - Auswertungen sehen | Kennzahlen und Diagramme des Wartungsmoduls |
## Tickets
| Key | Bezeichnung | Erlaubt |
| ------------------------------------------ | -------------------------------- | --------------------------------------------------------------------- |
| `openservice-ticket:can-create-ticket` | Tickets - Tickets erstellen | Tickets anlegen, auch aus Wartungsplänen und Durchführungen heraus |
| `openservice-ticket:can-delete-ticket` | Tickets - Tickets archivieren | Tickets archivieren; sie bleiben samt Verlauf erhalten |
## Stammdaten
| Key | Bezeichnung | Erlaubt |
| ---------------------------------------- | -------------------------------- | ----------------------------------------------------------------------- |
| `openservice-core:can-manage-masterdata` | Service - Stammdaten verwalten | Anlegen und Archivieren bei Anlagen, Tags, Projekten und Status; öffnet die Dienstleister-Übersicht |
| `openservice-core:can-create-tag` | Service - Tags anlegen | Einen Tag direkt aus einem Tag-Feld heraus anlegen |
> [!note] Firmen, Kontakte und Artikel brauchen keine zusätzliche Berechtigung
> Dort genügt der Administrationszugang: wer die Seite öffnen darf, darf auch
> anlegen und löschen.
## Lesen, Bearbeiten und Zuweisen regelt der Datensatz
Für Wartungspläne und Tickets gibt es dafür keine Berechtigungen. Wer einen
bestimmten Datensatz sehen und ändern darf, ergibt sich aus ihm selbst:
- Ein **Wartungsplan** gehört seinem Ersteller. Zuständige Rollen und Personen
bekommen Lesezugriff, die übrigen Benutzer sehen ihn nicht.
- Ein **Ticket** ist mandantenweit lesbar; ändern dürfen es der Ersteller sowie
die zugewiesenen Benutzer und Rollen.
Eine Zuweisung ist damit zugleich eine Rechtevergabe, und ein Entzug wirkt
sofort.
Wer einen bestimmten Plan sehen darf, zeigt der Dialog **„Sichtbarkeit prüfen"**
im Aktionsmenü des Plans.
## Ein Vorschlag als Ausgangspunkt
| Rolle | Zugang Wartung | Zugang Tickets | Admin | Pläne anlegen/archivieren | Durchführen | Vorlagen | Auswertungen | Tickets anlegen | Stammdaten |
| -------------------------- | :------------: | :------------: | :---: | :-----------------------: | :---------: | :------: | :----------: | :-------------: | :--------: |
| Administrator | ✓ | ✓ | ✓ | ✓ / ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Wartungsleitung | ✓ | ✓ | – | ✓ / ✓ | ✓ | ✓ | ✓ | ✓ | – |
| Techniker | ✓ | ✓ | – | – / – | ✓ | – | – | ✓ | – |
| Dienstleister (extern) | ✓ | – | – | – / – | ✓ | – | – | – | – |
| Betrachter / Management | ✓ | ✓ | – | – / – | – | – | ✓ | – | – |
Für den Dienstleister sind genau diese beiden Keys der übliche Zuschnitt:
Zugang zum Wartungsmodul und Durchführungen erfassen. Mehr braucht er nicht, und
welche Pläne er sieht, entscheidet ohnehin die Zuweisung.
## Was der Server beim Start einrichtet
- die Konfigurationszeilen je Mandant, mit Vorgabewerten
- die beiden Alarm-Secrets, erzeugt statt vorgegeben
- die Alarm-Aktionen und den Webhook samt Payload-Vorlage
- die Berechtigungs-Keys dieses Moduls
Nicht automatisch geht die **Outlook-Anbindung** — dafür ist das `client_secret`
Ihres Mandanten nötig.
## Verwandt
- [[End-User/Modules/open.SERVICE/Administration/Inbetriebnahme|Inbetriebnahme]]
- [[End-User/Modules/open.SERVICE/Seiten und Routen|Seiten und Routen]]
- [[Developer/open.SERVICE/Berechtigungen|Berechtigungen (Developer)]]