feat(docs): standalone docs page, Hilfe nav entry, rewritten user guide

- docs route renders without the app shell (own header, back-to-app link,
  theme toggle)
- nav entry renamed to Hilfe (de) / Help (en)
- reference links now case-insensitive (schema/tag slugs)
- handbook rewritten as 17-page user guide with links into the API reference
- release notes v0.8.1 added

docs/handbook/administration.md

@@ -1,61 +1,65 @@
 ---
-title: Administration & Papierkorb
-order: 7
+title: Administration
+order: 13
 ---
 
-# Administration & Papierkorb
+# Administration
 
-Diese Bereiche sind nur für **Administrator:innen** sichtbar und nutzbar.
+Der Bereich **Admin** (`/admin`) ist ausschließlich für Admins zugänglich.
+Ohne Admin-Rolle erscheint eine Zugriffsverweigerung.
 
-## Nutzerverwaltung
+> Oben rechts führt die Schaltfläche **Redundanz-Dashboard** zur automatischen
+> Doppelungs-Erkennung (siehe [Redundanz](/docs/handbook/redundanz)).
 
-Unter **Admin → Nutzer** kannst du:
+## Tab „Nutzer"
 
-- **Lokale Nutzer anlegen** (Benutzername, Passwort, E-Mail, Rolle, Tier).
-- **Rollen/Tier ändern** (`admin`/`user`, `free`/`premium`/`enterprise`).
-- **Passwörter zurücksetzen** (nur lokale Nutzer).
-- **Nutzer löschen**.
+Verwaltung der lokalen Konten.
 
-Zugehörige Endpunkte (Admin-only):
+- **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).
 
-- [`GET /users`](/docs/reference/endpoints/users#listusers)
-- [`POST /users`](/docs/reference/endpoints/users#createuser)
-- [`PATCH /users/{id}`](/docs/reference/endpoints/users#updateuser)
-- [`DELETE /users/{id}`](/docs/reference/endpoints/users#deleteuser)
-- [`PATCH /users/{id}/password`](/docs/reference/endpoints/users#setuserpassword)
+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).
 
-## Audit-Log
+## Tab „Tools"
 
-Das **Audit-Log** protokolliert sicherheitsrelevante Änderungen (wer hat wann
-was geändert). Es ist über
-[`GET /audit-logs`](/docs/reference/endpoints/audit#listauditlogs) abrufbar und
-filterbar nach Entitätstyp, Entitäts-ID und Limit.
+Zentraler Zugriff auf den Tool-Katalog.
 
-## Papierkorb (Trash)
+- **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).
 
-Tools werden nicht sofort gelöscht, sondern zuerst **soft gelöscht** (in den
-Papierkorb verschoben):
+## Tab „Audit-Log"
 
-- **Liste:** [`GET /tools/trash`](/docs/reference/endpoints/tools#listtrashedtools)
-- **In den Papierkorb verschieben:** [`POST /tools/trash`](/docs/reference/endpoints/tools#trashtools)
-- **Wiederherstellen:** [`POST /tools/trash/restore`](/docs/reference/endpoints/tools#restoretools)
-- **Endgültig löschen (einzeln):** [`DELETE /tools/trash`](/docs/reference/endpoints/tools#deletetrashedtools)
-- **Papierkorb leeren:** [`POST /tools/trash/empty`](/docs/reference/endpoints/tools#emptytrash)
+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.
 
-> Die Aufbewahrungsfrist des Papierkorbs (in Tagen) ist im
-> [`VersionInfo`](/docs/reference/schemas/versioninfo)-Schema als
-> `trashRetentionDays` verfügbar.
+API-Referenz: [`GET /audit-logs`](/docs/reference/endpoints/audit#listAuditLogs).
 
-## Felder im Überblick
+## Tab „System"
 
-### User
+Versionsinformationen der laufenden Instanz:
 
-| Feld | Typ | Bedeutung |
-| --- | --- | --- |
-| `id` | integer | Eindeutige Nutzer-ID. |
-| `username` | string | Anmeldename. |
-| `email` | string? | E-Mail-Adresse. |
-| `role` | string | `admin` oder `user`. |
-| `tier` | string | `free`, `premium` oder `enterprise`. |
-| `authProvider` | string | `local` oder `oidc`. |
-| `createdAt` | date-time | Erstellungszeitpunkt. |
+- **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.