1
0
Files
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

4.7 KiB

Dokumentation

Letzte Aktualisierung: 2026-04-01

Diese Dokumentation ist nach dem Diataxis-Modell in vier Quadranten gegliedert: Tutorials zum Lernen, How-to Guides zum Nachschlagen von Aufgaben, Explanation zum Verstehen und Reference zum Nachschlagen von Fakten.

Tutorials

  1. /docs/tutorial-01-erste-schritte.md
    • Schnellstart: Repo klonen, Container starten, erster Login.
  2. /docs/tutorial-02-systemueberblick.md
    • Produktbild, Kernmodule und Lernziel in 10 Minuten.
  3. /docs/tutorial-03-setup-und-erster-login.md
    • Lokales Setup, erster Login, erster Smoke-Test.
  4. /docs/tutorial-04-architektur-request-flow.md
    • Request-Flow, Schichtmodell, Do/Don't.
  5. /docs/tutorial-05-erste-aenderung-ui.md
    • Erste sichere UI-Änderung im Admin-Bereich.
  6. /docs/tutorial-06-erste-aenderung-backend.md
    • Erste Backend-/Service-/Repository-Änderung.
  7. /docs/tutorial-07-security-tenant-scope.md
    • Sicherheitsgrundlagen, Tenant-Scope, Pflichtchecks.
  8. /docs/tutorial-08-api-erweitern.md
    • API-Änderung sauber mit OpenAPI und Tests umsetzen.
  9. /docs/tutorial-09-advanced-scheduler-sso.md
    • Fortgeschrittene Themen: Scheduler, Lifecycle, SSO.

How-to Guides

  • /docs/howto-erste-aenderung.md
    • Schritt-für-Schritt durch die erste Codeänderung.
  • /docs/howto-globale-suche.md
    • Neue Resource in der globalen Suche integrieren.
  • /docs/howto-importe.md
    • Importfluss, Regeln und Fehlercodes.
  • /docs/howto-benutzerdefinierte-felder.md
    • Tenant/User-Zusatzfelder korrekt erweitern.
  • /docs/howto-geplante-aufgaben.md
    • Neue Scheduler-Jobs registrieren und betreiben.
  • /docs/howto-auth-sso-smoke-test.md
    • SSO-Funktionalitaet manuell verifizieren.
  • /docs/howto-anfragelimits.md
    • Rate-Limits verstehen und testen.
  • /docs/howto-rbac-permissions-playbook.md
    • RBAC-Rechte sauber erweitern (neue Permission, neue Ability, UI/API-Faelle).
  • /docs/howto-request-input-validation.md
    • Einheitliches Request/Input- und Validation-Muster für Web + API.
  • /docs/howto-docker-lokal.md
    • Lokaler Docker-Betrieb.
  • /docs/howto-docker-produktiv.md
    • Produktivbetrieb mit Docker.
  • /docs/howto-betriebscheck-doctor.md
    • Schneller Systemcheck mit php bin/console doctor.
  • /docs/howto-fehlerbehebung.md
    • Häufige Fehler und schnelle Lösungen.
  • /docs/howto-lokale-entwicklung.md
    • Tages-Workflow für Entwicklung und Checks.
  • /docs/howto-modul-erstellen.md
    • Neues Modul erstellen: Scaffold, Manifest, Route, Permission, UI-Slot, Test.
  • /docs/howto-gitea-required-checks.md
    • Gitea-Workflow für qa-required vorbereiten (Phase 1 enforcement-ready).
  • /docs/howto-dokumentation-erweitern.md
    • Regeln für konsistente, wachsende Doku.

Explanation

  • /docs/explanation-architektur.md
    • Architektur-Kompass mit verbindlichen Leitplanken.
  • /docs/explanation-di-container.md
    • Wie der AppContainer funktioniert und neue Services registriert werden.
  • /docs/explanation-sicherheitsmodell.md
    • Vollstaendiges Sicherheitsmodell (Auth, Permission, Scope).
  • /docs/explanation-session-management.md
    • Session-Lifecycle, Timeouts, Remember-Token, Frontend-Keepalive.
  • /docs/explanation-einstellungen-speicherung.md
    • Warum Settings in DB + Datei-Cache koexistieren.
  • /docs/explanation-docker-betrieb.md
    • Übersicht und Entscheidungshilfe für Dev/Prod.

Reference

  • /docs/reference-domain-glossar.md
    • Zentrale Begriffe (Tenant, Role, Permission, Scope, Policy).
  • /docs/reference-api.md
    • API-Referenz-Einstieg.
  • /docs/reference-konfiguration.md
    • ENV-Variablen und Produktions-Defaults.
  • /docs/reference-konventionen.md
    • Projektweite Konventionen (kurz und verbindlich).
  • /docs/reference-core-standards.md
    • Regeln speziell für core/**.
  • /docs/reference-benutzer-lifecycle-policy.md
    • Policy- und Laufzeitreferenz für User Lifecycle.
  • /docs/reference-frontend-css.md
    • CSS-Schichtsystem und Namenskonventionen.
  • /docs/reference-frontend-javascript.md
    • JS-Module, DOM-Utilities und Patterns.
  • /docs/reference-entwickler-checkliste.md
    • Definition of Done vor Merge.
  • /docs/reference-codex-prompts.md
    • Standard-Prompts für Skill-basierte Planung und Implementierung.
  • /docs/reference-extension-readiness.md
    • Freigabe-Checkliste für weitere Module auf Basis des bestehenden Modul-Contracts.
  • /docs/reference-cli-commands.md
    • Alle CLI-Kommandos (php bin/console), Bootstrap-Helfer, Anleitung neue Kommandos.
  • /docs/reference-module-manifest-contract.md
    • Verbindlicher Runtime- und Manifest-Contract für Module (V1.1).
  • /docs/reference-notifications-module.md
    • Verbindliche Referenz für Notifications (Events, Guardrails, Dedupe, Bell-Vertrag, Tests).
  • Agent-Workflow (Rollen, State-Machine, Contracts): siehe /.agents/workflow.md