🎓 Grade Hub

A Python‑based GUI application to manage student grades – built for Sierra Leone Universities, aligned with SDG 4 (Quality Education).

📌 Overview

The Grade Hub is a desktop application that helps students and lecturers work together more effectively in universities or schools accros Sierra Leone.
Lecturers can upload test (20%), assignment (15%), project (30%), and exam (35%) scores. The system automatically calculates weighted totals and letter grades. Students can log in with their ID to view their own semester‑by‑semester results.

This project was created as the final submission for the Principles of Structured Programming course. It demonstrates modular design, clean GUI logic, and real‑world problem solving.

✨ Features

For Students

• Secure login using Student ID and password
• View all personal grades organised by semester and module
• See individual marks for test, assignment, project, and exam
• Instantly see the calculated total (weighted) and letter grade (A+ to F)
• Refresh the grade table to fetch the latest updates from lecturers
• Logout safely to return to the login screen

For Lecturers

• Secure login using username and password
• Upload grades for any registered student
• Choose from 7 semesters (Semester 1 – 7).
• Choose from programs which program the student is in.
• Choose from modules which module to upload grade for.
• Enter marks for: Test (20%), Assignment (15%), Project (30%), Exam (35%)
• Preview the weighted total and letter grade before saving
• Save grade – updates the system; if a grade for the same student/semester/module exists, it is overwritten
• View all grades in the system (every student, every module) in a single table
• Refresh the grade table to see the latest saved records
• Logout safely

General & Technical Features

• Clean, modern GUI using ttkbootstrap (sandstone theme) – no terminal interaction needed
• In‑memory data storage with Python dictionaries and lists (easy to understand, no external database required)
• Structured programming – uses functions, loops, decision structures, and modular design
• Real‑world alignment – built for Universities/Colleges/Schools accross Sierra Leone
• Supports SDG 4 (Quality Education) by digitising academic records

👥 Authors

• Rayan Martin Turay
• Abdul Karim Koroma
• Foday Kamara

🌍 Real‑World Impact

• Built for Sierra Leone’s educational system
• Supports SDG 4 – Quality Education by digitising grade management, making academic records more transparent and accessible.

🧰 Technology Stack

• Language: Python 3
• GUI: tkinter + ttkbootstrap (themed widgets)
• Data storage: Python dictionaries & lists (temporary, in‑memory)
• License: MIT

📸 Screenshots

• Login Page

  

• Student Signup Page

  

• Lecturer Signup Page

  

• Lecturer Dashboard

  

• Student Dashboard

  

🚀 How to Run the Project

1. Prerequisites

Make sure you have Python 3 installed on your computer. Then install the extra library ttkbootstrap:

pip install ttkbootstrap

2. Download the code

git clone https://github.com/rayanmartynt/PROG103_STUDENT_ACADEMIC_PORTAL_GROUP2.git
cd PROG103_STUDENT_ACADEMIC_PORTAL_GROUP2
cd src

3. Run the application

python main.py