📘 UIU Faculty Schedule App

A modern, mobile-friendly web application to search and view faculty schedules at United International University (UIU). Students can easily find faculty information, see their undergrad & grad routines, and quickly check today’s availability/free slots to plan visits.

---

✨ Features

• Smart Search – Search by faculty name or code with live suggestions

• Faculty Info – Quick access to name, designation, room, and email

• Today’s Availability – Automatically highlights today’s classes, counseling, and free time slots

• Routine Tables – Separate Undergrad and Graduate schedules in a clean tabular view

• Color-coded Routine

  • 🟩 Class (CH) → Blue
  • 🟦 Counseling Hour (CnH) → Green
  • 🟨 Office Hour (OH) → Yellow
  • ⬜ Empty Slot → White

• Responsive UI – Looks great on mobile devices as well as desktops

---

🖼️ Demo Preview

---

🛠️ Tech Stack

• Frontend: HTML5, CSS3 (Bootstrap + custom styles), JavaScript
• Data Source: UIU Class Routine - Summer25 by UIU CSE Dept
• Responsive Design: Mobile-first approach

---

📂 Project Structure

faculty-schedule-app/
│
├── app.py                   # Main Flask application
├── requirements.txt         # Python dependencies
├── faculty_data.json        # Generated JSON file with parsed faculty schedules
├── templates/               # HTML templates for web pages
│   ├── index.html           # Search page (Main Page)
│   ├── schedule.html        # Faculty schedule display page
│   ├── admin.html           # Admin upload page (local only)
├── uploads/                 # Temporary folder for uploaded XLSX files
└── .gitignore               # Git ignore file

---

🚀 Getting Started

1. Clone this repo

   git clone https://github.com/yourusername/uiu-faculty-schedule-app.git
   cd uiu-faculty-schedule-app

2. Open in Browser Just double-click index.html or run with a simple server:

   python -m http.server 8080

   Then go to 👉 http://localhost:8080

---

📖 Usage

• Start typing a faculty name or code in the search bar.

• Suggestions will appear — select a faculty.

• Instantly see:

  • Personal details (designation, room, email)
  • Today’s free/busy schedule
  • Full Undergrad & Grad routines

---

📊 Example JSON Data

{
  "MdTH": {
    "code": "MdTH",
    "name": "Md. Tarek Hasan",
    "designation": "Lecturer",
    "room": "319",
    "email": "[email protected]",
    "undergrad": {
      "times": [
        "08:31 AM - 09:50 AM",
        "09:51 AM - 11:10 AM",
        "11:11 AM - 12:30 PM"
      ],
      "schedule": {
        "SAT": ["CnH", "CnH", "CSE 2216 (A): 427"],
        "SUN": ["DS 3885 (BA): 405", "CnH", "CSE 2215 (G): 308"]
      }
    },
    "grad": {
      "times": ["08:00 AM - 10:30 AM", "10:30 AM - 01:00 PM"],
      "schedule": {}
    }
  }
}

---

🤝 Contributing

We love contributions! 🎉 Whether it's reporting a bug, suggesting a feature, or improving the project, your help is welcome.

How to Contribute

1. Report Bugs

   • Open an issue describing the bug clearly. Include steps to reproduce and screenshots if possible.

2. Suggest Features

   • Open an issue with a clear description of the feature and its benefits.

3. Submit Improvements

   • Fork the repository.
   • Create a new branch: git checkout -b feature/your-feature-name
   • Make your changes and commit: git commit -m "Add your message"
   • Push to your branch: git push origin feature/your-feature-name
   • Open a pull request and explain your changes.

---

👨‍💻 Author

Md. Tashin Parvez – CSE Student & Competitive Programmer

• 🌐 GitHub
• 📖 Blog: Hashnode

---

🌐 Contact Me

Reach out for questions, suggestions, or feedback:

🏆 Competitive Programming Profiles