# PARITY-009 Certification: UI Action Analytics and Audit Events

Date: 2026-02-22  
Checklist Item: `PARITY-009`  
Ticket: `ISIS-0250`

## Scope

Certify that Isis web now emits analytics and audit telemetry for UI actions
across all route surfaces, including both interaction events and backend action
execution events.

## Evidence Matrix

| Requirement                                              | Evidence                                                                                                                                                                                                                                                                                                                                                                   | Status |
| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| UI interactions emit analytics events                    | `apps/isis/web/src/telemetry/UiInteractionTelemetry.tsx` now emits telemetry for `click`, `submit`, and `change` interactions via `UI_INTERACTION_TELEMETRY_EVENT`, with route and target metadata for each interaction.                                                                                                                                                   | Pass   |
| All SDK-backed UI actions emit audit events              | `apps/isis/web/src/telemetry/UiActionAuditTelemetry.ts` introduces `instrumentIsisClientWithUiAuditTelemetry()` and emits `UI_ACTION_AUDIT_TELEMETRY_EVENT` for every instrumented Isis client call (`generation`, `workflows`, `outputs`, `models`, `checkHealth`) with `start/success/error` phases, action id, route, duration, and error message metadata.             | Pass   |
| Audit instrumentation is enforced at web client boundary | `apps/isis/web/src/api/IsisClientProvider.tsx` now wraps every constructed `IsisClient` with `instrumentIsisClientWithUiAuditTelemetry`, ensuring page-level UI actions automatically produce audit telemetry without per-page manual wiring.                                                                                                                              | Pass   |
| Route fidelity for audit events matches app routing      | `apps/isis/web/src/telemetry/UiInteractionTelemetry.tsx` now synchronizes active router route into audit telemetry state (`setActiveUiTelemetryRoute`), ensuring audit event routes match current React Router location in SPA contexts.                                                                                                                                   | Pass   |
| Regression coverage validates analytics + audit signals  | Added/updated tests: `apps/isis/web/src/telemetry/UiInteractionTelemetry.spec.tsx` (click/submit/change coverage), `apps/isis/web/src/telemetry/UiActionAuditTelemetry.spec.ts` (start/success/error for resource and top-level client methods), and `apps/isis/web/src/App.e2e.spec.tsx` (asserts interaction telemetry + audit telemetry for authenticated submit flow). | Pass   |

## Reproduction Commands

```bash
pnpm --filter @isis/web exec vitest run src/telemetry/UiInteractionTelemetry.spec.tsx src/telemetry/UiActionAuditTelemetry.spec.ts src/App.e2e.spec.tsx src/pages/JobSubmissionStudio.spec.tsx
pnpm --filter @isis/web run typecheck
```
