fdf2d741a1
- docs route renders without the app shell (own header, back-to-app link, theme toggle) - nav entry renamed to Hilfe (de) / Help (en) - reference links now case-insensitive (schema/tag slugs) - handbook rewritten as 17-page user guide with links into the API reference - release notes v0.8.1 added
66 lines
2.3 KiB
Markdown
66 lines
2.3 KiB
Markdown
---
|
|
title: Administration
|
|
order: 13
|
|
---
|
|
|
|
# Administration
|
|
|
|
Der Bereich **Admin** (`/admin`) ist ausschließlich für Admins zugänglich.
|
|
Ohne Admin-Rolle erscheint eine Zugriffsverweigerung.
|
|
|
|
> Oben rechts führt die Schaltfläche **Redundanz-Dashboard** zur automatischen
|
|
> Doppelungs-Erkennung (siehe [Redundanz](/docs/handbook/redundanz)).
|
|
|
|
## Tab „Nutzer"
|
|
|
|
Verwaltung der lokalen Konten.
|
|
|
|
- **Nutzer hinzufügen:** Benutzername (Pflicht), Passwort (mind. 6 Zeichen),
|
|
E-Mail (optional), **Rolle** (User/Admin), **Tarif** (Free/Premium/Enterprise).
|
|
- **Nutzer bearbeiten:** Rolle, Tarif und (für lokale Konten) ein neues Passwort
|
|
setzen. Für OIDC-Konten wird die Passwortverwaltung im Identitätsanbieter
|
|
(z. B. Keycloak) angeboten.
|
|
- **Nutzer löschen:** Entfernt das Konto endgültig (nicht für das eigene Konto).
|
|
|
|
API-Referenz:
|
|
[`POST /users`](/docs/reference/endpoints/users#createUser),
|
|
[`PATCH /users/{id}`](/docs/reference/endpoints/users#updateUser),
|
|
[`DELETE /users/{id}`](/docs/reference/endpoints/users#deleteUser).
|
|
|
|
## Tab „Tools"
|
|
|
|
Zentraler Zugriff auf den Tool-Katalog.
|
|
|
|
- **Suchen** nach Tools.
|
|
- Tools einzeln ansehen, bearbeiten oder in den Papierkorb verschieben.
|
|
- **Massenaktion:** mehrere Tools auswählen und in den Papierkorb verschieben
|
|
(Bestätigungsdialog; soft gelöschte Tools sind aus allen öffentlichen Ansichten
|
|
entfernt und können wiederhergestellt oder endgültig gelöscht werden).
|
|
|
|
## Tab „Audit-Log"
|
|
|
|
Chronologisches Protokoll aller Anlage-, Änderungs- und Löschvorgänge
|
|
(max. 100 Einträge): Aktion, Entität + ID, Zeitstempel, ausführende Person und
|
|
geänderte Felder.
|
|
|
|
API-Referenz: [`GET /audit-logs`](/docs/reference/endpoints/audit#listAuditLogs).
|
|
|
|
## Tab „System"
|
|
|
|
Versionsinformationen der laufenden Instanz:
|
|
|
|
- **Version** (z. B. `v0.8.1`),
|
|
- **Commit** (7-stelliger SHA, verlinkt zum Repository),
|
|
- **Build-Datum**,
|
|
- **Papierkorb-Aufbewahrung** („N Tage" oder „Für immer").
|
|
|
|
## Tool-Verknüpfungen (Admin)
|
|
|
|
Auf der Detailseite eines Tools kannst du als Admin **Verknüpfungen**
|
|
(eigene/„manual" sowie automatisch erkannte) verwalten:
|
|
|
|
- **Tool verknüpfen:** Dialog mit Tool-ID, **Beziehungstyp**
|
|
(Ähnlich / Ersetzt / Abgelöst durch) und optionalen Notizen.
|
|
- Beziehungstypen werden als Badges auf der Detailseite angezeigt.
|
|
- Manuelle Verknüpfungen lassen sich per Papierkorb-Icon wieder entfernen.
|