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>
4.7 KiB
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
/docs/tutorial-01-erste-schritte.md- Schnellstart: Repo klonen, Container starten, erster Login.
/docs/tutorial-02-systemueberblick.md- Produktbild, Kernmodule und Lernziel in 10 Minuten.
/docs/tutorial-03-setup-und-erster-login.md- Lokales Setup, erster Login, erster Smoke-Test.
/docs/tutorial-04-architektur-request-flow.md- Request-Flow, Schichtmodell, Do/Don't.
/docs/tutorial-05-erste-aenderung-ui.md- Erste sichere UI-Änderung im Admin-Bereich.
/docs/tutorial-06-erste-aenderung-backend.md- Erste Backend-/Service-/Repository-Änderung.
/docs/tutorial-07-security-tenant-scope.md- Sicherheitsgrundlagen, Tenant-Scope, Pflichtchecks.
/docs/tutorial-08-api-erweitern.md- API-Änderung sauber mit OpenAPI und Tests umsetzen.
/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.
- Schneller Systemcheck mit
/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-requiredvorbereiten (Phase 1 enforcement-ready).
- Gitea-Workflow für
/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/**.
- Regeln speziell für
/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.
- Alle CLI-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