Eve library

V1-AWEB-104 — Dense-Data Visual Regression Coverage Spec

Spec

Revision 1

On this page

Implementation spec for the Phase 17.10 visual regression coverage of dense-data admin surfaces. Goal: lock in the V1 operator experience bar so future panel changes cannot silently drift the visual language.

Scope#

Visual regression screenshots covering:

  • Severity stripe rendering at all four levels (V1-AWEB-098).
  • Dense table density in both comfortable and compact modes (V1-AWEB-093 + V1-AWEB-095).
  • Master-detail split at 1280px / 1920px / 2560px (V1-AWEB-094).
  • Provenance trust card in all four severity outputs (V1-AWEB-097).
  • TextDiff highlighting on insertion / deletion / mixed (V1-AWEB-097).
  • AuditTimeline day grouping + per-event-kind icons (V1-AWEB-097).
  • AdminConfirmationModal at the three-subsection layout (V1-AWEB-099).
  • CopilotHealthPanel + WorkspaceSummaryCard grid on / (V1-AWEB-093).

Tooling#

Use Playwright's built-in screenshot comparison (expect(locator).toHaveScreenshot()). Tolerance: maxDiffPixelRatio: 0.001 (0.1% per surface).

Snapshots live under apps/oshun/admin/e2e/__screenshots__/<spec-name>/. Snapshots are regenerated only via the explicit playwright test --update-snapshots flag; CI fails on any diff.

Spec layout#

apps/oshun/admin/e2e/visual-regression-dense-data.spec.ts:

ts
test.describe('V1-AWEB-104 visual regression — dense data', () => {
  test('severity stripes — 4 levels at comfortable density', ...);
  test('severity stripes — 4 levels at compact density', ...);
  test('master-detail split — 1280×800', ...);
  test('master-detail split — 1920×1080', ...);
  test('master-detail split — 2560×1440', ...);
  test('ProvenanceTrustCard — valid', ...);
  test('ProvenanceTrustCard — pending', ...);
  test('ProvenanceTrustCard — invalid', ...);
  test('ProvenanceTrustCard — mixed absent', ...);
  test('TextDiff — insertion highlight', ...);
  test('TextDiff — deletion highlight', ...);
  test('TextDiff — mixed insertion + deletion', ...);
  test('AuditTimeline — multi-day grouping', ...);
  test('AdminConfirmationModal — typed confirmation', ...);
  test('CopilotHealthPanel + WorkspaceSummaryCard grid', ...);
});

15 spec entries → 15 baseline screenshots.

Snapshot hygiene#

  • Snapshots are committed to the repo under apps/oshun/admin/e2e/__screenshots__/.
  • Updates to a snapshot require a corresponding PR description note explaining the visual change.
  • Snapshots are only updated for intentional V1-AWEB-09x redesign changes; bug fixes that change pixels need a reviewed snapshot update with rationale.

Implementation deliverables#

  1. apps/oshun/admin/e2e/visual-regression-dense-data.spec.ts — the 15-spec file.
  2. Initial baseline snapshots committed to apps/oshun/admin/e2e/__screenshots__/visual-regression-dense-data/.
  3. PR template note added for snapshot updates (in the existing PR template under docs/).

Acceptance criteria#

  • All 15 spec entries exist and pass on a clean baseline generation run.
  • CI (when wired) fails on any diff > 0.1% per surface.
  • Snapshot directory is committed to the repo (not gitignored).
  • A snapshot update PR includes a rationale note.

Out of scope#

  • Cross-browser visual snapshots (Chromium-only).
  • Mobile / tablet snapshots.
  • Animated state snapshots (the V1-AWEB-098 no-motion-on-render rule keeps the surface set static).