# 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`
