ahmido
eca19819d1
## Summary - add a workspace-scoped baseline compare matrix page under baseline profiles - derive matrix tenant summaries, subject rows, cell states, freshness, and trust from existing snapshots, compare runs, and findings - add confirmation-gated `Compare assigned tenants` actions on the baseline detail and matrix surfaces without introducing a workspace umbrella run - preserve matrix navigation context into tenant compare and finding drilldowns and add centralized matrix badge semantics - include spec, plan, data model, contracts, quickstart, tasks, and focused feature/browser coverage for Spec 190 ## Verification - `cd apps/platform && ./vendor/bin/sail artisan test --compact tests/Unit/Badges/BaselineCompareMatrixBadgesTest.php tests/Feature/Baselines/BaselineCompareMatrixBuilderTest.php tests/Feature/Baselines/BaselineCompareMatrixCompareAllActionTest.php tests/Feature/Baselines/BaselineComparePerformanceGuardTest.php tests/Feature/Filament/BaselineCompareMatrixPageTest.php tests/Feature/Filament/BaselineProfileCompareStartSurfaceTest.php tests/Feature/Rbac/BaselineCompareMatrixAuthorizationTest.php tests/Feature/Guards/ActionSurfaceContractTest.php tests/Feature/Guards/NoAdHocStatusBadgesTest.php tests/Feature/Guards/NoDiagnosticWarningBadgesTest.php` - `cd apps/platform && ./vendor/bin/sail bin pint --dirty --format agent` - completed an integrated-browser smoke flow locally for matrix render, differ filter, finding drilldown round-trip, and `Compare assigned tenants` confirmation/action Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #221
97 lines
3.1 KiB
PHP
97 lines
3.1 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Support\Navigation;
|
|
|
|
use App\Filament\Pages\BaselineCompareMatrix;
|
|
use App\Models\BaselineProfile;
|
|
use App\Models\Tenant;
|
|
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;
|
|
}
|
|
|
|
/**
|
|
* @param array<string, mixed> $filters
|
|
*/
|
|
public static function forBaselineCompareMatrix(
|
|
BaselineProfile $profile,
|
|
array $filters = [],
|
|
?Tenant $tenant = null,
|
|
?string $subjectKey = null,
|
|
): self {
|
|
$parameters = array_filter([
|
|
'record' => $profile,
|
|
...$filters,
|
|
], static fn (mixed $value): bool => $value !== null && $value !== [] && $value !== '');
|
|
|
|
return new self(
|
|
sourceSurface: 'baseline_compare_matrix',
|
|
canonicalRouteName: BaselineCompareMatrix::getRouteName(),
|
|
tenantId: $tenant?->getKey(),
|
|
backLinkLabel: 'Back to compare matrix',
|
|
backLinkUrl: BaselineCompareMatrix::getUrl($parameters, panel: 'admin'),
|
|
filterPayload: array_filter([
|
|
'baseline_profile_id' => (int) $profile->getKey(),
|
|
'subject_key' => $subjectKey,
|
|
], static fn (mixed $value): bool => $value !== null && $value !== ''),
|
|
);
|
|
}
|
|
}
|