# UI-009 Provider Connections

| Field | Value |
| --- | --- |
| Route | `/admin/provider-connections` |
| Source | `ProviderConnectionResource` |
| Area / scope | Provider / integration / workspace |
| Archetype | Provider / Integration |
| Design depth | Strategic Surface |
| Repo truth | repo-verified |
| Screenshot | `../screenshots/desktop/ui-009-provider-connections.png` |
| Browser status | Reached through workspace route. |

## First Five Seconds

The surface is the main integration authority. It should make connection health, scope, credentials/consent state, and safe next action legible without exposing secrets or raw provider errors by default.

## Productization Review

- Decision-first: medium; table needs stronger next-action state.
- Evidence-first: provider health and verification can support decisions.
- Context: workspace-owned provider connection surface.
- Customer/auditor safety: internal/operator only.
- Diagnostics: raw provider details must stay hidden or support-gated.

## Information Inventory

Default content should include provider, connection type, target scope, health, permissions/consent, last verification, and next action. Diagnostic details should explain missing policy/scopes without raw secrets.

## Dangerous Actions

Credential rotation, disconnect/disable, reverify, and delete are high-impact. Target design must include authorization, confirmation, audit, and recovery guidance.

## Scores

| IA | Density | User Clarity | Sellability | Disclosure | Hierarchy | DS Fit | A11y | Responsive | Components | UX Writing | Perf |
| ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
| 3 | 4 | 3 | 4 | 3 | 3 | 4 | 3 | 3 | 4 | 3 | 4 |

## Top Issues

1. Needs stronger health/permission summary over raw integration detail.
2. Dangerous provider actions require target confirmation and audit treatment.
3. Provider-specific terminology should not leak into platform-core copy.

## Target Direction

P0 individual target mockup. This is a trust-critical setup and recovery surface.