Files
tool-evaluator/docs/handbook/administration.md
T
opencode 8f2fd89847
Build & Push Docker Image / build (push) Successful in 2m49s
feat(import): bulk tool import (CSV/JSON/YAML) for admins; NetBox-style help button
- Add POST /admin/tools/import with format auto-detect, CSV delimiters
  (comma/semicolon/tab), per-row validation via CreateToolBody, bulk insert,
  audit log entries per imported tool; gated by new 'tool-import' feature
  flag (premium/enterprise; admins always pass)
- Add tool-import-dialog UI (format tabs, delimiter select, textarea, file
  upload, result/error list) behind hasFeature('tool-import')
- Replace FieldHelp question marks and bare GuideHelp links with a NetBox-style
  'Hilfe/Help' outline button (HelpCircle + text) in form headers only
- Sync locales to 482 keys per language (de/en), update handbook docs
  (administration import section, index/plaene feature tables), regenerate
  API client + zod schemas, add yaml dependency
2026-08-04 23:09:11 +02:00

3.6 KiB

title, order
title order
Administration 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).

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
    

    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.