Ton: Fehlerabschnitte von Fuersorge-Sprache auf Handbuch-Sprache umgestellt
- AGENTS.md: neue Pflichtregel 'Ton in Fehlerabschnitten' (Tabelle Meldung|Bedeutung|Vorgehen; verbotene Muster + Ersatzformen) - anwender/*: 12 Seiten umgeschrieben - 'Wenn etwas schiefgeht'/'Wenn nicht alles klappt' -> 'Fehler'-Tabellen; 'bitte deine Betreuung/Teamleitung' -> konkrete Instanz mit Link; 'Zeichen fuer Zeichen', 'hoechstens drei Versuche', 'statt weiter zu raten' entfernt - hilfe.md komplett neu: Fehleruebersicht + Zustaendigkeiten als Tabellen (Titel 'Hilfe bei Stoerungen') - admin/ki-funktionen: Produkt-Zitat als solches belassen; projekt/audit-backup, sammlungen-anlegen, llm-nutzen entbelehrt - Belege nachgezogen: upload.maxBodySize/allowedMimeTypes, Konflikt = Unique-Index (409/500), Passwort-Reset in der Benutzerverwaltung - Build 71 Seiten gruen, 0 tote Links/Tabellen
This commit is contained in:
1 parent
761466dd63
commit
6aabd842e9
20 files changed
+83
-114
No files matched your search
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: 'Änderungen und Sicherung'
|
||||
description: 'Audit-Log lesen, Snapshots nutzen, Backup und Restore mit dem Betreiber abstimmen.'
|
||||
description: 'Audit-Log lesen, Snapshots nutzen, Backup und Restore ausführen.'
|
||||
---
|
||||
|
||||
import { Aside, Steps, Card, CardGrid } from '@astrojs/starlight/components';
|
||||
@@ -198,7 +198,7 @@ Der Check läuft in `admin_auth.go:20-74` **immer in dieser Reihenfolge**:
|
||||
Fehlt am Token das richtige Flag, antwortet der Endpunkt mit `403` — auch wenn du Projekt-Admin bist. `permissions: []` im Snapshot-Profil hilft dir heute nicht weiter (Phase 2); maßgeblich ist `allowSnapshots` am Token.
|
||||
</Aside>
|
||||
|
||||
## Backup und Restore (mit Betreiber)
|
||||
## Backup und Restore
|
||||
|
||||
Backups sind der Voll-Export für Umzug und Desaster-Fall — im Admin unter `/projects/:id/backup`:
|
||||
|
||||
@@ -219,8 +219,8 @@ Backups sind der Voll-Export für Umzug und Desaster-Fall — im Admin unter `/p
|
||||
| Fortschritt | Ja (Stream) | Ja (SSE-Stream) |
|
||||
|
||||
<Aside type="caution">
|
||||
Backup und Restore immer mit dem Betreiber abstimmen: Restore überschreibt Daten, große Medien brauchen Zeit und Platz.
|
||||
Fortschritt läuft als Stream (`text/event-stream`) — bei Abbrüchen nichts doppelt starten, sondern Analyse neu holen.
|
||||
Restore überschreibt Daten; große Medien brauchen Zeit und Platz.
|
||||
Fortschritt läuft als Stream (`text/event-stream`) — nach einem Abbruch die Analyse erneut hochladen und ein neues Token holen (Tokens sind einmalig, siehe Fehlertabelle unten).
|
||||
</Aside>
|
||||
|
||||
## Fehler
|
||||
@@ -229,8 +229,8 @@ Fortschritt läuft als Stream (`text/event-stream`) — bei Abbrüchen nichts do
|
||||
|---|---|---|
|
||||
| Audit bleibt leer | `audit.enabled` im Projekt fehlt oder Server-Flag aus | Beide Schalter prüfen, Änderung erneut auslösen |
|
||||
| Alte Einträge verschwinden | TTL (`720h`) abgelaufen | Wichtige Stände als Snapshot sichern, TTL ggf. auf `"0"` |
|
||||
| Snapshot-Button fehlt | Token ohne `allowSnapshots` | Betreiber um Recht bitten |
|
||||
| Backup-Button fehlt | Kein Projekt-Admin oder `AllowBackup` fehlt | Betreiber um Recht bitten |
|
||||
| Snapshot-Button fehlt | Token ohne `allowSnapshots` | Flag `allowSnapshots` am Projekt-Token setzen (siehe [Rechte und Auth-Reihenfolge](#rechte-und-auth-reihenfolge)) |
|
||||
| Backup-Button fehlt | Kein Projekt-Admin oder `AllowBackup` fehlt | Projekt-Admin-Rolle bzw. Flag `AllowBackup` am Projekt-Token prüfen (siehe [Rechte und Auth-Reihenfolge](#rechte-und-auth-reihenfolge)) |
|
||||
| `400 missing restoreToken` | Restore ohne Token aufgerufen | Erst `POST /backup` (Analyse), Token aus der Antwort nehmen |
|
||||
| `404 restore token not found or expired` | Token verbraucht, aufgeräumt oder TTL abgelaufen | Analyse erneut hochladen, neues Token holen |
|
||||
| `403 invalid entry id` / `404 snapshot not found` | Snapshot-Restore mit falscher/gelöschter ID | ID aus `GET /snapshots` neu lesen |
|
||||
|
||||
Reference in new issue
Block a user