Chaitanya - Material Stock Out Risk Indicator

[csk731]

Description

Implements the backend API for the "Material Stock-Out Risk Indicator" to support the frontend visualization of inventory risks.

Related PRS:

• Frontend PR: #4733

Main changes explained:

• src/controllers/bmdashboard/bmMaterialsController.js:
  • Added bmGetMaterialStockOutRisk controller function.
  • Logic:
    • Fetches all building materials and populates project/itemType details.
    • Analyzes updateRecord for the last 30 days to calculate averageDailyUsage.
    • Calculates daysUntilStockOut = stockAvailable / averageDailyUsage.
    • Sorts results in ascending order of days remaining (highest risk first).
    • Includes project filtering capability via projectIds query parameter.
• src/routes/bmdashboard/bmMaterialsRouter.js:
  • Registered the new GET route /materials/stock-out-risk pointing to the controller.

How to test:

1. Check into current branch.
2. Run npm install and start the server (npm run dev).
3. Frontend Integration Test:
   • Run the associated Frontend PR.
   • Navigate to the "Material Stock-Out Risk Indicator" on the dashboard.
   • Confirm data matches the backend response.

Screenshots or videos of changes:

• Check the Frontend PR

##Note:

• To test this, you can use the corresponding Frontend PR

[abhinav-TB]

Hi Chaitanya, I have tested this PR locally along with the frontend PR. I have left my comment here. OneCommunityGlobal/HighestGoodNetworkApp#4733 (comment)

[Anusha-Gali]

Hi Chaitanya,

I have reviewed your PR locally and the API works as expecetd.