Sanjeevkumar - Added APIs for financial summary of the Building Projects

[sanjeev30]

Description

This PR adds multiple backend APIs to provide financial data for building projects, including total costs and month-over-month percentage changes for materials, labor, and equipment. These endpoints support filtering by project type and date range to enhance project financial insights and reporting.

Implements: Financial Summary APIs for Phase 2 (WBS: FinancialReporting.2.1)

Related PRS (if any):

N/A
…

Main changes explained:

• Created API for calculating the the total cost of a project ( /api/financials/project/{projectId}/total-cost )
• Created API for cost breakdown of a project ( /api/financials/project/{projectId}/costs )
• Created API for calculating month over month change for a project [current and previous months] ( /api/financials/project/{projectId}/mom-changes )
• Created API to get projects by date range ( /api/financials/projects?startDate=2025-01-01&endDate=2025-03-01 )
• Created API to get projects by their type ( /api/financials/projects?projectType=commercial )
  …

How to test:

1. check into current branch (git checkout sanjeev_phase_2_financial_summary_data_apis)
2. do npm install
3. do npm run dev to run this PR locally
4. log as admin/normal user
5. verify APIs responses

Screenshots or videos of changes:

Note:

• Make sure your local DB has relevant projects, materials, tools, and members with purchase records and logged hours.
• calculateLaborCost for the last month currently uses a placeholder. If historical data is available, this logic can be extended in a future PR.

[gopikalakshmia]

I am getting an error whenever I try to check out the branch.

Please guide me if I am doing anything wrong here.

[KH07]

Tested functioned as intended. I checked out the current branch, ran npm install, ran npm run dev, and started the frontend. Logged in and obtained token from Inspect -> Storage -> Local Storage. In the Thunder Client extension on VS Code, filled in the third row under Headers, where key is ‘Authorization’ and value is the token. Send the GET request and API is responsive.

[KH07]

I am getting an error whenever I try to check out the branch. Please guide me if I am doing anything wrong here.

I used gh pr checkout # (PR number, 1307 in this case).

[ganeshpodishetti]

While checking out to this PR, I am getting an error.

[gopikalakshmia]

Verified the changes. . Checked out the branch, logged in, and obtained the token from Inspect → Storage → Local Storage. Opened the Thunder Client extension in VS Code and The API (GET request) is working correctly

[AnthonyWeathers]

I tested all of the api routes, and received successful responses from each of them, although I had to handle the projectId differently due to testing on Postman. This PR is approved.

[jeyanthi-sm]

Superseded by PR #1595 , which resolves the merge conflict and incorporates the same work