Skip to content

PulseBoard: Real-time CUNY student survey insights with interactive dashboards and predictive service recommendations.

License

Notifications You must be signed in to change notification settings

AlbertBagdos256/CUNY_PulseBoard_CTP-HACK-2025.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CUNY PulseBoard logo

A real-time survey and dashboard tool that helps CUNY understand and respond to student needs.

CUNY PulseBoard gives students a voice by turning their feedback into data-driven insights. Through quick and accessible surveys, students can share what resources they need most — whether it’s counseling, food, housing, or academic support. Their responses flow directly into a live dashboard that visualizes trends in real time, enabling administrators to quickly identify issues and take meaningful action to better support the CUNY community.

Key Features

  • 📝 Student Surveys – Quick and accessible feedback forms.
  • 📊 Live Dashboard – Real-time updates with interactive graphs.
  • 🗄️ Database Integration – Responses stored securely and reliably.
  • 🎯 Actionable Insights – Helps CUNY target resources where they’re needed most.

Dashboard Demo

📁Project Structure

CUNY_PulseBoard/
├── frontend/ # React + Vite frontend
│   ├── public/ # Static files
│   ├── src/ # Main source code
│   │   ├── assets/ # Images, icons, etc
│   │   ├── components/ # Reusable UI components
│   │   ├── pages/ # Application pages
│   │   ├── App.jsx # Root React component
│   │   ├── App.css # Global component styles
│   │   ├── index.css # Base/global styles
│   │   └── main.jsx # Entry point for React
│   ├── index.html # HTML entry point
│   ├── package.json # Frontend dependencies
│   ├── vite.config.js # Vite configuration
│   └── README.md # Frontend-specific documentation
│
├── backend/ # Python + FastAPI backend
│   ├── api/ # Core backend application
│   │   ├── routes/ # API endpoint route definitions
│   │   ├── sql_queries/ # SQL query files
│   │   ├── machine_learning.py # Machine learning     
│   │   ├── main.py # Entry point for FastAPI app
│   │   ├── mock_data.py # Script 
│   │   └── surveys.db # SQLite database file
│   ├── requirements.txt # Backend dependencies (pip)
│   └── README.md # Backend-specific documentation
│
├── media/ # Screenshots, GIFs, and other assets
│   └── Animation.gif
│
└── README.md # Project documentation

🛠️ Technologies Used

Frontend

  • React – Component-based UI library
  • JavaScript (ES6+) – Core language for dynamic client-side functionality
  • Vite – Fast development server and build tool
  • Recharts – Library for creating interactive charts and data visualizations

Backend

  • Python – Core backend language
  • FastAPI – Modern web framework for building APIs quickly and efficiently
  • SQLite – Lightweight relational database for survey and user data storage

General

  • Node.js – Used for frontend tooling and dependency management
  • pip – Python package manager for backend dependencies

About

PulseBoard: Real-time CUNY student survey insights with interactive dashboards and predictive service recommendations.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •