SIMSBIOHUB-891: Backend for Ticket System

[mauberti-bc]

Links to Jira Tickets

• https://apps.nrs.gov.bc.ca/int/jira/browse/SIMSBIOHUB-891

Description of Changes

• Introduces ticket tables and lifecycle support in the database.
• Adds backend APIs to create, list, view, update, change status, and delete tickets.
• Adds support for ticket comments and retrieving ticket history.
• Adds support for linking related tickets.
• Associates tickets to teams for access
• Includes seed data

API Endpoints

• POST /api/tickets
• GET /api/tickets (supports filters such as team_id, status, and pagination parameters)
• GET /api/tickets/{ticketId}
• PUT /api/tickets/{ticketId}
• DELETE /api/tickets/{ticketId}
• POST /api/tickets/{ticketId}/status
• POST /api/tickets/{ticketId}/comment
• PUT /api/tickets/{ticketId}/comment/{ticketCommentId}
• DELETE /api/tickets/{ticketId}/comment/{ticketCommentId}
• POST /api/tickets/{ticketId}/reference
• DELETE /api/tickets/{ticketId}/reference/{ticketReferenceId}

Testing Notes

• make backend to run the api and database with seed data
• In Postman, authorize as a system administrator
• Try each of the endpoints above to ensure they behave as expected

[github-actions]

OpenShift URLs for the PR Deployment:

• App Route: https://biohub-platform-app-345-a0ec71-dev.apps.silver.devops.gov.bc.ca/
• API Route: https://biohub-platform-api-345-a0ec71-dev.apps.silver.devops.gov.bc.ca/
• Pods: https://console.apps.silver.devops.gov.bc.ca/k8s/ns/a0ec71-dev/pods?name=345
• Helm Release: https://console.apps.silver.devops.gov.bc.ca/helm-releases/ns/a0ec71-dev/release/pr-345

[github-actions]

OpenShift URLs for the PR Deployment:

• App Route: https://biohub-platform-app-345-a0ec71-dev.apps.silver.devops.gov.bc.ca/
• API Route: https://biohub-platform-api-345-a0ec71-dev.apps.silver.devops.gov.bc.ca/
• Pods: https://console.apps.silver.devops.gov.bc.ca/k8s/ns/a0ec71-dev/pods?name=345
• Helm Release: https://console.apps.silver.devops.gov.bc.ca/helm-releases/ns/a0ec71-dev/release/pr-345

[dwhogan]

200 instead of 201

[dwhogan]

idempotent with ensure*, self-reference check constraint (source_ticket_id <> target_ticket_id) -> nice

slug generation using advisory locks, best I have seen to solve the age old id problem 👍

[dwhogan]

Endpoint tests
POST /api/tickets
GET /api/tickets (supports filters such as team_id, status, and pagination parameters)
GET /api/tickets/{ticketId}
PUT /api/tickets/{ticketId}
DELETE /api/tickets/{ticketId}
POST /api/tickets/{ticketId}/status
POST /api/tickets/{ticketId}/comment
PUT /api/tickets/{ticketId}/comment/{ticketCommentId}
DELETE /api/tickets/{ticketId}/comment/{ticketCommentId}
POST /api/tickets/{ticketId}/reference
DELETE /api/tickets/{ticketId}/reference/{ticketReferenceId}

the GET /api/tickets/{ticketId} after delete returns 500 instead of 404, the handler is catching the error and re-throwing iI think

[mauberti-bc]

the GET /api/tickets/{ticketId} after delete returns 500 instead of 404, the handler is catching the error and re-throwing iI think

Endpoint tests POST /api/tickets GET /api/tickets (supports filters such as team_id, status, and pagination parameters) GET /api/tickets/{ticketId} PUT /api/tickets/{ticketId} DELETE /api/tickets/{ticketId} POST /api/tickets/{ticketId}/status POST /api/tickets/{ticketId}/comment PUT /api/tickets/{ticketId}/comment/{ticketCommentId} DELETE /api/tickets/{ticketId}/comment/{ticketCommentId} POST /api/tickets/{ticketId}/reference DELETE /api/tickets/{ticketId}/reference/{ticketReferenceId}

the GET /api/tickets/{ticketId} after delete returns 500 instead of 404, the handler is catching the error and re-throwing iI think

I believe this is the pattern we have everywhere, because we throw in the repositories if row count is < 1, which would be true if the resource does not exist. We probably want to fix this everywhere at once.

Fixed here: #350

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.7% Duplication on New Code

See analysis details on SonarQube Cloud

[dwhogan]

👍