Files
tool-evaluator/docs/releases/v0.8.2/handbook/administration.md
T
opencode 3bb4598d04 feat(docs): version-based docs, correct Gitea tag links, form guide help
- 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)
2026-08-04 07:31:47 +02:00

2.3 KiB

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).

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, PATCH /users/{id}, DELETE /users/{id}.

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.

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.