PAL Kompetenzmess

Anleitung für System-Admins (SA)

Technischer Betrieb: Nutzerkonten, Audit-Log, Monitoring, API

Rollen-Abgrenzung (seit 07.07.2026): Der SA arbeitet „technisch, ohne Dateninhalt" — kein Zugriff auf Auswertung/Einzelauswertung, keine Klarnamen, keine Ergebnisdaten über die API. Verwaltung (Erhebungen, Fragebögen, Nutzer, Audit-Log, Monitoring) bleibt vollständig.

1. Nutzer:innen & API-Keys

Menü Administration → Nutzer:innen: Konten anlegen/deaktivieren, Rollen und Einrichtung zuordnen. Der Aktiv-Schalter sperrt sofort Login und API.

Nutzerverwaltung mit Rollen und Aktionen — Nutzerverwaltung: Rollen, Status, API-Key-Aktion je Zeile.

API-Key erzeugen (Aktion in der Nutzerzeile): Der Schlüssel wird einmalig angezeigt — gespeichert wird nur ein Hash. Verlorener Key = neuen erzeugen (der alte wird ungültig).

2. Audit-Log

Menü Administration → Audit-Log (nur lesbar): Logins/Logouts, Änderungen an Stammobjekten, jeder Export (wer, was, Format, Zeilen), API-Zugriffe, Consent-Widerrufe, Retention-Läufe.

Audit-Log mit Ereignissen — Revisionssicheres Audit-Log mit Filter nach Ereignistyp.

3. Monitoring

Werkzeug	Zweck
`/horizon`	Queue-Zustand, fehlgeschlagene Jobs (Retry direkt dort)
`/telescope` (nur SA/SUP)	Fehler, langsame Queries, Schedule, Mail-Vorschau — in Prod nur Fehler/Slow/Failed
`/metrics` (mit `METRICS_TOKEN`)	Prometheus-Kennzahlen (`pal_up`, `pal_queue_size` …); optional Compose-Profil `monitoring` (Prometheus+Grafana)
`/up`	Healthcheck für externe Uptime-Überwachung

4. Wiederkehrende Jobs

Zeit	Job	Prüfen
03:00	`retention:enforce` — Klardaten-Anonymisierung	Audit-Log „retention"; Probelauf mit `--dry-run`
08:00	`reminders:dispatch` — Kohorten-Erinnerungen	Horizon (Mail-Jobs)

php artisan schedule:list zeigt die Registrierung; der scheduler-Container muss laufen.

5. REST-API

Auth: Header X-API-Key: <key> oder Authorization: Bearer <key>
Lesend: GET /api/v1/me, /surveys, /surveys/{id}/results (pseudonymisiert + Aggregat), /cohorts
Schreibend: POST /api/v1/surveys/{id}/participants mit {"count": 10} und/oder {"persons": [...]} — Antwort enthält die Zugangs-Tokens
RBAC gilt auch hier; jeder Zugriff wird auditiert. Details: docs/spec/rest-api.md

6. Störungen

Playbooks im Betriebs-Runbook (docs/RUNBOOK.md, Abschnitt 8): Admin-500 (intl), unstyled Survey (Vite-Assets), fehlende Ergebnisse (Worker), PDF-Fehler (Gotenberg), RLS (DB-Rolle), Traefik/Session.

← Zurück zur Übersicht aller Anleitungen