# Quickstart — Verification Surfaces Unification (Spec 084)

## Local setup

- Start containers: `vendor/bin/sail up -d`
- Run tests (targeted): `vendor/bin/sail artisan test --compact`

## Manual verification (UI)

### 1) Tenant detail: start verification

1. Open a tenant record in the admin panel.
2. Use the header action: “Verify configuration”.
3. Confirm the action.

Expected:
- A queued `OperationRun` of type `provider.connection.check` is created or deduped.
- A notification includes “View run”, linking to the canonical tenantless route `/admin/operations/{run}`.

### 1b) Tenant list: row action verify

1. Open the tenant list in the admin panel.
2. On any active tenant row, choose “Verify configuration”.

Expected:
- Uses the same `provider.connection.check` start/dedupe semantics as tenant detail.
- Notification “View run” links to `/admin/operations/{run}`.

### 2) Tenant detail: embedded viewer

Expected:
- The tenant page shows the latest verification run attempt.
- If no run exists yet, it shows an empty state with “Start verification”.
- If a run is active and no report exists yet, it shows a DB-only “in progress” state.
- When completed, the viewer shows the stored report.

### 3) Blocked run report stub

Create a situation where verification is blocked (e.g., missing provider connection / consent).

Expected:
- A completed blocked `OperationRun` exists.
- The embedded viewer (and the operations run viewer) renders a stub report (no “report unavailable” state for completed blocked runs).

### 4) Onboarding: verify access

1. Go to managed tenant onboarding.
2. In the “Verify access” step, click “Start verification”.

Expected:
- Same semantics: run started/deduped/busy and “View run” links to `/admin/operations/{run}`.

## Authorization checks

Expected:
- Missing workspace membership or tenant entitlement: 404 (deny-as-not-found) for tenant routes and canonical run viewer of tenant-associated runs.
- Member without capability: action visible-but-disabled with helper text; server enforces 403 if invoked.
