fs
545bcc789b
Most German docs were written with `ue`/`ae`/`oe`/`ss` ASCII fallbacks (`fuer`, `aenderung`, `koennen`, `gemaess`) — relic from older toolchain constraints. Replaced 237 occurrences across 38 .md files with proper umlauts and ß so the docs read naturally. Substitutions are constrained to plain prose: fenced code blocks (```...```), inline code spans (`...`), markdown link targets `[..](..)`, and HTML comments are preserved verbatim. Path references like `docs/howto-erste-aenderung.md` keep their original (umlaut-replaced) filenames — only the surrounding prose is normalised. Tool: bin/fix-md-umlauts.py (idempotent — no-op on already-clean files). Re-runnable if ASCII fallbacks creep back in via copy-paste. Doc-link-check + doc-drift-check stay green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
57 lines
1.2 KiB
Markdown
57 lines
1.2 KiB
Markdown
# 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
|
|
```
|