Koha/api/v1/swagger/definitions/ticket.yaml
Martin Renvoize dcf7688b94 Bug 31028: Add catalog concern management page to staff
This patch adds a catalog concern management page to the staff client
accessible via the cataloging home page and a new 'Pending catalog
concerns' link on the front page.

This includes added the requisit ticket_updates api endpoints and notice
triggers and templates for notifying patrons of changes to their
reported concerns.

Test plan
1) Enable the `OpacCatalogConcerns` system preference
2) Catalog concern management is tied to your users ability to edit the
   catalog, `editcatalogue`.
3) Confirm that you can see 'Catalog concerns' listed on the cataloging
   home page if you have the `editcatalogue` permission and not if you
   do not.
4) Add a new concern as an opac user.
5) Confirm that once a concern is present in the system you see a count
   of 'catalog concerns pending' on the intranet main page if you have
   the `editcatalogue` permission.
6) Click through either the cataloging home page or pending concerns
   link on the main page to view the new concerns management page.
7) Confirm the table displays as one would expect.
8) Confirm clicking on details or the concern title exposes a 'details'
   modal with the option to add an update or resolve the concern.
9) Verify that if selecting 'notify' when updateing or resolving a
   concern triggers a notice to be sent to the opac user who first
   reported the issue.

Signed-off-by: David Nind <david@davidnind.com>
Signed-off-by: Helen Oliver <HOliver@tavi-port.ac.uk>

Signed-off-by: Kyle M Hall <kyle@bywatersolutions.com>
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
2023-03-06 11:23:17 -03:00

64 lines
1.4 KiB
YAML

---
type: object
properties:
ticket_id:
type: integer
description: Internal ticket identifier
readOnly: true
reported_date:
type:
- string
- "null"
format: date-time
description: Date the ticket was reported
readOnly: true
biblio:
type:
- object
- "null"
description: The object representing the biblio the ticket is related to
readOnly: true
biblio_id:
type: integer
description: Internal identifier for the biblio the ticket is related to
title:
type: string
description: Ticket title
body:
type: string
description: Ticket details
reporter:
type:
- object
- "null"
description: The object representing the patron who reported the ticket
readOnly: true
reporter_id:
type: integer
description: Internal identifier for the patron who reported the ticket
resolver:
type:
- object
- "null"
description: The object representing the user who resolved the ticket
readOnly: true
resolver_id:
type:
- integer
- "null"
description: Internal identifier for the user who resolved the ticket
resolved_date:
type:
- string
- "null"
format: date-time
description: Date the ticket was resolved_date
updates_count:
type:
- integer
- "null"
description: Number of updates
additionalProperties: false
required:
- title
- body