TenantAtlas/apps/platform/app/Support/Navigation/NavigationScope.php
ahmido e0c2cdb1f4 feat: enforce workspace and environment scope contract (Spec 338) (#409)
## Summary
- enforce the canonical workspace/environment scope contract for workspace hubs and environment-owned surfaces
- replace first-party Operations deep links that leaked Filament `tableFilters[...]` internals with stable product-level query behavior
- add the sidebar scope indicator and split environment-page navigation into explicit `Workspace-wide` and `Workspace admin` groups
- remove redundant tenantless `All environments` scope badges from workspace-wide pages while preserving explicit environment filter affordances
- include the Spec 338 artifacts, guard tests, and browser smoke coverage for the new contract

## Validation
- `cd apps/platform && ./vendor/bin/sail artisan test --compact tests/Feature/Navigation/Spec338EnvironmentSidebarSeparationTest.php tests/Feature/Navigation/Spec338OperationRunLinksQueryContractTest.php tests/Feature/Navigation/Spec338SidebarScopeIndicatorTest.php tests/Feature/Filament/PanelNavigationSegregationTest.php`
- `cd apps/platform && ./vendor/bin/sail php vendor/bin/pest tests/Browser/Spec338ScopeContractSmokeTest.php --compact`

## Notes
- Livewire v4 compliance unchanged
- Filament provider registration remains in `bootstrap/providers.php`
- no destructive action behavior changed
- no migrations, env var changes, or new Filament asset registration

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #409
2026-05-31 01:36:08 +00:00

54 lines
1.4 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\Navigation;
use Illuminate\Http\Request;
final class NavigationScope
{
public static function isWorkspaceSurface(?Request $request = null): bool
{
return ! self::isEnvironmentSurface($request);
}
public static function isEnvironmentSurface(?Request $request = null): bool
{
return in_array(self::pageCategory($request), [
AdminSurfaceScope::EnvironmentBound,
], true);
}
public static function shouldRegisterEnvironmentNavigation(?Request $request = null): bool
{
return self::isEnvironmentSurface($request);
}
public static function pageCategory(?Request $request = null): AdminSurfaceScope
{
return AdminSurfaceScope::fromPath(self::effectivePath($request));
}
private static function effectivePath(?Request $request = null): string
{
$request ??= request();
$path = '/'.ltrim((string) $request->path(), '/');
if (! self::isLivewireUpdatePath($path)) {
return $path;
}
$refererPath = parse_url((string) $request->headers->get('referer', ''), PHP_URL_PATH);
return is_string($refererPath) && $refererPath !== ''
? '/'.ltrim($refererPath, '/')
: $path;
}
private static function isLivewireUpdatePath(string $path): bool
{
return preg_match('#^/livewire(?:-[^/]+)?/update$#', $path) === 1;
}
}