crewli/api/app/Policies/FormBuilder/FormSubmissionActionFailurePolicy.php

<?php

declare(strict_types=1);

namespace App\Policies\FormBuilder;

use App\Models\FormBuilder\FormSubmissionActionFailure;
use App\Models\Organisation;
use App\Models\User;

/**
 * RFC-WS-6 §4 (V3) — IDOR-class FK-chain enforcement.
 *
 * The `form_submission_action_failures` table has no `organisation_id`
 * column by design. Tenant scope flows via
 * failure.submission.organisation_id. Cross-tenant access returns
 * `false` here; controllers (sessions 2/3) translate to 404 to prevent
 * resource-existence enumeration.
 */
final class FormSubmissionActionFailurePolicy
{
    public function viewAny(User $user): bool
    {
        if ($user->hasRole('super_admin')) {
            return true;
        }

        // Org admin in any organisation. Controllers in sessions 2/3
        // restrict the result set per role.
        return $user->organisations()
            ->wherePivot('role', 'org_admin')
            ->exists();
    }

    public function view(User $user, FormSubmissionActionFailure $failure): bool
    {
        return $this->canAccess($user, $failure);
    }

    public function retry(User $user, FormSubmissionActionFailure $failure): bool
    {
        return $this->canAccess($user, $failure);
    }

    public function resolve(User $user, FormSubmissionActionFailure $failure): bool
    {
        return $this->canAccess($user, $failure);
    }

    public function dismiss(User $user, FormSubmissionActionFailure $failure): bool
    {
        return $this->canAccess($user, $failure);
    }

    private function canAccess(User $user, FormSubmissionActionFailure $failure): bool
    {
        $failure->loadMissing('submission');
        $submission = $failure->submission;
        if ($submission === null) {
            return false; // parent submission deleted
        }

        $orgId = (string) $submission->organisation_id;
        if ($orgId === '') {
            return false;
        }

        if ($user->hasRole('super_admin')) {
            return true;
        }

        // Tenant scope: user must be an org_admin in the failure's
        // organisation. RFC V3 — IDOR-class FK-chain enforcement.
        $organisation = $submission->organisation;
        if (! $organisation instanceof Organisation) {
            return false;
        }

        return $organisation->users()
            ->where('user_id', $user->id)
            ->wherePivot('role', 'org_admin')
            ->exists();
    }
}