TenantAtlas/specs/077-workspace-nav-monitoring-hub/quickstart.md

Quickstart — Workspace-first Navigation & Monitoring Hub (077)

Audience: Devs and reviewers validating the feature on staging/local
Spec: specs/077-workspace-nav-monitoring-hub/spec.md

Local setup

• Start containers: ./vendor/bin/sail up -d
• Install dependencies if needed: ./vendor/bin/sail composer install and ./vendor/bin/sail npm install
• Run migrations: ./vendor/bin/sail artisan migrate

Manual validation checklist

Navigation separation

1. Open /admin and sign in.
2. In the user menu, confirm there is an explicit entry labeled "Switch workspace" that navigates to /admin/choose-workspace.
3. In the sidebar, confirm "Manage workspaces" exists only when authorized.
4. Confirm there is no navigation item labeled simply "Workspaces" that ambiguously points to both concepts.

Operations canonical + default tenant filter

1. Visit /admin/operations with no tenant context selected.
   • Expect: page loads and shows workspace-wide runs.
2. Activate tenant context (/admin/t/{tenant}), then navigate to /admin/operations.
   • Expect: default tenant filter applied, visible filter chip, chip can be cleared.
3. Visit a run deep link /admin/operations/{run} from both tenantless and tenant context.
   • Expect: same canonical page, no tenant-route dependency.

Security semantics

• Non-member accessing operations for another workspace: expect 404.
• Workspace member but missing capability for a protected action/screen: expect 403.
• Accessing /admin/workspaces for a workspace you are not a member of: expect 404.

Test execution

Run focused tests:

• US1 (nav separation): ./vendor/bin/sail artisan test --compact --filter=WorkspaceNavigationHub
• US2 (canonical ops URLs): ./vendor/bin/sail artisan test --compact --filter=OperationsCanonicalUrls
• US3 (non-leakage): ./vendor/bin/sail artisan test --compact --filter=NonLeakageWorkspaceOperations

Run a targeted suite for the feature area:

• ./vendor/bin/sail artisan test --compact tests/Feature/Workspaces tests/Feature/Monitoring tests/Feature/OpsUx

Run formatting before finalizing:

• ./vendor/bin/sail pint --dirty