Skip to content

This is a MERN stack project designed to facilitate the booking of appointments between students and teachers. The system includes functionalities for admins to manage teachers, for teachers to manage their appointments, and for students to book appointments with teachers.

Notifications You must be signed in to change notification settings

rudrax14/MERN_STACK-StudentTeacher-Booking-Appointment

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 

Repository files navigation

Student-Teacher Booking Appointment System

This is a MERN stack project designed to facilitate the booking of appointments between students and teachers. The system includes functionalities for admins to manage teachers, for teachers to manage their appointments, and for students to book appointments with teachers.

Table of Contents

Features

  • Admin management for adding, updating, and deleting teachers and approving student registrations.
  • Teacher functionalities for managing their appointment schedules, approving/cancelling appointments, sending email alerts to students, viewing messages, and viewing all appointments.
  • Student functionalities for registering, booking appointments with teachers, sending email alerts to teachers, and sending messages.

System Modules

Admin

  • Add Teacher (Name, Department, Subject, etc.)
  • Update/Delete Teacher
  • Approve Registration Student

Teacher

  • Login
  • Schedule Appointment
  • Approve/Cancel Appointment
  • Send Email Alerts to Students
  • View Messages
  • View All Appointments

Student

  • Register
  • Login
  • Book Appointment
  • Send Email Alert to Teacher
  • Send Message

Tech-Stack-Used

Frontend

vite (bundler-react)
tailwindcss (styling)
react-icons (icons)
react-router-dom (routing)
react-toastify (notify)
axios (API)

Backend

express (API)
jwt-token (token)
nodemail (MAIL)
bcrypt (encryption)

Installation

To run this project locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/rudrax14/MERN_STACK-StudentTeacher-Booking-Appointment
  2. Install backend dependencies:

    cd backend
    npm install
  3. Install frontend dependencies:

    cd frontend
    npm install
  4. Set up environment variables for the backend:

    Create a .env file in the backend directory with the following content:

    DB_URL=''
    JWT_KEY = ''
    PORT = 5000
    
    # mail integration 
    
    MAIL_HOST = smtp.gmail.com
    MAIL_USER = 'your_mail'
    MAIL_PASS = 
  5. Run the backend server:

    cd backend
    npm run dev
  6. Run the frontend server:

    cd frontend
    npm run dev
  7. Set up environment variables for frontend:

    Create a .env.local file in the frontend directory with the following content:

    VITE_BACKEND_URL='http:https://localhost:5000'

The application should now be running on http:https://localhost:5173/.

Usage

  1. Admin:

    • Log in to the admin dashboard.
    • Add, update, or delete teachers.
    • Approve student registrations.
  2. Teacher:

    • Log in to the teacher portal.
    • Schedule, approve, or cancel appointments.
    • Send email alerts to students.
    • View messages and all appointments.
  3. Student:

    • Register and log in to the student portal.
    • Book appointments with teachers.
    • Send email alerts and messages to teachers.

Screenshots

Landing Page

landingpage Dark

Student Dashboard

student dashboard dark

Teacher Dashboard

teacher d Dark

Admin Dashboard

admin

Login

Student

email: [email protected]
Password: pass123

Teacher

email: [email protected]
Password: pass123

Admin

email: [email protected]
Password: admin

Note: Don't Spam

Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository.
  2. Create your feature branch: git checkout -b feature/YourFeature
  3. Commit your changes: git commit -m 'Add some feature'
  4. Push to the branch: git push origin feature/YourFeature
  5. Open a pull request.

Thank You

Keep Coding

About

This is a MERN stack project designed to facilitate the booking of appointments between students and teachers. The system includes functionalities for admins to manage teachers, for teachers to manage their appointments, and for students to book appointments with teachers.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages