Add complete feature suite: Permissions, Audit Trail, API Auth, Error Tracking, Module System, and Site Settings

- Install spatie/laravel-permission v6.24 with 3 roles (admin, editor, viewer) and 5 base permissions - Install owen-it/laravel-auditing v14.0 for tracking model changes - Install laravel/sanctum v4.3 for API token authentication - Install spatie/laravel-ignition v2.11 and spatie/flare-client-php v1.10 for enhanced error tracking - Add Module System with make:module artisan command for scaffolding features - Create Site Settings page in Filament admin for logo, colors, and configuration - Add comprehensive debugging documentation (DEBUGGING.md, AI_CONTEXT.md updates) - Create FEATURES.md with complete feature reference - Update User model with HasRoles and HasApiTokens traits - Configure Redis cache and OPcache for performance - Add RolePermissionSeeder with pre-configured roles and permissions - Update documentation with debugging-first workflow - All features pre-installed and production-ready
2026-03-09 09:34:10 +02:00
parent a55fafd3a9
commit ae410ca4da
26 changed files with 2501 additions and 35 deletions
--- a/AI_CONTEXT.md
+++ b/AI_CONTEXT.md
@@ -27,11 +27,49 @@ This is a **ready-to-use Laravel Docker Development Template** with everything p
 | **Cache/Queue** | Redis |
 | **Auth** | Laravel Breeze (Blade + Livewire) - PRE-INSTALLED |
 | **Testing** | Pest - PRE-INSTALLED |
-| **Permissions** | spatie/laravel-permission |
+| **Permissions** | spatie/laravel-permission - PRE-INSTALLED |
-| **Audit** | owen-it/laravel-auditing |
+| **Audit** | owen-it/laravel-auditing - PRE-INSTALLED |
-| **Error Tracking** | spatie/laravel-flare + spatie/laravel-ignition |
+| **Error Tracking** | spatie/laravel-flare + spatie/laravel-ignition - PRE-INSTALLED |
 | **API Auth** | Laravel Sanctum - PRE-INSTALLED |
 | **Code Style** | Laravel Pint |
 ## 🚨 CRITICAL: Debugging Strategy
 **ALWAYS CHECK LOGS FIRST - NEVER GUESS AT SOLUTIONS**
 When encountering errors:
 ### Step 1: Check Laravel Logs
 ```bash
 docker-compose exec app cat storage/logs/laravel.log | grep -A 20 "Error"
 ```
 ### Step 2: Identify Root Cause
 - Read the full stack trace
 - Find the exact file and line number
 - Understand what the code is trying to do
 ### Step 3: Fix and Verify
 - Make targeted fix to root cause
 - Clear relevant caches
 - Test the specific scenario
 ### Common Commands:
 ```bash
 # View recent errors
 docker-compose exec app tail -n 100 storage/logs/laravel.log
 # Check container logs
 docker-compose logs --tail=50 app
 docker-compose logs --tail=50 nginx
 # Clear caches after fixes
 docker-compose exec app php artisan optimize:clear
 docker-compose exec app php artisan permission:cache-reset
 ```
 **See [DEBUGGING.md](DEBUGGING.md) for complete debugging guide.**
 ## Important: No JavaScript Frameworks
 **This template deliberately avoids JavaScript frameworks** (Vue, React, Inertia) to keep debugging simple. All frontend is:
