Skip to content

Add full guided tour to existing AD Posture dashboard#1

Merged
wgerade merged 14 commits into
mainfrom
feature/adposture-guided-tour
Jun 10, 2026
Merged

Add full guided tour to existing AD Posture dashboard#1
wgerade merged 14 commits into
mainfrom
feature/adposture-guided-tour

Conversation

@wgerade

@wgerade wgerade commented Jun 10, 2026

Copy link
Copy Markdown
Owner

Summary

Adds a guided tour directly to the existing AD Posture dashboard UI.

This no longer creates a separate dashboard and no longer includes certificate functionality.

What changed

  • Added dashboard/tour.js.
  • Updated dashboard/bootstrap.js to load tour.js on dashboard pages that use the shared bootstrap loader.
  • Updated dashboard/timeline.html to load tour.js directly, because Timeline does not use bootstrap.js.
  • Added dashboard/dashboard-data.js with synthetic demo dashboard data.
  • Added dashboard/timeline-data.js with synthetic demo timeline data.
  • Removed the previous standalone /tour/ prototype files from this PR branch.

Current behavior

The tour now runs inside the real dashboard pages and preserves the existing HTML, sidebar, topbar, panels, filters, tables, and current data-loading behavior.

The tour card follows the highlighted content. For each step it tries to position itself near the highlighted element, using the best available placement: right, left, bottom, or top. It also clamps itself inside the viewport to avoid leaving the screen.

The Action Plan page auto-starts the tutorial the first time it is opened in the browser session. The user can close it and continue navigating normally.

The tour now uses a curated screen-by-screen flow instead of automatically creating extra steps for every visible table/panel. This removes repeated explanations such as Last run / dataset context and avoids duplicate Action Plan steps.

Covered screens

  • index.html - Action Plan
  • objects.html - AD Objects
  • adcs.html - ADCS
  • auth.html - Kerberos
  • trusts.html - Trusts
  • dns.html - DNS
  • gpo.html - GPO
  • acl.html - ACL
  • exceptions.html - Exceptions
  • timeline.html - Timeline
  • executive.html - Executive

Data behavior

For the guided demo/public tour, synthetic data is included in:

  • dashboard/dashboard-data.js
  • dashboard/timeline-data.js

A viewer does not need to run the PowerShell demo script just to see populated dashboard content.

The PowerShell script can still be used later to regenerate demo assets or overwrite the embedded demo data during normal project workflows.

Removed from the first version

  • Certificate screen
  • Certificate PNG download
  • Separate landing page
  • Separate fake dashboard layout

Validation

Open:

dashboard/index.html

Expected behavior:

  • The tutorial starts automatically on index.html during the browser session.
  • The user can close it and navigate normally.
  • The Start tour button remains available.
  • The tour card follows the highlighted content instead of staying fixed in one corner.
  • The Action Plan tour is shorter and no longer repeats dataset/Last run context.
  • The tour continues after Exceptions into Timeline and then Executive.
  • The dashboard is populated with synthetic demo data without requiring a PowerShell script run.

Publishing

This PR remains draft. Nothing has been merged or published.

@wgerade wgerade changed the title Add AD Posture guided tour prototype Add guided tour to existing AD Posture dashboard Jun 10, 2026
@wgerade wgerade changed the title Add guided tour to existing AD Posture dashboard Add full guided tour to existing AD Posture dashboard Jun 10, 2026
@wgerade wgerade marked this pull request as ready for review June 10, 2026 21:45
@wgerade wgerade merged commit 935ce05 into main Jun 10, 2026
1 check failed
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