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

<?php

use App\Jobs\ApplyBackupScheduleRetentionJob;
use App\Jobs\RunBackupScheduleJob;
use App\Models\BackupSchedule;
use App\Models\BackupSet;
use App\Services\BackupScheduling\PolicyTypeResolver;
use App\Services\BackupScheduling\RunErrorMapper;
use App\Services\BackupScheduling\ScheduleTimeService;
use App\Services\Intune\AuditLogger;
use App\Services\Intune\BackupService;
use App\Services\Intune\PolicySyncService;
use App\Services\OperationRunService;
use Carbon\CarbonImmutable;
use Illuminate\Contracts\Queue\Job;
use Illuminate\Support\Facades\Bus;
use Illuminate\Support\Facades\Cache;

it('creates a backup set and marks the operation run successful', function () {
    Bus::fake();

    CarbonImmutable::setTestNow(CarbonImmutable::create(2026, 1, 5, 10, 0, 30, 'UTC'));

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

    $schedule = BackupSchedule::query()->create([
        'tenant_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);
    $operationRun = $operationRunService->ensureRun(
        tenant: $tenant,
        type: 'backup_schedule_run',
        inputs: ['backup_schedule_id' => (int) $schedule->id],
        initiator: $user,
    );

    app()->bind(PolicySyncService::class, fn () => new class extends PolicySyncService
    {
        public function __construct() {}

        public function syncPoliciesWithReport($tenant, ?array $supportedTypes = null): array
        {
            return ['synced' => [], 'failures' => []];
        }
    });

    $backupSet = BackupSet::factory()->create([
        'tenant_id' => $tenant->id,
        'status' => 'completed',
        'item_count' => 0,
    ]);

    app()->bind(BackupService::class, fn () => new class($backupSet) extends BackupService
    {
        public function __construct(private readonly BackupSet $backupSet) {}

        public function createBackupSet($tenant, $policyIds, ?string $actorEmail = null, ?string $actorName = null, ?string $name = null, bool $includeAssignments = false, bool $includeScopeTags = false, bool $includeFoundations = false): BackupSet
        {
            return $this->backupSet;
        }
    });

    Cache::flush();

    (new RunBackupScheduleJob(operationRun: $operationRun, backupScheduleId: (int) $schedule->id))->handle(
        app(PolicySyncService::class),
        app(BackupService::class),
        app(PolicyTypeResolver::class),
        app(ScheduleTimeService::class),
        app(AuditLogger::class),
        app(RunErrorMapper::class),
    );

    $schedule->refresh();
    expect($schedule->last_run_status)->toBe('success');

    $operationRun->refresh();
    expect($operationRun->status)->toBe('completed');
    expect($operationRun->outcome)->toBe('succeeded');
    expect($operationRun->context)->toMatchArray([
        'backup_schedule_id' => (int) $schedule->id,
        'backup_set_id' => (int) $backupSet->id,
    ]);
    expect($operationRun->summary_counts)->toMatchArray([
        'created' => 1,
    ]);

    Bus::assertDispatched(ApplyBackupScheduleRetentionJob::class);
});

it('skips runs when all policy types are unknown', function () {
    Bus::fake();

    CarbonImmutable::setTestNow(CarbonImmutable::create(2026, 1, 5, 10, 0, 30, 'UTC'));

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

    $schedule = BackupSchedule::query()->create([
        'tenant_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' => ['definitelyNotARealPolicyType'],
        'include_foundations' => true,
        'retention_keep_last' => 30,
        'next_run_at' => null,
    ]);

    /** @var OperationRunService $operationRunService */
    $operationRunService = app(OperationRunService::class);
    $operationRun = $operationRunService->ensureRun(
        tenant: $tenant,
        type: 'backup_schedule_run',
        inputs: ['backup_schedule_id' => (int) $schedule->id],
        initiator: $user,
    );

    Cache::flush();

    (new RunBackupScheduleJob(operationRun: $operationRun, backupScheduleId: (int) $schedule->id))->handle(
        app(PolicySyncService::class),
        app(BackupService::class),
        app(PolicyTypeResolver::class),
        app(ScheduleTimeService::class),
        app(AuditLogger::class),
        app(RunErrorMapper::class),
    );

    $schedule->refresh();
    expect($schedule->last_run_status)->toBe('skipped');

    $operationRun->refresh();
    expect($operationRun->status)->toBe('completed');
    expect($operationRun->outcome)->toBe('blocked');
    expect($operationRun->failure_summary)->toMatchArray([
        [
            'code' => 'unknown_policy_type',
            'message' => 'All configured policy types are unknown.',
            'reason_code' => 'unknown_error',
        ],
    ]);

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

it('marks runs as blocked when the schedule is archived', function () {
    Bus::fake();

    CarbonImmutable::setTestNow(CarbonImmutable::create(2026, 1, 5, 10, 0, 30, 'UTC'));

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

    $schedule = BackupSchedule::query()->create([
        'tenant_id' => $tenant->id,
        'name' => 'Archived schedule',
        '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();

    /** @var OperationRunService $operationRunService */
    $operationRunService = app(OperationRunService::class);
    $operationRun = $operationRunService->ensureRun(
        tenant: $tenant,
        type: 'backup_schedule_run',
        inputs: ['backup_schedule_id' => (int) $schedule->id],
        initiator: $user,
    );

    Cache::flush();

    (new RunBackupScheduleJob(operationRun: $operationRun, backupScheduleId: (int) $schedule->id))->handle(
        app(PolicySyncService::class),
        app(BackupService::class),
        app(PolicyTypeResolver::class),
        app(ScheduleTimeService::class),
        app(AuditLogger::class),
        app(RunErrorMapper::class),
    );

    $schedule->refresh();
    expect($schedule->last_run_status)->toBe('skipped');

    $operationRun->refresh();
    expect($operationRun->status)->toBe('completed');
    expect($operationRun->outcome)->toBe('blocked');
    expect($operationRun->summary_counts)->toMatchArray([
        'total' => 0,
        'processed' => 0,
        'failed' => 0,
        'skipped' => 1,
    ]);
    expect($operationRun->failure_summary)->toMatchArray([
        [
            'code' => 'schedule_archived',
            'reason_code' => 'unknown_error',
            'message' => 'Schedule is archived; run will not execute.',
        ],
    ]);

    $this->assertDatabaseHas('audit_logs', [
        'tenant_id' => $tenant->id,
        'action' => 'backup_schedule.run_skipped',
    ]);

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

it('fails fast when operation run context is not passed into the job', function () {
    CarbonImmutable::setTestNow(CarbonImmutable::create(2026, 1, 5, 10, 0, 30, 'UTC'));

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

    $schedule = BackupSchedule::query()->create([
        'tenant_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,
    ]);

    $queueJob = \Mockery::mock(Job::class);
    $queueJob->shouldReceive('fail')->once();

    $job = new RunBackupScheduleJob(operationRun: null, backupScheduleId: (int) $schedule->id);
    $job->setJob($queueJob);

    $job->handle(
        app(PolicySyncService::class),
        app(BackupService::class),
        app(PolicyTypeResolver::class),
        app(ScheduleTimeService::class),
        app(AuditLogger::class),
        app(RunErrorMapper::class),
    );
});