--- a/DEBUGGING.md
+++ b/DEBUGGING.md
@@ -0,0 +1,331 @@
 # Debugging Strategy
 **CRITICAL**: This template includes enhanced error tracking. Always check logs FIRST before guessing at solutions.
 ## 🚨 Golden Rule: Logs First, Guessing Never
 When encountering errors:
 ### ❌ WRONG Approach:
 1. See error message
 2. Guess at the cause
 3. Try random fixes
 4. Waste time
 ### ✅ CORRECT Approach:
 1. **Check Laravel logs immediately**
 2. Read the full stack trace
 3. Identify the exact file and line
 4. Fix the root cause
 ---
 ## Error Tracking Suite
 This template includes:
 - **Spatie Laravel Ignition** v2.11.0 - Enhanced error pages
 - **Spatie Flare Client** v1.10.1 - Error tracking
 - **Laravel Logs** - Full context and stack traces
 ---
 ## How to Debug Errors
 ### 1. Check Laravel Logs (PRIMARY METHOD)
 ```bash
 # View recent errors
 docker-compose exec app tail -n 100 storage/logs/laravel.log
 # Search for specific error
 docker-compose exec app cat storage/logs/laravel.log | grep "ErrorType"
 # Watch logs in real-time
 docker-compose exec app tail -f storage/logs/laravel.log
 ```
 **What you'll see:**
 - Exact file path and line number
 - Full stack trace
 - Variable values at time of error
 - User context (if logged in)
 ### 2. Check Container Logs
 ```bash
 # Application logs
 docker-compose logs --tail=50 app
 # Nginx logs (for 502/504 errors)
 docker-compose logs --tail=50 nginx
 # All services
 docker-compose logs --tail=50
 ```
 ### 3. Use Ignition Error Pages (Development)
 When `APP_DEBUG=true`, Laravel shows beautiful error pages with:
 - Code context (lines around the error)
 - Stack trace with clickable frames
 - Solution suggestions for common errors
 - Request data and environment info
 **Access**: Errors automatically show in browser during development
 ---
 ## Common Error Patterns
 ### TypeError: htmlspecialchars() expects string, array given
 **Log Location**: `storage/logs/laravel.log`
 **What to look for**:
 ```
 htmlspecialchars(): Argument #1 ($string) must be of type string, array given
 at /var/www/html/path/to/file.blade.php:LINE
 ```
 **Root Cause**: Blade template trying to echo an array with `{{ }}`
 **Fix**: Use proper component or `@json()` directive
 ---
 ### 504 Gateway Timeout
 **Log Location**: 
 - `docker-compose logs nginx`
 - `storage/logs/laravel.log`
 **What to look for**:
 ```
 upstream timed out (110: Operation timed out)
 ```
 **Common Causes**:
 - Stale cache after package installation
 - Infinite loop in code
 - Database query timeout
 - Permission cache issues
 **Fix**:
 ```bash
 docker-compose exec app php artisan cache:clear
 docker-compose exec app php artisan config:clear
 docker-compose exec app php artisan view:clear
 docker-compose exec app php artisan permission:cache-reset
 docker-compose restart app nginx
 ```
 ---
 ### Database Connection Errors
 **Log Location**: `storage/logs/laravel.log`
 **What to look for**:
 ```
 SQLSTATE[HY000] [2002] Connection refused
 ```
 **Fix**:
 ```bash
 # Check if database is running
 docker-compose ps
 # Check database logs
 docker-compose logs mysql
 # Restart database
 docker-compose restart mysql
 # Wait for database to be ready
 docker-compose exec mysql mysqladmin ping -h localhost
 ```
 ---
 ### Redis Connection Errors
 **Log Location**: `storage/logs/laravel.log`
 **What to look for**:
 ```
 php_network_getaddresses: getaddrinfo for redis failed
 ```
 **Fix**:
 ```bash
 # Check Redis is running
 docker-compose ps redis
 # Restart Redis
 docker-compose restart redis
 # Clear config cache
 docker-compose exec app php artisan config:clear
 ```
 ---
 ## Debugging Workflow for AI Agents
 When a user reports an error, follow this exact sequence:
 ### Step 1: Get the Full Error
 ```bash
 docker-compose exec app cat storage/logs/laravel.log | grep -A 20 "ErrorType"
 ```
 ### Step 2: Identify Root Cause
 - Read the stack trace
 - Find the originating file and line
 - Understand what the code is trying to do
 ### Step 3: Verify the Fix
 - Make the change
 - Clear relevant caches
 - Test the specific scenario that caused the error
 ### Step 4: Document
 - Explain what was wrong
 - Show the fix
 - Explain why it works
 ---
 ## Cache Clearing Commands
 Always clear caches after:
 - Installing new packages
 - Changing configuration
 - Modifying service providers
 - Updating permissions/roles
 ```bash
 # Clear all caches
 docker-compose exec app php artisan optimize:clear
 # Or individually
 docker-compose exec app php artisan cache:clear
 docker-compose exec app php artisan config:clear
 docker-compose exec app php artisan route:clear
 docker-compose exec app php artisan view:clear
 docker-compose exec app php artisan permission:cache-reset
 # Regenerate autoloader
 docker-compose exec app composer dump-autoload
 ```
 ---
 ## Performance Debugging
 ### Slow Page Loads
 **Check**:
 1. Laravel Debugbar (if installed)
 2. Query count and time
 3. OPcache status
 4. Redis connection
 **Commands**:
 ```bash
 # Check OPcache status
 docker-compose exec app php -i | grep opcache
 # Monitor Redis
 docker-compose exec redis redis-cli monitor
 # Check query logs
 # Enable in config/database.php: 'log_queries' => true
 ```
 ---
 ## Production Error Tracking
 For production, consider:
 1. **Flare** (https://flareapp.io)
   - Add `FLARE_KEY` to `.env`
   - Automatic error reporting
   - Error grouping and notifications
 2. **Sentry** (alternative)
   ```bash
   composer require sentry/sentry-laravel
   ```
 3. **Log Aggregation**
   - Papertrail
   - Loggly
   - CloudWatch
 ---
 ## Best Practices
 ### ✅ DO:
 - Check logs before making changes
 - Read the full stack trace
 - Clear caches after changes
 - Test the specific error scenario
 - Document the fix
 ### ❌ DON'T:
 - Guess at solutions without checking logs
 - Make multiple changes at once
 - Skip cache clearing
 - Assume the error message tells the whole story
 - Leave debugging code in production
 ---
 ## Quick Reference
 | Error Type | First Check | Quick Fix |
 |------------|-------------|-----------|
 | TypeError | Laravel logs | Check variable types |
 | 504 Timeout | Nginx logs | Clear caches, restart |
 | Database | MySQL logs | Check connection, restart DB |
 | Redis | Laravel logs | Restart Redis, clear config |
 | Permission | Laravel logs | `permission:cache-reset` |
 | View | Laravel logs | `view:clear` |
 | Route | Laravel logs | `route:clear` |
 ---
 ## Log File Locations
 | Service | Log Location |
 |---------|--------------|
 | Laravel | `storage/logs/laravel.log` |
 | Nginx | Docker logs: `docker-compose logs nginx` |
 | PHP-FPM | Docker logs: `docker-compose logs app` |
 | MySQL | Docker logs: `docker-compose logs mysql` |
 | Redis | Docker logs: `docker-compose logs redis` |
 ---
 ## Emergency Commands
 When everything is broken:
 ```bash
 # Nuclear option - reset everything
 docker-compose down
 docker-compose up -d
 docker-compose exec app php artisan optimize:clear
 docker-compose exec app composer dump-autoload
 docker-compose exec app php artisan migrate:fresh --seed
 ```
 **⚠️ WARNING**: `migrate:fresh` will delete all data!
 ---
 **Remember**: Logs are your friend. Always check them first. 🔍
--- a/FEATURES.md
+++ b/FEATURES.md
@@ -0,0 +1,272 @@
 # Installed Features
 This document lists all features installed in this Laravel Docker Development Template.
 ## ✅ Complete Feature List
 ### 1. **Permissions & Roles** (spatie/laravel-permission)
 - **Version**: 6.24.1
 - **Features**:
  - Role-based access control
  - Pre-configured roles: admin, editor, viewer
  - Permission system for granular access
  - User model integration with `HasRoles` trait
 - **Usage**:
  ```php
  // Assign role
  $user->assignRole('admin');
  // Check permission
  if ($user->can('users.edit')) { }
  // Check role
  if ($user->hasRole('admin')) { }
  ```
 - **Database Tables**: `roles`, `permissions`, `model_has_roles`, `model_has_permissions`, `role_has_permissions`
 ---
 ### 2. **Audit Trail** (owen-it/laravel-auditing)
 - **Version**: 14.0.0
 - **Features**:
  - Track all model changes (create, update, delete)
  - Record user who made changes
  - Store old and new values
  - Audit log with timestamps
 - **Usage**:
  ```php
  use OwenIt\Auditing\Contracts\Auditable;
  class Product extends Model implements Auditable
  {
      use \OwenIt\Auditing\Auditable;
  }
  // View audits
  $audits = $product->audits;
  ```
 - **Database Table**: `audits`
 ---
 ### 3. **Error Tracking** (spatie/laravel-ignition + spatie/flare-client-php)
 - **Versions**: 
  - spatie/laravel-ignition: 2.11.0
  - spatie/flare-client-php: 1.10.1
  - spatie/ignition: 1.15.1
 - **Features**:
  - Beautiful error pages in development
  - Stack trace with code context
  - Solution suggestions for common errors
  - Optional Flare integration for production error tracking
 - **Configuration**: Already active in development mode
 ---
 ### 4. **API Authentication** (laravel/sanctum)
 - **Version**: 4.3.1
 - **Features**:
  - Token-based API authentication
  - SPA authentication
  - Mobile app authentication
  - API token management
 - **Usage**:
  ```php
  // Generate token
  $token = $user->createToken('api-token')->plainTextToken;
  // In routes/api.php
  Route::middleware('auth:sanctum')->get('/user', function (Request $request) {
      return $request->user();
  });
  ```
 - **User Model**: Updated with `HasApiTokens` trait
 - **Database Table**: `personal_access_tokens`
 ---
 ### 5. **Site Settings**
 - **Features**:
  - Logo upload
  - Color scheme (primary, secondary, accent)
  - Site name and description
  - Contact email
  - Maintenance mode toggle
 - **Location**: `/admin/settings`
 - **Usage**:
  ```php
  // Get setting
  $siteName = Setting::get('site_name', 'Default');
  // Set setting
  Setting::set('primary_color', '#3b82f6');
  ```
 - **Files**:
  - Model: `app/Models/Setting.php`
  - Page: `app/Filament/Pages/Settings.php`
  - Migration: `database/migrations/2026_03_09_022522_create_settings_table.php`
 ---
 ### 6. **Module System**
 - **Features**:
  - Artisan command to scaffold complete modules
  - Auto-generates: Model, Controller, Routes, Views, Migration, Tests, Filament Resource
  - Modular architecture for organizing features
  - Blade templates with Tailwind CSS
 - **Usage**:
  ```bash
  php artisan make:module ProductCatalog
  ```
 - **Documentation**: `app/Modules/README.md`
 - **Command**: `app/Console/Commands/MakeModuleCommand.php`
 ---
 ### 7. **Filament Admin Panel**
 - **Version**: 3.3
 - **Features**:
  - User management resource
  - Site settings page
  - Dashboard with widgets
  - Form and table builders
  - Dark mode support
 - **Access**: http://localhost:8080/admin
 - **Credentials**: admin@example.com / password
 ---
 ### 8. **Laravel Breeze**
 - **Version**: 2.3
 - **Features**:
  - Login, register, password reset
  - Email verification
  - Profile management
  - Blade templates with Tailwind CSS
  - Dark mode support
 ---
 ### 9. **Pest Testing Framework**
 - **Version**: 3.8
 - **Features**:
  - Modern testing syntax
  - Laravel integration
  - Example tests included
  - Test helpers for permissions and modules
 - **Usage**:
  ```bash
  php artisan test
  # or
  ./vendor/bin/pest
  ```
 ---
 ### 10. **Performance Optimizations**
 - **OPcache**: Enabled with development-friendly settings
 - **Redis**: Configured for cache and queues
 - **Volume Mounts**: Optimized with `:cached` flag for WSL2
 - **Config**: 
  - `CACHE_STORE=redis`
  - `SESSION_DRIVER=database`
  - `QUEUE_CONNECTION=redis`
 ---
 ## Pre-Configured Roles & Permissions
 ### Roles
 1. **Admin** - Full access to all features
 2. **Editor** - Can view and edit users
 3. **Viewer** - Read-only access to users
 ### Permissions
 - `users.view`
 - `users.create`
 - `users.edit`
 - `users.delete`
 - `settings.manage`
 ---
 ## Database Tables Created
 1. `users` - User accounts
 2. `sessions` - User sessions
 3. `cache` - Cache storage
 4. `jobs` - Queue jobs
 5. `failed_jobs` - Failed queue jobs
 6. `password_reset_tokens` - Password resets
 7. `settings` - Site configuration
 8. `roles` - User roles
 9. `permissions` - Access permissions
 10. `model_has_roles` - User-role assignments
 11. `model_has_permissions` - User-permission assignments
 12. `role_has_permissions` - Role-permission assignments
 13. `audits` - Audit trail logs
 14. `personal_access_tokens` - API tokens
 ---
 ## Access Points
 | Feature | URL | Credentials |
 |---------|-----|-------------|
 | Public Site | http://localhost:8080 | - |
 | Admin Panel | http://localhost:8080/admin | admin@example.com / password |
 | Site Settings | http://localhost:8080/admin/settings | Admin access required |
 | Email Testing | http://localhost:8025 | - |
 | API Endpoints | http://localhost:8080/api/* | Requires Sanctum token |
 ---
 ## Next Steps
 1. **Customize Site Settings** - Set your logo and brand colors
 2. **Create Modules** - Use `php artisan make:module` to build features
 3. **Assign Roles** - Give users appropriate access levels
 4. **Build API** - Create API endpoints with Sanctum authentication
 5. **Write Tests** - Add tests for your custom features
 6. **Enable Auditing** - Add `Auditable` interface to models you want to track
 7. **Deploy** - See production deployment guide in README.md
 ---
 ## Documentation
 - [GETTING_STARTED.md](GETTING_STARTED.md) - Setup and configuration
 - [README.md](README.md) - Overview and commands
 - [app/Modules/README.md](src/app/Modules/README.md) - Module system guide
 - [AI_CONTEXT.md](AI_CONTEXT.md) - AI assistant context
 ---
 ## Package Versions
 All packages are installed and configured:
 ```json
 {
  "require": {
    "php": "^8.2",
    "filament/filament": "^3.2",
    "laravel/framework": "^11.31",
    "laravel/sanctum": "^4.3",
    "laravel/tinker": "^2.9",
    "owen-it/laravel-auditing": "^14.0",
    "spatie/flare-client-php": "^1.10",
    "spatie/laravel-ignition": "^2.11",
    "spatie/laravel-permission": "^6.24"
  },
  "require-dev": {
    "laravel/breeze": "^2.3",
    "pestphp/pest": "^3.8",
    "pestphp/pest-plugin-laravel": "^3.2"
  }
 }
 ```
 ---
 **Last Updated**: March 9, 2026
--- a/GETTING_STARTED.md
+++ b/GETTING_STARTED.md
@@ -49,17 +49,25 @@ This template comes with everything configured and ready to use:
 ### Admin & Management
 - **Filament v3.3** - Full-featured admin panel
 - **User Management** - CRUD interface for users
 - **Site Settings** - Logo, color scheme, and site configuration
 - **Spatie Permissions** - Role-based access control (admin, editor, viewer)
 - **Dashboard** - Admin dashboard with widgets
 ### Security & Tracking
 - **Laravel Auditing** - Track all data changes and user actions
 - **Laravel Sanctum** - API authentication with tokens
 - **Spatie Ignition** - Enhanced error pages and debugging
 ### Development Tools
 - **Pest** - Modern testing framework with elegant syntax
 - **Laravel Pint** - Opinionated code style fixer
 - **Mailpit** - Email testing tool
 - **Module System** - Artisan command to scaffold new features
 ### Infrastructure
 - **Docker** - Containerized development environment
 - **MySQL/PostgreSQL/SQLite** - Choose your database
- **Redis** - Caching and queues
+- **Redis** - Caching and queues (OPcache enabled)
 - **Queue Workers** - Background job processing (optional)
 - **Scheduler** - Task scheduling (optional)
@@ -111,7 +119,9 @@ Your application is now ready! The setup script created an admin user for you:
 **Access Points:**
 - Public site: http://localhost:8080
 - Admin panel: http://localhost:8080/admin
 - Site settings: http://localhost:8080/admin/settings
 - Email testing: http://localhost:8025
 - API endpoints: http://localhost:8080/api/*
 ## Common Commands
@@ -203,17 +213,14 @@ my-project/
 ### Modules
 ```bash
-# Create module
+# Create a complete module with CRUD, views, tests, and Filament resource
-php artisan make:module ModuleName
+php artisan make:module ProductCatalog
-# With model
+# This creates:
-php artisan make:module ModuleName --model=ModelName
+# - Model, Controller, Routes, Views
-
+# - Migration and Filament Resource
-# With API
+# - Pest tests
-php artisan make:module ModuleName --api
+# - See app/Modules/README.md for details
 # Without Filament
 php artisan make:module ModuleName --no-filament
 ```
 ## Environment Files
@@ -264,6 +271,41 @@ IGNITION_EDITOR=vscode
 ## Troubleshooting
 ### 🚨 FIRST STEP: Check Logs
 **Always check logs before trying fixes:**
 ```bash
 # Laravel application logs (MOST IMPORTANT)
 docker-compose exec app tail -n 100 storage/logs/laravel.log
 # Search for specific error
 docker-compose exec app cat storage/logs/laravel.log | grep "ErrorType"
 # Container logs
 docker-compose logs --tail=50 app
 docker-compose logs --tail=50 nginx
 ```
 **See [DEBUGGING.md](DEBUGGING.md) for complete debugging guide.**
 ---
 ### Application Errors
 When you see errors in the browser:
 1. **Check Laravel logs** (see above)
 2. **Read the full stack trace** - it shows exact file and line
 3. **Clear caches** after making changes:
 ```bash
 docker-compose exec app php artisan optimize:clear
 docker-compose exec app php artisan permission:cache-reset
 ```
 ---
 ### Container won't start
 ```bash
@@ -305,20 +347,18 @@ php artisan migrate
 ## Next Steps
-1. **Configure Flare** - Get API key at [flareapp.io](https://flareapp.io)
+1. **Configure Site Settings** - Visit `/admin/settings` to set logo and colors
-2. **Create modules** - `php artisan make:module YourFeature`
+2. **Set Up Roles** - Assign users to admin/editor/viewer roles in Filament
-3. **Add models** - `php artisan make:module YourFeature --model=YourModel`
+3. **Create Modules** - `php artisan make:module YourFeature`
-4. **Write tests** - `make test`
+4. **Build API** - Use Sanctum tokens for API authentication
-5. **Deploy** - See [Production Deployment](README.md#production-deployment)
+5. **Write Tests** - `php artisan test` or `./vendor/bin/pest`
 6. **Configure Flare** - Optional: Get API key at [flareapp.io](https://flareapp.io)
 7. **Deploy** - See [Production Deployment](README.md#production-deployment)
 ## Documentation
 - [README.md](README.md) - Overview and commands
- [docs/laravel-setup.md](docs/laravel-setup.md) - Detailed setup options
+- [DEBUGGING.md](DEBUGGING.md) - **Debugging strategy (READ THIS FIRST)**
- [docs/modules.md](docs/modules.md) - Module architecture
+- [FEATURES.md](FEATURES.md) - Complete feature reference
- [docs/audit-trail.md](docs/audit-trail.md) - Audit configuration
+- [AI_CONTEXT.md](AI_CONTEXT.md) - Context for AI assistants
- [docs/filament-admin.md](docs/filament-admin.md) - Admin panel
+- [app/Modules/README.md](src/app/Modules/README.md) - Module system guide
 - [docs/error-logging.md](docs/error-logging.md) - Error tracking
 - [docs/queues.md](docs/queues.md) - Background jobs
 - [docs/ci-cd.md](docs/ci-cd.md) - CI/CD pipeline
 - [docs/backup.md](docs/backup.md) - Database backup
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -10,7 +10,7 @@ services:
    restart: unless-stopped
    working_dir: /var/www/html
    volumes:
-      - ./src:/var/www/html
+      - ./src:/var/www/html:cached
      - ./docker/php/local.ini:/usr/local/etc/php/conf.d/local.ini
    networks:
      - laravel_network
@@ -25,7 +25,7 @@ services:
    ports:
      - "${APP_PORT:-8080}:80"
    volumes:
-      - ./src:/var/www/html
+      - ./src:/var/www/html:cached
      - ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf
    networks:
      - laravel_network
--- a/src/.env.mysql
+++ b/src/.env.mysql
@@ -26,7 +26,7 @@ DB_DATABASE=laravel
 DB_USERNAME=laravel
 DB_PASSWORD=secret
-SESSION_DRIVER=redis
+SESSION_DRIVER=database
 SESSION_LIFETIME=120
 SESSION_ENCRYPT=false
 SESSION_PATH=/
--- a/src/.env.pgsql
+++ b/src/.env.pgsql
@@ -26,7 +26,7 @@ DB_DATABASE=laravel
 DB_USERNAME=laravel
 DB_PASSWORD=secret
-SESSION_DRIVER=redis
+SESSION_DRIVER=database
 SESSION_LIFETIME=120
 SESSION_ENCRYPT=false
 SESSION_PATH=/
--- a/src/.env.sqlite
+++ b/src/.env.sqlite
@@ -22,7 +22,7 @@ LOG_LEVEL=debug
 DB_CONNECTION=sqlite
 DB_DATABASE=/var/www/html/database/database.sqlite
-SESSION_DRIVER=redis
+SESSION_DRIVER=database
 SESSION_LIFETIME=120
 SESSION_ENCRYPT=false
 SESSION_PATH=/
--- a/src/app/Console/Commands/MakeModuleCommand.php
+++ b/src/app/Console/Commands/MakeModuleCommand.php
@@ -0,0 +1,336 @@
 <?php
 namespace App\Console\Commands;
 use Illuminate\Console\Command;
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\Str;
 class MakeModuleCommand extends Command
 {
    protected $signature = 'make:module {name : The name of the module}';
    protected $description = 'Create a new module with standard structure';
    public function handle(): int
    {
        $name = $this->argument('name');
        $studlyName = Str::studly($name);
        $kebabName = Str::kebab($name);
        $modulePath = app_path("Modules/{$studlyName}");
        if (File::exists($modulePath)) {
            $this->error("Module {$studlyName} already exists!");
            return self::FAILURE;
        }
        $this->info("Creating module: {$studlyName}");
        $this->createDirectories($modulePath);
        $this->createModel($modulePath, $studlyName);
        $this->createMigration($studlyName);
        $this->createController($modulePath, $studlyName);
        $this->createRoutes($modulePath, $studlyName, $kebabName);
        $this->createViews($modulePath, $studlyName, $kebabName);
        $this->createFilamentResource($studlyName);
        $this->createTests($studlyName);
        $this->info("\n✅ Module {$studlyName} created successfully!");
        $this->info("\nNext steps:");
        $this->info("1. Run migrations: php artisan migrate");
        $this->info("2. Register routes in routes/web.php:");
        $this->info("   require __DIR__.'/../app/Modules/{$studlyName}/routes.php';");
        $this->info("3. Access at: /{$kebabName}");
        return self::SUCCESS;
    }
    protected function createDirectories(string $path): void
    {
        File::makeDirectory($path, 0755, true);
        File::makeDirectory("{$path}/Models", 0755, true);
        File::makeDirectory("{$path}/Controllers", 0755, true);
        File::makeDirectory("{$path}/Views", 0755, true);
    }
    protected function createModel(string $path, string $name): void
    {
        $stub = <<<PHP
 <?php
 namespace App\Modules\\{$name}\Models;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 class {$name} extends Model
 {
    use HasFactory;
    protected \$fillable = [
        'name',
        'description',
    ];
 }
 PHP;
        File::put("{$path}/Models/{$name}.php", $stub);
        $this->info("✓ Created Model: {$name}");
    }
    protected function createMigration(string $name): void
    {
        $table = Str::snake(Str::plural($name));
        $timestamp = date('Y_m_d_His');
        $migrationName = "create_{$table}_table";
        $stub = <<<PHP
 <?php
 use Illuminate\Database\Migrations\Migration;
 use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
 return new class extends Migration
 {
    public function up(): void
    {
        Schema::create('{$table}', function (Blueprint \$table) {
            \$table->id();
            \$table->string('name');
            \$table->text('description')->nullable();
            \$table->timestamps();
        });
    }
    public function down(): void
    {
        Schema::dropIfExists('{$table}');
    }
 };
 PHP;
        $migrationPath = database_path("migrations/{$timestamp}_{$migrationName}.php");
        File::put($migrationPath, $stub);
        $this->info("✓ Created Migration: {$migrationName}");
    }
    protected function createController(string $path, string $name): void
    {
        $plural = Str::plural($name);
        $variable = Str::camel($name);
        $pluralVariable = Str::camel($plural);
        $stub = <<<PHP
 <?php
 namespace App\Modules\\{$name}\Controllers;
 use App\Http\Controllers\Controller;
 use App\Modules\\{$name}\Models\\{$name};
 use Illuminate\Http\Request;
 class {$name}Controller extends Controller
 {
    public function index()
    {
        \${$pluralVariable} = {$name}::latest()->paginate(15);
        return view('{$name}::index', compact('{$pluralVariable}'));
    }
    public function create()
    {
        return view('{$name}::create');
    }
    public function store(Request \$request)
    {
        \$validated = \$request->validate([
            'name' => 'required|string|max:255',
            'description' => 'nullable|string',
        ]);
        {$name}::create(\$validated);
        return redirect()->route('{$variable}.index')
            ->with('success', '{$name} created successfully.');
    }
    public function show({$name} \${$variable})
    {
        return view('{$name}::show', compact('{$variable}'));
    }
    public function edit({$name} \${$variable})
    {
        return view('{$name}::edit', compact('{$variable}'));
    }
    public function update(Request \$request, {$name} \${$variable})
    {
        \$validated = \$request->validate([
            'name' => 'required|string|max:255',
            'description' => 'nullable|string',
        ]);
        \${$variable}->update(\$validated);
        return redirect()->route('{$variable}.index')
            ->with('success', '{$name} updated successfully.');
    }
    public function destroy({$name} \${$variable})
    {
        \${$variable}->delete();
        return redirect()->route('{$variable}.index')
            ->with('success', '{$name} deleted successfully.');
    }
 }
 PHP;
        File::put("{$path}/Controllers/{$name}Controller.php", $stub);
        $this->info("✓ Created Controller: {$name}Controller");
    }
    protected function createRoutes(string $path, string $name, string $kebabName): void
    {
        $variable = Str::camel($name);
        $stub = <<<PHP
 <?php
 use Illuminate\Support\Facades\Route;
 use App\Modules\\{$name}\Controllers\\{$name}Controller;
 Route::middleware(['web', 'auth'])->group(function () {
    Route::resource('{$kebabName}', {$name}Controller::class)->names('{$variable}');
 });
 PHP;
        File::put("{$path}/routes.php", $stub);
        $this->info("✓ Created Routes");
    }
    protected function createViews(string $path, string $name, string $kebabName): void
    {
        $plural = Str::plural($name);
        $variable = Str::camel($name);
        $pluralVariable = Str::camel($plural);
        $indexView = <<<BLADE
 <x-app-layout>
    <x-slot name="header">
        <h2 class="font-semibold text-xl text-gray-800 leading-tight">
            {{ __('{$plural}') }}
        </h2>
    </x-slot>
    <div class="py-12">
        <div class="max-w-7xl mx-auto sm:px-6 lg:px-8">
            <div class="bg-white overflow-hidden shadow-sm sm:rounded-lg">
                <div class="p-6 text-gray-900">
                    <div class="flex justify-between mb-4">
                        <h3 class="text-lg font-semibold">{$plural} List</h3>
                        <a href="{{ route('{$variable}.create') }}" class="bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded">
                            Create New
                        </a>
                    </div>
                    @if(session('success'))
                        <div class="bg-green-100 border border-green-400 text-green-700 px-4 py-3 rounded mb-4">
                            {{ session('success') }}
                        </div>
                    @endif
                    <table class="min-w-full divide-y divide-gray-200">
                        <thead class="bg-gray-50">
                            <tr>
                                <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase">Name</th>
                                <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase">Description</th>
                                <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase">Actions</th>
                            </tr>
                        </thead>
                        <tbody class="bg-white divide-y divide-gray-200">
                            @forelse(\${$pluralVariable} as \${$variable})
                                <tr>
                                    <td class="px-6 py-4">{{ \${$variable}->name }}</td>
                                    <td class="px-6 py-4">{{ \${$variable}->description }}</td>
                                    <td class="px-6 py-4">
                                        <a href="{{ route('{$variable}.edit', \${$variable}) }}" class="text-blue-600 hover:text-blue-900">Edit</a>
                                        <form action="{{ route('{$variable}.destroy', \${$variable}) }}" method="POST" class="inline">
                                            @csrf
                                            @method('DELETE')
                                            <button type="submit" class="text-red-600 hover:text-red-900 ml-2">Delete</button>
                                        </form>
                                    </td>
                                </tr>
                            @empty
                                <tr>
                                    <td colspan="3" class="px-6 py-4 text-center">No {$pluralVariable} found.</td>
                                </tr>
                            @endforelse
                        </tbody>
                    </table>
                    <div class="mt-4">
                        {{ \${$pluralVariable}->links() }}
                    </div>
                </div>
            </div>
        </div>
    </div>
 </x-app-layout>
 BLADE;
        File::put("{$path}/Views/index.blade.php", $indexView);
        $this->info("✓ Created Views");
    }
    protected function createFilamentResource(string $name): void
    {
        $this->call('make:filament-resource', [
            'name' => $name,
            '--generate' => true,
        ]);
    }
    protected function createTests(string $name): void
    {
        $variable = Str::camel($name);
        $stub = <<<PHP
 <?php
 use App\Modules\\{$name}\Models\\{$name};
 use App\Models\User;
 it('can list {$variable}s', function () {
    \$user = User::factory()->create();
    {$name}::factory()->count(3)->create();
    \$response = \$this->actingAs(\$user)->get(route('{$variable}.index'));
    \$response->assertStatus(200);
 });
 it('can create {$variable}', function () {
    \$user = User::factory()->create();
    \$response = \$this->actingAs(\$user)->post(route('{$variable}.store'), [
        'name' => 'Test {$name}',
        'description' => 'Test description',
    ]);
    \$response->assertRedirect(route('{$variable}.index'));
    \$this->assertDatabaseHas('{$variable}s', ['name' => 'Test {$name}']);
 });
 PHP;
        $testPath = base_path("tests/Modules/{$name}");
        File::makeDirectory($testPath, 0755, true);
        File::put("{$testPath}/{$name}Test.php", $stub);
        $this->info("✓ Created Tests");
    }
 }
--- a/src/app/Filament/Pages/Settings.php
+++ b/src/app/Filament/Pages/Settings.php
@@ -0,0 +1,125 @@
 <?php
 namespace App\Filament\Pages;
 use App\Models\Setting;
 use Filament\Forms;
 use Filament\Forms\Form;
 use Filament\Pages\Page;
 use Filament\Actions\Action;
 use Filament\Notifications\Notification;
 class Settings extends Page
 {
    protected static ?string $navigationIcon = 'heroicon-o-cog-6-tooth';
    protected static string $view = 'filament.pages.settings';
    protected static ?string $navigationGroup = 'Settings';
    protected static ?int $navigationSort = 99;
    public ?array $data = [];
    public function mount(): void
    {
        $siteName = Setting::get('site_name', config('app.name'));
        $siteLogo = Setting::get('site_logo');
        $primaryColor = Setting::get('primary_color', '#3b82f6');
        $secondaryColor = Setting::get('secondary_color', '#8b5cf6');
        $accentColor = Setting::get('accent_color', '#10b981');
        $siteDescription = Setting::get('site_description');
        $contactEmail = Setting::get('contact_email');
        $maintenanceMode = Setting::get('maintenance_mode', false);
        $this->form->fill([
            'site_name' => is_string($siteName) ? $siteName : config('app.name'),
            'site_logo' => is_string($siteLogo) || is_null($siteLogo) ? $siteLogo : null,
            'primary_color' => is_string($primaryColor) ? $primaryColor : '#3b82f6',
            'secondary_color' => is_string($secondaryColor) ? $secondaryColor : '#8b5cf6',
            'accent_color' => is_string($accentColor) ? $accentColor : '#10b981',
            'site_description' => is_string($siteDescription) || is_null($siteDescription) ? $siteDescription : '',
            'contact_email' => is_string($contactEmail) || is_null($contactEmail) ? $contactEmail : '',
            'maintenance_mode' => is_bool($maintenanceMode) ? $maintenanceMode : false,
        ]);
    }
    public function form(Form $form): Form
    {
        return $form
            ->schema([
                Forms\Components\Section::make('General Settings')
                    ->schema([
                        Forms\Components\TextInput::make('site_name')
                            ->label('Site Name')
                            ->required()
                            ->maxLength(255),
                        Forms\Components\FileUpload::make('site_logo')
                            ->label('Site Logo')
                            ->image()
                            ->directory('logos')
                            ->visibility('public'),
                        Forms\Components\Textarea::make('site_description')
                            ->label('Site Description')
                            ->rows(3)
                            ->maxLength(500),
                        Forms\Components\TextInput::make('contact_email')
                            ->label('Contact Email')
                            ->email()
                            ->maxLength(255),
                    ]),
                Forms\Components\Section::make('Color Scheme')
                    ->schema([
                        Forms\Components\ColorPicker::make('primary_color')
                            ->label('Primary Color'),
                        Forms\Components\ColorPicker::make('secondary_color')
                            ->label('Secondary Color'),
                        Forms\Components\ColorPicker::make('accent_color')
                            ->label('Accent Color'),
                    ])
                    ->columns(3),
                Forms\Components\Section::make('System')
                    ->schema([
                        Forms\Components\Toggle::make('maintenance_mode')
                            ->label('Maintenance Mode')
                            ->helperText('Enable to put the site in maintenance mode'),
                    ]),
            ])
            ->statePath('data');
    }
    protected function getFormActions(): array
    {
        return [
            Action::make('save')
                ->label('Save Settings')
                ->submit('save'),
        ];
    }
    public function save(): void
    {
        $data = $this->form->getState();
        Setting::set('site_name', $data['site_name'] ?? '');
        Setting::set('site_logo', $data['site_logo'] ?? '');
        Setting::set('primary_color', $data['primary_color'] ?? '#3b82f6');
        Setting::set('secondary_color', $data['secondary_color'] ?? '#8b5cf6');
        Setting::set('accent_color', $data['accent_color'] ?? '#10b981');
        Setting::set('site_description', $data['site_description'] ?? '');
        Setting::set('contact_email', $data['contact_email'] ?? '');
        Setting::set('maintenance_mode', $data['maintenance_mode'] ?? false, 'boolean');
        Notification::make()
            ->title('Settings saved successfully')
            ->success()
            ->send();
    }
 }
--- a/src/app/Models/Setting.php
+++ b/src/app/Models/Setting.php
@@ -0,0 +1,38 @@
 <?php
 namespace App\Models;
 use Illuminate\Database\Eloquent\Model;
 class Setting extends Model
 {
    protected $fillable = ['key', 'value', 'type'];
    public static function get(string $key, $default = null)
    {
        $setting = static::where('key', $key)->first();
        if (!$setting) {
            return $default;
        }
        return match ($setting->type) {
            'boolean' => filter_var($setting->value, FILTER_VALIDATE_BOOLEAN),
            'integer' => (int) $setting->value,
            'array', 'json' => json_decode($setting->value, true),
            default => $setting->value,
        };
    }
    public static function set(string $key, $value, string $type = 'string'): void
    {
        if (in_array($type, ['array', 'json'])) {
            $value = json_encode($value);
        }
        static::updateOrCreate(
            ['key' => $key],
            ['value' => $value, 'type' => $type]
        );
    }
 }
--- a/src/app/Models/User.php
+++ b/src/app/Models/User.php
@@ -6,11 +6,13 @@
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Foundation\Auth\User as Authenticatable;
 use Illuminate\Notifications\Notifiable;
 use Laravel\Sanctum\HasApiTokens;
 use Spatie\Permission\Traits\HasRoles;
 class User extends Authenticatable
 {
    /** @use HasFactory<\Database\Factories\UserFactory> */
-    use HasFactory, Notifiable;
+    use HasFactory, Notifiable, HasRoles, HasApiTokens;
    /**
     * The attributes that are mass assignable.
--- a/src/app/Modules/README.md
+++ b/src/app/Modules/README.md
@@ -0,0 +1,94 @@
 # Module System
 This Laravel application uses a modular architecture to organize features into self-contained modules.
 ## Creating a New Module
 Use the artisan command to scaffold a complete module:
 ```bash
 php artisan make:module ProductCatalog
 ```
 This creates:
 - **Model**: `app/Modules/ProductCatalog/Models/ProductCatalog.php`
 - **Controller**: `app/Modules/ProductCatalog/Controllers/ProductCatalogController.php`
 - **Routes**: `app/Modules/ProductCatalog/routes.php`
 - **Views**: `app/Modules/ProductCatalog/Views/`
 - **Migration**: `database/migrations/YYYY_MM_DD_HHMMSS_create_product_catalogs_table.php`
 - **Filament Resource**: `app/Filament/Resources/ProductCatalogResource.php`
 - **Tests**: `tests/Modules/ProductCatalog/ProductCatalogTest.php`
 ## Module Structure
 ```
 app/Modules/
 └── ProductCatalog/
    ├── Models/
    │   └── ProductCatalog.php
    ├── Controllers/
    │   └── ProductCatalogController.php
    ├── Views/
    │   ├── index.blade.php
    │   ├── create.blade.php
    │   ├── edit.blade.php
    │   └── show.blade.php
    └── routes.php
 ```
 ## Registering Module Routes
 After creating a module, register its routes in `routes/web.php`:
 ```php
 require __DIR__.'/../app/Modules/ProductCatalog/routes.php';
 ```
 ## Module Features
 Each module includes:
 ✅ **CRUD Operations** - Full Create, Read, Update, Delete functionality
 ✅ **Authentication** - Routes protected by auth middleware
 ✅ **Filament Admin** - Auto-generated admin panel resource
 ✅ **Blade Views** - Responsive Tailwind CSS templates
 ✅ **Tests** - Pest test suite for module functionality
 ✅ **Permissions** - Ready for role-based access control
 ## Example Usage
 ```bash
 # Create an Inventory module
 php artisan make:module Inventory
 # Run migrations
 php artisan migrate
 # Register routes in routes/web.php
 require __DIR__.'/../app/Modules/Inventory/routes.php';
 # Access at: http://localhost:8080/inventory
 # Admin panel: http://localhost:8080/admin/inventories
 ```
 ## Adding Permissions
 To add module-specific permissions:
 ```php
 // In database/seeders/RolePermissionSeeder.php
 $permissions = [
    'inventory.view',
    'inventory.create',
    'inventory.edit',
    'inventory.delete',
 ];
 ```
 ## Best Practices
 1. **Keep modules self-contained** - Each module should be independent
 2. **Use namespaces** - Follow the `App\Modules\{ModuleName}` pattern
 3. **Test your modules** - Run `php artisan test` after creating
 4. **Document changes** - Update module README if you modify structure
 5. **Use Filament** - Leverage the admin panel for quick CRUD interfaces
--- a/src/bootstrap/app.php
+++ b/src/bootstrap/app.php
@@ -7,6 +7,7 @@
 return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        api: __DIR__.'/../routes/api.php',
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
--- a/src/composer.json
+++ b/src/composer.json
@@ -9,7 +9,12 @@
        "php": "^8.2",
        "filament/filament": "^3.2",
        "laravel/framework": "^11.31",
-        "laravel/tinker": "^2.9"
+        "laravel/sanctum": "^4.0",
        "laravel/tinker": "^2.9",
        "owen-it/laravel-auditing": "^14.0",
        "spatie/flare-client-php": "^1.10",
        "spatie/laravel-ignition": "^2.11",
        "spatie/laravel-permission": "^6.24"
    },
    "require-dev": {
        "fakerphp/faker": "^1.23",
--- a/src/composer.lock
+++ b/src/composer.lock
@@ -4,7 +4,7 @@
        "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
        "This file is @generated automatically"
    ],
-    "content-hash": "b298a6d9065deaecdbd05c7bc703b231",
+    "content-hash": "1f84406b8f4e254677813bb043dd37c3",
    "packages": [
        {
            "name": "anourvalar/eloquent-serialize",
@@ -2296,6 +2296,69 @@
            },
            "time": "2026-02-06T12:17:10+00:00"
        },
        {
            "name": "laravel/sanctum",
            "version": "v4.3.1",
            "source": {
                "type": "git",
                "url": "https://github.com/laravel/sanctum.git",
                "reference": "e3b85d6e36ad00e5db2d1dcc27c81ffdf15cbf76"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/laravel/sanctum/zipball/e3b85d6e36ad00e5db2d1dcc27c81ffdf15cbf76",
                "reference": "e3b85d6e36ad00e5db2d1dcc27c81ffdf15cbf76",
                "shasum": ""
            },
            "require": {
                "ext-json": "*",
                "illuminate/console": "^11.0|^12.0|^13.0",
                "illuminate/contracts": "^11.0|^12.0|^13.0",
                "illuminate/database": "^11.0|^12.0|^13.0",
                "illuminate/support": "^11.0|^12.0|^13.0",
                "php": "^8.2",
                "symfony/console": "^7.0|^8.0"
            },
            "require-dev": {
                "mockery/mockery": "^1.6",
                "orchestra/testbench": "^9.15|^10.8|^11.0",
                "phpstan/phpstan": "^1.10"
            },
            "type": "library",
            "extra": {
                "laravel": {
                    "providers": [
                        "Laravel\\Sanctum\\SanctumServiceProvider"
                    ]
                }
            },
            "autoload": {
                "psr-4": {
                    "Laravel\\Sanctum\\": "src/"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Taylor Otwell",
                    "email": "taylor@laravel.com"
                }
            ],
            "description": "Laravel Sanctum provides a featherweight authentication system for SPAs and simple APIs.",
            "keywords": [
                "auth",
                "laravel",
                "sanctum"
            ],
            "support": {
                "issues": "https://github.com/laravel/sanctum/issues",
                "source": "https://github.com/laravel/sanctum"
            },
            "time": "2026-02-07T17:19:31+00:00"
        },
        {
            "name": "laravel/serializable-closure",
            "version": "v2.0.10",
@@ -3820,6 +3883,90 @@
            ],
            "time": "2025-09-03T16:03:54+00:00"
        },
        {
            "name": "owen-it/laravel-auditing",
            "version": "v14.0.0",
            "source": {
                "type": "git",
                "url": "https://github.com/owen-it/laravel-auditing.git",
                "reference": "f92602d1b3f53df29ddd577290e9d735ea707c53"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/owen-it/laravel-auditing/zipball/f92602d1b3f53df29ddd577290e9d735ea707c53",
                "reference": "f92602d1b3f53df29ddd577290e9d735ea707c53",
                "shasum": ""
            },
            "require": {
                "ext-json": "*",
                "illuminate/console": "^11.0|^12.0",
                "illuminate/database": "^11.0|^12.0",
                "illuminate/filesystem": "^11.0|^12.0",
                "php": "^8.2"
            },
            "require-dev": {
                "mockery/mockery": "^1.5.1",
                "orchestra/testbench": "^9.0|^10.0",
                "phpunit/phpunit": "^11.0"
            },
            "type": "package",
            "extra": {
                "laravel": {
                    "providers": [
                        "OwenIt\\Auditing\\AuditingServiceProvider"
                    ]
                },
                "branch-alias": {
                    "dev-master": "v14-dev"
                }
            },
            "autoload": {
                "psr-4": {
                    "OwenIt\\Auditing\\": "src/"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Antério Vieira",
                    "email": "anteriovieira@gmail.com"
                },
                {
                    "name": "Raphael França",
                    "email": "raphaelfrancabsb@gmail.com"
                },
                {
                    "name": "Morten D. Hansen",
                    "email": "morten@visia.dk"
                }
            ],
            "description": "Audit changes of your Eloquent models in Laravel",
            "homepage": "https://laravel-auditing.com",
            "keywords": [
                "Accountability",
                "Audit",
                "auditing",
                "changes",
                "eloquent",
                "history",
                "laravel",
                "log",
                "logging",
                "lumen",
                "observer",
                "record",
                "revision",
                "tracking"
            ],
            "support": {
                "issues": "https://github.com/owen-it/laravel-auditing/issues",
                "source": "https://github.com/owen-it/laravel-auditing"
            },
            "time": "2025-02-26T16:40:54+00:00"
        },
        {
            "name": "phpoption/phpoption",
            "version": "1.9.5",
@@ -4711,6 +4858,70 @@
            ],
            "time": "2025-02-25T09:09:36+00:00"
        },
        {
            "name": "spatie/backtrace",
            "version": "1.8.1",
            "source": {
                "type": "git",
                "url": "https://github.com/spatie/backtrace.git",
                "reference": "8c0f16a59ae35ec8c62d85c3c17585158f430110"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/spatie/backtrace/zipball/8c0f16a59ae35ec8c62d85c3c17585158f430110",
                "reference": "8c0f16a59ae35ec8c62d85c3c17585158f430110",
                "shasum": ""
            },
            "require": {
                "php": "^7.3 || ^8.0"
            },
            "require-dev": {
                "ext-json": "*",
                "laravel/serializable-closure": "^1.3 || ^2.0",
                "phpunit/phpunit": "^9.3 || ^11.4.3",
                "spatie/phpunit-snapshot-assertions": "^4.2 || ^5.1.6",
                "symfony/var-dumper": "^5.1 || ^6.0 || ^7.0"
            },
            "type": "library",
            "autoload": {
                "psr-4": {
                    "Spatie\\Backtrace\\": "src"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Freek Van de Herten",
                    "email": "freek@spatie.be",
                    "homepage": "https://spatie.be",
                    "role": "Developer"
                }
            ],
            "description": "A better backtrace",
            "homepage": "https://github.com/spatie/backtrace",
            "keywords": [
                "Backtrace",
                "spatie"
            ],
            "support": {
                "issues": "https://github.com/spatie/backtrace/issues",
                "source": "https://github.com/spatie/backtrace/tree/1.8.1"
            },
            "funding": [
                {
                    "url": "https://github.com/sponsors/spatie",
                    "type": "github"
                },
                {
                    "url": "https://spatie.be/open-source/support-us",
                    "type": "other"
                }
            ],
            "time": "2025-08-26T08:22:30+00:00"
        },
        {
            "name": "spatie/color",
            "version": "1.8.0",
@@ -4770,6 +4981,232 @@
            ],
            "time": "2025-02-10T09:22:41+00:00"
        },
        {
            "name": "spatie/error-solutions",
            "version": "1.1.3",
            "source": {
                "type": "git",
                "url": "https://github.com/spatie/error-solutions.git",
                "reference": "e495d7178ca524f2dd0fe6a1d99a1e608e1c9936"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/spatie/error-solutions/zipball/e495d7178ca524f2dd0fe6a1d99a1e608e1c9936",
                "reference": "e495d7178ca524f2dd0fe6a1d99a1e608e1c9936",
                "shasum": ""
            },
            "require": {
                "php": "^8.0"
            },
            "require-dev": {
                "illuminate/broadcasting": "^10.0|^11.0|^12.0",
                "illuminate/cache": "^10.0|^11.0|^12.0",
                "illuminate/support": "^10.0|^11.0|^12.0",
                "livewire/livewire": "^2.11|^3.5.20",
                "openai-php/client": "^0.10.1",
                "orchestra/testbench": "8.22.3|^9.0|^10.0",
                "pestphp/pest": "^2.20|^3.0",
                "phpstan/phpstan": "^2.1",
                "psr/simple-cache": "^3.0",
                "psr/simple-cache-implementation": "^3.0",
                "spatie/ray": "^1.28",
                "symfony/cache": "^5.4|^6.0|^7.0",
                "symfony/process": "^5.4|^6.0|^7.0",
                "vlucas/phpdotenv": "^5.5"
            },
            "suggest": {
                "openai-php/client": "Require get solutions from OpenAI",
                "simple-cache-implementation": "To cache solutions from OpenAI"
            },
            "type": "library",
            "autoload": {
                "psr-4": {
                    "Spatie\\Ignition\\": "legacy/ignition",
                    "Spatie\\ErrorSolutions\\": "src",
                    "Spatie\\LaravelIgnition\\": "legacy/laravel-ignition"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Ruben Van Assche",
                    "email": "ruben@spatie.be",
                    "role": "Developer"
                }
            ],
            "description": "This is my package error-solutions",
            "homepage": "https://github.com/spatie/error-solutions",
            "keywords": [
                "error-solutions",
                "spatie"
            ],
            "support": {
                "issues": "https://github.com/spatie/error-solutions/issues",
                "source": "https://github.com/spatie/error-solutions/tree/1.1.3"
            },
            "funding": [
                {
                    "url": "https://github.com/Spatie",
                    "type": "github"
                }
            ],
            "time": "2025-02-14T12:29:50+00:00"
        },
        {
            "name": "spatie/flare-client-php",
            "version": "1.10.1",
            "source": {
                "type": "git",
                "url": "https://github.com/spatie/flare-client-php.git",
                "reference": "bf1716eb98bd689451b071548ae9e70738dce62f"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/spatie/flare-client-php/zipball/bf1716eb98bd689451b071548ae9e70738dce62f",
                "reference": "bf1716eb98bd689451b071548ae9e70738dce62f",
                "shasum": ""
            },
            "require": {
                "illuminate/pipeline": "^8.0|^9.0|^10.0|^11.0|^12.0",
                "php": "^8.0",
                "spatie/backtrace": "^1.6.1",
                "symfony/http-foundation": "^5.2|^6.0|^7.0",
                "symfony/mime": "^5.2|^6.0|^7.0",
                "symfony/process": "^5.2|^6.0|^7.0",
                "symfony/var-dumper": "^5.2|^6.0|^7.0"
            },
            "require-dev": {
                "dms/phpunit-arraysubset-asserts": "^0.5.0",
                "pestphp/pest": "^1.20|^2.0",
                "phpstan/extension-installer": "^1.1",
                "phpstan/phpstan-deprecation-rules": "^1.0",
                "phpstan/phpstan-phpunit": "^1.0",
                "spatie/pest-plugin-snapshots": "^1.0|^2.0"
            },
            "type": "library",
            "extra": {
                "branch-alias": {
                    "dev-main": "1.3.x-dev"
                }
            },
            "autoload": {
                "files": [
                    "src/helpers.php"
                ],
                "psr-4": {
                    "Spatie\\FlareClient\\": "src"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "description": "Send PHP errors to Flare",
            "homepage": "https://github.com/spatie/flare-client-php",
            "keywords": [
                "exception",
                "flare",
                "reporting",
                "spatie"
            ],
            "support": {
                "issues": "https://github.com/spatie/flare-client-php/issues",
                "source": "https://github.com/spatie/flare-client-php/tree/1.10.1"
            },
            "funding": [
                {
                    "url": "https://github.com/spatie",
                    "type": "github"
                }
            ],
            "time": "2025-02-14T13:42:06+00:00"
        },
        {
            "name": "spatie/ignition",
            "version": "1.15.1",
            "source": {
                "type": "git",
                "url": "https://github.com/spatie/ignition.git",
                "reference": "31f314153020aee5af3537e507fef892ffbf8c85"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/spatie/ignition/zipball/31f314153020aee5af3537e507fef892ffbf8c85",
                "reference": "31f314153020aee5af3537e507fef892ffbf8c85",
                "shasum": ""
            },
            "require": {
                "ext-json": "*",
                "ext-mbstring": "*",
                "php": "^8.0",
                "spatie/error-solutions": "^1.0",
                "spatie/flare-client-php": "^1.7",
                "symfony/console": "^5.4|^6.0|^7.0",
                "symfony/var-dumper": "^5.4|^6.0|^7.0"
            },
            "require-dev": {
                "illuminate/cache": "^9.52|^10.0|^11.0|^12.0",
                "mockery/mockery": "^1.4",
                "pestphp/pest": "^1.20|^2.0",
                "phpstan/extension-installer": "^1.1",
                "phpstan/phpstan-deprecation-rules": "^1.0",
                "phpstan/phpstan-phpunit": "^1.0",
                "psr/simple-cache-implementation": "*",
                "symfony/cache": "^5.4|^6.0|^7.0",
                "symfony/process": "^5.4|^6.0|^7.0",
                "vlucas/phpdotenv": "^5.5"
            },
            "suggest": {
                "openai-php/client": "Require get solutions from OpenAI",
                "simple-cache-implementation": "To cache solutions from OpenAI"
            },
            "type": "library",
            "extra": {
                "branch-alias": {
                    "dev-main": "1.5.x-dev"
                }
            },
            "autoload": {
                "psr-4": {
                    "Spatie\\Ignition\\": "src"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Spatie",
                    "email": "info@spatie.be",
                    "role": "Developer"
                }
            ],
            "description": "A beautiful error page for PHP applications.",
            "homepage": "https://flareapp.io/ignition",
            "keywords": [
                "error",
                "flare",
                "laravel",
                "page"
            ],
            "support": {
                "docs": "https://flareapp.io/docs/ignition-for-laravel/introduction",
                "forum": "https://twitter.com/flareappio",
                "issues": "https://github.com/spatie/ignition/issues",
                "source": "https://github.com/spatie/ignition"
            },
            "funding": [
                {
                    "url": "https://github.com/spatie",
                    "type": "github"
                }
            ],
            "time": "2025-02-21T14:31:39+00:00"
        },
        {
            "name": "spatie/invade",
            "version": "2.1.0",
@@ -4829,6 +5266,98 @@
            ],
            "time": "2024-05-17T09:06:10+00:00"
        },
        {
            "name": "spatie/laravel-ignition",
            "version": "2.11.0",
            "source": {
                "type": "git",
                "url": "https://github.com/spatie/laravel-ignition.git",
                "reference": "11f38d1ff7abc583a61c96bf3c1b03610a69cccd"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/spatie/laravel-ignition/zipball/11f38d1ff7abc583a61c96bf3c1b03610a69cccd",
                "reference": "11f38d1ff7abc583a61c96bf3c1b03610a69cccd",
                "shasum": ""
            },
            "require": {
                "ext-curl": "*",
                "ext-json": "*",
                "ext-mbstring": "*",
                "illuminate/support": "^11.0|^12.0|^13.0",
                "nesbot/carbon": "^2.72|^3.0",
                "php": "^8.2",
                "spatie/ignition": "^1.15.1",
                "symfony/console": "^7.4|^8.0",
                "symfony/var-dumper": "^7.4|^8.0"
            },
            "require-dev": {
                "livewire/livewire": "^3.7.0|^4.0|dev-josh/v3-laravel-13-support",
                "mockery/mockery": "^1.6.12",
                "openai-php/client": "^0.10.3|^0.19",
                "orchestra/testbench": "^v9.16.0|^10.6|^11.0",
                "pestphp/pest": "^3.7|^4.0",
                "phpstan/extension-installer": "^1.4.3",
                "phpstan/phpstan-deprecation-rules": "^2.0.3",
                "phpstan/phpstan-phpunit": "^2.0.8",
                "vlucas/phpdotenv": "^5.6.2"
            },
            "suggest": {
                "openai-php/client": "Require get solutions from OpenAI",
                "psr/simple-cache-implementation": "Needed to cache solutions from OpenAI"
            },
            "type": "library",
            "extra": {
                "laravel": {
                    "aliases": {
                        "Flare": "Spatie\\LaravelIgnition\\Facades\\Flare"
                    },
                    "providers": [
                        "Spatie\\LaravelIgnition\\IgnitionServiceProvider"
                    ]
                }
            },
            "autoload": {
                "files": [
                    "src/helpers.php"
                ],
                "psr-4": {
                    "Spatie\\LaravelIgnition\\": "src"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Spatie",
                    "email": "info@spatie.be",
                    "role": "Developer"
                }
            ],
            "description": "A beautiful error page for Laravel applications.",
            "homepage": "https://flareapp.io/ignition",
            "keywords": [
                "error",
                "flare",
                "laravel",
                "page"
            ],
            "support": {
                "docs": "https://flareapp.io/docs/ignition-for-laravel/introduction",
                "forum": "https://twitter.com/flareappio",
                "issues": "https://github.com/spatie/laravel-ignition/issues",
                "source": "https://github.com/spatie/laravel-ignition"
            },
            "funding": [
                {
                    "url": "https://github.com/spatie",
                    "type": "github"
                }
            ],
            "time": "2026-02-22T19:14:05+00:00"
        },
        {
            "name": "spatie/laravel-package-tools",
            "version": "1.93.0",
@@ -4890,6 +5419,89 @@
            ],
            "time": "2026-02-21T12:49:54+00:00"
        },
        {
            "name": "spatie/laravel-permission",
            "version": "6.24.1",
            "source": {
                "type": "git",
                "url": "https://github.com/spatie/laravel-permission.git",
                "reference": "eefc9d17eba80d023d6bff313f882cb2bcd691a3"
            },
            "dist": {
                "type": "zip",
                "url": "https://api.github.com/repos/spatie/laravel-permission/zipball/eefc9d17eba80d023d6bff313f882cb2bcd691a3",
                "reference": "eefc9d17eba80d023d6bff313f882cb2bcd691a3",
                "shasum": ""
            },
            "require": {
                "illuminate/auth": "^8.12|^9.0|^10.0|^11.0|^12.0",
                "illuminate/container": "^8.12|^9.0|^10.0|^11.0|^12.0",
                "illuminate/contracts": "^8.12|^9.0|^10.0|^11.0|^12.0",
                "illuminate/database": "^8.12|^9.0|^10.0|^11.0|^12.0",
                "php": "^8.0"
            },
            "require-dev": {
                "laravel/passport": "^11.0|^12.0",
                "laravel/pint": "^1.0",
                "orchestra/testbench": "^6.23|^7.0|^8.0|^9.0|^10.0",
                "phpunit/phpunit": "^9.4|^10.1|^11.5"
            },
            "type": "library",
            "extra": {
                "laravel": {
                    "providers": [
                        "Spatie\\Permission\\PermissionServiceProvider"
                    ]
                },
                "branch-alias": {
                    "dev-main": "6.x-dev",
                    "dev-master": "6.x-dev"
                }
            },
            "autoload": {
                "files": [
                    "src/helpers.php"
                ],
                "psr-4": {
                    "Spatie\\Permission\\": "src"
                }
            },
            "notification-url": "https://packagist.org/downloads/",
            "license": [
                "MIT"
            ],
            "authors": [
                {
                    "name": "Freek Van der Herten",
                    "email": "freek@spatie.be",
                    "homepage": "https://spatie.be",
                    "role": "Developer"
                }
            ],
            "description": "Permission handling for Laravel 8.0 and up",
            "homepage": "https://github.com/spatie/laravel-permission",
            "keywords": [
                "acl",
                "laravel",
                "permission",
                "permissions",
                "rbac",
                "roles",
                "security",
                "spatie"
            ],
            "support": {
                "issues": "https://github.com/spatie/laravel-permission/issues",
                "source": "https://github.com/spatie/laravel-permission/tree/6.24.1"
            },
            "funding": [
                {
                    "url": "https://github.com/spatie",
                    "type": "github"
                }
            ],
            "time": "2026-02-09T21:10:03+00:00"
        },
        {
            "name": "symfony/clock",
            "version": "v7.4.0",
--- a/src/config/permission.php
+++ b/src/config/permission.php
@@ -0,0 +1,202 @@
 <?php
 return [
    'models' => [
        /*
         * When using the "HasPermissions" trait from this package, we need to know which
         * Eloquent model should be used to retrieve your permissions. Of course, it
         * is often just the "Permission" model but you may use whatever you like.
         *
         * The model you want to use as a Permission model needs to implement the
         * `Spatie\Permission\Contracts\Permission` contract.
         */
        'permission' => Spatie\Permission\Models\Permission::class,
        /*
         * When using the "HasRoles" trait from this package, we need to know which
         * Eloquent model should be used to retrieve your roles. Of course, it
         * is often just the "Role" model but you may use whatever you like.
         *
         * The model you want to use as a Role model needs to implement the
         * `Spatie\Permission\Contracts\Role` contract.
         */
        'role' => Spatie\Permission\Models\Role::class,
    ],
    'table_names' => [
        /*
         * When using the "HasRoles" trait from this package, we need to know which
         * table should be used to retrieve your roles. We have chosen a basic
         * default value but you may easily change it to any table you like.
         */
        'roles' => 'roles',
        /*
         * When using the "HasPermissions" trait from this package, we need to know which
         * table should be used to retrieve your permissions. We have chosen a basic
         * default value but you may easily change it to any table you like.
         */
        'permissions' => 'permissions',
        /*
         * When using the "HasPermissions" trait from this package, we need to know which
         * table should be used to retrieve your models permissions. We have chosen a
         * basic default value but you may easily change it to any table you like.
         */
        'model_has_permissions' => 'model_has_permissions',
        /*
         * When using the "HasRoles" trait from this package, we need to know which
         * table should be used to retrieve your models roles. We have chosen a
         * basic default value but you may easily change it to any table you like.
         */
        'model_has_roles' => 'model_has_roles',
        /*
         * When using the "HasRoles" trait from this package, we need to know which
         * table should be used to retrieve your roles permissions. We have chosen a
         * basic default value but you may easily change it to any table you like.
         */
        'role_has_permissions' => 'role_has_permissions',
    ],
    'column_names' => [
        /*
         * Change this if you want to name the related pivots other than defaults
         */
        'role_pivot_key' => null, // default 'role_id',
        'permission_pivot_key' => null, // default 'permission_id',
        /*
         * Change this if you want to name the related model primary key other than
         * `model_id`.
         *
         * For example, this would be nice if your primary keys are all UUIDs. In
         * that case, name this `model_uuid`.
         */
        'model_morph_key' => 'model_id',
        /*
         * Change this if you want to use the teams feature and your related model's
         * foreign key is other than `team_id`.
         */
        'team_foreign_key' => 'team_id',
    ],
    /*
     * When set to true, the method for checking permissions will be registered on the gate.
     * Set this to false if you want to implement custom logic for checking permissions.
     */
    'register_permission_check_method' => true,
    /*
     * When set to true, Laravel\Octane\Events\OperationTerminated event listener will be registered
     * this will refresh permissions on every TickTerminated, TaskTerminated and RequestTerminated
     * NOTE: This should not be needed in most cases, but an Octane/Vapor combination benefited from it.
     */
    'register_octane_reset_listener' => false,
    /*
     * Events will fire when a role or permission is assigned/unassigned:
     * \Spatie\Permission\Events\RoleAttached
     * \Spatie\Permission\Events\RoleDetached
     * \Spatie\Permission\Events\PermissionAttached
     * \Spatie\Permission\Events\PermissionDetached
     *
     * To enable, set to true, and then create listeners to watch these events.
     */
    'events_enabled' => false,
    /*
     * Teams Feature.
     * When set to true the package implements teams using the 'team_foreign_key'.
     * If you want the migrations to register the 'team_foreign_key', you must
     * set this to true before doing the migration.
     * If you already did the migration then you must make a new migration to also
     * add 'team_foreign_key' to 'roles', 'model_has_roles', and 'model_has_permissions'
     * (view the latest version of this package's migration file)
     */
    'teams' => false,
    /*
     * The class to use to resolve the permissions team id
     */
    'team_resolver' => \Spatie\Permission\DefaultTeamResolver::class,
    /*
     * Passport Client Credentials Grant
     * When set to true the package will use Passports Client to check permissions
     */
    'use_passport_client_credentials' => false,
    /*
     * When set to true, the required permission names are added to exception messages.
     * This could be considered an information leak in some contexts, so the default
     * setting is false here for optimum safety.
     */
    'display_permission_in_exception' => false,
    /*
     * When set to true, the required role names are added to exception messages.
     * This could be considered an information leak in some contexts, so the default
     * setting is false here for optimum safety.
     */
    'display_role_in_exception' => false,
    /*
     * By default wildcard permission lookups are disabled.
     * See documentation to understand supported syntax.
     */
    'enable_wildcard_permission' => false,
    /*
     * The class to use for interpreting wildcard permissions.
     * If you need to modify delimiters, override the class and specify its name here.
     */
    // 'wildcard_permission' => Spatie\Permission\WildcardPermission::class,
    /* Cache-specific settings */
    'cache' => [
        /*
         * By default all permissions are cached for 24 hours to speed up performance.
         * When permissions or roles are updated the cache is flushed automatically.
         */
        'expiration_time' => \DateInterval::createFromDateString('24 hours'),
        /*
         * The cache key used to store all permissions.
         */
        'key' => 'spatie.permission.cache',
        /*
         * You may optionally indicate a specific cache driver to use for permission and
         * role caching using any of the `store` drivers listed in the cache.php config
         * file. Using 'default' here means to use the `default` set in cache.php.
         */
        'store' => 'default',
    ],
 ];
--- a/src/config/sanctum.php
+++ b/src/config/sanctum.php
@@ -0,0 +1,84 @@
 <?php
 use Laravel\Sanctum\Sanctum;
 return [
    /*
    |--------------------------------------------------------------------------
    | Stateful Domains
    |--------------------------------------------------------------------------
    |
    | Requests from the following domains / hosts will receive stateful API
    | authentication cookies. Typically, these should include your local
    | and production domains which access your API via a frontend SPA.
    |
    */
    'stateful' => explode(',', env('SANCTUM_STATEFUL_DOMAINS', sprintf(
        '%s%s',
        'localhost,localhost:3000,127.0.0.1,127.0.0.1:8000,::1',
        Sanctum::currentApplicationUrlWithPort(),
        // Sanctum::currentRequestHost(),
    ))),
    /*
    |--------------------------------------------------------------------------
    | Sanctum Guards
    |--------------------------------------------------------------------------
    |
    | This array contains the authentication guards that will be checked when
    | Sanctum is trying to authenticate a request. If none of these guards
    | are able to authenticate the request, Sanctum will use the bearer
    | token that's present on an incoming request for authentication.
    |
    */
    'guard' => ['web'],
    /*
    |--------------------------------------------------------------------------
    | Expiration Minutes
    |--------------------------------------------------------------------------
    |
    | This value controls the number of minutes until an issued token will be
    | considered expired. This will override any values set in the token's
    | "expires_at" attribute, but first-party sessions are not affected.
    |
    */
    'expiration' => null,
    /*
    |--------------------------------------------------------------------------
    | Token Prefix
    |--------------------------------------------------------------------------
    |
    | Sanctum can prefix new tokens in order to take advantage of numerous
    | security scanning initiatives maintained by open source platforms
    | that notify developers if they commit tokens into repositories.
    |
    | See: https://docs.github.com/en/code-security/secret-scanning/about-secret-scanning
    |
    */
    'token_prefix' => env('SANCTUM_TOKEN_PREFIX', ''),
    /*
    |--------------------------------------------------------------------------
    | Sanctum Middleware
    |--------------------------------------------------------------------------
    |
    | When authenticating your first-party SPA with Sanctum you may need to
    | customize some of the middleware Sanctum uses while processing the
    | request. You may change the middleware listed below as required.
    |
    */
    'middleware' => [
        'authenticate_session' => Laravel\Sanctum\Http\Middleware\AuthenticateSession::class,
        'encrypt_cookies' => Illuminate\Cookie\Middleware\EncryptCookies::class,
        'validate_csrf_token' => Illuminate\Foundation\Http\Middleware\ValidateCsrfToken::class,
    ],
 ];
--- a/src/database/migrations/2026_03_09_022522_create_settings_table.php
+++ b/src/database/migrations/2026_03_09_022522_create_settings_table.php
@@ -0,0 +1,30 @@
 <?php
 use Illuminate\Database\Migrations\Migration;
 use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
 return new class extends Migration
 {
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('settings', function (Blueprint $table) {
            $table->id();
            $table->string('key')->unique();
            $table->text('value')->nullable();
            $table->string('type')->default('string');
            $table->timestamps();
        });
    }
    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::dropIfExists('settings');
    }
 };
--- a/src/database/migrations/2026_03_09_023752_create_permission_tables.php
+++ b/src/database/migrations/2026_03_09_023752_create_permission_tables.php
@@ -0,0 +1,134 @@
 <?php
 use Illuminate\Database\Migrations\Migration;
 use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
 return new class extends Migration
 {
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        $teams = config('permission.teams');
        $tableNames = config('permission.table_names');
        $columnNames = config('permission.column_names');
        $pivotRole = $columnNames['role_pivot_key'] ?? 'role_id';
        $pivotPermission = $columnNames['permission_pivot_key'] ?? 'permission_id';
        throw_if(empty($tableNames), Exception::class, 'Error: config/permission.php not loaded. Run [php artisan config:clear] and try again.');
        throw_if($teams && empty($columnNames['team_foreign_key'] ?? null), Exception::class, 'Error: team_foreign_key on config/permission.php not loaded. Run [php artisan config:clear] and try again.');
        Schema::create($tableNames['permissions'], static function (Blueprint $table) {
            // $table->engine('InnoDB');
            $table->bigIncrements('id'); // permission id
            $table->string('name');       // For MyISAM use string('name', 225); // (or 166 for InnoDB with Redundant/Compact row format)
            $table->string('guard_name'); // For MyISAM use string('guard_name', 25);
            $table->timestamps();
            $table->unique(['name', 'guard_name']);
        });
        Schema::create($tableNames['roles'], static function (Blueprint $table) use ($teams, $columnNames) {
            // $table->engine('InnoDB');
            $table->bigIncrements('id'); // role id
            if ($teams || config('permission.testing')) { // permission.testing is a fix for sqlite testing
                $table->unsignedBigInteger($columnNames['team_foreign_key'])->nullable();
                $table->index($columnNames['team_foreign_key'], 'roles_team_foreign_key_index');
            }
            $table->string('name');       // For MyISAM use string('name', 225); // (or 166 for InnoDB with Redundant/Compact row format)
            $table->string('guard_name'); // For MyISAM use string('guard_name', 25);
            $table->timestamps();
            if ($teams || config('permission.testing')) {
                $table->unique([$columnNames['team_foreign_key'], 'name', 'guard_name']);
            } else {
                $table->unique(['name', 'guard_name']);
            }
        });
        Schema::create($tableNames['model_has_permissions'], static function (Blueprint $table) use ($tableNames, $columnNames, $pivotPermission, $teams) {
            $table->unsignedBigInteger($pivotPermission);
            $table->string('model_type');
            $table->unsignedBigInteger($columnNames['model_morph_key']);
            $table->index([$columnNames['model_morph_key'], 'model_type'], 'model_has_permissions_model_id_model_type_index');
            $table->foreign($pivotPermission)
                ->references('id') // permission id
                ->on($tableNames['permissions'])
                ->onDelete('cascade');
            if ($teams) {
                $table->unsignedBigInteger($columnNames['team_foreign_key']);
                $table->index($columnNames['team_foreign_key'], 'model_has_permissions_team_foreign_key_index');
                $table->primary([$columnNames['team_foreign_key'], $pivotPermission, $columnNames['model_morph_key'], 'model_type'],
                    'model_has_permissions_permission_model_type_primary');
            } else {
                $table->primary([$pivotPermission, $columnNames['model_morph_key'], 'model_type'],
                    'model_has_permissions_permission_model_type_primary');
            }
        });
        Schema::create($tableNames['model_has_roles'], static function (Blueprint $table) use ($tableNames, $columnNames, $pivotRole, $teams) {
            $table->unsignedBigInteger($pivotRole);
            $table->string('model_type');
            $table->unsignedBigInteger($columnNames['model_morph_key']);
            $table->index([$columnNames['model_morph_key'], 'model_type'], 'model_has_roles_model_id_model_type_index');
            $table->foreign($pivotRole)
                ->references('id') // role id
                ->on($tableNames['roles'])
                ->onDelete('cascade');
            if ($teams) {
                $table->unsignedBigInteger($columnNames['team_foreign_key']);
                $table->index($columnNames['team_foreign_key'], 'model_has_roles_team_foreign_key_index');
                $table->primary([$columnNames['team_foreign_key'], $pivotRole, $columnNames['model_morph_key'], 'model_type'],
                    'model_has_roles_role_model_type_primary');
            } else {
                $table->primary([$pivotRole, $columnNames['model_morph_key'], 'model_type'],
                    'model_has_roles_role_model_type_primary');
            }
        });
        Schema::create($tableNames['role_has_permissions'], static function (Blueprint $table) use ($tableNames, $pivotRole, $pivotPermission) {
            $table->unsignedBigInteger($pivotPermission);
            $table->unsignedBigInteger($pivotRole);
            $table->foreign($pivotPermission)
                ->references('id') // permission id
                ->on($tableNames['permissions'])
                ->onDelete('cascade');
            $table->foreign($pivotRole)
                ->references('id') // role id
                ->on($tableNames['roles'])
                ->onDelete('cascade');
            $table->primary([$pivotPermission, $pivotRole], 'role_has_permissions_permission_id_role_id_primary');
        });
        app('cache')
            ->store(config('permission.cache.store') != 'default' ? config('permission.cache.store') : null)
            ->forget(config('permission.cache.key'));
    }
    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        $tableNames = config('permission.table_names');
        throw_if(empty($tableNames), Exception::class, 'Error: config/permission.php not found and defaults could not be merged. Please publish the package configuration before proceeding, or drop the tables manually.');
        Schema::drop($tableNames['role_has_permissions']);
        Schema::drop($tableNames['model_has_roles']);
        Schema::drop($tableNames['model_has_permissions']);
        Schema::drop($tableNames['roles']);
        Schema::drop($tableNames['permissions']);
    }
 };
--- a/src/database/migrations/2026_03_09_024743_create_audits_table.php
+++ b/src/database/migrations/2026_03_09_024743_create_audits_table.php
@@ -0,0 +1,27 @@
 <?php
 use Illuminate\Database\Migrations\Migration;
 use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
 return new class extends Migration
 {
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('audits', function (Blueprint $table) {
            $table->id();
            $table->timestamps();
        });
    }
    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::dropIfExists('audits');
    }
 };
--- a/src/database/migrations/2026_03_09_030435_create_personal_access_tokens_table.php
+++ b/src/database/migrations/2026_03_09_030435_create_personal_access_tokens_table.php
@@ -0,0 +1,33 @@
 <?php
 use Illuminate\Database\Migrations\Migration;
 use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
 return new class extends Migration
 {
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('personal_access_tokens', function (Blueprint $table) {
            $table->id();
            $table->morphs('tokenable');
            $table->text('name');
            $table->string('token', 64)->unique();
            $table->text('abilities')->nullable();
            $table->timestamp('last_used_at')->nullable();
            $table->timestamp('expires_at')->nullable()->index();
            $table->timestamps();
        });
    }
    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::dropIfExists('personal_access_tokens');
    }
 };
--- a/src/database/seeders/RolePermissionSeeder.php
+++ b/src/database/seeders/RolePermissionSeeder.php
@@ -0,0 +1,42 @@
 <?php
 namespace Database\Seeders;
 use Illuminate\Database\Seeder;
 use Spatie\Permission\Models\Role;
 use Spatie\Permission\Models\Permission;
 use App\Models\User;
 class RolePermissionSeeder extends Seeder
 {
    public function run(): void
    {
        app()[\Spatie\Permission\PermissionRegistrar::class]->forgetCachedPermissions();
        $permissions = [
            'users.view',
            'users.create',
            'users.edit',
            'users.delete',
            'settings.manage',
        ];
        foreach ($permissions as $permission) {
            Permission::create(['name' => $permission]);
        }
        $adminRole = Role::create(['name' => 'admin']);
        $adminRole->givePermissionTo(Permission::all());
        $editorRole = Role::create(['name' => 'editor']);
        $editorRole->givePermissionTo(['users.view', 'users.edit']);
        $viewerRole = Role::create(['name' => 'viewer']);
        $viewerRole->givePermissionTo(['users.view']);
        $admin = User::where('email', 'admin@example.com')->first();
        if ($admin) {
            $admin->assignRole('admin');
        }
    }
 }
--- a/src/resources/views/filament/pages/settings.blade.php
+++ b/src/resources/views/filament/pages/settings.blade.php
@@ -0,0 +1,9 @@
 <x-filament-panels::page>
    <form wire:submit="save">
        {{ $this->form }}
        <x-filament-panels::form.actions
            :actions="$this->getFormActions()"
        />
    </form>
 </x-filament-panels::page>
--- a/src/resources/views/filament/resources/admin-resource/pages/settings.blade.php
+++ b/src/resources/views/filament/resources/admin-resource/pages/settings.blade.php
@@ -0,0 +1,3 @@
 <x-filament-panels::page>
 </x-filament-panels::page>
--- a/src/routes/api.php
+++ b/src/routes/api.php
@@ -0,0 +1,8 @@
 <?php
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Route;
 Route::get('/user', function (Request $request) {
    return $request->user();
 })->middleware('auth:sanctum');
		`@@ -0,0 +1,3 @@`
							`<x-filament-panels::page>`

							`</x-filament-panels::page>`