Hodour
A full academic management platform for universities — attendance, grades, and recommendation letters across web, mobile, and admin
// At a glance
Problem
Universities were tracking attendance, grades, and recommendation letters manually across disconnected tools, with no single system serving students, teachers, and administrators.
Solution
Led the architecture and Spring Boot backend of an academic platform serving three clients — a teacher web app, an admin/coordinator web app, and a React Native student mobile app — covering QR/geolocation attendance, grade management, recommendation letter workflows, schedules, and absence justification, all behind a JWT-secured REST API.
// Key highlights
- →QR code + geolocation attendance tracking with real-time visualization for teachers
- →Grade management with automatic average calculation and PDF/Excel export
- →End-to-end recommendation letter workflow between students and teachers
- →Role-based hierarchy — director, department head, coordinator, teacher, student — each with tailored dashboards
- →Monorepo architecture: Spring Boot API, React web app, and React Native/Expo mobile app
// Demo // In action
Overview
Hodour is a complete academic management platform built for universities — far more than an attendance tracker, it's a centralized hub covering attendance, grades, recommendation letters, schedules, and analytics for students, teachers, and coordinators.
Architecture
A monorepo with a single Spring Boot REST API serving three clients:
- Teacher web app — React + TypeScript
- Admin/coordinator web app — React + TypeScript
- Student mobile app — React Native + Expo
The org hierarchy flows Director → Department Head → Coordinator → Teacher → Student, with permissions scoped at each level.
Tech Stack
Backend
- Spring Boot 3 (Java 17)
- MySQL 8 + Flyway migrations
- Spring Security + JWT authentication
- Redis caching
Frontend Web
- React 18 + TypeScript
- Tailwind CSS, React Query, React Router
- Recharts for analytics dashboards
Mobile
- React Native + Expo
- Expo Camera (QR scanning) + Expo Location (geolocation validation)
Key Features
- Smart attendance: dynamic QR code generation with geolocation-validated check-in, real-time visualization for teachers
- Grade management: entry, editing, and automatic average calculation, with PDF/Excel export
- Recommendation letters: end-to-end request → review → approval workflow between students and teachers
- Schedules & notifications: personalized timetables with push notifications for sessions and results
- Absence justification: document upload with an approval workflow
- Role-based dashboards: tailored views and permissions for directors, department heads, coordinators, teachers, and students
- Institutional analytics: attendance, grade, and performance reporting for administrators
My role
As Tech Lead, I owned the system architecture and the Spring Boot backend — the JWT-secured REST API, database schema and Flyway migrations, and the role/permission model shared across all three client apps.