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>
1.6 KiB
1.6 KiB
Fehlerbehebung
Letzte Aktualisierung: 2026-02-21
App reagiert nicht wie erwartet
Symptom
UI zeigt alte Daten/Assets oder Verhalten wirkt stale.
Lösung
docker compose restart php nginx
Login/API verhalten sich unerwartet
Symptom
401/403 bei API trotz gültigem Token.
Checks
- Authorization Header korrekt gesetzt (
Bearer <selector:secret>) - Token nicht revoked/abgelaufen
- Token hat erforderliche Permission
- Bei tenant-scoped Token: Zugriff nur auf passende Tenant-Ressourcen
Migration oder Schema-Probleme
Symptom
Neue Felder/Features fehlen lokal.
Lösung
- Aktuelles Schema in
db/init/init.sqlprüfen - Für Bestandsumgebung idempotentes SQL-Update ausführen
- Danach Container neu starten:
docker compose restart php
i18n Fehler
Symptom
Fehlende Translation-Keys oder Mixed-Language UI.
Lösung
docker compose exec php vendor/bin/phpunit --bootstrap vendor/autoload.php tests/I18n/TranslationKeysTest.php
PHPStan/Tests schlagen plötzlich fehl
Symptom
Fehler nach Refactor, obwohl Seite lädt.
Lösung
docker compose exec php vendor/bin/phpstan analyse -c phpstan.neon --no-progress
docker compose exec php vendor/bin/phpunit --bootstrap vendor/autoload.php
Dann gezielt betroffene Datei/Service prüfen.
Swagger UI lädt ungestylt oder inkonsistent
Symptom
API docs sehen nicht nach App-Theme aus.
Lösung
- Prüfen, dass
Buffer::set('style_groups', json_encode(['api-docs']))gesetzt ist - Prüfen, dass
css/vendor-overrides/swagger-ui.cssüberconfig/assets.phpeingebunden ist - Hard-Reload im Browser