Internal Guided Demo System

The guided demo is an authorized training and verification layer. It highlights controls, runs safe previews, pauses before real changes, and records proof events for logged-in demo users.

Demo Studio launches full-app, module, role, and public-safe tours.

Public showcase tours are preview-safe and do not expose locked learner data.

What The Demo Does

For buyersShows that LearnX AI is a connected LMS, not a plain CRUD admin. Buyers can inspect courses, CBT exams, assignments, certificates, tutor, commerce, reports, automations, SaaS, and API readiness.

For staff trainingWalks admins, teachers, reviewers, support, corporate managers, guardians, and students through the screens they actually use.

For developersEach step includes route, permission, anchor, sample record, extension point, and troubleshooting note.

For safetyThe demo may fill sample fields and run previews, but it never auto-submits save, delete, payment, certificate, or grade actions.

How To Launch

Public preview: open /showcase and start a public-safe tour.
Full demo: sign in with an authorized demo-environment account, then open /lms/demo-studio.
Module demo: choose a module card such as Course Builder, CBT Assessments, Reports, Automations, or SaaS/API.
Role demo: choose Admin, Academy Admin, Teacher, Reviewer, Support, Corporate, Guardian, or Student.
Resume: if the browser refreshes or the buyer navigates away, click the floating demo dock or Resume Last Tour.

Panel Controls

Control	What it does	Safe behavior
Pause / Resume	Stores the current step and minimizes the panel.	Progress is saved in localStorage and mirrored server-side for logged-in users.
Minimize	Turns the panel into a floating dock.	The user can keep working and resume later.
Restart Step	Resets checklist and safe-action progress for the current step.	No business record changes.
Restart Tour	Returns to the first step of the active tour.	Only demo progress changes.
Run Safe Action	Runs the next action such as highlight, open modal, fill safe field, or run preview.	Stops at confirmation boundaries before real saves.
Open Docs	Opens the module reference below.	Static docs only; no LMS data mutation.

Action-Assisted Mode

The demo is intentionally not a fully automatic robot. It prepares the screen, explains what the buyer is seeing, and pauses before any real mutation.

Action	Example	Allowed?
`assert_visible`	Confirm the CBT command bar exists.	Yes
`highlight_sequence`	Highlight KPI strip, table, and actions.	Yes
`fill_fields`	Fill sample course title or report prompt.	Yes, safe fields only
`open_modal` / `open_drawer`	Open Create Coupon, Assignment Rubric, or Tutor source drawer.	Yes
`run_preview`	Preview automation audience or report result.	Yes
`wait_for_confirm`	Pause before save, delete, grade release, payout, payment, certificate issue.	Required

Module Reference

Every live demo step links to one of these anchors. Use them during buyer calls to explain the plain workflow first, then open the developer note if the buyer asks about implementation.

Public Dashboards Role AI Courses Lessons Student Assessments Assignments Tutor Certificates Community Commerce Reports Automations SaaS/API

Module	Layman explanation	Demo example	Developer note
Public	Shows the product safely before login.	Start at `/showcase`, inspect feature journey and certificate verify CTA.	Public scripts are whitelisted in `config/learnx_demo.php`.
Dashboards	Each role gets its own command center.	Admin sees platform signals; Teacher sees own courses and grading work.	Routes use `/dashboard/*` and role permissions.
Role	Shows what each user type can do.	Run Teacher tour to inspect owned courses, Q&A, assignments, and earnings.	Permission filtering happens before steps are returned.
AI	Shows prompts, usage, quota, and safe fallback states.	Open AI request logs and prompt templates.	AI calls are logged and prompts are versioned.
Courses	Build, price, review, and publish learning products.	Create course title “Laravel SaaS Platform Builder” and inspect readiness.	Use `data-demo-anchor="course-builder-workspace"`.
Lessons	Author video, article, PDF, audio, live, and protected resources.	Open lesson studio and preview locked content behavior.	Protected media stays behind authorized routes.
Student	Shows learner dashboard, course hub, player, notes, bookmarks, progress, tutor, and certificates.	Resume a seeded course and inspect completion diagnostics.	Student context must stay scoped to the signed-in learner.
Assessments	Shows question bank, CBT exams, result sheets, corrections, and exports.	Skip Q2, answer Q3, and watch counters update.	Attempts preserve randomized order and teacher visibility rules.
Assignments	Shows practical work, file submissions, rubrics, resubmissions, feedback, and grading.	Preview a rubric score and stop before releasing feedback.	Submission files stay protected and grading is auditable.
Tutor	Shows private course AI tutor with source-backed answers.	Ask for beginner explanation and inspect cited sources.	Tutor uses bounded course context, not raw unrestricted data.
Certificates	Shows eligibility, issue, PDF, QR verification, revoke, and reissue.	Verify a seeded certificate and inspect public proof.	Public verify exposes credential facts only.
Community	Shows reviews, Q&A, discussions, moderation, and AI drafts.	Draft an instructor answer without auto-posting.	Moderation actions write activity logs.
Commerce	Shows free/paid courses, coupons, bundles, invoices, earnings, payouts.	Apply coupon and inspect earning split after discount.	Sandbox payments only in this phase.
Reports	Shows reports, Ask LMS, risk cards, exports, and intervention Kanban.	Ask “Which students are inactive?” and create intervention card.	Ask LMS maps text to safe predefined intents, never raw SQL.
Automations	Shows reminders, certificate auto-issue, run history, and Kanban.	Preview an assignment due reminder audience.	Commands run rules idempotently and record run items.
SaaS/API	Shows tenant packages, limits, billing placeholder, API docs, and mobile readiness.	Inspect X-Academy-Code login rules and tenant health.	Tenant routes and API docs are separate from learner data.

Developer Integration Notes

Source files Tour definitions live in config/learnx_demo.php. The service resolves permissions, routes, demo references, docs links, and safe connected records. The vanilla browser engine lives at public/assets/js/pages/lms/guided-demo.js.

Adding a new step Add a route name, selector, permission, optional demo reference key, action list, success checks, example, developer note, and docs anchor. Then add a matching data-demo-anchor to the Blade screen.

Troubleshooting If a step opens Demo Studio instead of the target page, check the route name or demo reference. If the highlight does not appear, add the missing data-demo-anchor or update synthetic anchors. If a buyer cannot run a tour, check the run guided demo permission.

Routes

/lms/demo-studio
/lms/demo-studio/tours/{script}
/showcase/demo/tours/{script}
/lms/guided-demo/progress
/lms/guided-demo/events
/lms/guided-demo/progress/reset

Demo QA Checklist

Start full app tour from Demo Studio.
Pause, refresh browser, and resume from the dock.
Restart one step and one full tour.
Run one safe fill-field action.
Open docs from a guided step.
Run one public-safe showcase tour without login.
Run one student tour and one staff tour.
Open Demo Health and confirm routes, permissions, anchors, actions, checks, and sample data.