Files

fs 0e86925464 refactor: rename lib/ to core/ for clearer core-module separation

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>

2026-04-13 23:20:42 +02:00

2.2 KiB

Raw Blame History

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

Runner startet und synchronisiert Registry-Jobs (ensureSystemJobs).
Globaler MySQL-Lock wird gesetzt (scheduled_jobs_runner).
Fällige Jobs (enabled=1, next_run_at <= now) werden abgearbeitet.
Jeder Lauf wird als success/failed/skipped protokolliert.
next_run_at wird neu berechnet.
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)

Handler in core/Service/Scheduler/Handler/* erstellen (ScheduledJobHandlerInterface).
Job-Key + Handler in ScheduledJobRegistry ergänzen.
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.

2.2 KiB Raw Blame History