fa/breadcrumb-the-shire
1
0
Fork 1
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

feat(scheduler): dispatch event on job failure, notify admins via notifications module

Browse Source 
Add ?ModuleEventDispatcher to SchedulerRunService (fail-open, nullable).
Dispatch scheduler.job_failed event when a job fails with payload:
job_id, job_key, label, error_code, error_message, trigger_type.

New SchedulerJobFailedNotificationListener in notifications module
creates in-app admin notifications for users with JOBS_MANAGE
permission, scoped per tenant, with 30-min dedup per job_key.

Also fixes audit module manifest: system_audit_purge job_key was
mismatched (audit_system_purge vs system_audit_purge in DB).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Felix Schneider
2026-04-06 12:26:54 +02:00
parent 576a0c51cd
commit 97ff3ce135
10 changed files with 276 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
modules/notifications/i18n/default_de.json
View File

@@ -12,5 +12,7 @@
"User activated: %s": "Benutzer aktiviert: %s",
"User deactivated: %s": "Benutzer deaktiviert: %s",
"User assignments updated: %s": "Benutzer-Zuweisungen aktualisiert: %s",
"Tenant, role, or department assignments were changed.": "Mandanten-, Rollen- oder Abteilungszuweisungen wurden geändert."
"Tenant, role, or department assignments were changed.": "Mandanten-, Rollen- oder Abteilungszuweisungen wurden geändert.",
"Scheduled job failed: %s": "Geplante Aufgabe fehlgeschlagen: %s",
"Error: %s": "Fehler: %s"
}

4
modules/notifications/i18n/default_en.json
View File

@@ -12,5 +12,7 @@
"User activated: %s": "User activated: %s",
"User deactivated: %s": "User deactivated: %s",
"User assignments updated: %s": "User assignments updated: %s",
"Tenant, role, or department assignments were changed.": "Tenant, role, or department assignments were changed."
"Tenant, role, or department assignments were changed.": "Tenant, role, or department assignments were changed.",
"Scheduled job failed: %s": "Scheduled job failed: %s",
"Error: %s": "Error: %s"
}

89
modules/notifications/lib/Module/Notifications/Listeners/SchedulerJobFailedNotificationListener.php Normal file
View File

@@ -0,0 +1,89 @@
<?php
namespace MintyPHP\Module\Notifications\Listeners;
use MintyPHP\App\Module\Contracts\EventListener;
use MintyPHP\Module\Notifications\Service\NotificationMessage;
use MintyPHP\Module\Notifications\Service\NotificationService;
use MintyPHP\Repository\User\UserReadRepositoryInterface;
use MintyPHP\Repository\Tenant\UserTenantRepositoryInterface;
use MintyPHP\Service\Access\PermissionService;
final class SchedulerJobFailedNotificationListener implements EventListener
{
public function __construct(
private readonly NotificationService $notificationService,
private readonly UserReadRepositoryInterface $userReadRepository,
private readonly UserTenantRepositoryInterface $userTenantRepository
) {
}
public function handle(string $event, array $payload): void
{
$jobKey = trim((string) ($payload['job_key'] ?? ''));
$jobId = (int) ($payload['job_id'] ?? 0);
$label = trim((string) ($payload['label'] ?? ''));
$errorCode = trim((string) ($payload['error_code'] ?? ''));
if ($jobKey === '' || $jobId <= 0) {
return;
}
$displayLabel = $label !== '' ? $label : $jobKey;
$adminUserIds = $this->userReadRepository->listPrivilegedUserIdsByPermissionKeys(
[PermissionService::JOBS_MANAGE]
);
if ($adminUserIds === []) {
return;
}
$adminSet = array_flip($adminUserIds);
$titleParams = [$displayLabel];
$bodyParams = $errorCode !== '' ? [$errorCode] : [];
$message = NotificationMessage::localized(
'scheduler.job_failed',
'Scheduled job failed: %s',
$titleParams,
$errorCode !== '' ? 'Error: %s' : null,
$bodyParams,
'admin/scheduled-jobs',
[
'job_id' => $jobId,
'job_key' => $jobKey,
'error_code' => $errorCode,
'dedupe_target' => 'job:' . $jobKey,
]
);
$tenantIds = $this->resolveAdminTenantIds($adminUserIds);
foreach ($tenantIds as $tenantId) {
$this->notificationService->createForTenantAdminUsersFromMessage(
$tenantId,
$message,
null,
$adminSet
);
}
}
/**
* Collect all unique tenant IDs across admin users.
*
* @param list<int> $userIds
* @return list<int>
*/
private function resolveAdminTenantIds(array $userIds): array
{
$tenantIds = [];
foreach ($userIds as $userId) {
foreach ($this->userTenantRepository->listTenantIdsByUserId($userId) as $tenantId) {
$tenantIds[$tenantId] = true;
}
}
return array_keys($tenantIds);
}
}

