TenantAtlas/app/Support/Tenants/TenantOperabilityContext.php
ahmido 417df4f9aa feat: central tenant operability policy (#177)
## Summary
- centralize tenant operability into a lane-aware, actor-aware policy boundary
- align selector eligibility, administrative discoverability, remembered context, tenant-bound routes, and canonical run viewers
- add focused Pest coverage plus Spec 148 artifacts and final polish task completion

## Validation
- `vendor/bin/sail artisan test --compact tests/Unit/Tenants/TenantOperabilityServiceTest.php tests/Unit/Tenants/TenantOperabilityOutcomeTest.php tests/Feature/Workspaces/ChooseTenantPageTest.php tests/Feature/Workspaces/SelectTenantControllerTest.php tests/Feature/TenantRBAC/ArchivedTenantRouteAccessTest.php tests/Feature/TenantRBAC/TenantRouteDenyAsNotFoundTest.php tests/Feature/Operations/TenantlessOperationRunViewerTest.php tests/Feature/OpsUx/OperateHubShellTest.php tests/Feature/Rbac/TenantLifecycleActionVisibilityTest.php tests/Feature/TenantRBAC/TenantSwitcherScopeTest.php tests/Feature/Rbac/TenantResourceAuthorizationTest.php tests/Feature/Filament/ManagedTenantsLandingLifecycleTest.php tests/Feature/Filament/TenantGlobalSearchLifecycleScopeTest.php tests/Feature/Onboarding/OnboardingDraftLifecycleTest.php tests/Feature/Onboarding/OnboardingDraftAuthorizationTest.php`
- `vendor/bin/sail bin pint --dirty --format agent`
- manual browser smoke checks on `/admin/choose-tenant`, `/admin/tenants`, `/admin/onboarding`, `/admin/onboarding/{draft}`, and `/admin/operations/{run}`

## Filament / platform notes
- Livewire v4 compliance preserved
- panel provider registration unchanged in `bootstrap/providers.php`
- Tenant resource global search remains backed by existing view/edit pages and is now separated from active-only selector eligibility
- destructive actions remain action closures with confirmation and authorization enforcement
- no asset pipeline changes and no new `filament:assets` deployment requirement

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #177
2026-03-17 11:48:55 +00:00

52 lines
1.6 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\Tenants;
use App\Models\Tenant;
use App\Models\TenantOnboardingSession;
use App\Models\User;
final readonly class TenantOperabilityContext
{
public function __construct(
public Tenant $tenant,
public ?User $actor,
public ?int $workspaceId,
public TenantInteractionLane $lane,
public ?TenantPageCategory $pageCategory = null,
public ?string $linkedRecordType = null,
public ?int $linkedRecordId = null,
public ?TenantOnboardingSession $onboardingDraft = null,
public ?string $requiredCapability = null,
public ?Tenant $selectedTenant = null,
) {}
public static function forTenant(
Tenant $tenant,
?User $actor = null,
?int $workspaceId = null,
TenantInteractionLane $lane = TenantInteractionLane::AdministrativeManagement,
?TenantPageCategory $pageCategory = null,
?TenantOnboardingSession $onboardingDraft = null,
?string $requiredCapability = null,
?Tenant $selectedTenant = null,
?string $linkedRecordType = null,
?int $linkedRecordId = null,
): self {
return new self(
tenant: $tenant,
actor: $actor,
workspaceId: $workspaceId,
lane: $lane,
pageCategory: $pageCategory,
linkedRecordType: $linkedRecordType,
linkedRecordId: $linkedRecordId,
onboardingDraft: $onboardingDraft,
requiredCapability: $requiredCapability,
selectedTenant: $selectedTenant,
);
}
}