Yu Yan - feat: add reasons array to infringements in user profile (resolves #1686, #1817)

[yany960]

Description

This PR adds a reasons array to infringements in the user profile, allowing for more robust and flexible categorization of issues such as "time not met," "missing summary," "missed video call," "late reporting," or "other."

The controller logic ensures reasons are consistently handled as a lowercased, deduplicated array with a safe default, which both improves data quality and simplifies future analytics or display logic.

Fixes #1686, #1817 (PRIORITY HIGH)
This is a redo PR:

Related PRS (if any):

PR 1686 - Original PR by Yu Yan taking over for Ujjwal
PR 1817 - Attempt to resolve merge conflicts

Main changes explained:

Added functionality to easily parse reasons for Blue Squares using a reasons array. Added the reasons array field to store multiple categorization reasons for each infringement.

• Added reasons field under infringements in userProfile model with predefined options (which can be modified as required)

  • Type: Array of Strings
  • Default: ['other']
  • Enum values: 'time not met', 'missing summary', 'missed video call', 'late reporting', 'other'

• Updated addInfringements controller logic to:

  • Accept reasons array from request body
  • Normalize values to lowercase
  • Remove duplicates
  • Filter valid enum values only
  • Default to ['other'] if empty or invalid

• Maintains backward compatibility with existing reason (single string) field

How to test:

1. Check out the current branch: feat/infringement-reasons-array
2. Run npm run build and npm start to run this PR locally
3. Send a POST request to api/userProfile/:userId/addInfringement to add an infringement

Example request body:

{
  "requestor": "<your-user-id>",
  "blueSquare": {
    "date": "2025-09-03",
    "description": "PR Testing Add Infringement",
    "reasons": ["time not met", "missing summary", "missed video call", "late reporting", "other"]
  }
}

[Anusha-Gali]

Hi Yuyan,

I tried to review your PR locally but i am unable to do so due to 403 Forbidden response.

[sonarqubecloud]

Quality Gate failed

Failed conditions
8.5% Duplication on New Code (required ≤ 3%)

See analysis details on SonarQube Cloud