District demo instructions

Share the choose-your-path video first (guest landing). /onboarding/ is the secondary hub pack. This page is the full walkthrough. Demo sandbox uses :13002 and Mongo pulsepoint_dev_db — not production on :3002.

Open choose-path video →
Print district leave-behind pack

Start here (video) Leave-behind Student login Teacher hub IEP PDF import Funding System map

For teachers (daily use)

Onboard a student — IEP PDF import (demo) or ask your operator to run demo-ready.sh
Teach & monitor — Teacher hub, Live monitor, Assignment builder
Student view — Student login or enhanced dashboard with ?name=…

You do not need Dev Hub for normal classroom demo — operators use it to seed data or fix issues for everyone.

For students

Open student login by grade, pick your name. Inclusion students (≥50% gen ed on IEP) land on the Inclusion Hub — supports + class work with a floating supports bar on worksheets. Other students use the full enhanced dashboard.

For district / leadership

Funding workspace and Grants index (passcode tunson when prompted). Optional Grafana district demo dashboard if observability is running.

How the pieces connect

One database holds each student. IEP PDF import creates the profile (goals, accommodations). Teacher tools and (operator) Dev Hub add assignments and supports. The enhanced dashboard is the student view.

Hub AI chat on the home page is advice only — it does not write to Mongo. Operators use Dev hub AI (staff unlock below) to apply assignments to a student dashboard.

15-minute walkthrough (presenter)

Confirm demo stack is up (operator) — API online on :13002
IEP import or demo seed — at least one student
Teacher hub or monitor — show class view
Student login first — login by grade → Inclusion Hub or dashboard
Inclusion demo: Inclusion Hub → worksheet with supports bar
Enhanced dashboard — full SPED view + Behavior tab
Staff: SEIS progress note (copy for SEIS paste)
Funding for leadership story

Class chat (peer) — teacher controls

Students use roster-scoped peer DMs (class chat). Teachers monitor via Monitor Hub review queue.
Flag marks a message for follow-up; Mute / hide removes it from student view; Restore brings it back.
Moderation requires staff passcode (server-enforced). Demo walkthrough: show one flagged message → Mute → Restore.
Do not demo peer chat on LIVE / Funnel without district FERPA agreement — SANDBOX only for meetings.

Key URLs (users)

Who	URL
Everyone — start	/admin/video-choose-your-path.html
All hubs (secondary)	/onboarding/
Student login	/student-login-by-grade.html
Inclusion Hub	/student/inclusion-hub.html
SEIS progress note	/reports/seis-progress-note.html
Teacher hub	/teacher-hub.html
Multiplication worksheet	/assignments/integer-multiplication-signs-with-supports.html
Funding	/funding-gate.html

Operator tools (staff only)

Dev Hub, terminal commands, wipe sandbox, and Grafana setup are hidden until you unlock. Share the choose-path video with users instead of /dev/.

Staff / operator section

Open Dev Hub (ops console) →

Start the stack (terminal on Aris)

cd ~/tunsoncloud-monorepo
./pulsepoint/scripts/start-district-demo.sh --no-funnel

With Grafana + Funnel:

./pulsepoint/scripts/start-district-demo.sh observability

./pulsepoint/scripts/start-district-demo.sh --seed

Instant demo data (no Ollama)

./pulsepoint/scripts/demo-ready.sh

Five ways to add data (Dev Hub)

IEP PDF import — Ollama draft → commit (demo only)
Add Assignment — Dev hub form
Add Support — accommodations / services
PulsePoint AI → dashboard — Dev hub AI
Behavior & intervention — section 4

Operator URLs

What	URL
Dev hub	/dev/
Grafana (local)	district demo

Before the meeting

Stop production PulsePoint on :3002
Live story: Wipe → demo-ready.sh or import one IEP PDF
Full data prep: Dev Hub → Seed all (full roster) or ./pulsepoint/scripts/seed-demo-all.sh
Test Funnel /dev/ if presenting remotely

Reset sandbox

Dev hub → Wipe sandbox, or:

./pulsepoint/scripts/wipe-district-demo.sh -y

Seed all (full demo Mongo)

Dev hub → Seed all (full roster), or:

./pulsepoint/scripts/seed-demo-all.sh

Loads ~25 Roosevelt students + goals + progress + behavior into pulsepoint_dev_db. Use for monitor/funding prep; use demo-ready.sh for the one-student live walkthrough.

Fix all users: edit pulsepoint/public/ (and mirror nginx-site/ if needed), restart demo containers — users hard-refresh.

Runbook: pulsepoint/docs/DISTRICT-DEMO.md · Dev hub: DEV-HUB-QUICK-REFERENCE.md