Denish - get volunteers over assigned time

[Dk-21]

Description

This PR introduces a new functionality to retrieve volunteers who logged hours exceeding their committed weekly hours by 1 hour or more, while filtering out volunteers with committed hours less than 10. The changes include adding a new function getVolunteersOverAssignedTime in overviewReportHelper.js and integrating it into the API endpoint /api/reports/volunteerstats.

Summary of Changes

• Added Functionality:
  • Created getVolunteersOverAssignedTime function in overviewReportHelper.js. This function filters volunteers based on the specified criteria and integrates seamlessly with other reporting helpers.
• Updated API Controller:
  • Modified getVolunteerStatsData function in reportsController.js to call the new helper function and return its results in the API response.

---

Related PRs (if any)

This PR is based on Backend PR : Abi weekly summary reports page #1062.

---

Main Changes Explained

• File Updates:
  • overviewReportHelper.js:
    • Added getVolunteersOverAssignedTime function to compute volunteers exceeding their committed hours by 1 or more.
  • reportsController.js:
    • Integrated the new helper function into the getVolunteerStatsData endpoint, ensuring it returns the appropriate data in the API response.

---

How to Test

1. Check into the Current Branch:

   git checkout add-getVolunteersOverAssignedTime

2.Install Dependencies:

 npm install

3. Run the Application:

npm run dev

4. Login Using Postman:
   -Endpoint: POST http://localhost:4500/api/login
   -Use Owner Credentials to log in.
   -Copy the JWT token from the response and paste it into the Postman headers tab under Authorization.

5. Query the Endpoint:
   API Call:

GET http://localhost:4500/api/reports/volunteerstats?startDate=2024-05-26&endDate=2024-06-02

Screenshot

Notes

• Ensure that the date range (startDate and endDate) provided in the API query reflects a valid period with active volunteers.
• Verify that the JWT token used in Postman is from an Owner account to access restricted data.
• Feel free to include screenshots or logs to confirm the data integrity during testing.

[strallia]

Updated aggregation pipeline to use a more consistent date field and formatted the response. Everything else looks good!