LabSIS KIT

https://github.com/iurygdeoliveira/labsis-saas-kit-v4
Admin
A starter kit for developing SaaS applications using the TALL stack (Tailwind, Alpine.js, Laravel,...
Tokens:87,106
Snippets:659
Trust Score:8.7
License:MIT
Update:9 months ago
Show doc for...
Tokens:
Raw
### Start Sail and Run Installation Script (Bash)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/01-instalacao-e-setup/instalacao-via-laravel-installer.md

Navigates into the newly created project directory, starts the Docker services using Sail in detached mode, and then executes the post-installation script 'install.php'. This script configures the application after initial setup.

```bash
cd minha-app
./vendor/bin/sail up -d
./vendor/bin/sail php install.php
```

--------------------------------

### Run Installation Script with Global PHP (Bash)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/01-instalacao-e-setup/instalacao-via-laravel-installer.md

Executes the 'install.php' script directly using a globally installed PHP interpreter. This is an alternative to using Sail for running the post-installation script, useful if Sail is not preferred or available.

```bash
php install.php
```

--------------------------------

### Install Laravel Installer and Check Version (Bash)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/01-instalacao-e-setup/instalacao-via-laravel-installer.md

Installs or updates the Laravel Installer globally using Composer and then checks its version. This is a prerequisite for using the Laravel Installer to create new projects.

```bash
composer global require laravel/installer
laravel --version
```

--------------------------------

### Create New Project with LabSis SaaS Kit (Bash)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/01-instalacao-e-setup/instalacao-via-laravel-installer.md

Creates a new Laravel project named 'minha-app' using the specified LabSis SaaS Kit v4 repository. This command utilizes the Laravel Installer with the --using flag to point to the starter kit's GitHub URL.

```bash
laravel new minha-app --using=https://github.com/iurygdeoliveira/labSIS-KIT
```

--------------------------------

### Initialize Git Versioning (Bash)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/01-instalacao-e-setup/instalacao-via-laravel-installer.md

Initializes a new Git repository in the project, stages all files, makes an initial commit, renames the default branch to 'main', sets the remote origin URL, and pushes the initial commit to the remote repository.

```bash
git init
git add .
git commit -m "chore: inicializa projeto a partir do starter kit"
git branch -M main
git remote add origin https://github.com/SEU_USUARIO/minha-app.git
git push -u origin main
```

--------------------------------

### Troubleshoot Container Not Starting

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/04-backend-e-arquitetura/mongodb-integration.md

Instructs to check the logs of the MongoDB container to diagnose issues when the container fails to start. This is a general debugging step for container-related problems.

```bash
vendor/bin/sail logs mongodb
```

--------------------------------

### Install Laravel Pulse

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/05-otimizacoes/laravel-pulse.md

Installs the Laravel Pulse package via Composer, publishes its assets, and runs database migrations. This is a foundational step for enabling application monitoring.

```bash
composer require laravel/pulse
php artisan vendor:publish --provider="Laravel\Pulse\PulseServiceProvider"
php artisan migrate
```

--------------------------------

### Initial System Setup with UserSeeder (PHP)

Source: https://context7.com/iurygdeoliveira/labsis-saas-kit-v4/llms.txt

The `UserSeeder` class is responsible for creating initial system data, including demonstration users, tenants, and configuring resource-based permissions for different roles. It provides commands for seeding the database and resetting the entire system, including migrations, assets, and tests.

```php
<?php

use Database\Seeders\UserSeeder;

// Executar seeder:
// php artisan db:seed --class=UserSeeder

// Usuários criados:
// 1. Admin (global)
//    Email: admin@labsis.dev.br
//    Senha: mudar123
//    Role: Admin (global, team_id = 0)
//    Acesso: /admin

// 2. Sicrano
//    Email: sicrano@labsis.dev.br
//    Senha: mudar123
//    Tenants: Tenant A (Owner), Tenant B (User)
//    Acesso: /user

// 3. Beltrano
//    Email: beltrano@labsis.dev.br
//    Senha: mudar123
//    Tenants: Tenant A (User), Tenant B (Owner)
//    Acesso: /user

// Permissões criadas por recurso:
$resources = ['media', 'users', 'authentication-log'];
// Cada recurso recebe: view, create, update, delete

// Atribuição de permissões:
// - Admin: todas as permissões (global)
// - Owner: todas as permissões (no tenant específico)
// - User: permissões definidas manualmente via UI

// Comando para reset completo:
// composer reset
// (executa migrate:fresh, seeders, build assets, testes)

```

--------------------------------

### Add Composer Bin to PATH (Bash)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/01-instalacao-e-setup/instalacao-via-laravel-installer.md

Adds the Composer vendor bin directory to the system's PATH environment variable. This is necessary on Linux/macOS if the 'laravel' command is not recognized after global installation.

```bash
export PATH="$HOME/.config/composer/vendor/bin:$HOME/.composer/vendor/bin:$PATH"
```

--------------------------------

### MinIO Private Bucket Setup with mc CLI

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/04-backend-e-arquitetura/gestao-de-midia.md

Commands to set up a private MinIO bucket using the `mc` command-line interface. It aliases the MinIO server, sets the 'labsis' bucket to private, and provides a note on resolving hostnames for signed URLs.

```bash
# Set up MinIO alias
mc alias set local http://minio:9000 sail password

# Set the 'labsis' bucket to private (no anonymous access)
mc anonymous set none local/labsis

# Note on host resolution for signed URLs:
# The signed URL uses the host from AWS_ENDPOINT. Ensure this host is resolvable
# in your browser (e.g., by adding an entry to /etc/hosts: 127.0.0.1 minio)

```

--------------------------------

### Testing HTTP Headers with cURL

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/content-security-policy.md

Provides command-line examples using `curl` to verify HTTP headers, specifically focusing on the Content Security Policy (CSP). This is useful for quickly checking server configurations.

```bash
# Ver todos os headers de segurança
curl -I http://localhost

# Buscar especificamente CSP
curl -I http://localhost | grep Content-Security-Policy
```

--------------------------------

### Environment Variables for S3/MinIO Storage

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/content-security-policy.md

Provides examples of environment variables (`.env` file) required for configuring S3 or MinIO storage endpoints. It shows configurations for local development (MinIO) and production environments.

```env
# .env
AWS_ENDPOINT=http://minio:9000          # Local
AWS_URL=http://localhost:9000           # Dev

# OU em produção:
AWS_ENDPOINT=https://s3.us-east-1.amazonaws.com
AWS_URL=https://cdn.seudominio.com
```

--------------------------------

### Troubleshoot 'Authentication failed' Error

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/04-backend-e-arquitetura/mongodb-integration.md

Guides on how to fix 'Authentication failed' errors by verifying that the MongoDB username and password in the .env file match those configured in the `docker-compose.yml`.

```ini
MONGODB_USERNAME=sail
MONGODB_PASSWORD=password
```

--------------------------------

### Application Information (JSON)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/08-ai-agents/laravel-boost.md

Retrieves global application information, including PHP and Laravel versions, database engine, installed packages, and available models. This is useful for understanding the application's environment.

```json
{
    "php_version": "8.5.1",
    "laravel_version": "12.46.0",
    "database_engine": "pgsql",
    "packages": [...],
    "models": ["App\\Models\\Video"]
}
```

--------------------------------

### Cache YouTube Metadata with TTL - PHP

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/05-otimizacoes/cache-e-redis.md

Example of caching YouTube video metadata using Redis. It employs `Cache::store('redis')->remember()` with a 6-hour Time To Live (TTL) to prevent repeated API calls. Cache keys are generated based on the SHA1 hash of the URL for uniqueness and easier invalidation.

```php
// Example within VideoMetadataService.php
$cachedTitle = Cache::store('redis')->remember("video:title:{$sha1Url}", now()->addHours(6), function () use ($url) {
    // Fetch title from YouTube API
    return fetchYoutubeTitle($url);
});

$cachedMetadata = Cache::store('redis')->remember("video:meta:{$sha1Url}", now()->addHours(6), function () use ($url) {
    // Fetch metadata from YouTube API
    return fetchYoutubeMetadata($url);
});
```

--------------------------------

### User Registration with Tenant Creation (PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/login-unificado.md

This PHP code handles user registration by creating a new user and a new tenant simultaneously. It sets initial user states to suspended and not approved, associates the user with the tenant, and triggers a notification event. The form includes fields for full name, unique email, password, and unique tenant name.

```php
<?php

namespace App\Filament\Pages\Auth;

use Filament\Pages\Page;

class Register extends Page
{
    protected static string $view = 'filament.pages.auth.register';

    // ... form schema and registration logic ...

    protected function handleRegistration(array $data):
    {
        // 1. Create user with suspended and not approved status
        $user = User::create([
            'name' => $data['name'],
            'email' => $data['email'],
            'password' => bcrypt($data['password']),
            'is_suspended' => true,
            'is_approved' => false,
            'email_verified_at' => null,
        ]);

        // 2. Create tenant
        $tenant = Tenant::create(['name' => $data['tenant_name']]);

        // 3. Associate user with tenant
        $user->tenants()->attach($tenant->id);

        // 4. Dispatch event
        UserRegistered::dispatch($user, $tenant);

        // 5. Show success notification
        $this->notify('success', 'Your account is pending approval.');

        return $user;
    }
}

```

--------------------------------

### Install Laravel MongoDB Package

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/04-backend-e-arquitetura/mongodb-integration.md

Installs the official MongoDB package for Laravel using Composer. This command adds the necessary dependencies to your project.

```bash
vendor/bin/sail composer require mongodb/laravel-mongodb
```

--------------------------------

### AdminPanelProvider Configuration

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/login-unificado.md

Sets up the global administrative panel. It's configured as the default panel, without tenancy, and automatically discovers resources, pages, clusters, and widgets. Access is restricted to users with the 'Admin' role.

```php
namespace App\Providers\Filament;

use Filament\Http\Middleware\Authenticate;
use Filament\Models\Contracts\Tenant;
use Filament\Panel;
use Filament\PanelProvider;
use Filament\Support\Colors\Color;
use Illuminate\Cookie\Middleware\EncryptCookies;
use Illuminate\Http\Middleware\ApplyMiddlewares;
use Illuminate\Http\Middleware\Crc32;
use Illuminate\Http\Middleware\EncryptCookies as MiddlewareEncryptCookies;
use Illuminate\Http\Middleware\FrameGuard;
use Illuminate\Session\Middleware\AuthenticateSession;
use Illuminate\Session\Middleware\StartSession;
use Illuminate\Support\Facades\Blade;
use Illuminate\Support\Facades\Config;
use Illuminate\Support\Facades\Route;
use Illuminate\Support\Str;
use Illuminate\Validation\Rules\Password;
use Illuminate\Http\Middleware\VerifyCsrfToken;

class AdminPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            ->id('admin')
            ->path('admin')
            ->default()
            ->tenant(null, false)
            ->colors([
                'primary' => Color::Sky,
            ])
            ->discoverResources(
                in: app_path('Filament/Admin/Resources'),
                for: 'App\\Filament\\Admin\\Resources'
            )
            ->discoverPages(
                in: app_path('Filament/Admin/Pages'),
                for: 'App\\Filament\\Admin\\Pages'
            )
            ->discoverWidgets(
                in: app_path('Filament/Admin/Widgets'),
                for: 'App\\Filament\\Admin\\Widgets'
            )
            ->middleware([
                EncryptCookies::class,
                AddQueuedCookiesToResponse::class,
                StartSession::class,
                AuthenticateSession::class,
                ShareErrorsFromSession::class,
                VerifyCsrfToken::class,
                SubstituteBindings::class,
                DisableFrames::class,
            ])
            ->auth(fn () => Auth::user())
            ->plugins([
                // ...
            ]);
    }
}

```

--------------------------------

### Configurando Modo Estrito para Eloquent Models (PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/04-backend-e-arquitetura/app-service-provider.md

O método configModels() dentro do boot() ativa o modo estrito do Eloquent. Isso previne o carregamento preguiçoso (lazy loading) e atribuições em massa silenciosas, melhorando a performance e a segurança da aplicação.

```php
private function configModels(): void
{
    Model::shouldBeStrict();
}
```

--------------------------------

### Perform MongoDB Queries with Eloquent

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/04-backend-e-arquitetura/mongodb-integration.md

Demonstrates how to perform basic CRUD operations and query MongoDB documents using the Eloquent model. Includes examples for creating, retrieving, and filtering documents.

```php
// Salvar documento
Log::create([
    'message' => 'User logged in',
    'level' => 'info',
    'context' => ['user_id' => 123, 'ip' => '192.168.1.1'],
]);

// Buscar documentos
$logs = Log::where('level', 'error')->get();

// Usar operadores MongoDB
$recentLogs = Log::where('created_at', '>=', now()->subDays(7))->get();
```

--------------------------------

### Exemplo de Policy Específica (MediaItemPolicy - PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/roles-e-permissions.md

Implementa a policy para `MediaItem`, herdando de uma policy base que já trata permissões de Admin e Owner. Os métodos específicos verificam permissões usando o enum `Permission`.

```php
<?php

namespace App\Policies;

use App\Enums\Permission;
use App\Models\User;

class MediaItemPolicy extends BasePolicy
{
    protected string $resource = 'media-items';

    public function viewAny(User $user): bool
    {
        return $user->hasPermissionTo(Permission::for($this->resource) . '.' . Permission::VIEW->value);
    }

    public function view(User $user): bool
    {
        return $user->hasPermissionTo(Permission::for($this->resource) . '.' . Permission::VIEW->value);
    }

    public function create(User $user): bool
    {
        return $user->hasPermissionTo(Permission::for($this->resource) . '.' . Permission::CREATE->value);
    }

    public function update(User $user): bool
    {
        return $user->hasPermissionTo(Permission::for($this->resource) . '.' . Permission::UPDATE->value);
    }

    public function delete(User $user): bool
    {
        return $user->hasPermissionTo(Permission::for($this->resource) . '.' . Permission::DELETE->value);
    }

    public function deleteAny(User $user): bool
    {
        return $user->hasPermissionTo(Permission::for($this->resource) . '.' . Permission::DELETE->value);
    }
}

```

--------------------------------

### Create a MongoDB Eloquent Model

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/04-backend-e-arquitetura/mongodb-integration.md

Defines a model for MongoDB collections, extending the `MongoDB\Laravel\Eloquent\Model`. This example shows how to specify the connection, collection name, fillable attributes, and casts for data types.

```php
<?php

namespace App\Models;

use MongoDB\Laravel\Eloquent\Model;

class Log extends Model
{
    protected $connection = 'mongodb';
    protected $collection = 'logs';

    protected $fillable = [
        'message',
        'level',
        'context',
        'created_at',
    ];

    protected function casts(): array
    {
        return [
            'context' => 'array',
            'created_at' => 'datetime',
        ];
    }
}
```

--------------------------------

### Estrutura de Policy com Verificação 'before' (PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/roles-e-permissions.md

Exemplo de estrutura para policies de autorização no Laravel, utilizando o método `before` para checar permissões de Admin global e Owner de tenant antes de delegar para métodos específicos.

```php
<?php

namespace App\Policies;

use App\Enums\RoleType;
use App\Models\User;
use App\Models\Tenant;
use Filament\Facades\Filament;
use Illuminate\Auth\Access\HandlesAuthorization;

abstract class BasePolicy
{
    use HandlesAuthorization;

    public function before(User $user): ?bool
    {
        // Admin tem acesso total
        if ($user->hasRole(RoleType::ADMIN->value)) {
            return true;
        }

        // Owner tem acesso total no tenant atual
        $currentTenant = Filament::getTenant();
        if ($currentTenant instanceof Tenant && $user->isOwnerOfTenant($currentTenant)) {
            return true;
        }

        // Deixa para os métodos específicos verificarem permissões
        return null;
    }

    // Métodos como viewAny, view, create, update, delete devem ser implementados pelas subclasses
}

```

--------------------------------

### Restart Docker Containers

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/04-backend-e-arquitetura/mongodb-integration.md

Restarts the Docker containers to ensure that the MongoDB service is properly initialized and accessible by the application. This command is useful after installing new packages or making changes to the Docker configuration.

```bash
vendor/bin/sail down
vendor/bin/sail up -d
```

--------------------------------

### UserPanelProvider Configuration

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/login-unificado.md

Configures the user panel with multi-tenancy support. It defines the tenant model, enables the tenant menu, and sets up relationships. The panel automatically discovers resources and clusters, and uses the `TeamSyncMiddleware`.

```php
namespace App\Providers\Filament;

use App\Filament\Resources\MediaResource;
use App\Filament\Resources\UserResource;
use App\Http\Middleware\RedirectToProperPanelMiddleware;
use App\Http\Middleware\TeamSyncMiddleware;
use Filament\Http\Middleware\Authenticate;
use Filament\Models\Contracts\Tenant;
use Filament\Panel;
use Filament\PanelProvider;
use Filament\Support\Colors\Color;
use Illuminate\Cookie\Middleware\EncryptCookies;
use Illuminate\Http\Middleware\ApplyMiddlewares;
use Illuminate\Http\Middleware\Crc32;
use Illuminate\Http\Middleware\EncryptCookies as MiddlewareEncryptCookies;
use Illuminate\Http\Middleware\FrameGuard;
use Illuminate\Session\Middleware\AuthenticateSession;
use Illuminate\Session\Middleware\StartSession;
use Illuminate\Support\Facades\Blade;
use Illuminate\Support\Facades\Config;
use Illuminate\Support\Facades\Route;
use Illuminate\Support\Str;
use Illuminate\Validation\Rules\Password;
use Illuminate\Http\Middleware\VerifyCsrfToken;

class UserPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            ->id('user')
            ->path('user')
            ->tenant(function (Tenant $tenant) {
                return $tenant->uuid;
            })
            ->tenantMenu(true)
            ->tenantAvatarCreation(
                fn ($tenant) => $tenant->logo_url
            )
            ->colors([
                'primary' => Color::Green,
            ])
            ->discoverResources([
                UserResource::class,
                MediaResource::class,
            ])
            ->discoverClusters(
                in: app_path('Filament/User/Clusters'),
                for: 'App\\Filament\\User\\Clusters'
            )
            ->middleware([
                EncryptCookies::class,
                AddQueuedCookiesToResponse::class,
                StartSession::class,
                AuthenticateSession::class,
                ShareErrorsFromSession::class,
                VerifyCsrfToken::class,
                SubstituteBindings::class,
                DisableFrames::class,
                RedirectToProperPanelMiddleware::class,
                TeamSyncMiddleware::class,
            ])
            ->auth(fn () => Auth::user())
            ->plugins([
                // ...
            ]);
    }
}

```

--------------------------------

### Update Footer Logo Configuration

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/03-ui-e-customizacao/customizando-logo.md

This example shows how to update the footer logo configuration in the `BasePanelProvider.php` file. It involves changing the asset path passed to the `withLogo` method of the EasyFooter plugin.

```php
->withLogo(
    asset('images/SEU_NOVO_ARQUIVO.png'), // ← Altere aqui
    'https://www.labsis.dev.br'
)
```

--------------------------------

### Define and Use Permissions with Enum

Source: https://context7.com/iurygdeoliveira/labsis-saas-kit-v4/llms.txt

Demonstrates how to define basic permissions (VIEW, CREATE, UPDATE, DELETE) using an enum and generate specific permissions for resources. It also shows how to retrieve translated labels and check user permissions.

```php
<?php

use App\Enums\Permission;

// Permissões disponíveis
Permission::VIEW;    // 'view'
Permission::CREATE;  // 'create'
Permission::UPDATE;  // 'update'
Permission::DELETE;  // 'delete'

// Obter label traduzido
echo Permission::VIEW->getLabel();   // "Visualizar"
echo Permission::CREATE->getLabel(); // "Criar"
echo Permission::UPDATE->getLabel(); // "Editar"
echo Permission::DELETE->getLabel(); // "Apagar"

// Gerar permissão para recurso específico
$mediaView = Permission::VIEW->for('media');     // "media.view"
$usersCreate = Permission::CREATE->for('users'); // "users.create"
$authLogDelete = Permission::DELETE->for('authentication-log'); // "authentication-log.delete"

// Verificar permissão do usuário
$user = auth()->user();
if ($user->can(Permission::UPDATE->for('media'))) {
    // Usuário pode editar mídias
}

// Criar todas as permissões para um recurso
$resources = ['media', 'users', 'authentication-log'];
foreach ($resources as $resource) {
    foreach (Permission::cases() as $permission) {
        \Spatie\Permission\Models\Permission::firstOrCreate([
            'name' => $permission->for($resource),
            'guard_name' => 'web',
        ]);
    }
}

```

--------------------------------

### Gerar Meta do PHPStorm com Sail

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/07-qualidade-de-codigo/03-ide-helper.md

Comando para gerar o arquivo .phpstorm.meta.php, que auxilia a IDE a entender o retorno de funções específicas do Laravel, como app() e auth().

```bash
./vendor/bin/sail php artisan ide-helper:meta
```

--------------------------------

### Add Method to Controller in PHP

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/08-ai-agents/serena.md

An example demonstrating how to add a new method to a controller semantically. This uses the `insert_after_symbol` function to append the new method after an existing one, ensuring correct placement.

```php
// Adiciona método `suspend()` após o método `update()`
insert_after_symbol("UserController/update", "
    public function suspend(User $user): RedirectResponse
    {
        $user->update(['is_suspended' => true]);
        return redirect()->back();
    }
")
```

--------------------------------

### Update Authentication Logo View

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/03-ui-e-customizacao/customizando-logo.md

This example shows how to update the Blade view for the authentication page logo if the image file name or path has changed. It demonstrates modifying the `src` attribute of the `<img>` tag.

```blade
<img src="{{ asset('images/SEU_NOVO_ARQUIVO.png') }}" alt="LabSIS" class="h-full" />
```

--------------------------------

### Clear Application Cache (Bash)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/03-ui-e-customizacao/customizando-logo.md

Command to clear the application cache. This is a crucial step after making configuration changes to ensure they are reflected. It provides options for users utilizing Sail and for those using a direct PHP installation.

```bash
./vendor/bin/sail artisan optimize:clear
```

```bash
php artisan optimize:clear
```

--------------------------------

### PHPDoc para Propriedades Computadas (PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/07-qualidade-de-codigo/01-larastan.md

Demonstração de como usar PHPDoc para declarar propriedades computadas ('@property-read') em classes PHP, auxiliando o Larastan a entender propriedades que não são diretamente definidas no modelo.

```php
/**
 * @property-read \App\Models\User|null $record
 * @property-read bool $canSuspend
 */
class ViewUser extends ViewRecord { ... }
```

--------------------------------

### Executar Análise Estática com Larastan (Bash)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/07-qualidade-de-codigo/01-larastan.md

Comando para executar a análise estática completa do projeto utilizando Larastan e PHPStan através do Sail. Pode ser direcionado para arquivos específicos para agilizar a verificação.

```bash
./vendor/bin/sail php ./vendor/bin/phpstan analyse
./vendor/bin/sail php ./vendor/bin/phpstan analyse app/Models/User.php
```

--------------------------------

### Get Active User Sessions (PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/07-database/mongodb-integration.md

Retrieves currently active user sessions that have not logged out. This is useful for monitoring real-time user activity. It relies on the `AuthenticationLog` model and its `active()` scope.

```php
// Usuários ainda logados (sem logout)
$activeSessions = AuthenticationLog::active()->get();
```

--------------------------------

### Tipos Genéricos em Relações Eloquent (PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/07-qualidade-de-codigo/01-larastan.md

Exemplo de como especificar tipos genéricos para relações Eloquent em modelos PHP usando PHPDoc, informando ao Larastan os modelos associados e o tipo de relação.

```php
/**
 * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany<\App\Models\Tenant, \App\Models\User>
 */
public function tenants(): BelongsToMany { ... }
```

--------------------------------

### Modelo de Usuário com Interfaces e Traits (PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/roles-e-permissions.md

Implementa o modelo `User` com interfaces `HasTenants` e `FilamentUser`, e o trait `HasRoles` do Spatie. Inclui métodos para verificar propriedade de tenant e atribuir roles.

```php
<?php

namespace App\Models;

use Filament\Models\Contracts\FilamentUser;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Illuminate\Database\Eloquent\Model;
use LabCorp\FilamentTenancy\Traits\HasTenants;
use Spatie\Permission\Traits\HasRoles;

class User extends Authenticatable implements FilamentUser
{
    use HasRoles, HasTenants, Notifiable;

    // ... outros atributos e métodos

    public function canAccessPanel(Panel $panel): bool
    {
        // Lógica para verificar acesso ao painel baseado em roles
        return $this->hasRole(RoleType::ADMIN->value) || $this->hasRole(RoleType::OWNER->value);
    }

    public function isOwnerOfTenant(Model $tenant): bool
    {
        // Lógica para verificar se o usuário é Owner de um tenant específico
        return $this->hasRole(RoleType::OWNER->value) && $this->tenant_id === $tenant->id;
    }

    public function isUserOfTenant(Model $tenant): bool
    {
        // Lógica para verificar se o usuário é User de um tenant específico
        return $this->hasRole(RoleType::USER->value) && $this->tenant_id === $tenant->id;
    }

    public function assignRoleInTenant(string $role, Model $tenant): void
    {
        // Lógica para atribuir role no contexto de um tenant
        $this->assignRole($role);
    }
}

```

--------------------------------

### Create MongoDB TTL Index for Auto-Deletion (JavaScript)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/07-database/mongodb-integration.md

Explains how to set up a Time-To-Live (TTL) index in MongoDB to automatically delete documents after a specified period. This is useful for managing log data retention. The example sets logs to expire after 365 days.

```javascript
// Deletar logs após 365 dias
db.authentication_log.createIndex(
    { login_at: 1 },
    { expireAfterSeconds: 31536000 } // 365 dias
);
```

--------------------------------

### User Registration with Automatic Tenant Creation

Source: https://context7.com/iurygdeoliveira/labsis-saas-kit-v4/llms.txt

Handles user registration by creating a new tenant and assigning the 'Owner' role to the user. The registration process is suspended until admin approval.

```php
<?php

use App\Filament\Pages\Auth\Register;
use App\Models\User;
use App\Models\Tenant;
use App\Events\UserRegistered;

// Formulário de registro personalizado:
// - Nome completo
// - Email
// - Senha (confirmação)
// - Nome do Tenant (organização)

// Fluxo de criação:
protected function handleRegistration(array $data): Model
{
    // 1. Criar usuário (suspenso por padrão)
    $user = User::create([
        'name' => $data['name'],
        'email' => $data['email'],
        'password' => $data['password'],
        'is_suspended' => true,  // Aguarda aprovação
        'is_approved' => false,
    ]);

    // 2. Criar tenant
    $tenant = Tenant::create([
        'name' => $data['tenant_name'],
        'is_active' => true,
    ]);

    // 3. Associar usuário ao tenant
    $user->tenants()->attach($tenant->id);

    // 4. Atribuir role Owner
    $ownerRole = Role::firstOrCreate([
        'name' => 'Owner',
        'team_id' => $tenant->id,
    ]);
    $user->rolesWithTeams()->syncWithoutDetaching([
        $ownerRole->id => ['team_id' => $tenant->id],
    ]);

    // 5. Disparar evento para notificar admin
    event(new UserRegistered($user));

    return $user;
}

// Após aprovação pelo admin:
// - is_approved = true
// - is_suspended = false
// - email_verified_at = now()
// - Evento UserApproved é disparado
// - Email de aprovação é enviado ao usuário

```

--------------------------------

### CSP Report-Only Directive Example (Text)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/content-security-policy.md

Demonstrates the use of the 'Content-Security-Policy-Report-Only' header. This directive allows for testing CSP policies without actually blocking resources. Instead, any violations are reported to the specified 'report-uri', enabling developers to refine their policies before enforcing them.

```text
Content-Security-Policy-Report-Only: ... ; report-uri /csp-violation-report
```

--------------------------------

### Manage Media Uploads and Video URLs with MediaService

Source: https://context7.com/iurygdeoliveira/labsis-saas-kit-v4/llms.txt

Explains how to use the MediaService to handle media creation from file uploads or external video URLs. It covers updating media, retrieving media URLs, internal paths, and identifying media types.

```php
<?php

use App\Services\MediaService;
use App\Models\MediaItem;
use Illuminate\Http\UploadedFile;

$mediaService = app(MediaService::class);

// Criar mídia a partir de upload de arquivo
$file = $request->file('document');
$mediaItem = $mediaService->createFromUpload(
    file: $file,
    name: 'Relatório Mensal',
    collection: 'media'
);
// Retorna MediaItem com arquivo anexado no S3

// Criar mídia a partir de URL de vídeo (YouTube)
$mediaItem = $mediaService->createFromVideoUrl(
    videoUrl: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
    name: 'Tutorial de Introdução',
    collection: 'media'
);

// Atualizar mídia existente
$updatedMedia = $mediaService->updateMedia($mediaItem, [
    'name' => 'Novo Nome do Arquivo',
    'video' => 'https://youtube.com/watch?v=xyz123', // ou null para arquivo
    'media' => $uploadedFile, // opcional: novo arquivo
]);

// Obter URL da mídia (assinada para arquivos S3)
$url = $mediaService->getMediaUrl($mediaItem);
// Para arquivos: URL temporária assinada com SigV4
// Para vídeos: URL do YouTube diretamente

// Obter caminho interno no storage
$path = $mediaService->getMediaPath($mediaItem);
// Retorna null para vídeos externos

// Identificar tipo da mídia
$type = $mediaService->getMediaType($mediaItem);
// Retorna: 'image', 'audio', 'video', 'video_url', 'document' ou 'unknown'

```

--------------------------------

### Round Input Field Borders using CSS

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/03-ui-e-customizacao/customizando-layout.md

This example shows how to apply rounded borders to all input fields within the Filament admin panel. The CSS targets the `.fi-input-wrapper` class and applies a `border-radius`. The `!important` flag may be necessary to override existing styles.

```css
/* Adicione ao final de resources/css/filament/admin/theme.css */

.fi-input-wrapper {
    border-radius: 0.75rem !important; /* 12px */
}
```

--------------------------------

### Gerar Modelos com Anotações usando Sail

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/07-qualidade-de-codigo/03-ide-helper.md

Comando para analisar o banco de dados e atualizar os PHPDocs dos modelos, adicionando anotações @property para colunas e relações. O parâmetro --nowrite gera um arquivo separado.

```bash
./vendor/bin/sail php artisan ide-helper:models --nowrite
```

--------------------------------

### Debugging Blocked Images in CSP (PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/content-security-policy.md

Provides a solution for debugging scenarios where images are blocked due to CSP restrictions. The example shows how to modify the 'img-src' directive in the PHP configuration to include the necessary domain, allowing the image to load while maintaining security.

```php
"img-src 'self' https://exemplo.com"
```

--------------------------------

### Garantir Tipagem de Record em Filament (PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/07-qualidade-de-codigo/01-larastan.md

Exemplo de como usar 'instanceof' em PHP para garantir a tipagem correta de um record em páginas do Filament, permitindo que o Larastan reconheça métodos específicos do modelo.

```php
public function afterSave(): void
{
    $record = $this->getRecord();

    if ($record instanceof \App\Models\User) {
        // Agora o Larastan sabe que $record tem o método tenants()
        $record->tenants()->sync(...);
    }
}
```

--------------------------------

### Executar Rector para Aplicação de Mudanças

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/07-qualidade-de-codigo/02-rector.md

Após revisar as alterações propostas pelo 'dry-run', este comando aplica as refatorações automaticamente no código-fonte do projeto.

```bash
./vendor/bin/sail php ./vendor/bin/rector process
```

--------------------------------

### Manual Log Deletion via Tinker (PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/07-database/mongodb-integration.md

Demonstrates how to delete authentication logs using Laravel's Tinker console. It shows examples of deleting logs older than a year and deleting all failed login attempts. This provides programmatic control over log cleanup.

```php
// Deletar logs com mais de 1 ano
AuthenticationLog::where('login_at', '<', now()->subYear())->delete();

// Deletar todos os logs falhados
AuthenticationLog::failed()->delete();
```

--------------------------------

### Configuração de Rotas Comentadas no Laravel

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/05-otimizacoes/cloudflare-page-cache.md

Exibe trechos comentados no arquivo 'bootstrap/app.php' relacionados ao carregamento de rotas de console e à rota de verificação de saúde da aplicação. Estes comentários são para referência ou limpeza.

```php
// commands: __DIR__.'/../routes/console.php',
// health: '/up',

```

--------------------------------

### Definição de Tipos de Roles com Métodos Auxiliares (PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/roles-e-permissions.md

Define um enum `RoleType` para gerenciar os tipos de roles no sistema (Admin, Owner, User). Inclui métodos estáticos para criação programática de roles associadas a tenants específicos ou roles globais.

```php
<?php

namespace App\Enums;

use Filament\Models\Contracts\Role;
use Illuminate\Database\Eloquent\Model;

enum RoleType: string
{
    case ADMIN = 'Admin';
    case OWNER = 'Owner';
    case USER = 'User';

    public static function ensureGlobalRoles(): void
    {
        // Lógica para criar role Admin global
    }

    public static function ensureOwnerRoleForTeam(Model $team): Role
    {
        // Lógica para criar role Owner para um tenant específico
    }

    public static function ensureUserRoleForTeam(Model $team): Role
    {
        // Lógica para criar role User para um tenant específico
    }
}

```

--------------------------------

### Define Global Authorization Gates in PHP

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/04-backend-e-arquitetura/app-service-provider.md

Establishes global authorization rules that are not tied to a specific model's policies. This example defines a `viewPulse` gate, restricting access to the Laravel Pulse dashboard to users who possess the 'admin' role. It demonstrates how to create custom authorization checks based on user attributes.

```php
private function configGates(): void
{
    Gate::define('viewPulse', function (AppUser $user) {
        return $user->hasRole('admin');
    });
}
```

--------------------------------

### Configurar Brisk Theme no Filament

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/03-ui-e-customizacao/customizando-layout.md

Demonstra como configurar o plugin Brisk Theme no painel Filament, com opções para usar a fonte sugerida ou desabilitá-la.

```php
// app/Providers/Filament/AdminPanelProvider.php

->plugin(BriskTheme::make()->withoutSuggestedFont())
```

```php
// Para usar a fonte padrão do Brisk Theme
->plugin(BriskTheme::make())

// Para manter a configuração atual (sem fonte sugerida)
->plugin(BriskTheme::make()->withoutSuggestedFont())
```

--------------------------------

### Use Nonce in Blade Views (Blade)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/content-security-policy.md

This example shows how to securely embed JavaScript code within Blade views by utilizing the generated CSP nonce. The nonce attribute on the script tag ensures that the inline script is only executed if it matches the nonce provided by the server, mitigating XSS risks.

```blade
<script nonce="{{ app('csp-nonce') }}">
    // Código JavaScript inline seguro
    console.log('Este script é permitido pelo CSP');
</script>
```

--------------------------------

### TeamSyncMiddleware Logic

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/login-unificado.md

This middleware is active in the 'user' panel and synchronizes permissions with the current tenant. It resolves the tenant using the route's UUID, falls back to the user's first active tenant, and sets `team_id` to 0 if no tenant is found.

```php
<?php

namespace App\Http\Middleware;

use Closure;
use Filament\Facades\Filament;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Config;
use Symfony\Component\HttpFoundation\Response;

class TeamSyncMiddleware
{
    /**
     * Handle an incoming request.
     *
     * @param  \Closure(Request): Response $next
     */
    public function handle(Request $request, Closure $next): Response
    {
        if (Filament::getCurrentPanel()->getId() !== 'user') {
            return $next($request);
        }

        $user = Auth::user();
        $tenant = $request->route('tenant'); // Assuming tenant is a route parameter

        if ($tenant && $user->can("viewAny", [
            $tenant,
            'tenant' => $tenant
        ])) {
            Config::set('spatie.laravel-multitenancy.current_tenant', $tenant);
            $user->current_tenant_id = $tenant->id;
        } else {
            $firstTenant = $user->getTenants(Filament::getPanel('user'))->first();
            if ($firstTenant) {
                Config::set('spatie.laravel-multitenancy.current_tenant', $firstTenant);
                $user->current_tenant_id = $firstTenant->id;
            } else {
                $user->current_tenant_id = 0;
            }
        }

        return $next($request);
    }
}

```

--------------------------------

### CSP Script-src Directive Examples (Text)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/content-security-policy.md

Illustrates the evolution of the 'script-src' directive in Content Security Policy. The 'Atual' (Current) version includes 'unsafe-inline' and 'unsafe-eval', which are less secure. The 'Mais seguro' (More Secure) version removes these, relying on nonces for inline scripts, which enhances security by preventing arbitrary script execution.

```text
script-src 'self' 'unsafe-inline' 'unsafe-eval'

script-src 'self' 'nonce-{random}'
```

--------------------------------

### Filament Media Infolist Action Configuration

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/04-backend-e-arquitetura/gestao-de-midia.md

Defines an 'open' action for media items in a Filament infolist. This action dynamically sets its label and icon based on the record's configuration and opens the media if a valid URL is resolved. The visibility of the action is controlled by whether a media URL is available.

```php
<?php

namespace App\Filament\Resources\Media\Schemas;

use Filament\Infolists\Components\Actions\Action;

class MediaInfolist
{
    public static function infolistSchema(): array
    {
        return [
            // Other infolist fields would go here
            Action::make('open')
                ->label(fn ($record) => self::resolveMediaActionConfig($record)['label'])
                ->icon(fn ($record) => self::resolveMediaActionConfig($record)['icon'])
                ->media(fn ($record) => self::resolveMediaActionConfig($record)['media'] ?? '#')
                ->visible(fn ($record): bool => self::resolveMediaActionConfig($record)['media'] !== null),
        ];
    }

    // Placeholder for resolveMediaActionConfig method
    protected static function resolveMediaActionConfig($record): array
    {
        // Logic to resolve media action configuration based on the record
        return ['label' => 'Open', 'icon' => 'heroicon-o-eye', 'media' => $record->getSignedMediaUrl()]; // Example
    }
}

```

--------------------------------

### Gerar Facades e Helpers Gerais com Sail

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/07-qualidade-de-codigo/03-ide-helper.md

Comando para regenerar o arquivo _ide_helper.php, que fornece definições para os Facades do Laravel. Essencial para a inteligência da IDE.

```bash
./vendor/bin/sail php artisan ide-helper:generate
```

--------------------------------

### Configurar SPA no Filament

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/requisitos/04-performance-spa_vs_mpa.md

Ativa o modo Single Page Application (SPA) para o painel Filament, otimizando a navegação ao atualizar apenas o conteúdo principal sem recarregar a página inteira.

```php
->spa()
```

--------------------------------

### Definição de Permissões do Sistema (PHP)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/roles-e-permissions.md

Define um enum `Permission` para representar as ações básicas do sistema (View, Create, Update, Delete). Possui um método `for()` para gerar permissões específicas baseadas em recursos.

```php
<?php

namespace App\Enums;

use Spatie\Permission\Contracts\Permission as PermissionContract;

enum Permission: string
{
    case VIEW = 'view';
    case CREATE = 'create';
    case UPDATE = 'update';
    case DELETE = 'delete';

    public static function for(string $resource): string
    {
        // Lógica para gerar permissão específica, ex: 'media.view'
        return sprintf('%s.%s', $resource, self::from("view")->value);
    }
}

```

--------------------------------

### Filament Panel Configuration (PHP)

Source: https://context7.com/iurygdeoliveira/labsis-saas-kit-v4/llms.txt

Centralizes common configurations for Admin and User panels using `BasePanelProvider`. It sets up shared plugins, middleware, and multi-factor authentication. Specific configurations for Admin and User panels are then extended, including tenant settings and custom middleware.

```php
<?php

use App\Providers\Filament\BasePanelProvider;
use App\Providers\Filament\AdminPanelProvider;
use App\Providers\Filament\UserPanelProvider;

// BasePanelProvider - Configurações compartilhadas:
$panel
    ->spa()
    ->databaseTransactions()
    ->profile()
    ->multiFactorAuthentication(
        AppAuthentication::make()->recoverable()
    )
    ->middleware([
        RedirectToProperPanelMiddleware::class,
        EnsureSecurityHeaders::class,
    ]);

// AdminPanelProvider - Painel administrativo global:
// Acesso: /admin
// Recursos: Tenants, Todos os usuários, Logs de autenticação
// Não possui tenant (global)
$panel->tenant(null);

// UserPanelProvider - Painel do usuário por tenant:
// Acesso: /user/{tenant-uuid}/...
// Recursos: Usuários do tenant, Mídias, Logs
// Multi-tenant habilitado:
$panel
    ->tenant(Tenant::class, slugAttribute: 'uuid')
    ->tenantMenu(true)
    ->middleware([
        TeamSyncMiddleware::class,
    ]);

```

--------------------------------

### Processo de Manipulação do Registro de Usuário (PHP - Laravel)

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/02-autenticacao-e-seguranca/fluxo-de-registro-de-novos-usuarios.md

Implementa a lógica principal para o registro de um novo usuário e tenant. Este método prepara os dados, cria o usuário e o tenant, associa-os, dispara um evento `UserRegistered` e gerencia exceções de banco de dados e genéricas.

```php
protected function handleRegistration(array $data): Model
{
    try {
        $userData = $this->prepareUserData($data);
        $tenantData = $this->prepareTenantData($data);

        $user = $this->createUser($userData);
        $tenant = $this->createTenant($tenantData);

        $this->associateUserWithTenant($user, $tenant);
        
        // Disparar evento de usuário registrado
        event(new \App\Events\UserRegistered($user));

        $this->showSuccessNotification();

        return $user;
    } catch (QueryException $e) {
        $this->handleDatabaseException($e);
        throw $e;
    } catch (Exception $e) {
        $this->handleGenericException($e);
        throw $e;
    }
}
```

--------------------------------

### Unified Login with State Checks (PHP)

Source: https://context7.com/iurygdeoliveira/labsis-saas-kit-v4/llms.txt

Customizes the Filament login process to include checks for user suspension and approval before granting access. It redirects users to appropriate pages based on their account status. Dependencies include Filament's authentication facade and custom user model methods like `isSuspended()` and `isApproved()`.

```php
<?php

use App\Filament\Pages\Auth\Login;
use Filament\Facades\Filament;

// Login customizado com verificações adicionais:
public function authenticate(): ?LoginResponse
{
    $data = $this->form->getState();
    $authGuard = Filament::auth();

    // Verificar credenciais
    $user = $authGuard->getProvider()->retrieveByCredentials(
        $this->getCredentialsFromFormData($data)
    );

    if (!$user) {
        $this->throwFailureValidationException();
    }

    // Verificar suspensão
    if ($user->isSuspended()) {
        $authGuard->login($user);
        $this->redirect(route('filament.auth.account-suspended'));
        return null;
    }

    // Verificar aprovação
    if (!$user->isApproved()) {
        $authGuard->login($user);
        $this->redirect(route('filament.auth.verification-pending'));
        return null;
    }

    // Continuar com autenticação padrão (inclui 2FA se habilitado)
    return parent::authenticate();
}

// Páginas de estado:
// - AccountSuspended: conta suspensa pelo admin
// - VerificationPending: aguardando aprovação do cadastro

```

--------------------------------

### Executar Teste de Performance SPA

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/requisitos/04-performance-spa_vs_mpa.md

Executa o teste de benchmark de performance para a configuração SPA ativada no Filament. O teste navega entre páginas, captura métricas e salva o relatório em um arquivo de log.

```bash
./vendor/bin/sail artisan test tests/Browser/Performance/SpaBenchmarkTest.php
```

--------------------------------

### Configurar Colunas Responsivas para Widgets Filament

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/03-ui-e-customizacao/widgets-filament.md

Este método permite controlar a exibição responsiva dos widgets em diferentes tamanhos de tela. Ao sobrescrever `getColumns()`, você pode definir o número de colunas para dispositivos 'sm', 'md' e 'xl', otimizando o layout.

```php
protected function getColumns(): int|array
{
    return [
        'sm' => 2,
        'md' => 3,
        'xl' => 5,
    ];
}
```

--------------------------------

### Formatar Data em Infolist do Filament com PHP

Source: https://github.com/iurygdeoliveira/labsis-saas-kit-v4/blob/main/docs/04-backend-e-arquitetura/padrao-datetime.md

Exemplo de como utilizar `AppDateTime::parse()` para formatar um campo de data (`created_at`) em uma Infolist do Filament. Garante que a data seja tratada de forma imutável antes da formatação.

```php
use App\Support\AppDateTime;

// ...

TextEntry::make('created_at')
    ->label('Criado em')
    ->formatStateUsing(fn ($state) => $state ? AppDateTime::parse($state)->format('d/m/Y H:i') : null)
```
Tokens:
Raw