add composer-unused, comprehensive docs, and project restructure
- 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>
2026-02-22 15:27:35 +01:00
# Dokumentation
2026-03-20 00:05:03 +01:00
Letzte Aktualisierung: 2026-03-19
add composer-unused, comprehensive docs, and project restructure
- 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>
2026-02-22 15:27:35 +01:00
2026-03-06 12:25:18 +01:00
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.
add composer-unused, comprehensive docs, and project restructure
- 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>
2026-02-22 15:27:35 +01:00
2026-03-06 12:25:18 +01:00
## Tutorials
add composer-unused, comprehensive docs, and project restructure
- 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>
2026-02-22 15:27:35 +01:00
2026-03-06 12:25:18 +01:00
1. `/docs/tutorial-01-erste-schritte.md`
- Schnellstart: Repo klonen, Container starten, erster Login.
2. `/docs/tutorial-02-systemueberblick.md`
2026-03-04 15:56:58 +01:00
- Produktbild, Kernmodule und Lernziel in 10 Minuten.
2026-03-06 12:25:18 +01:00
3. `/docs/tutorial-03-setup-und-erster-login.md`
2026-03-04 15:56:58 +01:00
- Lokales Setup, erster Login, erster Smoke-Test.
2026-03-06 12:25:18 +01:00
4. `/docs/tutorial-04-architektur-request-flow.md`
2026-03-04 15:56:58 +01:00
- Request-Flow, Schichtmodell, Do/Don't.
2026-03-06 12:25:18 +01:00
5. `/docs/tutorial-05-erste-aenderung-ui.md`
- Erste sichere UI-Aenderung im Admin-Bereich.
6. `/docs/tutorial-06-erste-aenderung-backend.md`
- Erste Backend-/Service-/Repository-Aenderung.
7. `/docs/tutorial-07-security-tenant-scope.md`
2026-03-04 15:56:58 +01:00
- Sicherheitsgrundlagen, Tenant-Scope, Pflichtchecks.
2026-03-06 12:25:18 +01:00
8. `/docs/tutorial-08-api-erweitern.md`
- API-Aenderung sauber mit OpenAPI und Tests umsetzen.
9. `/docs/tutorial-09-advanced-scheduler-sso.md`
2026-03-04 15:56:58 +01:00
- Fortgeschrittene Themen: Scheduler, Lifecycle, SSO.
add composer-unused, comprehensive docs, and project restructure
- 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>
2026-02-22 15:27:35 +01:00
2026-03-06 12:25:18 +01:00
## How-to Guides
add composer-unused, comprehensive docs, and project restructure
- 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>
2026-02-22 15:27:35 +01:00
2026-03-06 12:25:18 +01:00
- `/docs/howto-erste-aenderung.md`
- Schritt-fuer-Schritt durch die erste Codeaenderung.
- `/docs/howto-globale-suche.md`
2026-03-04 15:56:58 +01:00
- Neue Resource in der globalen Suche integrieren.
2026-03-06 12:25:18 +01:00
- `/docs/howto-importe.md`
2026-03-04 15:56:58 +01:00
- Importfluss, Regeln und Fehlercodes.
2026-03-06 12:25:18 +01:00
- `/docs/howto-benutzerdefinierte-felder.md`
2026-03-04 15:56:58 +01:00
- Tenant/User-Zusatzfelder korrekt erweitern.
2026-03-06 12:25:18 +01:00
- `/docs/howto-geplante-aufgaben.md`
2026-03-04 15:56:58 +01:00
- Neue Scheduler-Jobs registrieren und betreiben.
2026-03-06 12:25:18 +01:00
- `/docs/howto-auth-sso-smoke-test.md`
- SSO-Funktionalitaet manuell verifizieren.
- `/docs/howto-anfragelimits.md`
2026-03-04 15:56:58 +01:00
- Rate-Limits verstehen und testen.
2026-03-06 12:25:18 +01:00
- `/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 fuer Web + API.
- `/docs/howto-docker-lokal.md`
2026-03-04 15:56:58 +01:00
- Lokaler Docker-Betrieb.
2026-03-06 12:25:18 +01:00
- `/docs/howto-docker-produktiv.md`
2026-03-04 15:56:58 +01:00
- Produktivbetrieb mit Docker.
2026-03-06 12:25:18 +01:00
- `/docs/howto-betriebscheck-doctor.md`
2026-03-19 19:25:38 +01:00
- Schneller Systemcheck mit `php bin/console doctor` .
2026-03-06 12:25:18 +01:00
- `/docs/howto-fehlerbehebung.md`
- Haeufige Fehler und schnelle Loesungen.
- `/docs/howto-lokale-entwicklung.md`
- Tages-Workflow fuer Entwicklung und Checks.
- `/docs/howto-dokumentation-erweitern.md`
- Regeln fuer konsistente, wachsende Doku.
2026-03-04 15:56:58 +01:00
2026-03-06 12:25:18 +01:00
## Explanation
2026-03-04 15:56:58 +01:00
2026-03-06 12:25:18 +01:00
- `/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).
2026-03-14 15:57:44 +01:00
- `/docs/explanation-session-management.md`
- Session-Lifecycle, Timeouts, Remember-Token, Frontend-Keepalive.
2026-03-06 12:25:18 +01:00
- `/docs/explanation-einstellungen-speicherung.md`
- Warum Settings in DB + Datei-Cache koexistieren.
- `/docs/explanation-docker-betrieb.md`
- Uebersicht und Entscheidungshilfe fuer Dev/Prod.
2026-03-06 00:44:52 +01:00
2026-03-06 12:25:18 +01:00
## Reference
2026-03-06 00:44:52 +01:00
2026-03-06 12:25:18 +01:00
- `/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-lib-standards.md`
- Regeln speziell fuer `lib/**` .
- `/docs/reference-benutzer-lifecycle-policy.md`
- Policy- und Laufzeitreferenz fuer 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 fuer Skill-basierte Planung und Implementierung.
2026-03-09 18:30:52 +01:00
- `/docs/reference-extension-readiness.md`
feat: extend module platform with UI slots, runtime components, CLI tooling and {{userId}} search support
Completes the generic module platform that enables modules to contribute
UI elements, runtime JS components, and search resources without any
core hardcoding.
New generic UI slot types:
- topbar.right_item: module-contributed topbar buttons
- layout.body_end_template: module-contributed dialog/overlay templates
- layout.head_style: module-contributed global CSS
- runtime.component: declarative JS component registration with phase ordering
New infrastructure:
- ModuleAutoloader: PSR-4 autoloading for module-local PHP classes
- ModuleRuntimePageBuilder: symlinks module pages into runtime directory
- ModuleRuntimeAssetPublisher: publishes module CSS/JS to web/modules/
- ModulePermissionSynchronizer: syncs module permissions to DB
- CLI scripts: module-runtime-sync, module-build, module-migrate,
module-permissions-sync, module-assets-sync
- {{userId}} placeholder in SearchDataService for user-scoped search queries
- Component runtime with phased initialization (early/default/late)
- AppContainer.protectExistingBindings() to prevent module→core overwrites
- Architecture tests: ModuleStructureContractTest, CoreTemplateIsolationTest,
FrontendComponentRuntimeContractTest, AppContainerIsolationContractTest
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 22:19:56 +01:00
- Freigabe-Checkliste fuer weitere Module auf Basis des bestehenden Modul-Contracts.
2026-03-19 19:25:38 +01:00
- `/docs/reference-cli-commands.md`
- Alle CLI-Kommandos (`php bin/console` ), Bootstrap-Helfer, Anleitung neue Kommandos.
feat: extend module platform with UI slots, runtime components, CLI tooling and {{userId}} search support
Completes the generic module platform that enables modules to contribute
UI elements, runtime JS components, and search resources without any
core hardcoding.
New generic UI slot types:
- topbar.right_item: module-contributed topbar buttons
- layout.body_end_template: module-contributed dialog/overlay templates
- layout.head_style: module-contributed global CSS
- runtime.component: declarative JS component registration with phase ordering
New infrastructure:
- ModuleAutoloader: PSR-4 autoloading for module-local PHP classes
- ModuleRuntimePageBuilder: symlinks module pages into runtime directory
- ModuleRuntimeAssetPublisher: publishes module CSS/JS to web/modules/
- ModulePermissionSynchronizer: syncs module permissions to DB
- CLI scripts: module-runtime-sync, module-build, module-migrate,
module-permissions-sync, module-assets-sync
- {{userId}} placeholder in SearchDataService for user-scoped search queries
- Component runtime with phased initialization (early/default/late)
- AppContainer.protectExistingBindings() to prevent module→core overwrites
- Architecture tests: ModuleStructureContractTest, CoreTemplateIsolationTest,
FrontendComponentRuntimeContractTest, AppContainerIsolationContractTest
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 22:19:56 +01:00
- `/docs/reference-module-manifest-contract.md`
- Verbindlicher Runtime- und Manifest-Contract fuer Module (V1.1).
2026-03-20 00:05:03 +01:00
- `/docs/reference-notifications-module.md`
- Verbindliche Referenz fuer Notifications (Events, Guardrails, Dedupe, Bell-Vertrag, Tests).
2026-03-19 19:25:38 +01:00
- Agent-Workflow (Rollen, State-Machine, Contracts): siehe `/.agents/workflow.md`