📊 At a glance (live)
No roster loaded. Mongo returned zero students (normal for a fresh database).
Staff: use
Teacher hub or your usual import path.
For a throwaway sandbox only, you may load demo seed data — never on production FERPA data.
On this
demo stack, bulk seed is
disabled — add students via
IEP PDF import or Dev Hub forms. See
District demo.
📄 District onboarding (roadmap)
PulsePoint is meant to ship fully configured with a clean database (no students or IEP rows) until your team adds them.
Planned: teacher uploads an IEP-at-a-glance attachment → AI drafts roster, goals, and accommodations → staff review and commit.
Until that flow ships, use existing teacher tools or seed only on non-production stacks.
Full details: PulsePoint index → How district setup will work
Isolated stack for district meetings — separate Mongo (pulsepoint_dev_db on :37019), green Demo · sandbox badge, never mixed with live production on :3002.
Start from monorepo root: ./pulsepoint/scripts/start-district-demo.sh observability.
Full runbook: repo pulsepoint/docs/DISTRICT-DEMO.md.
URLs & services
API · Mongo
:18889 · :37019
Ollama (host Mac)
:11434 — IEP extract, Dev Hub AI
Staff passcode
tunson on gated pages
👋
Get started (teachers & students)
Share this link on onboarding — not Dev Hub
📖
District demo instructions
Full walkthrough — teachers, students, district; staff ops behind unlock
Walkthrough
🧪
Dev Hub
Operators only — seed, wipe, AI apply, preview; share /onboarding/ with users
Ops
📤
IEP PDF import
Upload IEP PDF → Ollama drafts student, goals, accommodations → commit to demo Mongo
Ollama
➕
Add assignment & support
Manual forms on Dev Hub — creates assignments + progress rows; add accommodations/services by student name
Dev Hub
🤖
PulsePoint AI → dashboard
Plain English → AI plan → apply to student Enhanced Dashboard (worksheets, supports). Not the hub chat below.
Apply
🔐
Student login (Chromebook)
Grade → name → Enhanced dashboard with Tap to start assignment banner
Student
🎓
Enhanced dashboard
Student portal — featured assignment banner, supports tab, games (Connect Four)
Portal
✖️
Integer multiplication
Interactive Ollama math worksheet — AI maps "PulsePoint AI" requests here
Worksheet
➗
Integer division
Interactive worksheet with supports and progress chart
Worksheet
💰
Funding workspace
Presentation mode for grants — passcode tunson
District
📋
Grants index
Leave-behind links — application guide, check-in sheet, word search
Leave-behind
📊
Grafana · district demo
Sandbox metrics only — demo API + Mongo scrapes
:8443
🔤
Freetime word search
Standalone — paste class names, no PulsePoint login required
Freetime
Disabled in demo: GET /api/seed-all returns 403.
Custom assignment titles show as "Up next" only unless linked to a worksheet.
Hub PulsePoint AI chat (below) gives teacher advice — use Dev Hub AI to write to a student dashboard.
Draft accommodations, clarify IEP wording, or brainstorm strategies — advice only (does not write to Mongo). To apply assignments and supports to a student dashboard, use Dev Hub → PulsePoint AI → Student dashboard. IEP PDF: IEP PDF → draft dashboard uploads a document for Ollama goal cards; on a demo API you can commit student + goals to Mongo (not on production).
/api/studentsGET
/api/student-goalsGET
/api/gradesGET
/api/progress-reportsGET
/api/assignmentsGET
/api/loginPOST
/api/progressPOST
/api/funding-program-impactGET
/api/system-totalsGET
/api/db-countsGET
/api/ai/chatPOST
/api/ai/monitoring/recentGET
/api/ai/llm-healthGET
/metricsPrometheus
Funding dashboard (/funding.html after the gate) also loads /api/stats, /api/activity, goals, progress, and AI digest endpoints.
Login+10 pts
Complete Assignment+25 pts
Score 80%++15 bonus
Score 60-79%+10 bonus
Score <60%+5 bonus
Student Loginsactivity_log
Assignment Completionsactivity_log
Points Awardedstudents.points
Login Countstudents.loginCount
Assignments Donestudents.assignmentsCompleted
WebSocket Eventslogin-update, assignment-update
📦
pulsepoint-student-api
Node.js Express server with Socket.IO, serves all pages and APIs
Port 8889
🍃
pulsepoint-mongodb
MongoDB database storing students, goals, grades, progress reports
Port 27017
📊
prometheus
Metrics collection, scrapes /metrics endpoint every 15s
Port 9091
📈
grafana
Visualization dashboards for student metrics and progress
Port 9003
students25 docs
student_goals177 docs
grades25 docs
progress_reports32 docs
assignments51 docs
activity_logLive tracking
Prometheus URL
localhost:9091
MongoDB Connection
mongodb://pulsepoint-mongodb:27017
WebSocket
Socket.IO on port 8889
Metrics Scrape
Every 15 seconds
BackendNode.js + Express
Real-TimeSocket.IO WebSocket
DatabaseMongoDB
MetricsPrometheus
VisualizationGrafana
ContainerizationDocker
NetworkTailscale Funnel
FrontendVanilla JS + CSS
Project Root/Users/aris/tunsoncloud-monorepo/tunsoncloud2025/active-projects/pulsepoint
Serverserver.js
Public Pages/public/ (35 HTML files)
Assignments/public/assignments/ (13 files)
Grafana Dashboards/monitoring/grafana/dashboards/
SEIS Scripts/scripts/add-*-data.js