TenantAtlas/specs/297-managed-environment-canonical-route-cutover/quickstart.md
Ahmed Darrazi 185f2795c6
Some checks failed
PR Fast Feedback / fast-feedback (pull_request) Failing after 1m45s
feat: retire legacy tenant route surfaces
2026-05-13 01:31:46 +02:00

96 lines
3.0 KiB
Markdown

# Quickstart: Managed Environment Canonical Route Cutover & Legacy Tenant Surface Retirement
Use this as the implementation command checklist. Refresh the baseline before editing code.
## 1. Safety
```bash
git status --short --branch
git diff --stat
git log -1 --oneline
```
## 2. Baseline Audit
```bash
cd apps/platform
./vendor/bin/sail artisan route:list | rg "admin/t|admin/tenants|provider-connections|required-permissions|workspaces/.*/environments|operations"
rg "TenantPanelProvider|panel:\s*'tenant'|panel:\s*\"tenant\"|/admin/t/|/admin/tenants|TenantResource::getUrl|TenantDashboard::getUrl|TenantRequiredPermissions::getUrl|setTenantPanelContext|admin\.operations" . --glob '!vendor' --glob '!node_modules'
```
Update:
```text
specs/297-managed-environment-canonical-route-cutover/legacy-surface-audit.md
```
## 3. Focused Proof
```bash
cd apps/platform
./vendor/bin/sail artisan test --compact \
tests/Feature/Guards/NoLegacyTenantPanelRuntimeTest.php \
tests/Feature/Guards/NoActiveTenantResourceRoutesTest.php \
tests/Feature/Guards/ManagedEnvironmentCanonicalRouteContractTest.php \
tests/Feature/Workspaces/WorkspaceIntendedUrlLegacyRejectionTest.php \
tests/Feature/ProviderConnections/LegacyRedirectTest.php \
tests/Feature/ManagedEnvironment/LegacyTenantCoreGuardTest.php \
tests/Feature/Spec080WorkspaceManagedTenantAdminMigrationTest.php \
tests/Feature/Filament/ManagedEnvironmentAccessScopeManagementTest.php \
tests/Feature/Rbac/ProviderConnectionWorkspaceFirstPolicyTest.php
```
## 4. Existing Guard Pack
```bash
cd apps/platform
./vendor/bin/sail artisan test --compact \
tests/Feature/Guards/Spec288NoLegacyRouteAndHelperGuardTest.php \
tests/Feature/Guards/Spec288ProviderCoreAndRoleAuthorityGuardTest.php \
tests/Feature/Guards/AdminWorkspaceRoutesGuardTest.php \
tests/Feature/Guards/ProviderBoundaryPlatformCoreGuardTest.php \
tests/Feature/Guards/BrowserLaneIsolationTest.php \
tests/Feature/Guards/CiLaneFailureClassificationContractTest.php \
tests/Feature/Guards/CiHeavyBrowserWorkflowContractTest.php
```
## 5. Broad Focused Validation
```bash
cd apps/platform
./vendor/bin/sail artisan test --compact tests/Feature/Guards
./vendor/bin/sail artisan test --compact tests/Feature/Workspaces
./vendor/bin/sail artisan test --compact tests/Feature/ProviderConnections
./vendor/bin/sail artisan test --compact tests/Feature/RequiredPermissions
./vendor/bin/sail artisan test --compact tests/Feature/Filament
./vendor/bin/sail bin pint --dirty --format agent
git diff --check
```
## 6. Browser Smoke
Run only if visible navigation/browser flows are touched:
```bash
cd apps/platform
./vendor/bin/sail artisan test --compact \
tests/Browser/Spec281ProviderConnectionScopeSmokeTest.php \
tests/Browser/Spec285WorkspaceRbacEnvironmentAccessSmokeTest.php
```
## 7. Final Decision
Close with exactly one:
```text
Managed Environment canonical cutover complete; legacy tenant surfaces retired.
```
```text
Blocked by true runtime dependency on legacy tenant surface.
```
```text
Incomplete; active legacy tenant routes remain.
```