Add GET /api/v1/users/guards/{id}/score performance scoring endpoint

[ajablaza]

feat: Add GET /api/v1/users/guards/{id}/score performance scoring endpoint

Summary

Adds a new endpoint that returns a composite performance score (0–100) for a given guard, calculated from three weighted dimensions: punctuality, shift completion, and incident reports.

Endpoint

GET /api/v1/users/guards/{id}/score

---

Scoring Breakdown

Punctuality — 35 pts max

Calculated as (on-time check-ins / total shifts) * 35. A guard who checks in on time for every shift scores the full 35.

Shift Completion — 35 pts max

Calculated as (completed shifts / total shifts) * 35. Reflects reliability in seeing shifts through to the end.

Incident Reports — 30 pts max (deductions)

Starts at 30 and deducts based on incident severity:

Severity	Deduction
High	−5 pts
Medium	−2 pts
Low	−1 pt

The deduction is calculated as:
deduction = (weightedIncidentSum / totalAssigned) × 10
incidentScore = max(0, 30 − deduction)

---

Notes

• Returns a single integer score in the range 0–100
• All three components are calculated at query time from existing shift and incident report data — no score persistence needed unless caching is later deemed necessary
• Edge case: guard with no shifts yet return a default value(null)

---

Postman Testing

[uppalkrish]

Show the api running on swagger

[ajablaza]

Done @uppalkrish