Files
tool-evaluator/docs/releases/v0.9.1/handbook/administration.de.md
T
opencode e164d51574 feat: compare limit 9, format-aware import placeholder, help links
- Raise compare limit from 8 to 9 (server + client, toast on overflow)
- Make import textarea placeholder match selected format (CSV/JSON/YAML/auto)
- Add GuideHelp links to admin create/edit user dialogs and tool import dialog
2026-08-05 07:40:47 +02:00

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

  • Importieren (Premium): über die Schaltfläche Importieren oben rechts können mehrere Tools gleichzeitig angelegt werden. Das Format wird automatisch erkannt (CSV, JSON oder YAML); für CSV lässt sich der Trenner wählen (automatisch, Komma, Semikolon oder Tabulator). Die Daten lassen sich direkt ins Formular einfügen oder als Datei hochladen.

    Unterstützte Felder: name (Pflicht), description, category, websiteUrl, iconUrl, features, tags (features/tags sind mit | getrennte Listen).

    CSV-Beispiel:

    name;description;category;features;tags
    Grafana;Observability- und Dashboard-Plattform;Monitoring;Dashboards|Alerts;devops
    Prometheus;Zeitreihen-Datenbank;Monitoring;Metrics;devops
    

    JSON-Beispiel:

    [
      { "name": "Grafana", "category": "Monitoring", "features": ["Dashboards"] },
      { "name": "Prometheus", "category": "Monitoring" }
    ]
    

    YAML-Beispiel:

    - name: Grafana
      category: Monitoring
      features:
        - Dashboards
    - name: Prometheus
      category: Monitoring
    

    Eine umfangreichere, fertig importierbare Beispieldatei liegt unter docs/examples/import-tools.yaml (24 gängige Enterprise-Tools).

    Beim Import werden einzelne fehlerhafte Zeilen übersprungen und mit Zeilennummer aufgelistet; korrekte Zeilen werden trotzdem angelegt. Jeder Import erzeugt Audit-Log-Einträge.

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.