TenantAtlas/apps/platform/app/Support/Tenants/ReferencedTenantLifecyclePresentation.php
ahmido ce0615a9c1 Spec 182: relocate Laravel platform to apps/platform (#213)
## 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
2026-04-08 08:40:47 +00:00

70 lines
2.3 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\Tenants;
use App\Models\Tenant;
final readonly class ReferencedTenantLifecyclePresentation
{
public function __construct(
public string $viewerContext,
public ?int $tenantId,
public ?string $tenantName,
public TenantLifecyclePresentation $presentation,
public ?string $contextNote,
) {}
public static function forOperationRun(Tenant $tenant): self
{
return self::fromTenant($tenant, 'operation_run');
}
public static function fromTenant(Tenant $tenant, string $viewerContext): self
{
$presentation = TenantLifecyclePresentation::fromTenant($tenant);
return new self(
viewerContext: $viewerContext,
tenantId: (int) $tenant->getKey(),
tenantName: $tenant->name,
presentation: $presentation,
contextNote: self::contextNoteFor($presentation),
);
}
public static function forInvalid(string $viewerContext, ?Tenant $tenant = null, ?string $normalizedValue = null): self
{
return new self(
viewerContext: $viewerContext,
tenantId: $tenant instanceof Tenant ? (int) $tenant->getKey() : null,
tenantName: $tenant?->name,
presentation: TenantLifecyclePresentation::invalid($normalizedValue),
contextNote: 'Some tenant follow-up actions may be unavailable from this canonical workspace view.',
);
}
public function selectorAvailabilityMessage(): ?string
{
if ($this->presentation->isInvalidFallback) {
return 'This tenant has an invalid lifecycle value and may not appear in the tenant selector.';
}
if (! $this->presentation->isSelectableAsContext()) {
return 'This tenant is currently '.$this->presentation->lowercaseLabel().' and may not appear in the tenant selector.';
}
return null;
}
private static function contextNoteFor(TenantLifecyclePresentation $presentation): ?string
{
if ($presentation->isInvalidFallback || ! $presentation->isSelectableAsContext()) {
return 'Some tenant follow-up actions may be unavailable from this canonical workspace view.';
}
return null;
}
}