Skip to content

aakashsharma003/Mbm-Attendance-Application

Repository files navigation

Demo Video of Project

screen-capture211.mp4

Mbm Attendance Application

😥 Tired of managing student attendance with paper and spreadsheets?

The Mbm Attendance Application is here to streamline the process!😀

Welcome to the repository.

This project is an attendance management application developed for MBM UNIVERSITY as a part of the Minor Project. The application aims to streamline the process of tracking and managing student attendance efficiently.

Features

  • User Authentication: Secure user authentication system for students and faculty members.
  • Dashboard: Intuitive dashboard for easy navigation and access to attendance-related functionalities.
  • Mark Attendance: Faculty members can mark attendance for their respective classes.
  • View Attendance: Students can view their attendance records for individual subjects.
  • Attendance Reports: Generate detailed reports of attendance for specific periods or subjects.
  • Notifications: Automated notifications for absentees and low attendance percentages.

Technologies Used

  • Frontend: HTML, CSS, JavaScript, ReactJs, vite
  • Backend: Node.js, Express.js
  • Database: MySQL
  • Authentication: JSON Web Tokens (JWT)

Prerequisites

  • Node.js (v20.11): You can use the package manager of your choice. Tests need to pass in Node 20 and 22.

Setup Instructions

  1. Clone the repository:   git clone https://github.com/aakashsharma003/Mbm-Attendance-Application.git

  2. Install dependencies: Run the below two commands in 2 different terminal

  3. backend   cd Mbm-Attendance-Application cd backend npm install

  4. frontend  cd Mbm-Attendance-Application cd frontend npm install

  5. Set up environment variables:

  • Create a `.env` file in the backend directory.
  • Add the following environment variables:
PORT=8000
DB_HOST="localhost"
DB_USERNAME="your_username"
DB_DBNAME="your_db_name"
DB_PASSWORD="your_password"
  1. Run the application:
  • run the command in both frontend & backend npm run dev
  1. Access the application backend in your browser at http://localhost:8000 & frontend at http://localhost:5173.

Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, please feel free to open an issue or submit a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Additional Notes

  • For development mode specific instructions (e.g., compiling assets, starting a development server), refer to the project documentation (if available).
  • Deployment instructions can be added if the application is designed to be deployed on a server.
  • Consider adding screenshots showcasing the application's functionalities.

Repo Activity

MBM Attendance Web