# Local Change Log

This RedmineUP helpdesk plugin is maintained as local legacy code for the
installed Redmine 3.4.4 environment. Keep entries focused on local behavior,
rollback archives, and LAN test status.

## 2026-04-25 - Issue API Helpdesk Contact Include

- Purpose: let external semantic indexing keep Redmine issues as the canonical
  object while still receiving Helpdesk ticket/contact metadata.
- Touched behavior:
  - Added `include=helpdesk` support to the Redmine issue API override.
  - Added a Helpdesk issue API serializer for ticket/customer fields.
- Upgrade note: see `docs/redmine_issue_api_helpdesk_include.md` before
  updating Redmine core issue API views.
- LAN test result:
  - Deployed to `192.168.50.170` with rollback backup
    `/home/reddev/redmine-plugin-backups/helpdesk-issue-api-include-20260425T094236Z`.
  - Confirmed `/issues/39779.json?include=journals,helpdesk` returns
    `helpdesk_ticket.contact` with id, name, company, and email.

## 2026-04-21 - Helpdesk Search Read API And Outbox Coverage

- Purpose: make helpdesk ticket and message identity first-class for external
  operational search and indexing.
- Rollback archives:
  - `dist/redmine_contacts-4.1.2-local-before-helpdesk-search-20260421T215548Z.tar.gz`
  - `dist/redmine_contacts_helpdesk-3.0.9-local-before-helpdesk-search-20260421T215548Z.tar.gz`
- Touched behavior:
  - Added read-only JSON endpoints under `helpdesk_search/*`.
  - Extended the existing `view_helpdesk_tickets` permission to cover those
    endpoints.
  - Added event outbox callbacks for `HelpdeskTicket` and `JournalMessage` in
    the local `redmine_event_outbox` plugin.
- Payload policy:
  - Includes ids, direction, message id, source, and non-body address metadata.
  - Does not include full email bodies, private notes, attachment data, or BCC
    addresses.
- LAN test result: pending. Validate by creating/updating a controlled helpdesk
  ticket and journal message, then checking `event_outbox_events` and the
  `helpdesk_search/*` JSON endpoints on the LAN Redmine copy.
