opencode
6c92b6358d
Full documentation hub replacing the release-notes-only view: - Handbook pages (docs/handbook) for all features and admin/betrieb - API reference generated from lib/api-spec/openapi.yaml via scripts/src/generate-docs.mjs (replaces sync-release-docs.mjs): endpoints, schemas/fields, search index, per-release snapshots - mkdocs layout: sidebar nav, right TOC with scrollspy, search overlay, version dropdown, repo link - FieldHelp (?) buttons in forms linking to reference field docs - v0.7.0 release notes backfilled, v0.8.0 release notes added
62 lines
2.2 KiB
Markdown
62 lines
2.2 KiB
Markdown
---
|
|
title: Administration & Papierkorb
|
|
order: 7
|
|
---
|
|
|
|
# Administration & Papierkorb
|
|
|
|
Diese Bereiche sind nur für **Administrator:innen** sichtbar und nutzbar.
|
|
|
|
## Nutzerverwaltung
|
|
|
|
Unter **Admin → Nutzer** kannst du:
|
|
|
|
- **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**.
|
|
|
|
Zugehörige Endpunkte (Admin-only):
|
|
|
|
- [`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)
|
|
|
|
## Audit-Log
|
|
|
|
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.
|
|
|
|
## Papierkorb (Trash)
|
|
|
|
Tools werden nicht sofort gelöscht, sondern zuerst **soft gelöscht** (in den
|
|
Papierkorb verschoben):
|
|
|
|
- **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)
|
|
|
|
> Die Aufbewahrungsfrist des Papierkorbs (in Tagen) ist im
|
|
> [`VersionInfo`](/docs/reference/schemas/versioninfo)-Schema als
|
|
> `trashRetentionDays` verfügbar.
|
|
|
|
## Felder im Überblick
|
|
|
|
### User
|
|
|
|
| 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. |
|