TenantAtlas/apps/platform/app/Support/References/Resolvers/PolicyReferenceResolver.php
ahmido feeaadd5ad feat: add provider-missing policy visibility and restore continuity (#316)
## Summary
- separate provider-missing policy presence from local ignore semantics by introducing `missing_from_provider_at`
- update policy, backup, and restore surfaces so current-state capture stays honest while historical restore continuity remains available
- add focused sync, Filament, backup, restore, localization, and badge coverage for the new provider-missing behavior

## Scope
- policy sync and model truth
- policy resource visibility, badges, labels, and action gating
- backup/export eligibility and restore continuity messaging
- spec 261 artifacts and focused tests

## Validation
- feature-specific Pest coverage is included in the branch
- validation was not re-run as part of this commit/push/PR handoff

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #316
2026-05-01 20:18:27 +00:00

78 lines
2.6 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\References\Resolvers;
use App\Filament\Resources\PolicyResource;
use App\Models\Policy;
use App\Models\Tenant;
use App\Models\User;
use App\Services\Auth\CapabilityResolver;
use App\Support\Auth\Capabilities;
use App\Support\References\ReferenceClass;
use App\Support\References\ReferenceDescriptor;
use App\Support\References\ReferenceLinkTarget;
use App\Support\References\ResolvedReference;
final class PolicyReferenceResolver extends BaseReferenceResolver
{
public function __construct(
\App\Support\References\ReferenceTypeLabelCatalog $typeLabels,
private readonly CapabilityResolver $capabilityResolver,
) {
parent::__construct($typeLabels);
}
public function referenceClass(): ReferenceClass
{
return ReferenceClass::Policy;
}
public function resolve(ReferenceDescriptor $descriptor): ResolvedReference
{
$policyId = $this->linkedModelId($descriptor);
$tenantId = $descriptor->tenantId;
if ($policyId === null || $tenantId === null || $tenantId <= 0) {
return $this->unresolved($descriptor);
}
$policy = Policy::query()
->with('tenant')
->whereKey($policyId)
->where('tenant_id', $tenantId)
->first();
if (! $policy instanceof Policy) {
return $this->missing($descriptor);
}
if (! $this->canOpenTenantRecord($policy->tenant, Capabilities::TENANT_VIEW)) {
return $this->inaccessible($descriptor);
}
return $this->resolved(
descriptor: $descriptor,
primaryLabel: (string) ($policy->display_name ?: __('localization.policy.versions.related_entry_policy')),
secondaryLabel: __('localization.policy.versions.reference_policy_number', ['id' => $policy->getKey()]),
linkTarget: new ReferenceLinkTarget(
targetKind: ReferenceClass::Policy->value,
url: PolicyResource::getUrl('view', ['record' => $policy], tenant: $policy->tenant),
actionLabel: __('localization.policy.versions.related_action_view_policy'),
contextBadge: 'Tenant',
),
);
}
private function canOpenTenantRecord(?Tenant $tenant, string $capability): bool
{
$user = auth()->user();
return $tenant instanceof Tenant
&& $user instanceof User
&& $this->capabilityResolver->isMember($user, $tenant)
&& $this->capabilityResolver->can($user, $tenant, $capability);
}
}