Changelog

All notable changes to this project will be documented in this file.

This project adheres to Semantic Versioning.

0.1.2 - 2026-05-09

Per-module Gettext backend (#3) — PhoenixKitCustomerSupport.Gettext owns the translation catalogues for the four admin/user sidebar tab labels registered by this module. Locale is set per-request by the parent app; this module handles msgid lookup against the active locale.
Translations for all sidebar tab msgids in en / ru / et (priv/gettext/<locale>/LC_MESSAGES/default.po).
lib/phoenix_kit_customer_support.ex — gettext_backend: PhoenixKitCustomerSupport.Gettext on every Tab.new! call (admin_tabs/0, settings_tabs/0, user_dashboard_tabs/0).
test/phoenix_kit_customer_support/i18n_test.exs — smoke test for backend wiring across all three tab callbacks and locale resolution; conditionally excluded via :requires_phoenix_kit_i18n_api when the resolved phoenix_kit predates Tab.localized_label/1.

Ticket assignment status history — assign_ticket/3 now always records a status-history row on assignment, even when the ticket status doesn't change (encoded as from == to); note text now includes the assignee's email via describe_user/1.
mix.exs — :gettext added to extra_applications and deps; priv/gettext added to package files: so catalogues ship to Hex consumers.

mix.exs — package files: narrowed from priv to priv/gettext so future priv/ content doesn't ship to Hex unintentionally.
describe_user/1 — dropped catch-all rescue that masked real DB faults inside repo().transaction/1 (Repo.get/2 already returns nil for missing rows).
test_helper.exs — psql invocation wrapped in try/rescue so the helper degrades gracefully when psql isn't on PATH.

Ticket attachment uploads (#2) — successful uploads were silently dropped because Enum.filter(&match?({:ok, _}, &1)) against consume_uploaded_entries/3 output never matched (the function unwraps {:ok, val} into bare val).
Storage error crash — returning {:error, reason} from the consume_uploaded_entries/3 callback violates the {:ok, term} | {:postpone, term} contract and crashed the LiveView.
Hang on invalid file type — errored upload entries (:not_accepted, :too_large) now get cancelled before consume_uploaded_entries/3, which previously raised on them.
KeyError after upload — file.original_name → file.original_file_name in the admin pending-files list (the schema field name; the old reference crashed the LiveView and reset pending_files).
Image classification — files were hardcoded as "document", so images never got bucket placement or thumbnail variants. Now classified via PhoenixKitCustomerSupport.Uploads.file_type_from_mime/1 from entry.client_type.

Uploads are consumed in the LiveView progress callback (auto_upload: true), so files appear in "Attached files" immediately after drop instead of staying in "Uploading…" until form submit.
Admin attachment tiles wrap in <a target="_blank" rel="noopener noreferrer"> to match user-side behaviour and click through to the original file.
Storage errors now surface in the UI via :upload_errors instead of being logged-only.
Internal: extracted PhoenixKitCustomerSupport.Uploads.consume_entry/4 and cancel_errored_entries/2 to deduplicate the upload pipeline across Web.New, Web.UserNew, and Web.UserDetails (~160 LOC removed).

Initial release of PhoenixKit Customer Support as a standalone Hex package, extracted from PhoenixKit core (>= 1.7.104).

Ticket lifecycle — open → in_progress → resolved → closed with full status-history audit trail (PhoenixKitCustomerSupport.TicketStatusHistory).
Comments and internal notes — public comments visible to ticket owners, plus agent-only internal notes gated by the customer_support_internal_notes_enabled setting.
Attachments — file uploads on tickets and comments via PhoenixKit.Modules.Storage, configurable through customer_support_attachments_enabled.
Assignment — assign tickets to support staff; assignment changes are recorded.
Reopen flow — closed tickets can be reopened by users or agents when customer_support_allow_reopen is true.
Admin LiveViews — list / new / edit / details / settings under /admin/customer-support and /admin/settings/customer-support.
User-dashboard LiveViews — list / new / details for the ticket owner under /dashboard/customer-support/tickets (routes wired by PhoenixKitWeb.Integration in core via Code.ensure_loaded? guards).
PubSub events — PhoenixKitCustomerSupport.Events exposes per-user, per-ticket, and global topics for real-time updates.
Module auto-discovery — implements PhoenixKit.Module; registered with PhoenixKit's module system at compile time, no manual router wiring required.

Key	Default	Description
`customer_support_enabled`	`false`	Enables the module globally.
`customer_support_per_page`	`20`	Tickets per page in admin and user list views.
`customer_support_comments_enabled`	`true`	Allow comments on tickets.
`customer_support_internal_notes_enabled`	`true`	Allow agent-only internal notes.
`customer_support_attachments_enabled`	`true`	Allow file attachments on tickets and comments.
`customer_support_allow_reopen`	`true`	Allow reopening of closed tickets.

PhoenixKit core's V109 migration renames the legacy keys so existing installs migrate cleanly:

Settings keys: customer_service_* → customer_support_*
Permission key (phoenix_kit_role_permissions.module_key): customer_service → customer_support
Routes: /customer-service/* → /customer-support/*
Module: PhoenixKitCustomerService → PhoenixKitCustomerSupport
Hex package: phoenix_kit_customer_support

Run mix phoenix_kit.update after upgrading core to apply V109.