ahmido
b15d1950b4
## Summary - add a shared cross-resource navigation layer with canonical navigation context and related-context rendering - wire findings, policy versions, baseline snapshots, backup sets, and canonical operations surfaces into consistent drill-down flows - extend focused Pest coverage for canonical operations links, related navigation, and tenant-context preservation ## Testing - focused Pest coverage for spec 131 was added and the task list marks the implementation verification and Pint steps as completed ## Follow-up - manual QA checklist item `T036` in `specs/131-cross-resource-navigation/tasks.md` is still open and should be completed during review Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #160
67 lines
2.0 KiB
PHP
67 lines
2.0 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Support\Navigation;
|
|
|
|
use Illuminate\Http\Request;
|
|
|
|
final readonly class CanonicalNavigationContext
|
|
{
|
|
/**
|
|
* @param array<string, mixed> $filterPayload
|
|
*/
|
|
public function __construct(
|
|
public string $sourceSurface,
|
|
public string $canonicalRouteName,
|
|
public ?int $tenantId = null,
|
|
public ?string $backLinkLabel = null,
|
|
public ?string $backLinkUrl = null,
|
|
public array $filterPayload = [],
|
|
) {}
|
|
|
|
public static function fromRequest(Request $request): ?self
|
|
{
|
|
$payload = $request->query('nav');
|
|
|
|
if (! is_array($payload)) {
|
|
return null;
|
|
}
|
|
|
|
$sourceSurface = $payload['source_surface'] ?? null;
|
|
$canonicalRouteName = $payload['canonical_route_name'] ?? null;
|
|
|
|
if (! is_string($sourceSurface) || $sourceSurface === '' || ! is_string($canonicalRouteName) || $canonicalRouteName === '') {
|
|
return null;
|
|
}
|
|
|
|
$tenantId = $payload['tenant_id'] ?? null;
|
|
|
|
return new self(
|
|
sourceSurface: $sourceSurface,
|
|
canonicalRouteName: $canonicalRouteName,
|
|
tenantId: is_numeric($tenantId) ? (int) $tenantId : null,
|
|
backLinkLabel: is_string($payload['back_label'] ?? null) ? (string) $payload['back_label'] : null,
|
|
backLinkUrl: is_string($payload['back_url'] ?? null) ? (string) $payload['back_url'] : null,
|
|
filterPayload: [],
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @return array<string, mixed>
|
|
*/
|
|
public function toQuery(): array
|
|
{
|
|
$query = $this->filterPayload;
|
|
$query['nav'] = array_filter([
|
|
'source_surface' => $this->sourceSurface,
|
|
'canonical_route_name' => $this->canonicalRouteName,
|
|
'tenant_id' => $this->tenantId,
|
|
'back_label' => $this->backLinkLabel,
|
|
'back_url' => $this->backLinkUrl,
|
|
], static fn (mixed $value): bool => $value !== null && $value !== '');
|
|
|
|
return $query;
|
|
}
|
|
}
|