Academic Issue Tracking System
Overview
The Academic Issue Tracking System (AITS) was a crucial class project developed to solve a critical administrative bottleneck at Makerere University. It centralizes the reporting, routing, and resolution of student complaints replacing fragmented email chains and physical visits with a transparent digital workflow.
The Development Team (Group N)
I worked alongside a talented team of students to bring this full-stack solution to life:
| Name | Role | GitHub |
|---|---|---|
| Wangoda Francis | Lead / Dev | @WangodaFrancis667 |
| Mujuni Innocent | Developer | @innocentinnox |
| Bwanika Robert | Developer | @BwanikaRobert |
| Matsiko Ian | Developer | @IANSEZI |
| Kinda Kelsey | Developer | @kindakelsey |
| Naluyima Pauline | Developer | @Paul098ineOliver |
System Architecture
We designed a decoupled architecture to ensure scalability across multiple colleges (COCIS, CESS, CHUSS).
- Backend: Django REST Framework (DRF) handling complex role-based logic and PostgreSQL for relational data integrity.
- Frontend: A responsive React SPA (Single Page Application) using Tailwind CSS for the UI and Axios for API consumption.
- DevOps: The system is containerized with Docker and deployed on a custom VPS. We implemented CI/CD pipelines using GitHub Actions to auto-deploy on main branch commits.
Key Features
1. Role-Based Access Control (RBAC)
The system serves three distinct user types with specific permissions:
- Students: Can raise issues (missing marks, tuition queries) and track their status in real-time.
- Registrars: Act as the first line of support—they can view, resolve, or forward complex issues to specific lecturers.
- Lecturers: receive forwarded issues relevant to their specific course units for final resolution.
2. Tokenized Tracking & Audit Logs
Every issue is assigned a unique tracking token. To ensure accountability, we implemented a strict audit logging system that records every action (Create, Forward, Resolve) taken on an issue.
3. Automated Notifications
The system integrates SMTP services to send email alerts whenever an issue status changes, ensuring students aren't left in the dark.
Live Demo Credentials
You can test the live system using these demo accounts to experience the different workflows.
Student Access:
Email:
student1234@students.mak.ac.ugPassword:Student@1234
Registrar Access:
Email:
registrar567@mak.ac.ugPassword:Registrar@1234
Lecturer Access:
Email:
lecturer899@cit.ac.ugPassword:Lecturer@1234