docs/explanation-docker-betrieb.md

# Docker-Betrieb

Letzte Aktualisierung: 2026-03-06

## Übersicht

Die Docker-Dokumentation ist in zwei klare Pfade getrennt:

1. Lokal entwickeln:
   - `/docs/howto-docker-lokal.md`
2. Produktiv betreiben:
   - `/docs/howto-docker-produktiv.md`

## Empfehlung

- Für tägliche Entwicklung immer mit `docker-compose.yml` arbeiten.
- Für Serverbetrieb ausschließlich `docker-compose.prod.yml` verwenden.
- Änderungen an Domain/TLS nur in der Produktivdoku und den Produktivdateien pflegen.
- Webserver-Contract ist Nginx-only; `.htaccess` wird im Docker-Betrieb nicht berücksichtigt.
- Nach Start oder Deployment einmal `docker compose exec php php bin/console doctor` ausführen.
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			`# Docker-Betrieb`

docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001 2026-03-06 12:25:18 +01:00			`Letzte Aktualisierung: 2026-03-06`
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
			`## Übersicht`

			`Die Docker-Dokumentation ist in zwei klare Pfade getrennt:`

			`1. Lokal entwickeln:`
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001 2026-03-06 12:25:18 +01:00			- `/docs/howto-docker-lokal.md`
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			`2. Produktiv betreiben:`
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001 2026-03-06 12:25:18 +01:00			- `/docs/howto-docker-produktiv.md`
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
			`## Empfehlung`

			- Für tägliche Entwicklung immer mit `docker-compose.yml` arbeiten.
			- Für Serverbetrieb ausschließlich `docker-compose.prod.yml` verwenden.
			`- Änderungen an Domain/TLS nur in der Produktivdoku und den Produktivdateien pflegen.`
chore: enforce nginx-only setup and remove .htaccess 2026-04-26 09:50:40 +02:00			- Webserver-Contract ist Nginx-only; `.htaccess` wird im Docker-Betrieb nicht berücksichtigt.
fix(docs): resolve documentation drift and add missing content - Fix fictional SettingGateway/SettingService references with actual multi-gateway pattern (AdminSettingsService + domain-specific gateways) - Replace non-existent gridQueryLimitOffset()/gridQueryOrderDir() with actual gridParseFiltersFromSchemaFile() - Normalize bin/doctor.php references to canonical bin/console doctor - Add i18n_path contract to module manifest docs - Document module:validate and make:module CLI commands - Add APP_VENDOR_PHP_ISSUES_MODE env var to config reference - Remove invalid label field from notifications module permissions (violates manifest schema additionalProperties: false) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> 2026-03-25 19:15:53 +01:00			- Nach Start oder Deployment einmal `docker compose exec php php bin/console doctor` ausführen.