forked from fa/breadcrumb-the-shire
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>
1.2 KiB
1.2 KiB
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):
php bin/console doctor
Im Docker-Setup:
docker compose exec php php bin/console doctor
Exit-Code
0: keine harten Fehler1: mindestens einFAIL-Check
WARN führt nicht zu Exit 1, sollte aber geprüft werden.
Typischer Einsatz im Betrieb
- Direkt nach Neuinstallation / Deployment.
- Bei 4xx/5xx-Symptomen als erster Schritt.
- Nach Konfigurations- oder RBAC-Änderungen.
Beispielausgabe
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