UX Component Coverage Matrix
This matrix maps backend application components from /Users/swilco/01-DEVELOPMENT/Evalium/docs/architecture/components.md to current UX documentation coverage.
Purpose:
- show what is already covered well
- show what is missing or under-specified
- prioritize which UX docs/screens to define next
Coverage labels:
Full: clear UX patterns and screen behavior are already documentedPartial: concept exists, but key screens/workflows/contracts are missingMissing: no meaningful UX contract documented yet
| Component | Primary UX Doc Coverage | Coverage | Missing / Under-Specified UX Screens and Flows | Priority |
|---|---|---|---|---|
| 1. Question authoring & Management | UX-AUTHORING.md, UX-AUTHORING-BACKEND-ALIGNMENT.md | Full | Keep aligned as backend expands (mostly complete) | P2 |
| 2. Evaluation authoring & Management | UX-AUTHORING.md, UX-AUTHORING-BACKEND-ALIGNMENT.md | Full | Publish-propagation and policy UX refinement as contracts evolve | P2 |
| 3. Evaluation Sections & Buckets | UX-AUTHORING.md | Partial | Bucket rule authoring details, deterministic preview controls, failure states, bucket validation UX details | P1 |
| 4. Assessment Runtime / Delivery | UX-RUNTIME-CANDIDATE-DELIVERY.md, UX-OPERATIONS.md | Full | Keep aligned with delivery API evolution, especially offline sync and proctor command endpoints | P1 |
| 5. Evidence & Verification | UX-REVIEW-AND-APPROVAL.md, UX-OPERATIONS.md, UX-INSIGHTS.md, UX-GOVERNANCE-COMPLIANCE.md | Full | Keep aligned with evidence storage-tier and integrity worker contract evolution | P1 |
| 6. Submission Review & Approval | UX-REVIEW-AND-APPROVAL.md, UX-OPERATIONS.md | Full | Keep aligned with review state normalization and policy/rationale enforcement updates | P0 |
| 7. Assignments | UX-OPERATIONS.md | Partial | Draft semantics (currently feature-flagged), schedule lifecycle detail screens, monitor -> submission handoff details | P1 |
| 8. Reporting & Analytics | UX-INSIGHTS.md | Partial | Concrete dashboard/page IA and block-level contracts per report surface | P1 |
| 9. Results Remediation | UX-INSIGHTS.md | Full | Mostly complete; maintain parity with backend rule expansion | P2 |
| 10. Programmes & Enrolments | UX-GOVERNANCE.md, UX-OPERATIONS.md | Full | Keep aligned with programme orchestration/listener behavior and certificate lifecycle expansion | P1 |
| 11. Claims & Disputes | UX-CLAIMS-DISPUTES.md | Full | Keep aligned with backend lifecycle changes and any new dispute policy rules | P2 |
| 12. Glass Box (Audit View) | UX-GLASSBOX.md | Full | Keep aligned with link-principal capability/redaction changes | P2 |
| 13. Observations & Findings | UX-OPERATIONS.md, UX-INSIGHTS.md | Partial | Observation/finding review surfaces, finding drilldowns, linkage to approval decisions and disputes | P1 |
| 14. Compliance & Data Privacy | UX-GOVERNANCE-COMPLIANCE.md | Partial | Strong direction exists; full case/timeline orchestration remains target-state and needs final first-class screen specs | P1 |
| 15. Taxonomy & Skills | UX-AUTHORING-BACKEND-ALIGNMENT.md, UX-INSIGHTS.md | Partial | Taxonomy admin IA beyond assignment/filtering; skills surfaces intentionally parked until inference/provenance ready | P1 |
| 16. Content Packs | UX-CONTENT-PACKS.md | Full | Keep aligned with pack workflow expansion beyond current lineage/install surfaces | P1 |
| 17. Identity & Auth Sessions | UX-IDENTITY-AND-ACCESS.md | Full | Keep aligned with auth/session contract changes (CSRF/session metadata/step-up behavior) | P1 |
| 18. Authorization (RBAC) | UX-IDENTITY-AND-ACCESS.md | Full | Keep aligned with capability matrix evolution and role-binding scope rules | P1 |
| 19. Audit & Ledgering | UX-AUDIT-LEDGER-EXPLORER.md + cross-cutting docs | Full | Keep aligned with future unified audit query/export contracts | P1 |
Recommended Next UX Spec Order​
Completed in this pass:
UX-REVIEW-AND-APPROVAL.md- Expanded operations contracts for evidence integrity and programmes/enrolments
UX-AUDIT-LEDGER-EXPLORER.md- Offline-sync target-state contract extension in
UX-RUNTIME-CANDIDATE-DELIVERY.md - Pack import/propagation target-state contract extension in
UX-CONTENT-PACKS.md
Next recommended priorities:
- Expand
UX-AUTHORING.mdfor bucket rule authoring and deterministic preview controls. - Expand
UX-INSIGHTS.mdwith concrete report page IA and per-block drilldown contracts. - Add first-class observation/finding review drilldown UX surface (currently cross-referenced, not fully specified).
- Finalize compliance case/timeline orchestration screen contract when case entity backend contracts are ready.
- Activate skills profile and explainability UX once provenance facts/inference jobs are backend-live.