TenantAtlas/apps/platform/tests/Feature/BackupScheduling/DispatchIdempotencyTest.php

<?php

use App\Jobs\RunBackupScheduleJob;
use App\Models\BackupSchedule;
use App\Models\OperationRun;
use App\Services\BackupScheduling\BackupScheduleDispatcher;
use App\Services\OperationRunService;
use Carbon\CarbonImmutable;
use Illuminate\Support\Facades\Bus;

it('dispatching the same slot twice creates only one run', function () {
    CarbonImmutable::setTestNow(CarbonImmutable::create(2026, 1, 5, 10, 0, 30, 'UTC'));

    [$user, $tenant] = createUserWithTenant(role: 'owner');
    $this->actingAs($user);

    BackupSchedule::query()->create([
        'managed_environment_id' => $tenant->id,
        'name' => 'Daily 10:00',
        'is_enabled' => true,
        'timezone' => 'UTC',
        'frequency' => 'daily',
        'time_of_day' => '10:00:00',
        'days_of_week' => null,
        'policy_types' => ['deviceConfiguration'],
        'include_foundations' => true,
        'retention_keep_last' => 30,
        'next_run_at' => null,
    ]);

    Bus::fake();

    $dispatcher = app(BackupScheduleDispatcher::class);

    $dispatcher->dispatchDue([$tenant->external_id]);
    $dispatcher->dispatchDue([$tenant->external_id]);

    expect(OperationRun::query()
        ->where('managed_environment_id', $tenant->getKey())
        ->where('type', 'backup.schedule.execute')
        ->count())->toBe(1);

    Bus::assertDispatchedTimes(RunBackupScheduleJob::class, 1);

    Bus::assertDispatched(RunBackupScheduleJob::class, function (RunBackupScheduleJob $job) use ($tenant): bool {
        return $job->backupScheduleId !== null
            && $job->operationRun?->managed_environment_id === $tenant->getKey()
            && $job->operationRun?->type === 'backup.schedule.execute';
    });
});

it('treats an existing canonical run as already-dispatched and advances next_run_at', function () {
    CarbonImmutable::setTestNow(CarbonImmutable::create(2026, 1, 5, 10, 0, 30, 'UTC'));

    [$user, $tenant] = createUserWithTenant(role: 'owner');
    $this->actingAs($user);

    $schedule = BackupSchedule::query()->create([
        'managed_environment_id' => $tenant->id,
        'name' => 'Daily 10:00',
        'is_enabled' => true,
        'timezone' => 'UTC',
        'frequency' => 'daily',
        'time_of_day' => '10:00:00',
        'days_of_week' => null,
        'policy_types' => ['deviceConfiguration'],
        'include_foundations' => true,
        'retention_keep_last' => 30,
        'next_run_at' => null,
    ]);

    /** @var OperationRunService $operationRunService */
    $operationRunService = app(OperationRunService::class);

    $operationRunService->ensureRunWithIdentityStrict(
        tenant: $tenant,
        type: 'backup.schedule.execute',
        identityInputs: [
            'backup_schedule_id' => (int) $schedule->id,
            'scheduled_for' => CarbonImmutable::now('UTC')->startOfMinute()->toDateTimeString(),
        ],
        context: [
            'backup_schedule_id' => (int) $schedule->id,
            'scheduled_for' => CarbonImmutable::now('UTC')->startOfMinute()->toDateTimeString(),
            'trigger' => 'scheduled',
        ],
    );

    Bus::fake();

    $dispatcher = app(BackupScheduleDispatcher::class);
    $dispatcher->dispatchDue([$tenant->external_id]);
    Bus::assertNotDispatched(RunBackupScheduleJob::class);

    expect(OperationRun::query()
        ->where('managed_environment_id', $tenant->getKey())
        ->where('type', 'backup.schedule.execute')
        ->count())->toBe(1);

    $schedule->refresh();
    expect($schedule->next_run_at)->not->toBeNull();
    expect($schedule->next_run_at->toDateTimeString())->toBe('2026-01-06 10:00:00');
});

it('does not dispatch archived schedules', function () {
    CarbonImmutable::setTestNow(CarbonImmutable::create(2026, 1, 5, 10, 0, 30, 'UTC'));

    [$user, $tenant] = createUserWithTenant(role: 'owner');
    $this->actingAs($user);

    $schedule = BackupSchedule::query()->create([
        'managed_environment_id' => $tenant->id,
        'name' => 'Archived daily 10:00',
        'is_enabled' => true,
        'timezone' => 'UTC',
        'frequency' => 'daily',
        'time_of_day' => '10:00:00',
        'days_of_week' => null,
        'policy_types' => ['deviceConfiguration'],
        'include_foundations' => true,
        'retention_keep_last' => 30,
        'next_run_at' => null,
    ]);

    $schedule->delete();

    Bus::fake();

    $dispatcher = app(BackupScheduleDispatcher::class);
    $result = $dispatcher->dispatchDue([$tenant->external_id]);

    expect($result['created_runs'])->toBe(0)
        ->and($result['scanned_schedules'])->toBe(0)
        ->and(OperationRun::query()
            ->where('managed_environment_id', $tenant->getKey())
            ->where('type', 'backup.schedule.execute')
            ->count())->toBe(0);

    Bus::assertNotDispatched(RunBackupScheduleJob::class);
});