fs
0e86925464
Rename the top-level lib/ directory to core/ so the project root immediately communicates which code is core platform and which lives in modules/. PHP namespaces (MintyPHP\*) are unchanged — only the Composer PSR-4 path mapping moves from lib/ to core/. Module-internal lib/ directories (modules/*/lib/) are untouched. Updated across the full stack: - composer.json PSR-4 mapping - bootstrap entry points (web/index.php, bin/*, tests/bootstrap.php) - tooling configs (phpstan.neon, phpunit.xml, php-cs-fixer) - 26 architecture contract tests - enforcement-policy, guard-catalog, quality-gates - all documentation (CLAUDE.md, README, 25 docs/, .agents/skills/) - bin/qa-extended.sh search paths - .claude/settings.local.json permission paths Workflow: .agents/runs/CORE-LIB-RENAME-001/ (Analyst → Planner → Executor → Code Review (4 findings fixed) → Security Review → Acceptance Test → Finalizer) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
75 lines
2.2 KiB
Markdown
75 lines
2.2 KiB
Markdown
# Geplante Aufgaben
|
|
|
|
Letzte Aktualisierung: 2026-03-06
|
|
|
|
## Ziel
|
|
|
|
Scheduler-Betrieb und Job-Erweiterung kurz und verlässlich dokumentieren.
|
|
|
|
## Kernkomponenten
|
|
|
|
- Runner: `bin/console scheduler:run`
|
|
- Orchestrierung: `core/Service/Scheduler/SchedulerRunService.php`
|
|
- Job-Konfiguration: `core/Service/Scheduler/ScheduledJobService.php`
|
|
- Registry: `core/Service/Scheduler/ScheduledJobRegistry.php`
|
|
- Schedule-Berechnung: `core/Service/Scheduler/ScheduleCalculator.php`
|
|
|
|
## Datenmodell
|
|
|
|
- `scheduled_jobs`: Job-Konfiguration und letzter Laufstatus
|
|
- `scheduled_job_runs`: Historie einzelner Läufe
|
|
- `scheduler_runtime_status`: Heartbeat/Runner-Status (eine Zeile, `id = 1`)
|
|
|
|
Retention:
|
|
|
|
- Run-Logs: 90 Tage (`ScheduledJobService::purgeRunsExpired`)
|
|
- System-Audit: konfigurierbar über `system_audit_retention_days` (Job `system_audit_purge`)
|
|
|
|
## Laufmodell
|
|
|
|
1. Runner startet und synchronisiert Registry-Jobs (`ensureSystemJobs`).
|
|
2. Globaler MySQL-Lock wird gesetzt (`scheduled_jobs_runner`).
|
|
3. Fällige Jobs (`enabled=1`, `next_run_at <= now`) werden abgearbeitet.
|
|
4. Jeder Lauf wird als `success`/`failed`/`skipped` protokolliert.
|
|
5. `next_run_at` wird neu berechnet.
|
|
6. Heartbeat wird aktualisiert, Lock wird freigegeben.
|
|
|
|
## Scheduling
|
|
|
|
Unterstützt:
|
|
|
|
- `hourly` (1..24)
|
|
- `daily` (1..365 + Uhrzeit)
|
|
- `weekly` (1..52 + Uhrzeit + Wochentage)
|
|
|
|
`catchup_once` steuert Nachholverhalten:
|
|
|
|
- `1`: genau ein Nachhol-Lauf, danach normal weiter
|
|
- `0`: kein Backlog-Sturm, verpasste Fenster werden übersprungen
|
|
|
|
## Rechte
|
|
|
|
- `jobs.view`: Übersicht sehen
|
|
- `jobs.manage`: Job speichern
|
|
- `jobs.run_now`: Job manuell starten
|
|
- Purge der Run-Logs: `settings.update`
|
|
|
|
Registrierte Core-Jobs:
|
|
|
|
- `user_lifecycle_run`
|
|
- `system_audit_purge`
|
|
|
|
## Neuen Job registrieren (kurz)
|
|
|
|
1. Handler in `core/Service/Scheduler/Handler/*` erstellen (`ScheduledJobHandlerInterface`).
|
|
2. Job-Key + Handler in `ScheduledJobRegistry` ergänzen.
|
|
3. Abhängigkeiten in `SchedulerServicesFactory` verdrahten.
|
|
|
|
Danach wird der Job bei `ensureSystemJobs()` automatisch in `scheduled_jobs` angelegt.
|
|
|
|
## Troubleshooting
|
|
|
|
- `lock_not_acquired`: ein anderer Runner läuft.
|
|
- Job bleibt `running`: stale-running Schutz greift nach 2 Stunden.
|
|
- Job läuft nicht: `enabled`, `next_run_at`, `timezone`, Schedule prüfen.
|