TenantAtlas/app/Jobs/Operations/PolicyVersionPruneWorkerJob.php

<?php

namespace App\Jobs\Operations;

use App\Models\OperationRun;
use App\Models\PolicyVersion;
use App\Services\OperationRunService;
use App\Services\Operations\TargetScopeConcurrencyLimiter;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use RuntimeException;
use Throwable;

class PolicyVersionPruneWorkerJob implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public ?OperationRun $operationRun = null;

    /**
     * @param  array<string, mixed>  $context
     */
    public function __construct(
        public int $tenantId,
        public int $userId,
        public int $policyVersionId,
        public int $retentionDays = 90,
        ?OperationRun $operationRun = null,
        public array $context = [],
    ) {
        $this->operationRun = $operationRun;
    }

    public function handle(OperationRunService $runs, TargetScopeConcurrencyLimiter $limiter): void
    {
        if (! $this->operationRun instanceof OperationRun) {
            throw new RuntimeException('OperationRun is required for policy version prune worker.');
        }

        $this->operationRun->refresh();

        if ($this->operationRun->status === 'completed') {
            return;
        }

        $context = is_array($this->operationRun->context) ? $this->operationRun->context : [];
        $targetScope = is_array($context['target_scope'] ?? null) ? $context['target_scope'] : [];

        $lock = $limiter->acquireSlot($this->tenantId, $targetScope);

        if (! $lock) {
            $delay = (int) config('tenantpilot.bulk_operations.poll_interval_seconds', 3);
            $this->release(max(1, $delay));

            return;
        }

        try {
            $version = PolicyVersion::withTrashed()
                ->where('tenant_id', $this->tenantId)
                ->whereKey($this->policyVersionId)
                ->first();

            if (! $version instanceof PolicyVersion) {
                $runs->incrementSummaryCounts($this->operationRun, [
                    'processed' => 1,
                    'failed' => 1,
                ]);

                $runs->appendFailures($this->operationRun, [[
                    'code' => 'policy_version.not_found',
                    'message' => 'Policy version '.$this->policyVersionId.' not found.',
                ]]);

                $runs->maybeCompleteBulkRun($this->operationRun);

                return;
            }

            if ($version->trashed()) {
                $runs->incrementSummaryCounts($this->operationRun, [
                    'processed' => 1,
                    'skipped' => 1,
                ]);

                $runs->maybeCompleteBulkRun($this->operationRun);

                return;
            }

            $eligible = PolicyVersion::query()
                ->where('tenant_id', $this->tenantId)
                ->whereKey($version->id)
                ->pruneEligible($this->retentionDays)
                ->exists();

            if (! $eligible) {
                $runs->incrementSummaryCounts($this->operationRun, [
                    'processed' => 1,
                    'skipped' => 1,
                ]);

                $runs->maybeCompleteBulkRun($this->operationRun);

                return;
            }

            $version->delete();

            $runs->incrementSummaryCounts($this->operationRun, [
                'processed' => 1,
                'succeeded' => 1,
                'deleted' => 1,
            ]);

            $runs->maybeCompleteBulkRun($this->operationRun);
        } catch (Throwable $e) {
            $runs->incrementSummaryCounts($this->operationRun, [
                'processed' => 1,
                'failed' => 1,
            ]);

            $runs->appendFailures($this->operationRun, [[
                'code' => 'policy_version.prune_failed',
                'message' => $e->getMessage(),
            ]]);

            $runs->maybeCompleteBulkRun($this->operationRun);

            throw $e;
        } finally {
            $lock->release();
        }
    }
}