Skip to content

Vasu-Dev-arch/Duty-Chart

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Duty Chart Generator – GCE Salem

Automates exam duty assignment for 50+ staff across 30+ dates using 70:30 ratio, slot preferences, and designation hierarchy.

Currently Used by Government College of Engineering, Salem exam cell.
Saves 12+ hours per exam schedule.

Python Tkinter Pandas


Features

  • Modern GUI with dark/light theme toggle
  • Excel input/output (.xlsx)
  • Fuzzy name matching between staff list and preferences
  • Designation hierarchy: Professor to Assoc. Professor to Asst. Professor to A.P(Contract)
  • Flexible duty ratios: 1:3:6, 1:3:7, 1:4:8
  • 70:30 permanent:guest staff ratio enforcement
  • Slot preference enforcement with violation reporting
  • Real-time progress bar and summary
  • Modular architecture: core/, gui/, config/

Screenshots

GUI (Dark Mode) Input Selection Sample Input Sample Output
GUI Dark Mode Browse Input Input Sample Output Sample

Sample Files

File Description
SampleInput.xlsx Test input with 3 sheets: Session Strength, Staff List, Slot Preference
output.xlsx Generated duty chart with totals and violations

How to Run

# 1. Clone the repo
git clone https://github.com/YOUR_USERNAME/dutychart.git
cd dutychart

# 2. Create virtual environment
python -m venv .venv
.venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

# 4. Run the app
python main.py

Project Structure

DutyChart/
├── core/          → Business logic (parser, matcher, scheduler)
├── gui/           → Tkinter interface
├── config/        → Logging setup
├── assets/        → Logo
├── samples/       → Test input/output
├── screenshots/   → Demo images
├── main.py        → Entry point
└── requirements.txt

Tech Stack

  • Python 3.9+
  • Pandas – Data processing
  • OpenPyXL – Excel I/O
  • Tkinter – Native GUI
  • Pillow – Image handling
  • tkcalendar – Date picker

Author

Vasudevan
CSE Student, Government College of Engineering, Salem

Github | LinkedIn | Portfolio

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages