Files
breadcrumb-the-shire/docs/howto-betriebscheck-doctor.md
fs 545bcc789b docs: replace ASCII umlaut fallbacks with proper äöüß across all .md
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>
2026-04-29 09:57:22 +02:00

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 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

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