README

A Filament plugin for jeffersongoncalves/laravel-service-desk that provides Admin, Agent, and User panels for complete service desk management.

Compatibility

Version	Filament	PHP	Laravel
1.x	^3.0	^8.1	^10.0

Installation

composer require jeffersongoncalves/filament-service-desk

Publish the configuration (optional):

php artisan vendor:publish --tag="filament-service-desk-config"

Usage

Admin Panel

Full management capabilities: departments, categories, tags, tickets, SLA, email channels, knowledge base, and service catalog.

use JeffersonGoncalves\FilamentServiceDesk\ServiceDeskPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ServiceDeskPlugin::make()
                ->knowledgeBase(true)
                ->sla(true)
                ->emailChannels(true)
                ->serviceCatalog(true)
                ->navigationGroup('Service Desk'),
        ]);
}

Resources: Department, Category, Tag, Canned Response, Ticket (with comments, attachments, history, watchers), SLA Policy (with targets, escalation rules), Business Hours Schedule (with time slots, holidays), Email Channel, KB Article (with versions, feedback), KB Category, Service (with form fields), Service Category.

Widgets: Service Desk Overview, SLA Compliance Chart, Tickets by Department Chart.

Agent Panel

Ticket handling and response for support agents.

use JeffersonGoncalves\FilamentServiceDesk\ServiceDeskAgentPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ServiceDeskAgentPlugin::make(),
        ]);
}

Resources: Ticket (scoped to assigned), Canned Responses (read-only).

Pages: Ticket Queue (claim unassigned tickets), Agent Dashboard.

Widgets: Agent Ticket Stats, SLA Breach Table.

User Panel

Self-service portal for end users.

use JeffersonGoncalves\FilamentServiceDesk\ServiceDeskUserPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ServiceDeskUserPlugin::make()
                ->knowledgeBase(true)
                ->serviceCatalog(true),
        ]);
}

Resources: Ticket (create/view own), Service Request (wizard with dynamic form).

Pages: Knowledge Base (search, browse, feedback).

Widgets: My Tickets Overview.

Feature Toggles

Each plugin supports fluent feature toggles:

Method	Default	Description
`knowledgeBase(bool)`	`true`	KB articles and categories
`sla(bool)`	`true`	SLA policies, targets, escalation
`emailChannels(bool)`	`true`	Email channel management
`serviceCatalog(bool)`	`true`	Service catalog and requests

Features can also be toggled globally in config/filament-service-desk.php.

Localization

Translations are provided for:

English (en)
Brazilian Portuguese (pt_BR)

Publish translations to customize:

php artisan vendor:publish --tag="filament-service-desk-translations"

Testing

composer test

Contributing

Please see CONTRIBUTING for details.

License

The MIT License (MIT). Please see License File for more information.

jeffersongoncalves / filament-service-desk

Maintainers

Details