### Set up environment file Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Copies the example environment file to create the .env configuration. ```bash cp .env.example .env ``` -------------------------------- ### Run automated installation script Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Runs the automated installation script that installs Composer dependencies, sets up the environment, generates the application key, configures the database, runs migrations, installs Node.js dependencies, builds assets, and configures Herd if used. ```bash php install.php ``` -------------------------------- ### Set up environment and generate app key Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Copies the example environment file and generates a new application key. ```bash cp .env.example .env php artisan key:generate ``` -------------------------------- ### Run the development server Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Starts the Laravel development server. ```bash php artisan serve ``` -------------------------------- ### Install Composer dependencies Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Installs Composer dependencies for the project. ```bash composer install ``` -------------------------------- ### Install JavaScript dependencies Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Installs JavaScript dependencies using PNPM. ```bash pnpm install ``` -------------------------------- ### Create a new app with FilaKit CLI Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Uses the FilaKit CLI to create a new application with the ServiceDeskKit kit. Requires the FilaKit CLI to be installed globally via Composer. ```bash filakit new my-app --kit=jeffersongoncalves/servicedeskkitv4 ``` -------------------------------- ### Start Sail containers Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Starts the Laravel Sail containers in detached mode. Laravel Sail automatically handles the development server, so `php artisan serve` is not needed. ```bash ./vendor/bin/sail up -d ``` -------------------------------- ### Navigate to project directory Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Moves into the project directory after cloning. ```bash cd my-app ``` -------------------------------- ### Create a new Laravel app with ServiceDeskKit Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Creates a new Laravel application using the ServiceDeskKit starter kit with MySQL as the database. ```bash laravel new my-app --using=jeffersongoncalves/servicedeskkitv4 --database=mysql ``` -------------------------------- ### Build frontend assets Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Builds frontend assets using PNPM. ```bash pnpm run build ``` -------------------------------- ### Run database migrations Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Runs database migrations. ```bash php artisan migrate ``` -------------------------------- ### Configure config/service-desk.php settings Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Key settings in config/service-desk.php for models, ticket options, and SLA configuration. Configure the user and operator models, ticket reference prefix, default priority, max attachment size, and SLA behavior including auto-apply and near-breach warning. ```php 'models' => [ 'user' => \App\Models\User::class, // Model that creates tickets 'operator' => \App\Models\Operator::class, // Model that handles tickets ], 'ticket' => [ 'reference_prefix' => 'SD', // Ticket reference prefix (e.g., SD-00001) 'default_priority' => 'medium', // Default priority for new tickets 'max_file_size' => 10240, // Max attachment size in KB ], 'sla' => [ 'enabled' => true, 'auto_apply' => true, // Automatically apply SLA policies 'near_breach_minutes' => 30, // Warning before SLA breach ], ``` -------------------------------- ### Configure custom ports in .env Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Configures custom ports for the application, MySQL, Redis, and Mailpit to avoid conflicts with other services. ```bash # Application Port (ex: 8080) APP_PORT=8080 # MySQL Port (ex: 3306) FORWARD_DB_PORT=3306 # Redis Port (ex: 6379) FORWARD_REDIS_PORT=6379 # Mailpit Port (ex: 1025) FORWARD_MAILPIT_PORT=1025 ``` -------------------------------- ### Generate application key Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Generates the application encryption key. ```bash php artisan key:generate ``` -------------------------------- ### Toggle features with ServiceDeskPlugin fluent methods Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Toggle features per-panel using fluent methods on the plugin. Enable knowledge base, SLA, email channels, service catalog, and set navigation group. ```php ServiceDeskPlugin::make() ->knowledgeBase(true) ->sla(true) ->emailChannels(true) ->serviceCatalog(true) ->navigationGroup('Service Desk'), ``` -------------------------------- ### Attach to application container Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Attaches to the application container to run commands inside it. ```bash ./vendor/bin/sail shell ``` -------------------------------- ### Override resource in config/filament-service-desk.php Source: https://github.com/jeffersongoncalves/servicedeskkitv4/blob/main/README.md Override any resource or widget by specifying your custom class in config/filament-service-desk.php. Replace the ticket resource with your custom class. ```php 'resources' => [ 'admin' => [ 'ticket' => \App\Filament\Admin\Resources\CustomTicketResource::class, // ... ], ], ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.