Skip to content

README.md

Latest commit

 

History

History
99 lines (77 loc) · 1.78 KB

README.md

File metadata and controls

99 lines (77 loc) · 1.78 KB

🎓 CampusPulse – Campus Resource & Faculty Analytics System

CampusPulse is a Flask-based web application designed to manage and analyze campus resources efficiently.

It helps track:

  • 🏫 Campus Blocks
  • 🏢 Classrooms
  • 📚 Courses
  • 👩‍🏫 Faculty Members
  • 🎓 Students
  • 🗓️ Class Sessions

It also provides real-time analytics for:

  • 📊 Classroom & Block Capacity Utilization
  • ⏳ Faculty Workload Distribution
  • ⚠️ Overcapacity Session Detection
  • 🔁 Clash Detection (Faculty & Room Conflicts)

🚀 Features

✅ Resource Management

  • Add / Delete Blocks
  • Add / Delete Classrooms
  • Add / Delete Courses
  • Add / Delete Faculty
  • Add / Delete Students
  • Schedule Sessions

✅ Smart Validation

  • Prevent room time clashes
  • Prevent faculty time clashes
  • Overcapacity warnings

✅ Analytics Dashboard

  • Block Utilization Chart
  • Faculty Workload Chart
  • KPI Summary Cards
  • Interactive Charts using Chart.js

🛠️ Tech Stack

  • Python
  • Flask
  • SQLite
  • Bootstrap 5
  • Chart.js
  • HTML5 / CSS3

📂 Project Structure

campuspulse/ │-- app.py │-- campus.db │-- schema.sql │-- requirements.txt │ ├── templates/ │ │-- base.html │ │-- dashboard.html │ │-- blocks.html │ │-- classrooms.html │ │-- courses.html │ │-- faculty.html │ │-- students.html │ │-- sessions.html │ │-- analytics.html │ └── static/ └── css/ └── style.css

⚙️ Installation

1️⃣ Clone the Repository

git clone https://github.com/yourusername/campuspulse.git
cd campuspulse


2️⃣ Create Virtual Environment
python -m venv venv
venv\Scripts\activate
3️⃣ Install Dependencies
pip install -r requirements.txt
4️⃣ Run Application
python app.py

Visit:

http://127.0.0.1:5000