Leave Tracking System

Leave Tracking System is a web application that can be used by any used company to track and manage their workers on leave. This web application provides users with various features such as managing leave settings, approving and denying leave requests, viewing past leave requests, and many more features that can help both clients and workers to organize and automate leave requests.

Authors

• @Safal Shrestha
• @Ishan Ghimire
• @Shardul Gautam
• @Trishan Wagle
• @Suraj Khadka

Run Locally

Clone the project

  git clone git@github.com:safalshrestha02/Leave-Tracking-System.git

Go to the project directory

  cd Leave-Tracking-System

Install dependencies

  npm install

Update your environment variables

  .env

Start the server

  npm start

Documentation

Bootcamp Documentation

Project Documentation

User Manual

Tech Stack

Client: HTML , CSS , Vanilla JavaScript ,

Server: Node , Express , MongoDB

Version Control: GIT , Github

API Specifications

Client Authentication

• Authentication will be ton using JWT/cookies
  • JWT and cookie should expire in 3 days
• Register Client
  • Unique client ID
  • Unique company name
  • Password will be hashed and stored
• Client Login
  • Client can login with email and password
  • Once logged in, a token will be sent along with a cookie (jwt = xxx)
  • Plain text password will compare with stored hashed password
• Get Active Client
  • Route to get the currently logged in user (via token)
• Add Worker
  • Add Worker to your company
  • Add unique worker ID
  • Default password is set to test1234
  • Password will be hashed and stored
• Fotgot/Reset Password
  • User can request to reset password
  • A hashed token will be emailed to the users registered email address
  • A put request can be made to the generated url to reset password
  • The link/token will expire after 10 minutes
• Change Password
  • User must be logged in to change password
  • Has three fields Current Password, New Password, Confirm Password
• Delete Worker
• Logout
  • Set cookie to none (jwt = none)
• Reject Unapproved Leaves
  • If leave req goes past the current date it will change the status to rejected

Client GET APIs

• Get all Clients
  • Lists out all the client
• Get worker of Specific Client
  • Takes current logged in clients objectID
  • Lists all the workers of that client
  • Pagination, Search, Sort
• Leave History of Workers
  • Takes current logged in clients objectID
  • Lists leave request of the company's workers
  • Filter, Search
• Manage Leaves
  • Approve and reject leaves
  • Filter
• Suggest ID
  • Checks all the worker IDs of a comapany
  • Suggests IDs that are not taken
  • Suggests 5 digit number

Worker Authentication

• Authentication will be ton using JWT/cookies
  • JWT and cookie should expire in 3 days
• Worker Login
  • Worker can login with worker ID and password
  • Once logged in, a token will be sent along with a cookie (jwt = xxx)
  • Plain text password will compare with stored hashed password
• Get Active Worker
  • Route to get the currently logged in user (via token)
• Fotgot/Reset Password
  • Worker can request to reset password
  • A hashed token will be emailed to the users registered email address
  • A put request can be made to the generated url to reset password
  • The link/token will expire after 10 minutes
• Change Password
  • Worker must be logged in to change password
  • Has three fields Current Password, New Password, Confirm Password
• Logout
  • Set cookie to none (jwt = none)

Leave Requests

• Apply for Leave
  • Worker must be logged in
• Delete Leave Requests
  • Worker can delete pending and upcomming leave
• Approve Leave
  • Client must me logged in
  • Will set leave status to "Approved" or "Rejected"
• Reject Unapproved Leaves
  • If leave req goes past the current date it will change the status to rejected

Worker GET APIs

• Get all workers
  • Lists all the workers
• Get leaves of specific worker
  • Takes current logged in worker's objectID as param
  • Lists all the leave requests of the worker
  • Pagination, Filter
• Get All Leave Requests
  • Lists all the leave requests of all workers

Screenshots

• Client Side

• Worker Side

• Client Mobile

• Worker Mobile