2.7 KiB
2.7 KiB
Dokumentation
Letzte Aktualisierung: 2026-02-22
Diese Dokumente sind für Entwickler gedacht, die die Anwendung warten oder erweitern.
Start hier (neue Entwickler)
/docs/erste-schritte.md- Setup in 30-45 Minuten, erster Login, erster Smoke-Test.
/docs/lokale-entwicklung.md- Täglicher Workflow, Schema-Updates und Qualitätschecks.
/docs/erste-aenderung.md- Schritt-für-Schritt für den ersten kleinen Code-Change.
/docs/dokumentation-erweitern.md- Wie neue Doku-Dateien sauber erstellt, einsortiert und suchbar gemacht werden.
/docs/entwickler-checkliste.md- Finale Checkliste vor Merge/Review.
Architektur und Regeln
/docs/architektur.md- Request-Lebenszyklus, Schichtentrennung, Frontend-Aufbau.
/docs/sicherheitsmodell.md- Auth, Permissions, Tenant-Scope, Public/API-Zugriffe.
/docs/konventionen.md- Coding- und Strukturkonventionen für PHP, Templates, CSS, JS.
Frontend
/docs/frontend-javascript.md- Frontend-JS-Aufbau, Init-Flow, Grid-Integration und URL-State-Sync.
/docs/frontend-css.md- CSS-Struktur, Layering, Vendor-Overrides und Asset-Einbindung.
Fach- und Feature-Dokumentation
/docs/benutzerdefinierte-felder.md- Tenant/User-Zusatzfelder (Typen, Pflege, Filterbarkeit).
/docs/importe.md- CSV-Import (V1), Mapping, Fehlercodes, Permission-Modell und Import-Audit.
/docs/einstellungen-speicherung.md- Source of truth für Settings (DB) und Datei-Cache-Verhalten.
/docs/anfragelimits.md- Login/API-Limits, Scopes, Block-Verhalten.
/docs/benutzer-lifecycle-policy.md- Automatische Benutzer-Deaktivierung/Löschung (Policy, Cron, manueller Run).
/docs/geplante-aufgaben.md- Zentrale geplante Aufgaben (Scheduler), Job-Konfiguration und Runner-Betrieb.
/docs/globale-suche.md- Globale Suche erweitern (Resource, Permission, Mapping, Aside-Integration).
API Referenz
/docs/api.md- API Quick Reference, Auth, Flows, Beispielaufrufe.
/docs/openapi.yaml- API Source of truth für Swagger UI.
Betriebswissen
/docs/konfiguration.md- Alle ENV-Variablen mit Beschreibung, Standardwerten und Produktions-Checkliste.
/docs/fehlerbehebung.md- Häufige Fehlerbilder und schnelle Lösungen.
/docs/auth-sso-smoke-test.md- Manueller Smoke-Runbook für Login, Microsoft-Start/Callback, Tenant-SSO-Save und Logout.
/docs/docker-lokal.md- Schneller lokaler Docker-Start inkl. typischer Befehle und Troubleshooting.
/docs/docker-produktiv.md- Produktionsbetrieb mit Domain, TLS und
docker-compose.prod.yml.
- Produktionsbetrieb mit Domain, TLS und
/docs/docker-betrieb.md- Einstieg und Navigation zwischen lokaler und produktiver Docker-Doku.