7
modules/notifications/lib/Module/Notifications/NotificationsContainerRegistrar.php
View File

@@ -9,6 +9,7 @@ use MintyPHP\Module\Notifications\Listeners\UserActivatedNotificationListener;
use MintyPHP\Module\Notifications\Listeners\UserAssignmentChangedNotificationListener;
use MintyPHP\Module\Notifications\Listeners\UserCreatedNotificationListener;
use MintyPHP\Module\Notifications\Listeners\UserDeactivatedNotificationListener;
use MintyPHP\Module\Notifications\Listeners\SchedulerJobFailedNotificationListener;
use MintyPHP\Module\Notifications\Listeners\UserDeletedNotificationListener;
use MintyPHP\Module\Notifications\Repository\NotificationRepository;
use MintyPHP\Module\Notifications\Service\NotificationService;
@@ -62,5 +63,11 @@ final class NotificationsContainerRegistrar implements ContainerRegistrar
$c->get(NotificationService::class),
$c->get(UserReadRepository::class)
));
$container->set(SchedulerJobFailedNotificationListener::class, static fn (AppContainer $c): SchedulerJobFailedNotificationListener => new SchedulerJobFailedNotificationListener(
$c->get(NotificationService::class),
$c->get(UserReadRepository::class),
$c->get(UserTenantRepository::class)
));
}
}

1
modules/notifications/lib/Module/Notifications/Service/NotificationService.php
View File

