Close ticket function block

[uttahb]

Add Function block for Closing Tickets in TMS

Issue:
Create a new endpoint open_tms_close_ticket in the backend under the directory backend/open_tms_close_ticket to handle ticket closing in the Ticket Management System (TMS).

Tables:

• tickets
• ticket_revisions
• ticket_activity

Input Signature:

• Request Method: POST
• Body:

  {
    "ticket_id": "<ticket id>"
  }

• Is Authenticated: Yes

Response Signature:

• Success:

  {
    "meta": {
      "status": 200,
      "message": "Ticket closed successfully"
    }
  }

• Error in Authentication:

  {
    "meta": {
      "status": 401,
      "message": "Unauthorized access"
    },
    "errors": [
      {
        "code": "AUTH_FAILED",
        "message": "Authentication failed for the request."
      }
    ]
  }

• Error with invalid next stage or assignee data:

  {
    "meta": {
      "status": 400,
      "message": "Bad Request"
    },
    "errors": [
      {
        "code": "BAD_REQUESt",
        "message": "Next stage or assignee is invalid."
      }
    ]
  }

• Any Other Internal Error:

  {
    "meta": {
      "status": 500,
      "message": "Something went wrong."
    },
    "errors": [
      {
        "code": "INTERNAL_ERROR",
        "message": "Something went wrong."
      }
    ]
  }

Expected Workflow:

1. Authenticate the request and build the user context in the middleware.
2. Fetch the latest ticket_revision from the ticket_id
3. Validate the to stage and assignee with the available process path from current stage
4. If validated successfully update the ticket table with closed status
5. Create a new entry in the ticket_activity table with current_stage as "ticket_closed" id from stage table
6. If validation fails, send proper error message
7. Capture errors and send appropriate error messages based on the response structure to the frontend.
8. If the workflow completes successfully, send a success message as per response signature to the frontend.

[SrijanSahaySrivastava]

@uttahb Please look into my PR.

[uttahb]

@SrijanSahaySrivastava Sure, will update you.

[ittyjose]

Hey @uttahb, I would like to work on this too.

[uttahb]

Hey @ittyjose sure, please go ahead.