TenantAtlas/app/Support/Tenants/ReferencedTenantLifecyclePresentation.php
ahmido 6ca496233b feat: centralize tenant lifecycle presentation (#175)
## Summary
- add a shared tenant lifecycle presentation contract and referenced-tenant adapter for canonical lifecycle labels and helper copy
- align tenant, chooser, onboarding, archived-banner, and tenantless operation viewer surfaces with the shared lifecycle vocabulary
- add Spec 146 design artifacts, audit notes, and regression coverage for lifecycle presentation across Filament and onboarding surfaces

## Validation
- `vendor/bin/sail bin pint --dirty --format agent`
- `vendor/bin/sail artisan test --compact tests/Feature/Badges/TenantStatusBadgeTest.php tests/Unit/Badges/TenantBadgesTest.php tests/Unit/Tenants/TenantLifecycleTest.php tests/Unit/Support/Tenants/TenantLifecyclePresentationTest.php tests/Feature/Filament/TenantLifecyclePresentationAcrossTenantSurfacesTest.php tests/Feature/Filament/ReferencedTenantLifecyclePresentationTest.php tests/Feature/Filament/TenantLifecycleStatusDomainSeparationTest.php tests/Feature/Filament/TenantViewHeaderUiEnforcementTest.php tests/Feature/Onboarding/TenantLifecyclePresentationCopyTest.php tests/Feature/Onboarding/OnboardingDraftAuthorizationTest.php tests/Feature/Onboarding/OnboardingDraftLifecycleTest.php`

## Notes
- Livewire v4.0+ compliance preserved; this change is presentation-only on existing Filament v5 surfaces.
- Panel provider registration remains unchanged in `bootstrap/providers.php`.
- No global-search behavior changed; no resource was newly made globally searchable or disabled.
- No destructive actions were added or changed.
- No asset registration strategy changed; existing deploy flow for `php artisan filament:assets` remains unchanged.

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #175
2026-03-16 18:18:53 +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;
}
}