@@ -15,6 +15,7 @@ class NotificationService
'user.activated' => true,
'user.deactivated' => true,
'user.assignment_changed' => true,
'scheduler.job_failed' => true,
];
public function __construct(

3
modules/notifications/module.php
View File

@@ -90,6 +90,9 @@ return [
'user.assignment_changed' => [
['class' => \MintyPHP\Module\Notifications\Listeners\UserAssignmentChangedNotificationListener::class, 'method' => 'handle'],
],
'scheduler.job_failed' => [
['class' => \MintyPHP\Module\Notifications\Listeners\SchedulerJobFailedNotificationListener::class, 'method' => 'handle'],
],
],
'scheduler_jobs' => [

130
modules/notifications/tests/Module/Notifications/Listeners/SchedulerJobFailedNotificationListenerTest.php Normal file
View File

@@ -0,0 +1,130 @@
<?php
namespace MintyPHP\Tests\Module\Notifications\Listeners;
use MintyPHP\Module\Notifications\Listeners\SchedulerJobFailedNotificationListener;
use MintyPHP\Module\Notifications\Service\NotificationMessage;
use MintyPHP\Module\Notifications\Service\NotificationService;
use MintyPHP\Repository\Tenant\UserTenantRepositoryInterface;
use MintyPHP\Repository\User\UserReadRepositoryInterface;
use MintyPHP\Service\Access\PermissionService;
use PHPUnit\Framework\MockObject\MockObject;
use PHPUnit\Framework\TestCase;
class SchedulerJobFailedNotificationListenerTest extends TestCase
{
private NotificationService&MockObject $notifService;
private UserReadRepositoryInterface&MockObject $userRepo;
private UserTenantRepositoryInterface&MockObject $utRepo;
private SchedulerJobFailedNotificationListener $listener;
protected function setUp(): void
{
$this->notifService = $this->createMock(NotificationService::class);
$this->userRepo = $this->createMock(UserReadRepositoryInterface::class);
$this->utRepo = $this->createMock(UserTenantRepositoryInterface::class);
$this->listener = new SchedulerJobFailedNotificationListener($this->notifService, $this->userRepo, $this->utRepo);
}
public function testHandleCreatesNotificationsForAdminsAcrossTenants(): void
{
$this->userRepo->expects($this->any())->method('listPrivilegedUserIdsByPermissionKeys')
->with([PermissionService::JOBS_MANAGE])
->willReturn([20, 30]);
$this->utRepo->expects($this->exactly(2))
->method('listTenantIdsByUserId')
->willReturnMap([
[20, [1, 2]],
[30, [2, 3]],
]);
$this->notifService->expects($this->exactly(3))
->method('createForTenantAdminUsersFromMessage')
->willReturnCallback(function (int $tenantId, NotificationMessage $message, ?int $excludeUserId, array $adminSet): int {
$this->assertContains($tenantId, [1, 2, 3]);
$this->assertSame('scheduler.job_failed', $message->type());
$this->assertStringContainsString('System audit purge', $message->title());
$this->assertSame('admin/scheduled-jobs', $message->link());
$this->assertNull($excludeUserId);
$this->assertArrayHasKey(20, $adminSet);
$this->assertArrayHasKey(30, $adminSet);
$this->assertSame('Scheduled job failed: %s', $message->titleKey());
$data = $message->data();
$this->assertSame('job:system_audit_purge', $data['dedupe_target']);
$this->assertSame('job_not_registered', $data['error_code']);
return 1;
});
$this->listener->handle('scheduler.job_failed', [
'job_id' => 5,
'job_key' => 'system_audit_purge',
'label' => 'System audit purge',
'error_code' => 'job_not_registered',
'error_message' => null,
'trigger_type' => 'scheduler',
]);
}
public function testHandleUsesJobKeyAsLabelWhenLabelEmpty(): void
{
$this->userRepo->expects($this->any())->method('listPrivilegedUserIdsByPermissionKeys')->willReturn([10]);
$this->utRepo->expects($this->any())->method('listTenantIdsByUserId')->willReturn([1]);
$this->notifService->expects($this->once())
->method('createForTenantAdminUsersFromMessage')
->willReturnCallback(function (int $tenantId, NotificationMessage $message): int {
$this->assertStringContainsString('my_job_key', $message->title());
return 1;
});
$this->listener->handle('scheduler.job_failed', [
'job_id' => 1,
'job_key' => 'my_job_key',
'label' => '',
'error_code' => 'unexpected_error',
]);
}
public function testHandleSkipsEmptyPayload(): void
{
$this->notifService->expects($this->never())->method('createForTenantAdminUsersFromMessage');
$this->listener->handle('scheduler.job_failed', []);
$this->listener->handle('scheduler.job_failed', ['job_key' => '', 'job_id' => 0]);
$this->listener->handle('scheduler.job_failed', ['job_key' => 'test', 'job_id' => 0]);
}
public function testHandleSkipsWhenNoAdmins(): void
{
$this->userRepo->expects($this->any())->method('listPrivilegedUserIdsByPermissionKeys')->willReturn([]);
$this->notifService->expects($this->never())->method('createForTenantAdminUsersFromMessage');
$this->listener->handle('scheduler.job_failed', [
'job_id' => 5,
'job_key' => 'some_job',
'label' => 'Some Job',
'error_code' => 'unexpected_error',
]);
}
public function testHandleOmitsBodyWhenNoErrorCode(): void
{
$this->userRepo->expects($this->any())->method('listPrivilegedUserIdsByPermissionKeys')->willReturn([10]);
$this->utRepo->expects($this->any())->method('listTenantIdsByUserId')->willReturn([1]);
$this->notifService->expects($this->once())
->method('createForTenantAdminUsersFromMessage')
->willReturnCallback(function (int $tenantId, NotificationMessage $message): int {
$this->assertNull($message->body());
return 1;
});
$this->listener->handle('scheduler.job_failed', [
'job_id' => 1,
'job_key' => 'test_job',
'label' => 'Test',
'error_code' => '',
]);
}
}