πŸŽ›οΈ PulsePoint System Hub

Complete overview of all dashboards, tools, and data for Roosevelt SPED students

β€”
Students
β€”
IEP Goals
35
Pages
6
Grafana Dashboards

πŸ“Š Database totals

β€”
Students in Mongo
β€”
IEP goals
β€”
Student Grades
β€”
Progress Reports
β€”
Assignments
β€”
Case managers

πŸ“¦ Database & seed

Loading connection status…

Open seed in new tab Raw debug JSON

πŸ“„ District onboarding (roadmap)

Goal: ship PulsePoint fully wired (UI, API, AI, monitoring) with a clean databaseβ€”no roster or IEP rows until staff add them. Teachers upload an IEP-at-a-glance (or future supported template); AI drafts students, goals, and accommodations; staff review and commit before Mongo is updated. Demo-only stacks can still use seed below.

  1. Deploy β€” Docker Compose (nginx + API + Mongo + …); data lives in volumes, not in the HTML tree.
  2. Skip seed in production β€” /api/seed-all is for training and QA, not live FERPA data.
  3. Planned import β€” attachment β†’ extract text β†’ structured LLM prompt β†’ review UI β†’ writes to Mongo (details TBD).
  4. Privacy β€” prefer on-prem inference for PHI; minimal retention of raw uploads; align logging with district policy.

Full write-up on PulsePoint index

⚠️ Empty roster

Zero students in this database. If you expected data, confirm Mongo and DB name in the status line above. Otherwise this is normal for a new stack β€” add students by uploading an IEP PDF (demo import). Synthetic seed is hidden on demo stacks. Isolated dev stack (separate Mongo, port 13002): docker/compose/docker-compose.pulsepoint-dev.yml. Roadmap: how district setup will work.

πŸ’¬ PulsePoint AI

Teacher Β· Ollama

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: draft dashboard from upload (Ollama). On demo stacks only, staff can commit student + goals β€” never on production.

πŸ“‘ Real-Time Monitoring

WebSocket Live

πŸ“Š Grafana Dashboards

Prometheus Metrics

🎯 IEP Goals & Progress

IEP goals

πŸ‘₯ Student Access

0 students

Quick open: Student login (emoji cards) Β· Enhanced dashboard

πŸ“ Assignments & Games

Universal hub

Every activity is listed in one place β€” open the hub for the full catalog (auto-indexed from /public/assignments).

πŸ–₯️ Teacher & Admin Tools

πŸ’΅ Funding & district

Authorized

πŸ–ΌοΈ One-pager snapshots (PNG)

Staff Β· FERPA

Daily PNG exports of each student’s one-pager at the same depth as ?meeting=1 (assignments & standards grid, full behavior text). Opens only after the same staff passcode as Teacher Hub (staff_passcode in control-center-config.json). Regenerate with npm run snapshots:daily.

πŸ”Œ API Endpoints

This server
/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
/metricsPrometheus

Funding dashboard (/funding.html after the gate) also loads /api/stats, /api/activity, goals, progress, and AI digest endpoints.

⭐ Points System

Gamification
Login+10 pts
Complete Assignment+25 pts
Score 80%++15 bonus
Score 60-79%+10 bonus
Score <60%+5 bonus

πŸ“Š Activity Tracking

Real-time
Student Loginsactivity_log
Assignment Completionsactivity_log
Points Awardedstudents.points
Login Countstudents.loginCount
Assignments Donestudents.assignmentsCompleted
WebSocket Eventslogin-update, assignment-update

🐳 Docker Containers

Aris Mac
πŸ“¦
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

πŸƒ MongoDB Collections

pulsepoint_db
studentsβ€”
student_goalsβ€”
gradesβ€”
progress_reportsβ€”
assignmentsβ€”
activity_logβ€”
behavior_incidentsβ€”
interventionsβ€”

🌐 Network Configuration

Tailscale Funnel URL
ariss-macbook-pro.sunfish-bearded.ts.net
Grafana URL
ariss-macbook-pro.sunfish-bearded.ts.net:8443
Prometheus URL
localhost:9091
MongoDB Connection
mongodb://pulsepoint-mongodb:27017
WebSocket
Socket.IO on port 8889
Metrics Scrape
Every 15 seconds

πŸ› οΈ Tech Stack

BackendNode.js + Express
Real-TimeSocket.IO WebSocket
DatabaseMongoDB
MetricsPrometheus
VisualizationGrafana
ContainerizationDocker
NetworkTailscale Funnel
FrontendVanilla JS + CSS

πŸ“ Project Files

Aris Mac
Project Root/Users/aris/tunsoncloud-monorepo/tunsoncloud2025/active-projects/pulsepoint
Serverserver.js
Public Pages/public/ (35 HTML files)
Assignments/public/assignments/ (see /api/assignments/catalog)
Grafana Dashboards/monitoring/grafana/dashboards/
SEIS Scripts/scripts/add-*-data.js