## Summary - amend the operator UI constitution and related SpecKit templates for the new UI/UX governance rules - add Spec 168 artifacts plus the tenant governance aggregate implementation used by the tenant dashboard, banner, and baseline compare landing surfaces - normalize Filament action surfaces around clickable-row inspection, grouped secondary actions, and explicit action-surface declarations across enrolled resources and pages - fix post-suite regressions in membership cache priming, finding workflow state refresh, tenant review derived-state invalidation, and tenant-bound backup-set related navigation ## Commit Series - `docs: amend operator UI constitution` - `spec: add tenant governance aggregate contract` - `feat: add tenant governance aggregate contract` - `refactor: normalize filament action surfaces` - `fix: resolve post-suite state regressions` ## Testing - `vendor/bin/sail artisan test --compact` - Result: `3176 passed, 8 skipped (17384 assertions)` ## Notes - Livewire v4 / Filament v5 stack remains unchanged - no provider registration changes; `bootstrap/providers.php` remains the relevant location - no new global-search resources or asset-registration changes in this branch Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #199
279 lines
11 KiB
PHP
279 lines
11 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
use App\Filament\Resources\TenantResource;
|
|
use App\Filament\Resources\TenantResource\Pages\EditTenant;
|
|
use App\Filament\Resources\TenantResource\Pages\ListTenants;
|
|
use App\Filament\Resources\TenantResource\Pages\ViewTenant;
|
|
use App\Models\Tenant;
|
|
use App\Support\Ui\ActionSurface\Enums\ActionSurfaceSlot;
|
|
use App\Support\Workspaces\WorkspaceContext;
|
|
use Filament\Actions\ActionGroup;
|
|
use Filament\Facades\Filament;
|
|
use Illuminate\Foundation\Testing\RefreshDatabase;
|
|
use Livewire\Livewire;
|
|
|
|
uses(RefreshDatabase::class);
|
|
|
|
function tenantActionSurfaceSearchTitles($results): array
|
|
{
|
|
return collect($results)->map(fn ($result): string => (string) $result->title)->values()->all();
|
|
}
|
|
|
|
it('keeps onboarding lifecycle actions consistent across list, view, and edit surfaces', function (): void {
|
|
$tenant = Tenant::factory()->onboarding()->create();
|
|
[$user, $tenant] = createUserWithTenant(tenant: $tenant, role: 'owner', ensureDefaultMicrosoftProviderConnection: false);
|
|
|
|
createOnboardingDraft([
|
|
'workspace' => $tenant->workspace,
|
|
'tenant' => $tenant,
|
|
'started_by' => $user,
|
|
'updated_by' => $user,
|
|
'state' => [
|
|
'entra_tenant_id' => (string) $tenant->tenant_id,
|
|
'tenant_name' => (string) $tenant->name,
|
|
],
|
|
]);
|
|
|
|
session()->put(WorkspaceContext::SESSION_KEY, (int) $tenant->workspace_id);
|
|
|
|
Livewire::actingAs($user)
|
|
->test(ListTenants::class)
|
|
->assertTableActionVisible('related_onboarding', $tenant)
|
|
->assertTableActionHidden('archive', $tenant)
|
|
->assertTableActionHidden('restore', $tenant);
|
|
|
|
Filament::setTenant(null, true);
|
|
|
|
Livewire::actingAs($user)
|
|
->test(ViewTenant::class, ['record' => $tenant->getRouteKey()])
|
|
->assertActionVisible('related_onboarding')
|
|
->assertActionHidden('archive')
|
|
->assertActionHidden('restore');
|
|
|
|
Livewire::actingAs($user)
|
|
->test(EditTenant::class, ['record' => $tenant->getRouteKey()])
|
|
->assertActionVisible('related_onboarding')
|
|
->assertActionHidden('archive')
|
|
->assertActionHidden('restore');
|
|
});
|
|
|
|
it('keeps active lifecycle actions consistent across list, view, and edit surfaces', function (): void {
|
|
$tenant = Tenant::factory()->active()->create();
|
|
[$user, $tenant] = createUserWithTenant(tenant: $tenant, role: 'owner', ensureDefaultMicrosoftProviderConnection: false);
|
|
|
|
session()->put(WorkspaceContext::SESSION_KEY, (int) $tenant->workspace_id);
|
|
|
|
Livewire::actingAs($user)
|
|
->test(ListTenants::class)
|
|
->assertTableActionVisible('archive', $tenant)
|
|
->assertTableActionHidden('restore', $tenant)
|
|
->assertTableActionHidden('related_onboarding', $tenant);
|
|
|
|
Filament::setTenant(null, true);
|
|
|
|
Livewire::actingAs($user)
|
|
->test(ViewTenant::class, ['record' => $tenant->getRouteKey()])
|
|
->assertActionVisible('archive')
|
|
->assertActionHidden('restore')
|
|
->assertActionHidden('related_onboarding');
|
|
|
|
Livewire::actingAs($user)
|
|
->test(EditTenant::class, ['record' => $tenant->getRouteKey()])
|
|
->assertActionVisible('archive')
|
|
->assertActionHidden('restore')
|
|
->assertActionHidden('related_onboarding');
|
|
});
|
|
|
|
it('keeps draft lifecycle actions consistent across list, view, and edit surfaces', function (): void {
|
|
$tenant = Tenant::factory()->draft()->create();
|
|
[$user, $tenant] = createUserWithTenant(tenant: $tenant, role: 'owner', ensureDefaultMicrosoftProviderConnection: false);
|
|
|
|
createOnboardingDraft([
|
|
'workspace' => $tenant->workspace,
|
|
'tenant' => $tenant,
|
|
'started_by' => $user,
|
|
'updated_by' => $user,
|
|
'state' => [
|
|
'entra_tenant_id' => (string) $tenant->tenant_id,
|
|
'tenant_name' => (string) $tenant->name,
|
|
],
|
|
]);
|
|
|
|
session()->put(WorkspaceContext::SESSION_KEY, (int) $tenant->workspace_id);
|
|
|
|
Livewire::actingAs($user)
|
|
->test(ListTenants::class)
|
|
->assertTableActionVisible('related_onboarding', $tenant)
|
|
->assertTableActionHidden('archive', $tenant)
|
|
->assertTableActionHidden('restore', $tenant);
|
|
|
|
Filament::setTenant(null, true);
|
|
|
|
Livewire::actingAs($user)
|
|
->test(ViewTenant::class, ['record' => $tenant->getRouteKey()])
|
|
->assertActionVisible('related_onboarding')
|
|
->assertActionHidden('archive')
|
|
->assertActionHidden('restore');
|
|
|
|
Livewire::actingAs($user)
|
|
->test(EditTenant::class, ['record' => $tenant->getRouteKey()])
|
|
->assertActionVisible('related_onboarding')
|
|
->assertActionHidden('archive')
|
|
->assertActionHidden('restore');
|
|
});
|
|
|
|
it('keeps archived lifecycle actions consistent across list, view, and edit surfaces', function (): void {
|
|
$tenant = Tenant::factory()->archived()->create();
|
|
[$user, $tenant] = createUserWithTenant(tenant: $tenant, role: 'owner', ensureDefaultMicrosoftProviderConnection: false);
|
|
|
|
session()->put(WorkspaceContext::SESSION_KEY, (int) $tenant->workspace_id);
|
|
|
|
Livewire::actingAs($user)
|
|
->test(ListTenants::class)
|
|
->assertTableActionVisible('restore', $tenant)
|
|
->assertTableActionHidden('archive', $tenant);
|
|
|
|
Filament::setTenant(null, true);
|
|
|
|
Livewire::actingAs($user)
|
|
->test(ViewTenant::class, ['record' => $tenant->getRouteKey()])
|
|
->assertActionVisible('restore')
|
|
->assertActionHidden('archive');
|
|
|
|
Livewire::actingAs($user)
|
|
->test(EditTenant::class, ['record' => $tenant->getRouteKey()])
|
|
->assertActionVisible('restore')
|
|
->assertActionHidden('archive');
|
|
});
|
|
|
|
it('keeps tenant global search aligned with administrative discoverability across lifecycles', function (): void {
|
|
$active = Tenant::factory()->active()->create(['name' => 'Surface Search Active']);
|
|
[$user, $active] = createUserWithTenant(tenant: $active, role: 'owner', ensureDefaultMicrosoftProviderConnection: false);
|
|
|
|
$draft = Tenant::factory()->draft()->create([
|
|
'workspace_id' => (int) $active->workspace_id,
|
|
'name' => 'Surface Search Draft',
|
|
]);
|
|
$onboarding = Tenant::factory()->onboarding()->create([
|
|
'workspace_id' => (int) $active->workspace_id,
|
|
'name' => 'Surface Search Onboarding',
|
|
]);
|
|
$archived = Tenant::factory()->archived()->create([
|
|
'workspace_id' => (int) $active->workspace_id,
|
|
'name' => 'Surface Search Archived',
|
|
]);
|
|
|
|
createUserWithTenant(tenant: $draft, user: $user, role: 'owner', ensureDefaultMicrosoftProviderConnection: false);
|
|
createUserWithTenant(tenant: $onboarding, user: $user, role: 'owner', ensureDefaultMicrosoftProviderConnection: false);
|
|
createUserWithTenant(tenant: $archived, user: $user, role: 'owner', ensureDefaultMicrosoftProviderConnection: false);
|
|
|
|
$this->actingAs($user);
|
|
|
|
Filament::setCurrentPanel('admin');
|
|
Filament::setTenant(null, true);
|
|
Filament::bootCurrentPanel();
|
|
|
|
session()->put(WorkspaceContext::SESSION_KEY, (int) $active->workspace_id);
|
|
|
|
expect(tenantActionSurfaceSearchTitles(TenantResource::getGlobalSearchResults('Surface Search')))
|
|
->toEqualCanonicalizing([
|
|
'Surface Search Active',
|
|
'Surface Search Draft',
|
|
'Surface Search Onboarding',
|
|
'Surface Search Archived',
|
|
]);
|
|
});
|
|
|
|
it('keeps list-row lifecycle actions independent from the selected header tenant context', function (): void {
|
|
$selectedTenant = Tenant::factory()->active()->create(['name' => 'Selected Header Tenant']);
|
|
[$user, $selectedTenant] = createUserWithTenant(tenant: $selectedTenant, role: 'owner', ensureDefaultMicrosoftProviderConnection: false);
|
|
|
|
$onboardingTenant = Tenant::factory()->onboarding()->create([
|
|
'workspace_id' => (int) $selectedTenant->workspace_id,
|
|
'name' => 'Independent Onboarding Tenant',
|
|
]);
|
|
$archivedTenant = Tenant::factory()->archived()->create([
|
|
'workspace_id' => (int) $selectedTenant->workspace_id,
|
|
'name' => 'Independent Archived Tenant',
|
|
]);
|
|
|
|
createUserWithTenant(tenant: $onboardingTenant, user: $user, role: 'owner', workspaceRole: 'owner', ensureDefaultMicrosoftProviderConnection: false);
|
|
createUserWithTenant(tenant: $archivedTenant, user: $user, role: 'owner', workspaceRole: 'owner', ensureDefaultMicrosoftProviderConnection: false);
|
|
|
|
createOnboardingDraft([
|
|
'workspace' => $onboardingTenant->workspace,
|
|
'tenant' => $onboardingTenant,
|
|
'started_by' => $user,
|
|
'updated_by' => $user,
|
|
'state' => [
|
|
'entra_tenant_id' => (string) $onboardingTenant->tenant_id,
|
|
'tenant_name' => (string) $onboardingTenant->name,
|
|
],
|
|
]);
|
|
|
|
session()->put(WorkspaceContext::SESSION_KEY, (int) $selectedTenant->workspace_id);
|
|
Filament::setTenant($selectedTenant, true);
|
|
|
|
Livewire::actingAs($user)
|
|
->test(ListTenants::class)
|
|
->assertTableActionVisible('archive', $selectedTenant)
|
|
->assertTableActionVisible('related_onboarding', $onboardingTenant)
|
|
->assertTableActionHidden('archive', $onboardingTenant)
|
|
->assertTableActionVisible('restore', $archivedTenant)
|
|
->assertTableActionHidden('archive', $archivedTenant);
|
|
});
|
|
|
|
it('documents the tenant row-click and More-menu contract for lifecycle actions', function (): void {
|
|
$tenant = Tenant::factory()->active()->create();
|
|
[$user, $tenant] = createUserWithTenant(tenant: $tenant, role: 'owner', ensureDefaultMicrosoftProviderConnection: false);
|
|
|
|
createOnboardingDraft([
|
|
'workspace' => $tenant->workspace,
|
|
'tenant' => $tenant,
|
|
'started_by' => $user,
|
|
'updated_by' => $user,
|
|
'status' => 'completed',
|
|
'state' => [
|
|
'entra_tenant_id' => (string) $tenant->tenant_id,
|
|
'tenant_name' => (string) $tenant->name,
|
|
],
|
|
]);
|
|
|
|
$declaration = TenantResource::actionSurfaceDeclaration();
|
|
|
|
expect($declaration->listRowPrimaryActionLimit())->toBe(1)
|
|
->and((string) ($declaration->slot(ActionSurfaceSlot::ListRowMoreMenu)?->details ?? ''))->toContain('one');
|
|
|
|
session()->put(WorkspaceContext::SESSION_KEY, (int) $tenant->workspace_id);
|
|
Filament::setTenant(null, true);
|
|
|
|
$component = Livewire::actingAs($user)
|
|
->test(ListTenants::class)
|
|
->assertTableActionVisible('archive', $tenant)
|
|
->assertTableActionHidden('related_onboarding', $tenant)
|
|
->assertTableActionVisible('related_onboarding_overflow', $tenant)
|
|
->assertTableActionHidden('restore', $tenant);
|
|
|
|
$table = $component->instance()->getTable();
|
|
$rowActions = $table->getActions();
|
|
$primaryRowActionNames = collect($rowActions)
|
|
->reject(static fn ($action): bool => $action instanceof ActionGroup)
|
|
->map(static fn ($action): ?string => $action->getName())
|
|
->filter()
|
|
->values()
|
|
->all();
|
|
$moreGroup = collect($rowActions)->first(static fn ($action): bool => $action instanceof ActionGroup);
|
|
$moreActionNames = collect($moreGroup?->getActions() ?? [])
|
|
->map(static fn ($action): ?string => $action->getName())
|
|
->filter()
|
|
->values()
|
|
->all();
|
|
|
|
expect($primaryRowActionNames)->not->toContain('view')
|
|
->and($table->getRecordUrl($tenant))->toBe(TenantResource::getUrl('view', ['record' => $tenant]))
|
|
->and($moreActionNames)->toContain('archive')
|
|
->and($moreActionNames)->toContain('related_onboarding_overflow');
|
|
});
|