# 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).
- **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:**

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

  **JSON-Beispiel:**

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

  **YAML-Beispiel:**

  ```yaml
  - 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`](/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.