breadcrumb-the-shire/docs/howto-betriebscheck-doctor.md

# Betriebscheck mit `doctor`

Letzte Aktualisierung: 2026-03-19

## Ziel

`php bin/console doctor` ist der schnelle Gesundheitscheck für eine Instanz.

Er prüft unter anderem:

- ENV-Validierung (Pflichtkeys + Formate)
- AppContainer-Bootstrap
- Datenbankverbindung + Kern-Tabellen
- Schreibbarkeit von `APP_STORAGE_PATH`
- RBAC-Basisrechte
- Admin-Rollen-Zuweisung
- Scheduler-Heartbeat (Warnung, falls alt/fehlend)

## Aufruf

Lokal (wenn PHP + DB direkt erreichbar sind):

```bash
php bin/console doctor
```

Im Docker-Setup:

```bash
docker compose exec php php bin/console doctor
```

## Exit-Code

- `0`: keine harten Fehler
- `1`: mindestens ein `FAIL`-Check

`WARN` führt nicht zu Exit `1`, sollte aber geprüft werden.

## Typischer Einsatz im Betrieb

1. Direkt nach Neuinstallation / Deployment.
2. Bei 4xx/5xx-Symptomen als erster Schritt.
3. Nach Konfigurations- oder RBAC-Änderungen.

## Beispielausgabe

```text
Minty Doctor Report
===================
[OK] Environment validation: all required env keys and formats are valid
[OK] Database connectivity: connection established
[WARN] Scheduler heartbeat: last heartbeat 900s ago (result=ok)

Summary: ok=7 warn=1 fail=0
```