Abbaraees / al-mudarris

Android app that streamlines student management, attendance tracking, and assessment monitoring. Add and manage student information effortlessly, take attendance with a single tap, create and score assessments, and generate insightful reports to track progress and make informed decisions.

Al-Mudarris: Manage Your Class with Ease

Welcome to the repository for Al-Mudarris, your Android app for managing student information and class performance!

What is Al-Mudarris?

Al-Mudarris is a Kotlin-based Android app built with Jetpack Compose that empowers teachers to:

• Track student information: Add, edit, and view student details like names, grades, contact information, and more.
• Manage attendance: Take attendance for individual days, view attendance reports, and analyze trends.
• Monitor assessments: Create, track, and score assessments, analyze student performance, and export results.
• Streamline class management: Efficiently manage student data, access key information at a glance, and improve teaching effectiveness.

Features:

• Student Management:
  • Add, edit, and delete students.
  • View detailed student profiles with information like name, grade, contact details, and attendance history.
  • Track individual and class-wide performance on assessments.
• Attendance Tracking:
  • Take attendance for individual days with a simple and intuitive interface.
  • Generate attendance reports for specific periods and analyze trends.
  • Export attendance data to CSV or PDF for further analysis.
• Assessment Management:
  • Create and manage various types of assessments (e.g., quizzes, tests, projects).
  • Score assessments efficiently and view individual and class-wide results.
  • Generate detailed reports with insights into student performance.
  • Export assessment data for further analysis or sharing.

Technologies Used:

• Kotlin: Modern and expressive programming language for Android development.
• Jetpack Compose: Declarative UI framework for building beautiful and responsive Android apps.
• Other Jetpack libraries: Utilize various Jetpack libraries like Room, Navigation, ViewModel, and more for efficient data management, navigation, and UI presentation.

Getting Started:

1. Clone this repository.
2. Install Android Studio and ensure you have the latest Kotlin and Jetpack Compose plugins installed.
3. Open the project in Android Studio.
4. Build and run the app on an emulator or real device.

Contributing:

We welcome contributions from the community! Please follow these guidelines for submitting pull requests:

• Fork this repository.
• Create a new branch for your feature or bug fix.
• Write clear and concise commit messages.
• Update the README file with any new features or changes.
• Submit a pull request when your changes are ready.

License:

This project is licensed under the Apache License, Version 2.0.

Contact:

For any questions or feedback, please feel free to create an issue in this repository or reach out to the maintainers directly.

We hope Al-Mudarris becomes your go-to tool for managing your class and improving your teaching experience!