TenantAtlas/app/Support/References/Resolvers/BaselineSnapshotReferenceResolver.php
ahmido 8ee1174c8d feat: add resolved reference presentation layer (#161)
## Summary
- add the shared resolved-reference foundation with registry, resolvers, presenters, and badge semantics
- refactor related context, assignment evidence, and policy-version assignment rendering toward label-first reference presentation
- add Spec 132 artifacts and focused Pest coverage for reference resolution, degraded states, canonical linking, and tenant-context carryover

## Verification
- `vendor/bin/sail bin pint --dirty --format agent`
- focused Pest verification was marked complete in the task artifact

## Notes
- this PR is opened from the current session branch
- `specs/132-guid-context-resolver/tasks.md` reflects in-progress completion state for the implemented tasks

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #161
2026-03-10 18:52:52 +00:00

88 lines
2.9 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\References\Resolvers;
use App\Filament\Resources\BaselineSnapshotResource;
use App\Models\BaselineSnapshot;
use App\Models\User;
use App\Models\Workspace;
use App\Services\Auth\WorkspaceCapabilityResolver;
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 BaselineSnapshotReferenceResolver extends BaseReferenceResolver
{
public function __construct(
\App\Support\References\ReferenceTypeLabelCatalog $typeLabels,
private readonly WorkspaceCapabilityResolver $workspaceCapabilityResolver,
) {
parent::__construct($typeLabels);
}
public function referenceClass(): ReferenceClass
{
return ReferenceClass::BaselineSnapshot;
}
public function resolve(ReferenceDescriptor $descriptor): ResolvedReference
{
$snapshotId = $this->linkedModelId($descriptor);
$workspaceId = $descriptor->workspaceId;
if ($snapshotId === null || $workspaceId === null || $workspaceId <= 0) {
return $this->unresolved($descriptor);
}
$snapshot = BaselineSnapshot::query()
->with('baselineProfile')
->whereKey($snapshotId)
->where('workspace_id', $workspaceId)
->first();
if (! $snapshot instanceof BaselineSnapshot) {
return $this->missing($descriptor);
}
if (! $this->canOpenWorkspaceBaselines((int) $snapshot->workspace_id)) {
return $this->inaccessible($descriptor);
}
$profileName = $snapshot->baselineProfile?->name;
return $this->resolved(
descriptor: $descriptor,
primaryLabel: is_string($profileName) && trim($profileName) !== '' ? $profileName : 'Baseline snapshot',
secondaryLabel: 'Baseline snapshot #'.$snapshot->getKey(),
linkTarget: new ReferenceLinkTarget(
targetKind: ReferenceClass::BaselineSnapshot->value,
url: BaselineSnapshotResource::getUrl('view', ['record' => $snapshot], panel: 'admin'),
actionLabel: 'View snapshot',
contextBadge: 'Workspace',
),
);
}
private function canOpenWorkspaceBaselines(int $workspaceId): bool
{
$user = auth()->user();
if (! $user instanceof User) {
return false;
}
$workspace = Workspace::query()->whereKey($workspaceId)->first();
if (! $workspace instanceof Workspace) {
return false;
}
return $this->workspaceCapabilityResolver->isMember($user, $workspace)
&& $this->workspaceCapabilityResolver->can($user, $workspace, Capabilities::WORKSPACE_BASELINES_VIEW);
}
}