TenantAtlas/tests/Unit/Support/Tenants/TenantLifecyclePresentationTest.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

65 lines
2.8 KiB
PHP

<?php
declare(strict_types=1);
use App\Models\Tenant;
use App\Support\Tenants\ReferencedTenantLifecyclePresentation;
use App\Support\Tenants\TenantLifecycle;
use App\Support\Tenants\TenantLifecyclePresentation;
use Illuminate\Foundation\Testing\RefreshDatabase;
uses(RefreshDatabase::class);
it('maps every canonical lifecycle value to a canonical presentation contract', function (string $value, string $label, string $color): void {
$presentation = TenantLifecyclePresentation::fromValue($value);
expect($presentation->value)->toBe($value)
->and($presentation->label)->toBe($label)
->and($presentation->badge()->color)->toBe($color)
->and($presentation->isInvalidFallback)->toBeFalse()
->and($presentation->lifecycle?->value)->toBe($value);
})->with([
'draft' => ['draft', 'Draft', 'gray'],
'onboarding' => ['onboarding', 'Onboarding', 'warning'],
'active' => ['active', 'Active', 'success'],
'archived' => ['archived', 'Archived', 'gray'],
]);
it('builds lifecycle presentation from tenant soft-delete state', function (): void {
$tenant = Tenant::factory()->archived()->create();
$presentation = TenantLifecyclePresentation::fromTenant($tenant);
expect($presentation->lifecycle)->toBe(TenantLifecycle::Archived)
->and($presentation->label)->toBe('Archived')
->and($presentation->longDescription)->toContain('inspection and audit history');
});
it('uses explicit invalid fallback for non-canonical lifecycle data', function (): void {
$presentation = TenantLifecyclePresentation::fromValue('pending');
expect($presentation->isInvalidFallback)->toBeTrue()
->and($presentation->label)->toBe('Invalid lifecycle')
->and($presentation->badge()->color)->toBe('danger')
->and($presentation->value)->toBe('pending');
});
it('marks invalid referenced tenant lifecycle as unavailable for selector context', function (): void {
$presentation = ReferencedTenantLifecyclePresentation::forInvalid('operation_run', normalizedValue: 'inactive');
expect($presentation->selectorAvailabilityMessage())->toBe('This tenant has an invalid lifecycle value and may not appear in the tenant selector.')
->and($presentation->contextNote)->toBe('Some tenant follow-up actions may be unavailable from this canonical workspace view.');
});
it('describes non-selectable referenced tenant lifecycle using canonical wording', function (): void {
$tenant = Tenant::factory()->create([
'status' => Tenant::STATUS_ONBOARDING,
'name' => 'Onboarding Tenant',
]);
$presentation = ReferencedTenantLifecyclePresentation::forOperationRun($tenant);
expect($presentation->selectorAvailabilityMessage())->toBe('This tenant is currently onboarding and may not appear in the tenant selector.')
->and($presentation->presentation->label)->toBe('Onboarding');
});