TenantAtlas/apps/platform/app/Support/References/ResolvedReference.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

72 lines
2.3 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\References;
final readonly class ResolvedReference
{
/**
* @param array<string, mixed> $meta
*/
public function __construct(
public ReferenceClass $referenceClass,
public string $rawIdentifier,
public string $primaryLabel,
public ?string $secondaryLabel,
public ReferenceResolutionState $state,
public ?string $stateLabel,
public ?ReferenceLinkTarget $linkTarget,
public ReferenceTechnicalDetail $technicalDetail,
public array $meta = [],
) {}
public function isLinkable(): bool
{
return $this->linkTarget instanceof ReferenceLinkTarget && $this->state->isLinkable();
}
public function withLinkTarget(?ReferenceLinkTarget $linkTarget): self
{
return new self(
referenceClass: $this->referenceClass,
rawIdentifier: $this->rawIdentifier,
primaryLabel: $this->primaryLabel,
secondaryLabel: $this->secondaryLabel,
state: $this->state,
stateLabel: $this->stateLabel,
linkTarget: $linkTarget,
technicalDetail: $this->technicalDetail,
meta: $this->meta,
);
}
/**
* @return array{
* referenceClass: string,
* rawIdentifier: string,
* primaryLabel: string,
* secondaryLabel: ?string,
* state: string,
* stateLabel: ?string,
* linkTarget: array{targetKind: string, url: string, actionLabel: string, contextBadge: ?string}|null,
* technicalDetail: array{displayId: ?string, fullId: string, sourceHint: ?string, copyable: bool, defaultCollapsed: bool},
* meta: array<string, mixed>
* }
*/
public function toArray(): array
{
return [
'referenceClass' => $this->referenceClass->value,
'rawIdentifier' => $this->rawIdentifier,
'primaryLabel' => $this->primaryLabel,
'secondaryLabel' => $this->secondaryLabel,
'state' => $this->state->value,
'stateLabel' => $this->stateLabel,
'linkTarget' => $this->linkTarget?->toArray(),
'technicalDetail' => $this->technicalDetail->toArray(),
'meta' => $this->meta,
];
}
}