๐ EduFlow Student Dashboard (Dash + Plotly)
A web-based interactive analytics dashboard built using Python, Dash, Plotly, and Pandas to analyze academic performance of BCA students. This dashboard allows faculty or administrators to upload student marks data and instantly visualize performance insights such as pass/fail status, gender-wise distribution, mark ranges, and KPIs.
๐ Features
โข ๐ Upload CSV or Excel files (Drag & Drop supported)
โข ๐ฏ Subject-wise performance analysis
โข ๐ Automatic calculation of Total Marks
โข ๐งฎ Key Performance Indicators (KPIs):
โ Total Students
โ Boys Percentage (%)
โ Girls Percentage (%)
โ Average Marks
โข ๐ Interactive visualizations:
โ Gender distribution (Pie chart)
โ Marks distribution by range (Histogram)
โ Pass vs Fail comparison (Bar chart)
โ Gender-wise Pass & Fail analysis (Donut charts)
โข ๐จ Clean pastel UI suitable for academic dashboards
๐ ๏ธ Tech Stack
โข Python 3.9+
โข Dash โ Web framework
โข Plotly Express โ Interactive charts
โข Pandas โ Data processing
โข Base64 / IO โ File upload handling
๐ Project Structure
student-dashboard/ โ โโโ app.py # Main Dash application โโโ README.md # Project documentation โโโ requirements.txt # Python dependencies โโโ sample_data.xlsx # (Optional) Sample dataset
๐ Required Dataset Format
The uploaded file must contain the following columns:
Column Name Description
Course Course name (e.g., BCA)
Gender Boy / Girl
Subject Subject name
Internal_1 Internal exam 1 marks
Internal_2 Internal exam 2 marks
External External exam marks
โ๏ธ Installation & Setup
1๏ธโฃ Clone the Repository
git clone https://github.com/your-username/bca-student-dashboard.git cd bca-student-dashboard
2๏ธโฃ Create Virtual Environment (Optional but Recommended)
python -m venv venv source venv/bin/activate # For Windows: venv\Scripts\activate
3๏ธโฃ Install Dependencies
pip install dash plotly pandas
4๏ธโฃ Run the Application
python app.py
Open your browser and go to:
๐ง How It Works
-
Upload student marks file (CSV / Excel)
-
Dashboard filters data for BCA course only
-
Select a subject from the dropdown
-
Dashboard updates all KPIs and charts dynamically
-
Pass/Fail is calculated using:
PASS_MARK = 50
๐ฏ Use Cases
โข College internal assessment analysis
โข Department level academic reviews
โข Faculty performance tracking
โข Student result visualization
๐ Customization Ideas
โข Add semester-wise filters
โข Export reports as PDF
โข Role-based login (Admin / Faculty)
โข Predict performance using ML
โข Connect with database (MySQL / PostgreSQL)
๐งโ๐ป Author
Sreelekshmi A A (https://github.com/sreelekshmiaa)
Theertha Sunil (https://github.com/theerthasunil066-boop)
Shivganga R T (https://github.com/shivgangart)
Course: BCA (Data Science & AI)
Institution: Asian School of Business
๐ License
This project is for educational purposes. You are free to modify and use it for academic projects.
