Files

T

opencode 6eb3dfd8f9 docs: cut to v0.9.0 with unified .de/.en naming

- Remove all prior release notes and version snapshots (v0.6.0-v0.8.6)
- Rename handbook to *.de.md; keep *.en.md
- New release notes v0.9.0.de.md/.en.md with v0.9.0 snapshot
- generate-docs.mjs: .de/.en convention incl. search index and en-fallback
- docs.tsx: release fallback now uses version.de.md
- Wording: neutral tagline, anonymous user, no gender forms
- Add docs/examples/import-tools.yaml and link from administration docs

2026-08-05 00:13:41 +02:00

3.7 KiB

Raw Permalink Blame History

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

3.7 KiB Raw Permalink Blame History