## Summary - move the Laravel application into `apps/platform` and keep the repository root for orchestration, docs, and tooling - update the local command model, Sail/Docker wiring, runtime paths, and ignore rules around the new platform location - add relocation quickstart/contracts plus focused smoke coverage for bootstrap, command model, routes, and runtime behavior ## Validation - `cd apps/platform && ./vendor/bin/sail artisan test --compact tests/Feature/PlatformRelocation` - integrated browser smoke validated `/up`, `/`, `/admin`, `/admin/choose-workspace`, and tenant route semantics for `200`, `403`, and `404` ## Remaining Rollout Checks - validate Dokploy build context and working-directory assumptions against the new `apps/platform` layout - confirm web, queue, and scheduler processes all start from the expected working directory in staging/production - verify no legacy volume mounts or asset-publish paths still point at the old root-level `public/` or `storage/` locations Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #213
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;
|
|
}
|
|
}
|