opencode
3bb4598d04
- each release now carries a full docs snapshot (reference + handbook) under docs/releases/<v>/; the docs frontend loads a version's snapshot for /docs/vX.Y.Z/* and shows the handbook/reference of that version - version dropdown navigates to /docs/<version> (docs home) instead of the release notes page; old /docs/vX.Y.Z redirect removed - generator: --snapshot writes handbook + reference; build copies versioned snapshots (last 7 versions) into /docs/versions/<v>/ - fix Gitea tag links: /admin/tool-evaluator/tags/<v> was 404, correct URL is /releases/tag/<v> - add GuideHelp button to forms/pages linking to the matching handbook guide (rating, tool add/edit, costs, compare, watchlist, analytics)
62 lines
2.3 KiB
Markdown
62 lines
2.3 KiB
Markdown
|
|
# 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.
|