Denish - New Filed Added for gettotalsummariessubmitted

[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 getTotalSummariesSubmitted 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 getTotalSummariesSubmitted 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](http://localhost:4500/api/reports/volunteerstats?startDate=2024-05-26&endDate=2024-06 02&comparisonStartDate=2024-05-18&comparisonEndDate=2024-05-25

Screenshot

Notes

• Ensure that the date range (startDate and endDate) provided in the API query reflects a valid period with active volunteers.
• Also TO Compare You need to provide the comaprison Dates as well.
• 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]

I verify that the totalSummariesSubmitted field is returned in the response and retrieving expected data.

For testing purposes, I added this data into a user profile document:

API works with and without comparison dates: