## 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
70 lines
2.3 KiB
PHP
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;
|
|
}
|
|
}
|