# UX-010 Certification: UI Interaction, API Route Test, and Telemetry Parity

Date: 2026-02-22  
Checklist Item: `UX-010`  
Ticket: `ISIS-0235`

## Journey Scope

User state: authenticated Isis web user executing feature interactions across
jobs, workflows, outputs, runpod, providers, and models  
Journey: user performs UI interactions -> UI telemetry event emits ->
corresponding backend API route has route-level test coverage  
Coverage target: interaction telemetry exists for UI actions and route suites
cover UI-facing API surfaces

## Evidence Matrix

| Requirement                                             | Evidence                                                                                                                                                                                                                                                                                                   | Status |
| ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| Every interactive UI action emits telemetry             | `apps/isis/web/src/telemetry/UiInteractionTelemetry.tsx` introduces `UiInteractionTelemetryBoundary` that captures click/submit interactions and emits `isis:web:ui-interaction` events with route and target metadata.                                                                                    | Pass   |
| Telemetry boundary is active for full app surface       | `apps/isis/web/src/App.tsx` mounts `UiInteractionTelemetryBoundary` at app root, making telemetry active for authenticated and unauthenticated routes (including login and protected pages).                                                                                                               | Pass   |
| Telemetry behavior is test-covered                      | `apps/isis/web/src/telemetry/UiInteractionTelemetry.spec.tsx` validates click and submit telemetry payload emission; `apps/isis/web/src/App.e2e.spec.tsx` validates telemetry for real authenticated action (`Submit Job`) at `/jobs`.                                                                     | Pass   |
| Model-management UI interactions now have route tests   | `apps/isis/generation-api/src/routes/models.spec.ts` adds route parity tests for register/list/audit/get/update/delete/versions/upload-url/upload-complete/download/by-name-version flows used by `ModelsPage` and model audit views.                                                                      | Pass   |
| Job/workflow/output UI interactions have route coverage | Existing route test suites remain green: `apps/isis/generation-api/src/routes/jobs.spec.ts`, `apps/isis/workflow-registry/src/routes/workflows.auth.spec.ts`, and `apps/isis/output-registry/src/routes/outputs.auth.spec.ts`, covering UI-exposed create/read/update/delete/action interactions surfaces. | Pass   |

## Reproduction Commands

```bash
pnpm --filter @isis/web exec vitest run src/telemetry/UiInteractionTelemetry.spec.tsx src/App.e2e.spec.tsx
pnpm --filter @isis/generation-api exec vitest run src/routes/models.spec.ts src/routes/jobs.spec.ts
pnpm --filter @isis/workflow-registry exec vitest run src/routes/workflows.auth.spec.ts
pnpm --filter @isis/output-registry exec vitest run src/routes/outputs.auth.spec.ts
```
