Skip to content

feat: DataMiner LCA UX audit workflow#34

Open
leanderdruwel-skyline wants to merge 5 commits into
mainfrom
feat/dataminer-lca-ux-audit
Open

feat: DataMiner LCA UX audit workflow#34
leanderdruwel-skyline wants to merge 5 commits into
mainfrom
feat/dataminer-lca-ux-audit

Conversation

@leanderdruwel-skyline
Copy link
Copy Markdown
Collaborator

Adds a fully reusable Playwright-based UX audit tool for any DataMiner Low-Code App.

What's included

  • \�gents/dataminer-ux-audit/\ — self-contained Playwright project
  • Visits every page, waits for data to load, clicks table row icons to open side panels
  • Checks against the DataMiner LCA style guide (SG-xx)
  • Modern UI/UX best-practice checks (spacing, elevation, typography, status chips, …)
  • Annotated screenshots with numbered coloured boxes (�� Style Guide, 🔵 UX Expert)
  • HTML report with per-page score, annotation key table, ranked improvement plan
  • Two-pass audit (warm-up + measured) for accurate load times
  • SAML + Microsoft auth with 8-hour session reuse
  • Copilot CLI extension (
    un_dataminer_ux_audit) for one-command usage
  • Results committed to
    esults/\ folder for traceability

Usage

See \�gents/dataminer-ux-audit/README.md\ for full instructions.

leanderdruwel-skyline and others added 5 commits May 13, 2026 07:44
Adds a fully reusable Playwright-based UX audit tool for any DataMiner
Low-Code App.

- Visits every page, waits for data to load, opens table row icon panels
- Checks against the DataMiner LCA style guide (SG-xx rules)
- Modern UX/UI best practice checks (spacing, elevation, typography, etc.)
- Annotated screenshots with numbered coloured boxes
- HTML report with per-page score, annotation key table, improvement plan
- Two-pass audit (warm-up + measured) for accurate load times
- SAML + Microsoft auth with 8-hour session reuse
- Copilot CLI extension (run_dataminer_ux_audit) for one-command usage
- Results committed to results/ folder for traceability

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Comprehensive UX spec covering:
- Design tokens: semantic colour palette, typography scale, spacing grid,
  border radii, elevation/shadow levels
- Component guidelines: tables, buttons, status chips, filter panels,
  side panels, KPI tiles, empty/loading states
- Cross-app consistency rules (CC-01 to CC-10)
- Anti-patterns observed across current portfolio
- Scoring reference mapping audit checks to spec rules
- Baseline audit results from May 2026 cross-app run

Based on analysis of 5 real DataMiner LCA apps across two servers.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…y buttons

Replace DOM/aria-label heuristics with URL-change detection.
Each sidebar tab is clicked; only those that produce a new URL route are
kept as real pages. This correctly filters out the hamburger and back
arrow buttons that share the same .sidebar-tab class but do not navigate.

Also:
- pages[0] uses sentinel domIndex=-1 (already on this page after goto)
- goToPage() no-ops for domIndex=-1
- URL labels are URL-decoded and hyphen-unescaped for clean filenames
- Discovery log now shows label(domIndex) for debugging

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
lca-phase1-review.spec.ts combines:
- Full audit checks (SG-01/06/07/08/09/12, UX-02 to UX-09)
- Clean + annotated screenshots with numbered finding boxes
- Aggressive before/after CSS mockup (chart colors, rounded
  corners, header accent bar, uppercase labels, status chips)
- HTML report: exec summary (PO) + annotation key + before/after
  side-by-side + full findings table

Score for Facility Manager Overview: 45/100 (D)
7 findings, 4 annotated boxes, clear visible before/after diff

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant