PhoenixKitCustomerSupport

Customer support ticketing module for PhoenixKit.

Provides a full ticketing system: create tickets, track status, add comments and attachments, manage agents. Extracted from PhoenixKit core (>= 1.7.104).

Features

• Ticket lifecycle — open → in_progress → resolved → closed with full status-history audit trail
• Comments — public comments visible to ticket owners, plus agent-only internal notes
• Attachments — file uploads on tickets and comments via PhoenixKit.Modules.Storage
• Assignment — assign tickets to support staff; assignment changes are recorded
• Reopen flow — closed tickets can be reopened by users or agents (configurable)
• Admin and user LiveViews — admin pages under /admin/customer-support, user-facing pages under /dashboard/customer-support/tickets
• PubSub events — per-user, per-ticket, and global topics for real-time updates
• Auto-discovery — implements PhoenixKit.Module; PhoenixKit finds it at startup with zero config

Installation

Add to the host app's mix.exs:

{:phoenix_kit_customer_support, "~> 0.1"}

Then mix deps.get. The module appears in the admin Modules page and sidebar automatically via PhoenixKit.Module auto-discovery.

Module integration

The package registers itself with PhoenixKit's module system. No manual router wiring needed — admin routes are auto-discovered at compile time via route_module/0.

Routes

Admin routes (registered by this package via route_module/0)

Path	LiveView
/admin/customer-support	PhoenixKitCustomerSupport.Web.List
/admin/customer-support/tickets	PhoenixKitCustomerSupport.Web.List
/admin/customer-support/tickets/new	PhoenixKitCustomerSupport.Web.New
/admin/customer-support/tickets/:uuid	PhoenixKitCustomerSupport.Web.Details
/admin/customer-support/tickets/:uuid/edit	PhoenixKitCustomerSupport.Web.Edit
/admin/settings/customer-support	PhoenixKitCustomerSupport.Web.Settings

User dashboard routes (wired by PhoenixKit core via Code.ensure_loaded? guards)

Path	LiveView
/dashboard/customer-support/tickets	PhoenixKitCustomerSupport.Web.UserList
/dashboard/customer-support/tickets/new	PhoenixKitCustomerSupport.Web.UserNew
/dashboard/customer-support/tickets/:id	PhoenixKitCustomerSupport.Web.UserDetails

User-facing routes are registered by PhoenixKitWeb.Integration in the core library when this package is present — no additional router configuration is required in the host app.

Settings

The following settings keys control this module's behaviour. They are managed via the admin Settings UI (/admin/settings/customer-support) or directly via PhoenixKit.Settings.

Key	Default	Description
customer_support_enabled	false	Enables or disables the customer support module globally.
customer_support_per_page	20	Number of tickets shown per page in admin and user list views.
customer_support_comments_enabled	true	Allows users and agents to post comments on tickets.
customer_support_internal_notes_enabled	true	Enables internal (agent-only) notes on tickets.
customer_support_attachments_enabled	true	Allows file attachments to be added to tickets and comments.
customer_support_allow_reopen	true	Permits closed tickets to be reopened by users or agents.

Development

mix deps.get
mix compile
mix test