TenantAtlas/specs/085-tenant-operate-hub/quickstart.md

Quickstart: Tenant Operate Hub / Tenant Overview IA

Date: 2026-02-09
Branch: 085-tenant-operate-hub

Local setup

• Start containers: vendor/bin/sail up -d
• Install deps (if needed): vendor/bin/sail composer install

Manual verification steps (happy path)

1. Sign in.
2. Select a workspace (via the context bar).
3. Enter a tenant context (e.g., go to /admin/t/{tenant} via the tenant panel).
4. In the tenant panel sidebar, open the Monitoring group and click:
   • Runs → lands on /admin/operations
5. Verify /admin/operations shows:
   • Header scope: Scope: Tenant — <tenant name>
   • CTAs: Back to <tenant name> and Show all tenants
   • The table default scope is tenant-filtered to the active tenant.
6. Click Show all tenants.
7. Verify you stay on /admin/operations and scope becomes Scope: Workspace — all tenants.
8. Open an operation run detail at /admin/operations/{run}.
9. Verify the header shows:
   • ← Back to <tenant name>
   • secondary Show all operations → /admin/operations
10. Click ← Back to <tenant name> and verify it lands on the tenant dashboard (/admin/t/{tenant}).

Negative verification (security)

• With tenant context active, revoke tenant entitlement for the test user.
• Reload /admin/operations.
• Verify scope is workspace-wide and no tenant name / “Back to tenant” affordance appears.
• Request the tenant dashboard URL directly (/admin/t/{tenant}) and verify deny-as-not-found.

Test commands (to be added in Phase 2)

• Targeted suite: vendor/bin/sail artisan test --compact --filter=OperationsIndexScopeTest