fs
25370a1a55
- Add icanhazstring/composer-unused as dev dependency for dependency hygiene checks - Add German documentation (docs/) covering architecture, conventions, workflows, and developer checklists - Add API layer (ApiAuth, ApiBootstrap, ApiResponse), audit, scheduler, custom fields, and SSO services - Add Microsoft OIDC SSO, API token management, and user lifecycle features - Add swagger-ui vendor integration and OpenAPI spec - Add production Docker setup and bin/ scripts - Update composer dependencies, config, templates, and frontend assets throughout Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
72 lines
2.5 KiB
Markdown
72 lines
2.5 KiB
Markdown
# Dokumentation
|
|
|
|
Letzte Aktualisierung: 2026-02-21
|
|
|
|
Diese Dokumente sind für Entwickler gedacht, die die Anwendung warten oder erweitern.
|
|
|
|
## Start hier (neue Entwickler)
|
|
|
|
1. `/docs/erste-schritte.md`
|
|
- Setup in 30-45 Minuten, erster Login, erster Smoke-Test.
|
|
2. `/docs/lokale-entwicklung.md`
|
|
- Täglicher Workflow, Schema-Updates und Qualitätschecks.
|
|
3. `/docs/erste-aenderung.md`
|
|
- Schritt-für-Schritt für den ersten kleinen Code-Change.
|
|
4. `/docs/dokumentation-erweitern.md`
|
|
- Wie neue Doku-Dateien sauber erstellt, einsortiert und suchbar gemacht werden.
|
|
5. `/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/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`.
|
|
- `/docs/docker-betrieb.md`
|
|
- Einstieg und Navigation zwischen lokaler und produktiver Docker-Doku.
|