A web-based system for managing Grades 9–12 student records, attendance, assessments, and exams using a marks-out-of-100 grading system aligned with Ethiopian Ministry of Education standards.
# HSMS Ethiopia - High School Management System
HSMS Ethiopia is a comprehensive, modular, and modern web-based application designed to manage the complex needs of high schools in Ethiopia. It provides a centralized platform for administrators, teachers, students, and parents to manage academic and administrative tasks efficiently.
## ✨ Features
- **User Management**: Role-based access control with pre-defined roles (Admin, Registrar, Teacher, Student).
- **Student Information System**: Complete lifecycle management of students from admission to graduation.
- **Teacher Management**: Manage teacher profiles, specializations, and assignments.
- **Attendance Tracking**: Record and monitor student attendance, with support for both manual and **biometric device integration**.
- **Assessments & Grading**: Manage quizzes, tests, and exams, and automatically calculate student grades.
- **Financial Management**: Handle fee structures, generate invoices, and track payments.
- **Multilingual Support**: Built-in support for English and Amharic, with an easily extendable language system.
- **RESTful API**: A secure, token-based (JWT) API for all major functionalities, enabling integration with mobile apps and other systems.
- **Payment Gateway Ready**: Modular integration for Ethiopian payment gateways like **Telebirr**, **CBE**, and **CBE Birr**.
- **SMS Gateway Ready**: Integrated with a modular service ready for **EthioTelecom's** SMS API to send notifications.
- **Reporting System**: Generate and export reports for attendance, academic performance, and financials.
- **Internal Communication**: Built-in messaging and notification system for seamless communication between users.
## 🛠️ Tech Stack
- **Backend**: PHP 8+
- **Database**: MySQL / MariaDB
- **Frontend**: HTML5, CSS3, JavaScript (with a modern, responsive design)
- **API**: RESTful architecture with JSON Web Tokens (JWT) for authentication.
- **PHP Dependencies**: `firebase/php-jwt` for token management (via Comp …