Enable Discovery debug logging for production troubleshooting

- Add DISCOVERY_LOG_LEVEL=debug
- Add DISCOVERY_SHOW_PROGRESS=true
- Temporary changes for debugging InitializerProcessor fixes on production
This commit is contained in:
2025-08-11 20:13:26 +02:00
parent 59fd3dd3b1
commit 55a330b223
3683 changed files with 2956207 additions and 16948 deletions

67
docs/next-steps.md Normal file
View File

@@ -0,0 +1,67 @@
# Nächste Schritte (Kurzplan)
Dieser Kurzplan macht die Top-Prioritäten aus `docs/tasks.md` sofort umsetzbar. Er ist so geschrieben, dass du ihn Schritt für Schritt abarbeiten kannst. Jeder Schritt verweist auf die detaillierten Aufgaben in `docs/tasks.md`.
Hinweis: Befehle lokal ausführen; Projekt nutzt Docker. Siehe auch „Project Guidelines“ im Repository.
## Heute (Setup & Checks)
- [ ] Abhängigkeiten installieren und Basis-Checks ausführen
- [ ] Composer-Install: `composer install`
- [ ] Docker Images bauen: `./build.sh`
- [ ] Stack starten: `docker-compose up -d`
- [ ] Healthcheck: App erreichbar unter http://localhost:${APP_PORT:-8000}
- [ ] Grundchecks lokal laufen lassen
- [ ] Linter (sofern konfiguriert): `composer cs`
- [ ] PHPStan: `composer phpstan`
- [ ] Tests: `./vendor/bin/pest`
Siehe: tasks.md → 1 (Baseline), 2 (CI/CD), 3 (Static Analysis), 15 (Testing)
## Als Nächstes (Kurzzyklus, 12 Tage)
- [ ] Static Analysis schärfen (tasks.md → Punkt 3)
- [ ] Selektiv `declare(strict_types=1);` in Hot-Paths ergänzen (z. B. src/Framework/Http/*, src/Framework/Config/*)
- [ ] PHPStan auf aktueller Codebasis „sauber“ bekommen (Fehler beheben statt pauschal ignorieren)
- [ ] Baseline überprüfen und ggf. reduzieren
- [ ] Kritische Tests ergänzen (tasks.md → Punkte 10, 11, 14, 15)
- [ ] HTTP: Tests für HttpRequest/Query, Fehlerpfade, Middleware-Kette
- [ ] Feature Flags: Tests für CacheFeatureFlagRepository inkl. Negative Caching Verhalten
- [ ] WAF/Rate Limiting: Basisfälle & Fehlerszenarien abdecken
## Diese Woche (35 Tage)
- [ ] CI/CD-Pipeline aufsetzen/härten (tasks.md → Punkt 2)
- [ ] Jobs: Lint, PHPStan, Pest, `composer audit`
- [ ] Optional: Coverage (XDEBUG_MODE=coverage) mit Minimal-Schwelle
- [ ] Pre-commit Hooks (z. B. CaptainHook) lokal aktivieren
- [ ] Konfiguration & Secrets zentralisieren (tasks.md → Punkt 5)
- [ ] `.env.example` prüfen/ergänzen (fehlende Keys, Defaults)
- [ ] Boot-time Validierung sicherstellen (ConfigValidator bereits integriert)
- [ ] Secrets über ENV/Secret Store, nicht im Repo
- [ ] Observability-Basis (tasks.md → Punkte 6, 8)
- [ ] Strukturierte Logs & Metriken-Events (Cache Hit/Miss/Errors) definieren
- [ ] Einfache Zähler/Timer an kritischen Stellen einhängen
## Konkrete, kleine Fixes (Schnelle Gewinne)
- [ ] Feature Flags Negative-Caching absichern (tasks.md → 20)
- [ ] Prüfen, dass der Marker (`NOT_FOUND`) nicht mit echten Werten kollidiert; ggf. Sentinel-ValueObject einführen
- [ ] View Cache nicht einchecken (tasks.md → 13, 20)
- [ ] Sicherstellen, dass `src/Framework/View/cache/*` in `.gitignore` ausgeschlossen ist
## Validierung nach Umsetzung
- [ ] Alle Checks lokal: `composer cs && composer phpstan && ./vendor/bin/pest && composer audit`
- [ ] Docker-Stack Neustart: `docker-compose restart`
- [ ] Manuelle Smoke-Tests der wichtigsten Endpunkte
## Entscheidungspunkte (bitte festlegen)
- [ ] Bevorzugtes CI-System (GitHub Actions, GitLab CI, …)?
- [ ] Minimal abzudeckende Coverage-Schwelle (z. B. 40% initial)?
- [ ] Ziel-PHPStan-Level kurzfristig (8 → 9)?
---
Kurzlinke Referenzen:
- CI/CD → tasks.md §2
- Static Analysis → tasks.md §3
- HTTP Layer → tasks.md §10
- Feature Flags → tasks.md §11 & §20
- WAF/Rate Limiting → tasks.md §7
- Konfiguration/Secrets → tasks.md §5
- Observability → tasks.md §6 & §8