From d768217edc7ad5aa3c4d019066d3a57c66b17208 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 12 Nov 2025 13:27:32 +0100
Subject: [PATCH 001/132] feat(modules): add modular system with example and
 armory modules

- Implement BaseModuleServiceProvider for module management
- Add MakeModuleCommand for module scaffolding
- Include example and armory modules with routes, controllers and providers
- Update composer.json autoload configuration
---
 app/Console/Commands/MakeModuleCommand.php    | 116 ++++++++++++++++++
 .../Http/Controllers/ArmoryController.php     |  13 ++
 app/Modules/Armory/Http/routes.php            |   9 ++
 .../Providers/ArmoryServiceProvider.php       |  10 ++
 app/Modules/Armory/module.json                |   8 ++
 .../Http/Controllers/ExampleController.php    |  13 ++
 app/Modules/Example/Http/routes.php           |   5 +
 .../Providers/ExampleServiceProvider.php      |  10 ++
 app/Modules/Example/module.json               |  12 ++
 app/Providers/BaseModuleServiceProvider.php   |  74 +++++++++++
 bootstrap/providers.php                       |   1 +
 composer.json                                 |   3 +-
 12 files changed, 273 insertions(+), 1 deletion(-)
 create mode 100644 app/Console/Commands/MakeModuleCommand.php
 create mode 100644 app/Modules/Armory/Http/Controllers/ArmoryController.php
 create mode 100644 app/Modules/Armory/Http/routes.php
 create mode 100644 app/Modules/Armory/Providers/ArmoryServiceProvider.php
 create mode 100644 app/Modules/Armory/module.json
 create mode 100644 app/Modules/Example/Http/Controllers/ExampleController.php
 create mode 100644 app/Modules/Example/Http/routes.php
 create mode 100644 app/Modules/Example/Providers/ExampleServiceProvider.php
 create mode 100644 app/Modules/Example/module.json
 create mode 100644 app/Providers/BaseModuleServiceProvider.php

diff --git a/app/Console/Commands/MakeModuleCommand.php b/app/Console/Commands/MakeModuleCommand.php
new file mode 100644
index 0000000..3554717
--- /dev/null
+++ b/app/Console/Commands/MakeModuleCommand.php
@@ -0,0 +1,116 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Str;
+
+class MakeModuleCommand extends Command
+{
+    /**
+     * Nombre del comando para Artisan
+     */
+    protected $signature = 'make:module {name : The name of the module} {--force : Overwrite existing module if it exists}';
+
+    /**
+     * Descripción
+     */
+    protected $description = 'Create a new module with its folder structure and base ServiceProvider';
+
+    /**
+     * Ejecuta el comando
+     */
+    public function handle(): int
+    {
+        $name = Str::studly($this->argument('name'));
+        $path = base_path("app/Modules/{$name}");
+
+        if (File::exists($path) && !$this->option('force')) {
+            $this->error("The module [{$name}] already exists! Use --force to overwrite.");
+            return self::FAILURE;
+        }
+
+        // Estructura de carpetas
+        $directories = [
+            'App/Services',
+            'App/UseCases',
+            'App/DTOs',
+            'Domain/Models',
+            'Domain/Interfaces',
+            'Infrastructure/Repositories',
+            'Http/Controllers',
+            'Http/Requests',
+            'Providers',
+            'Resources/views',
+            'Infrastructure/Database/migrations',
+        ];
+
+        foreach ($directories as $dir) {
+            File::makeDirectory("{$path}/{$dir}", 0755, true, true);
+        }
+
+        // module.json
+        $moduleJson = [
+            'name' => $name,
+            'enabled' => true,
+            'routes' => true,
+            'migrations' => true,
+            'views' => true,
+            'namespace' => "Modules\\{$name}"
+        ];
+
+        File::put("{$path}/module.json", json_encode($moduleJson, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
+
+        // routes.php
+        $routes = <<<PHP
+        <?php
+
+        use Illuminate\\Support\\Facades\\Route;
+
+        Route::middleware('web')
+            ->prefix(strtolower('{$name}'))
+            ->group(function () {
+                Route::get('/', [\\Modules\\{$name}\\Http\\Controllers\\{$name}Controller::class, 'index']);
+            });
+        PHP;
+        File::put("{$path}/Http/routes.php", $routes);
+
+        // Controller base
+        $controller = <<<PHP
+        <?php
+
+        namespace Modules\\{$name}\\Http\\Controllers;
+
+        use App\\Http\\Controllers\\Controller;
+
+        class {$name}Controller extends Controller
+        {
+            public function index()
+            {
+                return response()->json(['message' => '{$name} module is working']);
+            }
+        }
+        PHP;
+        File::put("{$path}/Http/Controllers/{$name}Controller.php", $controller);
+
+        // ServiceProvider
+        $provider = <<<PHP
+        <?php
+
+        namespace Modules\\{$name}\\Providers;
+
+        use App\\Providers\\BaseModuleServiceProvider;
+
+        class {$name}ServiceProvider extends BaseModuleServiceProvider
+        {
+            protected string \$moduleName = '{$name}';
+        }
+        PHP;
+        File::put("{$path}/Providers/{$name}ServiceProvider.php", $provider);
+
+        $this->info("Module [{$name}] created successfully at app/Modules/{$name}");
+        return self::SUCCESS;
+    }
+}
+
diff --git a/app/Modules/Armory/Http/Controllers/ArmoryController.php b/app/Modules/Armory/Http/Controllers/ArmoryController.php
new file mode 100644
index 0000000..e039839
--- /dev/null
+++ b/app/Modules/Armory/Http/Controllers/ArmoryController.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace Modules\Armory\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+
+class ArmoryController extends Controller
+{
+    public function index()
+    {
+        return response()->json(['message' => 'Armory module is working']);
+    }
+}
\ No newline at end of file
diff --git a/app/Modules/Armory/Http/routes.php b/app/Modules/Armory/Http/routes.php
new file mode 100644
index 0000000..422ab84
--- /dev/null
+++ b/app/Modules/Armory/Http/routes.php
@@ -0,0 +1,9 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+
+Route::middleware('web')
+    ->prefix(strtolower('Armory'))
+    ->group(function () {
+        Route::get('/', [\Modules\Armory\Http\Controllers\ArmoryController::class, 'index']);
+    });
\ No newline at end of file
diff --git a/app/Modules/Armory/Providers/ArmoryServiceProvider.php b/app/Modules/Armory/Providers/ArmoryServiceProvider.php
new file mode 100644
index 0000000..6b80901
--- /dev/null
+++ b/app/Modules/Armory/Providers/ArmoryServiceProvider.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace Modules\Armory\Providers;
+
+use App\Providers\BaseModuleServiceProvider;
+
+class ArmoryServiceProvider extends BaseModuleServiceProvider
+{
+    protected string $moduleName = 'Armory';
+}
\ No newline at end of file
diff --git a/app/Modules/Armory/module.json b/app/Modules/Armory/module.json
new file mode 100644
index 0000000..c7971de
--- /dev/null
+++ b/app/Modules/Armory/module.json
@@ -0,0 +1,8 @@
+{
+    "name": "Armory",
+    "enabled": true,
+    "routes": true,
+    "migrations": true,
+    "views": true,
+    "namespace": "Modules\\Armory"
+}
\ No newline at end of file
diff --git a/app/Modules/Example/Http/Controllers/ExampleController.php b/app/Modules/Example/Http/Controllers/ExampleController.php
new file mode 100644
index 0000000..9be90e6
--- /dev/null
+++ b/app/Modules/Example/Http/Controllers/ExampleController.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace Modules\Example\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+
+class ExampleController extends Controller
+{
+    public function index()
+    {
+        return response()->json(['message' => 'Módulo Example funcionando']);
+    }
+}
diff --git a/app/Modules/Example/Http/routes.php b/app/Modules/Example/Http/routes.php
new file mode 100644
index 0000000..6ab1818
--- /dev/null
+++ b/app/Modules/Example/Http/routes.php
@@ -0,0 +1,5 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+
+Route::get('/example', 'ExampleController@index');
diff --git a/app/Modules/Example/Providers/ExampleServiceProvider.php b/app/Modules/Example/Providers/ExampleServiceProvider.php
new file mode 100644
index 0000000..4fe82bd
--- /dev/null
+++ b/app/Modules/Example/Providers/ExampleServiceProvider.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace Modules\Example\Providers;
+
+use App\Providers\BaseModuleServiceProvider;
+
+class ExampleServiceProvider extends BaseModuleServiceProvider
+{
+    protected string $moduleName = 'Example';
+}
diff --git a/app/Modules/Example/module.json b/app/Modules/Example/module.json
new file mode 100644
index 0000000..560f689
--- /dev/null
+++ b/app/Modules/Example/module.json
@@ -0,0 +1,12 @@
+{
+    "name": "Example",
+    "description": "Módulo de ejemplo",
+    "version": "1.0.0",
+    "author": "WoW-CMS",
+    "author_url": "https://wow-cms.com",
+    "enabled": true,
+    "routes": true,
+    "migrations": false,
+    "views": false,
+    "namespace": "Modules\\Example"
+}
diff --git a/app/Providers/BaseModuleServiceProvider.php b/app/Providers/BaseModuleServiceProvider.php
new file mode 100644
index 0000000..952f175
--- /dev/null
+++ b/app/Providers/BaseModuleServiceProvider.php
@@ -0,0 +1,74 @@
+<?php
+
+namespace App\Providers;
+
+use Illuminate\Support\ServiceProvider;
+use Illuminate\Support\Facades\Route;
+use Illuminate\Support\Facades\File;
+
+abstract class BaseModuleServiceProvider extends ServiceProvider
+{
+    protected string $moduleName = '';
+    protected string $modulePath = '';
+    protected array $config = [];
+
+    public function boot(): void
+    {
+        if (empty($this->moduleName)) {
+            throw new \RuntimeException('Module name not defined in ' . static::class);
+        }
+
+        $this->modulePath = base_path("app/Modules/{$this->moduleName}");
+        $this->loadModuleConfig();
+
+        if (!($this->config['enabled'] ?? true)) {
+            return;
+        }
+
+        if ($this->config['routes'] ?? false) {
+            $this->loadRoutes();
+        }
+
+        if ($this->config['migrations'] ?? false) {
+            $this->loadMigrations();
+        }
+
+        if ($this->config['views'] ?? false) {
+            $this->loadViews();
+        }
+    }
+
+    private function loadModuleConfig(): void
+    {
+        $configFile = $this->modulePath . '/module.json';
+        if (File::exists($configFile)) {
+            $this->config = json_decode(File::get($configFile), true) ?? [];
+        }
+    }
+
+    private function loadRoutes(): void
+    {
+        $routesPath = $this->modulePath . '/Http/routes.php';
+        if (File::exists($routesPath)) {
+            Route::middleware('web')
+                ->namespace(($this->config['namespace'] ?? "Modules\\{$this->moduleName}") . '\\Http\\Controllers')
+                ->group($routesPath);
+        }
+    }
+
+    private function loadMigrations(): void
+    {
+        $path = $this->modulePath . '/Infrastructure/Database/migrations';
+        if (is_dir($path)) {
+            $this->loadMigrationsFrom($path);
+        }
+    }
+
+    private function loadViews(): void
+    {
+        $path = $this->modulePath . '/Resources/views';
+        if (is_dir($path)) {
+            $this->loadViewsFrom($path, strtolower($this->moduleName));
+        }
+    }
+}
diff --git a/bootstrap/providers.php b/bootstrap/providers.php
index df3195a..4ed90a5 100755
--- a/bootstrap/providers.php
+++ b/bootstrap/providers.php
@@ -4,4 +4,5 @@
     App\Providers\AppServiceProvider::class,
     App\Providers\ArmoryServiceProvider::class,
     Spatie\Permission\PermissionServiceProvider::class,
+    Modules\Example\Providers\ExampleServiceProvider::class,
 ];
diff --git a/composer.json b/composer.json
index d897428..771de4e 100755
--- a/composer.json
+++ b/composer.json
@@ -34,7 +34,8 @@
         "psr-4": {
             "App\\": "app/",
             "Database\\Factories\\": "database/factories/",
-            "Database\\Seeders\\": "database/seeders/"
+            "Database\\Seeders\\": "database/seeders/",
+            "Modules\\": "app/Modules/"
         }
     },
     "autoload-dev": {

From c51a8d079d0076a0a9ad66737121c6258d2a7317 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 12 Nov 2025 20:44:02 +0100
Subject: [PATCH 002/132] refactor(modules): remove armory module and implement
 dynamic module loading

The Armory module was removed as part of transitioning to a dynamic module loading system. Added ModuleLoader helper and ModuleServiceProvider to automatically discover and register module service providers.
---
 app/Helpers/ModuleLoader.php                  | 45 +++++++++++++++++++
 .../Http/Controllers/ArmoryController.php     | 13 ------
 app/Modules/Armory/Http/routes.php            |  9 ----
 .../Providers/ArmoryServiceProvider.php       | 10 -----
 app/Modules/Armory/module.json                |  8 ----
 app/Providers/ModuleServiceProvider.php       | 16 +++++++
 bootstrap/providers.php                       |  7 ++-
 7 files changed, 66 insertions(+), 42 deletions(-)
 create mode 100644 app/Helpers/ModuleLoader.php
 delete mode 100644 app/Modules/Armory/Http/Controllers/ArmoryController.php
 delete mode 100644 app/Modules/Armory/Http/routes.php
 delete mode 100644 app/Modules/Armory/Providers/ArmoryServiceProvider.php
 delete mode 100644 app/Modules/Armory/module.json
 create mode 100644 app/Providers/ModuleServiceProvider.php

diff --git a/app/Helpers/ModuleLoader.php b/app/Helpers/ModuleLoader.php
new file mode 100644
index 0000000..d36c0a2
--- /dev/null
+++ b/app/Helpers/ModuleLoader.php
@@ -0,0 +1,45 @@
+<?php
+
+namespace App\Helpers;
+
+class ModuleLoader
+{
+    public static function getProviders(): array
+    {
+        $providers = [];
+        $modulesPath = base_path('app/Modules');
+
+        if (!is_dir($modulesPath)) {
+            return $providers;
+        }
+
+        foreach (glob("$modulesPath/*", GLOB_ONLYDIR) as $moduleDir) {
+            $moduleName = basename($moduleDir);
+            $namespace = "Modules\\{$moduleName}\\Providers";
+            $expectedFile = "{$moduleDir}/Providers/{$moduleName}ServiceProvider.php";
+            $expectedClass = "{$namespace}\\{$moduleName}ServiceProvider";
+
+            if (file_exists($expectedFile)) {
+                require_once $expectedFile;
+                if (class_exists($expectedClass)) {
+                    $providers[] = $expectedClass;
+                    continue;
+                }
+            }
+
+            $providersDir = "{$moduleDir}/Providers";
+            if (is_dir($providersDir)) {
+                foreach (glob("{$providersDir}/*ServiceProvider.php") as $providerFile) {
+                    require_once $providerFile;
+                    $className = pathinfo($providerFile, PATHINFO_FILENAME);
+                    $fullClass = "{$namespace}\\{$className}";
+                    if (class_exists($fullClass)) {
+                        $providers[] = $fullClass;
+                    }
+                }
+            }
+        }
+
+        return $providers;
+    }
+}
diff --git a/app/Modules/Armory/Http/Controllers/ArmoryController.php b/app/Modules/Armory/Http/Controllers/ArmoryController.php
deleted file mode 100644
index e039839..0000000
--- a/app/Modules/Armory/Http/Controllers/ArmoryController.php
+++ /dev/null
@@ -1,13 +0,0 @@
-<?php
-
-namespace Modules\Armory\Http\Controllers;
-
-use App\Http\Controllers\Controller;
-
-class ArmoryController extends Controller
-{
-    public function index()
-    {
-        return response()->json(['message' => 'Armory module is working']);
-    }
-}
\ No newline at end of file
diff --git a/app/Modules/Armory/Http/routes.php b/app/Modules/Armory/Http/routes.php
deleted file mode 100644
index 422ab84..0000000
--- a/app/Modules/Armory/Http/routes.php
+++ /dev/null
@@ -1,9 +0,0 @@
-<?php
-
-use Illuminate\Support\Facades\Route;
-
-Route::middleware('web')
-    ->prefix(strtolower('Armory'))
-    ->group(function () {
-        Route::get('/', [\Modules\Armory\Http\Controllers\ArmoryController::class, 'index']);
-    });
\ No newline at end of file
diff --git a/app/Modules/Armory/Providers/ArmoryServiceProvider.php b/app/Modules/Armory/Providers/ArmoryServiceProvider.php
deleted file mode 100644
index 6b80901..0000000
--- a/app/Modules/Armory/Providers/ArmoryServiceProvider.php
+++ /dev/null
@@ -1,10 +0,0 @@
-<?php
-
-namespace Modules\Armory\Providers;
-
-use App\Providers\BaseModuleServiceProvider;
-
-class ArmoryServiceProvider extends BaseModuleServiceProvider
-{
-    protected string $moduleName = 'Armory';
-}
\ No newline at end of file
diff --git a/app/Modules/Armory/module.json b/app/Modules/Armory/module.json
deleted file mode 100644
index c7971de..0000000
--- a/app/Modules/Armory/module.json
+++ /dev/null
@@ -1,8 +0,0 @@
-{
-    "name": "Armory",
-    "enabled": true,
-    "routes": true,
-    "migrations": true,
-    "views": true,
-    "namespace": "Modules\\Armory"
-}
\ No newline at end of file
diff --git a/app/Providers/ModuleServiceProvider.php b/app/Providers/ModuleServiceProvider.php
new file mode 100644
index 0000000..634ac24
--- /dev/null
+++ b/app/Providers/ModuleServiceProvider.php
@@ -0,0 +1,16 @@
+<?php
+
+namespace App\Providers;
+
+use Illuminate\Support\ServiceProvider;
+use App\Helpers\ModuleLoader;
+
+class ModuleServiceProvider extends ServiceProvider
+{
+    public function register(): void
+    {
+        foreach (ModuleLoader::getProviders() as $provider) {
+            $this->app->register($provider);
+        }
+    }
+}
diff --git a/bootstrap/providers.php b/bootstrap/providers.php
index 4ed90a5..ae2545d 100755
--- a/bootstrap/providers.php
+++ b/bootstrap/providers.php
@@ -1,8 +1,11 @@
 <?php
 
-return [
+// Core providers
+$providers = [
     App\Providers\AppServiceProvider::class,
     App\Providers\ArmoryServiceProvider::class,
     Spatie\Permission\PermissionServiceProvider::class,
-    Modules\Example\Providers\ExampleServiceProvider::class,
+    App\Providers\ModuleServiceProvider::class,
 ];
+
+return $providers;

From ae8ae4c35306f310f45f82e0fe61858bccb8353c Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 18 Nov 2025 18:25:22 +0100
Subject: [PATCH 003/132] feat(armory): implement modular armory feature with
 repository pattern

- Add new Armory module with MVC structure
- Implement TrinityCore repository for character data
- Create service layer for business logic
- Add blade templates for UI components
- Move existing armory functionality to module
- Update routes and service providers
- Include wowhead integration for item tooltips
---
 .../Interfaces/ArmoryRepositoryInterface.php  |   2 +-
 .../Http/Controllers/ArmoryController.php     |  65 ++++
 app/Modules/Armory/Http/routes.php            |  12 +
 .../TrinityCoreArmoryRepository.php           | 300 ++++++++++++++++++
 .../Providers/ArmoryServiceProvider.php       |  32 +-
 .../Resources/views/armory/index.blade.php    | 166 ++++++++++
 .../armory/partials/achievements.blade.php    |  14 +
 .../armory/partials/equipment-slot.blade.php  |  36 +++
 .../views/armory/partials/equipment.blade.php |  80 +++++
 .../armory/partials/professions.blade.php     |  25 ++
 .../Resources/views/armory/show.blade.php     | 117 +++++++
 .../Armory}/Services/ArmoryService.php        |  16 +-
 app/Modules/Armory/module.json                |   8 +
 app/Providers/AppServiceProvider.php          |   4 +-
 routes/web.php                                |  10 +-
 15 files changed, 844 insertions(+), 43 deletions(-)
 rename app/{ => Modules/Armory/Domain}/Interfaces/ArmoryRepositoryInterface.php (92%)
 create mode 100644 app/Modules/Armory/Http/Controllers/ArmoryController.php
 create mode 100644 app/Modules/Armory/Http/routes.php
 create mode 100644 app/Modules/Armory/Infrastructure/Repositories/TrinityCoreArmoryRepository.php
 rename app/{ => Modules/Armory}/Providers/ArmoryServiceProvider.php (66%)
 create mode 100644 app/Modules/Armory/Resources/views/armory/index.blade.php
 create mode 100644 app/Modules/Armory/Resources/views/armory/partials/achievements.blade.php
 create mode 100644 app/Modules/Armory/Resources/views/armory/partials/equipment-slot.blade.php
 create mode 100644 app/Modules/Armory/Resources/views/armory/partials/equipment.blade.php
 create mode 100644 app/Modules/Armory/Resources/views/armory/partials/professions.blade.php
 create mode 100644 app/Modules/Armory/Resources/views/armory/show.blade.php
 rename app/{ => Modules/Armory}/Services/ArmoryService.php (88%)
 create mode 100644 app/Modules/Armory/module.json

diff --git a/app/Interfaces/ArmoryRepositoryInterface.php b/app/Modules/Armory/Domain/Interfaces/ArmoryRepositoryInterface.php
similarity index 92%
rename from app/Interfaces/ArmoryRepositoryInterface.php
rename to app/Modules/Armory/Domain/Interfaces/ArmoryRepositoryInterface.php
index 92c4fac..671d54a 100644
--- a/app/Interfaces/ArmoryRepositoryInterface.php
+++ b/app/Modules/Armory/Domain/Interfaces/ArmoryRepositoryInterface.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace App\Interfaces;
+namespace Modules\Armory\Domain\Interfaces;
 
 interface ArmoryRepositoryInterface
 {
diff --git a/app/Modules/Armory/Http/Controllers/ArmoryController.php b/app/Modules/Armory/Http/Controllers/ArmoryController.php
new file mode 100644
index 0000000..74f2da0
--- /dev/null
+++ b/app/Modules/Armory/Http/Controllers/ArmoryController.php
@@ -0,0 +1,65 @@
+<?php
+
+namespace Modules\Armory\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use Modules\Armory\Domain\Interfaces\ArmoryRepositoryInterface;
+use Illuminate\Http\Request;
+use App\Services\Parser\WowheadParserService;
+use Modules\Armory\Services\ArmoryService;
+
+class ArmoryController extends Controller
+{
+    protected int $perPage = 9;
+
+    protected array $views = [
+        'index' => 'armory::armory.index',
+        'show'  => 'armory::armory.show',
+    ];
+
+    protected ArmoryRepositoryInterface $armoryRepo;
+    protected WowheadParserService $wowheadParser;
+    protected ArmoryService $armoryService;
+
+    public function __construct(
+        ArmoryRepositoryInterface $armoryRepo,
+        WowheadParserService $wowheadParser,
+        ArmoryService $armoryService
+    ) {
+        $this->armoryRepo = $armoryRepo;
+        $this->wowheadParser = $wowheadParser;
+        $this->armoryService = $armoryService;
+    }
+
+    public function index(Request $request)
+    {
+        $q = $request->input('q');
+        $faction = $request->input('faction') ?: null;
+        $realm = $request->input('realm') ?: 1;
+        $class = $request->input('class') ?: null;
+        $minLevel = $request->input('min_level') ?: null;
+
+        $request->merge(['realm' => $realm]);
+
+        $characters = ($q || $faction || $class || $minLevel)
+            ? $this->armoryService->searchCharacters($q, $faction, $class, $minLevel)
+            : collect();
+
+        return view($this->views['index'], [
+            'data' => $characters,
+            'search' => $q ?? '',
+            'realm' => $realm,
+        ]);
+    }
+
+    public function show(int $guid, Request $request, ?int $realm = null)
+    {
+        $realm = $realm ?: $request->input('realm', 1);
+        $request->merge(['realm' => $realm]);
+
+        $profile = $this->armoryService->getCharacterProfile($guid);
+        abort_if(empty($profile), 404);
+
+        return view($this->views['show'], array_merge($profile, ['realm' => $realm]));
+    }
+}
\ No newline at end of file
diff --git a/app/Modules/Armory/Http/routes.php b/app/Modules/Armory/Http/routes.php
new file mode 100644
index 0000000..0aa2e79
--- /dev/null
+++ b/app/Modules/Armory/Http/routes.php
@@ -0,0 +1,12 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use Modules\Armory\Http\Controllers\ArmoryController;
+
+Route::middleware('web')->group(function () {
+    Route::prefix('armory')->group(function () {
+        Route::get('/', [ArmoryController::class, 'index'])->name('armory');
+        Route::get('{id}', [ArmoryController::class, 'show'])->where('id', '[0-9]+')->name('armory.show');
+        Route::get('{id}/{realm?}', [ArmoryController::class, 'show'])->where('id', '[0-9]+')->where('realm', '[0-9]+')->name('armory.show.realm');
+    });
+});
\ No newline at end of file
diff --git a/app/Modules/Armory/Infrastructure/Repositories/TrinityCoreArmoryRepository.php b/app/Modules/Armory/Infrastructure/Repositories/TrinityCoreArmoryRepository.php
new file mode 100644
index 0000000..28616d8
--- /dev/null
+++ b/app/Modules/Armory/Infrastructure/Repositories/TrinityCoreArmoryRepository.php
@@ -0,0 +1,300 @@
+<?php
+namespace Modules\Armory\Infrastructure\Repositories;
+
+use App\Enums\Professions;
+use Modules\Armory\Domain\Interfaces\ArmoryRepositoryInterface;
+use App\Traits\ConnectsToExternalDatabase;
+use App\Enums\Achievement;
+use Illuminate\Database\Connection;
+use Illuminate\Support\Collection;
+
+class TrinityCoreArmoryRepository implements ArmoryRepositoryInterface
+{
+    /**
+     * Connect to external databases
+     */
+    use ConnectsToExternalDatabase;
+
+    /**
+     * Connection to auth database
+     */
+    protected ?Connection $auth = null;
+    
+    /**
+     * Connection to characters database
+     */
+    protected ?Connection $characters = null;
+
+    /**
+     * Connection to world database
+     */
+    protected ?Connection $world = null;
+    
+    /**
+     * Array with realm configuration
+     */
+    protected array $realmConfig;
+
+    /**
+     * Constructor
+     *
+     * @param array $realmConfig Array with realm configuration
+     */
+    public function __construct(array $realmConfig)
+    {
+        $this->realmConfig = $realmConfig;
+    }
+
+    /**
+     * Get connection to characters database
+     *
+     * @return ?Connection Connection to characters database or null if connection failed
+     */
+    protected function getCharacters(): ?Connection
+    {
+        if (!$this->characters) {
+            $this->characters = $this->connectToExternalDatabase($this->realmConfig['character_database'], 'characters');
+        }
+        return $this->characters;
+    }
+
+    /**
+     * Get connection to world database
+     *
+     * @return ?Connection Connection to world database or null if connection failed
+     */
+    protected function getWorld(): ?Connection
+    {
+        if (!$this->world) {
+            $this->world = $this->connectToExternalDatabase($this->realmConfig['world_database'], 'world');
+        }
+        return $this->world;
+    }
+
+    /**
+     * Get all characters from characters database
+     *
+     * @return Collection Collection of all characters or empty collection if connection failed
+     */
+    public function getAllCharacters()
+    {
+        $conn = $this->getCharacters();
+        if (!$conn) return collect();
+
+        return $conn->table('characters')->get();
+    }
+
+    /**
+     * Search characters by name
+     *
+     * @param string $q Search query
+     * @return Collection Collection of characters matching the query or empty collection if connection failed
+     */
+    public function search(string $q, ?string $faction, ?string $class, ?int $minLevel)
+    {
+        $conn = $this->getCharacters();
+        if (!$conn) return collect();
+
+        $query = $conn->table('characters');
+
+        if ($q) {
+            $query->where('name', 'like', "%{$q}%");
+        }
+
+        if (!empty($faction)) {
+            $races = $faction === 'horde'
+                ? [2, 5, 6, 8, 9, 10]
+                : [1, 3, 4, 7, 11];
+
+            $query->whereIn('race', $races);
+        }
+
+        if ($class) {
+            $query->where('class', $class);
+        }
+        if ($minLevel) {
+            $query->where('level', '>=', $minLevel);
+        }
+        
+        return $query->orderByDesc('level')->get();
+    }
+
+    /**
+     * Get character by GUID
+     *
+     * @param int $guid Character GUID
+     * @return Collection Collection of character or empty collection if connection failed
+     */
+    public function getCharacter(int $guid)
+    {
+        $conn = $this->getCharacters();
+        if (!$conn) return collect();
+
+        return $conn->table('characters')->where('guid', $guid)->first();
+    }
+
+    /**
+     * Get character items by GUID
+     *
+     * @param int $guid Character GUID
+     * @return Collection Collection of character items or empty collection if connection failed
+     */
+    public function getCharacterItems(int $guid)
+    {
+        $characters = $this->getCharacters();
+        $world = $this->getWorld();
+
+        if (!$characters || !$world) return collect();
+
+        $rows = $characters->table('character_inventory AS ci')
+            ->where('ci.guid', $guid)
+            ->whereBetween('ci.slot', [0, 18])
+            ->join('item_instance AS ii', 'ii.guid', '=', 'ci.item')
+            ->orderBy('ci.slot')
+            ->get([
+                'ci.bag',
+                'ci.slot',
+                'ii.itemEntry',
+            ]);
+        
+        return $rows->map(function ($row) {
+            return [
+                'bag'   => $row->bag,
+                'slot'  => $row->slot,
+                'entry' => $row->itemEntry,
+            ];
+        });
+    }
+
+    /**
+     * Get character achievements by GUID
+     *
+     * @param int $guid Character GUID
+     * @return Collection Collection of character achievements or empty collection if connection failed
+     */
+    public function getAchievementsCharacter(int $guid)
+    {
+        $characters = $this->getCharacters();
+        $world = $this->getWorld();
+
+        if (!$characters || !$world) return collect();
+
+        $rows = $characters->table('character_achievement')
+            ->where('guid', $guid)
+            ->whereNotIn('achievement', Achievement::BLOCK_ACHIEVEMENTS)
+            ->orderByDesc('date')
+            ->limit(10)
+            ->get([
+                'achievement',
+                'date'
+            ]);
+        
+        return $rows->map(function ($row) {
+            return [
+                'id' => $row->achievement,
+                'date' => $row->date,
+            ];
+        });
+    }
+
+    /**
+     * Get guild by ID
+     *
+     * @param int $guildId Guild ID
+     * @return Collection Collection of guild or empty collection if connection failed
+     */
+    public function getGuildByMember(int $memberGuid)
+    {
+        $conn = $this->getCharacters();
+        if (!$conn) return collect();
+
+        return $conn->table('guild as g')
+            ->join('guild_member as gm', 'gm.guildid', '=', 'g.guildid')
+            ->where('gm.guid', $memberGuid)
+            ->first();
+    }
+
+    /**
+     * Get guild rank of member
+     *
+     * @param int $guildId Guild ID
+     * @param int $memberGuid Member GUID
+     * @return Collection Collection of guild rank or empty collection if connection failed
+     */
+    public function getGuildRankMember(int $guildId, int $memberGuid)
+    {
+        $conn = $this->getCharacters();
+        if (!$conn) return collect();
+
+        return $conn->table('guild_member as gm')
+            ->join('guild_rank as gr', 'gr.guildid', '=', 'gm.guildid')
+            ->where('gm.guildid', $guildId)
+            ->where('gm.guid', $memberGuid)
+            ->get([
+                'gr.rname',
+            ])->first();
+    }
+
+    /**
+     * Get Skill of character
+     *
+     * @param int $guid Character GUID
+     * @return Collection Collection of skill or empty collection if connection failed
+     */
+    public function getSkillCharacter(int $guid)
+    {
+        $conn = $this->getCharacters();
+        if (!$conn) return collect();
+
+        $skill = $conn->table('character_skills')
+            ->where('guid', $guid) 
+            ->where('professionSlot', 0)
+            ->get([
+                'skill',
+                'max',
+                'value',
+            ]);
+        
+        return $skill->map(function ($row) {
+            return [
+                'id' => $row->skill,
+                'name' => Professions::getName($row->skill),
+                'type' => Professions::getType($row->skill),
+                'icon' => Professions::getIcon($row->skill),
+                'max' => $row->max,
+                'value' => $row->value,
+            ];
+        });
+    }
+
+    /**
+     * Get Arena Team of character
+     *
+     * @param int $guid Character GUID
+     * @return Collection Collection of arena team or empty collection if connection failed
+     */
+    public function getArenaTeam(int $guid)
+    {
+        $conn = $this->getCharacters();
+        if (!$conn) return collect();
+
+        $arenaTeam = $conn->table('arena_team')
+            ->join('arena_team_member as atm', 'atm.arenaTeamId', '=', 'arena_team.arenaTeamId')
+            ->where('atm.guid', $guid)
+            ->get([
+                'arena_team.arenaTeamId',
+                'arena_team.name',
+                'arena_team.rating',
+                'atm.personalRating',
+            ]);
+        
+        return $arenaTeam->map(function ($row) {
+            return [
+                'id' => $row->arenaTeamId,
+                'name' => $row->name,
+                'points' => $row->rating,
+                'personalRating' => $row->personalRating,
+            ];
+        });
+    }
+}
diff --git a/app/Providers/ArmoryServiceProvider.php b/app/Modules/Armory/Providers/ArmoryServiceProvider.php
similarity index 66%
rename from app/Providers/ArmoryServiceProvider.php
rename to app/Modules/Armory/Providers/ArmoryServiceProvider.php
index b0abd4a..5099ea6 100644
--- a/app/Providers/ArmoryServiceProvider.php
+++ b/app/Modules/Armory/Providers/ArmoryServiceProvider.php
@@ -1,18 +1,18 @@
 <?php
 
-namespace App\Providers;
+namespace Modules\Armory\Providers;
 
-use Illuminate\Support\ServiceProvider;
-use App\Repositories\Armory\TrinityCoreArmoryRepository;
-use App\Interfaces\ArmoryRepositoryInterface;
+use App\Providers\BaseModuleServiceProvider;
+use Modules\Armory\Infrastructure\Repositories\TrinityCoreArmoryRepository;
+use Modules\Armory\Domain\Interfaces\ArmoryRepositoryInterface;
 use App\Models\Realm;
 use App\Enums\Emulator;
 
-class ArmoryServiceProvider extends ServiceProvider
+class ArmoryServiceProvider extends BaseModuleServiceProvider
 {
-    /**
-     * Register services.
-     */
+    protected string $moduleName = 'Armory';
+
+
     public function register(): void
     {
         $this->app->bind(ArmoryRepositoryInterface::class, function ($app) {
@@ -32,20 +32,12 @@ public function register(): void
                 'world_database' => json_decode($realm->world_database, true),
             ];
 
-            $emulatorEnum = Emulator::from($realm->emulator); // lanza excepción si no existe
+            $emulatorEnum = Emulator::from($realm->emulator);
 
             return match ($emulatorEnum) {
-                Emulator::TRINITYCORE => new TrinityCoreArmoryRepository($realmConfig),    
+                Emulator::TRINITYCORE => new TrinityCoreArmoryRepository($realmConfig),
                 default => throw new \Exception("Unsupported emulator: $emulator")
             };
         });
-    }
-
-    /**
-     * Bootstrap services.
-     */
-    public function boot(): void
-    {
-        //
-    }
-}
+    } 
+}
\ No newline at end of file
diff --git a/app/Modules/Armory/Resources/views/armory/index.blade.php b/app/Modules/Armory/Resources/views/armory/index.blade.php
new file mode 100644
index 0000000..187de5b
--- /dev/null
+++ b/app/Modules/Armory/Resources/views/armory/index.blade.php
@@ -0,0 +1,166 @@
+@extends('layouts.main')
+
+@section('content')
+<!-- Hero Section with Search -->
+<div class="bg-gradient-to-b from-gray-800 to-gray-900 py-16 border-b border-gray-700">
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+        <div class="text-center mb-12">
+            <h1 class="text-6xl font-bold cinzel mb-4 bg-gradient-to-r from-blue-400 to-purple-500 bg-clip-text text-transparent">
+                Character Armory
+            </h1>
+            <p class="text-gray-400 text-xl">Search and explore character profiles across all realms</p>
+        </div>
+
+        <!-- Advanced Search -->
+        <form action="{{ route('armory') }}" method="GET" class="search-container max-w-4xl mx-auto p-8 rounded-2xl shadow-2xl border border-gray-700">
+            <div class="grid grid-cols-1 md:grid-cols-3 gap-4 mb-6">
+                <div class="md:col-span-2">
+                    <label class="block text-sm font-medium text-gray-400 mb-2">Character Name</label>
+                    <input type="text"
+                           name="q"
+                           id="searchInput"
+                           placeholder="Enter character name..."
+                           value="{{ old('q', request('q')) }}"
+                           class="w-full px-6 py-4 rounded-lg bg-gray-800 border border-gray-700 text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent text-lg">
+                </div>
+                <div class="md:col-span-1">
+                    <label class="block text-sm font-medium text-gray-400 mb-2">Realm</label>
+                    <select name="realm" class="w-full px-4 py-3 rounded-lg bg-gray-800 border border-gray-700 text-white focus:outline-none focus:ring-2 focus:ring-blue-500">
+                        <option value="">Any</option>
+                        @foreach(App\Models\Realm::all() as $realm)
+                            <option value="{{ $realm->id }}" {{ request('realm') == $realm->id ? 'selected' : '' }}>{{ $realm->name }}</option>
+                        @endforeach
+                    </select>
+                </div>
+            </div>
+
+            <div class="grid grid-cols-1 md:grid-cols-3 gap-4 mb-6">
+                <div>
+                    <label class="block text-sm font-medium text-gray-400 mb-2">Faction</label>
+                    <select name="faction" class="w-full px-4 py-3 rounded-lg bg-gray-800 border border-gray-700 text-white focus:outline-none focus:ring-2 focus:ring-blue-500">
+                        <option value="">All Factions</option>
+                        <option value="horde" {{ request('faction') == 'horde' ? 'selected' : '' }}>Horde</option>
+                        <option value="alliance" {{ request('faction') == 'alliance' ? 'selected' : '' }}>Alliance</option>
+                    </select>
+                </div>
+                <div>
+                    <label class="block text-sm font-medium text-gray-400 mb-2">Class</label>
+                    <select name="class" class="w-full px-4 py-3 rounded-lg bg-gray-800 border border-gray-700 text-white focus:outline-none focus:ring-2 focus:ring-blue-500">
+                        <option value="">All Classes</option>
+                        <option value="1" {{ request('class') == '1' ? 'selected' : '' }}>Warrior</option>
+                        <option value="2" {{ request('class') == '2' ? 'selected' : '' }}>Paladin</option>
+                        <option value="3" {{ request('class') == '3' ? 'selected' : '' }}>Hunter</option>
+                        <option value="4" {{ request('class') == '4' ? 'selected' : '' }}>Rogue</option>
+                        <option value="5" {{ request('class') == '5' ? 'selected' : '' }}>Priest</option>
+                        <option value="6" {{ request('class') == '6' ? 'selected' : '' }}>Death Knight</option>
+                        <option value="7" {{ request('class') == '7' ? 'selected' : '' }}>Shaman</option>
+                        <option value="8" {{ request('class') == '8' ? 'selected' : '' }}>Mage</option>
+                        <option value="9" {{ request('class') == '9' ? 'selected' : '' }}>Warlock</option>
+                        <option value="11" {{ request('class') == '11' ? 'selected' : '' }}>Druid</option>
+                    </select>
+                </div>
+                <div>
+                    <label class="block text-sm font-medium text-gray-400 mb-2">Min Level</label>
+                    <select name="min_level" class="w-full px-4 py-3 rounded-lg bg-gray-800 border border-gray-700 text-white focus:outline-none focus:ring-2 focus:ring-blue-500">
+                        <option value="">Any</option>
+                        <option value="80" {{ request('min_level') == '80' ? 'selected' : '' }}>80</option>
+                        <option value="70" {{ request('min_level') == '70' ? 'selected' : '' }}>70</option>
+                        <option value="60" {{ request('min_level') == '60' ? 'selected' : '' }}>60</option>
+                    </select>
+                </div>
+            </div>
+
+            <button type="submit"
+                    class="w-full bg-gradient-to-r from-blue-600 to-purple-600 hover:from-blue-700 hover:to-purple-700 text-white px-8 py-4 rounded-lg font-bold text-lg transition-all duration-300 transform hover:scale-105 shadow-lg hover:shadow-2xl">
+                <i class="fas fa-search mr-3"></i> Search Characters
+            </button>
+        </form>
+    </div>
+    </div>
+
+<!-- Results Section -->
+<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12">
+    <div class="flex items-center justify-between mb-8">
+        <div>
+            <h2 class="text-3xl font-bold cinzel mb-2">Search Results</h2>
+            <p class="text-gray-400">
+                Found <span class="text-blue-400 font-bold"></span> characters
+            </p>
+        </div>
+    </div>
+
+    @if(filled(request('q')) || filled(request('faction')) || filled(request('class')) || filled(request('min_level')))
+        @if($data->count())
+            <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6" id="characterGrid">
+                @foreach($data as $player)
+                    <div class="bg-gray-800 rounded-xl p-6 border border-gray-700 hover:border-gray-600 transition-all">
+                        <div class="flex items-start gap-4 mb-4">
+                            <img src="https://wow.zamimg.com/images/wow/icons/large/achievement_character_{{ strtolower(App\Helpers\RealmHelper::getWoWConstant('race', $player->race)) }}_{{ strtolower($player->gender == 1 ? 'male' : 'female') }}.jpg"
+                                 alt="{{ $player->name }}"
+                                 class="w-20 h-20 rounded-lg border-2 {{ App\Helpers\RealmHelper::getFactionByRace($player->race) === 'horde' ? 'border-red-600' : 'border-blue-600' }}">
+                            <div class="flex-1">
+                                <div class="flex items-center gap-2 mb-1">
+                                    <h3 class="text-2xl font-bold class-{{ strtolower($player->class) }}">{{ $player->name }}</h3>
+                                    <span class="level-badge bg-gray-700 text-white px-2 py-1 rounded text-xs font-bold">{{ $player->level }}</span>
+                                </div>
+                                <p class="text-gray-400 text-sm mb-2">{{ App\Helpers\RealmHelper::getWoWConstant('race', $player->race) }} {{ App\Helpers\RealmHelper::getWoWConstant('class', $player->class) }}</p>
+                                <div class="guild-tag inline-block px-3 py-1 rounded-full text-xs font-medium bg-gray-700 text-gray-300">
+                                    <i class="fas fa-shield-alt mr-1"></i> &lt;{{ $player->guild_name ?? 'N/A' }}&gt;
+                                </div>
+                            </div>
+                        </div>
+
+                        <div class="border-t border-gray-700 pt-4 mb-4">
+                            <div class="flex items-center justify-between text-sm mb-2">
+                                <span class="text-gray-400">Realm</span>
+                                <span class="text-white font-medium">{{ $player->realm_name ?? 'N/A' }}</span>
+                            </div>
+                            <div class="flex items-center justify-between text-sm mb-2">
+                                <span class="text-gray-400">Item Level</span>
+                                <span class="text-purple-400 font-bold">{{ $player->item_level ?? 'N/A' }}</span>
+                            </div>
+                            <div class="flex items-center justify-between text-sm">
+                                <span class="text-gray-400">Achievement Points</span>
+                                <span class="text-yellow-500 font-bold">{{ number_format($player->achievement_points ?? 0) }}</span>
+                            </div>
+                        </div>
+
+                        <div class="flex gap-2 mb-4">
+                            <div class="stats-pill flex-1 px-3 py-2 rounded-lg text-center bg-gray-700">
+                                <div class="text-xs text-gray-400">Arena</div>
+                                <div class="text-sm font-bold text-purple-400">{{ $player->arena_points ?? 0 }}</div>
+                            </div>
+                            <div class="stats-pill flex-1 px-3 py-2 rounded-lg text-center bg-gray-700">
+                                <div class="text-xs text-gray-400">HKs</div>
+                                <div class="text-sm font-bold text-red-400">{{ number_format($player->honorable_kills ?? 0) }}</div>
+                            </div>
+                        </div>
+
+                        <a href="{{ route('armory.show.realm', [$player->guid, $player->realm_id ?? 1]) }}"
+                           class="w-full bg-blue-600 hover:bg-blue-700 text-white py-3 rounded-lg font-medium transition-all duration-300 transform hover:scale-105 inline-block text-center">
+                            <i class="fas fa-eye mr-2"></i> View Profile
+                        </a>
+                    </div>
+                @endforeach
+            </div>
+
+            <!-- Pagination -->
+            <div class="mt-8">
+            </div>
+        @else
+            <div class="max-w-md mx-auto">
+                <div class="bg-yellow-900/30 border border-yellow-700 rounded-lg p-4 text-center">
+                    <div class="flex items-center justify-center mb-2">
+                        <svg class="w-6 h-6 text-yellow-400 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
+                                  d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
+                        </svg>
+                        <h3 class="text-yellow-400 font-semibold">No Character Found</h3>
+                    </div>
+                    <p class="text-yellow-200 text-sm">We couldn't find any character matching your criteria. Please adjust your filters and try again.</p>
+                </div>
+            </div>
+        @endif
+    @endif
+</div>
+@endsection
\ No newline at end of file
diff --git a/app/Modules/Armory/Resources/views/armory/partials/achievements.blade.php b/app/Modules/Armory/Resources/views/armory/partials/achievements.blade.php
new file mode 100644
index 0000000..b594c14
--- /dev/null
+++ b/app/Modules/Armory/Resources/views/armory/partials/achievements.blade.php
@@ -0,0 +1,14 @@
+<div id="achievements-tab" class="tab-content hidden">
+    <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
+        @foreach($achievements as $item)
+        <div class="achievement-badge rounded-xl p-6">
+            <div class="flex items-start gap-4">
+                <a class="text-xl font-bold text-yellow-400 mb-2" href="https://www.wowhead.com/achievement={{ $item['id'] }}" data-wh-icon-size="large" data-wowhead="achievement={{ $item['id'] }}">
+                    <img src="https://wow.zamimg.com/images/wow/icons/large/{{ $item['icon'] ?? 'achievement_boss_lichking' }}.jpg" 
+                        class="w-20 h-20 rounded-lg border-2 border-yellow-500">
+                </a>
+            </div>
+        </div>
+        @endforeach
+    </div>
+</div>
\ No newline at end of file
diff --git a/app/Modules/Armory/Resources/views/armory/partials/equipment-slot.blade.php b/app/Modules/Armory/Resources/views/armory/partials/equipment-slot.blade.php
new file mode 100644
index 0000000..8cb9ec4
--- /dev/null
+++ b/app/Modules/Armory/Resources/views/armory/partials/equipment-slot.blade.php
@@ -0,0 +1,36 @@
+@php
+    $qualityName = $equip['wowhead']['quality']['name'] ?? 'Common';
+    $qualityClass = 'item-quality-' . strtolower($qualityName);
+    $icon = $equip['wowhead']['icon']['name'] ?? 'inv_misc_questionmark';
+    $iconUrl = "https://wow.zamimg.com/images/wow/icons/large/{$icon}.jpg";
+@endphp
+
+<div class="item-slot rounded-xl p-3 flex items-center gap-3 cursor-pointer
+    {{ $equip ? $qualityClass : 'border border-gray-700 text-gray-500' }}"
+    @if($equip) data-wowhead="item={{ $equip['entry'] }}" @endif>
+    
+    <img src="{{ $iconUrl }}" class="w-16 h-16 rounded-lg">
+    
+    <div class="flex-1 min-w-0">
+        <div class="text-xs text-gray-400">{{ $label }}</div>
+        <div class="font-bold truncate
+            @switch(strtolower($qualityName))
+                @case('legendary') text-orange-400 @break
+                @case('epic') text-purple-400 @break
+                @case('rare') text-blue-400 @break
+                @case('uncommon') text-green-400 @break
+                @default text-gray-200
+            @endswitch">
+            {{ $equip['wowhead']['name'] ?? 'No equipado' }}
+        </div>
+        @if(isset($equip['wowhead']['level']))
+            <div class="text-xs text-gray-500">Item Level {{ $equip['wowhead']['level'] }}</div>
+        @endif
+    </div>
+
+    @if($equip && in_array(strtolower($qualityName), ['epic', 'legendary']))
+        <div class="text-2xl {{ strtolower($qualityName) === 'legendary' ? 'text-orange-400' : 'text-purple-400' }}">
+            <i class="fas fa-gem"></i>
+        </div>
+    @endif
+</div>
\ No newline at end of file
diff --git a/app/Modules/Armory/Resources/views/armory/partials/equipment.blade.php b/app/Modules/Armory/Resources/views/armory/partials/equipment.blade.php
new file mode 100644
index 0000000..94c441c
--- /dev/null
+++ b/app/Modules/Armory/Resources/views/armory/partials/equipment.blade.php
@@ -0,0 +1,80 @@
+<div id="equipment-tab" class="tab-content">
+    @php
+        // Orden de slots (según el orden visual clásico de WoW)
+        $slotOrder = [
+            'Head', 'Neck', 'Shoulders', 'Back', 'Chest', 'Wrist',
+            'Hands', 'Waist', 'Legs', 'Feet', 'Finger 1', 'Finger 2',
+            'Trinket 1', 'Trinket 2', 'Main Hand', 'Off Hand'
+        ];
+
+        // Indexación de ítems por slot numérico si lo necesitas más adelante
+        $equippedBySlot = [];
+        foreach ($item as $equip) {
+            $equippedBySlot[$equip['slot']] = $equip;
+        }
+
+        // Conversión simple para mostrar nombre de slot (slot numérico → texto)
+        $slotNames = [
+            0 => 'Head', 1 => 'Neck', 2 => 'Shoulders', 14 => 'Back',
+            4 => 'Chest', 8 => 'Wrist', 9 => 'Hands', 5 => 'Waist',
+            6 => 'Legs', 7 => 'Feet', 10 => 'Finger 1', 11 => 'Finger 2',
+            12 => 'Trinket 1', 13 => 'Trinket 2', 15 => 'Main Hand', 16 => 'Off Hand'
+        ];
+    @endphp
+
+    <div class="grid grid-cols-1 lg:grid-cols-3 gap-8">
+        <!-- LEFT EQUIPMENT -->
+        <div class="space-y-3">
+            @foreach (array_slice($slotNames, 0, 6, true) as $slot => $label)
+                @php $equip = $equippedBySlot[$slot] ?? null; @endphp
+                @include('armory.partials.equipment-slot', ['equip' => $equip, 'label' => $label])
+            @endforeach
+        </div>
+
+        <!-- CENTER - CHARACTER MODEL -->
+        <div class="character-model rounded-2xl p-8 flex items-center justify-center relative overflow-hidden border border-gray-700">
+            <div class="absolute inset-0 bg-gradient-to-b from-transparent via-transparent to-gray-900 opacity-30"></div>
+            <div class="relative z-10 text-center">
+                <img src="https://wow.zamimg.com/images/wow/icons/large/achievement_character_{{ strtolower(App\Helpers\RealmHelper::getWoWConstant('race', $character->race)) }}_{{ strtolower($character->gender == 1 ? 'male' : 'female') }}.jpg"
+                     alt="{{ $character->name }}" class="w-80 h-80 mx-auto mb-6 opacity-90 rounded-full border-4 border-red-600 shadow-2xl">
+            </div>
+        </div>
+
+        <!-- RIGHT EQUIPMENT -->
+        <div class="space-y-3">
+            @foreach (array_slice($slotNames, 6, 6, true) as $slot => $label)
+                @php $equip = $equippedBySlot[$slot] ?? null; @endphp
+                @include('armory::armory.partials.equipment-slot', ['equip' => $equip, 'label' => $label])
+            @endforeach
+        </div>
+    </div>
+
+    <!-- BOTTOM ROW -->
+    <div class="grid grid-cols-2 md:grid-cols-4 gap-4 mt-8">
+        @foreach (array_slice($slotNames, 12, 4, true) as $slot => $label)
+            @php $equip = $equippedBySlot[$slot] ?? null; @endphp
+            <div class="item-slot rounded-xl p-3 cursor-pointer text-center {{ $equip ? 'item-quality-' . strtolower($equip['wowhead']['quality']['name'] ?? 'common') : 'border border-gray-700 text-gray-500' }}"
+                 @if($equip) data-wowhead="item={{ $equip['entry'] }}" @endif>
+                <img src="{{ $equip && isset($equip['wowhead']['icon']['name'])
+                    ? 'https://wow.zamimg.com/images/wow/icons/large/' . $equip['wowhead']['icon']['name'] . '.jpg'
+                    : 'https://wow.zamimg.com/images/wow/icons/large/inv_misc_questionmark.jpg' }}"
+                    class="w-16 h-16 rounded-lg mx-auto mb-2">
+                <div>
+                    <div class="text-xs text-gray-400">{{ $label }}</div>
+                    <div class="font-bold text-sm truncate @switch(strtolower($equip['wowhead']['quality']['name'] ?? 'common'))
+                        @case('legendary') text-orange-400 @break
+                        @case('epic') text-purple-400 @break
+                        @case('rare') text-blue-400 @break
+                        @case('uncommon') text-green-400 @break
+                        @default text-gray-200
+                    @endswitch">
+                        {{ $equip['wowhead']['name'] ?? 'No equipado' }}
+                    </div>
+                    @if(isset($equip['wowhead']['level']))
+                        <div class="text-xs text-gray-500">iLvl {{ $equip['wowhead']['level'] }}</div>
+                    @endif
+                </div>
+            </div>
+        @endforeach
+    </div>
+</div>
\ No newline at end of file
diff --git a/app/Modules/Armory/Resources/views/armory/partials/professions.blade.php b/app/Modules/Armory/Resources/views/armory/partials/professions.blade.php
new file mode 100644
index 0000000..eaaf201
--- /dev/null
+++ b/app/Modules/Armory/Resources/views/armory/partials/professions.blade.php
@@ -0,0 +1,25 @@
+<div id="professions-tab" class="tab-content hidden">
+    <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
+        @foreach($skill as $item)
+        <div class="stat-card rounded-xl p-6">
+            <div class="flex items-center gap-4 mb-6">
+                <img src="{{ $item['icon'] }}" 
+                    class="w-20 h-20 rounded-lg border-2 border-orange-500">
+                <div>
+                    <h3 class="text-2xl font-bold">{{ $item['name'] }}</h3>
+                    <p class="text-gray-400">{{ ucfirst($item['type']) }}</p>
+                </div>
+            </div>
+            <div class="mb-6">
+                <div class="flex justify-between mb-2">
+                    <span class="text-gray-400 font-medium">Skill Level</span>
+                    <span class="font-bold text-green-400 text-xl">{{ $item['value'] }} / {{ $item['max'] }}</span>
+                </div>
+                <div class="w-full bg-gray-700 rounded-full h-4">
+                    <div class="bg-gradient-to-r from-green-500 to-green-600 h-4 rounded-full" style="width: {{ $item['value'] / $item['max'] * 100 }}%"></div>
+                </div>
+            </div>
+        </div>
+        @endforeach
+    </div>
+</div>
\ No newline at end of file
diff --git a/app/Modules/Armory/Resources/views/armory/show.blade.php b/app/Modules/Armory/Resources/views/armory/show.blade.php
new file mode 100644
index 0000000..f80bbd3
--- /dev/null
+++ b/app/Modules/Armory/Resources/views/armory/show.blade.php
@@ -0,0 +1,117 @@
+@extends('layouts.main')
+
+@section('content')
+<div class="hero-bg pt-32 pb-16 relative">
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 relative z-10">
+        <div class="flex items-start gap-8 flex-wrap lg:flex-nowrap">
+            <!-- Character Portrait -->
+            <div class="flex-shrink-0">
+                <div class="relative">
+                    <img src="https://wow.zamimg.com/images/wow/icons/large/achievement_character_{{ strtolower(App\Helpers\RealmHelper::getWoWConstant('race', $character->race)) }}_{{ strtolower($character->gender == 1 ? 'male' : 'female') }}.jpg" 
+                        alt="Character" class="w-48 h-48 rounded-2xl border-4 border-red-600 shadow-2xl">
+                    <div class="absolute -bottom-4 -right-4 bg-gradient-to-br from-yellow-500 to-orange-600 rounded-full w-20 h-20 flex items-center justify-center border-4 border-gray-900 shadow-xl">
+                        <span class="text-3xl font-bold">{{ $character->level ?? '??' }}</span>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Character Info -->
+            <div class="flex-1">
+                <div class="flex items-center gap-4 mb-4">
+                    <h1 class="text-6xl font-bold cinzel class-{{ strtolower(App\Helpers\RealmHelper::getWoWConstant('class', $character->class ?? 1)) }}">{{ $character->name ?? 'Unknown' }}</h1>
+                    <span class="px-4 py-2 {{ App\Helpers\RealmHelper::getFactionByRace($character->race ?? 1) === 'horde' ? 'bg-red-600' : 'bg-blue-600' }} rounded-lg font-bold text-lg">
+                        <i class="fas fa-fist-raised mr-2"></i> {{ strtoupper(App\Helpers\RealmHelper::getFactionByRace($character->race ?? 1)) }}
+                    </span>
+                </div>
+                
+                <div class="flex items-center gap-6 text-xl mb-6">
+                    <span class="flex items-center gap-2">
+                        <i class="fas fa-user text-red-400"></i> {{ App\Helpers\RealmHelper::getWoWConstant('race', $character->race ?? 1) }} / {{ App\Helpers\RealmHelper::getWoWConstant('class', $character->class ?? 1) }}
+                    </span>
+                    <span class="flex items-center gap-2">
+                        <i class="fas fa-server text-purple-400"></i> {{ App\Helpers\RealmHelper::find($realm)->name }}
+                    </span>
+                </div>
+
+                <!-- Guild -->
+                @if($guild && $memberRank)
+                <div class="guild-banner inline-block px-6 py-3 rounded-xl mb-6">
+                    <div class="flex items-center gap-3">
+                        <i class="fas fa-shield-alt text-2xl"></i>
+                        <div>
+                            <div class="text-sm text-purple-200">{{ $memberRank->rname ?? 'Member' }} of</div>
+                            <div class="text-xl font-bold">&lt;{{ $guild->name ?? 'Unknown Guild' }}&gt;</div>
+                        </div>
+                    </div>
+                </div>
+                @endif
+
+                <!-- Quick Stats -->
+                <div class="grid grid-cols-1 md:grid-cols-3 gap-4">
+                    <div class="stat-card p-4 rounded-xl">
+                        <div class="text-gray-400 text-sm mb-1">Item Level</div>
+                        <div class="text-3xl font-bold text-purple-400">{{ $promedItemLevel ?? '0' }}</div>
+                    </div>
+                    <div class="stat-card p-4 rounded-xl">
+                        <div class="text-gray-400 text-sm mb-1">Arena Rating</div>
+                        <div class="text-3xl font-bold text-purple-500">{{ $arenaTeam[0]['personalRating'] ?? '0' }}</div>
+                    </div>
+                    <div class="stat-card p-4 rounded-xl">
+                        <div class="text-gray-400 text-sm mb-1">Honorable Kills</div>
+                        <div class="text-3xl font-bold text-red-400">{{ $character->totalKills ?? '0' }}</div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+}</div>
+<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
+    <!-- Tabs -->
+    <div class="mb-8 overflow-x-full">
+        <div class="flex gap-2 border-b border-gray-700 min-w-max">
+            <button class="tab-btn active px-8 py-4 font-bold rounded-t-lg" onclick="switchTab('equipment')">
+                <i class="fas fa-vest mr-2"></i> Equipment
+            </button>
+            <button class="tab-btn px-8 py-4 font-bold rounded-t-lg text-gray-400 hover:text-white hover:bg-gray-800" onclick="switchTab('achievements')">
+                <i class="fas fa-trophy mr-2"></i> Achievements
+            </button>
+            <button class="tab-btn px-8 py-4 font-bold rounded-t-lg text-gray-400 hover:text-white hover:bg-gray-800" onclick="switchTab('professions')">
+                <i class="fas fa-hammer mr-2"></i> Professions
+            </button>
+        </div>
+    </div>
+
+    @include('armory::armory.partials.equipment', ['item' => $items ?? collect()])
+    @include('armory::armory.partials.achievements', ['achievements' => $achievement ?? collect()])
+    @include('armory::armory.partials.professions', ['skill' => $skill ?? collect()])
+</div>
+
+<script>
+    function switchTab(tabName) {
+        // Hide all tabs
+        document.querySelectorAll('.tab-content').forEach(tab => {
+            tab.classList.add('hidden');
+        });
+        
+        // Remove active class from all buttons
+        document.querySelectorAll('.tab-btn').forEach(btn => {
+            btn.classList.remove('active');
+            btn.classList.add('text-gray-400', 'hover:text-white', 'hover:bg-gray-800');
+        });
+        
+        // Show selected tab
+        document.getElementById(tabName + '-tab').classList.remove('hidden');
+        
+        // Add active class to clicked button
+        event.target.closest('.tab-btn').classList.add('active');
+        event.target.closest('.tab-btn').classList.remove('text-gray-400', 'hover:text-white', 'hover:bg-gray-800');
+    }
+    
+    const whTooltips = {
+        colorLinks: true,
+        iconizeLinks: true,
+        renameLinks: true
+    };
+</script>
+<script src="https://wow.zamimg.com/js/tooltips.js"></script>
+@endsection
\ No newline at end of file
diff --git a/app/Services/ArmoryService.php b/app/Modules/Armory/Services/ArmoryService.php
similarity index 88%
rename from app/Services/ArmoryService.php
rename to app/Modules/Armory/Services/ArmoryService.php
index ec82bda..1081d4b 100644
--- a/app/Services/ArmoryService.php
+++ b/app/Modules/Armory/Services/ArmoryService.php
@@ -1,8 +1,8 @@
 <?php
 
-namespace App\Services;
+namespace Modules\Armory\Services;
 
-use App\Interfaces\ArmoryRepositoryInterface;
+use Modules\Armory\Domain\Interfaces\ArmoryRepositoryInterface;
 use App\Helpers\RealmHelper;
 use App\Services\Parser\WowheadParserService;
 use Illuminate\Support\Collection;
@@ -20,9 +20,6 @@ public function __construct(
         $this->wowheadParser = $wowheadParser;
     }
 
-    /**
-     * Get complete character profile data
-     */
     public function getCharacterProfile(int $guid): array
     {
         $character = $this->armoryRepo->getCharacter($guid);
@@ -51,9 +48,6 @@ public function getCharacterProfile(int $guid): array
         ];
     }
 
-    /**
-     * Get character items enriched with Wowhead data
-     */
     public function getEnrichedCharacterItems(int $guid): Collection
     {
         $items = $this->armoryRepo->getCharacterItems($guid);
@@ -64,9 +58,6 @@ public function getEnrichedCharacterItems(int $guid): Collection
         });
     }
 
-    /**
-     * Calculate average item level from enriched items
-     */
     public function calculateAverageItemLevel(Collection $items): int
     {
         $itemLevels = $items->pluck('wowhead.level')
@@ -76,9 +67,6 @@ public function calculateAverageItemLevel(Collection $items): int
         return (int) RealmHelper::calculateItemLevelPromed($itemLevels);
     }
 
-    /**
-     * Search characters with filters
-     */
     public function searchCharacters(
         string $q = '',
         ?string $faction = null,
diff --git a/app/Modules/Armory/module.json b/app/Modules/Armory/module.json
new file mode 100644
index 0000000..59c64ab
--- /dev/null
+++ b/app/Modules/Armory/module.json
@@ -0,0 +1,8 @@
+{
+    "name": "Armorytest",
+    "enabled": true,
+    "routes": true,
+    "migrations": true,
+    "views": true,
+    "namespace": "Modules\\Armorytest"
+}
\ No newline at end of file
diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php
index 5a4632d..907465f 100755
--- a/app/Providers/AppServiceProvider.php
+++ b/app/Providers/AppServiceProvider.php
@@ -4,9 +4,9 @@
 
 use Illuminate\Support\ServiceProvider;
 use Illuminate\Support\Facades\Config;
-use App\Services\ArmoryService;
+use Modules\Armory\Services\ArmoryService;
 use App\Services\Parser\WowheadParserService;
-use App\Interfaces\ArmoryRepositoryInterface;
+use Modules\Armory\Domain\Interfaces\ArmoryRepositoryInterface;
 
 class AppServiceProvider extends ServiceProvider
 {
diff --git a/routes/web.php b/routes/web.php
index 0f36f26..939870d 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -1,6 +1,5 @@
 <?php
 
-use App\Http\Controllers\Frontend\ArmoryController;
 use App\Http\Controllers\Frontend\HomeController;
 use App\Http\Controllers\Frontend\NewsController;
 use App\Http\Controllers\Frontend\Users\UserController;
@@ -45,17 +44,16 @@
 Route::prefix('news')->group(function () {
     Route::get('/', [NewsController::class, 'index'])->name('news');
     Route::get('/{slug}', [NewsController::class, 'show'])->name('news.show');
-});
-Route::prefix('armory')->group(function () {
-    Route::get('/', [ArmoryController::class, 'index'])->name('armory');
-    Route::get('{id}', [ArmoryController::class, 'show'])->where('id', '[0-9]+')->name('armory.show');
-    Route::get('{id}/{realm?}', [ArmoryController::class, 'show'])->where('id', '[0-9]+')->where('realm', '[0-9]+')->name('armory.show.realm');
+    // Comments for news
     Route::post('/{slug}/comment', [CommentController::class, 'store'])->name('news.comment.store');
     Route::delete('/comment/{id}', [CommentController::class, 'destroy'])->name('news.comment.destroy');
+    // Newsletter subscription under news
     Route::post('/subscribe', [SubscriptionController::class, 'subscribe'])->name('subscribe');
     Route::get('/confirm-subscription/{token}', [SubscriptionController::class, 'confirmSubscription'])->name('confirm.subscription');
     Route::get('/unsubscribe/{token}', [SubscriptionController::class, 'unsubscribe'])->name('unsubscribe');
 });
+// Armory: ahora servido desde el módulo ArmoryTest
+// Se dejan las rutas de comentarios/suscripción bajo news (si aplica) o se reubican aparte
 
 Route::prefix('auth')->group(function () {
     Route::get('/login', [AuthController::class,'showLoginForm'])->name('login');

From 8df5f238ced65856c88744a1fd23c90119dca2a5 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 18 Nov 2025 18:31:54 +0100
Subject: [PATCH 004/132] refactor(module-structure): simplify module directory
 structure and clean up code

- Remove redundant App/Services, App/UseCases, and App/DTOs from module creation
- Add PHPDoc comments to ArmoryController for better documentation
- Clean up blade template comments and improve readability
- Remove outdated comments from routes file
---
 app/Console/Commands/MakeModuleCommand.php    |  4 +-
 .../Http/Controllers/ArmoryController.php     | 48 +++++++++++++++++++
 .../views/armory/partials/equipment.blade.php | 10 ----
 routes/web.php                                | 13 +----
 4 files changed, 51 insertions(+), 24 deletions(-)

diff --git a/app/Console/Commands/MakeModuleCommand.php b/app/Console/Commands/MakeModuleCommand.php
index 3554717..58419bf 100644
--- a/app/Console/Commands/MakeModuleCommand.php
+++ b/app/Console/Commands/MakeModuleCommand.php
@@ -33,9 +33,7 @@ public function handle(): int
 
         // Estructura de carpetas
         $directories = [
-            'App/Services',
-            'App/UseCases',
-            'App/DTOs',
+            'Services',
             'Domain/Models',
             'Domain/Interfaces',
             'Infrastructure/Repositories',
diff --git a/app/Modules/Armory/Http/Controllers/ArmoryController.php b/app/Modules/Armory/Http/Controllers/ArmoryController.php
index 74f2da0..db0c026 100644
--- a/app/Modules/Armory/Http/Controllers/ArmoryController.php
+++ b/app/Modules/Armory/Http/Controllers/ArmoryController.php
@@ -10,17 +10,51 @@
 
 class ArmoryController extends Controller
 {
+    /**
+     * Number of characters to display per page in listings.
+     *
+     * @var int
+     */
     protected int $perPage = 9;
 
+    /**
+     * View paths used by the controller.
+     *
+     * @var array<string,string>
+     */
     protected array $views = [
         'index' => 'armory::armory.index',
         'show'  => 'armory::armory.show',
     ];
 
+    /**
+     * Armory repository instance.
+     *
+     * @var ArmoryRepositoryInterface
+     */
     protected ArmoryRepositoryInterface $armoryRepo;
+
+    /**
+     * Wowhead parser service instance.
+     *
+     * @var WowheadParserService
+     */
     protected WowheadParserService $wowheadParser;
+
+    /**
+     * Armory service instance.
+     *
+     * @var ArmoryService
+     */
     protected ArmoryService $armoryService;
 
+    /**
+     * ArmoryController constructor.
+     *
+     * @param ArmoryRepositoryInterface $armoryRepo     Armory repository instance.
+     * @param WowheadParserService      $wowheadParser  Wowhead parser service instance.
+     * @param ArmoryService             $armoryService  Armory service instance.
+     */
     public function __construct(
         ArmoryRepositoryInterface $armoryRepo,
         WowheadParserService $wowheadParser,
@@ -31,6 +65,12 @@ public function __construct(
         $this->armoryService = $armoryService;
     }
 
+    /**
+     * Display the character index page.
+     *
+     * @param Request $request Incoming request
+     * @return \Illuminate\View\View
+     */
     public function index(Request $request)
     {
         $q = $request->input('q');
@@ -52,6 +92,14 @@ public function index(Request $request)
         ]);
     }
 
+    /**
+     * Display the character profile page.
+     *
+     * @param int         $guid    Character GUID
+     * @param Request     $request Incoming request
+     * @param int|null    $realm   Realm ID (optional)
+     * @return \Illuminate\View\View
+     */
     public function show(int $guid, Request $request, ?int $realm = null)
     {
         $realm = $realm ?: $request->input('realm', 1);
diff --git a/app/Modules/Armory/Resources/views/armory/partials/equipment.blade.php b/app/Modules/Armory/Resources/views/armory/partials/equipment.blade.php
index 94c441c..d092c67 100644
--- a/app/Modules/Armory/Resources/views/armory/partials/equipment.blade.php
+++ b/app/Modules/Armory/Resources/views/armory/partials/equipment.blade.php
@@ -1,19 +1,16 @@
 <div id="equipment-tab" class="tab-content">
     @php
-        // Orden de slots (según el orden visual clásico de WoW)
         $slotOrder = [
             'Head', 'Neck', 'Shoulders', 'Back', 'Chest', 'Wrist',
             'Hands', 'Waist', 'Legs', 'Feet', 'Finger 1', 'Finger 2',
             'Trinket 1', 'Trinket 2', 'Main Hand', 'Off Hand'
         ];
 
-        // Indexación de ítems por slot numérico si lo necesitas más adelante
         $equippedBySlot = [];
         foreach ($item as $equip) {
             $equippedBySlot[$equip['slot']] = $equip;
         }
 
-        // Conversión simple para mostrar nombre de slot (slot numérico → texto)
         $slotNames = [
             0 => 'Head', 1 => 'Neck', 2 => 'Shoulders', 14 => 'Back',
             4 => 'Chest', 8 => 'Wrist', 9 => 'Hands', 5 => 'Waist',
@@ -23,15 +20,12 @@
     @endphp
 
     <div class="grid grid-cols-1 lg:grid-cols-3 gap-8">
-        <!-- LEFT EQUIPMENT -->
         <div class="space-y-3">
             @foreach (array_slice($slotNames, 0, 6, true) as $slot => $label)
                 @php $equip = $equippedBySlot[$slot] ?? null; @endphp
                 @include('armory.partials.equipment-slot', ['equip' => $equip, 'label' => $label])
             @endforeach
         </div>
-
-        <!-- CENTER - CHARACTER MODEL -->
         <div class="character-model rounded-2xl p-8 flex items-center justify-center relative overflow-hidden border border-gray-700">
             <div class="absolute inset-0 bg-gradient-to-b from-transparent via-transparent to-gray-900 opacity-30"></div>
             <div class="relative z-10 text-center">
@@ -39,8 +33,6 @@
                      alt="{{ $character->name }}" class="w-80 h-80 mx-auto mb-6 opacity-90 rounded-full border-4 border-red-600 shadow-2xl">
             </div>
         </div>
-
-        <!-- RIGHT EQUIPMENT -->
         <div class="space-y-3">
             @foreach (array_slice($slotNames, 6, 6, true) as $slot => $label)
                 @php $equip = $equippedBySlot[$slot] ?? null; @endphp
@@ -48,8 +40,6 @@
             @endforeach
         </div>
     </div>
-
-    <!-- BOTTOM ROW -->
     <div class="grid grid-cols-2 md:grid-cols-4 gap-4 mt-8">
         @foreach (array_slice($slotNames, 12, 4, true) as $slot => $label)
             @php $equip = $equippedBySlot[$slot] ?? null; @endphp
diff --git a/routes/web.php b/routes/web.php
index 939870d..58bf602 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -16,8 +16,8 @@
 
 Route::get('/test-redis', function() {
     try {
-        $pong = Redis::ping(); // devuelve +PONG
-        $keys = Redis::keys('*'); // lista todas las keys
+        $pong = Redis::ping();
+        $keys = Redis::keys('*');
         return response()->json([
             'connected' => $pong === '+PONG',
             'keys_count' => count($keys),
@@ -44,16 +44,12 @@
 Route::prefix('news')->group(function () {
     Route::get('/', [NewsController::class, 'index'])->name('news');
     Route::get('/{slug}', [NewsController::class, 'show'])->name('news.show');
-    // Comments for news
     Route::post('/{slug}/comment', [CommentController::class, 'store'])->name('news.comment.store');
     Route::delete('/comment/{id}', [CommentController::class, 'destroy'])->name('news.comment.destroy');
-    // Newsletter subscription under news
     Route::post('/subscribe', [SubscriptionController::class, 'subscribe'])->name('subscribe');
     Route::get('/confirm-subscription/{token}', [SubscriptionController::class, 'confirmSubscription'])->name('confirm.subscription');
     Route::get('/unsubscribe/{token}', [SubscriptionController::class, 'unsubscribe'])->name('unsubscribe');
 });
-// Armory: ahora servido desde el módulo ArmoryTest
-// Se dejan las rutas de comentarios/suscripción bajo news (si aplica) o se reubican aparte
 
 Route::prefix('auth')->group(function () {
     Route::get('/login', [AuthController::class,'showLoginForm'])->name('login');
@@ -63,7 +59,6 @@
     Route::post('/logout', [AuthController::class, 'logout'])->name('logout');
 });
 
-// Rutas para users
 Route::prefix('ucp')->middleware(['auth', 'role:User,GameMaster,Admin'])->group(function () {
     Route::get('/', [UserController::class, 'show'])->name('ucp.dashboard');
     Route::get('/gameaccount', [UserController::class, 'gameAccount'])->name('ucp.gameaccount');
@@ -73,18 +68,14 @@
     Route::get('/manage', [UserController::class, 'manage'])->name('ucp.manageAccount');
 });
 
-// Forums routes
 Route::prefix('forums')->group(function () {
     Route::get('/', [ForumsController::class, 'index'])->name('forums');
-    
-    // Routes that require authentication
     Route::prefix('ucp')->middleware(['auth', 'role:User,GameMaster,Admin'])->group(function () {
         Route::get('/{slug}/create', [ForumsController::class, 'createThread'])->name('forums.create_thread');
         Route::post('/{slug}/create', [ForumsController::class, 'storeThread'])->name('forums.store_thread');
         Route::post('/{forumSlug}/{threadSlug}/reply', [ForumsController::class, 'storePost'])->name('forums.store_post');
     });
     
-    // These routes must be defined after the more specific routes above
     Route::get('/{forumSlug}/{threadSlug}', [ForumsController::class, 'showThread'])->name('forums.thread');
     Route::get('/{slug}', [ForumsController::class, 'showForum'])->name('forums.show');
 });

From bfe343d48118c388989122574fb04085d5ea543f Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 18 Nov 2025 18:40:56 +0100
Subject: [PATCH 005/132] refactor(MakeModuleCommand): improve module
 scaffolding command

- Add PHPDoc comments for better code documentation
- Implement --force option to overwrite existing modules
- Clean up code formatting and indentation
- Improve generated files structure and readability
---
 app/Console/Commands/MakeModuleCommand.php | 88 +++++++++++++---------
 1 file changed, 52 insertions(+), 36 deletions(-)

diff --git a/app/Console/Commands/MakeModuleCommand.php b/app/Console/Commands/MakeModuleCommand.php
index 58419bf..56db658 100644
--- a/app/Console/Commands/MakeModuleCommand.php
+++ b/app/Console/Commands/MakeModuleCommand.php
@@ -6,20 +6,32 @@
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\Str;
 
+/**
+ * Artisan command to scaffold a new module.
+ *
+ * Generates the full folder structure, base controller,
+ * service provider and configuration files.
+ */
 class MakeModuleCommand extends Command
 {
     /**
-     * Nombre del comando para Artisan
+     * The console command signature.
+     *
+     * @var string
      */
     protected $signature = 'make:module {name : The name of the module} {--force : Overwrite existing module if it exists}';
 
     /**
-     * Descripción
+     * The console command description.
+     *
+     * @var string
      */
     protected $description = 'Create a new module with its folder structure and base ServiceProvider';
 
     /**
-     * Ejecuta el comando
+     * Execute the console command.
+     *
+     * @return int Exit code: 0 on success, 1 on failure.
      */
     public function handle(): int
     {
@@ -31,7 +43,12 @@ public function handle(): int
             return self::FAILURE;
         }
 
-        // Estructura de carpetas
+        // Ensure clean slate when --force is used
+        if ($this->option('force') && File::exists($path)) {
+            File::deleteDirectory($path);
+        }
+
+        // Directory structure to be created inside the module
         $directories = [
             'Services',
             'Domain/Models',
@@ -48,7 +65,7 @@ public function handle(): int
             File::makeDirectory("{$path}/{$dir}", 0755, true, true);
         }
 
-        // module.json
+        // Generate module.json configuration file
         $moduleJson = [
             'name' => $name,
             'enabled' => true,
@@ -60,55 +77,54 @@ public function handle(): int
 
         File::put("{$path}/module.json", json_encode($moduleJson, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
 
-        // routes.php
+        // Generate default routes file
         $routes = <<<PHP
-        <?php
+<?php
 
-        use Illuminate\\Support\\Facades\\Route;
+use Illuminate\\Support\\Facades\\Route;
 
-        Route::middleware('web')
-            ->prefix(strtolower('{$name}'))
-            ->group(function () {
-                Route::get('/', [\\Modules\\{$name}\\Http\\Controllers\\{$name}Controller::class, 'index']);
-            });
-        PHP;
+Route::middleware('web')
+    ->prefix(strtolower('{$name}'))
+    ->group(function () {
+        Route::get('/', [\\Modules\\{$name}\\Http\\Controllers\\{$name}Controller::class, 'index']);
+    });
+PHP;
         File::put("{$path}/Http/routes.php", $routes);
 
-        // Controller base
+        // Generate base controller
         $controller = <<<PHP
-        <?php
+<?php
 
-        namespace Modules\\{$name}\\Http\\Controllers;
+namespace Modules\\{$name}\\Http\\Controllers;
 
-        use App\\Http\\Controllers\\Controller;
+use App\\Http\\Controllers\\Controller;
 
-        class {$name}Controller extends Controller
-        {
-            public function index()
-            {
-                return response()->json(['message' => '{$name} module is working']);
-            }
-        }
-        PHP;
+class {$name}Controller extends Controller
+{
+    public function index()
+    {
+        return response()->json(['message' => '{$name} module is working']);
+    }
+}
+PHP;
         File::put("{$path}/Http/Controllers/{$name}Controller.php", $controller);
 
-        // ServiceProvider
+        // Generate module service provider
         $provider = <<<PHP
-        <?php
+<?php
 
-        namespace Modules\\{$name}\\Providers;
+namespace Modules\\{$name}\\Providers;
 
-        use App\\Providers\\BaseModuleServiceProvider;
+use App\\Providers\\BaseModuleServiceProvider;
 
-        class {$name}ServiceProvider extends BaseModuleServiceProvider
-        {
-            protected string \$moduleName = '{$name}';
-        }
-        PHP;
+class {$name}ServiceProvider extends BaseModuleServiceProvider
+{
+    protected string \$moduleName = '{$name}';
+}
+PHP;
         File::put("{$path}/Providers/{$name}ServiceProvider.php", $provider);
 
         $this->info("Module [{$name}] created successfully at app/Modules/{$name}");
         return self::SUCCESS;
     }
 }
-

From 85cbb6ba16e4cd574a98558916ecbb407a51139e Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 27 Nov 2025 23:04:07 +0100
Subject: [PATCH 006/132] build: update laravel framework and remove mysql ssl
 options

Update Laravel framework from 12.34.0 to 12.40.2 and remove MySQL SSL connection options that are no longer needed
---
 .../Controllers/Frontend/HomeController.php   |  29 +-
 app/Libraries/Redis/RedisLibrary.php          | 170 ++++
 app/Providers/AppServiceProvider.php          |  13 +-
 bootstrap/providers.php                       |   1 -
 composer.json                                 |   2 +-
 composer.lock                                 | 788 +++++++++---------
 config/database.php                           |  20 +-
 7 files changed, 587 insertions(+), 436 deletions(-)
 create mode 100644 app/Libraries/Redis/RedisLibrary.php

diff --git a/app/Http/Controllers/Frontend/HomeController.php b/app/Http/Controllers/Frontend/HomeController.php
index 4c43fc6..dfc92d7 100644
--- a/app/Http/Controllers/Frontend/HomeController.php
+++ b/app/Http/Controllers/Frontend/HomeController.php
@@ -6,6 +6,7 @@
 use App\Helpers\RealmHelper;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\View;
+use App\Libraries\Redis\RedisLibrary;
 use App\Models\News;
 
 /**
@@ -48,18 +49,36 @@ class HomeController extends Controller
      * @param string|null $view
      * @return \Illuminate\Contracts\View\View
      */
-    public function index(Request $request, ?string $view = null)
+    public function index(Request $request, \App\Libraries\Redis\RedisLibrary $redis, ?string $view = null)
     {
         $realms = RealmHelper::all();
         $perPage = $request->get('per_page', $this->perPage);
-    
-        $allNews = \App\Models\News::query()
+        $page = (int) ($request->get('page', 1));
+
+        $cacheKey = "news:list:perpage:{$perPage}:page:{$page}";
+        $featuredKey = 'home_featured';
+
+        $news = $redis->get($cacheKey);
+        $featuredNews = $redis->get($featuredKey);
+
+        if (!$news || !$featuredNews) {
+            $allNews = \App\Models\News::query()
                 ->orderBy('created_at', 'desc')
                 ->paginate($perPage);
 
-        $featuredNews = $allNews->shift();
-        $news = $allNews;
+            $featuredNews = $allNews->shift();
+            $news = $allNews;
+
+            $redis->set($cacheKey, $news, 60);
+            $redis->set($featuredKey, $featuredNews, 60);
+        }   
     
+        if ($featuredNews)
+        {
+            
+        var_dump($featuredNews);
+        die();
+        }
         $data = [
             'realms' => $realms,
             'featuredNews' => $featuredNews,
diff --git a/app/Libraries/Redis/RedisLibrary.php b/app/Libraries/Redis/RedisLibrary.php
new file mode 100644
index 0000000..5967983
--- /dev/null
+++ b/app/Libraries/Redis/RedisLibrary.php
@@ -0,0 +1,170 @@
+<?php
+
+namespace App\Libraries\Redis;
+
+use Illuminate\Support\Facades\Redis;
+
+/**
+ * Class RedisLibrary
+ *
+ * A Laravel-friendly Redis wrapper providing cached key-value operations,
+ * TTL helpers, increment/decrement utilities, and token management.
+ */
+class RedisLibrary
+{
+    /** @var string Global key prefix */
+    private string $prefix;
+
+    /**
+     * RedisLibrary constructor.
+     *
+     * @param string $prefix Optional key prefix
+     */
+    public function __construct(string $prefix = '')
+    {
+        $this->prefix = $prefix;
+    }
+
+    /**
+     * Build a namespaced key.
+     *
+     * @param string $key
+     * @return string
+     */
+    private function key(string $key): string
+    {
+        return $this->prefix . $key;
+    }
+
+    /* ======================================================
+     * Basic Key/Value Methods
+     * ====================================================== */
+
+    /**
+     * Store a value in Redis.
+     *
+     * @param string $key
+     * @param mixed  $value
+     * @param int    $ttl  Expiration time in seconds (0 = persistent)
+     *
+     * @return bool
+     */
+    public function set(string $key, mixed $value, int $ttl = 0): bool
+    {
+        $key = $this->key($key);
+
+        if ($ttl > 0) {
+            return Redis::setex($key, $ttl, json_encode($value));
+        }
+
+        return Redis::set($key, json_encode($value));
+    }
+
+    /**
+     * Retrieve a value from Redis and decode it.
+     *
+     * @param string $key
+     * @return mixed|null
+     */
+    public function get(string $key): mixed
+    {
+        $value = Redis::get($this->key($key));
+        return $value ? json_decode($value, true) : null;
+    }
+
+    /**
+     * Delete a Redis key.
+     *
+     * @param string $key
+     * @return bool
+     */
+    public function delete(string $key): bool
+    {
+        return Redis::del($this->key($key)) > 0;
+    }
+
+    /**
+     * Determine if a key exists.
+     *
+     * @param string $key
+     * @return bool
+     */
+    public function exists(string $key): bool
+    {
+        return Redis::exists($this->key($key)) === 1;
+    }
+
+    /**
+     * Get the TTL of a stored key.
+     *
+     * @param string $key
+     * @return int
+     */
+    public function ttl(string $key): int
+    {
+        return Redis::ttl($this->key($key));
+    }
+
+    /**
+     * Increment a stored numeric key.
+     *
+     * @param string $key
+     * @param int    $amount
+     * @return int
+     */
+    public function increment(string $key, int $amount = 1): int
+    {
+        return Redis::incrby($this->key($key), $amount);
+    }
+
+    /**
+     * Decrement a stored numeric key.
+     *
+     * @param string $key
+     * @param int    $amount
+     * @return int
+     */
+    public function decrement(string $key, int $amount = 1): int
+    {
+        return Redis::decrby($this->key($key), $amount);
+    }
+
+    /* ======================================================
+     * Token Management (JWT / Sessions)
+     * ====================================================== */
+
+    /**
+     * Store a user token using a namespaced key.
+     *
+     * @param string $userId
+     * @param string $token
+     * @param int    $ttl
+     * @return bool
+     */
+    public function storeToken(string $userId, string $token, int $ttl): bool
+    {
+        return $this->set("user:{$userId}:token", $token, $ttl);
+    }
+
+    /**
+     * Retrieve a stored user token.
+     *
+     * @param string $userId
+     * @return string|null
+     */
+    public function getToken(string $userId): ?string
+    {
+        return $this->get("user:{$userId}:token");
+    }
+
+    /**
+     * Delete a stored user token.
+     *
+     * @param string $userId
+     * @return bool
+     */
+    public function deleteToken(string $userId): bool
+    {
+        return $this->delete("user:{$userId}:token");
+    }
+}
diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php
index 907465f..9d518b4 100755
--- a/app/Providers/AppServiceProvider.php
+++ b/app/Providers/AppServiceProvider.php
@@ -2,6 +2,7 @@
 
 namespace App\Providers;
 
+use App\Libraries\Redis\RedisLibrary;
 use Illuminate\Support\ServiceProvider;
 use Illuminate\Support\Facades\Config;
 use Modules\Armory\Services\ArmoryService;
@@ -10,9 +11,6 @@
 
 class AppServiceProvider extends ServiceProvider
 {
-    /**
-     * Register any application services.
-     */
     public function register(): void
     {
         // Register ArmoryService
@@ -23,6 +21,12 @@ public function register(): void
             );
         });
 
+        // Register RedisLibrary (solo prefix)
+        $this->app->singleton(RedisLibrary::class, function ($app) {
+            $prefix = config('cache.prefix', '');
+            return new RedisLibrary($prefix);
+        });
+
         if (app()->environment('production')) {
             $forbidden = [
                 'laravel/telescope',
@@ -38,9 +42,6 @@ public function register(): void
         }
     }
 
-    /**
-     * Bootstrap any application services.
-     */
     public function boot(): void
     {
         if (!file_exists(storage_path('installed.lock'))) {
diff --git a/bootstrap/providers.php b/bootstrap/providers.php
index ae2545d..8e23487 100755
--- a/bootstrap/providers.php
+++ b/bootstrap/providers.php
@@ -3,7 +3,6 @@
 // Core providers
 $providers = [
     App\Providers\AppServiceProvider::class,
-    App\Providers\ArmoryServiceProvider::class,
     Spatie\Permission\PermissionServiceProvider::class,
     App\Providers\ModuleServiceProvider::class,
 ];
diff --git a/composer.json b/composer.json
index 771de4e..80ccdab 100755
--- a/composer.json
+++ b/composer.json
@@ -13,7 +13,7 @@
     ],
     "require": {
         "php": "^8.2",
-        "laravel/framework": "12.34.0",
+        "laravel/framework": "12.40.2",
         "laravel/pulse": "^1.4",
         "laravel/tinker": "2.10.1",
         "predis/predis": "3.2.0",
diff --git a/composer.lock b/composer.lock
index ec38e74..e353110 100755
--- a/composer.lock
+++ b/composer.lock
@@ -4,20 +4,20 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "c6581f611a28c187561caa16c810b898",
+    "content-hash": "8d94a0b29b5ef74cbf8ba04ad7c94ba4",
     "packages": [
         {
             "name": "brick/math",
-            "version": "0.14.0",
+            "version": "0.14.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/brick/math.git",
-                "reference": "113a8ee2656b882d4c3164fa31aa6e12cbb7aaa2"
+                "reference": "f05858549e5f9d7bb45875a75583240a38a281d0"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/brick/math/zipball/113a8ee2656b882d4c3164fa31aa6e12cbb7aaa2",
-                "reference": "113a8ee2656b882d4c3164fa31aa6e12cbb7aaa2",
+                "url": "https://api.github.com/repos/brick/math/zipball/f05858549e5f9d7bb45875a75583240a38a281d0",
+                "reference": "f05858549e5f9d7bb45875a75583240a38a281d0",
                 "shasum": ""
             },
             "require": {
@@ -56,7 +56,7 @@
             ],
             "support": {
                 "issues": "https://github.com/brick/math/issues",
-                "source": "https://github.com/brick/math/tree/0.14.0"
+                "source": "https://github.com/brick/math/tree/0.14.1"
             },
             "funding": [
                 {
@@ -64,7 +64,7 @@
                     "type": "github"
                 }
             ],
-            "time": "2025-08-29T12:40:03+00:00"
+            "time": "2025-11-24T14:40:29+00:00"
         },
         {
             "name": "carbonphp/carbon-doctrine-types",
@@ -379,26 +379,26 @@
         },
         {
             "name": "doctrine/sql-formatter",
-            "version": "1.5.2",
+            "version": "1.5.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/sql-formatter.git",
-                "reference": "d6d00aba6fd2957fe5216fe2b7673e9985db20c8"
+                "reference": "a8af23a8e9d622505baa2997465782cbe8bb7fc7"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/sql-formatter/zipball/d6d00aba6fd2957fe5216fe2b7673e9985db20c8",
-                "reference": "d6d00aba6fd2957fe5216fe2b7673e9985db20c8",
+                "url": "https://api.github.com/repos/doctrine/sql-formatter/zipball/a8af23a8e9d622505baa2997465782cbe8bb7fc7",
+                "reference": "a8af23a8e9d622505baa2997465782cbe8bb7fc7",
                 "shasum": ""
             },
             "require": {
                 "php": "^8.1"
             },
             "require-dev": {
-                "doctrine/coding-standard": "^12",
-                "ergebnis/phpunit-slow-test-detector": "^2.14",
-                "phpstan/phpstan": "^1.10",
-                "phpunit/phpunit": "^10.5"
+                "doctrine/coding-standard": "^14",
+                "ergebnis/phpunit-slow-test-detector": "^2.20",
+                "phpstan/phpstan": "^2.1.31",
+                "phpunit/phpunit": "^10.5.58"
             },
             "bin": [
                 "bin/sql-formatter"
@@ -428,35 +428,34 @@
             ],
             "support": {
                 "issues": "https://github.com/doctrine/sql-formatter/issues",
-                "source": "https://github.com/doctrine/sql-formatter/tree/1.5.2"
+                "source": "https://github.com/doctrine/sql-formatter/tree/1.5.3"
             },
-            "time": "2025-01-24T11:45:48+00:00"
+            "time": "2025-10-26T09:35:14+00:00"
         },
         {
             "name": "dragonmantank/cron-expression",
-            "version": "v3.4.0",
+            "version": "v3.6.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/dragonmantank/cron-expression.git",
-                "reference": "8c784d071debd117328803d86b2097615b457500"
+                "reference": "d61a8a9604ec1f8c3d150d09db6ce98b32675013"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/dragonmantank/cron-expression/zipball/8c784d071debd117328803d86b2097615b457500",
-                "reference": "8c784d071debd117328803d86b2097615b457500",
+                "url": "https://api.github.com/repos/dragonmantank/cron-expression/zipball/d61a8a9604ec1f8c3d150d09db6ce98b32675013",
+                "reference": "d61a8a9604ec1f8c3d150d09db6ce98b32675013",
                 "shasum": ""
             },
             "require": {
-                "php": "^7.2|^8.0",
-                "webmozart/assert": "^1.0"
+                "php": "^8.2|^8.3|^8.4|^8.5"
             },
             "replace": {
                 "mtdowling/cron-expression": "^1.0"
             },
             "require-dev": {
-                "phpstan/extension-installer": "^1.0",
-                "phpstan/phpstan": "^1.0",
-                "phpunit/phpunit": "^7.0|^8.0|^9.0"
+                "phpstan/extension-installer": "^1.4.3",
+                "phpstan/phpstan": "^1.12.32|^2.1.31",
+                "phpunit/phpunit": "^8.5.48|^9.0"
             },
             "type": "library",
             "extra": {
@@ -487,7 +486,7 @@
             ],
             "support": {
                 "issues": "https://github.com/dragonmantank/cron-expression/issues",
-                "source": "https://github.com/dragonmantank/cron-expression/tree/v3.4.0"
+                "source": "https://github.com/dragonmantank/cron-expression/tree/v3.6.0"
             },
             "funding": [
                 {
@@ -495,7 +494,7 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-10-09T13:47:03+00:00"
+            "time": "2025-10-31T18:51:33+00:00"
         },
         {
             "name": "egulias/email-validator",
@@ -1110,16 +1109,16 @@
         },
         {
             "name": "laravel/framework",
-            "version": "v12.34.0",
+            "version": "v12.40.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/framework.git",
-                "reference": "f9ec5a5d88bc8c468f17b59f88e05c8ac3c8d687"
+                "reference": "1ccd99220b474500e672b373f32bd709ec38de50"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/framework/zipball/f9ec5a5d88bc8c468f17b59f88e05c8ac3c8d687",
-                "reference": "f9ec5a5d88bc8c468f17b59f88e05c8ac3c8d687",
+                "url": "https://api.github.com/repos/laravel/framework/zipball/1ccd99220b474500e672b373f32bd709ec38de50",
+                "reference": "1ccd99220b474500e672b373f32bd709ec38de50",
                 "shasum": ""
             },
             "require": {
@@ -1231,13 +1230,13 @@
                 "league/flysystem-sftp-v3": "^3.25.1",
                 "mockery/mockery": "^1.6.10",
                 "opis/json-schema": "^2.4.1",
-                "orchestra/testbench-core": "^10.7.0",
+                "orchestra/testbench-core": "^10.8.0",
                 "pda/pheanstalk": "^5.0.6|^7.0.0",
                 "php-http/discovery": "^1.15",
                 "phpstan/phpstan": "^2.0",
                 "phpunit/phpunit": "^10.5.35|^11.5.3|^12.0.1",
                 "predis/predis": "^2.3|^3.0",
-                "resend/resend-php": "^0.10.0",
+                "resend/resend-php": "^0.10.0|^1.0",
                 "symfony/cache": "^7.2.0",
                 "symfony/http-client": "^7.2.0",
                 "symfony/psr-http-message-bridge": "^7.2.0",
@@ -1271,7 +1270,7 @@
                 "predis/predis": "Required to use the predis connector (^2.3|^3.0).",
                 "psr/http-message": "Required to allow Storage::put to accept a StreamInterface (^1.0).",
                 "pusher/pusher-php-server": "Required to use the Pusher broadcast driver (^6.0|^7.0).",
-                "resend/resend-php": "Required to enable support for the Resend mail transport (^0.10.0).",
+                "resend/resend-php": "Required to enable support for the Resend mail transport (^0.10.0|^1.0).",
                 "symfony/cache": "Required to PSR-6 cache bridge (^7.2).",
                 "symfony/filesystem": "Required to enable support for relative symbolic links (^7.2).",
                 "symfony/http-client": "Required to enable support for the Symfony API mail transports (^7.2).",
@@ -1325,20 +1324,20 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2025-10-14T13:58:31+00:00"
+            "time": "2025-11-26T19:24:25+00:00"
         },
         {
             "name": "laravel/prompts",
-            "version": "v0.3.7",
+            "version": "v0.3.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/prompts.git",
-                "reference": "a1891d362714bc40c8d23b0b1d7090f022ea27cc"
+                "reference": "096748cdfb81988f60090bbb839ce3205ace0d35"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/prompts/zipball/a1891d362714bc40c8d23b0b1d7090f022ea27cc",
-                "reference": "a1891d362714bc40c8d23b0b1d7090f022ea27cc",
+                "url": "https://api.github.com/repos/laravel/prompts/zipball/096748cdfb81988f60090bbb839ce3205ace0d35",
+                "reference": "096748cdfb81988f60090bbb839ce3205ace0d35",
                 "shasum": ""
             },
             "require": {
@@ -1354,7 +1353,7 @@
             "require-dev": {
                 "illuminate/collections": "^10.0|^11.0|^12.0",
                 "mockery/mockery": "^1.5",
-                "pestphp/pest": "^2.3|^3.4",
+                "pestphp/pest": "^2.3|^3.4|^4.0",
                 "phpstan/phpstan": "^1.12.28",
                 "phpstan/phpstan-mockery": "^1.1.3"
             },
@@ -1382,22 +1381,22 @@
             "description": "Add beautiful and user-friendly forms to your command-line applications.",
             "support": {
                 "issues": "https://github.com/laravel/prompts/issues",
-                "source": "https://github.com/laravel/prompts/tree/v0.3.7"
+                "source": "https://github.com/laravel/prompts/tree/v0.3.8"
             },
-            "time": "2025-09-19T13:47:56+00:00"
+            "time": "2025-11-21T20:52:52+00:00"
         },
         {
             "name": "laravel/pulse",
-            "version": "v1.4.3",
+            "version": "v1.4.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/pulse.git",
-                "reference": "8c57f30aa6e094c138cd191314fe060d60773c14"
+                "reference": "4a39a82087c045a2e827f9ecb0e9a510d1d00dca"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/pulse/zipball/8c57f30aa6e094c138cd191314fe060d60773c14",
-                "reference": "8c57f30aa6e094c138cd191314fe060d60773c14",
+                "url": "https://api.github.com/repos/laravel/pulse/zipball/4a39a82087c045a2e827f9ecb0e9a510d1d00dca",
+                "reference": "4a39a82087c045a2e827f9ecb0e9a510d1d00dca",
                 "shasum": ""
             },
             "require": {
@@ -1427,8 +1426,8 @@
             "require-dev": {
                 "guzzlehttp/guzzle": "^7.7",
                 "mockery/mockery": "^1.0",
-                "orchestra/testbench": "^8.23.1|^9.0|^10.0",
-                "pestphp/pest": "^2.0",
+                "orchestra/testbench": "^8.36|^9.15|^10.8",
+                "pestphp/pest": "^2.0|^3.0|^4.0",
                 "pestphp/pest-plugin-laravel": "^2.2",
                 "phpstan/phpstan": "^1.12.21",
                 "predis/predis": "^1.0|^2.0"
@@ -1471,20 +1470,20 @@
                 "issues": "https://github.com/laravel/pulse/issues",
                 "source": "https://github.com/laravel/pulse"
             },
-            "time": "2025-07-18T15:54:11+00:00"
+            "time": "2025-11-24T14:05:55+00:00"
         },
         {
             "name": "laravel/serializable-closure",
-            "version": "v2.0.6",
+            "version": "v2.0.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/serializable-closure.git",
-                "reference": "038ce42edee619599a1debb7e81d7b3759492819"
+                "reference": "cb291e4c998ac50637c7eeb58189c14f5de5b9dd"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/serializable-closure/zipball/038ce42edee619599a1debb7e81d7b3759492819",
-                "reference": "038ce42edee619599a1debb7e81d7b3759492819",
+                "url": "https://api.github.com/repos/laravel/serializable-closure/zipball/cb291e4c998ac50637c7eeb58189c14f5de5b9dd",
+                "reference": "cb291e4c998ac50637c7eeb58189c14f5de5b9dd",
                 "shasum": ""
             },
             "require": {
@@ -1493,7 +1492,7 @@
             "require-dev": {
                 "illuminate/support": "^10.0|^11.0|^12.0",
                 "nesbot/carbon": "^2.67|^3.0",
-                "pestphp/pest": "^2.36|^3.0",
+                "pestphp/pest": "^2.36|^3.0|^4.0",
                 "phpstan/phpstan": "^2.0",
                 "symfony/var-dumper": "^6.2.0|^7.0.0"
             },
@@ -1532,7 +1531,7 @@
                 "issues": "https://github.com/laravel/serializable-closure/issues",
                 "source": "https://github.com/laravel/serializable-closure"
             },
-            "time": "2025-10-09T13:42:30+00:00"
+            "time": "2025-11-21T20:52:36+00:00"
         },
         {
             "name": "laravel/tinker",
@@ -1602,16 +1601,16 @@
         },
         {
             "name": "league/commonmark",
-            "version": "2.7.1",
+            "version": "2.8.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/thephpleague/commonmark.git",
-                "reference": "10732241927d3971d28e7ea7b5712721fa2296ca"
+                "reference": "4efa10c1e56488e658d10adf7b7b7dcd19940bfb"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/thephpleague/commonmark/zipball/10732241927d3971d28e7ea7b5712721fa2296ca",
-                "reference": "10732241927d3971d28e7ea7b5712721fa2296ca",
+                "url": "https://api.github.com/repos/thephpleague/commonmark/zipball/4efa10c1e56488e658d10adf7b7b7dcd19940bfb",
+                "reference": "4efa10c1e56488e658d10adf7b7b7dcd19940bfb",
                 "shasum": ""
             },
             "require": {
@@ -1648,7 +1647,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "2.8-dev"
+                    "dev-main": "2.9-dev"
                 }
             },
             "autoload": {
@@ -1705,7 +1704,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-07-20T12:47:49+00:00"
+            "time": "2025-11-26T21:48:24+00:00"
         },
         {
             "name": "league/config",
@@ -1791,16 +1790,16 @@
         },
         {
             "name": "league/flysystem",
-            "version": "3.30.1",
+            "version": "3.30.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/thephpleague/flysystem.git",
-                "reference": "c139fd65c1f796b926f4aec0df37f6caa959a8da"
+                "reference": "5966a8ba23e62bdb518dd9e0e665c2dbd4b5b277"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/thephpleague/flysystem/zipball/c139fd65c1f796b926f4aec0df37f6caa959a8da",
-                "reference": "c139fd65c1f796b926f4aec0df37f6caa959a8da",
+                "url": "https://api.github.com/repos/thephpleague/flysystem/zipball/5966a8ba23e62bdb518dd9e0e665c2dbd4b5b277",
+                "reference": "5966a8ba23e62bdb518dd9e0e665c2dbd4b5b277",
                 "shasum": ""
             },
             "require": {
@@ -1868,22 +1867,22 @@
             ],
             "support": {
                 "issues": "https://github.com/thephpleague/flysystem/issues",
-                "source": "https://github.com/thephpleague/flysystem/tree/3.30.1"
+                "source": "https://github.com/thephpleague/flysystem/tree/3.30.2"
             },
-            "time": "2025-10-20T15:35:26+00:00"
+            "time": "2025-11-10T17:13:11+00:00"
         },
         {
             "name": "league/flysystem-local",
-            "version": "3.30.0",
+            "version": "3.30.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/thephpleague/flysystem-local.git",
-                "reference": "6691915f77c7fb69adfb87dcd550052dc184ee10"
+                "reference": "ab4f9d0d672f601b102936aa728801dd1a11968d"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/thephpleague/flysystem-local/zipball/6691915f77c7fb69adfb87dcd550052dc184ee10",
-                "reference": "6691915f77c7fb69adfb87dcd550052dc184ee10",
+                "url": "https://api.github.com/repos/thephpleague/flysystem-local/zipball/ab4f9d0d672f601b102936aa728801dd1a11968d",
+                "reference": "ab4f9d0d672f601b102936aa728801dd1a11968d",
                 "shasum": ""
             },
             "require": {
@@ -1917,9 +1916,9 @@
                 "local"
             ],
             "support": {
-                "source": "https://github.com/thephpleague/flysystem-local/tree/3.30.0"
+                "source": "https://github.com/thephpleague/flysystem-local/tree/3.30.2"
             },
-            "time": "2025-05-21T10:34:19+00:00"
+            "time": "2025-11-10T11:23:37+00:00"
         },
         {
             "name": "league/mime-type-detection",
@@ -1979,33 +1978,38 @@
         },
         {
             "name": "league/uri",
-            "version": "7.5.1",
+            "version": "7.6.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/thephpleague/uri.git",
-                "reference": "81fb5145d2644324614cc532b28efd0215bda430"
+                "reference": "f625804987a0a9112d954f9209d91fec52182344"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/thephpleague/uri/zipball/81fb5145d2644324614cc532b28efd0215bda430",
-                "reference": "81fb5145d2644324614cc532b28efd0215bda430",
+                "url": "https://api.github.com/repos/thephpleague/uri/zipball/f625804987a0a9112d954f9209d91fec52182344",
+                "reference": "f625804987a0a9112d954f9209d91fec52182344",
                 "shasum": ""
             },
             "require": {
-                "league/uri-interfaces": "^7.5",
-                "php": "^8.1"
+                "league/uri-interfaces": "^7.6",
+                "php": "^8.1",
+                "psr/http-factory": "^1"
             },
             "conflict": {
                 "league/uri-schemes": "^1.0"
             },
             "suggest": {
                 "ext-bcmath": "to improve IPV4 host parsing",
+                "ext-dom": "to convert the URI into an HTML anchor tag",
                 "ext-fileinfo": "to create Data URI from file contennts",
                 "ext-gmp": "to improve IPV4 host parsing",
                 "ext-intl": "to handle IDN host with the best performance",
+                "ext-uri": "to use the PHP native URI class",
                 "jeremykendall/php-domain-parser": "to resolve Public Suffix and Top Level Domain",
                 "league/uri-components": "Needed to easily manipulate URI objects components",
+                "league/uri-polyfill": "Needed to backport the PHP URI extension for older versions of PHP",
                 "php-64bit": "to improve IPV4 host parsing",
+                "rowbot/url": "to handle WHATWG URL",
                 "symfony/polyfill-intl-idn": "to handle IDN host via the Symfony polyfill if ext-intl is not present"
             },
             "type": "library",
@@ -2033,6 +2037,7 @@
             "description": "URI manipulation library",
             "homepage": "https://uri.thephpleague.com",
             "keywords": [
+                "URN",
                 "data-uri",
                 "file-uri",
                 "ftp",
@@ -2045,9 +2050,11 @@
                 "psr-7",
                 "query-string",
                 "querystring",
+                "rfc2141",
                 "rfc3986",
                 "rfc3987",
                 "rfc6570",
+                "rfc8141",
                 "uri",
                 "uri-template",
                 "url",
@@ -2057,7 +2064,7 @@
                 "docs": "https://uri.thephpleague.com",
                 "forum": "https://thephpleague.slack.com",
                 "issues": "https://github.com/thephpleague/uri-src/issues",
-                "source": "https://github.com/thephpleague/uri/tree/7.5.1"
+                "source": "https://github.com/thephpleague/uri/tree/7.6.0"
             },
             "funding": [
                 {
@@ -2065,26 +2072,25 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-12-08T08:40:02+00:00"
+            "time": "2025-11-18T12:17:23+00:00"
         },
         {
             "name": "league/uri-interfaces",
-            "version": "7.5.0",
+            "version": "7.6.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/thephpleague/uri-interfaces.git",
-                "reference": "08cfc6c4f3d811584fb09c37e2849e6a7f9b0742"
+                "reference": "ccbfb51c0445298e7e0b7f4481b942f589665368"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/thephpleague/uri-interfaces/zipball/08cfc6c4f3d811584fb09c37e2849e6a7f9b0742",
-                "reference": "08cfc6c4f3d811584fb09c37e2849e6a7f9b0742",
+                "url": "https://api.github.com/repos/thephpleague/uri-interfaces/zipball/ccbfb51c0445298e7e0b7f4481b942f589665368",
+                "reference": "ccbfb51c0445298e7e0b7f4481b942f589665368",
                 "shasum": ""
             },
             "require": {
                 "ext-filter": "*",
                 "php": "^8.1",
-                "psr/http-factory": "^1",
                 "psr/http-message": "^1.1 || ^2.0"
             },
             "suggest": {
@@ -2092,6 +2098,7 @@
                 "ext-gmp": "to improve IPV4 host parsing",
                 "ext-intl": "to handle IDN host with the best performance",
                 "php-64bit": "to improve IPV4 host parsing",
+                "rowbot/url": "to handle WHATWG URL",
                 "symfony/polyfill-intl-idn": "to handle IDN host via the Symfony polyfill if ext-intl is not present"
             },
             "type": "library",
@@ -2116,7 +2123,7 @@
                     "homepage": "https://nyamsprod.com"
                 }
             ],
-            "description": "Common interfaces and classes for URI representation and interaction",
+            "description": "Common tools for parsing and resolving RFC3987/RFC3986 URI",
             "homepage": "https://uri.thephpleague.com",
             "keywords": [
                 "data-uri",
@@ -2141,7 +2148,7 @@
                 "docs": "https://uri.thephpleague.com",
                 "forum": "https://thephpleague.slack.com",
                 "issues": "https://github.com/thephpleague/uri-src/issues",
-                "source": "https://github.com/thephpleague/uri-interfaces/tree/7.5.0"
+                "source": "https://github.com/thephpleague/uri-interfaces/tree/7.6.0"
             },
             "funding": [
                 {
@@ -2149,20 +2156,20 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-12-08T08:18:47+00:00"
+            "time": "2025-11-18T12:17:23+00:00"
         },
         {
             "name": "livewire/livewire",
-            "version": "v3.6.4",
+            "version": "v3.7.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/livewire/livewire.git",
-                "reference": "ef04be759da41b14d2d129e670533180a44987dc"
+                "reference": "f5f9efe6d5a7059116bd695a89d95ceedf33f3cb"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/livewire/livewire/zipball/ef04be759da41b14d2d129e670533180a44987dc",
-                "reference": "ef04be759da41b14d2d129e670533180a44987dc",
+                "url": "https://api.github.com/repos/livewire/livewire/zipball/f5f9efe6d5a7059116bd695a89d95ceedf33f3cb",
+                "reference": "f5f9efe6d5a7059116bd695a89d95ceedf33f3cb",
                 "shasum": ""
             },
             "require": {
@@ -2217,7 +2224,7 @@
             "description": "A front-end framework for Laravel.",
             "support": {
                 "issues": "https://github.com/livewire/livewire/issues",
-                "source": "https://github.com/livewire/livewire/tree/v3.6.4"
+                "source": "https://github.com/livewire/livewire/tree/v3.7.0"
             },
             "funding": [
                 {
@@ -2225,7 +2232,7 @@
                     "type": "github"
                 }
             ],
-            "time": "2025-07-17T05:12:15+00:00"
+            "time": "2025-11-12T17:58:16+00:00"
         },
         {
             "name": "monolog/monolog",
@@ -2437,25 +2444,25 @@
         },
         {
             "name": "nette/schema",
-            "version": "v1.3.2",
+            "version": "v1.3.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nette/schema.git",
-                "reference": "da801d52f0354f70a638673c4a0f04e16529431d"
+                "reference": "2befc2f42d7c715fd9d95efc31b1081e5d765004"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nette/schema/zipball/da801d52f0354f70a638673c4a0f04e16529431d",
-                "reference": "da801d52f0354f70a638673c4a0f04e16529431d",
+                "url": "https://api.github.com/repos/nette/schema/zipball/2befc2f42d7c715fd9d95efc31b1081e5d765004",
+                "reference": "2befc2f42d7c715fd9d95efc31b1081e5d765004",
                 "shasum": ""
             },
             "require": {
                 "nette/utils": "^4.0",
-                "php": "8.1 - 8.4"
+                "php": "8.1 - 8.5"
             },
             "require-dev": {
                 "nette/tester": "^2.5.2",
-                "phpstan/phpstan-nette": "^1.0",
+                "phpstan/phpstan-nette": "^2.0@stable",
                 "tracy/tracy": "^2.8"
             },
             "type": "library",
@@ -2465,6 +2472,9 @@
                 }
             },
             "autoload": {
+                "psr-4": {
+                    "Nette\\": "src"
+                },
                 "classmap": [
                     "src/"
                 ]
@@ -2493,22 +2503,22 @@
             ],
             "support": {
                 "issues": "https://github.com/nette/schema/issues",
-                "source": "https://github.com/nette/schema/tree/v1.3.2"
+                "source": "https://github.com/nette/schema/tree/v1.3.3"
             },
-            "time": "2024-10-06T23:10:23+00:00"
+            "time": "2025-10-30T22:57:59+00:00"
         },
         {
             "name": "nette/utils",
-            "version": "v4.0.8",
+            "version": "v4.0.9",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nette/utils.git",
-                "reference": "c930ca4e3cf4f17dcfb03037703679d2396d2ede"
+                "reference": "505a30ad386daa5211f08a318e47015b501cad30"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nette/utils/zipball/c930ca4e3cf4f17dcfb03037703679d2396d2ede",
-                "reference": "c930ca4e3cf4f17dcfb03037703679d2396d2ede",
+                "url": "https://api.github.com/repos/nette/utils/zipball/505a30ad386daa5211f08a318e47015b501cad30",
+                "reference": "505a30ad386daa5211f08a318e47015b501cad30",
                 "shasum": ""
             },
             "require": {
@@ -2582,9 +2592,9 @@
             ],
             "support": {
                 "issues": "https://github.com/nette/utils/issues",
-                "source": "https://github.com/nette/utils/tree/v4.0.8"
+                "source": "https://github.com/nette/utils/tree/v4.0.9"
             },
-            "time": "2025-08-06T21:43:34+00:00"
+            "time": "2025-10-31T00:45:47+00:00"
         },
         {
             "name": "nikic/php-parser",
@@ -2646,31 +2656,31 @@
         },
         {
             "name": "nunomaduro/termwind",
-            "version": "v2.3.2",
+            "version": "v2.3.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nunomaduro/termwind.git",
-                "reference": "eb61920a53057a7debd718a5b89c2178032b52c0"
+                "reference": "6fb2a640ff502caace8e05fd7be3b503a7e1c017"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nunomaduro/termwind/zipball/eb61920a53057a7debd718a5b89c2178032b52c0",
-                "reference": "eb61920a53057a7debd718a5b89c2178032b52c0",
+                "url": "https://api.github.com/repos/nunomaduro/termwind/zipball/6fb2a640ff502caace8e05fd7be3b503a7e1c017",
+                "reference": "6fb2a640ff502caace8e05fd7be3b503a7e1c017",
                 "shasum": ""
             },
             "require": {
                 "ext-mbstring": "*",
                 "php": "^8.2",
-                "symfony/console": "^7.3.4"
+                "symfony/console": "^7.3.6"
             },
             "require-dev": {
                 "illuminate/console": "^11.46.1",
                 "laravel/pint": "^1.25.1",
                 "mockery/mockery": "^1.6.12",
-                "pestphp/pest": "^2.36.0 || ^3.8.4",
+                "pestphp/pest": "^2.36.0 || ^3.8.4 || ^4.1.3",
                 "phpstan/phpstan": "^1.12.32",
                 "phpstan/phpstan-strict-rules": "^1.6.2",
-                "symfony/var-dumper": "^7.3.4",
+                "symfony/var-dumper": "^7.3.5",
                 "thecodingmachine/phpstan-strict-rules": "^1.0.0"
             },
             "type": "library",
@@ -2713,7 +2723,7 @@
             ],
             "support": {
                 "issues": "https://github.com/nunomaduro/termwind/issues",
-                "source": "https://github.com/nunomaduro/termwind/tree/v2.3.2"
+                "source": "https://github.com/nunomaduro/termwind/tree/v2.3.3"
             },
             "funding": [
                 {
@@ -2729,7 +2739,7 @@
                     "type": "github"
                 }
             ],
-            "time": "2025-10-18T11:10:27+00:00"
+            "time": "2025-11-20T02:34:59+00:00"
         },
         {
             "name": "phpoption/phpoption",
@@ -3283,16 +3293,16 @@
         },
         {
             "name": "psy/psysh",
-            "version": "v0.12.13",
+            "version": "v0.12.14",
             "source": {
                 "type": "git",
                 "url": "https://github.com/bobthecow/psysh.git",
-                "reference": "d86c2f750e72017a5cdb1b9f1cef468a5cbacd1e"
+                "reference": "95c29b3756a23855a30566b745d218bee690bef2"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/bobthecow/psysh/zipball/d86c2f750e72017a5cdb1b9f1cef468a5cbacd1e",
-                "reference": "d86c2f750e72017a5cdb1b9f1cef468a5cbacd1e",
+                "url": "https://api.github.com/repos/bobthecow/psysh/zipball/95c29b3756a23855a30566b745d218bee690bef2",
+                "reference": "95c29b3756a23855a30566b745d218bee690bef2",
                 "shasum": ""
             },
             "require": {
@@ -3313,7 +3323,6 @@
             "suggest": {
                 "composer/class-map-generator": "Improved tab completion performance with better class discovery.",
                 "ext-pcntl": "Enabling the PCNTL extension makes PsySH a lot happier :)",
-                "ext-pdo-sqlite": "The doc command requires SQLite to work.",
                 "ext-posix": "If you have PCNTL, you'll want the POSIX extension as well."
             },
             "bin": [
@@ -3357,9 +3366,9 @@
             ],
             "support": {
                 "issues": "https://github.com/bobthecow/psysh/issues",
-                "source": "https://github.com/bobthecow/psysh/tree/v0.12.13"
+                "source": "https://github.com/bobthecow/psysh/tree/v0.12.14"
             },
-            "time": "2025-10-20T22:48:29+00:00"
+            "time": "2025-10-27T17:15:31+00:00"
         },
         {
             "name": "ralouphie/getallheaders",
@@ -3561,16 +3570,16 @@
         },
         {
             "name": "spatie/laravel-permission",
-            "version": "6.21.0",
+            "version": "6.23.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/spatie/laravel-permission.git",
-                "reference": "6a118e8855dfffcd90403aab77bbf35a03db51b3"
+                "reference": "9e41247bd512b1e6c229afbc1eb528f7565ae3bb"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/spatie/laravel-permission/zipball/6a118e8855dfffcd90403aab77bbf35a03db51b3",
-                "reference": "6a118e8855dfffcd90403aab77bbf35a03db51b3",
+                "url": "https://api.github.com/repos/spatie/laravel-permission/zipball/9e41247bd512b1e6c229afbc1eb528f7565ae3bb",
+                "reference": "9e41247bd512b1e6c229afbc1eb528f7565ae3bb",
                 "shasum": ""
             },
             "require": {
@@ -3632,7 +3641,7 @@
             ],
             "support": {
                 "issues": "https://github.com/spatie/laravel-permission/issues",
-                "source": "https://github.com/spatie/laravel-permission/tree/6.21.0"
+                "source": "https://github.com/spatie/laravel-permission/tree/6.23.0"
             },
             "funding": [
                 {
@@ -3640,20 +3649,20 @@
                     "type": "github"
                 }
             ],
-            "time": "2025-07-23T16:08:05+00:00"
+            "time": "2025-11-03T20:16:13+00:00"
         },
         {
             "name": "symfony/clock",
-            "version": "v7.3.0",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/clock.git",
-                "reference": "b81435fbd6648ea425d1ee96a2d8e68f4ceacd24"
+                "reference": "9169f24776edde469914c1e7a1442a50f7a4e110"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/clock/zipball/b81435fbd6648ea425d1ee96a2d8e68f4ceacd24",
-                "reference": "b81435fbd6648ea425d1ee96a2d8e68f4ceacd24",
+                "url": "https://api.github.com/repos/symfony/clock/zipball/9169f24776edde469914c1e7a1442a50f7a4e110",
+                "reference": "9169f24776edde469914c1e7a1442a50f7a4e110",
                 "shasum": ""
             },
             "require": {
@@ -3698,7 +3707,7 @@
                 "time"
             ],
             "support": {
-                "source": "https://github.com/symfony/clock/tree/v7.3.0"
+                "source": "https://github.com/symfony/clock/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -3709,25 +3718,29 @@
                     "url": "https://github.com/fabpot",
                     "type": "github"
                 },
+                {
+                    "url": "https://github.com/nicolas-grekas",
+                    "type": "github"
+                },
                 {
                     "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-09-25T14:21:43+00:00"
+            "time": "2025-11-12T15:39:26+00:00"
         },
         {
             "name": "symfony/console",
-            "version": "v7.3.4",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "2b9c5fafbac0399a20a2e82429e2bd735dcfb7db"
+                "reference": "0bc0f45254b99c58d45a8fbf9fb955d46cbd1bb8"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/2b9c5fafbac0399a20a2e82429e2bd735dcfb7db",
-                "reference": "2b9c5fafbac0399a20a2e82429e2bd735dcfb7db",
+                "url": "https://api.github.com/repos/symfony/console/zipball/0bc0f45254b99c58d45a8fbf9fb955d46cbd1bb8",
+                "reference": "0bc0f45254b99c58d45a8fbf9fb955d46cbd1bb8",
                 "shasum": ""
             },
             "require": {
@@ -3735,7 +3748,7 @@
                 "symfony/deprecation-contracts": "^2.5|^3",
                 "symfony/polyfill-mbstring": "~1.0",
                 "symfony/service-contracts": "^2.5|^3",
-                "symfony/string": "^7.2"
+                "symfony/string": "^7.2|^8.0"
             },
             "conflict": {
                 "symfony/dependency-injection": "<6.4",
@@ -3749,16 +3762,16 @@
             },
             "require-dev": {
                 "psr/log": "^1|^2|^3",
-                "symfony/config": "^6.4|^7.0",
-                "symfony/dependency-injection": "^6.4|^7.0",
-                "symfony/event-dispatcher": "^6.4|^7.0",
-                "symfony/http-foundation": "^6.4|^7.0",
-                "symfony/http-kernel": "^6.4|^7.0",
-                "symfony/lock": "^6.4|^7.0",
-                "symfony/messenger": "^6.4|^7.0",
-                "symfony/process": "^6.4|^7.0",
-                "symfony/stopwatch": "^6.4|^7.0",
-                "symfony/var-dumper": "^6.4|^7.0"
+                "symfony/config": "^6.4|^7.0|^8.0",
+                "symfony/dependency-injection": "^6.4|^7.0|^8.0",
+                "symfony/event-dispatcher": "^6.4|^7.0|^8.0",
+                "symfony/http-foundation": "^6.4|^7.0|^8.0",
+                "symfony/http-kernel": "^6.4|^7.0|^8.0",
+                "symfony/lock": "^6.4|^7.0|^8.0",
+                "symfony/messenger": "^6.4|^7.0|^8.0",
+                "symfony/process": "^6.4|^7.0|^8.0",
+                "symfony/stopwatch": "^6.4|^7.0|^8.0",
+                "symfony/var-dumper": "^6.4|^7.0|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -3792,7 +3805,7 @@
                 "terminal"
             ],
             "support": {
-                "source": "https://github.com/symfony/console/tree/v7.3.4"
+                "source": "https://github.com/symfony/console/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -3812,20 +3825,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-22T15:31:00+00:00"
+            "time": "2025-11-27T13:27:24+00:00"
         },
         {
             "name": "symfony/css-selector",
-            "version": "v7.3.0",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "601a5ce9aaad7bf10797e3663faefce9e26c24e2"
+                "reference": "ab862f478513e7ca2fe9ec117a6f01a8da6e1135"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/601a5ce9aaad7bf10797e3663faefce9e26c24e2",
-                "reference": "601a5ce9aaad7bf10797e3663faefce9e26c24e2",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/ab862f478513e7ca2fe9ec117a6f01a8da6e1135",
+                "reference": "ab862f478513e7ca2fe9ec117a6f01a8da6e1135",
                 "shasum": ""
             },
             "require": {
@@ -3861,7 +3874,7 @@
             "description": "Converts CSS selectors to XPath expressions",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/v7.3.0"
+                "source": "https://github.com/symfony/css-selector/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -3872,12 +3885,16 @@
                     "url": "https://github.com/fabpot",
                     "type": "github"
                 },
+                {
+                    "url": "https://github.com/nicolas-grekas",
+                    "type": "github"
+                },
                 {
                     "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-09-25T14:21:43+00:00"
+            "time": "2025-10-30T13:39:42+00:00"
         },
         {
             "name": "symfony/deprecation-contracts",
@@ -3948,32 +3965,33 @@
         },
         {
             "name": "symfony/error-handler",
-            "version": "v7.3.4",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/error-handler.git",
-                "reference": "99f81bc944ab8e5dae4f21b4ca9972698bbad0e4"
+                "reference": "48be2b0653594eea32dcef130cca1c811dcf25c2"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/error-handler/zipball/99f81bc944ab8e5dae4f21b4ca9972698bbad0e4",
-                "reference": "99f81bc944ab8e5dae4f21b4ca9972698bbad0e4",
+                "url": "https://api.github.com/repos/symfony/error-handler/zipball/48be2b0653594eea32dcef130cca1c811dcf25c2",
+                "reference": "48be2b0653594eea32dcef130cca1c811dcf25c2",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.2",
                 "psr/log": "^1|^2|^3",
-                "symfony/var-dumper": "^6.4|^7.0"
+                "symfony/polyfill-php85": "^1.32",
+                "symfony/var-dumper": "^6.4|^7.0|^8.0"
             },
             "conflict": {
                 "symfony/deprecation-contracts": "<2.5",
                 "symfony/http-kernel": "<6.4"
             },
             "require-dev": {
-                "symfony/console": "^6.4|^7.0",
+                "symfony/console": "^6.4|^7.0|^8.0",
                 "symfony/deprecation-contracts": "^2.5|^3",
-                "symfony/http-kernel": "^6.4|^7.0",
-                "symfony/serializer": "^6.4|^7.0",
+                "symfony/http-kernel": "^6.4|^7.0|^8.0",
+                "symfony/serializer": "^6.4|^7.0|^8.0",
                 "symfony/webpack-encore-bundle": "^1.0|^2.0"
             },
             "bin": [
@@ -4005,7 +4023,7 @@
             "description": "Provides tools to manage errors and ease debugging PHP code",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/error-handler/tree/v7.3.4"
+                "source": "https://github.com/symfony/error-handler/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -4025,28 +4043,28 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-11T10:12:26+00:00"
+            "time": "2025-11-05T14:29:59+00:00"
         },
         {
             "name": "symfony/event-dispatcher",
-            "version": "v7.3.3",
+            "version": "v8.0.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/event-dispatcher.git",
-                "reference": "b7dc69e71de420ac04bc9ab830cf3ffebba48191"
+                "reference": "573f95783a2ec6e38752979db139f09fec033f03"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/event-dispatcher/zipball/b7dc69e71de420ac04bc9ab830cf3ffebba48191",
-                "reference": "b7dc69e71de420ac04bc9ab830cf3ffebba48191",
+                "url": "https://api.github.com/repos/symfony/event-dispatcher/zipball/573f95783a2ec6e38752979db139f09fec033f03",
+                "reference": "573f95783a2ec6e38752979db139f09fec033f03",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
+                "php": ">=8.4",
                 "symfony/event-dispatcher-contracts": "^2.5|^3"
             },
             "conflict": {
-                "symfony/dependency-injection": "<6.4",
+                "symfony/security-http": "<7.4",
                 "symfony/service-contracts": "<2.5"
             },
             "provide": {
@@ -4055,13 +4073,14 @@
             },
             "require-dev": {
                 "psr/log": "^1|^2|^3",
-                "symfony/config": "^6.4|^7.0",
-                "symfony/dependency-injection": "^6.4|^7.0",
-                "symfony/error-handler": "^6.4|^7.0",
-                "symfony/expression-language": "^6.4|^7.0",
-                "symfony/http-foundation": "^6.4|^7.0",
+                "symfony/config": "^7.4|^8.0",
+                "symfony/dependency-injection": "^7.4|^8.0",
+                "symfony/error-handler": "^7.4|^8.0",
+                "symfony/expression-language": "^7.4|^8.0",
+                "symfony/framework-bundle": "^7.4|^8.0",
+                "symfony/http-foundation": "^7.4|^8.0",
                 "symfony/service-contracts": "^2.5|^3",
-                "symfony/stopwatch": "^6.4|^7.0"
+                "symfony/stopwatch": "^7.4|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -4089,7 +4108,7 @@
             "description": "Provides tools that allow your application components to communicate with each other by dispatching events and listening to them",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/event-dispatcher/tree/v7.3.3"
+                "source": "https://github.com/symfony/event-dispatcher/tree/v8.0.0"
             },
             "funding": [
                 {
@@ -4109,7 +4128,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-08-13T11:49:31+00:00"
+            "time": "2025-10-30T14:17:19+00:00"
         },
         {
             "name": "symfony/event-dispatcher-contracts",
@@ -4189,23 +4208,23 @@
         },
         {
             "name": "symfony/finder",
-            "version": "v7.3.2",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "2a6614966ba1074fa93dae0bc804227422df4dfe"
+                "reference": "340b9ed7320570f319028a2cbec46d40535e94bd"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/2a6614966ba1074fa93dae0bc804227422df4dfe",
-                "reference": "2a6614966ba1074fa93dae0bc804227422df4dfe",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/340b9ed7320570f319028a2cbec46d40535e94bd",
+                "reference": "340b9ed7320570f319028a2cbec46d40535e94bd",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.2"
             },
             "require-dev": {
-                "symfony/filesystem": "^6.4|^7.0"
+                "symfony/filesystem": "^6.4|^7.0|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -4233,7 +4252,7 @@
             "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v7.3.2"
+                "source": "https://github.com/symfony/finder/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -4253,27 +4272,26 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-07-15T13:41:35+00:00"
+            "time": "2025-11-05T05:42:40+00:00"
         },
         {
             "name": "symfony/http-foundation",
-            "version": "v7.3.4",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-foundation.git",
-                "reference": "c061c7c18918b1b64268771aad04b40be41dd2e6"
+                "reference": "769c1720b68e964b13b58529c17d4a385c62167b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-foundation/zipball/c061c7c18918b1b64268771aad04b40be41dd2e6",
-                "reference": "c061c7c18918b1b64268771aad04b40be41dd2e6",
+                "url": "https://api.github.com/repos/symfony/http-foundation/zipball/769c1720b68e964b13b58529c17d4a385c62167b",
+                "reference": "769c1720b68e964b13b58529c17d4a385c62167b",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.2",
-                "symfony/deprecation-contracts": "^2.5|^3.0",
-                "symfony/polyfill-mbstring": "~1.1",
-                "symfony/polyfill-php83": "^1.27"
+                "symfony/deprecation-contracts": "^2.5|^3",
+                "symfony/polyfill-mbstring": "^1.1"
             },
             "conflict": {
                 "doctrine/dbal": "<3.6",
@@ -4282,13 +4300,13 @@
             "require-dev": {
                 "doctrine/dbal": "^3.6|^4",
                 "predis/predis": "^1.1|^2.0",
-                "symfony/cache": "^6.4.12|^7.1.5",
-                "symfony/clock": "^6.4|^7.0",
-                "symfony/dependency-injection": "^6.4|^7.0",
-                "symfony/expression-language": "^6.4|^7.0",
-                "symfony/http-kernel": "^6.4|^7.0",
-                "symfony/mime": "^6.4|^7.0",
-                "symfony/rate-limiter": "^6.4|^7.0"
+                "symfony/cache": "^6.4.12|^7.1.5|^8.0",
+                "symfony/clock": "^6.4|^7.0|^8.0",
+                "symfony/dependency-injection": "^6.4|^7.0|^8.0",
+                "symfony/expression-language": "^6.4|^7.0|^8.0",
+                "symfony/http-kernel": "^6.4|^7.0|^8.0",
+                "symfony/mime": "^6.4|^7.0|^8.0",
+                "symfony/rate-limiter": "^6.4|^7.0|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -4316,7 +4334,7 @@
             "description": "Defines an object-oriented layer for the HTTP specification",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-foundation/tree/v7.3.4"
+                "source": "https://github.com/symfony/http-foundation/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -4336,29 +4354,29 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-16T08:38:17+00:00"
+            "time": "2025-11-13T08:49:24+00:00"
         },
         {
             "name": "symfony/http-kernel",
-            "version": "v7.3.4",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-kernel.git",
-                "reference": "b796dffea7821f035047235e076b60ca2446e3cf"
+                "reference": "7348193cd384495a755554382e4526f27c456085"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-kernel/zipball/b796dffea7821f035047235e076b60ca2446e3cf",
-                "reference": "b796dffea7821f035047235e076b60ca2446e3cf",
+                "url": "https://api.github.com/repos/symfony/http-kernel/zipball/7348193cd384495a755554382e4526f27c456085",
+                "reference": "7348193cd384495a755554382e4526f27c456085",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.2",
                 "psr/log": "^1|^2|^3",
                 "symfony/deprecation-contracts": "^2.5|^3",
-                "symfony/error-handler": "^6.4|^7.0",
-                "symfony/event-dispatcher": "^7.3",
-                "symfony/http-foundation": "^7.3",
+                "symfony/error-handler": "^6.4|^7.0|^8.0",
+                "symfony/event-dispatcher": "^7.3|^8.0",
+                "symfony/http-foundation": "^7.4|^8.0",
                 "symfony/polyfill-ctype": "^1.8"
             },
             "conflict": {
@@ -4368,6 +4386,7 @@
                 "symfony/console": "<6.4",
                 "symfony/dependency-injection": "<6.4",
                 "symfony/doctrine-bridge": "<6.4",
+                "symfony/flex": "<2.10",
                 "symfony/form": "<6.4",
                 "symfony/http-client": "<6.4",
                 "symfony/http-client-contracts": "<2.5",
@@ -4385,27 +4404,27 @@
             },
             "require-dev": {
                 "psr/cache": "^1.0|^2.0|^3.0",
-                "symfony/browser-kit": "^6.4|^7.0",
-                "symfony/clock": "^6.4|^7.0",
-                "symfony/config": "^6.4|^7.0",
-                "symfony/console": "^6.4|^7.0",
-                "symfony/css-selector": "^6.4|^7.0",
-                "symfony/dependency-injection": "^6.4|^7.0",
-                "symfony/dom-crawler": "^6.4|^7.0",
-                "symfony/expression-language": "^6.4|^7.0",
-                "symfony/finder": "^6.4|^7.0",
+                "symfony/browser-kit": "^6.4|^7.0|^8.0",
+                "symfony/clock": "^6.4|^7.0|^8.0",
+                "symfony/config": "^6.4|^7.0|^8.0",
+                "symfony/console": "^6.4|^7.0|^8.0",
+                "symfony/css-selector": "^6.4|^7.0|^8.0",
+                "symfony/dependency-injection": "^6.4|^7.0|^8.0",
+                "symfony/dom-crawler": "^6.4|^7.0|^8.0",
+                "symfony/expression-language": "^6.4|^7.0|^8.0",
+                "symfony/finder": "^6.4|^7.0|^8.0",
                 "symfony/http-client-contracts": "^2.5|^3",
-                "symfony/process": "^6.4|^7.0",
-                "symfony/property-access": "^7.1",
-                "symfony/routing": "^6.4|^7.0",
-                "symfony/serializer": "^7.1",
-                "symfony/stopwatch": "^6.4|^7.0",
-                "symfony/translation": "^6.4|^7.0",
+                "symfony/process": "^6.4|^7.0|^8.0",
+                "symfony/property-access": "^7.1|^8.0",
+                "symfony/routing": "^6.4|^7.0|^8.0",
+                "symfony/serializer": "^7.1|^8.0",
+                "symfony/stopwatch": "^6.4|^7.0|^8.0",
+                "symfony/translation": "^6.4|^7.0|^8.0",
                 "symfony/translation-contracts": "^2.5|^3",
-                "symfony/uid": "^6.4|^7.0",
-                "symfony/validator": "^6.4|^7.0",
-                "symfony/var-dumper": "^6.4|^7.0",
-                "symfony/var-exporter": "^6.4|^7.0",
+                "symfony/uid": "^6.4|^7.0|^8.0",
+                "symfony/validator": "^6.4|^7.0|^8.0",
+                "symfony/var-dumper": "^6.4|^7.0|^8.0",
+                "symfony/var-exporter": "^6.4|^7.0|^8.0",
                 "twig/twig": "^3.12"
             },
             "type": "library",
@@ -4434,7 +4453,7 @@
             "description": "Provides a structured process for converting a Request into a Response",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-kernel/tree/v7.3.4"
+                "source": "https://github.com/symfony/http-kernel/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -4454,20 +4473,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-27T12:32:17+00:00"
+            "time": "2025-11-27T13:38:24+00:00"
         },
         {
             "name": "symfony/mailer",
-            "version": "v7.3.4",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/mailer.git",
-                "reference": "ab97ef2f7acf0216955f5845484235113047a31d"
+                "reference": "a3d9eea8cfa467ece41f0f54ba28185d74bd53fd"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/mailer/zipball/ab97ef2f7acf0216955f5845484235113047a31d",
-                "reference": "ab97ef2f7acf0216955f5845484235113047a31d",
+                "url": "https://api.github.com/repos/symfony/mailer/zipball/a3d9eea8cfa467ece41f0f54ba28185d74bd53fd",
+                "reference": "a3d9eea8cfa467ece41f0f54ba28185d74bd53fd",
                 "shasum": ""
             },
             "require": {
@@ -4475,8 +4494,8 @@
                 "php": ">=8.2",
                 "psr/event-dispatcher": "^1",
                 "psr/log": "^1|^2|^3",
-                "symfony/event-dispatcher": "^6.4|^7.0",
-                "symfony/mime": "^7.2",
+                "symfony/event-dispatcher": "^6.4|^7.0|^8.0",
+                "symfony/mime": "^7.2|^8.0",
                 "symfony/service-contracts": "^2.5|^3"
             },
             "conflict": {
@@ -4487,10 +4506,10 @@
                 "symfony/twig-bridge": "<6.4"
             },
             "require-dev": {
-                "symfony/console": "^6.4|^7.0",
-                "symfony/http-client": "^6.4|^7.0",
-                "symfony/messenger": "^6.4|^7.0",
-                "symfony/twig-bridge": "^6.4|^7.0"
+                "symfony/console": "^6.4|^7.0|^8.0",
+                "symfony/http-client": "^6.4|^7.0|^8.0",
+                "symfony/messenger": "^6.4|^7.0|^8.0",
+                "symfony/twig-bridge": "^6.4|^7.0|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -4518,7 +4537,7 @@
             "description": "Helps sending emails",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/mailer/tree/v7.3.4"
+                "source": "https://github.com/symfony/mailer/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -4538,24 +4557,25 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-17T05:51:54+00:00"
+            "time": "2025-11-21T15:26:00+00:00"
         },
         {
             "name": "symfony/mime",
-            "version": "v7.3.4",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/mime.git",
-                "reference": "b1b828f69cbaf887fa835a091869e55df91d0e35"
+                "reference": "bdb02729471be5d047a3ac4a69068748f1a6be7a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/mime/zipball/b1b828f69cbaf887fa835a091869e55df91d0e35",
-                "reference": "b1b828f69cbaf887fa835a091869e55df91d0e35",
+                "url": "https://api.github.com/repos/symfony/mime/zipball/bdb02729471be5d047a3ac4a69068748f1a6be7a",
+                "reference": "bdb02729471be5d047a3ac4a69068748f1a6be7a",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.2",
+                "symfony/deprecation-contracts": "^2.5|^3",
                 "symfony/polyfill-intl-idn": "^1.10",
                 "symfony/polyfill-mbstring": "^1.0"
             },
@@ -4570,11 +4590,11 @@
                 "egulias/email-validator": "^2.1.10|^3.1|^4",
                 "league/html-to-markdown": "^5.0",
                 "phpdocumentor/reflection-docblock": "^3.0|^4.0|^5.0",
-                "symfony/dependency-injection": "^6.4|^7.0",
-                "symfony/process": "^6.4|^7.0",
-                "symfony/property-access": "^6.4|^7.0",
-                "symfony/property-info": "^6.4|^7.0",
-                "symfony/serializer": "^6.4.3|^7.0.3"
+                "symfony/dependency-injection": "^6.4|^7.0|^8.0",
+                "symfony/process": "^6.4|^7.0|^8.0",
+                "symfony/property-access": "^6.4|^7.0|^8.0",
+                "symfony/property-info": "^6.4|^7.0|^8.0",
+                "symfony/serializer": "^6.4.3|^7.0.3|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -4606,7 +4626,7 @@
                 "mime-type"
             ],
             "support": {
-                "source": "https://github.com/symfony/mime/tree/v7.3.4"
+                "source": "https://github.com/symfony/mime/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -4626,7 +4646,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-16T08:38:17+00:00"
+            "time": "2025-11-16T10:14:42+00:00"
         },
         {
             "name": "symfony/polyfill-ctype",
@@ -5459,16 +5479,16 @@
         },
         {
             "name": "symfony/process",
-            "version": "v7.3.4",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/process.git",
-                "reference": "f24f8f316367b30810810d4eb30c543d7003ff3b"
+                "reference": "7ca8dc2d0dcf4882658313aba8be5d9fd01026c8"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/f24f8f316367b30810810d4eb30c543d7003ff3b",
-                "reference": "f24f8f316367b30810810d4eb30c543d7003ff3b",
+                "url": "https://api.github.com/repos/symfony/process/zipball/7ca8dc2d0dcf4882658313aba8be5d9fd01026c8",
+                "reference": "7ca8dc2d0dcf4882658313aba8be5d9fd01026c8",
                 "shasum": ""
             },
             "require": {
@@ -5500,7 +5520,7 @@
             "description": "Executes commands in sub-processes",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/process/tree/v7.3.4"
+                "source": "https://github.com/symfony/process/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -5520,20 +5540,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-11T10:12:26+00:00"
+            "time": "2025-10-16T11:21:06+00:00"
         },
         {
             "name": "symfony/routing",
-            "version": "v7.3.4",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/routing.git",
-                "reference": "8dc648e159e9bac02b703b9fbd937f19ba13d07c"
+                "reference": "4720254cb2644a0b876233d258a32bf017330db7"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/routing/zipball/8dc648e159e9bac02b703b9fbd937f19ba13d07c",
-                "reference": "8dc648e159e9bac02b703b9fbd937f19ba13d07c",
+                "url": "https://api.github.com/repos/symfony/routing/zipball/4720254cb2644a0b876233d258a32bf017330db7",
+                "reference": "4720254cb2644a0b876233d258a32bf017330db7",
                 "shasum": ""
             },
             "require": {
@@ -5547,11 +5567,11 @@
             },
             "require-dev": {
                 "psr/log": "^1|^2|^3",
-                "symfony/config": "^6.4|^7.0",
-                "symfony/dependency-injection": "^6.4|^7.0",
-                "symfony/expression-language": "^6.4|^7.0",
-                "symfony/http-foundation": "^6.4|^7.0",
-                "symfony/yaml": "^6.4|^7.0"
+                "symfony/config": "^6.4|^7.0|^8.0",
+                "symfony/dependency-injection": "^6.4|^7.0|^8.0",
+                "symfony/expression-language": "^6.4|^7.0|^8.0",
+                "symfony/http-foundation": "^6.4|^7.0|^8.0",
+                "symfony/yaml": "^6.4|^7.0|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -5585,7 +5605,7 @@
                 "url"
             ],
             "support": {
-                "source": "https://github.com/symfony/routing/tree/v7.3.4"
+                "source": "https://github.com/symfony/routing/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -5605,20 +5625,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-11T10:12:26+00:00"
+            "time": "2025-11-27T13:27:24+00:00"
         },
         {
             "name": "symfony/service-contracts",
-            "version": "v3.6.0",
+            "version": "v3.6.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/service-contracts.git",
-                "reference": "f021b05a130d35510bd6b25fe9053c2a8a15d5d4"
+                "reference": "45112560a3ba2d715666a509a0bc9521d10b6c43"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/f021b05a130d35510bd6b25fe9053c2a8a15d5d4",
-                "reference": "f021b05a130d35510bd6b25fe9053c2a8a15d5d4",
+                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/45112560a3ba2d715666a509a0bc9521d10b6c43",
+                "reference": "45112560a3ba2d715666a509a0bc9521d10b6c43",
                 "shasum": ""
             },
             "require": {
@@ -5672,7 +5692,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/service-contracts/tree/v3.6.0"
+                "source": "https://github.com/symfony/service-contracts/tree/v3.6.1"
             },
             "funding": [
                 {
@@ -5683,43 +5703,47 @@
                     "url": "https://github.com/fabpot",
                     "type": "github"
                 },
+                {
+                    "url": "https://github.com/nicolas-grekas",
+                    "type": "github"
+                },
                 {
                     "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-04-25T09:37:31+00:00"
+            "time": "2025-07-15T11:30:57+00:00"
         },
         {
             "name": "symfony/string",
-            "version": "v7.3.4",
+            "version": "v8.0.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/string.git",
-                "reference": "f96476035142921000338bad71e5247fbc138872"
+                "reference": "f929eccf09531078c243df72398560e32fa4cf4f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/string/zipball/f96476035142921000338bad71e5247fbc138872",
-                "reference": "f96476035142921000338bad71e5247fbc138872",
+                "url": "https://api.github.com/repos/symfony/string/zipball/f929eccf09531078c243df72398560e32fa4cf4f",
+                "reference": "f929eccf09531078c243df72398560e32fa4cf4f",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
-                "symfony/polyfill-ctype": "~1.8",
-                "symfony/polyfill-intl-grapheme": "~1.0",
-                "symfony/polyfill-intl-normalizer": "~1.0",
-                "symfony/polyfill-mbstring": "~1.0"
+                "php": ">=8.4",
+                "symfony/polyfill-ctype": "^1.8",
+                "symfony/polyfill-intl-grapheme": "^1.33",
+                "symfony/polyfill-intl-normalizer": "^1.0",
+                "symfony/polyfill-mbstring": "^1.0"
             },
             "conflict": {
                 "symfony/translation-contracts": "<2.5"
             },
             "require-dev": {
-                "symfony/emoji": "^7.1",
-                "symfony/http-client": "^6.4|^7.0",
-                "symfony/intl": "^6.4|^7.0",
+                "symfony/emoji": "^7.4|^8.0",
+                "symfony/http-client": "^7.4|^8.0",
+                "symfony/intl": "^7.4|^8.0",
                 "symfony/translation-contracts": "^2.5|^3.0",
-                "symfony/var-exporter": "^6.4|^7.0"
+                "symfony/var-exporter": "^7.4|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -5758,7 +5782,7 @@
                 "utf8"
             ],
             "support": {
-                "source": "https://github.com/symfony/string/tree/v7.3.4"
+                "source": "https://github.com/symfony/string/tree/v8.0.0"
             },
             "funding": [
                 {
@@ -5778,27 +5802,27 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-11T14:36:48+00:00"
+            "time": "2025-09-11T14:37:55+00:00"
         },
         {
             "name": "symfony/translation",
-            "version": "v7.3.4",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/translation.git",
-                "reference": "ec25870502d0c7072d086e8ffba1420c85965174"
+                "reference": "2d01ca0da3f092f91eeedb46f24aa30d2fca8f68"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/translation/zipball/ec25870502d0c7072d086e8ffba1420c85965174",
-                "reference": "ec25870502d0c7072d086e8ffba1420c85965174",
+                "url": "https://api.github.com/repos/symfony/translation/zipball/2d01ca0da3f092f91eeedb46f24aa30d2fca8f68",
+                "reference": "2d01ca0da3f092f91eeedb46f24aa30d2fca8f68",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.2",
                 "symfony/deprecation-contracts": "^2.5|^3",
                 "symfony/polyfill-mbstring": "~1.0",
-                "symfony/translation-contracts": "^2.5|^3.0"
+                "symfony/translation-contracts": "^2.5.3|^3.3"
             },
             "conflict": {
                 "nikic/php-parser": "<5.0",
@@ -5817,17 +5841,17 @@
             "require-dev": {
                 "nikic/php-parser": "^5.0",
                 "psr/log": "^1|^2|^3",
-                "symfony/config": "^6.4|^7.0",
-                "symfony/console": "^6.4|^7.0",
-                "symfony/dependency-injection": "^6.4|^7.0",
-                "symfony/finder": "^6.4|^7.0",
+                "symfony/config": "^6.4|^7.0|^8.0",
+                "symfony/console": "^6.4|^7.0|^8.0",
+                "symfony/dependency-injection": "^6.4|^7.0|^8.0",
+                "symfony/finder": "^6.4|^7.0|^8.0",
                 "symfony/http-client-contracts": "^2.5|^3.0",
-                "symfony/http-kernel": "^6.4|^7.0",
-                "symfony/intl": "^6.4|^7.0",
+                "symfony/http-kernel": "^6.4|^7.0|^8.0",
+                "symfony/intl": "^6.4|^7.0|^8.0",
                 "symfony/polyfill-intl-icu": "^1.21",
-                "symfony/routing": "^6.4|^7.0",
+                "symfony/routing": "^6.4|^7.0|^8.0",
                 "symfony/service-contracts": "^2.5|^3",
-                "symfony/yaml": "^6.4|^7.0"
+                "symfony/yaml": "^6.4|^7.0|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -5858,7 +5882,7 @@
             "description": "Provides tools to internationalize your application",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/translation/tree/v7.3.4"
+                "source": "https://github.com/symfony/translation/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -5878,20 +5902,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-07T11:39:36+00:00"
+            "time": "2025-11-27T13:27:24+00:00"
         },
         {
             "name": "symfony/translation-contracts",
-            "version": "v3.6.0",
+            "version": "v3.6.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/translation-contracts.git",
-                "reference": "df210c7a2573f1913b2d17cc95f90f53a73d8f7d"
+                "reference": "65a8bc82080447fae78373aa10f8d13b38338977"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/df210c7a2573f1913b2d17cc95f90f53a73d8f7d",
-                "reference": "df210c7a2573f1913b2d17cc95f90f53a73d8f7d",
+                "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/65a8bc82080447fae78373aa10f8d13b38338977",
+                "reference": "65a8bc82080447fae78373aa10f8d13b38338977",
                 "shasum": ""
             },
             "require": {
@@ -5940,7 +5964,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/translation-contracts/tree/v3.6.0"
+                "source": "https://github.com/symfony/translation-contracts/tree/v3.6.1"
             },
             "funding": [
                 {
@@ -5951,25 +5975,29 @@
                     "url": "https://github.com/fabpot",
                     "type": "github"
                 },
+                {
+                    "url": "https://github.com/nicolas-grekas",
+                    "type": "github"
+                },
                 {
                     "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-09-27T08:32:26+00:00"
+            "time": "2025-07-15T13:41:35+00:00"
         },
         {
             "name": "symfony/uid",
-            "version": "v7.3.1",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/uid.git",
-                "reference": "a69f69f3159b852651a6bf45a9fdd149520525bb"
+                "reference": "2498e9f81b7baa206f44de583f2f48350b90142c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/uid/zipball/a69f69f3159b852651a6bf45a9fdd149520525bb",
-                "reference": "a69f69f3159b852651a6bf45a9fdd149520525bb",
+                "url": "https://api.github.com/repos/symfony/uid/zipball/2498e9f81b7baa206f44de583f2f48350b90142c",
+                "reference": "2498e9f81b7baa206f44de583f2f48350b90142c",
                 "shasum": ""
             },
             "require": {
@@ -5977,7 +6005,7 @@
                 "symfony/polyfill-uuid": "^1.15"
             },
             "require-dev": {
-                "symfony/console": "^6.4|^7.0"
+                "symfony/console": "^6.4|^7.0|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -6014,7 +6042,7 @@
                 "uuid"
             ],
             "support": {
-                "source": "https://github.com/symfony/uid/tree/v7.3.1"
+                "source": "https://github.com/symfony/uid/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -6025,25 +6053,29 @@
                     "url": "https://github.com/fabpot",
                     "type": "github"
                 },
+                {
+                    "url": "https://github.com/nicolas-grekas",
+                    "type": "github"
+                },
                 {
                     "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-06-27T19:55:54+00:00"
+            "time": "2025-09-25T11:02:55+00:00"
         },
         {
             "name": "symfony/var-dumper",
-            "version": "v7.3.4",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/var-dumper.git",
-                "reference": "b8abe7daf2730d07dfd4b2ee1cecbf0dd2fbdabb"
+                "reference": "41fd6c4ae28c38b294b42af6db61446594a0dece"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/var-dumper/zipball/b8abe7daf2730d07dfd4b2ee1cecbf0dd2fbdabb",
-                "reference": "b8abe7daf2730d07dfd4b2ee1cecbf0dd2fbdabb",
+                "url": "https://api.github.com/repos/symfony/var-dumper/zipball/41fd6c4ae28c38b294b42af6db61446594a0dece",
+                "reference": "41fd6c4ae28c38b294b42af6db61446594a0dece",
                 "shasum": ""
             },
             "require": {
@@ -6055,10 +6087,10 @@
                 "symfony/console": "<6.4"
             },
             "require-dev": {
-                "symfony/console": "^6.4|^7.0",
-                "symfony/http-kernel": "^6.4|^7.0",
-                "symfony/process": "^6.4|^7.0",
-                "symfony/uid": "^6.4|^7.0",
+                "symfony/console": "^6.4|^7.0|^8.0",
+                "symfony/http-kernel": "^6.4|^7.0|^8.0",
+                "symfony/process": "^6.4|^7.0|^8.0",
+                "symfony/uid": "^6.4|^7.0|^8.0",
                 "twig/twig": "^3.12"
             },
             "bin": [
@@ -6097,7 +6129,7 @@
                 "dump"
             ],
             "support": {
-                "source": "https://github.com/symfony/var-dumper/tree/v7.3.4"
+                "source": "https://github.com/symfony/var-dumper/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -6117,7 +6149,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-11T10:12:26+00:00"
+            "time": "2025-10-27T20:36:44+00:00"
         },
         {
             "name": "tijsverkoyen/css-to-inline-styles",
@@ -6332,64 +6364,6 @@
             ],
             "time": "2024-11-21T01:49:47+00:00"
         },
-        {
-            "name": "webmozart/assert",
-            "version": "1.12.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/webmozarts/assert.git",
-                "reference": "541057574806f942c94662b817a50f63f7345360"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/webmozarts/assert/zipball/541057574806f942c94662b817a50f63f7345360",
-                "reference": "541057574806f942c94662b817a50f63f7345360",
-                "shasum": ""
-            },
-            "require": {
-                "ext-ctype": "*",
-                "ext-date": "*",
-                "ext-filter": "*",
-                "php": "^7.2 || ^8.0"
-            },
-            "suggest": {
-                "ext-intl": "",
-                "ext-simplexml": "",
-                "ext-spl": ""
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "1.10-dev"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "Webmozart\\Assert\\": "src/"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Bernhard Schussek",
-                    "email": "bschussek@gmail.com"
-                }
-            ],
-            "description": "Assertions to validate method input/output with nice error messages.",
-            "keywords": [
-                "assert",
-                "check",
-                "validate"
-            ],
-            "support": {
-                "issues": "https://github.com/webmozarts/assert/issues",
-                "source": "https://github.com/webmozarts/assert/tree/1.12.0"
-            },
-            "time": "2025-10-20T12:43:39+00:00"
-        },
         {
             "name": "wowcrypto/wowcrypto",
             "version": "1.2.0",
@@ -8751,28 +8725,28 @@
         },
         {
             "name": "symfony/yaml",
-            "version": "v7.3.3",
+            "version": "v7.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/yaml.git",
-                "reference": "d4f4a66866fe2451f61296924767280ab5732d9d"
+                "reference": "6c84a4b55aee4cd02034d1c528e83f69ddf63810"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/yaml/zipball/d4f4a66866fe2451f61296924767280ab5732d9d",
-                "reference": "d4f4a66866fe2451f61296924767280ab5732d9d",
+                "url": "https://api.github.com/repos/symfony/yaml/zipball/6c84a4b55aee4cd02034d1c528e83f69ddf63810",
+                "reference": "6c84a4b55aee4cd02034d1c528e83f69ddf63810",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.2",
-                "symfony/deprecation-contracts": "^2.5|^3.0",
+                "symfony/deprecation-contracts": "^2.5|^3",
                 "symfony/polyfill-ctype": "^1.8"
             },
             "conflict": {
                 "symfony/console": "<6.4"
             },
             "require-dev": {
-                "symfony/console": "^6.4|^7.0"
+                "symfony/console": "^6.4|^7.0|^8.0"
             },
             "bin": [
                 "Resources/bin/yaml-lint"
@@ -8803,7 +8777,7 @@
             "description": "Loads and dumps YAML files",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/yaml/tree/v7.3.3"
+                "source": "https://github.com/symfony/yaml/tree/v7.4.0"
             },
             "funding": [
                 {
@@ -8823,20 +8797,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-08-27T11:34:33+00:00"
+            "time": "2025-11-16T10:14:42+00:00"
         },
         {
             "name": "theseer/tokenizer",
-            "version": "1.2.3",
+            "version": "1.3.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/theseer/tokenizer.git",
-                "reference": "737eda637ed5e28c3413cb1ebe8bb52cbf1ca7a2"
+                "reference": "b7489ce515e168639d17feec34b8847c326b0b3c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/theseer/tokenizer/zipball/737eda637ed5e28c3413cb1ebe8bb52cbf1ca7a2",
-                "reference": "737eda637ed5e28c3413cb1ebe8bb52cbf1ca7a2",
+                "url": "https://api.github.com/repos/theseer/tokenizer/zipball/b7489ce515e168639d17feec34b8847c326b0b3c",
+                "reference": "b7489ce515e168639d17feec34b8847c326b0b3c",
                 "shasum": ""
             },
             "require": {
@@ -8865,7 +8839,7 @@
             "description": "A small library for converting tokenized PHP source code into XML and potentially other formats",
             "support": {
                 "issues": "https://github.com/theseer/tokenizer/issues",
-                "source": "https://github.com/theseer/tokenizer/tree/1.2.3"
+                "source": "https://github.com/theseer/tokenizer/tree/1.3.1"
             },
             "funding": [
                 {
@@ -8873,7 +8847,7 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-03-03T12:36:25+00:00"
+            "time": "2025-11-17T20:03:58+00:00"
         }
     ],
     "aliases": [],
diff --git a/config/database.php b/config/database.php
index ca960a8..944683f 100755
--- a/config/database.php
+++ b/config/database.php
@@ -56,10 +56,7 @@
             'prefix' => '',
             'prefix_indexes' => true,
             'strict' => true,
-            'engine' => null,
-            'options' => extension_loaded('pdo_mysql') ? array_filter([
-                PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
-            ]) : [],
+            'engine' => null
         ],
 
         'mysql_characters' => [
@@ -76,10 +73,7 @@
             'prefix' => '',
             'prefix_indexes' => true,
             'strict' => true,
-            'engine' => null,
-            'options' => extension_loaded('pdo_mysql') ? array_filter([
-                PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
-            ]) : [],
+            'engine' => null
         ],
 
         'mysql_world' => [
@@ -96,10 +90,7 @@
             'prefix' => '',
             'prefix_indexes' => true,
             'strict' => true,
-            'engine' => null,
-            'options' => extension_loaded('pdo_mysql') ? array_filter([
-                PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
-            ]) : [],
+            'engine' => null
         ],
 
         'mariadb' => [
@@ -116,10 +107,7 @@
             'prefix' => '',
             'prefix_indexes' => true,
             'strict' => true,
-            'engine' => null,
-            'options' => extension_loaded('pdo_mysql') ? array_filter([
-                PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
-            ]) : [],
+            'engine' => null
         ],
 
         'pgsql' => [

From 68ae71813a7ce4128a07433b670dcf7629414268 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 31 Dec 2025 20:21:06 +0100
Subject: [PATCH 007/132] refactor: improve RedisLibrary with fallback to Cache
 and add validation

- Add Redis fallback to Laravel Cache when Redis is disabled or fails
- Implement input validation in AccountLibrary for account creation
- Remove debug code from HomeController
- Add type hints and docblocks to NewsController methods
- Add .env.example file with default configuration
---
 .env.example                                  |  62 +++++++++++
 .../Controllers/Frontend/HomeController.php   |   6 -
 .../Controllers/Frontend/NewsController.php   |  23 +++-
 app/Libraries/Auth/AccountLibrary.php         |  39 ++++++-
 app/Libraries/Redis/RedisLibrary.php          | 104 ++++++++++++++++--
 5 files changed, 212 insertions(+), 22 deletions(-)
 create mode 100644 .env.example

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..ce7a7da
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,62 @@
+APP_NAME="NexusCMS"
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_URL="https://nexuscms.test"
+
+APP_LOCALE="en"
+APP_FALLBACK_LOCALE=en
+APP_FAKER_LOCALE=en_US
+
+APP_MAINTENANCE_DRIVER=file
+# APP_MAINTENANCE_STORE=database
+
+PHP_CLI_SERVER_WORKERS=4
+
+BCRYPT_ROUNDS=12
+
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+DB_CONNECTION="mysql"
+DB_HOST="127.0.0.1"
+DB_PORT="3306"
+DB_DATABASE="test"
+DB_USERNAME="root"
+DB_PASSWORD="root"
+
+SESSION_DRIVER=database
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+BROADCAST_CONNECTION=log
+FILESYSTEM_DISK=local
+QUEUE_CONNECTION=database
+MEMCACHED_HOST=127.0.0.1
+
+CACHE_DRIVER=redis
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379
+
+MAIL_MAILER=smtp
+MAIL_HOST=localhost
+MAIL_PORT=1025
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_ENCRYPTION=null
+MAIL_FROM_ADDRESS="noreply@nexuscms.test"
+MAIL_FROM_NAME="${APP_NAME}"
+MAIL_SCHEME=null
+
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+VITE_APP_NAME="${APP_NAME}"
diff --git a/app/Http/Controllers/Frontend/HomeController.php b/app/Http/Controllers/Frontend/HomeController.php
index dfc92d7..4bfcf03 100644
--- a/app/Http/Controllers/Frontend/HomeController.php
+++ b/app/Http/Controllers/Frontend/HomeController.php
@@ -73,12 +73,6 @@ public function index(Request $request, \App\Libraries\Redis\RedisLibrary $redis
             $redis->set($featuredKey, $featuredNews, 60);
         }   
     
-        if ($featuredNews)
-        {
-            
-        var_dump($featuredNews);
-        die();
-        }
         $data = [
             'realms' => $realms,
             'featuredNews' => $featuredNews,
diff --git a/app/Http/Controllers/Frontend/NewsController.php b/app/Http/Controllers/Frontend/NewsController.php
index dd73fe7..4b0f755 100755
--- a/app/Http/Controllers/Frontend/NewsController.php
+++ b/app/Http/Controllers/Frontend/NewsController.php
@@ -7,6 +7,8 @@
 use App\Helpers\GeneralHelper;
 use App\Models\NewsCategory;
 use Illuminate\Http\Request;
+use Illuminate\Contracts\View\View;
+
 /**
  * Frontend Home Controller for handling main website pages
  */
@@ -28,20 +30,28 @@ class NewsController extends Controller
 
     /**
      * Per page
+     *
+     * @var int
      */
     protected $perPage = 5;
 
     /**
      * Default view for the controller
      *
-     * @var string
+     * @var array<string,string>
      */
     protected $views = [
         'index' => 'news.index',
         'show' => 'news.show',
     ];
 
-    public function index(Request $request)
+    /**
+     * Display a listing of published news articles with optional category filtering.
+     *
+     * @param Request $request
+     * @return View
+     */
+    public function index(Request $request): View
     {
         $category = $request->get('category', 'all');
         $query = News::where('is_published', true)->orderBy('created_at', 'desc');
@@ -59,7 +69,14 @@ public function index(Request $request)
         return view($this->views['index'], ['data' => $items, 'recentNews' => $recentNews, 'category' => $category]);
     }
 
-    public function show(string $slug, ?string $view = null)
+    /**
+     * Display a single news article by slug.
+     *
+     * @param string $slug
+     * @param string|null $view
+     * @return View
+     */
+    public function show(string $slug, ?string $view = null): View
     {
         $item = (new News)->getCachedByField('slug', $slug);
         if (!$item) abort(404);
diff --git a/app/Libraries/Auth/AccountLibrary.php b/app/Libraries/Auth/AccountLibrary.php
index 3ea0d3f..1eda22e 100755
--- a/app/Libraries/Auth/AccountLibrary.php
+++ b/app/Libraries/Auth/AccountLibrary.php
@@ -6,15 +6,27 @@
 
 class AccountLibrary
 {
+    /**
+     * The SoapAccountCreator instance for account creation.
+     */
     private SoapAccountCreator $soapCreator;
+
+    /**
+     * The realm object containing console credentials.
+     */
     private object $realm;
 
+    /**
+     * Constructor to initialize the AccountLibrary with realm credentials.
+     *
+     * @param object $realm The realm object containing console credentials.
+     */
     public function __construct(object $realm)
     {
         $this->realm = $realm;
         $this->soapCreator = new SoapAccountCreator(
             $realm->console_hostname,
-            $realm->console_port, 
+            $realm->console_port,
             $realm->console_username,
             $realm->console_password,
             $realm->console_urn,
@@ -23,15 +35,36 @@ public function __construct(object $realm)
     }
 
     /**
-     * Creates a new account using either Battle.net or non-Battle.net authentication
+     * Creates a new account using either Battle.net or non-Battle.net authentication.
+     *
+     * @param string $username The username for the new account.
+     * @param string $password The password for the new account.
+     * @param string $email    The email address for the new account.
+     * @param bool   $isBnet   Whether the account is for Battle.net authentication.
+     *
+     * @return bool True if the account was successfully created, false otherwise.
+     *
+     * @throws \Exception If the account creation fails.
      */
     public function createNewAccount(string $username, string $password, string $email, bool $isBnet = false): bool
     {
         try {
+            // Validate username and password length
+            if (strlen($username) < 3 || strlen($password) < 6) {
+                throw new \Exception('Username must be at least 3 characters long and password must be at least 6 characters long.');
+            }
+
+            // Validate email format
+            if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
+                throw new \Exception('Invalid email format.');
+            }
+
             if ($isBnet) {
+                // Create Battle.net account
                 return $this->soapCreator->createAccountBnet($email, $password);
             }
-            
+
+            // Create non-Battle.net account
             return $this->soapCreator->createAccount($username, $password, $email);
         } catch (\Exception $e) {
             throw new \Exception('Account creation failed: ' . $e->getMessage());
diff --git a/app/Libraries/Redis/RedisLibrary.php b/app/Libraries/Redis/RedisLibrary.php
index 5967983..dbaaa6d 100644
--- a/app/Libraries/Redis/RedisLibrary.php
+++ b/app/Libraries/Redis/RedisLibrary.php
@@ -3,6 +3,7 @@
 namespace App\Libraries\Redis;
 
 use Illuminate\Support\Facades\Redis;
+use Illuminate\Support\Facades\Cache;
 
 /**
  * Class RedisLibrary
@@ -14,6 +15,8 @@ class RedisLibrary
 {
     /** @var string Global key prefix */
     private string $prefix;
+    /** @var bool Whether Redis operations are enabled */
+    private bool $enabled;
 
     /**
      * RedisLibrary constructor.
@@ -23,6 +26,8 @@ class RedisLibrary
     public function __construct(string $prefix = '')
     {
         $this->prefix = $prefix;
+        // Leer flag desde .env (por petición explícita). Si no existe, por defecto deshabilitado.
+        $this->enabled = filter_var(env('REDIS_ENABLED', false), FILTER_VALIDATE_BOOL);
     }
 
     /**
@@ -53,11 +58,28 @@ public function set(string $key, mixed $value, int $ttl = 0): bool
     {
         $key = $this->key($key);
 
-        if ($ttl > 0) {
-            return Redis::setex($key, $ttl, json_encode($value));
+        if (!$this->enabled) {
+            if ($ttl > 0) {
+                Cache::put($key, $value, now()->addSeconds($ttl));
+            } else {
+                Cache::forever($key, $value);
+            }
+            return true;
         }
 
-        return Redis::set($key, json_encode($value));
+        try {
+            if ($ttl > 0) {
+                return Redis::set($key, $ttl, json_encode($value));
+            }
+            return Redis::set($key, json_encode($value));
+        } catch (\Throwable $e) {
+            if ($ttl > 0) {
+                Cache::put($key, $value, now()->addSeconds($ttl));
+            } else {
+                Cache::forever($key, $value);
+            }
+            return true;
+        }
     }
 
     /**
@@ -68,8 +90,18 @@ public function set(string $key, mixed $value, int $ttl = 0): bool
      */
     public function get(string $key): mixed
     {
-        $value = Redis::get($this->key($key));
-        return $value ? json_decode($value, true) : null;
+        $key = $this->key($key);
+
+        if (!$this->enabled) {
+            return Cache::get($key, null);
+        }
+
+        try {
+            $value = Redis::get($key);
+            return $value ? json_decode($value, true) : null;
+        } catch (\Throwable $e) {
+            return Cache::get($key, null);
+        }
     }
 
     /**
@@ -80,7 +112,15 @@ public function get(string $key): mixed
      */
     public function delete(string $key): bool
     {
-        return Redis::del($this->key($key)) > 0;
+        $key = $this->key($key);
+        if (!$this->enabled) {
+            return Cache::forget($key);
+        }
+        try {
+            return Redis::del($key) > 0;
+        } catch (\Throwable $e) {
+            return Cache::forget($key);
+        }
     }
 
     /**
@@ -91,7 +131,15 @@ public function delete(string $key): bool
      */
     public function exists(string $key): bool
     {
-        return Redis::exists($this->key($key)) === 1;
+        $key = $this->key($key);
+        if (!$this->enabled) {
+            return Cache::has($key);
+        }
+        try {
+            return Redis::exists($key) === 1;
+        } catch (\Throwable $e) {
+            return Cache::has($key);
+        }
     }
 
     /**
@@ -102,7 +150,15 @@ public function exists(string $key): bool
      */
     public function ttl(string $key): int
     {
-        return Redis::ttl($this->key($key));
+        $key = $this->key($key);
+        if (!$this->enabled) {
+            return -1; // TTL no disponible en fallback de Cache
+        }
+        try {
+            return Redis::ttl($key);
+        } catch (\Throwable $e) {
+            return -1;
+        }
     }
 
     /**
@@ -114,7 +170,21 @@ public function ttl(string $key): int
      */
     public function increment(string $key, int $amount = 1): int
     {
-        return Redis::incrby($this->key($key), $amount);
+        $key = $this->key($key);
+        if (!$this->enabled) {
+            $current = (int) (Cache::get($key, 0) ?? 0);
+            $new = $current + $amount;
+            Cache::put($key, $new);
+            return $new;
+        }
+        try {
+            return Redis::incrby($key, $amount);
+        } catch (\Throwable $e) {
+            $current = (int) (Cache::get($key, 0) ?? 0);
+            $new = $current + $amount;
+            Cache::put($key, $new);
+            return $new;
+        }
     }
 
     /**
@@ -126,7 +196,21 @@ public function increment(string $key, int $amount = 1): int
      */
     public function decrement(string $key, int $amount = 1): int
     {
-        return Redis::decrby($this->key($key), $amount);
+        $key = $this->key($key);
+        if (!$this->enabled) {
+            $current = (int) (Cache::get($key, 0) ?? 0);
+            $new = $current - $amount;
+            Cache::put($key, $new);
+            return $new;
+        }
+        try {
+            return Redis::decrby($key, $amount);
+        } catch (\Throwable $e) {
+            $current = (int) (Cache::get($key, 0) ?? 0);
+            $new = $current - $amount;
+            Cache::put($key, $new);
+            return $new;
+        }
     }
 
     /* ======================================================

From 01f77f2e56a43dfb10843f5bb5dc6733fbfb18a2 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 1 Jan 2026 14:22:30 +0100
Subject: [PATCH 008/132] build: add nixpacks configuration for PHP deployment

---
 nixpacks.toml | 11 +++++++++++
 1 file changed, 11 insertions(+)
 create mode 100644 nixpacks.toml

diff --git a/nixpacks.toml b/nixpacks.toml
new file mode 100644
index 0000000..73d56d8
--- /dev/null
+++ b/nixpacks.toml
@@ -0,0 +1,11 @@
+providers = ["php"]
+
+[phases.install]
+cmds = [
+  "composer install --no-dev --optimize-autoloader"
+]
+
+[phases.build]
+cmds = [
+  "php artisan migrate --force || true"
+]

From 1877553dfec6e5df851277dd1fbba7a66317d6d5 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 1 Jan 2026 14:27:43 +0100
Subject: [PATCH 009/132] build: update nixpacks configuration for deployment

- Add --ignore-platform-reqs flag to composer install for compatibility
- Move migration command to start phase and combine with nginx/php-fpm setup
---
 nixpacks.toml | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/nixpacks.toml b/nixpacks.toml
index 73d56d8..f1f1dc3 100644
--- a/nixpacks.toml
+++ b/nixpacks.toml
@@ -2,10 +2,8 @@ providers = ["php"]
 
 [phases.install]
 cmds = [
-  "composer install --no-dev --optimize-autoloader"
+  "composer install --no-dev --optimize-autoloader --ignore-platform-reqs"
 ]
 
-[phases.build]
-cmds = [
-  "php artisan migrate --force || true"
-]
+[start]
+cmd = "php artisan migrate --force || true && node /assets/scripts/prestart.mjs /assets/nginx.template.conf /nginx.conf && (php-fpm -y /assets/php-fpm.conf & nginx -c /nginx.conf)"

From 75418544dab6f82f8de36b5b6e858d9977e22c58 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 1 Jan 2026 14:32:20 +0100
Subject: [PATCH 010/132] build(nixpacks): add required php extensions and
 nodejs for laravel

Add typical Laravel PHP extensions (pdo, mbstring, bcmath etc) and Node.js 18 with npm for nginx template support in the Nixpacks configuration.
---
 nixpacks.toml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/nixpacks.toml b/nixpacks.toml
index f1f1dc3..432659b 100644
--- a/nixpacks.toml
+++ b/nixpacks.toml
@@ -1,5 +1,24 @@
 providers = ["php"]
 
+[phases.setup]
+nixPkgs = [
+  "php84",
+  "php84Packages.composer",
+
+  # Extensiones típicas Laravel
+  "php84Extensions.pdo",
+  "php84Extensions.pdo_mysql",
+  "php84Extensions.mbstring",
+  "php84Extensions.bcmath",
+  "php84Extensions.openssl",
+  "php84Extensions.tokenizer",
+  "php84Extensions.xml",
+
+  # Necesario para nginx template
+  "nodejs_18",
+  "npm-9_x"
+]
+
 [phases.install]
 cmds = [
   "composer install --no-dev --optimize-autoloader --ignore-platform-reqs"

From 3b9ead661c2fdd2b7cc4816be47eec9d6cb0d394 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 1 Jan 2026 14:40:29 +0100
Subject: [PATCH 011/132] build(nixpacks): disable nodejs and clean up php
 extensions

---
 nixpacks.toml | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/nixpacks.toml b/nixpacks.toml
index 432659b..7e6c104 100644
--- a/nixpacks.toml
+++ b/nixpacks.toml
@@ -1,22 +1,19 @@
 providers = ["php"]
 
+[variables]
+NIXPACKS_NODE_DISABLED = "1"
+
 [phases.setup]
 nixPkgs = [
   "php84",
   "php84Packages.composer",
-
-  # Extensiones típicas Laravel
   "php84Extensions.pdo",
   "php84Extensions.pdo_mysql",
   "php84Extensions.mbstring",
   "php84Extensions.bcmath",
   "php84Extensions.openssl",
   "php84Extensions.tokenizer",
-  "php84Extensions.xml",
-
-  # Necesario para nginx template
-  "nodejs_18",
-  "npm-9_x"
+  "php84Extensions.xml"
 ]
 
 [phases.install]

From 149bda5da7c7bbe1a7499c3e6a1488060287fa6d Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 1 Jan 2026 14:42:40 +0100
Subject: [PATCH 012/132] fix: simplify start command by removing unnecessary
 operations

---
 nixpacks.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/nixpacks.toml b/nixpacks.toml
index 7e6c104..f64b4f3 100644
--- a/nixpacks.toml
+++ b/nixpacks.toml
@@ -22,4 +22,4 @@ cmds = [
 ]
 
 [start]
-cmd = "php artisan migrate --force || true && node /assets/scripts/prestart.mjs /assets/nginx.template.conf /nginx.conf && (php-fpm -y /assets/php-fpm.conf & nginx -c /nginx.conf)"
+cmd = "php artisan migrate --force"

From f58bccbd0bab298cbbd63da2caf0ec7eb78adb8a Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 1 Jan 2026 14:52:03 +0100
Subject: [PATCH 013/132] build(nixpacks): update nixpacks configuration for
 postbuild phase

---
 nixpacks.toml | 26 ++++----------------------
 1 file changed, 4 insertions(+), 22 deletions(-)

diff --git a/nixpacks.toml b/nixpacks.toml
index f64b4f3..f779ae9 100644
--- a/nixpacks.toml
+++ b/nixpacks.toml
@@ -1,25 +1,7 @@
-providers = ["php"]
-
-[variables]
-NIXPACKS_NODE_DISABLED = "1"
-
-[phases.setup]
-nixPkgs = [
-  "php84",
-  "php84Packages.composer",
-  "php84Extensions.pdo",
-  "php84Extensions.pdo_mysql",
-  "php84Extensions.mbstring",
-  "php84Extensions.bcmath",
-  "php84Extensions.openssl",
-  "php84Extensions.tokenizer",
-  "php84Extensions.xml"
-]
-
-[phases.install]
+[phases.postbuild]
 cmds = [
-  "composer install --no-dev --optimize-autoloader --ignore-platform-reqs"
+    "php /app/artisan optimize:clear",
+    "php /app/artisan migrate --force",
 ]
 
-[start]
-cmd = "php artisan migrate --force"
+dependsOn = ["build"]
\ No newline at end of file

From aaa1f4e8688825a4670fc0813da7f9e2a50037fb Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 1 Jan 2026 14:59:38 +0100
Subject: [PATCH 014/132] style: remove extra blank line in routes file

---
 routes/web.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/routes/web.php b/routes/web.php
index 58bf602..9c4cd1f 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -31,7 +31,6 @@
     }
 });
 
-
 Route::middleware([])->group(function () {
     if (!file_exists(storage_path('installed.lock'))) {
         Route::get('/install', [InstallController::class, 'index'])->name('install.index');

From 2ccdf0602edc0885174fda3ed284056e8a8da0e9 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 1 Jan 2026 15:09:07 +0100
Subject: [PATCH 015/132] refactor(RedisLibrary): remove redundant section
 comments

---
 app/Libraries/Redis/RedisLibrary.php | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/app/Libraries/Redis/RedisLibrary.php b/app/Libraries/Redis/RedisLibrary.php
index dbaaa6d..d36fbc7 100644
--- a/app/Libraries/Redis/RedisLibrary.php
+++ b/app/Libraries/Redis/RedisLibrary.php
@@ -41,10 +41,6 @@ private function key(string $key): string
         return $this->prefix . $key;
     }
 
-    /* ======================================================
-     * Basic Key/Value Methods
-     * ====================================================== */
-
     /**
      * Store a value in Redis.
      *
@@ -213,10 +209,6 @@ public function decrement(string $key, int $amount = 1): int
         }
     }
 
-    /* ======================================================
-     * Token Management (JWT / Sessions)
-     * ====================================================== */
-
     /**
      * Store a user token using a namespaced key.
      *

From 38d8ff5367ec92e171cb889eaac759be286c7a8f Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 1 Jan 2026 15:14:38 +0100
Subject: [PATCH 016/132] refactor: remove redundant comment in AccountLinked
 model

---
 app/Models/AccountLinked.php | 40 +++++++++++++++++++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

diff --git a/app/Models/AccountLinked.php b/app/Models/AccountLinked.php
index 80ce240..dde0b4b 100755
--- a/app/Models/AccountLinked.php
+++ b/app/Models/AccountLinked.php
@@ -4,22 +4,60 @@
 
 use Illuminate\Database\Eloquent\Model;
 
+/**
+ * App\Models\AccountLinked
+ *
+ * @property int $id
+ * @property int $user_id
+ * @property int $realm_id
+ * @property int $target_id
+ * @property \Illuminate\Support\Carbon|null $created_at
+ * @property \Illuminate\Support\Carbon|null $updated_at
+ * @property-read \App\Models\User $user
+ * @property-read \App\Models\Realm $realm
+ *
+ * @method static \Illuminate\Database\Eloquent\Builder|AccountLinked newModelQuery()
+ * @method static \Illuminate\Database\Eloquent\Builder|AccountLinked newQuery()
+ * @method static \Illuminate\Database\Eloquent\Builder|AccountLinked query()
+ * @method static \Illuminate\Database\Eloquent\Builder|AccountLinked whereUserId($value)
+ * @method static \Illuminate\Database\Eloquent\Builder|AccountLinked whereRealmId($value)
+ * @method static \Illuminate\Database\Eloquent\Builder|AccountLinked whereTargetId($value)
+ */
 class AccountLinked extends Model
 {
+    /**
+     * The table associated with the model.
+     *
+     * @var string
+     */
     protected $table = 'account_linked';
 
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array<int, string>
+     */
     protected $fillable = [
         'user_id',
         'realm_id',
         'target_id'
     ];
 
-    // Relaciones
+    /**
+     * Get the user that owns the account link.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo<\App\Models\User, \App\Models\AccountLinked>
+     */
     public function user()
     {
         return $this->belongsTo(User::class);
     }
 
+    /**
+     * Get the realm that owns the account link.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo<\App\Models\Realm, \App\Models\AccountLinked>
+     */
     public function realm()
     {
         return $this->belongsTo(Realm::class);

From 98fc509a96a42ee97438f5eb35c590f0049ee58d Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 3 Jan 2026 13:47:56 +0100
Subject: [PATCH 017/132] refactor: remove unused ArmoryController and add
 Redis enabled flag

The ArmoryController was deleted as it's no longer used in the application. Added an enabled flag to RedisLibrary to control Redis operations.
---
 .../Controllers/Frontend/ArmoryController.php | 84 -------------------
 app/Libraries/Redis/RedisLibrary.php          |  1 +
 2 files changed, 1 insertion(+), 84 deletions(-)
 delete mode 100644 app/Http/Controllers/Frontend/ArmoryController.php

diff --git a/app/Http/Controllers/Frontend/ArmoryController.php b/app/Http/Controllers/Frontend/ArmoryController.php
deleted file mode 100644
index ec86763..0000000
--- a/app/Http/Controllers/Frontend/ArmoryController.php
+++ /dev/null
@@ -1,84 +0,0 @@
-<?php
-
-namespace App\Http\Controllers\Frontend;
-
-use App\Helpers\RealmHelper;
-use App\Http\Controllers\Controller;
-use App\Interfaces\ArmoryRepositoryInterface;
-use Illuminate\Http\Request;
-use Illuminate\Contracts\Pagination\LengthAwarePaginator;
-use Illuminate\Support\Facades\Cache;
-use App\Services\Parser\WowheadParserService;
-use App\Services\ArmoryService;
-
-/**
- * Frontend Armory Controller
- *
- * Handles public-facing Armory pages using the Armory repository.
- */
-class ArmoryController extends Controller
-{
-    protected int $perPage = 9;
-
-    protected array $views = [
-        'index' => 'armory.index',
-        'show'  => 'armory.show',
-    ];
-
-    protected ArmoryRepositoryInterface $armoryRepo;
-    protected WowheadParserService $wowheadParser;
-    protected ArmoryService $armoryService;
-
-    public function __construct(
-        ArmoryRepositoryInterface $armoryRepo, 
-        WowheadParserService $wowheadParser,
-        ArmoryService $armoryService
-    ) {
-        $this->armoryRepo = $armoryRepo;
-        $this->wowheadParser = $wowheadParser;
-        $this->armoryService = $armoryService;
-    }
-
-    /**
-     * Display a paginated list of Armory characters
-     */
-    public function index(Request $request)
-    {
-        $q = $request->input('q');
-        $faction = $request->input('faction') ?: null;
-        $realm = $request->input('realm') ?: 1; // Default to realm 1 if not specified
-        $class = $request->input('class') ?: null;
-        $minLevel = $request->input('min_level') ?: null;
-
-        // Pass realm to the repository through the request
-        $request->merge(['realm' => $realm]);
-
-        $characters = ($q || $faction || $class || $minLevel) 
-            ? $this->armoryService->searchCharacters($q, $faction, $class, $minLevel)
-            : collect();
-        
-        return view($this->views['index'], [
-            'data' => $characters,
-            'search' => $q ?? '',
-            'realm' => $realm,
-        ]);
-    }
-
-    /**
-     * Show a single character by GUID
-     */
-    public function show(int $guid, Request $request, ?int $realm = null)
-    {
-        // Get realm from URL parameter or query string, default to 1
-        $realm = $realm ?: $request->input('realm', 1);
-        
-        // Pass realm to the repository through the request
-        $request->merge(['realm' => $realm]);
-
-        $profile = $this->armoryService->getCharacterProfile($guid);
-        
-        abort_if(empty($profile), 404);
-
-        return view($this->views['show'], array_merge($profile, ['realm' => $realm]));
-    }
-}
diff --git a/app/Libraries/Redis/RedisLibrary.php b/app/Libraries/Redis/RedisLibrary.php
index d36fbc7..6366cf7 100644
--- a/app/Libraries/Redis/RedisLibrary.php
+++ b/app/Libraries/Redis/RedisLibrary.php
@@ -15,6 +15,7 @@ class RedisLibrary
 {
     /** @var string Global key prefix */
     private string $prefix;
+    
     /** @var bool Whether Redis operations are enabled */
     private bool $enabled;
 

From 5a18e1a88ad03516f6f3148b17091c62514a5074 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 3 Jan 2026 14:03:34 +0100
Subject: [PATCH 018/132] feat(WoWConstants): update race and expansion
 constants

Add new expansion MIDNIGHT and update race constants to include missing races and correct existing values. Update corresponding expansion names, colors, and max levels to reflect current game state.
---
 app/Enums/WoWConstants.php | 46 ++++++++++++++++++++++++++------------
 1 file changed, 32 insertions(+), 14 deletions(-)

diff --git a/app/Enums/WoWConstants.php b/app/Enums/WoWConstants.php
index 469e3ca..87d588c 100755
--- a/app/Enums/WoWConstants.php
+++ b/app/Enums/WoWConstants.php
@@ -16,6 +16,7 @@ class WoWConstants
     public const EXPANSION_SHADOWLANDS = 8;
     public const EXPANSION_DRAGONFLIGHT = 9;
     public const EXPANSION_WAR_WITHIN = 10;
+    public const EXPANSION_MIDNIGHT = 11;
     
     // Classes
     public const CLASS_WARRIOR = 1;
@@ -41,16 +42,28 @@ class WoWConstants
     public const RACE_TAUREN = 6;
     public const RACE_GNOME = 7;
     public const RACE_TROLL = 8;
-    public const RACE_BLOODELF = 9;
-    public const RACE_DRAENEI = 10;
-    public const RACE_WOLF = 11;
-    public const RACE_GOBLIN = 12;
-    public const RACE_PANDAREN = 13;
-    public const RACE_DARK_IRON_DWARF = 14;
-    public const RACE_HIGHMOUNTAIN_TAUREN = 15;
-    public const RACE_VOID_ELF = 16;
-    public const RACE_MAGHAR_ORC = 17;
-    
+    public const RACE_GOBLIN = 9;
+    public const RACE_BLOODELF = 10;
+    public const RACE_DRAENEI = 11;
+    public const RACE_WORGEN = 22;
+    public const RACE_PANDAREN = 24; // Neutral Pandaren
+    public const RACE_PANDAREN_ALLIANCE = 25; // Alliance Pandaren
+    public const RACE_PANDAREN_HORDE = 26; // Horde Pandaren
+    public const RACE_NIGHTBORNE = 27; // Nightborne
+    public const RACE_HIGHMOUNTAIN_TAUREN = 28; // Highmountain Tauren
+    public const RACE_VOID_ELF = 29; // Void Elf
+    public const RACE_LIGHTFORGED_DRAENEI = 30; // Lightforged Draenei
+    public const RACE_ZANDALARI_TROLL = 31; // Zandalari Troll
+    public const RACE_KUL_TIRAN = 32; // Kul'Tiran
+    public const RACE_DARK_IRON_DWARF = 34; // Dark Iron Dwarf
+    public const RACE_VULPERA = 35; // Vulpera
+    public const RACE_MAGHAR_ORC = 36; // Maghar Orc
+    public const RACE_MECAGHOME = 37; // Mecaghome
+    public const RACE_DRACTHYR_ALLIANCE = 52; // Draconic
+    public const RACE_DRACTHYR_HORDE = 70; // Draconic
+    public const RACE_EARTHEN_HORDE  = 84; // Earthen
+    public const RACE_EARTHEN_ALLIANCE  = 85; // Earthen
+
     public const EXPANSION_NAMES = [
         self::EXPANSION_VANILLA => 'Vanilla',
         self::EXPANSION_TBC => 'The Burning Crusade',
@@ -63,6 +76,7 @@ class WoWConstants
         self::EXPANSION_SHADOWLANDS => 'Shadowlands',
         self::EXPANSION_DRAGONFLIGHT => 'Dragonflight',
         self::EXPANSION_WAR_WITHIN   => 'The War Within',
+        self::EXPANSION_MIDNIGHT     => 'Midnight',
     ];
 
     public const EXPANSION_VERSIONS = [
@@ -91,6 +105,7 @@ class WoWConstants
         self::EXPANSION_SHADOWLANDS => 'border-blue-500',
         self::EXPANSION_DRAGONFLIGHT => 'border-green-500',
         self::EXPANSION_WAR_WITHIN   => 'border-yellow-500',
+        self::EXPANSION_MIDNIGHT     => 'border-pink-500',
     ];
 
     public const EXPANSION_MAX_LEVEL = [
@@ -105,6 +120,7 @@ class WoWConstants
         self::EXPANSION_SHADOWLANDS => 60,
         self::EXPANSION_DRAGONFLIGHT => 70,
         self::EXPANSION_WAR_WITHIN   => 80,
+        self::EXPANSION_MIDNIGHT     => 90,
     ];
     
     public const CLASS_NAMES = [
@@ -153,8 +169,8 @@ class WoWConstants
         11 => 'Draenei',
         22 => 'Worgen',
         24 => 'Pandaren',
-        25 => 'Pandaren',
-        26 => 'Pandaren',
+        25 => 'Pandaren Alliance',
+        26 => 'Pandaren Horde',
         27 => 'Nightborne',
         28 => 'Highmountain Tauren',
         29 => 'Void Elf',
@@ -165,7 +181,9 @@ class WoWConstants
         35 => 'Vulpera',
         36 => "Mag'har Orc",
         37 => 'Mechagnome',
-        52 => 'Dracthyr',
-        70 => 'Dracthyr',
+        52 => 'Draconic Alliance',
+        70 => 'Draconic Horde',
+        84 => 'Earthen Horde',
+        85 => 'Earthen Alliance',
     ];
 }

From 358b20424a0635122fa1d5945ccc2d8e5a76bb03 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 3 Jan 2026 14:09:20 +0100
Subject: [PATCH 019/132] feat(RealmHelper): add new playable races to faction
 lists

Update alliance and horde race lists to include newly added playable races from recent game expansions
---
 app/Helpers/RealmHelper.php | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/app/Helpers/RealmHelper.php b/app/Helpers/RealmHelper.php
index 9482da5..e0d843c 100755
--- a/app/Helpers/RealmHelper.php
+++ b/app/Helpers/RealmHelper.php
@@ -73,7 +73,15 @@ public static function getFactionByRace(int $race): ?string
             WoWConstants::RACE_NIGHT_ELF,
             WoWConstants::RACE_GNOME,
             WoWConstants::RACE_DRAENEI,
+            WoWConstants::RACE_WORGEN,
+            WoWConstants::RACE_PANDAREN_ALLIANCE,
             WoWConstants::RACE_VOID_ELF,
+            WoWConstants::RACE_LIGHTFORGED_DRAENEI,
+            WoWConstants::RACE_KUL_TIRAN,
+            WoWConstants::RACE_DARK_IRON_DWARF,
+            WoWConstants::RACE_MECAGHOME,
+            WoWConstants::RACE_DRACTHYR_ALLIANCE,
+            WoWConstants::RACE_EARTHEN_ALLIANCE,
         ];
 
         $hordeRaces = [
@@ -81,12 +89,16 @@ public static function getFactionByRace(int $race): ?string
             WoWConstants::RACE_UNDEAD,
             WoWConstants::RACE_TAUREN,
             WoWConstants::RACE_TROLL,
-            WoWConstants::RACE_BLOODELF,
             WoWConstants::RACE_GOBLIN,
-            WoWConstants::RACE_MAGHAR_ORC,
+            WoWConstants::RACE_BLOODELF,
+            WoWConstants::RACE_PANDAREN_HORDE,
+            WoWConstants::RACE_NIGHTBORNE,
             WoWConstants::RACE_HIGHMOUNTAIN_TAUREN,
-            WoWConstants::RACE_DARK_IRON_DWARF,
-            WoWConstants::RACE_PANDAREN,
+            WoWConstants::RACE_ZANDALARI_TROLL,
+            WoWConstants::RACE_VULPERA,
+            WoWConstants::RACE_MAGHAR_ORC,
+            WoWConstants::RACE_DRACTHYR_HORDE,
+            WoWConstants::RACE_EARTHEN_HORDE,
         ];
 
         if (in_array($race, $allianceRaces, true)) {

From 737552da93441f11ec73a42736227976e793fb5b Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 3 Jan 2026 14:29:04 +0100
Subject: [PATCH 020/132] refactor(RealmHelper): improve type hints and switch
 to match expression

- Add return type hints for all() and find() methods
- Replace switch statement with match expression in getWoWConstant()
- Standardize faction strings to lowercase in getFactionByRace()
---
 app/Helpers/RealmHelper.php | 36 +++++++++++++++---------------------
 1 file changed, 15 insertions(+), 21 deletions(-)

diff --git a/app/Helpers/RealmHelper.php b/app/Helpers/RealmHelper.php
index e0d843c..60f310c 100755
--- a/app/Helpers/RealmHelper.php
+++ b/app/Helpers/RealmHelper.php
@@ -4,6 +4,7 @@
 
 use App\Models\Realm;
 use App\Enums\WoWConstants;
+use Illuminate\Database\Eloquent\Collection;
 
 class RealmHelper
 {
@@ -12,7 +13,7 @@ class RealmHelper
      *
      * @return \Illuminate\Database\Eloquent\Collection<int, Realm>
      */
-    public static function all()
+    public static function all(): Collection
     {
         return Realm::all();
     }
@@ -23,7 +24,7 @@ public static function all()
      * @param int $id The ID of the realm to find
      * @return Realm|null Returns the realm if found, null otherwise
      */
-    public static function find($id)
+    public static function find(int $id): ?Realm
     {
         return Realm::find($id);
     }
@@ -35,28 +36,21 @@ public static function find($id)
      * @param int|null $id The ID of the constant to get
      * @return string|null Returns the constant value for the given type and ID, or null if not found
      */
-    public static function getWoWConstant(string $type = 'expansion', ?int $id = null)
+    public static function getWoWConstant(string $type = 'expansion', ?int $id = null): string|int|null
     {
         if ($id === null) {
             return null;
         }
 
-        switch ($type) {
-            case 'expansion':
-                return WoWConstants::EXPANSION_NAMES[$id] ?? null;
-            case 'version':
-                return WoWConstants::EXPANSION_VERSIONS[$id] ?? null;
-            case 'color':
-                return WoWConstants::EXPANSION_COLORS[$id] ?? null;
-            case 'class':
-                return WoWConstants::CLASS_NAMES[$id] ?? null;
-            case 'class_color':
-                return WoWConstants::CLASS_COLORS[$id] ?? null;
-            case 'race':
-                return WoWConstants::RACE_NAMES[$id] ?? null;
-            default:
-                return null;
-        }
+        return match ($type) {
+            'expansion'   => WoWConstants::EXPANSION_NAMES[$id] ?? null,
+            'version'     => WoWConstants::EXPANSION_VERSIONS[$id] ?? null,
+            'color'       => WoWConstants::EXPANSION_COLORS[$id] ?? null,
+            'class'       => WoWConstants::CLASS_NAMES[$id] ?? null,
+            'class_color' => WoWConstants::CLASS_COLORS[$id] ?? null,
+            'race'        => WoWConstants::RACE_NAMES[$id] ?? null,
+            default       => null,
+        };
     }
 
     /**
@@ -102,11 +96,11 @@ public static function getFactionByRace(int $race): ?string
         ];
 
         if (in_array($race, $allianceRaces, true)) {
-            return 'Alliance';
+            return 'alliance';
         }
 
         if (in_array($race, $hordeRaces, true)) {
-            return 'Horde';
+            return 'horde';
         }
 
         return null;

From 57fb270bcc832497ab436b862279c7ce54a56de7 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 3 Jan 2026 23:54:33 +0100
Subject: [PATCH 021/132] feat(forum): implement forum module with models,
 routes and services

Add initial implementation of forum module including:
- Forum, Thread and Post models with relationships
- Basic routing and controller setup
- ForumService for business logic
- Initial views structure
---
 app/Modules/Forum/Domain/Models/Forum.php     |  54 ++++++
 app/Modules/Forum/Domain/Models/Post.php      |  36 ++++
 app/Modules/Forum/Domain/Models/Thread.php    |  64 +++++++
 .../Http/Controllers/ForumController.php      |  72 ++++++++
 app/Modules/Forum/Http/routes.php             |   9 +
 .../Forum/Providers/ForumServiceProvider.php  |  10 ++
 app/Modules/Forum/Services/ForumService.php   | 162 ++++++++++++++++++
 app/Modules/Forum/module.json                 |   8 +
 8 files changed, 415 insertions(+)
 create mode 100644 app/Modules/Forum/Domain/Models/Forum.php
 create mode 100644 app/Modules/Forum/Domain/Models/Post.php
 create mode 100644 app/Modules/Forum/Domain/Models/Thread.php
 create mode 100644 app/Modules/Forum/Http/Controllers/ForumController.php
 create mode 100644 app/Modules/Forum/Http/routes.php
 create mode 100644 app/Modules/Forum/Providers/ForumServiceProvider.php
 create mode 100644 app/Modules/Forum/Services/ForumService.php
 create mode 100644 app/Modules/Forum/module.json

diff --git a/app/Modules/Forum/Domain/Models/Forum.php b/app/Modules/Forum/Domain/Models/Forum.php
new file mode 100644
index 0000000..4a1bbbc
--- /dev/null
+++ b/app/Modules/Forum/Domain/Models/Forum.php
@@ -0,0 +1,54 @@
+<?php
+
+namespace Modules\Forum\Domain\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class Forum extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'name',
+        'description',
+        'slug',
+        'parent_id',
+        'order',
+        'is_category',
+    ];
+
+    /**
+     * Get all threads for this forum
+     */
+    public function threads(): HasMany
+    {
+        return $this->hasMany(Thread::class);
+    }
+
+    /**
+     * Get the parent forum if this is a subforum
+     */
+    public function parent(): BelongsTo
+    {
+        return $this->belongsTo(Forum::class, 'parent_id');
+    }
+
+    /**
+     * Get all subforums for this forum
+     */
+    public function subforums(): HasMany
+    {
+        return $this->hasMany(Forum::class, 'parent_id');
+    }
+
+    /**
+     * Get the latest thread in this forum
+     */
+    public function latestThread(): BelongsTo
+    {
+        return $this->belongsTo(Thread::class, 'latest_thread_id');
+    }
+}
\ No newline at end of file
diff --git a/app/Modules/Forum/Domain/Models/Post.php b/app/Modules/Forum/Domain/Models/Post.php
new file mode 100644
index 0000000..974cbd1
--- /dev/null
+++ b/app/Modules/Forum/Domain/Models/Post.php
@@ -0,0 +1,36 @@
+<?php
+
+namespace Modules\Forum\Domain\Models;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class Post extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'thread_id',
+        'user_id',
+        'content',
+        'is_first_post',
+    ];
+
+    /**
+     * Get the thread this post belongs to
+     */
+    public function thread(): BelongsTo
+    {
+        return $this->belongsTo(Thread::class);
+    }
+
+    /**
+     * Get the user who created this post
+     */
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}
\ No newline at end of file
diff --git a/app/Modules/Forum/Domain/Models/Thread.php b/app/Modules/Forum/Domain/Models/Thread.php
new file mode 100644
index 0000000..8f4f77f
--- /dev/null
+++ b/app/Modules/Forum/Domain/Models/Thread.php
@@ -0,0 +1,64 @@
+<?php
+
+namespace Modules\Forum\Domain\Models;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class Thread extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'title',
+        'slug',
+        'forum_id',
+        'user_id',
+        'is_sticky',
+        'is_locked',
+        'view_count',
+    ];
+
+    /**
+     * Get all posts for this thread
+     */
+    public function posts(): HasMany
+    {
+        return $this->hasMany(Post::class);
+    }
+
+    /**
+     * Get the forum this thread belongs to
+     */
+    public function forum(): BelongsTo
+    {
+        return $this->belongsTo(Forum::class);
+    }
+
+    /**
+     * Get the user who created this thread
+     */
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    /**
+     * Get the first post of this thread
+     */
+    public function firstPost(): BelongsTo
+    {
+        return $this->belongsTo(Post::class, 'first_post_id');
+    }
+
+    /**
+     * Get the latest post of this thread
+     */
+    public function latestPost(): BelongsTo
+    {
+        return $this->belongsTo(Post::class, 'latest_post_id');
+    }
+}
\ No newline at end of file
diff --git a/app/Modules/Forum/Http/Controllers/ForumController.php b/app/Modules/Forum/Http/Controllers/ForumController.php
new file mode 100644
index 0000000..99e05d7
--- /dev/null
+++ b/app/Modules/Forum/Http/Controllers/ForumController.php
@@ -0,0 +1,72 @@
+<?php
+
+namespace Modules\Forum\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+use Modules\Forum\Domain\Models\Forum;
+use Modules\Forum\Services\ForumService;
+
+class ForumController extends Controller
+{
+    protected ForumService $forumService;
+
+    protected array $views = [
+        'index'         => 'forums.index',
+        'forum'         => 'forums.forum',
+        'thread'        => 'forums.thread',
+        'create_thread' => 'forums.create_thread',
+        'create_post'   => 'forums.create_post',
+    ];
+
+    public function __construct(ForumService $forumService)
+    {
+        $this->forumService = $forumService;
+    }
+
+    public function index() : View
+    {
+        $categories = $this->forumService->getCategories();
+
+        return view($this->views['index'], compact('categories'));
+    }
+
+    public function forum(string $slug) : View
+    {
+        $forum = $this->forumService->getForumWithThreads($slug);
+
+        return view($this->views['forum'], compact('forum'));
+    }
+
+    public function thread(string $forumSlug, string $threadSlug, ?string $view = null) : View
+    {
+        $data = $this->forumService->getThreadWithPosts($forumSlug, $threadSlug);
+
+        return view($this->views['thread'], compact('thread'));
+    }
+
+    public function createThread(string $slug) : View
+    {
+        $forum = Forum::where('slug', $slug)->firstOrFail();
+
+        return view($this->views['create_thread'], compact('forum'));
+    }
+
+    public function storeThread(Request $request, string $slug)
+    {
+        $forum = Forum::where('slug', $slug)->firstOrFail();
+
+        $validated = $request->validate([
+            'title'   => 'required|min:3|max:255',
+            'content' => 'required|min:10',
+        ]);
+
+        $threadSlug = $this->forumService->createThread($forum, $validated);
+
+        return redirect()->route('forums.thread', [
+            'forumSlug'  => $forum->slug,
+            'threadSlug' => $threadSlug,
+        ])->with('success', 'Thread created successfully!');
+    }
+}
\ No newline at end of file
diff --git a/app/Modules/Forum/Http/routes.php b/app/Modules/Forum/Http/routes.php
new file mode 100644
index 0000000..fd607c4
--- /dev/null
+++ b/app/Modules/Forum/Http/routes.php
@@ -0,0 +1,9 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+
+Route::middleware('web')
+    ->prefix(strtolower('Forum'))
+    ->group(function () {
+        Route::get('/', [\Modules\Forum\Http\Controllers\ForumController::class, 'index']);
+    });
\ No newline at end of file
diff --git a/app/Modules/Forum/Providers/ForumServiceProvider.php b/app/Modules/Forum/Providers/ForumServiceProvider.php
new file mode 100644
index 0000000..a1d60f6
--- /dev/null
+++ b/app/Modules/Forum/Providers/ForumServiceProvider.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace Modules\Forum\Providers;
+
+use App\Providers\BaseModuleServiceProvider;
+
+class ForumServiceProvider extends BaseModuleServiceProvider
+{
+    protected string $moduleName = 'Forum';
+}
\ No newline at end of file
diff --git a/app/Modules/Forum/Services/ForumService.php b/app/Modules/Forum/Services/ForumService.php
new file mode 100644
index 0000000..614d901
--- /dev/null
+++ b/app/Modules/Forum/Services/ForumService.php
@@ -0,0 +1,162 @@
+<?php
+
+namespace Modules\Forum\Services;
+
+use App\Models\Forum;
+use App\Models\Thread;
+use App\Models\Post;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
+
+/**
+ * Service for managing forums, threads, and posts.
+ * 
+ * Provides methods to:
+ * - Retrieve categories and subforums.
+ * - Retrieve forums with their threads.
+ * - Retrieve threads with their posts.
+ * - Create threads and posts.
+ */
+class ForumService
+{
+    /**
+     * Get main categories with their subforums.
+     *
+     * @return \Illuminate\Database\Eloquent\Collection|Forum[]
+     */
+    public function getCategories()
+    {
+        return Forum::where('is_category', true)
+            ->orderBy('order')
+            ->with(['subforums' => function ($query) {
+                $query->orderBy('order');
+            }])
+            ->get();
+    }
+
+    /**
+     * Get a forum by slug with its threads.
+     *
+     * @param string $slug
+     * @return array{forum: Forum, threads: \Illuminate\Contracts\Pagination\LengthAwarePaginator}
+     */
+    public function getForumWithThreads(string $slug)
+    {
+        $forum = Forum::where('slug', $slug)
+            ->with(['subforums' => function ($query) {
+                $query->orderBy('order');
+            }])
+            ->firstOrFail();
+
+        $threads = Thread::where('forum_id', $forum->id)
+            ->orderBy('is_sticky', 'desc')
+            ->orderBy('created_at', 'desc')
+            ->with(['user', 'latestPost.user'])
+            ->paginate(20);
+
+        return compact('forum', 'threads');
+    }
+
+    /**
+     * Get a thread with its posts.
+     *
+     * @param string $forumSlug
+     * @param string $threadSlug
+     * @return array{forum: Forum, thread: Thread, posts: \Illuminate\Contracts\Pagination\LengthAwarePaginator}
+     */
+    public function getThreadWithPosts(string $forumSlug, string $threadSlug)
+    {
+        $forum = Forum::where('slug', $forumSlug)->firstOrFail();
+        $thread = Thread::where('slug', $threadSlug)
+            ->where('forum_id', $forum->id)
+            ->firstOrFail();
+
+        $thread->increment('view_count');
+
+        $posts = Post::where('thread_id', $thread->id)
+            ->orderBy('created_at')
+            ->with('user')
+            ->paginate(15);
+
+        return compact('forum', 'thread', 'posts');
+    }
+
+    /**
+     * Create a new thread with its first post.
+     *
+     * @param Forum $forum
+     * @param array $validated Validated thread data ['title' => string, 'content' => string]
+     * @return string The unique slug of the created thread
+     * @throws \Throwable
+     */
+    public function createThread(Forum $forum, array $validated)
+    {
+        $threadSlug = Str::slug($validated['title']);
+
+        // Make slug unique if it already exists
+        $count = Thread::where('slug', $threadSlug)->count();
+        if ($count > 0) {
+            $threadSlug .= '-' . time();
+        }
+
+        DB::transaction(function () use ($forum, $validated, $threadSlug) {
+            $thread = Thread::create([
+                'title'    => $validated['title'],
+                'slug'     => $threadSlug,
+                'forum_id' => $forum->id,
+                'user_id'  => Auth::id(),
+            ]);
+
+            $post = Post::create([
+                'thread_id'     => $thread->id,
+                'user_id'       => Auth::id(),
+                'content'       => $validated['content'],
+                'is_first_post' => true,
+            ]);
+
+            $thread->update([
+                'first_post_id'  => $post->id,
+                'latest_post_id' => $post->id,
+            ]);
+
+            $forum->update([
+                'latest_thread_id' => $thread->id,
+            ]);
+        });
+
+        return $threadSlug;
+    }
+
+    /**
+     * Create a new post in a thread.
+     *
+     * @param Thread $thread
+     * @param array $validated Validated post data ['content' => string]
+     * @return void
+     * @throws \Exception If the thread is locked
+     * @throws \Throwable
+     */
+    public function createPost(Thread $thread, array $validated)
+    {
+        if ($thread->is_locked) {
+            throw new \Exception('Thread is locked.');
+        }
+
+        DB::transaction(function () use ($thread, $validated) {
+            $post = Post::create([
+                'thread_id' => $thread->id,
+                'user_id'   => Auth::id(),
+                'content'   => $validated['content'],
+            ]);
+
+            $thread->update([
+                'latest_post_id' => $post->id,
+            ]);
+
+            $thread->forum->update([
+                'latest_thread_id' => $thread->id,
+            ]);
+        });
+    }
+}
diff --git a/app/Modules/Forum/module.json b/app/Modules/Forum/module.json
new file mode 100644
index 0000000..173734b
--- /dev/null
+++ b/app/Modules/Forum/module.json
@@ -0,0 +1,8 @@
+{
+    "name": "Forum",
+    "enabled": true,
+    "routes": true,
+    "migrations": true,
+    "views": true,
+    "namespace": "Modules\\Forum"
+}
\ No newline at end of file

From c57a1741699687d09215941bb545693fd06a0f07 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 4 Jan 2026 01:16:47 +0100
Subject: [PATCH 022/132] feat(armory): add realm validation in character
 search

Add getRealmById method to validate realm existence before character search
---
 .../Domain/Interfaces/ArmoryRepositoryInterface.php      | 1 +
 app/Modules/Armory/Http/Controllers/ArmoryController.php | 9 +++++++++
 app/Modules/Armory/Services/ArmoryService.php            | 7 +++++++
 3 files changed, 17 insertions(+)

diff --git a/app/Modules/Armory/Domain/Interfaces/ArmoryRepositoryInterface.php b/app/Modules/Armory/Domain/Interfaces/ArmoryRepositoryInterface.php
index 671d54a..13bf2cf 100644
--- a/app/Modules/Armory/Domain/Interfaces/ArmoryRepositoryInterface.php
+++ b/app/Modules/Armory/Domain/Interfaces/ArmoryRepositoryInterface.php
@@ -13,4 +13,5 @@ public function getGuildRankMember(int $guildId, int $memberGuid);
     public function getAchievementsCharacter(int $guid);
     public function getSkillCharacter(int $guid);
     public function getArenaTeam(int $guid);
+    public function getRealmById(int $id);
 }
\ No newline at end of file
diff --git a/app/Modules/Armory/Http/Controllers/ArmoryController.php b/app/Modules/Armory/Http/Controllers/ArmoryController.php
index db0c026..7a3f50e 100644
--- a/app/Modules/Armory/Http/Controllers/ArmoryController.php
+++ b/app/Modules/Armory/Http/Controllers/ArmoryController.php
@@ -79,6 +79,15 @@ public function index(Request $request)
         $class = $request->input('class') ?: null;
         $minLevel = $request->input('min_level') ?: null;
 
+        // Validate if realm is on db
+        $realm = $this->armoryRepo->getRealmById($realm);
+
+        if (empty($realm)) {
+            return view($this->views['index'], [
+                'error' => 'Realm not found',
+            ]);
+        }
+
         $request->merge(['realm' => $realm]);
 
         $characters = ($q || $faction || $class || $minLevel)
diff --git a/app/Modules/Armory/Services/ArmoryService.php b/app/Modules/Armory/Services/ArmoryService.php
index 1081d4b..be5a17c 100644
--- a/app/Modules/Armory/Services/ArmoryService.php
+++ b/app/Modules/Armory/Services/ArmoryService.php
@@ -75,4 +75,11 @@ public function searchCharacters(
     ): Collection {
         return $this->armoryRepo->search($q, $faction, $class, $minLevel);
     }
+
+    public function getRealmById(int $id): array
+    {
+        $realm = $this->armoryRepo->getRealmById($id);
+
+        return $realm ? $realm->toArray() : [];
+    }
 }
\ No newline at end of file

From 7578e69927517a52b603f7a1920c8b8389b6dd1c Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 4 Jan 2026 01:22:39 +0100
Subject: [PATCH 023/132] chore: remove obsolete nixpacks configuration file

---
 nixpacks.toml | 7 -------
 1 file changed, 7 deletions(-)
 delete mode 100644 nixpacks.toml

diff --git a/nixpacks.toml b/nixpacks.toml
deleted file mode 100644
index f779ae9..0000000
--- a/nixpacks.toml
+++ /dev/null
@@ -1,7 +0,0 @@
-[phases.postbuild]
-cmds = [
-    "php /app/artisan optimize:clear",
-    "php /app/artisan migrate --force",
-]
-
-dependsOn = ["build"]
\ No newline at end of file

From 76c8380c49c231715259e678cf4d736c6875ba29 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 4 Jan 2026 01:30:28 +0100
Subject: [PATCH 024/132] refactor(armory): remove realm validation and related
 methods

The realm validation was moved to the service provider where it's more appropriate. Removed unused getRealmById method and related interface method to clean up the codebase.
---
 .../Domain/Interfaces/ArmoryRepositoryInterface.php      | 1 -
 app/Modules/Armory/Http/Controllers/ArmoryController.php | 9 ---------
 app/Modules/Armory/Providers/ArmoryServiceProvider.php   | 3 ++-
 app/Modules/Armory/Services/ArmoryService.php            | 7 -------
 4 files changed, 2 insertions(+), 18 deletions(-)

diff --git a/app/Modules/Armory/Domain/Interfaces/ArmoryRepositoryInterface.php b/app/Modules/Armory/Domain/Interfaces/ArmoryRepositoryInterface.php
index 13bf2cf..671d54a 100644
--- a/app/Modules/Armory/Domain/Interfaces/ArmoryRepositoryInterface.php
+++ b/app/Modules/Armory/Domain/Interfaces/ArmoryRepositoryInterface.php
@@ -13,5 +13,4 @@ public function getGuildRankMember(int $guildId, int $memberGuid);
     public function getAchievementsCharacter(int $guid);
     public function getSkillCharacter(int $guid);
     public function getArenaTeam(int $guid);
-    public function getRealmById(int $id);
 }
\ No newline at end of file
diff --git a/app/Modules/Armory/Http/Controllers/ArmoryController.php b/app/Modules/Armory/Http/Controllers/ArmoryController.php
index 7a3f50e..db0c026 100644
--- a/app/Modules/Armory/Http/Controllers/ArmoryController.php
+++ b/app/Modules/Armory/Http/Controllers/ArmoryController.php
@@ -79,15 +79,6 @@ public function index(Request $request)
         $class = $request->input('class') ?: null;
         $minLevel = $request->input('min_level') ?: null;
 
-        // Validate if realm is on db
-        $realm = $this->armoryRepo->getRealmById($realm);
-
-        if (empty($realm)) {
-            return view($this->views['index'], [
-                'error' => 'Realm not found',
-            ]);
-        }
-
         $request->merge(['realm' => $realm]);
 
         $characters = ($q || $faction || $class || $minLevel)
diff --git a/app/Modules/Armory/Providers/ArmoryServiceProvider.php b/app/Modules/Armory/Providers/ArmoryServiceProvider.php
index 5099ea6..61e57f5 100644
--- a/app/Modules/Armory/Providers/ArmoryServiceProvider.php
+++ b/app/Modules/Armory/Providers/ArmoryServiceProvider.php
@@ -20,8 +20,9 @@ public function register(): void
             $realmId = $request->get('realm', 1);
 
             $realm = Realm::find($realmId);
+            
             if (!$realm) {
-                throw new \Exception("Realm $realmId not found.");
+                return [];
             }
 
             $emulator = $realm->emulator;
diff --git a/app/Modules/Armory/Services/ArmoryService.php b/app/Modules/Armory/Services/ArmoryService.php
index be5a17c..1081d4b 100644
--- a/app/Modules/Armory/Services/ArmoryService.php
+++ b/app/Modules/Armory/Services/ArmoryService.php
@@ -75,11 +75,4 @@ public function searchCharacters(
     ): Collection {
         return $this->armoryRepo->search($q, $faction, $class, $minLevel);
     }
-
-    public function getRealmById(int $id): array
-    {
-        $realm = $this->armoryRepo->getRealmById($id);
-
-        return $realm ? $realm->toArray() : [];
-    }
 }
\ No newline at end of file

From bcba5277558c0f84568168291e6275dfce85c069 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 4 Jan 2026 01:54:14 +0100
Subject: [PATCH 025/132] fix(ArmoryServiceProvider): throw exception when
 realm not found

---
 app/Modules/Armory/Providers/ArmoryServiceProvider.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/app/Modules/Armory/Providers/ArmoryServiceProvider.php b/app/Modules/Armory/Providers/ArmoryServiceProvider.php
index 61e57f5..2b9b547 100644
--- a/app/Modules/Armory/Providers/ArmoryServiceProvider.php
+++ b/app/Modules/Armory/Providers/ArmoryServiceProvider.php
@@ -20,9 +20,9 @@ public function register(): void
             $realmId = $request->get('realm', 1);
 
             $realm = Realm::find($realmId);
-            
+
             if (!$realm) {
-                return [];
+                throw new \Exception("Realm $realmId not found.");
             }
 
             $emulator = $realm->emulator;

From 803d16964e6b6ff36bb367211a862050798b283b Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 4 Jan 2026 23:31:36 +0100
Subject: [PATCH 026/132] feat(donate): add donate module with routes and views

Implement a new donate module including:
- Module configuration
- Service provider
- Controller with index route
- Donation page view with packages
---
 .../Http/Controllers/DonateController.php     |  13 ++
 app/Modules/Donate/Http/routes.php            |   9 +
 .../Providers/DonateServiceProvider.php       |  10 +
 .../Donate/Resources/views/home.blade.php     | 210 ++++++++++++++++++
 app/Modules/Donate/module.json                |   8 +
 resources/views/layouts/main.blade.php        |   4 +-
 6 files changed, 252 insertions(+), 2 deletions(-)
 create mode 100644 app/Modules/Donate/Http/Controllers/DonateController.php
 create mode 100644 app/Modules/Donate/Http/routes.php
 create mode 100644 app/Modules/Donate/Providers/DonateServiceProvider.php
 create mode 100644 app/Modules/Donate/Resources/views/home.blade.php
 create mode 100644 app/Modules/Donate/module.json

diff --git a/app/Modules/Donate/Http/Controllers/DonateController.php b/app/Modules/Donate/Http/Controllers/DonateController.php
new file mode 100644
index 0000000..6c1066d
--- /dev/null
+++ b/app/Modules/Donate/Http/Controllers/DonateController.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace Modules\Donate\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+
+class DonateController extends Controller
+{
+    public function index()
+    {
+        return view('donate::home');
+    }
+}   
\ No newline at end of file
diff --git a/app/Modules/Donate/Http/routes.php b/app/Modules/Donate/Http/routes.php
new file mode 100644
index 0000000..768fa1b
--- /dev/null
+++ b/app/Modules/Donate/Http/routes.php
@@ -0,0 +1,9 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+
+Route::middleware('web')
+    ->prefix(strtolower('Donate'))
+    ->group(function () {
+        Route::get('/', [\Modules\Donate\Http\Controllers\DonateController::class, 'index'])->name('donate');
+    });
\ No newline at end of file
diff --git a/app/Modules/Donate/Providers/DonateServiceProvider.php b/app/Modules/Donate/Providers/DonateServiceProvider.php
new file mode 100644
index 0000000..fe2efd4
--- /dev/null
+++ b/app/Modules/Donate/Providers/DonateServiceProvider.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace Modules\Donate\Providers;
+
+use App\Providers\BaseModuleServiceProvider;
+
+class DonateServiceProvider extends BaseModuleServiceProvider
+{
+    protected string $moduleName = 'Donate';
+}
\ No newline at end of file
diff --git a/app/Modules/Donate/Resources/views/home.blade.php b/app/Modules/Donate/Resources/views/home.blade.php
new file mode 100644
index 0000000..95047e5
--- /dev/null
+++ b/app/Modules/Donate/Resources/views/home.blade.php
@@ -0,0 +1,210 @@
+@extends('layouts.main')
+
+@section('title', 'Donate')
+
+@section('content')
+    <!-- Hero Section -->
+    <div class="relative pt-32 pb-20 px-4 sm:px-6 lg:px-8">
+        <div class="max-w-7xl mx-auto text-center">
+            <h1 class="text-5xl md:text-6xl font-bold mb-6">
+                Support <span class="text-blue-500">NexusCMS</span>
+            </h1>
+            <p class="text-xl text-slate-400 max-w-3xl mx-auto">
+                Your donations help us maintain high-quality servers, develop custom content, and keep the community thriving. Every contribution makes a difference.
+            </p>
+        </div>
+    </div>
+
+    <!-- Donation Packages -->
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 pb-20">
+        <div class="text-center mb-12">
+            <h2 class="text-3xl md:text-4xl font-bold mb-4">Donation Packages</h2>
+            <p class="text-slate-400">Choose a package that suits you best</p>
+        </div>
+
+        <div class="grid md:grid-cols-3 gap-8 mb-16">
+            <!-- Bronze Package -->
+            <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-8 hover:border-orange-600/50 transition-all duration-300">
+                <div class="text-center mb-6">
+                    <div class="w-16 h-16 bg-gradient-to-br from-orange-600 to-orange-800 rounded-full flex items-center justify-center mx-auto mb-4">
+                        <i class="fas fa-medal text-2xl"></i>
+                    </div>
+                    <h3 class="text-2xl font-bold mb-2">Bronze Supporter</h3>
+                    <div class="text-4xl font-bold text-orange-500 mb-2">$5</div>
+                    <p class="text-slate-400 text-sm">One-time donation</p>
+                </div>
+                <ul class="space-y-3 mb-8">
+                    <li class="flex items-start gap-2">
+                        <i class="fas fa-check text-orange-500 mt-1"></i>
+                        <span class="text-slate-300">500 Donation Points</span>
+                    </li>
+                </ul>
+                <button class="w-full py-3 bg-gradient-to-r from-orange-600 to-orange-700 hover:from-orange-700 hover:to-orange-800 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-orange-900/30">
+                    Donate Now
+                </button>
+            </div>
+
+            <!-- Silver Package -->
+            <div class="bg-slate-900/50 border-2 border-slate-400 rounded-xl p-8 hover:border-slate-300 transition-all duration-300 relative transform md:scale-105">
+                <div class="absolute -top-4 left-1/2 transform -translate-x-1/2">
+                    <span class="bg-gradient-to-r from-blue-600 to-blue-700 px-4 py-1 rounded-full text-sm font-semibold">MOST POPULAR</span>
+                </div>
+                <div class="text-center mb-6">
+                    <div class="w-16 h-16 bg-gradient-to-br from-slate-400 to-slate-600 rounded-full flex items-center justify-center mx-auto mb-4">
+                        <i class="fas fa-crown text-2xl"></i>
+                    </div>
+                    <h3 class="text-2xl font-bold mb-2">Silver Supporter</h3>
+                    <div class="text-4xl font-bold text-slate-400 mb-2">$15</div>
+                    <p class="text-slate-400 text-sm">One-time donation</p>
+                </div>
+                <ul class="space-y-3 mb-8">
+                    <li class="flex items-start gap-2">
+                        <i class="fas fa-check text-slate-400 mt-1"></i>
+                        <span class="text-slate-300">1,800 Donation Points</span>
+                    </li>
+                </ul>
+                <button class="w-full py-3 bg-gradient-to-r from-slate-400 to-slate-600 hover:from-slate-500 hover:to-slate-700 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-slate-900/50">
+                    Donate Now
+                </button>
+            </div>
+
+            <!-- Gold Package -->
+            <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-8 hover:border-yellow-600/50 transition-all duration-300">
+                <div class="text-center mb-6">
+                    <div class="w-16 h-16 bg-gradient-to-br from-yellow-500 to-yellow-700 rounded-full flex items-center justify-center mx-auto mb-4">
+                        <i class="fas fa-gem text-2xl"></i>
+                    </div>
+                    <h3 class="text-2xl font-bold mb-2">Gold Supporter</h3>
+                    <div class="text-4xl font-bold text-yellow-500 mb-2">$30</div>
+                    <p class="text-slate-400 text-sm">One-time donation</p>
+                </div>
+                <ul class="space-y-3 mb-8">
+                    <li class="flex items-start gap-2">
+                        <i class="fas fa-check text-yellow-500 mt-1"></i>
+                        <span class="text-slate-300">4,000 Donation Points</span>
+                    </li>
+                </ul>
+                <button class="w-full py-3 bg-gradient-to-r from-yellow-600 to-yellow-700 hover:from-yellow-700 hover:to-yellow-800 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-yellow-900/30">
+                    Donate Now
+                </button>
+            </div>
+        </div>
+
+        <!-- Custom Amount Section -->
+        <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-8 mb-16">
+            <div class="max-w-2xl mx-auto text-center">
+                <h3 class="text-2xl font-bold mb-4">Custom Donation Amount</h3>
+                <p class="text-slate-400 mb-6">Choose your own amount to support the server</p>
+                <div class="flex flex-col sm:flex-row gap-4 items-center justify-center">
+                    <div class="relative flex-1 w-full sm:max-w-xs">
+                        <span class="absolute left-4 top-1/2 transform -translate-y-1/2 text-slate-400 text-xl">$</span>
+                        <input type="number" placeholder="Enter amount" min="1" class="w-full pl-10 pr-4 py-3 bg-slate-800 border border-slate-700 rounded-lg focus:outline-none focus:border-blue-500 text-white">
+                    </div>
+                    <button class="px-8 py-3 bg-blue-600 hover:bg-blue-700 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-blue-900/30 w-full sm:w-auto">
+                        Donate
+                    </button>
+                </div>
+                <p class="text-slate-500 text-sm mt-4">Conversion rate: $1 = 100 Donation Points</p>
+            </div>
+        </div>
+
+        <!-- Donation Points Store Preview -->
+        <div class="mb-16">
+            <div class="text-center mb-12">
+                <h2 class="text-3xl md:text-4xl font-bold mb-4">What Can You Buy?</h2>
+                <p class="text-slate-400">Spend your donation points on exclusive items and services</p>
+            </div>
+
+            <div class="grid md:grid-cols-4 gap-6">
+                <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-6 hover:border-blue-500/50 transition-all duration-300">
+                    <h4 class="font-bold mb-2">Epic Mount</h4>
+                    <p class="text-slate-400 text-sm mb-4">Exclusive flying mount</p>
+                    <div class="flex items-center justify-between">
+                        <span class="text-blue-500 font-semibold">1,500 DP</span>
+                        <button class="text-sm text-slate-400 hover:text-white">View</button>
+                    </div>
+                </div>
+
+                <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-6 hover:border-blue-500/50 transition-all duration-300">
+                    <h4 class="font-bold mb-2">Transmog Set</h4>
+                    <p class="text-slate-400 text-sm mb-4">Legendary appearance</p>
+                    <div class="flex items-center justify-between">
+                        <span class="text-blue-500 font-semibold">2,000 DP</span>
+                        <button class="text-sm text-slate-400 hover:text-white">View</button>
+                    </div>
+                </div>
+
+                <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-6 hover:border-blue-500/50 transition-all duration-300">
+                    <h4 class="font-bold mb-2">Name Change</h4>
+                    <p class="text-slate-400 text-sm mb-4">Change character name</p>
+                    <div class="flex items-center justify-between">
+                        <span class="text-blue-500 font-semibold">500 DP</span>
+                        <button class="text-sm text-slate-400 hover:text-white">View</button>
+                    </div>
+                </div>
+
+                <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-6 hover:border-blue-500/50 transition-all duration-300">
+                    <h4 class="font-bold mb-2">Level Boost</h4>
+                    <p class="text-slate-400 text-sm mb-4">Instant level 70</p>
+                    <div class="flex items-center justify-between">
+                        <span class="text-blue-500 font-semibold">3,000 DP</span>
+                        <button class="text-sm text-slate-400 hover:text-white">View</button>
+                    </div>
+                </div>
+            </div>
+
+            <div class="text-center mt-8">
+                <a href="#" class="inline-flex items-center gap-2 px-6 py-3 bg-slate-800 hover:bg-slate-700 rounded-lg font-semibold transition-all duration-200">
+                    View Full Store
+                    <i class="fas fa-arrow-right"></i>
+                </a>
+            </div>
+        </div>
+
+        <!-- FAQ Section -->
+        <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-8">
+            <h2 class="text-3xl font-bold mb-8 text-center">Donation FAQ</h2>
+            <div class="space-y-4 max-w-3xl mx-auto">
+                <div class="bg-slate-800/50 rounded-lg p-6">
+                    <h4 class="font-bold mb-2 flex items-center gap-2">
+                        <i class="fas fa-question-circle text-blue-500"></i>
+                        How do I receive my donation points?
+                    </h4>
+                    <p class="text-slate-400 text-sm">Donation points are automatically added to your account within 5 minutes after a successful payment.</p>
+                </div>
+                <div class="bg-slate-800/50 rounded-lg p-6">
+                    <h4 class="font-bold mb-2 flex items-center gap-2">
+                        <i class="fas fa-question-circle text-blue-500"></i>
+                        What payment methods do you accept?
+                    </h4>
+                    <p class="text-slate-400 text-sm">We accept PayPal, credit cards, and various cryptocurrency options for your convenience.</p>
+                </div>
+                <div class="bg-slate-800/50 rounded-lg p-6">
+                    <h4 class="font-bold mb-2 flex items-center gap-2">
+                        <i class="fas fa-question-circle text-blue-500"></i>
+                        Can I get a refund?
+                    </h4>
+                    <p class="text-slate-400 text-sm">Donations are generally non-refundable. However, if you encounter technical issues, please contact our support team.</p>
+                </div>
+                <div class="bg-slate-800/50 rounded-lg p-6">
+                    <h4 class="font-bold mb-2 flex items-center gap-2">
+                        <i class="fas fa-question-circle text-blue-500"></i>
+                        Are donations required to play?
+                    </h4>
+                    <p class="text-slate-400 text-sm">Absolutely not! NexusCMS is completely free to play. Donations help us improve the server but are entirely optional.</p>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- Thank You Section -->
+    <div class="bg-gradient-to-r from-blue-900/20 to-purple-900/20 border-y border-slate-800 py-16">
+        <div class="max-w-4xl mx-auto px-4 sm:px-6 lg:px-8 text-center">
+            <i class="fas fa-heart text-5xl text-red-500 mb-6"></i>
+            <h2 class="text-3xl md:text-4xl font-bold mb-4">Thank You for Your Support!</h2>
+            <p class="text-slate-300 text-lg">
+                Every donation, no matter the size, helps us maintain our servers, develop new content, and create the best possible experience for our community. We couldn't do this without supporters like you.
+            </p>
+        </div>
+    </div>
+@endsection
\ No newline at end of file
diff --git a/app/Modules/Donate/module.json b/app/Modules/Donate/module.json
new file mode 100644
index 0000000..9604e23
--- /dev/null
+++ b/app/Modules/Donate/module.json
@@ -0,0 +1,8 @@
+{
+    "name": "Donate",
+    "enabled": true,
+    "routes": true,
+    "migrations": true,
+    "views": true,
+    "namespace": "Modules\\Donate"
+}
\ No newline at end of file
diff --git a/resources/views/layouts/main.blade.php b/resources/views/layouts/main.blade.php
index 036354d..4edbd99 100644
--- a/resources/views/layouts/main.blade.php
+++ b/resources/views/layouts/main.blade.php
@@ -28,7 +28,7 @@
                         <a href="{{ route('howtoplay') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">HOW TO PLAY</a>
                         <!-- <a href="{{ route('forums') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">FORUMS</a> -->
                         <a href="{{ route('armory') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">ARMORY</a>
-                        <a href="#" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">DONATE</a>
+                        <a href="{{ route('donate') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">DONATE</a>
                     </div>
                 </div>
                 <div class="flex items-center gap-3">
@@ -60,7 +60,7 @@
                     <a href="{{ route('news') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">NEWS</a>
                     <a href="{{ route('howtoplay') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">HOW TO PLAY</a>
                     <a href="{{ route('armory') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">ARMORY</a>
-                    <a href="#" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">DONATE</a>
+                    <a href="{{ route('donate') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">DONATE</a>
                     @auth
                         <div class="flex flex-col gap-2 pt-2">
                             <a href="{{ route('ucp.dashboard') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">

From 08b7d7479a1d916e6c45bc840e2f24eb0fa716a6 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 7 Jan 2026 20:50:05 +0100
Subject: [PATCH 027/132] feat(donate): implement braintree payment gateway
 integration

- Add Braintree PHP SDK dependency
- Create Braintree gateway implementation
- Add donation transaction model and migration
- Extend user model with dp/vp fields
- Implement checkout flow with Braintree
- Add donation routes and controller logic
- Update donate view with payment form
---
 .env.example                                  |  6 ++
 app/Models/User.php                           |  4 +
 .../Interfaces/PaymentGatewayInterface.php    | 15 ++++
 .../Domain/Models/DonationTransaction.php     | 28 +++++++
 .../Http/Controllers/DonateController.php     | 72 +++++++++++++++++-
 app/Modules/Donate/Http/routes.php            |  8 +-
 .../Gateways/BraintreeGateway.php             | 75 +++++++++++++++++++
 .../Providers/DonateServiceProvider.php       | 25 ++++++-
 .../Resources/views/braintree.blade.php       | 44 +++++++++++
 .../Donate/Resources/views/home.blade.php     | 43 ++++++++---
 .../Donate/Services/GatewayManager.php        | 34 +++++++++
 composer.json                                 |  3 +-
 composer.lock                                 | 51 ++++++++++++-
 config/donate.php                             | 16 ++++
 ..._01_07_000001_add_dp_vp_to_users_table.php | 24 ++++++
 ...002_create_donation_transactions_table.php | 31 ++++++++
 16 files changed, 462 insertions(+), 17 deletions(-)
 create mode 100644 app/Modules/Donate/Domain/Interfaces/PaymentGatewayInterface.php
 create mode 100644 app/Modules/Donate/Domain/Models/DonationTransaction.php
 create mode 100644 app/Modules/Donate/Infrastructure/Gateways/BraintreeGateway.php
 create mode 100644 app/Modules/Donate/Resources/views/braintree.blade.php
 create mode 100644 app/Modules/Donate/Services/GatewayManager.php
 create mode 100644 config/donate.php
 create mode 100644 database/migrations/2026_01_07_000001_add_dp_vp_to_users_table.php
 create mode 100644 database/migrations/2026_01_07_000002_create_donation_transactions_table.php

diff --git a/.env.example b/.env.example
index ce7a7da..400324a 100644
--- a/.env.example
+++ b/.env.example
@@ -59,4 +59,10 @@ AWS_DEFAULT_REGION=us-east-1
 AWS_BUCKET=
 AWS_USE_PATH_STYLE_ENDPOINT=false
 
+## Donate Gateways
+BRAINTREE_ENVIRONMENT=sandbox
+BRAINTREE_MERCHANT_ID=
+BRAINTREE_PUBLIC_KEY=
+BRAINTREE_PRIVATE_KEY=
+
 VITE_APP_NAME="${APP_NAME}"
diff --git a/app/Models/User.php b/app/Models/User.php
index 2ae77e3..3cb83bc 100755
--- a/app/Models/User.php
+++ b/app/Models/User.php
@@ -17,6 +17,8 @@ class User extends Authenticatable
         'email',
         'password',
         'created_at',
+        'dp',
+        'vp',
     ];
 
     protected $hidden = [
@@ -27,6 +29,8 @@ class User extends Authenticatable
     protected $casts = [
         'email_verified_at' => 'datetime',
         'password' => 'hashed',
+        'dp' => 'integer',
+        'vp' => 'integer',
     ];
     
     /**
diff --git a/app/Modules/Donate/Domain/Interfaces/PaymentGatewayInterface.php b/app/Modules/Donate/Domain/Interfaces/PaymentGatewayInterface.php
new file mode 100644
index 0000000..87f5b90
--- /dev/null
+++ b/app/Modules/Donate/Domain/Interfaces/PaymentGatewayInterface.php
@@ -0,0 +1,15 @@
+<?php
+
+namespace Modules\Donate\Domain\Interfaces;
+
+use Illuminate\Http\Request;
+
+interface PaymentGatewayInterface
+{
+    public function id(): string;
+    public function displayName(): string;
+    public function createCheckout(int $amount, array $meta = []): array;
+    public function handleCallback(Request $request): array;
+    public function handleWebhook(Request $request): array;
+}
+
diff --git a/app/Modules/Donate/Domain/Models/DonationTransaction.php b/app/Modules/Donate/Domain/Models/DonationTransaction.php
new file mode 100644
index 0000000..1d62760
--- /dev/null
+++ b/app/Modules/Donate/Domain/Models/DonationTransaction.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace Modules\Donate\Domain\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class DonationTransaction extends Model
+{
+    protected $table = 'donation_transactions';
+
+    protected $fillable = [
+        'user_id',
+        'gateway',
+        'transaction_id',
+        'amount',
+        'currency',
+        'dp_awarded',
+        'status',
+        'meta',
+    ];
+
+    protected $casts = [
+        'amount' => 'integer',
+        'dp_awarded' => 'integer',
+        'meta' => 'array',
+    ];
+}
+
diff --git a/app/Modules/Donate/Http/Controllers/DonateController.php b/app/Modules/Donate/Http/Controllers/DonateController.php
index 6c1066d..dcdf9d7 100644
--- a/app/Modules/Donate/Http/Controllers/DonateController.php
+++ b/app/Modules/Donate/Http/Controllers/DonateController.php
@@ -3,11 +3,77 @@
 namespace Modules\Donate\Http\Controllers;
 
 use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Modules\Donate\Services\GatewayManager;
+use Modules\Donate\Domain\Models\DonationTransaction;
+use Illuminate\Support\Facades\DB;
 
 class DonateController extends Controller
 {
-    public function index()
+    public function index(GatewayManager $gateways)
     {
-        return view('donate::home');
+        $available = array_map(fn($g) => ['id' => $g->id(), 'name' => $g->displayName()], $gateways->all());
+        return view('donate::home', ['gateways' => $available]);
     }
-}   
\ No newline at end of file
+
+    public function checkout(Request $request, GatewayManager $gateways)
+    {
+        $gatewayId = $request->string('gateway')->toString();
+        $amount = (int) $request->input('amount', 0);
+        $gateway = $gateways->get($gatewayId);
+        abort_unless($gateway, 404);
+        $meta = ['user_id' => optional($request->user())->id];
+        
+        if ($request->filled('nonce')) {
+            $meta['nonce'] = $request->input('nonce');
+        }
+        $result = $gateway->createCheckout($amount, $meta);
+        if (isset($result['client_token'])) {
+            return view('donate::braintree', ['token' => $result['client_token'], 'amount' => $amount]);
+        }
+        if (isset($result['redirect_url'])) {
+            return redirect()->away($result['redirect_url']);
+        }
+        if (($result['status'] ?? null) === 'success') {
+            $user = $request->user();
+            $rate = (int) config('donate.dp_rate', 100);
+            $dp = (int) ($amount * $rate);
+            DB::transaction(function () use ($user, $gatewayId, $amount, $dp, $result) {
+                $tx = DonationTransaction::create([
+                    'user_id' => $user->id,
+                    'gateway' => $gatewayId,
+                    'transaction_id' => $result['transaction_id'] ?? null,
+                    'amount' => $amount,
+                    'currency' => 'USD',
+                    'dp_awarded' => $dp,
+                    'status' => 'completed',
+                    'meta' => ['raw' => $result],
+                ]);
+                $user->increment('dp', $dp);
+            });
+            return response()->json([
+                'status' => 'success',
+                'dp_awarded' => $dp,
+                'amount' => $amount,
+                'gateway' => $gatewayId,
+            ]);
+        }
+        return response()->json($result, 400);
+    }
+
+    public function callback(string $gateway, Request $request, GatewayManager $gateways)
+    {
+        $gw = $gateways->get($gateway);
+        abort_unless($gw, 404);
+        $result = $gw->handleCallback($request);
+        return response()->json($result);
+    }
+
+    public function webhook(string $gateway, Request $request, GatewayManager $gateways)
+    {
+        $gw = $gateways->get($gateway);
+        abort_unless($gw, 404);
+        $result = $gw->handleWebhook($request);
+        return response()->json($result);
+    }
+}
diff --git a/app/Modules/Donate/Http/routes.php b/app/Modules/Donate/Http/routes.php
index 768fa1b..9b94c76 100644
--- a/app/Modules/Donate/Http/routes.php
+++ b/app/Modules/Donate/Http/routes.php
@@ -1,9 +1,13 @@
 <?php
 
 use Illuminate\Support\Facades\Route;
+use Modules\Donate\Http\Controllers\DonateController;
 
 Route::middleware('web')
     ->prefix(strtolower('Donate'))
     ->group(function () {
-        Route::get('/', [\Modules\Donate\Http\Controllers\DonateController::class, 'index'])->name('donate');
-    });
\ No newline at end of file
+        Route::get('/', [DonateController::class, 'index'])->name('donate');
+        Route::post('/checkout', [DonateController::class, 'checkout'])->middleware('auth')->name('donate.checkout');
+        Route::match(['get', 'post'], '/callback/{gateway}', [DonateController::class, 'callback'])->name('donate.callback');
+        Route::post('/webhook/{gateway}', [DonateController::class, 'webhook'])->name('donate.webhook');
+    });
diff --git a/app/Modules/Donate/Infrastructure/Gateways/BraintreeGateway.php b/app/Modules/Donate/Infrastructure/Gateways/BraintreeGateway.php
new file mode 100644
index 0000000..bb53f56
--- /dev/null
+++ b/app/Modules/Donate/Infrastructure/Gateways/BraintreeGateway.php
@@ -0,0 +1,75 @@
+<?php
+
+namespace Modules\Donate\Infrastructure\Gateways;
+
+use Modules\Donate\Domain\Interfaces\PaymentGatewayInterface;
+use Illuminate\Http\Request;
+use Braintree\Gateway;
+
+class BraintreeGateway implements PaymentGatewayInterface
+{
+    protected Gateway $gateway;
+
+    public function __construct()
+    {
+        $cfg = config('donate.gateways.braintree', []);
+        $this->gateway = new Gateway([
+            'environment' => $cfg['environment'] ?? 'sandbox',
+            'merchantId'  => $cfg['merchant_id'] ?? '',
+            'publicKey'   => $cfg['public_key'] ?? '',
+            'privateKey'  => $cfg['private_key'] ?? '',
+        ]);
+    }
+
+    public function id(): string
+    {
+        return 'braintree';
+    }
+
+    public function displayName(): string
+    {
+        return 'Braintree';
+    }
+
+    public function createCheckout(int $amount, array $meta = []): array
+    {
+        if (isset($meta['nonce'])) {
+            $result = $this->gateway->transaction()->sale([
+                'amount' => number_format($amount, 2, '.', ''),
+                'paymentMethodNonce' => $meta['nonce'],
+                'options' => ['submitForSettlement' => true],
+            ]);
+            if ($result->success) {
+                return [
+                    'status' => 'success',
+                    'transaction_id' => $result->transaction->id,
+                    'amount' => $amount,
+                ];
+            }
+            $errors = [];
+            foreach ($result->errors->deepAll() as $error) {
+                $errors[] = "{$error->code}: {$error->message}";
+            }
+            return [
+                'status' => 'error',
+                'errors' => $errors,
+            ];
+        }
+
+        $token = $this->gateway->clientToken()->generate();
+        return [
+            'client_token' => $token,
+            'amount' => $amount,
+        ];
+    }
+
+    public function handleCallback(Request $request): array
+    {
+        return ['status' => 'success', 'gateway' => $this->id()];
+    }
+
+    public function handleWebhook(Request $request): array
+    {
+        return ['received' => true];
+    }
+}
diff --git a/app/Modules/Donate/Providers/DonateServiceProvider.php b/app/Modules/Donate/Providers/DonateServiceProvider.php
index fe2efd4..a8e8005 100644
--- a/app/Modules/Donate/Providers/DonateServiceProvider.php
+++ b/app/Modules/Donate/Providers/DonateServiceProvider.php
@@ -3,8 +3,31 @@
 namespace Modules\Donate\Providers;
 
 use App\Providers\BaseModuleServiceProvider;
+use Modules\Donate\Services\GatewayManager;
+use Modules\Donate\Infrastructure\Gateways\StripeGateway;
+use Modules\Donate\Infrastructure\Gateways\BraintreeGateway;
+use Modules\Donate\Infrastructure\Gateways\MercadoPagoGateway;
 
 class DonateServiceProvider extends BaseModuleServiceProvider
 {
     protected string $moduleName = 'Donate';
-}
\ No newline at end of file
+
+    public function register(): void
+    {
+        $this->mergeConfigFrom(base_path('config/donate.php'), 'donate');
+
+        $this->app->singleton(GatewayManager::class, function () {
+            $enabled = config('donate.enabled_gateways', []);
+            $map = [
+                'braintree' => new BraintreeGateway(),
+            ];
+            $gateways = [];
+            foreach ($enabled as $id) {
+                if (isset($map[$id])) {
+                    $gateways[] = $map[$id];
+                }
+            }
+            return new GatewayManager($gateways);
+        });
+    }
+}
diff --git a/app/Modules/Donate/Resources/views/braintree.blade.php b/app/Modules/Donate/Resources/views/braintree.blade.php
new file mode 100644
index 0000000..58ae155
--- /dev/null
+++ b/app/Modules/Donate/Resources/views/braintree.blade.php
@@ -0,0 +1,44 @@
+@extends('layouts.main')
+
+@section('title', 'Braintree Checkout')
+
+@section('content')
+<div class="max-w-2xl mx-auto pt-24 pb-16 px-4">
+    <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-8">
+        <h2 class="text-2xl font-bold mb-4">Complete your payment</h2>
+        <p class="text-slate-400 mb-6">Amount: ${{ number_format($amount ?? 0, 2) }}</p>
+        <form id="bt-form" method="POST" action="{{ route('donate.checkout') }}">
+            @csrf
+            <input type="hidden" name="gateway" value="braintree">
+            <input type="hidden" name="amount" value="{{ $amount }}">
+            <input type="hidden" name="nonce" id="nonce">
+            <div id="dropin-container" class="mb-6"></div>
+            <button id="submit-button" type="submit" class="px-6 py-3 bg-blue-600 hover:bg-blue-700 rounded-lg text-white font-semibold">
+                Pay
+            </button>
+        </form>
+    </div>
+</div>
+
+<script src="https://js.braintreegateway.com/web/dropin/1.39.0/js/dropin.min.js"></script>
+<script>
+document.addEventListener('DOMContentLoaded', function () {
+    var form = document.getElementById('bt-form');
+    var button = document.getElementById('submit-button');
+    braintree.dropin.create({
+        authorization: '{{ $token }}',
+        container: '#dropin-container'
+    }, function (createErr, instance) {
+        form.addEventListener('submit', function (event) {
+            event.preventDefault();
+            instance.requestPaymentMethod(function (err, payload) {
+                if (err) return;
+                document.getElementById('nonce').value = payload.nonce;
+                form.submit();
+            });
+        });
+    });
+});
+</script>
+@endsection
+
diff --git a/app/Modules/Donate/Resources/views/home.blade.php b/app/Modules/Donate/Resources/views/home.blade.php
index 95047e5..df6c1de 100644
--- a/app/Modules/Donate/Resources/views/home.blade.php
+++ b/app/Modules/Donate/Resources/views/home.blade.php
@@ -95,15 +95,40 @@
             <div class="max-w-2xl mx-auto text-center">
                 <h3 class="text-2xl font-bold mb-4">Custom Donation Amount</h3>
                 <p class="text-slate-400 mb-6">Choose your own amount to support the server</p>
-                <div class="flex flex-col sm:flex-row gap-4 items-center justify-center">
-                    <div class="relative flex-1 w-full sm:max-w-xs">
-                        <span class="absolute left-4 top-1/2 transform -translate-y-1/2 text-slate-400 text-xl">$</span>
-                        <input type="number" placeholder="Enter amount" min="1" class="w-full pl-10 pr-4 py-3 bg-slate-800 border border-slate-700 rounded-lg focus:outline-none focus:border-blue-500 text-white">
+                @auth
+                    <form method="POST" action="{{ route('donate.checkout') }}" class="flex flex-col sm:flex-row gap-4 items-center justify-center">
+                        @csrf
+                        <div class="relative flex-1 w-full sm:max-w-xs">
+                            <span class="absolute left-4 top-1/2 transform -translate-y-1/2 text-slate-400 text-xl">$</span>
+                            <input name="amount" type="number" placeholder="Enter amount" min="1" class="w-full pl-10 pr-4 py-3 bg-slate-800 border border-slate-700 rounded-lg focus:outline-none focus:border-blue-500 text-white">
+                        </div>
+                        <div class="flex-1 w-full sm:max-w-xs">
+                            <select name="gateway" class="w-full px-4 py-3 bg-slate-800 border border-slate-700 rounded-lg text-white">
+                                @foreach(($gateways ?? []) as $gw)
+                                    <option value="{{ $gw['id'] }}">{{ $gw['name'] }}</option>
+                                @endforeach
+                            </select>
+                        </div>
+                        <button type="submit" class="px-8 py-3 bg-blue-600 hover:bg-blue-700 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-blue-900/30 w-full sm:w-auto">
+                            Donate
+                        </button>
+                    </form>
+                @else
+                    <div class="flex flex-col sm:flex-row gap-4 items-center justify-center">
+                        <div class="relative flex-1 w-full sm:max-w-xs">
+                            <span class="absolute left-4 top-1/2 transform -translate-y-1/2 text-slate-400 text-xl">$</span>
+                            <input disabled placeholder="Login required" class="w-full pl-10 pr-4 py-3 bg-slate-800 border border-slate-700 rounded-lg text-slate-500">
+                        </div>
+                        <div class="flex-1 w-full sm:max-w-xs">
+                            <select disabled class="w-full px-4 py-3 bg-slate-800 border border-slate-700 rounded-lg text-slate-500">
+                                <option>Select gateway</option>
+                            </select>
+                        </div>
+                        <a href="{{ route('login') }}" class="px-8 py-3 bg-slate-700 hover:bg-slate-600 rounded-lg font-semibold transition-all duration-200 text-white w-full sm:w-auto">
+                            Login to Donate
+                        </a>
                     </div>
-                    <button class="px-8 py-3 bg-blue-600 hover:bg-blue-700 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-blue-900/30 w-full sm:w-auto">
-                        Donate
-                    </button>
-                </div>
+                @endauth
                 <p class="text-slate-500 text-sm mt-4">Conversion rate: $1 = 100 Donation Points</p>
             </div>
         </div>
@@ -207,4 +232,4 @@
             </p>
         </div>
     </div>
-@endsection
\ No newline at end of file
+@endsection
diff --git a/app/Modules/Donate/Services/GatewayManager.php b/app/Modules/Donate/Services/GatewayManager.php
new file mode 100644
index 0000000..b10e4c5
--- /dev/null
+++ b/app/Modules/Donate/Services/GatewayManager.php
@@ -0,0 +1,34 @@
+<?php
+
+namespace Modules\Donate\Services;
+
+use Modules\Donate\Domain\Interfaces\PaymentGatewayInterface;
+use Illuminate\Support\Arr;
+
+class GatewayManager
+{
+    protected array $gateways = [];
+
+    public function __construct(array $gateways)
+    {
+        foreach ($gateways as $gateway) {
+            $this->register($gateway);
+        }
+    }
+
+    public function register(PaymentGatewayInterface $gateway): void
+    {
+        $this->gateways[$gateway->id()] = $gateway;
+    }
+
+    public function all(): array
+    {
+        return $this->gateways;
+    }
+
+    public function get(string $id): ?PaymentGatewayInterface
+    {
+        return Arr::get($this->gateways, $id);
+    }
+}
+
diff --git a/composer.json b/composer.json
index 80ccdab..61d193a 100755
--- a/composer.json
+++ b/composer.json
@@ -18,7 +18,8 @@
         "laravel/tinker": "2.10.1",
         "predis/predis": "3.2.0",
         "spatie/laravel-permission": "^6.18",
-        "wowcrypto/wowcrypto": "1.2.0"
+        "wowcrypto/wowcrypto": "1.2.0",
+        "braintree/braintree_php": "^6.13"
     },
     "require-dev": {
         "fakerphp/faker": "1.23",
diff --git a/composer.lock b/composer.lock
index e353110..8635ce0 100755
--- a/composer.lock
+++ b/composer.lock
@@ -4,8 +4,57 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "8d94a0b29b5ef74cbf8ba04ad7c94ba4",
+    "content-hash": "b336f73b62082a66e2b07c931571e0f2",
     "packages": [
+        {
+            "name": "braintree/braintree_php",
+            "version": "6.31.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/braintree/braintree_php.git",
+                "reference": "5c41da561a821d4131bcd336322e196e0198ef83"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/braintree/braintree_php/zipball/5c41da561a821d4131bcd336322e196e0198ef83",
+                "reference": "5c41da561a821d4131bcd336322e196e0198ef83",
+                "shasum": ""
+            },
+            "require": {
+                "ext-curl": "*",
+                "ext-dom": "*",
+                "ext-hash": "*",
+                "ext-openssl": "*",
+                "ext-xmlwriter": "*",
+                "php": ">=7.3.0"
+            },
+            "require-dev": {
+                "phpunit/phpunit": "^9.0",
+                "squizlabs/php_codesniffer": "^3.0"
+            },
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "Braintree\\": "lib/Braintree"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Braintree",
+                    "homepage": "https://www.braintreepayments.com"
+                }
+            ],
+            "description": "Braintree PHP Client Library",
+            "support": {
+                "issues": "https://github.com/braintree/braintree_php/issues",
+                "source": "https://github.com/braintree/braintree_php/tree/6.31.0"
+            },
+            "time": "2025-12-11T16:27:18+00:00"
+        },
         {
             "name": "brick/math",
             "version": "0.14.1",
diff --git a/config/donate.php b/config/donate.php
new file mode 100644
index 0000000..535c0d1
--- /dev/null
+++ b/config/donate.php
@@ -0,0 +1,16 @@
+<?php
+
+return [
+    'enabled_gateways' => [
+        'braintree',
+    ],
+    'gateways' => [
+        'braintree' => [
+            'environment' => env('BRAINTREE_ENVIRONMENT'),
+            'merchant_id' => env('BRAINTREE_MERCHANT_ID'),
+            'public_key' => env('BRAINTREE_PUBLIC_KEY'),
+            'private_key' => env('BRAINTREE_PRIVATE_KEY'),
+        ],
+    ],
+    'dp_rate' => 100,
+];
diff --git a/database/migrations/2026_01_07_000001_add_dp_vp_to_users_table.php b/database/migrations/2026_01_07_000001_add_dp_vp_to_users_table.php
new file mode 100644
index 0000000..8361c94
--- /dev/null
+++ b/database/migrations/2026_01_07_000001_add_dp_vp_to_users_table.php
@@ -0,0 +1,24 @@
+<?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::table('users', function (Blueprint $table) {
+            $table->unsignedInteger('dp')->default(0)->after('password');
+            $table->unsignedInteger('vp')->default(0)->after('dp');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            $table->dropColumn(['dp', 'vp']);
+        });
+    }
+};
+
diff --git a/database/migrations/2026_01_07_000002_create_donation_transactions_table.php b/database/migrations/2026_01_07_000002_create_donation_transactions_table.php
new file mode 100644
index 0000000..609bbaa
--- /dev/null
+++ b/database/migrations/2026_01_07_000002_create_donation_transactions_table.php
@@ -0,0 +1,31 @@
+<?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('donation_transactions', function (Blueprint $table) {
+            $table->id();
+            $table->unsignedBigInteger('user_id');
+            $table->string('gateway', 64);
+            $table->string('transaction_id', 128)->nullable();
+            $table->unsignedInteger('amount'); // in whole currency units (e.g., USD)
+            $table->string('currency', 8)->default('USD');
+            $table->unsignedInteger('dp_awarded')->default(0);
+            $table->string('status', 32)->default('pending');
+            $table->json('meta')->nullable();
+            $table->timestamps();
+            $table->index(['user_id', 'gateway', 'status']);
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('donation_transactions');
+    }
+};
+

From 2cb8dde00cf0a5d3e5af279ac4230ba48cbd8817 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 7 Jan 2026 20:59:10 +0100
Subject: [PATCH 028/132] feat(donate): add donation receipt page and redirect
 after checkout

Add a new receipt page to display donation transaction details and modify checkout flow to redirect to this page. The receipt includes transaction ID, amount, DP awarded, and other relevant information with print/save functionality.
---
 .../Http/Controllers/DonateController.php     | 20 ++++---
 app/Modules/Donate/Http/routes.php            |  1 +
 .../Donate/Resources/views/receipt.blade.php  | 54 +++++++++++++++++++
 3 files changed, 68 insertions(+), 7 deletions(-)
 create mode 100644 app/Modules/Donate/Resources/views/receipt.blade.php

diff --git a/app/Modules/Donate/Http/Controllers/DonateController.php b/app/Modules/Donate/Http/Controllers/DonateController.php
index dcdf9d7..4a41b01 100644
--- a/app/Modules/Donate/Http/Controllers/DonateController.php
+++ b/app/Modules/Donate/Http/Controllers/DonateController.php
@@ -38,7 +38,8 @@ public function checkout(Request $request, GatewayManager $gateways)
             $user = $request->user();
             $rate = (int) config('donate.dp_rate', 100);
             $dp = (int) ($amount * $rate);
-            DB::transaction(function () use ($user, $gatewayId, $amount, $dp, $result) {
+            $txId = null;
+            DB::transaction(function () use ($user, $gatewayId, $amount, $dp, $result, &$txId) {
                 $tx = DonationTransaction::create([
                     'user_id' => $user->id,
                     'gateway' => $gatewayId,
@@ -50,13 +51,9 @@ public function checkout(Request $request, GatewayManager $gateways)
                     'meta' => ['raw' => $result],
                 ]);
                 $user->increment('dp', $dp);
+                $txId = $tx->id;
             });
-            return response()->json([
-                'status' => 'success',
-                'dp_awarded' => $dp,
-                'amount' => $amount,
-                'gateway' => $gatewayId,
-            ]);
+            return redirect()->route('donate.receipt', ['id' => $txId]);
         }
         return response()->json($result, 400);
     }
@@ -76,4 +73,13 @@ public function webhook(string $gateway, Request $request, GatewayManager $gatew
         $result = $gw->handleWebhook($request);
         return response()->json($result);
     }
+
+    public function receipt(int $id)
+    {
+        $tx = DonationTransaction::query()
+            ->where('id', $id)
+            ->where('user_id', auth()->id())
+            ->firstOrFail();
+        return view('donate::receipt', ['tx' => $tx]);
+    }
 }
diff --git a/app/Modules/Donate/Http/routes.php b/app/Modules/Donate/Http/routes.php
index 9b94c76..09cd3a4 100644
--- a/app/Modules/Donate/Http/routes.php
+++ b/app/Modules/Donate/Http/routes.php
@@ -10,4 +10,5 @@
         Route::post('/checkout', [DonateController::class, 'checkout'])->middleware('auth')->name('donate.checkout');
         Route::match(['get', 'post'], '/callback/{gateway}', [DonateController::class, 'callback'])->name('donate.callback');
         Route::post('/webhook/{gateway}', [DonateController::class, 'webhook'])->name('donate.webhook');
+        Route::get('/receipt/{id}', [DonateController::class, 'receipt'])->middleware('auth')->where('id', '[0-9]+')->name('donate.receipt');
     });
diff --git a/app/Modules/Donate/Resources/views/receipt.blade.php b/app/Modules/Donate/Resources/views/receipt.blade.php
new file mode 100644
index 0000000..f90bbfc
--- /dev/null
+++ b/app/Modules/Donate/Resources/views/receipt.blade.php
@@ -0,0 +1,54 @@
+@extends('layouts.main')
+
+@section('title', 'Donation Receipt')
+
+@section('content')
+<div class="max-w-3xl mx-auto pt-24 pb-16 px-4">
+    <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-8">
+        <div class="flex items-center justify-between mb-6">
+            <h2 class="text-2xl font-bold">Donation Receipt</h2>
+            <button onclick="window.print()" class="px-4 py-2 bg-slate-700 hover:bg-slate-600 rounded-lg text-white font-semibold">
+                Print / Save as PDF
+            </button>
+        </div>
+        <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
+            <div>
+                <div class="text-sm text-slate-400">Receipt ID</div>
+                <div class="font-semibold text-white">{{ $tx->id }}</div>
+            </div>
+            <div>
+                <div class="text-sm text-slate-400">Date</div>
+                <div class="font-semibold text-white">{{ $tx->created_at }}</div>
+            </div>
+            <div>
+                <div class="text-sm text-slate-400">Gateway</div>
+                <div class="font-semibold text-white capitalize">{{ $tx->gateway }}</div>
+            </div>
+            <div>
+                <div class="text-sm text-slate-400">Transaction ID</div>
+                <div class="font-semibold text-white">{{ $tx->transaction_id ?? 'N/A' }}</div>
+            </div>
+            <div>
+                <div class="text-sm text-slate-400">Amount</div>
+                <div class="font-semibold text-white">${{ number_format($tx->amount, 2) }} {{ $tx->currency }}</div>
+            </div>
+            <div>
+                <div class="text-sm text-slate-400">DP Awarded</div>
+                <div class="font-semibold text-blue-400">{{ number_format($tx->dp_awarded) }}</div>
+            </div>
+            <div>
+                <div class="text-sm text-slate-400">Status</div>
+                <div class="font-semibold {{ $tx->status === 'completed' ? 'text-green-400' : 'text-yellow-400' }}">{{ ucfirst($tx->status) }}</div>
+            </div>
+            <div>
+                <div class="text-sm text-slate-400">User</div>
+                <div class="font-semibold text-white">{{ Auth::user()->name }}</div>
+            </div>
+        </div>
+        <div class="mt-8 text-sm text-slate-500">
+            Keep this receipt as proof of your donation. Thank you for your support.
+        </div>
+    </div>
+</div>
+@endsection
+

From c1377c708f9ce982ee728f7b2bab509260b9b7bc Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 9 Jan 2026 00:31:25 +0100
Subject: [PATCH 029/132] feat(donate): implement donation transactions and UI
 improvements

- Add donation transaction history view with stats and table
- Update sidebar navigation with donations link
- Replace hardcoded DP rate with config value
- Improve UCP dashboard styling and layout
- Add route for donation transactions
- Update login page register link to use route helper
---
 .../Frontend/Users/UserController.php         |  29 ++-
 .../Donate/Resources/views/home.blade.php     |   2 +-
 config/donate.php                             |  31 ++-
 resources/views/auth/login.blade.php          |   2 +-
 .../views/ucp/components/sidebar.blade.php    |  86 ++++----
 resources/views/ucp/donations.blade.php       | 148 +++++++++++++
 resources/views/ucp/index.blade.php           | 198 +++++++++---------
 routes/web.php                                |   2 +-
 8 files changed, 354 insertions(+), 144 deletions(-)
 create mode 100644 resources/views/ucp/donations.blade.php

diff --git a/app/Http/Controllers/Frontend/Users/UserController.php b/app/Http/Controllers/Frontend/Users/UserController.php
index 34eb3ef..c4f78c2 100755
--- a/app/Http/Controllers/Frontend/Users/UserController.php
+++ b/app/Http/Controllers/Frontend/Users/UserController.php
@@ -12,6 +12,7 @@
 use App\Models\AccountLinked;
 use App\Models\Realm;
 use App\Traits\ConnectsToExternalDatabase;
+use Modules\Donate\Domain\Models\DonationTransaction;
 
 /**
  * User Controller for handling user-related actions in the frontend
@@ -30,6 +31,7 @@ class UserController extends Controller
         'create' => 'ucp.createAccount',
         'gameAccount' => 'ucp.gameAccount',
         'manage' => 'ucp.manageAccount',
+        'transaction' => 'ucp.donations',
     ];
 
     /**
@@ -68,13 +70,32 @@ public function show()
             throw new UserNotFoundException('User not found', 404);
         }
 
-        // TODO: Remove this line when you have a real implementation
-        // at the moment we are just returning a dummy user
-        $user->coins = 0;
-
         return view($this->views['index'], compact('user'));
     }
 
+    /**
+     * Show transaction page
+     *
+     * @throws UserNotFoundException
+     * @return \Illuminate\View\View
+     */
+    public function transaction()
+    {
+        $user = $this->auth->guard()->user();
+
+        $transactions = DonationTransaction::where('user_id', $user->id)->get();
+
+        if ($transactions->isEmpty()) {
+            $transactions = [];
+        }
+
+        if (!$user) {
+            throw new UserNotFoundException('User not found', 404);
+        }
+
+        return view($this->views['transaction'], compact('user', 'transactions'));
+    }
+
     /**
      * Show create account form
      *
diff --git a/app/Modules/Donate/Resources/views/home.blade.php b/app/Modules/Donate/Resources/views/home.blade.php
index df6c1de..f7e5ca9 100644
--- a/app/Modules/Donate/Resources/views/home.blade.php
+++ b/app/Modules/Donate/Resources/views/home.blade.php
@@ -129,7 +129,7 @@
                         </a>
                     </div>
                 @endauth
-                <p class="text-slate-500 text-sm mt-4">Conversion rate: $1 = 100 Donation Points</p>
+                <p class="text-slate-500 text-sm mt-4">Conversion rate: $1 = {{ config('donate.dp_rate') }} Donation Points</p>
             </div>
         </div>
 
diff --git a/config/donate.php b/config/donate.php
index 535c0d1..0e30611 100644
--- a/config/donate.php
+++ b/config/donate.php
@@ -1,9 +1,39 @@
 <?php
 
 return [
+    /**
+     * Enabled gateways for donation transactions.
+     * 
+     * @var array
+     * 
+     * Development note: Add more gateways as needed.
+     * 
+     * @example 'enabled_gateways' => ['braintree', 'paypal'],
+     */
     'enabled_gateways' => [
         'braintree',
     ],
+
+    /**
+     * Conversion rate between currency and donation points.
+     * 
+     * @var int
+     * 
+     * Development note: Update this value as needed.
+     * 
+     * @example 'dp_rate' => 100,
+     */
+    'dp_rate' => 100,
+
+    /**
+     * Gateways configuration.
+     * 
+     * @var array
+     * 
+     * Development note: Add more gateways as needed.
+     * 
+     * @example 'gateways' => ['braintree' => [...]],
+     */
     'gateways' => [
         'braintree' => [
             'environment' => env('BRAINTREE_ENVIRONMENT'),
@@ -12,5 +42,4 @@
             'private_key' => env('BRAINTREE_PRIVATE_KEY'),
         ],
     ],
-    'dp_rate' => 100,
 ];
diff --git a/resources/views/auth/login.blade.php b/resources/views/auth/login.blade.php
index 6a49f84..33ad8fc 100755
--- a/resources/views/auth/login.blade.php
+++ b/resources/views/auth/login.blade.php
@@ -152,7 +152,7 @@ class="w-full py-3 px-4 bg-gradient-to-r from-blue-600 to-blue-700 hover:from-bl
                     <div class="text-center pt-4">
                         <p class="text-slate-400">
                             Don't have an account? 
-                            <a href="#" class="text-blue-400 hover:text-blue-300 font-medium transition-colors">Register here</a>
+                            <a href="{{ route('register') }}" class="text-blue-400 hover:text-blue-300 font-medium transition-colors">Register here</a>
                         </p>
                     </div>
                 </form>
diff --git a/resources/views/ucp/components/sidebar.blade.php b/resources/views/ucp/components/sidebar.blade.php
index 0941e5f..c7bcb5c 100755
--- a/resources/views/ucp/components/sidebar.blade.php
+++ b/resources/views/ucp/components/sidebar.blade.php
@@ -1,54 +1,56 @@
 <aside class="w-full lg:w-72 space-y-6">
-    <div class="bg-gray-800/70 backdrop-blur-lg rounded-2xl border border-gray-800 p-8 shadow-2xl">
-        <div class="flex items-center space-x-5 mb-8">
-            <div class="relative">
-                <div class="p-1 rounded-full bg-gradient-to-r from-blue-500 to-indigo-500">
-                    <img src="{{ $user->avatar ?? null }}" 
-                         alt="Avatar" 
-                         class="w-16 h-16 rounded-full ring-2 ring-gray-800">
+    <div class="bg-slate-800/50 backdrop-blur-sm rounded-2xl border border-slate-700/50 overflow-hidden shadow-xl">
+        <div class="p-6 bg-gradient-to-br from-blue-500/10 to-purple-500/10 border-b border-slate-700/50">
+            <div class="flex flex-col items-center">
+                <div class="relative">
+                    <div class="w-20 h-20 rounded-full bg-gradient-to-br from-blue-400 to-purple-500 p-0.5">
+                        <div class="w-full h-full rounded-full bg-slate-800 flex items-center justify-center text-2xl font-bold">
+                            {{ $user->name[0] }}
+                        </div>
+                    </div>
+                    <div class="absolute bottom-0 right-0 w-5 h-5 bg-green-500 rounded-full border-2 border-slate-800"></div>
                 </div>
-                <div class="absolute -bottom-1 -right-1 w-5 h-5 bg-emerald-500 border border-gray-800 rounded-full shadow-lg"></div>
-            </div>
-            <div>
-                <h3 class="text-xl font-bold text-white tracking-tight">{{ $user->name }}</h3>
+                <h3 class="mt-4 text-lg font-bold text-white">{{ $user->name }}</h3>
                 @if($user->roles->isNotEmpty())
-                    <span class="text-sm text-gray-400">{{ $user->roles->first()->name }}</span>
+                    <span class="mt-1 px-3 py-1 text-xs font-medium bg-purple-500/20 text-purple-300 rounded-full border border-purple-500/30">{{ $user->roles->first()->name }}</span>
                 @endif
             </div>
         </div>
-    
-        <nav class="space-y-2">
-            <a href="{{ route('ucp.dashboard') }}" 
-               class="flex items-center space-x-3 px-5 py-3.5 rounded-xl transition-all duration-300 {{ request()->routeIs('ucp.dashboard') ? 'bg-gradient-to-r from-blue-600/30 to-indigo-600/30 text-blue-400 border border-gray-900 shadow-lg' : 'text-gray-400 hover:bg-gray-700/50 hover:text-white hover:shadow-md' }}">
-                <i class="fas fa-home w-5 h-5"></i>
-                <span class="font-medium">Dashboard</span>
-            </a>
-            <a href="{{ route('ucp.gameaccount') }}" 
-            class="flex items-center space-x-3 px-5 py-3.5 rounded-xl transition-all duration-300 {{ request()->routeIs('ucp.gameaccount') ? 'bg-gradient-to-r from-blue-600/30 to-indigo-600/30 text-blue-400 border border-gray-900 shadow-lg' : 'text-gray-400 hover:bg-gray-700/50 hover:text-white hover:shadow-md' }}">
-                <i class="fas fa-gamepad w-5 h-5"></i>
-                <span class="font-medium">Game Account</span>
-            </a>
-            
+        
+        <nav class="p-4">
+            <div class="space-y-2">
+                <a href="{{ route('ucp.dashboard') }}" class="flex items-center space-x-3 px-4 py-3 rounded-xl bg-blue-500/20 text-blue-300 border border-blue-500/30 transition-all duration-200 hover:bg-blue-500/30">
+                    <i class="fas fa-home w-5"></i>
+                    <span class="font-medium">Dashboard</span>
+                </a>
+                <a href="{{ route('ucp.gameaccount') }}" class="flex items-center space-x-3 px-4 py-3 rounded-xl text-gray-400 hover:bg-slate-700/50 hover:text-white transition-all duration-200">
+                    <i class="fas fa-gamepad w-5"></i>
+                    <span class="font-medium">Game Account</span>
+                </a>
+                <a href="{{ route('ucp.transaction') }}" class="flex items-center space-x-3 px-4 py-3 rounded-xl text-gray-400 hover:bg-slate-700/50 hover:text-white transition-all duration-200">
+                    <i class="fas fa-hand-holding-usd w-5"></i>
+                    <span class="font-medium">Donations</span>
+                </a>
+            </div>
+
             @if($user->hasRole(['GameMaster', 'Admin']))
-                <div class="pt-4 mt-4 border-t border-gray-700">
-                    <h4 class="text-xs font-semibold text-gray-500 uppercase tracking-wider mb-2 px-2">GameMaster</h4>
-                    <a href="#" 
-                    class="flex items-center space-x-3 px-5 py-3.5 rounded-xl transition-all duration-300 {{ request()->routeIs('gm.dashboard') ? 'bg-gradient-to-r from-purple-600/30 to-pink-600/30 text-purple-400 border border-gray-900 shadow-lg' : 'text-gray-400 hover:bg-gray-700/50 hover:text-white hover:shadow-md' }}">
-                        <i class="fas fa-shield-alt w-5 h-5"></i>
-                        <span class="font-medium">GM Panel</span>
-                    </a>
-                </div>
+            <div class="mt-6 pt-6 border-t border-slate-700/50">
+                <p class="px-4 text-xs font-semibold text-gray-500 uppercase tracking-wider mb-3">GAMEMASTER</p>
+                <a href="#" class="flex items-center space-x-3 px-4 py-3 rounded-xl text-gray-400 hover:bg-slate-700/50 hover:text-white transition-all duration-200">
+                    <i class="fas fa-shield w-5"></i>
+                    <span class="font-medium">GM Panel</span>
+                </a>
+            </div>
             @endif
-            
+
             @if($user->hasRole('Admin'))
-                <div class="pt-4 mt-4 border-t border-gray-700">
-                    <h4 class="text-xs font-semibold text-gray-500 uppercase tracking-wider mb-2 px-2">Admin</h4>
-                    <a href="#" 
-                    class="flex items-center space-x-3 px-5 py-3.5 rounded-xl transition-all duration-300 {{ request()->routeIs('admin.dashboard') ? 'bg-gradient-to-r from-red-600/30 to-yellow-600/30 text-red-400 border border-gray-900 shadow-lg' : 'text-gray-400 hover:bg-gray-700/50 hover:text-white hover:shadow-md' }}">
-                        <i class="fas fa-cog w-5 h-5"></i>
-                        <span class="font-medium">Admin Panel</span>
-                    </a>
-                </div>
+            <div class="mt-6 pt-6 border-t border-slate-700/50">
+                <p class="px-4 text-xs font-semibold text-gray-500 uppercase tracking-wider mb-3">ADMIN</p>
+                <a href="#" class="flex items-center space-x-3 px-4 py-3 rounded-xl text-gray-400 hover:bg-slate-700/50 hover:text-white transition-all duration-200">
+                    <i class="fas fa-cog w-5"></i>
+                    <span class="font-medium">Admin Panel</span>
+                </a>
+            </div>
             @endif
         </nav>
     </div>
diff --git a/resources/views/ucp/donations.blade.php b/resources/views/ucp/donations.blade.php
new file mode 100644
index 0000000..dbad09a
--- /dev/null
+++ b/resources/views/ucp/donations.blade.php
@@ -0,0 +1,148 @@
+@extends('layouts.main')
+
+@section('content')
+
+<div class="max-w-7xl mx-auto px-6 sm:px-6 lg:px-8 py-8 pt-24">
+    <div class="grid grid-cols-1 lg:grid-cols-4 gap-6">
+        @include('ucp.components.sidebar')
+
+        <main class="lg:col-span-3 space-y-6">
+                <!-- Stats Overview -->
+            <div class="grid grid-cols-1 sm:grid-cols-3 gap-4">
+                <!-- Total Donated -->
+                <div class="bg-gradient-to-br from-emerald-500/10 to-emerald-600/5 rounded-xl p-6 border border-emerald-500/20 hover:border-emerald-500/40 transition-all duration-200">
+                    <div class="flex items-center justify-between mb-3">
+                        <div class="w-12 h-12 rounded-lg bg-emerald-500/20 flex items-center justify-center">
+                            <i class="fas fa-dollar-sign text-xl text-emerald-400"></i>
+                        </div>
+                    </div>
+                    <p class="text-sm text-gray-400 mb-1">Total Donated</p>
+                    <p class="text-3xl font-bold text-white">{{ number_format($transactions->sum('amount'), 2) }}</p>
+                </div>
+
+                <!-- Total Coins -->
+                <div class="bg-gradient-to-br from-amber-500/10 to-amber-600/5 rounded-xl p-6 border border-amber-500/20 hover:border-amber-500/40 transition-all duration-200">
+                    <div class="flex items-center justify-between mb-3">
+                        <div class="w-12 h-12 rounded-lg bg-amber-500/20 flex items-center justify-center">
+                            <i class="fas fa-coins text-xl text-amber-400"></i>
+                        </div>
+                    </div>
+                    <p class="text-sm text-gray-400 mb-1">Total Coins Earned</p>
+                    <p class="text-3xl font-bold text-white">{{ number_format($transactions->sum('dp_awarded')) }}</p>
+                </div>
+
+                <!-- Transactions -->
+                <div class="bg-gradient-to-br from-blue-500/10 to-blue-600/5 rounded-xl p-6 border border-blue-500/20 hover:border-blue-500/40 transition-all duration-200">
+                    <div class="flex items-center justify-between mb-3">
+                        <div class="w-12 h-12 rounded-lg bg-blue-500/20 flex items-center justify-center">
+                            <i class="fas fa-receipt text-xl text-blue-400"></i>
+                        </div>
+                    </div>
+                    <p class="text-sm text-gray-400 mb-1">Total Transactions</p>
+                    <p class="text-3xl font-bold text-white">{{ number_format($transactions->count()) }}</p>
+                </div>
+            </div>
+
+            <!-- Transactions Table -->
+            <div class="bg-slate-800/50 backdrop-blur-sm rounded-2xl border border-slate-700/50 overflow-hidden shadow-xl">
+                <div class="p-6 border-b border-slate-700/50 flex justify-between items-center">
+                    <div>
+                        <h2 class="text-2xl font-bold bg-gradient-to-r from-blue-400 to-purple-500 bg-clip-text text-transparent">Transaction History</h2>
+                        <p class="text-sm text-gray-400 mt-1">Manage and track all your donation transactions</p>
+                    </div>
+                </div>
+                
+                <div class="overflow-x-auto">
+                    <table class="w-full">
+                        <thead>
+                            <tr class="bg-slate-700/30">
+                                <th class="px-6 py-4 text-left text-xs font-semibold text-gray-400 uppercase tracking-wider">Transaction ID</th>
+                                <th class="px-6 py-4 text-left text-xs font-semibold text-gray-400 uppercase tracking-wider">Date</th>
+                                <th class="px-6 py-4 text-left text-xs font-semibold text-gray-400 uppercase tracking-wider">Amount</th>
+                                <th class="px-6 py-4 text-left text-xs font-semibold text-gray-400 uppercase tracking-wider">Coins</th>
+                                <th class="px-6 py-4 text-left text-xs font-semibold text-gray-400 uppercase tracking-wider">Method</th>
+                                <th class="px-6 py-4 text-left text-xs font-semibold text-gray-400 uppercase tracking-wider">Status</th>
+                                <th class="px-6 py-4 text-right text-xs font-semibold text-gray-400 uppercase tracking-wider">Actions</th>
+                            </tr>
+                        </thead>
+                        <tbody class="divide-y divide-slate-700/50">
+                            @foreach ($transactions as $transaction)
+                            <!-- Transaction 1 -->
+                            <tr class="hover:bg-slate-700/20 transition-colors duration-200">
+                                <td class="px-6 py-4">
+                                    <div class="flex items-center space-x-3">
+                                        <div class="w-10 h-10 rounded-lg bg-blue-500/20 flex items-center justify-center">
+                                            <i class="fas fa-hashtag text-blue-400"></i>
+                                        </div>
+                                        <span class="text-sm font-mono text-gray-300">{{ $transaction->transaction_id }}</span>
+                                    </div>
+                                </td>
+                                <td class="px-6 py-4">
+                                    <div class="text-sm text-gray-300">{{ $transaction->created_at->format('M d, Y') }}</div>
+                                    <div class="text-xs text-gray-500">{{ $transaction->created_at->format('h:i A') }}</div>
+                                </td>
+                                <td class="px-6 py-4">
+                                    <span class="text-sm font-bold text-emerald-400">${{ number_format($transaction->amount, 2) }}</span>
+                                </td>
+                                <td class="px-6 py-4">
+                                    <div class="flex items-center space-x-2">
+                                        <i class="fas fa-coins text-amber-400"></i>
+                                        <span class="text-sm font-semibold text-white">{{ number_format($transaction->dp_awarded, 0) }}</span>
+                                    </div>
+                                </td>
+                                <td class="px-6 py-4">
+                                    <div class="text-sm font-medium text-gray-300 text-capitalize">{{ ucfirst($transaction->gateway) }}</div>
+                                </td>
+                                <td class="px-6 py-4">
+                                    @if($transaction->status == 'completed')
+                                    <span class="inline-flex items-center px-3 py-1 rounded-full text-xs font-medium bg-green-500/20 text-green-300 border border-green-500/30">
+                                        <div class="w-1.5 h-1.5 bg-green-400 rounded-full mr-2"></div>
+                                        Completed
+                                    </span>
+                                    @else
+                                    <span class="inline-flex items-center px-3 py-1 rounded-full text-xs font-medium bg-amber-500/20 text-amber-300 border border-amber-500/30">
+                                        <div class="w-1.5 h-1.5 bg-amber-400 rounded-full mr-2 animate-pulse"></div>
+                                        Pending
+                                    </span>
+                                    @endif
+                                </td>
+                                <td class="px-6 py-4 text-right">
+                                    <button class="text-gray-400 hover:text-blue-400 transition-colors duration-200">
+                                        <i class="fas fa-eye"></i>
+                                    </button>
+                                </td>
+                            </tr>
+                            @endforeach
+                        </tbody>
+                    </table>
+                </div>
+
+                <!-- Pagination -->
+                <div class="px-6 py-4 border-t border-slate-700/50 flex items-center justify-between">
+                    <div class="text-sm text-gray-400">
+                        Showing <span class="font-semibold text-white">1-5</span> of <span class="font-semibold text-white">18</span> transactions
+                    </div>
+                    <div class="flex items-center space-x-2">
+                        <button class="px-4 py-2 bg-slate-700/50 text-gray-400 rounded-lg hover:bg-slate-700 hover:text-white transition-all duration-200 disabled:opacity-50 disabled:cursor-not-allowed" disabled>
+                            <i class="fas fa-chevron-left mr-2"></i>
+                            Previous
+                        </button>
+                        <button class="px-4 py-2 bg-blue-500 text-white rounded-lg hover:bg-blue-600 transition-all duration-200">
+                            1
+                        </button>
+                        <button class="px-4 py-2 bg-slate-700/50 text-gray-400 rounded-lg hover:bg-slate-700 hover:text-white transition-all duration-200">
+                            2
+                        </button>
+                        <button class="px-4 py-2 bg-slate-700/50 text-gray-400 rounded-lg hover:bg-slate-700 hover:text-white transition-all duration-200">
+                            3
+                        </button>
+                        <button class="px-4 py-2 bg-slate-700/50 text-gray-400 rounded-lg hover:bg-slate-700 hover:text-white transition-all duration-200">
+                            Next
+                            <i class="fas fa-chevron-right ml-2"></i>
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </main>
+    </div>
+</div>
\ No newline at end of file
diff --git a/resources/views/ucp/index.blade.php b/resources/views/ucp/index.blade.php
index a58f958..dc7a26a 100755
--- a/resources/views/ucp/index.blade.php
+++ b/resources/views/ucp/index.blade.php
@@ -1,121 +1,131 @@
 @extends('layouts.main')
 
 @section('content')
-<div class="min-h-screen bg-gradient-to-b from-gray-900 to-gray-950 pt-24 pb-12">
-    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
-        <div class="flex flex-col lg:flex-row gap-8">
-            @include('ucp.components.sidebar')
 
-            <div class="flex-1 space-y-6">
-                <div class="bg-gradient-to-r from-gray-900 via-gray-800 to-gray-900 border border-gray-700 rounded-3xl p-8 shadow-2xl backdrop-blur-lg">
-                    <div class="flex items-center justify-between mb-6">
-                        <h2 class="text-2xl font-bold text-transparent bg-clip-text bg-gradient-to-r from-blue-400 to-purple-500">
-                            Account Overview
-                        </h2>
-                        @switch($user->status ?? 'active')
-                            @case('active')
-                                <span class="px-3 py-1 text-sm font-medium text-green-400 bg-emerald-500/20 rounded-full border border-emerald-400/20">
-                                    Active Account
-                                </span>
-                                @break
-                            @case('inactive')
-                                <span class="px-3 py-1 text-sm font-medium text-amber-400 bg-amber-500/20 rounded-full border border-amber-400/20">
-                                    Inactive Account
-                                </span>
-                                @break
-                            @case('banned')
-                                <span class="px-3 py-1 text-sm font-medium text-red-400 bg-red-500/20 rounded-full border border-red-400/20">
-                                    Banned Account
-                                </span>
-                                @break
-                            @default
-                                <span class="px-3 py-1 text-sm font-medium text-gray-400 bg-gray-500/20 rounded-full border border-gray-400/20">
-                                    Unknown Status
-                                </span>
-                        @endswitch
-                    </div>
-                    
-                    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4">
-                        <div class="bg-gray-900/50 rounded-lg p-4 border border-gray-900 transition-all duration-300 hover:bg-gray-900/70 hover:border-blue-500/20 hover:shadow-lg hover:shadow-blue-500/5 hover:transform hover:scale-[1.02]">
-                            <div class="flex items-center space-x-3 text-gray-400 mb-2">
-                                <i class="fas fa-shield-alt w-5 h-5 text-blue-400"></i>
-                                <span>Status</span>
+<div class="max-w-7xl mx-auto px-6 sm:px-6 lg:px-8 py-8 pt-24">
+    <div class="grid grid-cols-1 lg:grid-cols-4 gap-6">
+        @include('ucp.components.sidebar')
+
+        <main class="lg:col-span-3 space-y-6">
+            <!-- Account Overview -->
+            <div class="bg-slate-800/50 backdrop-blur-sm rounded-2xl border border-slate-700/50 overflow-hidden shadow-xl">
+                <div class="p-6 border-b border-slate-700/50 flex justify-between items-center">
+                    <h2 class="text-2xl font-bold bg-gradient-to-r from-blue-400 to-purple-500 bg-clip-text text-transparent">Account Overview</h2>
+                </div>
+                
+                <div class="p-6">
+                    <div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-4">
+                        <!-- Status Card -->
+                        <div class="bg-gradient-to-br from-blue-500/10 to-blue-600/5 rounded-xl p-5 border border-blue-500/20 hover:border-blue-500/40 transition-all duration-200 hover:transform hover:scale-105">
+                            <div class="flex items-center space-x-3 mb-3">
+                                <div class="w-10 h-10 rounded-lg bg-blue-500/20 flex items-center justify-center">
+                                    <i class="fas fa-shield text-blue-400"></i>
+                                </div>
+                                <span class="text-sm text-gray-400">Status</span>
                             </div>
-                            <div class="text-xl font-bold text-white">Verified</div>
+                            @switch($user->status ?? 'active')
+                                @case('active')
+                                    <span class="text-2xl font-bold text-green-400">
+                                        Active
+                                    </span>
+                                    @break
+                                @case('inactive')
+                                    <span class="text-2xl font-bold text-amber-400">
+                                        Inactive
+                                    </span>
+                                    @break
+                                @case('banned')
+                                    <span class="text-2xl font-bold text-red-400">
+                                        Banned
+                                    </span>
+                                    @break
+                                @default
+                                    <span class="text-2xl font-bold text-gray-400">
+                                        Unknown Status
+                                    </span>
+                            @endswitch
                         </div>
-                        
-                        <div class="bg-gray-900/50 rounded-lg p-4 border border-gray-900 transition-all duration-300 hover:bg-gray-900/70 hover:border-blue-500/20 hover:shadow-lg hover:shadow-blue-500/5 hover:transform hover:scale-[1.02]">
-                            <div class="flex items-center space-x-3 text-gray-400 mb-2">
-                                <i class="fas fa-users w-5 h-5 text-purple-400"></i>
-                                <span>Characters</span>
-                            </div>
-                            <div class="text-xl font-bold text-white">
-                                {{ count($user->characters ?? []) }}
+
+                        <!-- Characters Card -->
+                        <div class="bg-gradient-to-br from-purple-500/10 to-purple-600/5 rounded-xl p-5 border border-purple-500/20 hover:border-purple-500/40 transition-all duration-200 hover:transform hover:scale-105">
+                            <div class="flex items-center space-x-3 mb-3">
+                                <div class="w-10 h-10 rounded-lg bg-purple-500/20 flex items-center justify-center">
+                                    <i class="fas fa-users text-purple-400"></i>
+                                </div>
+                                <span class="text-sm text-gray-400">Characters</span>
                             </div>
+                            <p class="text-2xl font-bold text-white">{{ count($user->characters ?? []) }}</p>
                         </div>
-                        
-                        <div class="bg-gray-900/50 rounded-lg p-4 border border-gray-900 transition-all duration-300 hover:bg-gray-900/70 hover:border-purple-500/20 hover:shadow-lg hover:shadow-purple-500/5 hover:transform hover:scale-[1.02]">
-                            <div class="flex items-center space-x-3 text-gray-400 mb-2">
-                                <i class="fas fa-clock w-5 h-5 text-emerald-400"></i>
-                                <span>Member Since</span>
-                            </div>
-                            <div class="text-xl font-bold text-white">
-                                {{ $user->created_at->format('m/d/Y') }}
+
+                        <!-- Member Since Card -->
+                        <div class="bg-gradient-to-br from-emerald-500/10 to-emerald-600/5 rounded-xl p-5 border border-purple-500/20 hover:border-emerald-500/40 transition-all duration-200 hover:transform hover:scale-105">
+                            <div class="flex items-center space-x-3 mb-3">
+                                <div class="w-10 h-10 rounded-lg bg-emerald-500/20 flex items-center justify-center">
+                                    <i class="fas fa-calendar text-emerald-400"></i>
+                                </div>
+                                <span class="text-sm text-gray-400">Member Since</span>
                             </div>
+                            <p class="text-lg font-bold text-white">{{ $user->created_at->format('m/d/Y') }}</p>
                         </div>
-                        
-                        <div class="bg-gray-900/50 rounded-lg p-4 border border-gray-900 transition-all duration-300 hover:bg-gray-900/70 hover:border-emerald-500/20 hover:shadow-lg hover:shadow-emerald-500/5 hover:transform hover:scale-[1.02]">
-                            <div class="flex items-center space-x-3 text-gray-400 mb-2">
-                                <i class="fas fa-coins w-5 h-5 text-yellow-400"></i>
-                                <span>Coins</span>
-                            </div>
-                            <div class="text-xl font-bold text-white">
-                                {{ $user->coins ?? 0 }}
+
+                        <!-- Coins Card -->
+                        <div class="bg-gradient-to-br from-amber-500/10 to-amber-600/5 rounded-xl p-5 border border-purple-500/20 hover:border-amber-500/40 transition-all duration-200 hover:transform hover:scale-105">
+                            <div class="flex items-center space-x-3 mb-3">
+                                <div class="w-10 h-10 rounded-lg bg-amber-500/20 flex items-center justify-center">
+                                    <i class="fas fa-coins text-amber-400"></i>
+                                </div>
+                                <span class="text-sm text-gray-400">Coins</span>
                             </div>
+                            <p class="text-2xl font-bold text-white">{{ $user->dp }}</p>
                         </div>
                     </div>
                 </div>
+            </div>
 
-                <div class="bg-gray-800/50 backdrop-blur-sm rounded-xl border border-gray-800 p-6 shadow-xl transition-all duration-300 hover:bg-gray-800/70 hover:border-blue-500/20 hover:shadow-2xl hover:shadow-blue-500/5">
-                    <div class="flex items-center justify-between mb-6">
-                        <h3 class="text-xl font-bold text-transparent bg-clip-text bg-gradient-to-r from-blue-400 to-purple-500">
-                            My Characters
-                        </h3>
-                    </div>
+             <!-- My Characters -->
+            <div class="bg-slate-800/50 backdrop-blur-sm rounded-2xl border border-slate-700/50 overflow-hidden shadow-xl">
+                <div class="p-6 border-b border-slate-700/50">
+                    <h2 class="text-2xl font-bold bg-gradient-to-r from-blue-400 to-purple-500 bg-clip-text text-transparent">My Characters</h2>
+                </div>
+                
+                <div class="p-6">
+                    <!-- Table -->
                     <div class="overflow-x-auto">
-                        <table class="w-full">
+                        <table class="w-full text-left">
                             <thead>
-                                <tr class="text-left text-gray-400 border-b border-gray-700">
-                                    <th class="pb-4 font-medium">Name</th>
-                                    <th class="pb-4 font-medium">Level</th>
-                                    <th class="pb-4 font-medium">Class</th>
-                                    <th class="pb-4 font-medium">Realm</th>
+                                <tr class="border-b border-slate-700/50">
+                                    <th class="px-4 py-3 text-sm font-semibold text-gray-400 uppercase tracking-wider">Name</th>
+                                    <th class="px-4 py-3 text-sm font-semibold text-gray-400 uppercase tracking-wider">Level</th>
+                                    <th class="px-4 py-3 text-sm font-semibold text-gray-400 uppercase tracking-wider">Class</th>
+                                    <th class="px-4 py-3 text-sm font-semibold text-gray-400 uppercase tracking-wider">Realm</th>
                                 </tr>
                             </thead>
-                            <tbody class="divide-y divide-gray-700">
+                            <tbody class="divide-y divide-slate-700/30">
                                 @forelse ($user->characters ?? [] as $character)
-                                    <tr class="text-gray-300 hover:bg-gray-800/30 transition-colors duration-200">
-                                        <td class="py-4">
-                                            <div class="flex items-center space-x-3">
-                                                <img class="h-8 w-8 rounded-full" src="https://wow.zamimg.com/images/wow/icons/large/inv_misc_questionmark.jpg" alt="{{ $character->name }}">
-                                                <span class="font-medium">{{ $character->name }}</span>
-                                            </div>
+                                    <tr class="hover:bg-slate-700/20 transition-colors duration-200">
+                                        <td class="px-4 py-4 flex items-center space-x-3">
+                                            <img class="h-8 w-8 rounded-full" src="https://wow.zamimg.com/images/wow/icons/large/inv_misc_questionmark.jpg" alt="{{ $character->name }}">
+                                            <span class="font-medium text-white">{{ $character->name }}</span>
                                         </td>
-                                        <td class="py-4">
-                                            <span class="px-2 py-1 text-xs font-medium text-yellow-400 bg-yellow-400/10 rounded-full">
-                                                {{ $character->level }}
-                                            </span>
+                                        <td class="px-4 py-4">
+                                            <span class="px-2 py-1 text-xs font-medium text-yellow-400 bg-yellow-400/10 rounded-full">{{ $character->level }}</span>
                                         </td>
-                                        <td class="py-4">{{ $character->class }}</td>
-                                        <td class="py-4">{{ $character->realm }}</td>
+                                        <td class="px-4 py-4 text-gray-300">{{ $character->class }}</td>
+                                        <td class="px-4 py-4 text-gray-300">{{ $character->realm }}</td>
                                     </tr>
                                 @empty
                                     <tr>
-                                        <td colspan="5" class="py-8 text-center text-gray-400">
-                                            <div class="flex flex-col items-center">
-                                                <i class="fas fa-user-slash text-4xl mb-3"></i>
-                                                <p class="text-lg">No characters available</p>
-                                                <p class="text-sm text-gray-500">Create your first character to begin your adventure</p>
+                                        <td colspan="4" class="px-4 py-16 text-center">
+                                            <div class="flex flex-col items-center justify-center">
+                                                <div class="w-20 h-20 rounded-full bg-slate-700/50 flex items-center justify-center mb-6">
+                                                    <i class="fas fa-user-slash text-3xl text-gray-500"></i>
+                                                </div>
+                                                <h3 class="text-xl font-bold text-gray-300 mb-2">No characters available</h3>
+                                                <p class="text-gray-500 mb-6">Create your first character to begin your adventure</p>
+                                                <a href="{{ route('ucp.gameaccount.create') }}" class="px-6 py-3 bg-gradient-to-r from-blue-500 to-purple-500 hover:from-blue-600 hover:to-purple-600 text-white font-medium rounded-xl transition-all duration-200 transform hover:scale-105 shadow-lg shadow-blue-500/25">
+                                                    <i class="fas fa-plus mr-2"></i>
+                                                    Create Character
+                                                </a>
                                             </div>
                                         </td>
                                     </tr>
@@ -125,7 +135,7 @@
                     </div>
                 </div>
             </div>
-        </div>
+        </main>
     </div>
 </div>
 @endsection
\ No newline at end of file
diff --git a/routes/web.php b/routes/web.php
index 9c4cd1f..02b0c94 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -61,7 +61,7 @@
 Route::prefix('ucp')->middleware(['auth', 'role:User,GameMaster,Admin'])->group(function () {
     Route::get('/', [UserController::class, 'show'])->name('ucp.dashboard');
     Route::get('/gameaccount', [UserController::class, 'gameAccount'])->name('ucp.gameaccount');
-    Route::get('/battlepass', [UserController::class, 'battlePass'])->name('ucp.battlepass');
+    Route::get('/donations', [UserController::class, 'transaction'])->name('ucp.transaction');
     Route::get('/gameaccount/create', [UserController::class, 'createAction'])->name('ucp.gameaccount.create');
     Route::post('/gameaccount/create', [UserController::class, 'createGameAccount'])->name('ucp.gameaccount.store');
     Route::get('/manage', [UserController::class, 'manage'])->name('ucp.manageAccount');

From 7ad9e581a3c40254421f6c8eb1d9cd0b0f912ee7 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 11 Jan 2026 00:35:56 +0100
Subject: [PATCH 030/132] feat(donate): implement donation plans feature

- Add DonationPlan model with migration and seeder
- Update donate config to support plans configuration
- Modify BraintreeGateway to handle plan amounts correctly
- Extend DonateController to process plan-based donations
- Redesign home view to display donation plans and handle plan selection
---
 .../Donate/Domain/Models/DonationPlan.php     |  51 +++++++
 .../Http/Controllers/DonateController.php     |  35 ++++-
 .../Gateways/BraintreeGateway.php             |   2 +-
 .../Donate/Resources/views/home.blade.php     | 143 ++++++++++--------
 config/donate.php                             |  15 +-
 ..._09_000001_create_donation_plans_table.php |  29 ++++
 database/seeders/DonationPlansSeeder.php      |  79 ++++++++++
 7 files changed, 282 insertions(+), 72 deletions(-)
 create mode 100644 app/Modules/Donate/Domain/Models/DonationPlan.php
 create mode 100644 database/migrations/2026_01_09_000001_create_donation_plans_table.php
 create mode 100644 database/seeders/DonationPlansSeeder.php

diff --git a/app/Modules/Donate/Domain/Models/DonationPlan.php b/app/Modules/Donate/Domain/Models/DonationPlan.php
new file mode 100644
index 0000000..97ea4b0
--- /dev/null
+++ b/app/Modules/Donate/Domain/Models/DonationPlan.php
@@ -0,0 +1,51 @@
+<?php
+
+namespace Modules\Donate\Domain\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+
+class DonationPlan extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'name',
+        'description',
+        'amount',
+        'dp_base',
+        'extra_pct',
+        'is_promo',
+        'active',
+        'sort_order',
+    ];
+
+    protected $casts = [
+        'amount' => 'float',
+        'dp_base' => 'integer',
+        'extra_pct' => 'integer',
+        'is_promo' => 'boolean',
+        'active' => 'boolean',
+        'sort_order' => 'integer',
+    ];
+
+    public function scopeActive($query)
+    {
+        return $query->where('active', true);
+    }
+
+    public function scopePromo($query)
+    {
+        return $query->where('is_promo', true);
+    }
+
+    public function getDpTotalAttribute(): int
+    {
+        return $this->dp_base + (int) ($this->dp_base * $this->extra_pct / 100);
+    }
+
+    public function getFormattedAmountAttribute(): string
+    {
+        return '$' . number_format($this->amount, 2);
+    }
+}
\ No newline at end of file
diff --git a/app/Modules/Donate/Http/Controllers/DonateController.php b/app/Modules/Donate/Http/Controllers/DonateController.php
index 4a41b01..e7aa7cb 100644
--- a/app/Modules/Donate/Http/Controllers/DonateController.php
+++ b/app/Modules/Donate/Http/Controllers/DonateController.php
@@ -7,54 +7,73 @@
 use Modules\Donate\Services\GatewayManager;
 use Modules\Donate\Domain\Models\DonationTransaction;
 use Illuminate\Support\Facades\DB;
+use Modules\Donate\Domain\Models\DonationPlan;
 
 class DonateController extends Controller
 {
     public function index(GatewayManager $gateways)
     {
         $available = array_map(fn($g) => ['id' => $g->id(), 'name' => $g->displayName()], $gateways->all());
-        return view('donate::home', ['gateways' => $available]);
+        $plans = DonationPlan::where('active', true)->orderBy('sort_order')->get();
+        
+        return view('donate::home', ['gateways' => $available, 'plans' => $plans]); 
     }
 
     public function checkout(Request $request, GatewayManager $gateways)
     {
         $gatewayId = $request->string('gateway')->toString();
-        $amount = (int) $request->input('amount', 0);
+        
+        if ($request->filled('plan_id')) {
+            $plan = DonationPlan::findOrFail($request->input('plan_id'));
+            $amount = (int) ($plan->amount);
+            $dpAmount = $plan->dp_total;
+        } else {
+            $amount = (int) ($request->input('amount', 0));
+            $rate = (int) config('donate.dp_rate', 100);
+            $dpAmount = (int) (($request->input('amount', 0)) * $rate);
+        }
+        
         $gateway = $gateways->get($gatewayId);
         abort_unless($gateway, 404);
+        
         $meta = ['user_id' => optional($request->user())->id];
         
         if ($request->filled('nonce')) {
             $meta['nonce'] = $request->input('nonce');
         }
+        
         $result = $gateway->createCheckout($amount, $meta);
+        
         if (isset($result['client_token'])) {
             return view('donate::braintree', ['token' => $result['client_token'], 'amount' => $amount]);
         }
+        
         if (isset($result['redirect_url'])) {
             return redirect()->away($result['redirect_url']);
         }
+        
         if (($result['status'] ?? null) === 'success') {
             $user = $request->user();
-            $rate = (int) config('donate.dp_rate', 100);
-            $dp = (int) ($amount * $rate);
             $txId = null;
-            DB::transaction(function () use ($user, $gatewayId, $amount, $dp, $result, &$txId) {
+            
+            DB::transaction(function () use ($user, $gatewayId, $amount, $dpAmount, $result, &$txId) {
                 $tx = DonationTransaction::create([
                     'user_id' => $user->id,
                     'gateway' => $gatewayId,
                     'transaction_id' => $result['transaction_id'] ?? null,
                     'amount' => $amount,
                     'currency' => 'USD',
-                    'dp_awarded' => $dp,
+                    'dp_awarded' => $dpAmount,
                     'status' => 'completed',
                     'meta' => ['raw' => $result],
                 ]);
-                $user->increment('dp', $dp);
+                $user->increment('dp', $dpAmount);
                 $txId = $tx->id;
             });
+            
             return redirect()->route('donate.receipt', ['id' => $txId]);
         }
+        
         return response()->json($result, 400);
     }
 
@@ -82,4 +101,4 @@ public function receipt(int $id)
             ->firstOrFail();
         return view('donate::receipt', ['tx' => $tx]);
     }
-}
+}
\ No newline at end of file
diff --git a/app/Modules/Donate/Infrastructure/Gateways/BraintreeGateway.php b/app/Modules/Donate/Infrastructure/Gateways/BraintreeGateway.php
index bb53f56..182c63f 100644
--- a/app/Modules/Donate/Infrastructure/Gateways/BraintreeGateway.php
+++ b/app/Modules/Donate/Infrastructure/Gateways/BraintreeGateway.php
@@ -35,7 +35,7 @@ public function createCheckout(int $amount, array $meta = []): array
     {
         if (isset($meta['nonce'])) {
             $result = $this->gateway->transaction()->sale([
-                'amount' => number_format($amount, 2, '.', ''),
+                'amount' => number_format($amount / 100, 2, '.', ''),
                 'paymentMethodNonce' => $meta['nonce'],
                 'options' => ['submitForSettlement' => true],
             ]);
diff --git a/app/Modules/Donate/Resources/views/home.blade.php b/app/Modules/Donate/Resources/views/home.blade.php
index f7e5ca9..26e3d76 100644
--- a/app/Modules/Donate/Resources/views/home.blade.php
+++ b/app/Modules/Donate/Resources/views/home.blade.php
@@ -23,72 +23,91 @@
         </div>
 
         <div class="grid md:grid-cols-3 gap-8 mb-16">
-            <!-- Bronze Package -->
-            <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-8 hover:border-orange-600/50 transition-all duration-300">
-                <div class="text-center mb-6">
-                    <div class="w-16 h-16 bg-gradient-to-br from-orange-600 to-orange-800 rounded-full flex items-center justify-center mx-auto mb-4">
-                        <i class="fas fa-medal text-2xl"></i>
-                    </div>
-                    <h3 class="text-2xl font-bold mb-2">Bronze Supporter</h3>
-                    <div class="text-4xl font-bold text-orange-500 mb-2">$5</div>
-                    <p class="text-slate-400 text-sm">One-time donation</p>
-                </div>
-                <ul class="space-y-3 mb-8">
-                    <li class="flex items-start gap-2">
-                        <i class="fas fa-check text-orange-500 mt-1"></i>
-                        <span class="text-slate-300">500 Donation Points</span>
-                    </li>
-                </ul>
-                <button class="w-full py-3 bg-gradient-to-r from-orange-600 to-orange-700 hover:from-orange-700 hover:to-orange-800 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-orange-900/30">
-                    Donate Now
-                </button>
-            </div>
-
-            <!-- Silver Package -->
-            <div class="bg-slate-900/50 border-2 border-slate-400 rounded-xl p-8 hover:border-slate-300 transition-all duration-300 relative transform md:scale-105">
-                <div class="absolute -top-4 left-1/2 transform -translate-x-1/2">
-                    <span class="bg-gradient-to-r from-blue-600 to-blue-700 px-4 py-1 rounded-full text-sm font-semibold">MOST POPULAR</span>
-                </div>
-                <div class="text-center mb-6">
-                    <div class="w-16 h-16 bg-gradient-to-br from-slate-400 to-slate-600 rounded-full flex items-center justify-center mx-auto mb-4">
-                        <i class="fas fa-crown text-2xl"></i>
+            @foreach(($plans ?? collect())->take(3) as $plan)
+                <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-8 hover:border-blue-600/50 transition-all duration-300">
+                    <div class="text-center mb-6">
+                        <div class="w-16 h-16 bg-gradient-to-br from-blue-600 to-blue-800 rounded-full flex items-center justify-center mx-auto mb-4">
+                            <i class="fas fa-gift text-2xl"></i>
+                        </div>
+                        <h3 class="text-2xl font-bold mb-2">{{ $plan->name }}</h3>
+                        <div class="text-4xl font-bold text-blue-500 mb-2">{{ $plan->formatted_amount }}</div>
+                        <p class="text-slate-400 text-sm">{{ $plan->description }}</p>
+                        @if($plan->is_promo)
+                            <span class="inline-block mt-2 bg-red-600 text-white px-3 py-1 rounded-full text-xs font-semibold">
+                                PROMO +{{ $plan->extra_pct }}%
+                            </span>
+                        @endif
                     </div>
-                    <h3 class="text-2xl font-bold mb-2">Silver Supporter</h3>
-                    <div class="text-4xl font-bold text-slate-400 mb-2">$15</div>
-                    <p class="text-slate-400 text-sm">One-time donation</p>
+                    <ul class="space-y-3 mb-8">
+                        <li class="flex items-start gap-2">
+                            <i class="fas fa-check text-blue-500 mt-1"></i>
+                            <span class="text-slate-300">{{ number_format($plan->dp_total) }} Donation Points</span>
+                        </li>
+                        @if($plan->extra_pct > 0)
+                            <li class="flex items-start gap-2">
+                                <i class="fas fa-star text-yellow-500 mt-1"></i>
+                                <span class="text-slate-300">+{{ $plan->extra_pct }}% Bonus Points</span>
+                            </li>
+                        @endif
+                    </ul>
+                    @auth
+                        <form method="POST" action="{{ route('donate.checkout') }}">
+                            @csrf
+                            <input type="hidden" name="plan_id" value="{{ $plan->id }}">
+                            <input type="hidden" name="amount" value="{{ $plan->amount }}">
+                            <input type="hidden" name="gateway" value="braintree">
+                            <button type="submit" class="w-full py-3 bg-gradient-to-r from-blue-600 to-blue-700 hover:from-blue-700 hover:to-blue-800 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-blue-900/30">
+                                Donate Now
+                            </button>
+                        </form>
+                    @else
+                        <a href="{{ route('login') }}" class="block w-full py-3 bg-slate-700 hover:bg-slate-600 rounded-lg font-semibold transition-all duration-200 text-center">
+                            Login to Donate
+                        </a>
+                    @endauth
                 </div>
-                <ul class="space-y-3 mb-8">
-                    <li class="flex items-start gap-2">
-                        <i class="fas fa-check text-slate-400 mt-1"></i>
-                        <span class="text-slate-300">1,800 Donation Points</span>
-                    </li>
-                </ul>
-                <button class="w-full py-3 bg-gradient-to-r from-slate-400 to-slate-600 hover:from-slate-500 hover:to-slate-700 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-slate-900/50">
-                    Donate Now
-                </button>
-            </div>
+            @endforeach
+        </div>
 
-            <!-- Gold Package -->
-            <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-8 hover:border-yellow-600/50 transition-all duration-300">
-                <div class="text-center mb-6">
-                    <div class="w-16 h-16 bg-gradient-to-br from-yellow-500 to-yellow-700 rounded-full flex items-center justify-center mx-auto mb-4">
-                        <i class="fas fa-gem text-2xl"></i>
-                    </div>
-                    <h3 class="text-2xl font-bold mb-2">Gold Supporter</h3>
-                    <div class="text-4xl font-bold text-yellow-500 mb-2">$30</div>
-                    <p class="text-slate-400 text-sm">One-time donation</p>
+        <!-- All Plans Grid -->
+        @if(($plans ?? collect())->count() > 3)
+            <div class="mb-16">
+                <h3 class="text-2xl font-bold mb-8 text-center">More Packages</h3>
+                <div class="grid md:grid-cols-4 gap-6">
+                    @foreach(($plans ?? collect())->skip(3) as $plan)
+                        <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-6 hover:border-blue-600/50 transition-all duration-300">
+                            <div class="text-center mb-4">
+                                <h4 class="font-bold mb-2">{{ $plan->name }}</h4>
+                                <div class="text-4xl font-bold text-blue-500 mb-2">{{ $plan->formatted_amount }}</div>
+                                @if($plan->is_promo)
+                                    <span class="inline-block bg-red-600 text-white px-2 py-1 rounded-full text-xs font-semibold">
+                                        PROMO +{{ $plan->extra_pct }}%
+                                    </span>
+                                @endif
+                            </div>
+                            <div class="text-center mb-4">
+                                <span class="text-slate-300">{{ number_format($plan->dp_total) }} DP</span>
+                            </div>
+                            @auth
+                                <form method="POST" action="{{ route('donate.checkout') }}">
+                                    @csrf
+                                    <input type="hidden" name="plan_id" value="{{ $plan->id }}">
+                                    <input type="hidden" name="amount" value="{{ $plan->amount }}">
+                                    <input type="hidden" name="gateway" value="braintree">
+                                    <button type="submit" class="w-full py-2 bg-blue-600 hover:bg-blue-700 rounded-lg font-semibold transition-all duration-200">
+                                        Donate
+                                    </button>
+                                </form>
+                            @else
+                                <a href="{{ route('login') }}" class="block w-full py-2 bg-slate-700 hover:bg-slate-600 rounded-lg font-semibold transition-all duration-200 text-center">
+                                    Login
+                                </a>
+                            @endauth
+                        </div>
+                    @endforeach
                 </div>
-                <ul class="space-y-3 mb-8">
-                    <li class="flex items-start gap-2">
-                        <i class="fas fa-check text-yellow-500 mt-1"></i>
-                        <span class="text-slate-300">4,000 Donation Points</span>
-                    </li>
-                </ul>
-                <button class="w-full py-3 bg-gradient-to-r from-yellow-600 to-yellow-700 hover:from-yellow-700 hover:to-yellow-800 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-yellow-900/30">
-                    Donate Now
-                </button>
             </div>
-        </div>
+        @endif
 
         <!-- Custom Amount Section -->
         <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-8 mb-16">
@@ -232,4 +251,4 @@
             </p>
         </div>
     </div>
-@endsection
+@endsection
\ No newline at end of file
diff --git a/config/donate.php b/config/donate.php
index 0e30611..01afac6 100644
--- a/config/donate.php
+++ b/config/donate.php
@@ -1,5 +1,7 @@
 <?php
 
+use Modules\Donate\Domain\Models\DonationPlan;
+
 return [
     /**
      * Enabled gateways for donation transactions.
@@ -42,4 +44,15 @@
             'private_key' => env('BRAINTREE_PRIVATE_KEY'),
         ],
     ],
-];
+
+    /**
+     * Donation plans configuration.
+     * 
+     * @var array|callable
+     * 
+     * Development note: Set to null to load from database.
+     * 
+     * @example 'plans' => fn() => DonationPlan::active()->orderBy('sort_order')->get(),
+     */
+    'plans' => fn() => DonationPlan::active()->orderBy('sort_order')->get(),
+];
\ No newline at end of file
diff --git a/database/migrations/2026_01_09_000001_create_donation_plans_table.php b/database/migrations/2026_01_09_000001_create_donation_plans_table.php
new file mode 100644
index 0000000..e246b41
--- /dev/null
+++ b/database/migrations/2026_01_09_000001_create_donation_plans_table.php
@@ -0,0 +1,29 @@
+<?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('donation_plans', function (Blueprint $table) {
+            $table->id();
+            $table->string('name');
+            $table->text('description')->nullable();
+            $table->decimal('amount', 10, 2); // decimal for proper price handling
+            $table->integer('dp_base'); // base donation points
+            $table->integer('extra_pct')->default(0); // extra percentage
+            $table->boolean('is_promo')->default(false);
+            $table->boolean('active')->default(true);
+            $table->integer('sort_order')->default(0);
+            $table->timestamps();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('donation_plans');
+    }
+};
\ No newline at end of file
diff --git a/database/seeders/DonationPlansSeeder.php b/database/seeders/DonationPlansSeeder.php
new file mode 100644
index 0000000..d08fa91
--- /dev/null
+++ b/database/seeders/DonationPlansSeeder.php
@@ -0,0 +1,79 @@
+<?php
+
+namespace Database\Seeders;
+
+use Illuminate\Database\Seeder;
+use Modules\Donate\Domain\Models\DonationPlan;
+
+class DonationPlansSeeder extends Seeder
+{
+    public function run(): void
+    {
+        $plans = [
+            [
+                'name' => 'Bronze',
+                'description' => 'Perfect starter package',
+                'amount' => 5.00,
+                'dp_base' => 500,
+                'extra_pct' => 0,
+                'is_promo' => false,
+                'active' => true,
+                'sort_order' => 1,
+            ],
+            [
+                'name' => 'Silver',
+                'description' => 'Great value package',
+                'amount' => 10.00,
+                'dp_base' => 1100,
+                'extra_pct' => 10,
+                'is_promo' => false,
+                'active' => true,
+                'sort_order' => 2,
+            ],
+            [
+                'name' => 'Gold',
+                'description' => 'Premium package with bonus',
+                'amount' => 25.00,
+                'dp_base' => 3000,
+                'extra_pct' => 20,
+                'is_promo' => false,
+                'active' => true,
+                'sort_order' => 3,
+            ],
+            [
+                'name' => 'Platinum',
+                'description' => 'Ultimate package with maximum bonus',
+                'amount' => 50.00,
+                'dp_base' => 6500,
+                'extra_pct' => 30,
+                'is_promo' => false,
+                'active' => true,
+                'sort_order' => 4,
+            ],
+            [
+                'name' => 'Diamond',
+                'description' => 'Exclusive package with VIP benefits',
+                'amount' => 100.00,
+                'dp_base' => 15000,
+                'extra_pct' => 50,
+                'is_promo' => false,
+                'active' => true,
+                'sort_order' => 5,
+            ],
+            [
+                'name' => 'Weekend Special',
+                'description' => 'Limited time offer! 50% extra points',
+                'amount' => 15.00,
+                'dp_base' => 1500,
+                'extra_pct' => 50,
+                'is_promo' => true,
+                'active' => true,
+                'sort_order' => 6,
+            ],
+        ];
+
+        foreach ($plans as $plan) {
+            DonationPlan::create($plan);
+        }
+    }
+}
\ No newline at end of file

From b7b9bc1992d5ab686a35027173adf25af6d16abc Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 11 Jan 2026 01:25:43 +0100
Subject: [PATCH 031/132] refactor(donate): change amount handling to use
 decimal values

- Update transaction amount to use decimal type in database
- Modify payment gateway interface to accept float amounts
- Remove number formatting from receipt view
- Adjust donation plan amounts and seeding values
---
 .../Donate/Domain/Interfaces/PaymentGatewayInterface.php    | 2 +-
 app/Modules/Donate/Http/Controllers/DonateController.php    | 4 ++--
 .../Donate/Infrastructure/Gateways/BraintreeGateway.php     | 4 ++--
 app/Modules/Donate/Resources/views/receipt.blade.php        | 2 +-
 ...2026_01_07_000002_create_donation_transactions_table.php | 2 +-
 .../2026_01_09_000001_create_donation_plans_table.php       | 6 +++---
 database/seeders/DonationPlansSeeder.php                    | 6 +++---
 7 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/app/Modules/Donate/Domain/Interfaces/PaymentGatewayInterface.php b/app/Modules/Donate/Domain/Interfaces/PaymentGatewayInterface.php
index 87f5b90..f8419ed 100644
--- a/app/Modules/Donate/Domain/Interfaces/PaymentGatewayInterface.php
+++ b/app/Modules/Donate/Domain/Interfaces/PaymentGatewayInterface.php
@@ -8,7 +8,7 @@ interface PaymentGatewayInterface
 {
     public function id(): string;
     public function displayName(): string;
-    public function createCheckout(int $amount, array $meta = []): array;
+    public function createCheckout(float $amount, array $meta = []): array;
     public function handleCallback(Request $request): array;
     public function handleWebhook(Request $request): array;
 }
diff --git a/app/Modules/Donate/Http/Controllers/DonateController.php b/app/Modules/Donate/Http/Controllers/DonateController.php
index e7aa7cb..9af58bf 100644
--- a/app/Modules/Donate/Http/Controllers/DonateController.php
+++ b/app/Modules/Donate/Http/Controllers/DonateController.php
@@ -25,10 +25,10 @@ public function checkout(Request $request, GatewayManager $gateways)
         
         if ($request->filled('plan_id')) {
             $plan = DonationPlan::findOrFail($request->input('plan_id'));
-            $amount = (int) ($plan->amount);
+            $amount = $plan->amount;
             $dpAmount = $plan->dp_total;
         } else {
-            $amount = (int) ($request->input('amount', 0));
+            $amount = $request->input('amount', 0);
             $rate = (int) config('donate.dp_rate', 100);
             $dpAmount = (int) (($request->input('amount', 0)) * $rate);
         }
diff --git a/app/Modules/Donate/Infrastructure/Gateways/BraintreeGateway.php b/app/Modules/Donate/Infrastructure/Gateways/BraintreeGateway.php
index 182c63f..76c134c 100644
--- a/app/Modules/Donate/Infrastructure/Gateways/BraintreeGateway.php
+++ b/app/Modules/Donate/Infrastructure/Gateways/BraintreeGateway.php
@@ -31,11 +31,11 @@ public function displayName(): string
         return 'Braintree';
     }
 
-    public function createCheckout(int $amount, array $meta = []): array
+    public function createCheckout(float $amount, array $meta = []): array
     {
         if (isset($meta['nonce'])) {
             $result = $this->gateway->transaction()->sale([
-                'amount' => number_format($amount / 100, 2, '.', ''),
+                'amount' => $amount,
                 'paymentMethodNonce' => $meta['nonce'],
                 'options' => ['submitForSettlement' => true],
             ]);
diff --git a/app/Modules/Donate/Resources/views/receipt.blade.php b/app/Modules/Donate/Resources/views/receipt.blade.php
index f90bbfc..448b035 100644
--- a/app/Modules/Donate/Resources/views/receipt.blade.php
+++ b/app/Modules/Donate/Resources/views/receipt.blade.php
@@ -30,7 +30,7 @@
             </div>
             <div>
                 <div class="text-sm text-slate-400">Amount</div>
-                <div class="font-semibold text-white">${{ number_format($tx->amount, 2) }} {{ $tx->currency }}</div>
+                <div class="font-semibold text-white">${{ $tx->amount }} {{ $tx->currency }}</div>
             </div>
             <div>
                 <div class="text-sm text-slate-400">DP Awarded</div>
diff --git a/database/migrations/2026_01_07_000002_create_donation_transactions_table.php b/database/migrations/2026_01_07_000002_create_donation_transactions_table.php
index 609bbaa..1fe18da 100644
--- a/database/migrations/2026_01_07_000002_create_donation_transactions_table.php
+++ b/database/migrations/2026_01_07_000002_create_donation_transactions_table.php
@@ -13,7 +13,7 @@ public function up(): void
             $table->unsignedBigInteger('user_id');
             $table->string('gateway', 64);
             $table->string('transaction_id', 128)->nullable();
-            $table->unsignedInteger('amount'); // in whole currency units (e.g., USD)
+            $table->decimal('amount', 10, 2);
             $table->string('currency', 8)->default('USD');
             $table->unsignedInteger('dp_awarded')->default(0);
             $table->string('status', 32)->default('pending');
diff --git a/database/migrations/2026_01_09_000001_create_donation_plans_table.php b/database/migrations/2026_01_09_000001_create_donation_plans_table.php
index e246b41..052ca9f 100644
--- a/database/migrations/2026_01_09_000001_create_donation_plans_table.php
+++ b/database/migrations/2026_01_09_000001_create_donation_plans_table.php
@@ -12,9 +12,9 @@ public function up(): void
             $table->id();
             $table->string('name');
             $table->text('description')->nullable();
-            $table->decimal('amount', 10, 2); // decimal for proper price handling
-            $table->integer('dp_base'); // base donation points
-            $table->integer('extra_pct')->default(0); // extra percentage
+            $table->decimal('amount', 10, 2);
+            $table->integer('dp_base');
+            $table->integer('extra_pct')->default(0);
             $table->boolean('is_promo')->default(false);
             $table->boolean('active')->default(true);
             $table->integer('sort_order')->default(0);
diff --git a/database/seeders/DonationPlansSeeder.php b/database/seeders/DonationPlansSeeder.php
index d08fa91..24ad2e3 100644
--- a/database/seeders/DonationPlansSeeder.php
+++ b/database/seeders/DonationPlansSeeder.php
@@ -13,7 +13,7 @@ public function run(): void
             [
                 'name' => 'Bronze',
                 'description' => 'Perfect starter package',
-                'amount' => 5.00,
+                'amount' => 4.50,
                 'dp_base' => 500,
                 'extra_pct' => 0,
                 'is_promo' => false,
@@ -33,7 +33,7 @@ public function run(): void
             [
                 'name' => 'Gold',
                 'description' => 'Premium package with bonus',
-                'amount' => 25.00,
+                'amount' => 25.50,
                 'dp_base' => 3000,
                 'extra_pct' => 20,
                 'is_promo' => false,
@@ -53,7 +53,7 @@ public function run(): void
             [
                 'name' => 'Diamond',
                 'description' => 'Exclusive package with VIP benefits',
-                'amount' => 100.00,
+                'amount' => 95.25,
                 'dp_base' => 15000,
                 'extra_pct' => 50,
                 'is_promo' => false,

From ae93a412df54e29a002b69aada844573ce72efec Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 11 Jan 2026 02:02:09 +0100
Subject: [PATCH 032/132] fix(home): add conditional check for featured news
 image

---
 resources/views/home/index.blade.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/resources/views/home/index.blade.php b/resources/views/home/index.blade.php
index 1a5dea1..6814875 100755
--- a/resources/views/home/index.blade.php
+++ b/resources/views/home/index.blade.php
@@ -97,7 +97,9 @@ class="absolute top-1/2 left-1/2 w-80 h-80 rounded-full bg-cyan-500/10 opacity-5
 
                 <div id="features" class="bg-slate-800/50 backdrop-blur-sm rounded-2xl overflow-hidden border border-slate-700/50 hover:border-blue-500/50">
                     <div class="relative">
+                        @if(!empty($data['featuredNews']->image))
                         <img src="{{ asset('storage/images/' . $data['featuredNews']->image) }}" alt="{{ $data['featuredNews']->title }}" class="w-full h-64 object-cover group-hover:scale-105 transition-transform duration-500">
+                        @endif
                         <div class="absolute top-4 left-4">
                             <span class="bg-blue-600 text-white text-xs font-bold px-3 py-1 rounded-full uppercase tracking-wide">Featured</span>
                         </div>

From 1296d1070b7e4a46a3de054248f7461c6ae9b775 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 11 Jan 2026 02:28:23 +0100
Subject: [PATCH 033/132] fix(views): add conditional check for featuredNews
 existence.

---
 resources/views/home/index.blade.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/resources/views/home/index.blade.php b/resources/views/home/index.blade.php
index 6814875..f80fbe1 100755
--- a/resources/views/home/index.blade.php
+++ b/resources/views/home/index.blade.php
@@ -95,6 +95,7 @@ class="absolute top-1/2 left-1/2 w-80 h-80 rounded-full bg-cyan-500/10 opacity-5
                     <p class="text-slate-400 text-lg">Stay up to date with the latest server news, events, and updates.</p>
                 </div>
 
+                @if(!empty($data['featuredNews']))
                 <div id="features" class="bg-slate-800/50 backdrop-blur-sm rounded-2xl overflow-hidden border border-slate-700/50 hover:border-blue-500/50">
                     <div class="relative">
                         @if(!empty($data['featuredNews']->image))
@@ -116,6 +117,7 @@ class="absolute top-1/2 left-1/2 w-80 h-80 rounded-full bg-cyan-500/10 opacity-5
                         </a>
                     </div>
                 </div>
+                @endif
 
                 <div class="grid md:grid-cols-2 gap-6">
                     @foreach($data['news'] as $item)

From 953e6c3334d908987802b54f4bbba21acc93c882 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 11 Jan 2026 02:49:59 +0100
Subject: [PATCH 034/132] fix(views): replace foreach with forelse to handle
 empty news array.

---
 resources/views/home/index.blade.php | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/resources/views/home/index.blade.php b/resources/views/home/index.blade.php
index f80fbe1..5a8d25b 100755
--- a/resources/views/home/index.blade.php
+++ b/resources/views/home/index.blade.php
@@ -120,7 +120,7 @@ class="absolute top-1/2 left-1/2 w-80 h-80 rounded-full bg-cyan-500/10 opacity-5
                 @endif
 
                 <div class="grid md:grid-cols-2 gap-6">
-                    @foreach($data['news'] as $item)
+                    @forelse($data['news'] as $item)
                     <div class="bg-slate-800/30 backdrop-blur-sm rounded-xl p-5 border border-slate-700/50 hover:border-slate-600 cursor-pointer">
                         <div class="text-xs text-slate-400 mb-2">{{ $item->published_at->format('F d, Y') }}</div>
                         <h4 class="text-lg font-bold text-white mb-2 group-hover:text-blue-400 transition-colors">{{ $item->title }}</h4>
@@ -132,7 +132,11 @@ class="absolute top-1/2 left-1/2 w-80 h-80 rounded-full bg-cyan-500/10 opacity-5
                             </svg>
                         </a>
                     </div>
-                    @endforeach
+                    @empty
+                    <div class="bg-slate-800/30 backdrop-blur-sm rounded-xl p-5 border border-slate-700/50 hover:border-slate-600 cursor-pointer">
+                        <p class="text-slate-400 text-sm">No news available.</p>
+                    </div>
+                    @endforelse
                 </div>
 
                 <div class="text-center pt-4">

From 86c3651494dc5f15906ab1c3567c5bac1526a428 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 11 Jan 2026 14:34:12 +0100
Subject: [PATCH 035/132] fix(donations): handle empty transactions case in
 donations view

---
 resources/views/ucp/donations.blade.php | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/resources/views/ucp/donations.blade.php b/resources/views/ucp/donations.blade.php
index dbad09a..c194968 100644
--- a/resources/views/ucp/donations.blade.php
+++ b/resources/views/ucp/donations.blade.php
@@ -1,7 +1,6 @@
 @extends('layouts.main')
 
 @section('content')
-
 <div class="max-w-7xl mx-auto px-6 sm:px-6 lg:px-8 py-8 pt-24">
     <div class="grid grid-cols-1 lg:grid-cols-4 gap-6">
         @include('ucp.components.sidebar')
@@ -17,7 +16,7 @@
                         </div>
                     </div>
                     <p class="text-sm text-gray-400 mb-1">Total Donated</p>
-                    <p class="text-3xl font-bold text-white">{{ number_format($transactions->sum('amount'), 2) }}</p>
+                    <p class="text-3xl font-bold text-white">{{ $transactions->isEmpty() ? '0.00' : number_format($transactions->sum('amount'), 2) }}</p>
                 </div>
 
                 <!-- Total Coins -->
@@ -28,7 +27,7 @@
                         </div>
                     </div>
                     <p class="text-sm text-gray-400 mb-1">Total Coins Earned</p>
-                    <p class="text-3xl font-bold text-white">{{ number_format($transactions->sum('dp_awarded')) }}</p>
+                    <p class="text-3xl font-bold text-white">{{ $transactions->isEmpty() ? '0' : number_format($transactions->sum('dp_awarded')) }}</p>
                 </div>
 
                 <!-- Transactions -->
@@ -39,7 +38,7 @@
                         </div>
                     </div>
                     <p class="text-sm text-gray-400 mb-1">Total Transactions</p>
-                    <p class="text-3xl font-bold text-white">{{ number_format($transactions->count()) }}</p>
+                    <p class="text-3xl font-bold text-white">{{ $transactions->isEmpty() ? '0' : number_format($transactions->count()) }}</p>
                 </div>
             </div>
 
@@ -145,4 +144,5 @@
             </div>
         </main>
     </div>
-</div>
\ No newline at end of file
+</div>
+@endsection
\ No newline at end of file

From 8bfcbe43ceb2c977e911935946c0003fecb99d27 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 22 Jan 2026 00:40:57 +0100
Subject: [PATCH 036/132] feat(admin): implement admin module with roles,
 permissions and dashboard

- Add Admin module with service providers, routes and controllers
- Implement role and permission management with CRUD operations
- Create admin dashboard with stats, activity feed and version checking
- Add drag-and-drop interface for assigning permissions to roles
- Include responsive layout with sidebar navigation
---
 .../Http/Controllers/AdminController.php      |  26 ++
 .../Http/Controllers/PermissionController.php |  16 +
 .../Admin/Http/Controllers/RoleController.php |  65 +++
 app/Modules/Admin/Http/routes.php             |  18 +
 .../Admin/Providers/AdminServiceProvider.php  |  10 +
 .../Admin/Resources/views/index.blade.php     | 370 ++++++++++++++++
 .../Resources/views/layouts/app.blade.php     | 171 ++++++++
 .../views/permissions/index.blade.php         |  78 ++++
 .../Resources/views/roles/create.blade.php    | 150 +++++++
 .../Resources/views/roles/edit.blade.php      | 173 ++++++++
 .../Resources/views/roles/index.blade.php     |  57 +++
 app/Modules/Admin/Services/apiService.php     |  46 ++
 app/Modules/Admin/module.json                 |   8 +
 .../Http/Controllers/DonateController.php     |   2 +-
 .../Http/Controllers/StoreController.php      |  13 +
 app/Modules/Store/Http/routes.php             |   9 +
 .../Store/Providers/StoreServiceProvider.php  |  10 +
 .../Store/Resources/views/store.blade.php     | 398 ++++++++++++++++++
 app/Modules/Store/module.json                 |   8 +
 config/app.php                                |   9 +
 20 files changed, 1636 insertions(+), 1 deletion(-)
 create mode 100644 app/Modules/Admin/Http/Controllers/AdminController.php
 create mode 100644 app/Modules/Admin/Http/Controllers/PermissionController.php
 create mode 100644 app/Modules/Admin/Http/Controllers/RoleController.php
 create mode 100644 app/Modules/Admin/Http/routes.php
 create mode 100644 app/Modules/Admin/Providers/AdminServiceProvider.php
 create mode 100644 app/Modules/Admin/Resources/views/index.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/layouts/app.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/permissions/index.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/roles/create.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/roles/edit.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/roles/index.blade.php
 create mode 100644 app/Modules/Admin/Services/apiService.php
 create mode 100644 app/Modules/Admin/module.json
 create mode 100644 app/Modules/Store/Http/Controllers/StoreController.php
 create mode 100644 app/Modules/Store/Http/routes.php
 create mode 100644 app/Modules/Store/Providers/StoreServiceProvider.php
 create mode 100644 app/Modules/Store/Resources/views/store.blade.php
 create mode 100644 app/Modules/Store/module.json

diff --git a/app/Modules/Admin/Http/Controllers/AdminController.php b/app/Modules/Admin/Http/Controllers/AdminController.php
new file mode 100644
index 0000000..7a9796a
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/AdminController.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use Modules\Admin\Services\ApiService;
+
+class AdminController extends Controller
+{
+    protected ApiService $apiService;
+
+    public function __construct(ApiService $apiService)
+    {
+        $this->apiService = $apiService;
+    }
+
+    public function index()
+    {
+        $latestRelease = $this->apiService->latestRelease();
+        $checkVersion = $this->apiService->checkVersion('wow-cms', 'nexuscms', config('app.version'));
+
+        $outdated = $checkVersion['outdated'];
+
+        return view('admin::index', compact('latestRelease', 'checkVersion', 'outdated'));  
+    }
+}
diff --git a/app/Modules/Admin/Http/Controllers/PermissionController.php b/app/Modules/Admin/Http/Controllers/PermissionController.php
new file mode 100644
index 0000000..0764952
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/PermissionController.php
@@ -0,0 +1,16 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use Spatie\Permission\Models\Permission;
+
+class PermissionController extends Controller
+{
+    public function index()
+    {
+        $permissions = Permission::query()->orderBy('name')->get();
+        return view('admin::permissions.index', compact('permissions'));
+    }
+}
+
diff --git a/app/Modules/Admin/Http/Controllers/RoleController.php b/app/Modules/Admin/Http/Controllers/RoleController.php
new file mode 100644
index 0000000..693ed02
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/RoleController.php
@@ -0,0 +1,65 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Spatie\Permission\Models\Role;
+use Spatie\Permission\Models\Permission;
+
+class RoleController extends Controller
+{
+    public function index()
+    {
+        $roles = Role::query()->withCount('permissions')->orderBy('name')->get();
+        return view('admin::roles.index', compact('roles'));
+    }
+
+    public function create()
+    {
+        $permissions = Permission::query()->orderBy('name')->get();
+        return view('admin::roles.create', compact('permissions'));
+    }
+
+    public function store(Request $request)
+    {
+        $validated = $request->validate([
+            'name' => ['required', 'string', 'max:100', 'unique:roles,name'],
+            'permissions' => ['array'],
+            'permissions.*' => ['string', 'exists:permissions,name'],
+        ]);
+
+        $role = Role::create(['name' => $validated['name']]);
+
+        $perms = $validated['permissions'] ?? [];
+        if (!empty($perms)) {
+            $role->givePermissionTo($perms);
+        }
+
+        return redirect()->route('admin.roles.index')->with('success', 'Rol creado correctamente.');
+    }
+
+    public function edit(Role $role)
+    {
+        $permissions = Permission::query()->orderBy('name')->get();
+        $selected = $role->permissions()->pluck('name')->toArray();
+        return view('admin::roles.edit', compact('role', 'permissions', 'selected'));
+    }
+
+    public function update(Request $request, Role $role)
+    {
+        $validated = $request->validate([
+            'name' => ['required', 'string', 'max:100', 'unique:roles,name,' . $role->id],
+            'permissions' => ['array'],
+            'permissions.*' => ['string', 'exists:permissions,name'],
+        ]);
+
+        $role->name = $validated['name'];
+        $role->save();
+
+        $perms = $validated['permissions'] ?? [];
+        $role->syncPermissions($perms);
+
+        return redirect()->route('admin.roles.index')->with('success', 'Rol actualizado correctamente.');
+    }
+}
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
new file mode 100644
index 0000000..4a2c759
--- /dev/null
+++ b/app/Modules/Admin/Http/routes.php
@@ -0,0 +1,18 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+
+
+Route::middleware(['auth', 'role:Admin', 'web'])
+    ->prefix(strtolower('acp'))
+    ->group(function () {
+        Route::get('/', [\Modules\Admin\Http\Controllers\AdminController::class, 'index']);
+        Route::get('/permissions', [\Modules\Admin\Http\Controllers\PermissionController::class, 'index'])->name('admin.permissions');
+        
+        // Roles
+        Route::get('/roles', [\Modules\Admin\Http\Controllers\RoleController::class, 'index'])->name('admin.roles.index');
+        Route::get('/roles/create', [\Modules\Admin\Http\Controllers\RoleController::class, 'create'])->name('admin.roles.create');
+        Route::post('/roles', [\Modules\Admin\Http\Controllers\RoleController::class, 'store'])->name('admin.roles.store');
+        Route::get('/roles/{role}/edit', [\Modules\Admin\Http\Controllers\RoleController::class, 'edit'])->name('admin.roles.edit');
+        Route::put('/roles/{role}', [\Modules\Admin\Http\Controllers\RoleController::class, 'update'])->name('admin.roles.update');
+    });
diff --git a/app/Modules/Admin/Providers/AdminServiceProvider.php b/app/Modules/Admin/Providers/AdminServiceProvider.php
new file mode 100644
index 0000000..9f82477
--- /dev/null
+++ b/app/Modules/Admin/Providers/AdminServiceProvider.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace Modules\Admin\Providers;
+
+use App\Providers\BaseModuleServiceProvider;
+
+class AdminServiceProvider extends BaseModuleServiceProvider
+{
+    protected string $moduleName = 'Admin';
+}
\ No newline at end of file
diff --git a/app/Modules/Admin/Resources/views/index.blade.php b/app/Modules/Admin/Resources/views/index.blade.php
new file mode 100644
index 0000000..06ef1ae
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/index.blade.php
@@ -0,0 +1,370 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Admin Dashboard')
+
+@section('content')
+<!-- Top Bar -->
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <button class="md:hidden text-gray-600">
+            <i class="fas fa-bars text-xl"></i>
+        </button>
+        <h1 class="text-2xl font-bold text-gray-800">Dashboard</h1>
+    </div>
+    <div class="flex items-center gap-4">
+        <div class="relative">
+            <input type="search" placeholder="Search..." class="pl-10 pr-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 w-64">
+            <i class="fas fa-search absolute left-3 top-1/2 -translate-y-1/2 text-gray-400"></i>
+        </div>
+        <button class="relative text-gray-600 hover:text-gray-800">
+            <i class="fas fa-bell text-xl"></i>
+            <span class="absolute -top-1 -right-1 w-5 h-5 bg-red-500 rounded-full text-white text-xs flex items-center justify-center">3</span>
+        </button>
+        <a href="#" class="text-gray-600 hover:text-gray-800">
+            <i class="fas fa-external-link-alt text-xl"></i>
+        </a>
+    </div>
+</header>
+
+<!-- Content Area -->
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <!-- Stats Grid -->
+    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6 mb-6">
+        <!-- Stat Card 1 -->
+        <div class="bg-white rounded-lg shadow p-6">
+            <div class="flex items-center justify-between mb-4">
+                <div class="w-12 h-12 bg-blue-100 rounded-lg flex items-center justify-center">
+                    <i class="fas fa-users text-2xl text-blue-600"></i>
+                </div>
+                <span class="text-sm font-medium text-green-600 flex items-center gap-1">
+                    <i class="fas fa-arrow-up"></i> 12%
+                </span>
+            </div>
+            <h3 class="text-gray-500 text-sm font-medium mb-1">Total Accounts</h3>
+            <p class="text-3xl font-bold text-gray-800">15,430</p>
+        </div>
+
+        <!-- Stat Card 2 -->
+        <div class="bg-white rounded-lg shadow p-6">
+            <div class="flex items-center justify-between mb-4">
+                <div class="w-12 h-12 bg-green-100 rounded-lg flex items-center justify-center">
+                    <i class="fas fa-circle text-2xl text-green-600"></i>
+                </div>
+                <span class="text-sm font-medium text-green-600 flex items-center gap-1">
+                    <i class="fas fa-arrow-up"></i> 8%
+                </span>
+            </div>
+            <h3 class="text-gray-500 text-sm font-medium mb-1">Online Players</h3>
+            <p class="text-3xl font-bold text-gray-800">1,250</p>
+        </div>
+
+        <!-- Stat Card 3 -->
+        <div class="bg-white rounded-lg shadow p-6">
+            <div class="flex items-center justify-between mb-4">
+                <div class="w-12 h-12 bg-yellow-100 rounded-lg flex items-center justify-center">
+                    <i class="fas fa-dollar-sign text-2xl text-yellow-600"></i>
+                </div>
+                <span class="text-sm font-medium text-green-600 flex items-center gap-1">
+                    <i class="fas fa-arrow-up"></i> 24%
+                </span>
+            </div>
+            <h3 class="text-gray-500 text-sm font-medium mb-1">Revenue (Month)</h3>
+            <p class="text-3xl font-bold text-gray-800">$8,420</p>
+        </div>
+
+        <!-- Stat Card 4 -->
+        <div class="bg-white rounded-lg shadow p-6">
+            <div class="flex items-center justify-between mb-4">
+                <div class="w-12 h-12 bg-purple-100 rounded-lg flex items-center justify-center">
+                    <i class="fas fa-server text-2xl text-purple-600"></i>
+                </div>
+                <span class="text-sm font-medium text-green-600 flex items-center gap-1">
+                    <i class="fas fa-check"></i> Stable
+                </span>
+            </div>
+            <h3 class="text-gray-500 text-sm font-medium mb-1">Server Uptime</h3>
+            <p class="text-3xl font-bold text-gray-800">99.8%</p>
+        </div>
+    </div>
+
+    <!-- Main Grid -->
+    <div class="grid lg:grid-cols-3 gap-6">
+        <!-- Left Column -->
+        <div class="lg:col-span-2 space-y-6">
+            <!-- Quick Actions -->
+            <div class="bg-white rounded-lg shadow">
+                <div class="p-6 border-b border-gray-200">
+                    <h2 class="text-lg font-bold text-gray-800">Quick Actions</h2>
+                </div>
+                <div class="p-6">
+                    <div class="grid md:grid-cols-3 gap-4">
+                        <button class="flex items-center gap-3 p-4 border-2 border-gray-200 rounded-lg hover:border-blue-500 hover:bg-blue-50 transition">
+                            <i class="fas fa-plus-circle text-blue-600 text-xl"></i>
+                            <span class="font-semibold text-gray-700">Create News</span>
+                        </button>
+                        <button class="flex items-center gap-3 p-4 border-2 border-gray-200 rounded-lg hover:border-green-500 hover:bg-green-50 transition">
+                            <i class="fas fa-user-plus text-green-600 text-xl"></i>
+                            <span class="font-semibold text-gray-700">Add Account</span>
+                        </button>
+                        <button class="flex items-center gap-3 p-4 border-2 border-gray-200 rounded-lg hover:border-purple-500 hover:bg-purple-50 transition">
+                            <i class="fas fa-envelope text-purple-600 text-xl"></i>
+                            <span class="font-semibold text-gray-700">Send Mail</span>
+                        </button>
+                        <button class="flex items-center gap-3 p-4 border-2 border-gray-200 rounded-lg hover:border-red-500 hover:bg-red-50 transition">
+                            <i class="fas fa-ban text-red-600 text-xl"></i>
+                            <span class="font-semibold text-gray-700">Ban Player</span>
+                        </button>
+                        <button class="flex items-center gap-3 p-4 border-2 border-gray-200 rounded-lg hover:border-yellow-500 hover:bg-yellow-50 transition">
+                            <i class="fas fa-box text-yellow-600 text-xl"></i>
+                            <span class="font-semibold text-gray-700">Add Item</span>
+                        </button>
+                        <button class="flex items-center gap-3 p-4 border-2 border-gray-200 rounded-lg hover:border-cyan-500 hover:bg-cyan-50 transition">
+                            <i class="fas fa-sync text-cyan-600 text-xl"></i>
+                            <span class="font-semibold text-gray-700">Restart Realm</span>
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Recent Activity -->
+            <div class="bg-white rounded-lg shadow">
+                <div class="p-6 border-b border-gray-200 flex items-center justify-between">
+                    <h2 class="text-lg font-bold text-gray-800">Recent Activity</h2>
+                    <a href="#" class="text-sm text-blue-600 hover:text-blue-700">View All</a>
+                </div>
+                <div class="p-6">
+                    <div class="space-y-4">
+                        <div class="flex items-start gap-4">
+                            <div class="w-10 h-10 bg-green-100 rounded-lg flex items-center justify-center flex-shrink-0">
+                                <i class="fas fa-user-plus text-green-600"></i>
+                            </div>
+                            <div class="flex-1">
+                                <p class="font-semibold text-gray-800">New Registration</p>
+                                <p class="text-sm text-gray-600">PlayerName123 created an account</p>
+                                <p class="text-xs text-gray-400 mt-1">2 minutes ago</p>
+                            </div>
+                        </div>
+                        <div class="flex items-start gap-4">
+                            <div class="w-10 h-10 bg-yellow-100 rounded-lg flex items-center justify-center flex-shrink-0">
+                                <i class="fas fa-shopping-cart text-yellow-600"></i>
+                            </div>
+                            <div class="flex-1">
+                                <p class="font-semibold text-gray-800">Store Purchase</p>
+                                <p class="text-sm text-gray-600">Player purchased Level 80 Boost for $35</p>
+                                <p class="text-xs text-gray-400 mt-1">15 minutes ago</p>
+                            </div>
+                        </div>
+                        <div class="flex items-start gap-4">
+                            <div class="w-10 h-10 bg-red-100 rounded-lg flex items-center justify-center flex-shrink-0">
+                                <i class="fas fa-ban text-red-600"></i>
+                            </div>
+                            <div class="flex-1">
+                                <p class="font-semibold text-gray-800">Ban Applied</p>
+                                <p class="text-sm text-gray-600">Hacker99 banned for botting (permanent)</p>
+                                <p class="text-xs text-gray-400 mt-1">1 hour ago</p>
+                            </div>
+                        </div>
+                        <div class="flex items-start gap-4">
+                            <div class="w-10 h-10 bg-blue-100 rounded-lg flex items-center justify-center flex-shrink-0">
+                                <i class="fas fa-newspaper text-blue-600"></i>
+                            </div>
+                            <div class="flex-1">
+                                <p class="font-semibold text-gray-800">News Published</p>
+                                <p class="text-sm text-gray-600">New patch notes released by Admin</p>
+                                <p class="text-xs text-gray-400 mt-1">3 hours ago</p>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Realms Status -->
+            <div class="bg-white rounded-lg shadow">
+                <div class="p-6 border-b border-gray-200">
+                    <h2 class="text-lg font-bold text-gray-800">Realms Status</h2>
+                </div>
+                <div class="p-6">
+                    <div class="space-y-4">
+                        <div class="flex items-center justify-between p-4 bg-gray-50 rounded-lg">
+                            <div class="flex items-center gap-4">
+                                <div class="w-3 h-3 bg-green-500 rounded-full"></div>
+                                <div>
+                                    <p class="font-bold text-gray-800">Realm 1 - FireStorm</p>
+                                    <p class="text-sm text-gray-600">Version 3.3.5a | 850 players</p>
+                                </div>
+                            </div>
+                            <div class="flex items-center gap-2">
+                                <button class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">Manage</button>
+                                <button class="px-3 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300">
+                                    <i class="fas fa-sync"></i>
+                                </button>
+                            </div>
+                        </div>
+                        <div class="flex items-center justify-between p-4 bg-gray-50 rounded-lg">
+                            <div class="flex items-center gap-4">
+                                <div class="w-3 h-3 bg-green-500 rounded-full"></div>
+                                <div>
+                                    <p class="font-bold text-gray-800">Realm 2 - Frostmourne</p>
+                                    <p class="text-sm text-gray-600">Version 3.3.5a | 320 players</p>
+                                </div>
+                            </div>
+                            <div class="flex items-center gap-2">
+                                <button class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">Manage</button>
+                                <button class="px-3 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300">
+                                    <i class="fas fa-sync"></i>
+                                </button>
+                            </div>
+                        </div>
+                        <div class="flex items-center justify-between p-4 bg-gray-50 rounded-lg">
+                            <div class="flex items-center gap-4">
+                                <div class="w-3 h-3 bg-green-500 rounded-full"></div>
+                                <div>
+                                    <p class="font-bold text-gray-800">Realm 3 - IceCrown</p>
+                                    <p class="text-sm text-gray-600">Version 3.3.5a | 80 players</p>
+                                </div>
+                            </div>
+                            <div class="flex items-center gap-2">
+                                <button class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">Manage</button>
+                                <button class="px-3 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300">
+                                    <i class="fas fa-sync"></i>
+                                </button>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Right Column -->
+        <div class="space-y-6">
+            <!-- CMS Update and version -->
+            <!-- CMS Update & Version -->
+            <div class="bg-gradient-to-br from-blue-50 to-indigo-50 rounded-xl shadow-lg border border-blue-100 overflow-hidden">
+                <div class="px-6 py-4 bg-white/60 backdrop-blur-sm border-b border-blue-100 flex items-center justify-between">
+                    <h2 class="text-lg font-bold text-gray-800 flex items-center gap-2">
+                        <i class="fas fa-rocket text-blue-600"></i>
+                        System Update
+                    </h2>
+                    <span class="px-3 py-1 bg-green-100 text-green-700 rounded-full text-xs font-semibold shadow-sm">v{{ config('app.version') }}</span>
+                </div>
+                <div class="p-6">
+                    @if($outdated)
+                    <div class="flex items-start gap-4">
+                        <div class="w-12 h-12 bg-gradient-to-br from-blue-500 to-indigo-600 rounded-xl flex items-center justify-center shadow-md">
+                            <i class="fas fa-rocket text-white text-xl"></i>
+                        </div>
+                        <div class="flex-1">
+                            <p class="text-base text-gray-800 font-semibold mb-1">NexusCMS v{{ $latestRelease['tag_name'] ?? 'N/A' }} is now available</p>
+                            <p class="text-sm text-gray-600 mb-3">{{ $latestRelease['body'] ?? 'N/A' }}</p>
+                            <div class="flex items-center gap-3">
+                                <a href="{{ $latestRelease['html_url'] ?? '#' }}" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
+                                <span class="text-gray-300">•</span>
+                                <a href="#" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Update now</a>
+                            </div>
+                        </div>
+                    </div>
+                    @else
+                    <div class="flex items-start gap-4">
+                        <div class="w-12 h-12 bg-gradient-to-br from-blue-500 to-indigo-600 rounded-xl flex items-center justify-center shadow-md">
+                            <i class="fas fa-rocket text-white text-xl"></i>
+                        </div>
+                        <div class="flex-1">
+                            <p class="text-base text-gray-800 font-semibold mb-1">You are using the latest version</p>
+                            <p class="text-sm text-gray-600">Version {{ $latestRelease['tag_name'] ?? 'N/A' }}</p>
+                            <p class="text-sm text-gray-600">Released on {{ $latestRelease['published_at'] ?? 'N/A' }}</p>
+                            <div class="flex items-center gap-3">
+                                <a href="{{ $latestRelease['html_url'] ?? '#' }}" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
+                                <span class="text-gray-300">•</span>
+                            </div>
+                        </div>
+                    </div>
+                    @endif
+                </div>
+            </div>
+
+            <!-- Pending Reports -->
+            <div class="bg-white rounded-lg shadow">
+                <div class="p-6 border-b border-gray-200 flex items-center justify-between">
+                    <h2 class="text-lg font-bold text-gray-800">Pending Reports</h2>
+                    <span class="px-2.5 py-0.5 bg-red-100 text-red-700 rounded-full text-xs font-semibold">12</span>
+                </div>
+                <div class="p-6">
+                    <div class="space-y-3">
+                        <div class="p-3 bg-red-50 rounded-lg border-l-4 border-red-500">
+                            <div class="flex items-start justify-between mb-1">
+                                <p class="font-semibold text-gray-800 text-sm">Cheating Report</p>
+                                <span class="text-xs font-medium text-red-600">High</span>
+                            </div>
+                            <p class="text-xs text-gray-600">Player using speed hacks in BG</p>
+                            <p class="text-xs text-gray-400 mt-1">5 min ago</p>
+                        </div>
+                        <div class="p-3 bg-yellow-50 rounded-lg border-l-4 border-yellow-500">
+                            <div class="flex items-start justify-between mb-1">
+                                <p class="font-semibold text-gray-800 text-sm">Harassment</p>
+                                <span class="text-xs font-medium text-yellow-600">Medium</span>
+                            </div>
+                            <p class="text-xs text-gray-600">Toxic behavior in global chat</p>
+                            <p class="text-xs text-gray-400 mt-1">12 min ago</p>
+                        </div>
+                        <div class="p-3 bg-blue-50 rounded-lg border-l-4 border-blue-500">
+                            <div class="flex items-start justify-between mb-1">
+                                <p class="font-semibold text-gray-800 text-sm">Bug Report</p>
+                                <span class="text-xs font-medium text-blue-600">Low</span>
+                            </div>
+                            <p class="text-xs text-gray-600">Quest NPC not responding</p>
+                            <p class="text-xs text-gray-400 mt-1">1 hour ago</p>
+                        </div>
+                    </div>
+                    <button class="w-full mt-4 py-2 border border-gray-300 rounded-lg text-sm font-medium text-gray-700 hover:bg-gray-50">
+                        View All Reports
+                    </button>
+                </div>
+            </div>
+
+            <!-- Recent Donations -->
+            <div class="bg-white rounded-lg shadow">
+                <div class="p-6 border-b border-gray-200">
+                    <h2 class="text-lg font-bold text-gray-800">Recent Donations</h2>
+                </div>
+                <div class="p-6">
+                    <div class="space-y-3">
+                        <div class="flex items-center justify-between p-3 bg-gray-50 rounded-lg">
+                            <div>
+                                <p class="font-semibold text-gray-800 text-sm">PlayerOne</p>
+                                <p class="text-xs text-gray-600">Gold Package</p>
+                            </div>
+                            <div class="text-right">
+                                <p class="text-green-600 font-bold">$30</p>
+                                <p class="text-xs text-gray-400">Just now</p>
+                            </div>
+                        </div>
+                        <div class="flex items-center justify-between p-3 bg-gray-50 rounded-lg">
+                            <div>
+                                <p class="font-semibold text-gray-800 text-sm">CoolGamer99</p>
+                                <p class="text-xs text-gray-600">Silver Package</p>
+                            </div>
+                            <div class="text-right">
+                                <p class="text-green-600 font-bold">$15</p>
+                                <p class="text-xs text-gray-400">10 min ago</p>
+                            </div>
+                        </div>
+                        <div class="flex items-center justify-between p-3 bg-gray-50 rounded-lg">
+                            <div>
+                                <p class="font-semibold text-gray-800 text-sm">EpicWarrior</p>
+                                <p class="text-xs text-gray-600">Custom Amount</p>
+                            </div>
+                            <div class="text-right">
+                                <p class="text-green-600 font-bold">$50</p>
+                                <p class="text-xs text-gray-400">30 min ago</p>
+                            </div>
+                        </div>
+                    </div>
+                    <button class="w-full mt-4 py-2 border border-gray-300 rounded-lg text-sm font-medium text-gray-700 hover:bg-gray-50">
+                        View All Donations
+                    </button>
+                </div>
+            </div>
+        </div>
+    </div>
+    </main>
+@endsection
\ No newline at end of file
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
new file mode 100644
index 0000000..0576747
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -0,0 +1,171 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{ config('app.name', 'NexusCMS') }} - @yield('title', 'AdminCP - Dashboard')</title>
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css">
+    <link href="https://fonts.googleapis.com/css2?family=Cinzel:wght@400;700&family=Inter:wght@300;400;600&display=swap" rel="stylesheet">
+    @vite(['resources/css/app.css', 'resources/js/app.js'])
+    @yield('styles')
+    <style>
+        /* Custom scrollbar for webkit browsers */
+        .custom-scrollbar::-webkit-scrollbar {
+            width: 6px;
+        }
+        .custom-scrollbar::-webkit-scrollbar-track {
+            background: #1f2937; /* gray-800 */
+        }
+        .custom-scrollbar::-webkit-scrollbar-thumb {
+            background-color: #4b5563; /* gray-600 */
+            border-radius: 3px;
+        }
+        .custom-scrollbar::-webkit-scrollbar-thumb:hover {
+            background-color: #6b7280; /* gray-500 */
+        }
+        /* Firefox */
+        .custom-scrollbar {
+            scrollbar-width: thin;
+            scrollbar-color: #4b5563 #1f2937;
+        }
+    </style>
+</head>
+<body class="bg-gray-100">
+    <div class="flex h-screen overflow-hidden">
+        <!-- Sidebar -->
+        <aside class="w-64 bg-gray-900 text-white flex-shrink-0 hidden md:flex flex-col">
+            <!-- Logo -->
+            <div class="h-16 flex items-center px-6 bg-gray-800 border-b border-gray-700">
+                <div class="flex items-center gap-2">
+                    <div class="w-8 h-8 bg-blue-600 rounded flex items-center justify-center font-bold">
+                        N
+                    </div>
+                    <span class="text-lg font-bold">AdminCP</span>
+                </div>
+            </div>
+
+            <!-- Navigation -->
+            <nav class="flex-1 overflow-y-auto py-4 custom-scrollbar">
+                <div class="px-3 mb-4">
+                    <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Main</h3>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 bg-blue-600 rounded-lg mb-1">
+                        <i class="fas fa-home w-5"></i>
+                        <span>Dashboard</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-chart-line w-5"></i>
+                        <span>Analytics</span>
+                    </a>
+                </div>
+
+                <div class="px-3 mb-4">
+                    <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Management</h3>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-users w-5"></i>
+                        <span>Users</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-user-shield w-5"></i>
+                        <span>Characters</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-ban w-5"></i>
+                        <span>Bans</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-exclamation-triangle w-5"></i>
+                        <span>Reports</span>
+                        <span class="ml-auto bg-red-500 text-xs px-2 py-0.5 rounded-full">12</span>
+                    </a>
+                </div>
+
+                <div class="px-3 mb-4">
+                    <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Content</h3>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-newspaper w-5"></i>
+                        <span>News</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-file-alt w-5"></i>
+                        <span>Pages</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-bullhorn w-5"></i>
+                        <span>Announcements</span>
+                    </a>
+                </div>
+
+                <div class="px-3 mb-4">
+                    <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Store</h3>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-shopping-cart w-5"></i>
+                        <span>Products</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-tags w-5"></i>
+                        <span>Categories</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-receipt w-5"></i>
+                        <span>Transactions</span>
+                    </a>
+                </div>
+
+                <div class="px-3 mb-4">
+                    <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Realms</h3>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-server w-5"></i>
+                        <span>Realm Management</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-database w-5"></i>
+                        <span>Database</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-envelope w-5"></i>
+                        <span>In-Game Mail</span>
+                    </a>
+                </div>
+
+                <div class="px-3 mb-4">
+                    <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">System</h3>
+                    <a href="{{ route('admin.roles.index') }}" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-user-shield w-5"></i>
+                        <span>Roles & Permissions</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-cog w-5"></i>
+                        <span>Settings</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-terminal w-5"></i>
+                        <span>Logs</span>
+                    </a>
+                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                        <i class="fas fa-download w-5"></i>
+                        <span>Backups</span>
+                    </a>
+                </div>
+            </nav>
+
+            <!-- User Info -->
+            <div class="p-4 bg-gray-800 border-t border-gray-700">
+                <div class="flex items-center gap-3">
+                    <div class="w-10 h-10 bg-blue-600 rounded-full flex items-center justify-center font-bold">
+                        A
+                    </div>
+                    <div class="flex-1 min-w-0">
+                        <div class="text-sm font-semibold truncate">Administrator</div>
+                        <div class="text-xs text-gray-400">Super Admin</div>
+                    </div>
+                    <a href="#" class="text-gray-400 hover:text-white">
+                        <i class="fas fa-sign-out-alt"></i>
+                    </a>
+                </div>
+            </div>
+        </aside>
+        <div class="flex-1 flex flex-col overflow-hidden">
+            @yield('content')
+        </div>
+    </div>
+</body>
diff --git a/app/Modules/Admin/Resources/views/permissions/index.blade.php b/app/Modules/Admin/Resources/views/permissions/index.blade.php
new file mode 100644
index 0000000..da69f9e
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/permissions/index.blade.php
@@ -0,0 +1,78 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Permission List')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">Permission List</h1>
+    </div>
+    <div class="flex items-center gap-4">
+        <a href="{{ url('/acp') }}" class="text-gray-600 hover:text-gray-800">
+            <i class="fas fa-home text-xl"></i>
+        </a>
+    </div>
+    </header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <div class="bg-white rounded-lg shadow">
+        <div class="p-6 border-b border-gray-200 flex items-center justify-between">
+            <div>
+                <h2 class="text-lg font-bold text-gray-800">Available Permissions</h2>
+                <p class="text-sm text-gray-600">Based on the current system configuration</p>
+            </div>
+            <div class="relative">
+                <input type="search" id="search-permissions" placeholder="Search permissions..." class="pl-10 pr-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 w-64">
+                <i class="fas fa-search absolute left-3 top-1/2 -translate-y-1/2 text-gray-400"></i>
+            </div>
+        </div>
+        @php
+            $grouped = $permissions->groupBy(fn($p) => explode('.', $p->name)[0]);
+        @endphp
+        <div class="p-6 space-y-8" id="permissions-list">
+            @foreach($grouped as $group => $items)
+                <div class="space-y-3 permission-group" data-group="{{ $group }}">
+                    <div class="flex items-center justify-between">
+                        <h3 class="text-base font-semibold text-gray-800 capitalize">{{ $group }}</h3>
+                        <span class="text-xs px-2 py-1 bg-gray-100 text-gray-700 rounded">Total: {{ $items->count() }}</span>
+                    </div>
+                    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-3">
+                        @foreach($items as $permission)
+                            <div class="flex items-center justify-between p-3 bg-gray-50 rounded border border-gray-200 permission-item">
+                                <div class="flex items-center gap-3">
+                                    <div class="w-8 h-8 bg-blue-100 text-blue-600 rounded flex items-center justify-center">
+                                        <i class="fas fa-key"></i>
+                                    </div>
+                                    <div>
+                                        <p class="font-medium text-gray-800">{{ $permission->name }}</p>
+                                        <p class="text-xs text-gray-500">ID: {{ $permission->id }}</p>
+                                    </div>
+                                </div>
+                                <span class="text-xs px-2 py-1 bg-blue-100 text-blue-700 rounded">{{ explode('.', $permission->name)[0] }}</span>
+                            </div>
+                        @endforeach
+                    </div>
+                </div>
+            @endforeach
+            @if($permissions->isEmpty())
+                <div class="p-6 text-center text-gray-600">No permissions are configured.</div>
+            @endif
+        </div>
+    </div>
+</main>
+
+<script>
+document.addEventListener('DOMContentLoaded', function () {
+    const input = document.getElementById('search-permissions');
+    const items = document.querySelectorAll('#permissions-list .permission-item');
+    input.addEventListener('input', function () {
+        const q = this.value.toLowerCase();
+        items.forEach(el => {
+            const text = el.textContent.toLowerCase();
+            el.style.display = text.includes(q) ? '' : 'none';
+        });
+    });
+});
+</script>
+@endsection
+
diff --git a/app/Modules/Admin/Resources/views/roles/create.blade.php b/app/Modules/Admin/Resources/views/roles/create.blade.php
new file mode 100644
index 0000000..8cf7904
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/roles/create.blade.php
@@ -0,0 +1,150 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Crear Rol')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">Create New Role</h1>
+    </div>
+    <div class="flex items-center gap-3">
+        <a href="{{ route('admin.roles.index') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
+            Back to Roles
+        </a>
+        <a href="{{ route('admin.permissions') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
+            View Permissions
+        </a>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <form method="POST" action="{{ route('admin.roles.store') }}" class="space-y-6">
+        @csrf
+        <div class="bg-white rounded-lg shadow">
+            <div class="p-6 border-b border-gray-200">
+                <h2 class="text-lg font-bold text-gray-800">Role Information</h2>
+            </div>
+            <div class="p-6 space-y-4">
+                <div>
+                    <label for="name" class="block text-sm font-medium text-gray-700">Role Name</label>
+                    <input type="text" name="name" id="name" value="{{ old('name') }}" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500" placeholder="Ej: GameMaster Pro">
+                    @error('name')
+                        <p class="text-sm text-red-600 mt-1">{{ $message }}</p>
+                    @enderror
+                </div>
+            </div>
+        </div>
+
+        <div class="bg-white rounded-lg shadow">
+            <div class="p-6 border-b border-gray-200">
+                <h2 class="text-lg font-bold text-gray-800">Assign Permissions (Drag & Drop)</h2>
+                <p class="text-sm text-gray-600">Drag permissions from the available list to the role list.</p>
+            </div>
+            <div class="p-6 grid grid-cols-1 lg:grid-cols-2 gap-6">
+                <div>
+                    <h3 class="text-sm font-semibold text-gray-700 mb-2">Available Permissions</h3>
+                    <div id="available" class="min-h-[300px] p-3 border border-gray-200 rounded-lg bg-gray-50 flex flex-col gap-2">
+                        @foreach($permissions as $permission)
+                            <div class="perm-item flex items-center justify-between p-2 bg-white border border-gray-200 rounded cursor-move"
+                                 draggable="true"
+                                 data-name="{{ $permission->name }}">
+                                <div class="flex items-center gap-2">
+                                    <div class="w-7 h-7 bg-blue-100 text-blue-600 rounded flex items-center justify-center">
+                                        <i class="fas fa-key"></i>
+                                    </div>
+                                    <span class="text-sm text-gray-800">{{ $permission->name }}</span>
+                                </div>
+                                <span class="text-xs px-2 py-1 bg-gray-100 text-gray-700 rounded">{{ explode('.', $permission->name)[0] }}</span>
+                            </div>
+                        @endforeach
+                    </div>
+                </div>
+                <div>
+                    <h3 class="text-sm font-semibold text-gray-700 mb-2">Role Permissions</h3>
+                    <div id="selected" class="min-h-[300px] p-3 border border-blue-300 rounded-lg bg-blue-50 flex flex-col gap-2">
+                        <div class="text-sm text-blue-700" id="selected-empty">Drag permissions here to add them to the role</div>
+                    </div>
+                </div>
+            </div>
+            <div class="p-6 border-t border-gray-200 flex items-center justify-end gap-3">
+                <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                    Crear rol
+                </button>
+            </div>
+        </div>
+
+        <div id="hidden-inputs"></div>
+    </form>
+</main>
+
+<script>
+document.addEventListener('DOMContentLoaded', () => {
+    const available = document.getElementById('available');
+    const selected = document.getElementById('selected');
+    const hiddenInputs = document.getElementById('hidden-inputs');
+    const selectedEmpty = document.getElementById('selected-empty');
+
+    function updateHiddenInputs() {
+        hiddenInputs.innerHTML = '';
+        const names = Array.from(selected.querySelectorAll('.perm-item')).map(el => el.dataset.name);
+        if (names.length === 0) {
+            selectedEmpty.style.display = '';
+        } else {
+            selectedEmpty.style.display = 'none';
+        }
+        names.forEach(name => {
+            const input = document.createElement('input');
+            input.type = 'hidden';
+            input.name = 'permissions[]';
+            input.value = name;
+            hiddenInputs.appendChild(input);
+        });
+    }
+
+    function makeDraggable(container) {
+        container.addEventListener('dragstart', (e) => {
+            const target = e.target.closest('.perm-item');
+            if (!target) return;
+            e.dataTransfer.setData('text/plain', target.dataset.name);
+            e.dataTransfer.dropEffect = 'move';
+            container._dragging = target;
+        });
+
+        container.addEventListener('dragover', (e) => {
+            e.preventDefault();
+            e.dataTransfer.dropEffect = 'move';
+            container.classList.add('ring-2', 'ring-blue-300');
+        });
+
+        container.addEventListener('dragleave', () => {
+            container.classList.remove('ring-2', 'ring-blue-300');
+        });
+
+        container.addEventListener('drop', (e) => {
+            e.preventDefault();
+            container.classList.remove('ring-2', 'ring-blue-300');
+            const dragging = available._dragging || selected._dragging;
+            if (dragging && dragging.parentElement !== container) {
+                container.appendChild(dragging);
+                updateHiddenInputs();
+            }
+        });
+    }
+
+    makeDraggable(available);
+    makeDraggable(selected);
+
+    // Double click to move between lists
+    document.querySelectorAll('.perm-item').forEach(item => {
+        item.addEventListener('dblclick', () => {
+            const targetContainer = item.parentElement.id === 'available' ? selected : available;
+            targetContainer.appendChild(item);
+            updateHiddenInputs();
+        });
+    });
+
+    updateHiddenInputs();
+});
+</script>
+@endsection
+
diff --git a/app/Modules/Admin/Resources/views/roles/edit.blade.php b/app/Modules/Admin/Resources/views/roles/edit.blade.php
new file mode 100644
index 0000000..464820c
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/roles/edit.blade.php
@@ -0,0 +1,173 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Editar Rol')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">Edit Role: {{ $role->name }}</h1>
+    </div>
+    <div class="flex items-center gap-3">
+        <a href="{{ route('admin.roles.index') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
+            Back to Roles
+        </a>
+        <a href="{{ route('admin.permissions') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
+            View Permissions
+        </a>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <form method="POST" action="{{ route('admin.roles.update', $role) }}" class="space-y-6">
+        @csrf
+        @method('PUT')
+        <div class="bg-white rounded-lg shadow">
+            <div class="p-6 border-b border-gray-200">
+                <h2 class="text-lg font-bold text-gray-800">Role Details</h2>
+            </div>
+            <div class="p-6 space-y-4">
+                <div>
+                    <label for="name" class="block text-sm font-medium text-gray-700">Role Name</label>
+                    <input type="text" name="name" id="name" value="{{ old('name', $role->name) }}" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    @error('name')
+                        <p class="text-sm text-red-600 mt-1">{{ $message }}</p>
+                    @enderror
+                </div>
+            </div>
+        </div>
+
+        <div class="bg-white rounded-lg shadow">
+            <div class="p-6 border-b border-gray-200">
+                <h2 class="text-lg font-bold text-gray-800">Permissions (Drag & Drop)</h2>
+                <p class="text-sm text-gray-600">Drag permissions between lists to update the role.</p>
+            </div>
+            <div class="p-6 grid grid-cols-1 lg:grid-cols-2 gap-6">
+                <div>
+                    <h3 class="text-sm font-semibold text-gray-700 mb-2">Available Permissions</h3>
+                    <div id="available" class="min-h-[300px] p-3 border border-gray-200 rounded-lg bg-gray-50 flex flex-col gap-2">
+                        @php
+                            $selectedSet = collect($selected);
+                        @endphp
+                        @foreach($permissions as $permission)
+                            @if(!$selectedSet->contains($permission->name))
+                                <div class="perm-item flex items-center justify-between p-2 bg-white border border-gray-200 rounded cursor-move"
+                                     draggable="true"
+                                     data-name="{{ $permission->name }}">
+                                    <div class="flex items-center gap-2">
+                                        <div class="w-7 h-7 bg-blue-100 text-blue-600 rounded flex items-center justify-center">
+                                            <i class="fas fa-key"></i>
+                                        </div>
+                                        <span class="text-sm text-gray-800">{{ $permission->name }}</span>
+                                    </div>
+                                    <span class="text-xs px-2 py-1 bg-gray-100 text-gray-700 rounded">{{ explode('.', $permission->name)[0] }}</span>
+                                </div>
+                            @endif
+                        @endforeach
+                    </div>
+                </div>
+                <div>
+                    <h3 class="text-sm font-semibold text-gray-700 mb-2">Role Permissions</h3>
+                    <div id="selected" class="min-h-[300px] p-3 border border-blue-300 rounded-lg bg-blue-50 flex flex-col gap-2">
+                        @forelse($permissions as $permission)
+                            @if($selectedSet->contains($permission->name))
+                                <div class="perm-item flex items-center justify-between p-2 bg-white border border-gray-200 rounded cursor-move"
+                                     draggable="true"
+                                     data-name="{{ $permission->name }}">
+                                    <div class="flex items-center gap-2">
+                                        <div class="w-7 h-7 bg-blue-100 text-blue-600 rounded flex items-center justify-center">
+                                            <i class="fas fa-key"></i>
+                                        </div>
+                                        <span class="text-sm text-gray-800">{{ $permission->name }}</span>
+                                    </div>
+                                    <span class="text-xs px-2 py-1 bg-gray-100 text-gray-700 rounded">{{ explode('.', $permission->name)[0] }}</span>
+                                </div>
+                            @endif
+                        @empty
+                            <div class="text-sm text-blue-700" id="selected-empty">Drag permissions here to add them to the role</div>
+                        @endforelse
+                    </div>
+                </div>
+            </div>
+            <div class="p-6 border-t border-gray-200 flex items-center justify-end gap-3">
+                <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                    Save Changes
+                </button>
+            </div>
+        </div>
+
+        <div id="hidden-inputs">
+            @foreach($selected as $name)
+                <input type="hidden" name="permissions[]" value="{{ $name }}">
+            @endforeach
+        </div>
+    </form>
+</main>
+
+<script>
+document.addEventListener('DOMContentLoaded', () => {
+    const available = document.getElementById('available');
+    const selected = document.getElementById('selected');
+    const hiddenInputs = document.getElementById('hidden-inputs');
+    const selectedEmpty = document.getElementById('selected-empty');
+
+    function updateHiddenInputs() {
+        hiddenInputs.innerHTML = '';
+        const names = Array.from(selected.querySelectorAll('.perm-item')).map(el => el.dataset.name);
+        if (selectedEmpty) {
+            selectedEmpty.style.display = names.length === 0 ? '' : 'none';
+        }
+        names.forEach(name => {
+            const input = document.createElement('input');
+            input.type = 'hidden';
+            input.name = 'permissions[]';
+            input.value = name;
+            hiddenInputs.appendChild(input);
+        });
+    }
+
+    function makeDraggable(container) {
+        container.addEventListener('dragstart', (e) => {
+            const target = e.target.closest('.perm-item');
+            if (!target) return;
+            e.dataTransfer.setData('text/plain', target.dataset.name);
+            e.dataTransfer.dropEffect = 'move';
+            container._dragging = target;
+        });
+
+        container.addEventListener('dragover', (e) => {
+            e.preventDefault();
+            e.dataTransfer.dropEffect = 'move';
+            container.classList.add('ring-2', 'ring-blue-300');
+        });
+
+        container.addEventListener('dragleave', () => {
+            container.classList.remove('ring-2', 'ring-blue-300');
+        });
+
+        container.addEventListener('drop', (e) => {
+            e.preventDefault();
+            container.classList.remove('ring-2', 'ring-blue-300');
+            const dragging = available._dragging || selected._dragging;
+            if (dragging && dragging.parentElement !== container) {
+                container.appendChild(dragging);
+                updateHiddenInputs();
+            }
+        });
+    }
+
+    makeDraggable(available);
+    makeDraggable(selected);
+
+    document.querySelectorAll('.perm-item').forEach(item => {
+        item.addEventListener('dblclick', () => {
+            const targetContainer = item.parentElement.id === 'available' ? selected : available;
+            targetContainer.appendChild(item);
+            updateHiddenInputs();
+        });
+    });
+
+    updateHiddenInputs();
+});
+</script>
+@endsection
+
diff --git a/app/Modules/Admin/Resources/views/roles/index.blade.php b/app/Modules/Admin/Resources/views/roles/index.blade.php
new file mode 100644
index 0000000..fab7d5a
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/roles/index.blade.php
@@ -0,0 +1,57 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Roles')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">Roles & Permissions</h1>
+    </div>
+    <div class="flex items-center gap-3">
+        <a href="{{ route('admin.permissions') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
+            View Permissions
+        </a>
+        <a href="{{ route('admin.roles.create') }}" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+            Create Role
+        </a>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <div class="bg-white rounded-lg shadow">
+        <div class="p-6 border-b border-gray-200">
+            <h2 class="text-lg font-bold text-gray-800">Role List</h2>
+        </div>
+        @if(session('success'))
+            <div class="mx-6 mt-4 p-3 bg-green-50 text-green-700 border border-green-200 rounded">
+                {{ session('success') }}
+            </div>
+        @endif
+        <div class="p-6">
+            <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
+                @forelse($roles as $role)
+                    <div class="p-4 bg-gray-50 rounded border border-gray-200">
+                        <div class="flex items-center justify-between">
+                            <div class="flex items-center gap-3">
+                                <div class="w-8 h-8 bg-purple-100 text-purple-600 rounded flex items-center justify-center">
+                                    <i class="fas fa-user-shield"></i>
+                                </div>
+                                <div>
+                                    <p class="font-semibold text-gray-800">{{ $role->name }}</p>
+                                    <p class="text-xs text-gray-500">Permissions: {{ $role->permissions_count }}</p>
+                                </div>
+                            </div>
+                            <div class="flex items-center gap-2">
+                                <a href="{{ route('admin.roles.edit', $role) }}" class="px-3 py-1 bg-gray-200 text-gray-800 rounded hover:bg-gray-300 text-xs">Edit</a>
+                                <button class="px-3 py-1 bg-red-100 text-red-700 rounded hover:bg-red-200 text-xs">Delete</button>
+                            </div>
+                        </div>
+                    </div>
+                @empty
+                    <div class="text-gray-600">No roles created.</div>
+                @endforelse
+            </div>
+        </div>
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Admin/Services/apiService.php b/app/Modules/Admin/Services/apiService.php
new file mode 100644
index 0000000..2fb24a9
--- /dev/null
+++ b/app/Modules/Admin/Services/apiService.php
@@ -0,0 +1,46 @@
+<?php
+
+namespace Modules\Admin\Services;
+
+use Illuminate\Support\Facades\Http;
+
+class ApiService
+{
+    protected string $baseUrl = 'http://wowcms-apiwowcms-rtpsnl-03dd1f-188-245-113-32.traefik.me/api/github';
+
+    public function latestRelease(): array
+    {
+        $response = Http::timeout(5)->acceptJson()->get($this->baseUrl . '/wow-cms/nexuscms/latest');
+
+        if (!$response->ok()) {
+            return [];
+        }
+
+        $data = $response->json();
+
+        return is_array($data) ? $data : [];
+    }
+
+    public function checkVersion(string $owner, string $repo, string $current): array
+    {
+        $response = Http::timeout(5)->acceptJson()->get("{$this->baseUrl}/{$owner}/{$repo}/check-version", [
+            'current' => $current,
+        ]);
+
+        if (!$response->ok()) {
+            return [];
+        }
+
+        $data = $response->json();
+
+        if (!is_array($data)) {
+            return [];
+        }
+
+        return [
+            'current'  => $data['current']  ?? '',
+            'latest'   => $data['latest']   ?? '',
+            'outdated' => $data['outdated'] ?? false,
+        ];
+    }
+}
diff --git a/app/Modules/Admin/module.json b/app/Modules/Admin/module.json
new file mode 100644
index 0000000..406aa95
--- /dev/null
+++ b/app/Modules/Admin/module.json
@@ -0,0 +1,8 @@
+{
+    "name": "Admin",
+    "enabled": true,
+    "routes": true,
+    "migrations": true,
+    "views": true,
+    "namespace": "Modules\\Admin"
+}
\ No newline at end of file
diff --git a/app/Modules/Donate/Http/Controllers/DonateController.php b/app/Modules/Donate/Http/Controllers/DonateController.php
index 9af58bf..873551a 100644
--- a/app/Modules/Donate/Http/Controllers/DonateController.php
+++ b/app/Modules/Donate/Http/Controllers/DonateController.php
@@ -101,4 +101,4 @@ public function receipt(int $id)
             ->firstOrFail();
         return view('donate::receipt', ['tx' => $tx]);
     }
-}
\ No newline at end of file
+}
diff --git a/app/Modules/Store/Http/Controllers/StoreController.php b/app/Modules/Store/Http/Controllers/StoreController.php
new file mode 100644
index 0000000..d849412
--- /dev/null
+++ b/app/Modules/Store/Http/Controllers/StoreController.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace Modules\Store\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+
+class StoreController extends Controller
+{
+    public function index()
+    {
+        return view('store::store'); 
+    }
+}
\ No newline at end of file
diff --git a/app/Modules/Store/Http/routes.php b/app/Modules/Store/Http/routes.php
new file mode 100644
index 0000000..494a2d5
--- /dev/null
+++ b/app/Modules/Store/Http/routes.php
@@ -0,0 +1,9 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+
+Route::middleware('web')
+    ->prefix(strtolower('Store'))
+    ->group(function () {
+        Route::get('/', [\Modules\Store\Http\Controllers\StoreController::class, 'index']);
+    });
\ No newline at end of file
diff --git a/app/Modules/Store/Providers/StoreServiceProvider.php b/app/Modules/Store/Providers/StoreServiceProvider.php
new file mode 100644
index 0000000..89cd32c
--- /dev/null
+++ b/app/Modules/Store/Providers/StoreServiceProvider.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace Modules\Store\Providers;
+
+use App\Providers\BaseModuleServiceProvider;
+
+class StoreServiceProvider extends BaseModuleServiceProvider
+{
+    protected string $moduleName = 'Store';
+}
\ No newline at end of file
diff --git a/app/Modules/Store/Resources/views/store.blade.php b/app/Modules/Store/Resources/views/store.blade.php
new file mode 100644
index 0000000..e04cde2
--- /dev/null
+++ b/app/Modules/Store/Resources/views/store.blade.php
@@ -0,0 +1,398 @@
+@extends('layouts.main')
+
+@section('title', 'Store')
+
+@section('content')
+    <!-- Hero Section -->
+    <div class="relative pt-32 pb-20 px-4 sm:px-6 lg:px-8">
+        <div class="max-w-7xl mx-auto">
+            <div class="text-center mb-8">
+                <h1 class="text-5xl md:text-6xl font-bold mb-6">
+                    Donation <span class="text-blue-500">Store</span>
+                </h1>
+                <p class="text-xl text-slate-400 max-w-3xl mx-auto mb-4">
+                    Use your donation points to purchase exclusive items, services, and perks across all realms
+                </p>
+                <div class="inline-flex items-center gap-3 bg-slate-900/50 border border-slate-800 rounded-lg px-6 py-3">
+                    <i class="fas fa-coins text-yellow-500 text-xl"></i>
+                    <div class="text-left">
+                        <div class="text-xs text-slate-400">Your Balance</div>
+                        <div class="text-2xl font-bold text-yellow-500">2,450 DP</div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    <!-- Realm Selector -->
+    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 pb-12">
+        <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-6 mb-8">
+            <div class="flex flex-col md:flex-row md:items-center md:justify-between gap-4">
+                <div class="flex items-center gap-3">
+                    <i class="fas fa-globe text-blue-500 text-xl"></i>
+                    <div>
+                        <h3 class="font-bold">Select Realm</h3>
+                        <p class="text-sm text-slate-400">Choose which realm to purchase items for</p>
+                    </div>
+                </div>
+                <div class="flex flex-wrap gap-3">
+                    <button class="px-6 py-2 bg-blue-600 hover:bg-blue-700 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-blue-900/30">
+                        <i class="fas fa-server mr-2"></i>All Realms
+                    </button>
+                    <button class="px-6 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
+                        <i class="fas fa-fire mr-2 text-red-500"></i>Realm 1
+                    </button>
+                    <button class="px-6 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
+                        <i class="fas fa-bolt mr-2 text-yellow-500"></i>Realm 2
+                    </button>
+                    <button class="px-6 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
+                        <i class="fas fa-snowflake mr-2 text-cyan-500"></i>Realm 3
+                    </button>
+                </div>
+            </div>
+        </div>
+
+        <!-- Filters and Search -->
+        <div class="flex flex-col md:flex-row gap-4 mb-8">
+            <div class="flex-1">
+                <div class="relative">
+                    <i class="fas fa-search absolute left-4 top-1/2 transform -translate-y-1/2 text-slate-400"></i>
+                    <input type="text" placeholder="Search items..." class="w-full pl-12 pr-4 py-3 bg-slate-900/50 border border-slate-800 rounded-lg focus:outline-none focus:border-blue-500 text-white">
+                </div>
+            </div>
+            <select class="px-4 py-3 bg-slate-900/50 border border-slate-800 rounded-lg focus:outline-none focus:border-blue-500 text-white">
+                <option>All Categories</option>
+                <option>Mounts</option>
+                <option>Pets</option>
+                <option>Transmog</option>
+                <option>Services</option>
+                <option>Consumables</option>
+                <option>Miscellaneous</option>
+            </select>
+            <select class="px-4 py-3 bg-slate-900/50 border border-slate-800 rounded-lg focus:outline-none focus:border-blue-500 text-white">
+                <option>Sort by: Featured</option>
+                <option>Price: Low to High</option>
+                <option>Price: High to Low</option>
+                <option>Newest</option>
+                <option>Most Popular</option>
+            </select>
+        </div>
+
+        <!-- Category Tabs -->
+        <div class="flex flex-wrap gap-3 mb-8">
+            <button class="px-5 py-2 bg-blue-600 hover:bg-blue-700 rounded-lg font-semibold transition-all duration-200">
+                <i class="fas fa-star mr-2"></i>Featured
+            </button>
+            <button class="px-5 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
+                <i class="fas fa-horse mr-2"></i>Mounts
+            </button>
+            <button class="px-5 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
+                <i class="fas fa-paw mr-2"></i>Pets
+            </button>
+            <button class="px-5 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
+                <i class="fas fa-tshirt mr-2"></i>Transmog
+            </button>
+            <button class="px-5 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
+                <i class="fas fa-cogs mr-2"></i>Services
+            </button>
+            <button class="px-5 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
+                <i class="fas fa-flask mr-2"></i>Consumables
+            </button>
+        </div>
+
+        <!-- Featured Banner -->
+        <div class="bg-gradient-to-r from-purple-900/50 to-blue-900/50 border border-purple-700/50 rounded-xl p-8 mb-12">
+            <div class="flex flex-col md:flex-row items-center gap-6">
+                <div class="w-32 h-32 bg-slate-800 rounded-xl flex items-center justify-center">
+                    <i class="fas fa-dragon text-6xl text-purple-500"></i>
+                </div>
+                <div class="flex-1 text-center md:text-left">
+                    <span class="inline-block px-3 py-1 bg-purple-600 rounded-full text-xs font-semibold mb-2">LIMITED TIME</span>
+                    <h3 class="text-2xl md:text-3xl font-bold mb-2">Celestial Dragon Mount</h3>
+                    <p class="text-slate-300 mb-4">Exclusive flying mount with special effects - Only available this month!</p>
+                    <div class="flex items-center gap-4 justify-center md:justify-start">
+                        <span class="text-3xl font-bold text-purple-400">2,500 DP</span>
+                        <button class="px-6 py-2 bg-purple-600 hover:bg-purple-700 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-purple-900/30">
+                            Purchase Now
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Products Grid -->
+        <div class="grid md:grid-cols-3 lg:grid-cols-4 gap-6 mb-12">
+            <!-- Product Card 1 -->
+            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
+                <div class="relative">
+                    <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
+                        <i class="fas fa-dragon text-6xl text-blue-500 group-hover:scale-110 transition-transform duration-300"></i>
+                    </div>
+                    <div class="absolute top-3 right-3">
+                        <span class="px-2 py-1 bg-blue-600 rounded text-xs font-semibold">NEW</span>
+                    </div>
+                </div>
+                <div class="p-4">
+                    <div class="flex items-start justify-between mb-2">
+                        <h4 class="font-bold text-sm">Swift Spectral Tiger</h4>
+                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
+                            <i class="fas fa-star"></i>
+                        </button>
+                    </div>
+                    <p class="text-slate-400 text-xs mb-3">Epic Flying Mount</p>
+                    <div class="flex items-center justify-between">
+                        <span class="text-blue-500 font-bold">1,800 DP</span>
+                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
+                            Buy
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Product Card 2 -->
+            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
+                <div class="relative">
+                    <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
+                        <i class="fas fa-cat text-6xl text-purple-500 group-hover:scale-110 transition-transform duration-300"></i>
+                    </div>
+                    <div class="absolute top-3 right-3">
+                        <span class="px-2 py-1 bg-red-600 rounded text-xs font-semibold">HOT</span>
+                    </div>
+                </div>
+                <div class="p-4">
+                    <div class="flex items-start justify-between mb-2">
+                        <h4 class="font-bold text-sm">Mini Phoenix Pet</h4>
+                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
+                            <i class="fas fa-star"></i>
+                        </button>
+                    </div>
+                    <p class="text-slate-400 text-xs mb-3">Companion Pet</p>
+                    <div class="flex items-center justify-between">
+                        <span class="text-blue-500 font-bold">500 DP</span>
+                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
+                            Buy
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Product Card 3 -->
+            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
+                <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
+                    <i class="fas fa-vest text-6xl text-yellow-500 group-hover:scale-110 transition-transform duration-300"></i>
+                </div>
+                <div class="p-4">
+                    <div class="flex items-start justify-between mb-2">
+                        <h4 class="font-bold text-sm">Legendary Transmog Set</h4>
+                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
+                            <i class="fas fa-star"></i>
+                        </button>
+                    </div>
+                    <p class="text-slate-400 text-xs mb-3">Full Armor Set</p>
+                    <div class="flex items-center justify-between">
+                        <span class="text-blue-500 font-bold">2,200 DP</span>
+                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
+                            Buy
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Product Card 4 -->
+            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
+                <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
+                    <i class="fas fa-level-up-alt text-6xl text-green-500 group-hover:scale-110 transition-transform duration-300"></i>
+                </div>
+                <div class="p-4">
+                    <div class="flex items-start justify-between mb-2">
+                        <h4 class="font-bold text-sm">Level 80 Boost</h4>
+                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
+                            <i class="fas fa-star"></i>
+                        </button>
+                    </div>
+                    <p class="text-slate-400 text-xs mb-3">Character Service</p>
+                    <div class="flex items-center justify-between">
+                        <span class="text-blue-500 font-bold">3,500 DP</span>
+                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
+                            Buy
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Product Card 5 -->
+            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
+                <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
+                    <i class="fas fa-user-edit text-6xl text-cyan-500 group-hover:scale-110 transition-transform duration-300"></i>
+                </div>
+                <div class="p-4">
+                    <div class="flex items-start justify-between mb-2">
+                        <h4 class="font-bold text-sm">Name Change</h4>
+                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
+                            <i class="fas fa-star"></i>
+                        </button>
+                    </div>
+                    <p class="text-slate-400 text-xs mb-3">Character Service</p>
+                    <div class="flex items-center justify-between">
+                        <span class="text-blue-500 font-bold">600 DP</span>
+                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
+                            Buy
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Product Card 6 -->
+            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
+                <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
+                    <i class="fas fa-exchange-alt text-6xl text-orange-500 group-hover:scale-110 transition-transform duration-300"></i>
+                </div>
+                <div class="p-4">
+                    <div class="flex items-start justify-between mb-2">
+                        <h4 class="font-bold text-sm">Faction Change</h4>
+                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
+                            <i class="fas fa-star"></i>
+                        </button>
+                    </div>
+                    <p class="text-slate-400 text-xs mb-3">Character Service</p>
+                    <div class="flex items-center justify-between">
+                        <span class="text-blue-500 font-bold">1,200 DP</span>
+                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
+                            Buy
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Product Card 7 -->
+            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
+                <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
+                    <i class="fas fa-users text-6xl text-pink-500 group-hover:scale-110 transition-transform duration-300"></i>
+                </div>
+                <div class="p-4">
+                    <div class="flex items-start justify-between mb-2">
+                        <h4 class="font-bold text-sm">Race Change</h4>
+                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
+                            <i class="fas fa-star"></i>
+                        </button>
+                    </div>
+                    <p class="text-slate-400 text-xs mb-3">Character Service</p>
+                    <div class="flex items-center justify-between">
+                        <span class="text-blue-500 font-bold">1,000 DP</span>
+                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
+                            Buy
+                        </button>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Product Card 8 -->
+            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
+                <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
+                    <i class="fas fa-flask text-6xl text-red-500 group-hover:scale-110 transition-transform duration-300"></i>
+                </div>
+                <div class="p-4">
+                    <div class="flex items-start justify-between mb-2">
+                        <h4 class="font-bold text-sm">XP Boost Potion (x10)</h4>
+                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
+                            <i class="fas fa-star"></i>
+                        </button>
+                    </div>
+                    <p class="text-slate-400 text-xs mb-3">Consumable</p>
+                    <div class="flex items-center justify-between">
+                        <span class="text-blue-500 font-bold">300 DP</span>
+                        <button onclick="document.getElementById('purchaseModal').classList.remove('hidden')" class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
+                            Buy
+                        </button>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Pagination -->
+        <div class="flex justify-center items-center gap-2">
+            <button class="px-4 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
+                <i class="fas fa-chevron-left"></i>
+            </button>
+            <button class="px-4 py-2 bg-blue-600 hover:bg-blue-700 rounded-lg font-semibold transition-all duration-200">1</button>
+            <button class="px-4 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">2</button>
+            <button class="px-4 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">3</button>
+            <span class="px-2 text-slate-400">...</span>
+            <button class="px-4 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">10</button>
+            <button class="px-4 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
+                <i class="fas fa-chevron-right"></i>
+            </button>
+        </div>
+    </div>
+
+    <!-- Info Banner -->
+    <div class="bg-gradient-to-r from-blue-900/20 to-purple-900/20 border-y border-slate-800 py-12 mt-16">
+        <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
+            <div class="grid md:grid-cols-3 gap-8 text-center">
+                <div>
+                    <i class="fas fa-shield-alt text-4xl text-blue-500 mb-4"></i>
+                    <h3 class="font-bold mb-2">Instant Delivery</h3>
+                    <p class="text-slate-400 text-sm">All items are delivered automatically to your account within minutes</p>
+                </div>
+                <div>
+                    <i class="fas fa-sync text-4xl text-green-500 mb-4"></i>
+                    <h3 class="font-bold mb-2">Multi-Realm Support</h3>
+                    <p class="text-slate-400 text-sm">Purchase once and use across all realms or choose specific realms</p>
+                </div>
+                <div>
+                    <i class="fas fa-headset text-4xl text-purple-500 mb-4"></i>
+                    <h3 class="font-bold mb-2">24/7 Support</h3>
+                    <p class="text-slate-400 text-sm">Our support team is always ready to help with any questions</p>
+                </div>
+            </div>
+        </div>
+    </div>
+@endsection
+
+@section('modals')
+<div id="purchaseModal" class="hidden fixed inset-0 bg-black/70 z-50">
+    <div class="flex items-center justify-center min-h-screen p-4">
+        <div role="dialog" aria-modal="true" class="bg-slate-900 border border-slate-800 rounded-xl max-w-md w-full">
+            <div class="flex items-center justify-between p-6 border-b border-slate-800">
+                <h3 class="text-xl font-bold">Confirm Purchase</h3>
+                <button class="px-3 py-2 bg-slate-800 rounded">
+                    <i class="fas fa-times"></i>
+                </button>
+            </div>
+            <div class="p-6">
+                <div class="mb-4">
+                    <div class="font-bold mb-1">Swift Spectral Tiger</div>
+                    <div class="text-slate-400 text-sm">Epic Flying Mount</div>
+                </div>
+                <div class="bg-slate-800 rounded-lg p-4 mb-4">
+                    <div class="flex justify-between mb-2">
+                        <span class="text-slate-400">Price</span>
+                        <span class="font-bold">1,800 DP</span>
+                    </div>
+                    <div class="flex justify-between">
+                        <span class="text-slate-400">Your Balance</span>
+                        <span class="font-bold text-yellow-500">2,450 DP</span>
+                    </div>
+                    <div class="border-t border-slate-700 my-3"></div>
+                    <div class="flex justify-between">
+                        <span class="text-slate-400">After Purchase</span>
+                        <span class="font-bold text-green-500">650 DP</span>
+                    </div>
+                </div>
+                <label class="block mb-4">
+                    <span class="text-sm text-slate-400 mb-2 block">Select Character</span>
+                    <select class="w-full px-4 py-2 bg-slate-800 border border-slate-700 rounded-lg text-white">
+                        <option>Character 1 - Level 80</option>
+                        <option>Character 2 - Level 70</option>
+                        <option>Character 3 - Level 60</option>
+                    </select>
+                </label>
+            </div>
+            <div class="flex gap-3 p-6 border-t border-slate-800">
+                <button class="flex-1 px-4 py-2 bg-slate-800 rounded">Cancel</button>
+                <button class="flex-1 px-4 py-2 bg-blue-600 rounded text-white">Confirm Purchase</button>
+            </div>
+        </div>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Store/module.json b/app/Modules/Store/module.json
new file mode 100644
index 0000000..e21d3a5
--- /dev/null
+++ b/app/Modules/Store/module.json
@@ -0,0 +1,8 @@
+{
+    "name": "Store",
+    "enabled": true,
+    "routes": true,
+    "migrations": true,
+    "views": true,
+    "namespace": "Modules\\Store"
+}
\ No newline at end of file
diff --git a/config/app.php b/config/app.php
index 324b513..e20afbc 100755
--- a/config/app.php
+++ b/config/app.php
@@ -123,4 +123,13 @@
         'store' => env('APP_MAINTENANCE_STORE', 'database'),
     ],
 
+    /*
+    |--------------------------------------------------------------------------
+    | Version CMS
+    |--------------------------------------------------------------------------
+    |
+    | The version of the CMS.
+    |
+    */
+    'version' => env('APP_VERSION', '0.1.6-alpha'),
 ];

From 54534fdaa39c033bf39b174ac2703ddcc120bd5e Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 25 Jan 2026 17:15:08 +0100
Subject: [PATCH 037/132] feat(roles): add delete functionality and improve
 user display

- Add DELETE route and controller method for role deletion
- Update role index view with delete link and confirmation dialog
- Replace hardcoded user info with dynamic data in admin layout
- Add docblocks to controller methods for better code documentation
---
 .../Admin/Http/Controllers/RoleController.php | 28 +++++++++++++++++--
 app/Modules/Admin/Http/routes.php             |  1 +
 .../Resources/views/layouts/app.blade.php     |  4 +--
 .../Resources/views/roles/index.blade.php     |  2 +-
 4 files changed, 30 insertions(+), 5 deletions(-)

diff --git a/app/Modules/Admin/Http/Controllers/RoleController.php b/app/Modules/Admin/Http/Controllers/RoleController.php
index 693ed02..19e446d 100644
--- a/app/Modules/Admin/Http/Controllers/RoleController.php
+++ b/app/Modules/Admin/Http/Controllers/RoleController.php
@@ -9,18 +9,27 @@
 
 class RoleController extends Controller
 {
+    /**
+     * Display a listing of the roles.
+     */
     public function index()
     {
         $roles = Role::query()->withCount('permissions')->orderBy('name')->get();
         return view('admin::roles.index', compact('roles'));
     }
 
+    /**
+     * Show the form for creating a new role.
+     */
     public function create()
     {
         $permissions = Permission::query()->orderBy('name')->get();
         return view('admin::roles.create', compact('permissions'));
     }
 
+    /**
+     * Store a newly created role in storage.
+     */
     public function store(Request $request)
     {
         $validated = $request->validate([
@@ -36,9 +45,12 @@ public function store(Request $request)
             $role->givePermissionTo($perms);
         }
 
-        return redirect()->route('admin.roles.index')->with('success', 'Rol creado correctamente.');
+        return redirect()->route('admin.roles.index')->with('success', 'Role created successfully.');
     }
 
+    /**
+     * Show the form for editing the specified role.
+     */
     public function edit(Role $role)
     {
         $permissions = Permission::query()->orderBy('name')->get();
@@ -46,6 +58,9 @@ public function edit(Role $role)
         return view('admin::roles.edit', compact('role', 'permissions', 'selected'));
     }
 
+    /**
+     * Update the specified role in storage.
+     */
     public function update(Request $request, Role $role)
     {
         $validated = $request->validate([
@@ -60,6 +75,15 @@ public function update(Request $request, Role $role)
         $perms = $validated['permissions'] ?? [];
         $role->syncPermissions($perms);
 
-        return redirect()->route('admin.roles.index')->with('success', 'Rol actualizado correctamente.');
+        return redirect()->route('admin.roles.index')->with('success', 'Role updated successfully.');
+    }
+
+    /**
+     * Remove the specified role from storage.
+     */
+    public function destroy(Role $role)
+    {
+        $role->delete();
+        return redirect()->route('admin.roles.index')->with('success', 'Role deleted successfully.');
     }
 }
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index 4a2c759..bc52a2d 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -15,4 +15,5 @@
         Route::post('/roles', [\Modules\Admin\Http\Controllers\RoleController::class, 'store'])->name('admin.roles.store');
         Route::get('/roles/{role}/edit', [\Modules\Admin\Http\Controllers\RoleController::class, 'edit'])->name('admin.roles.edit');
         Route::put('/roles/{role}', [\Modules\Admin\Http\Controllers\RoleController::class, 'update'])->name('admin.roles.update');
+        Route::delete('/roles/{role}', [\Modules\Admin\Http\Controllers\RoleController::class, 'destroy'])->name('admin.roles.destroy');
     });
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index 0576747..5376bbc 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -155,8 +155,8 @@
                         A
                     </div>
                     <div class="flex-1 min-w-0">
-                        <div class="text-sm font-semibold truncate">Administrator</div>
-                        <div class="text-xs text-gray-400">Super Admin</div>
+                        <div class="text-sm font-semibold truncate">{{ Auth::user()->name }}</div>
+                        <div class="text-xs text-gray-400">{{ Auth::user()->roles->pluck('name')->join(', ') }}</div>
                     </div>
                     <a href="#" class="text-gray-400 hover:text-white">
                         <i class="fas fa-sign-out-alt"></i>
diff --git a/app/Modules/Admin/Resources/views/roles/index.blade.php b/app/Modules/Admin/Resources/views/roles/index.blade.php
index fab7d5a..835e1a9 100644
--- a/app/Modules/Admin/Resources/views/roles/index.blade.php
+++ b/app/Modules/Admin/Resources/views/roles/index.blade.php
@@ -43,7 +43,7 @@
                             </div>
                             <div class="flex items-center gap-2">
                                 <a href="{{ route('admin.roles.edit', $role) }}" class="px-3 py-1 bg-gray-200 text-gray-800 rounded hover:bg-gray-300 text-xs">Edit</a>
-                                <button class="px-3 py-1 bg-red-100 text-red-700 rounded hover:bg-red-200 text-xs">Delete</button>
+                                <a href="{{ route('admin.roles.destroy', $role) }}" class="px-3 py-1 bg-red-100 text-red-700 rounded hover:bg-red-200 text-xs" onclick="return confirm('Are you sure you want to delete this role?')">Delete</a>
                             </div>
                         </div>
                     </div>

From 5637d21a442e53fd344eda4d25b0d6844493b0c0 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 25 Jan 2026 18:41:55 +0100
Subject: [PATCH 038/132] build: add Dockerfile for Laravel with PHP 8.4 FPM

---
 dockerfile | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 dockerfile

diff --git a/dockerfile b/dockerfile
new file mode 100644
index 0000000..8ed6940
--- /dev/null
+++ b/dockerfile
@@ -0,0 +1,32 @@
+# Imagen base con PHP 8.4 FPM
+FROM php:8.4-fpm
+
+# Instalar dependencias del sistema y extensiones necesarias para Laravel
+RUN apt-get update && apt-get install -y \
+    git \
+    unzip \
+    libzip-dev \
+    libonig-dev \
+    libpq-dev \
+    libcurl4-openssl-dev \
+    libxml2-dev \
+    && docker-php-ext-install pdo_mysql mbstring zip exif pcntl bcmath sockets \
+    && docker-php-ext-enable pdo_mysql mbstring zip exif pcntl bcmath sockets
+
+# Instalar Composer globalmente
+COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
+
+# Crear directorio de la aplicación
+WORKDIR /app
+
+# Copiar archivos de Laravel
+COPY . .
+
+# Dar permisos de almacenamiento
+RUN chown -R www-data:www-data /app/storage /app/bootstrap/cache
+
+# Exponer puerto PHP-FPM
+EXPOSE 9000
+
+# Comando por defecto
+CMD ["php-fpm"]
\ No newline at end of file

From 74ed5ad5d397120361b15e022c2d609834422510 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 27 Jan 2026 23:06:44 +0100
Subject: [PATCH 039/132] feat(docker): add nginx and entrypoint for full web
 server setup

---
 docker/entrypoint.sh          |  6 ++++++
 docker/nginx/default-ssl.conf | 26 ++++++++++++++++++++++++++
 docker/nginx/default.conf     | 23 +++++++++++++++++++++++
 dockerfile                    | 22 ++++++++++++----------
 4 files changed, 67 insertions(+), 10 deletions(-)
 create mode 100644 docker/entrypoint.sh
 create mode 100644 docker/nginx/default-ssl.conf
 create mode 100644 docker/nginx/default.conf

diff --git a/docker/entrypoint.sh b/docker/entrypoint.sh
new file mode 100644
index 0000000..eae7051
--- /dev/null
+++ b/docker/entrypoint.sh
@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -e
+
+php-fpm &
+nginx -g "daemon off;"
+
diff --git a/docker/nginx/default-ssl.conf b/docker/nginx/default-ssl.conf
new file mode 100644
index 0000000..1cdca8a
--- /dev/null
+++ b/docker/nginx/default-ssl.conf
@@ -0,0 +1,26 @@
+server {
+    listen 443 ssl;
+    server_name _;
+
+    ssl_certificate /etc/ssl/certs/selfsigned.crt;
+    ssl_certificate_key /etc/ssl/private/selfsigned.key;
+
+    root /app/public;
+    index index.php index.html;
+
+    location / {
+        try_files $uri $uri/ /index.php?$query_string;
+    }
+
+    location ~ \.php$ {
+        include fastcgi_params;
+        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
+        fastcgi_param PATH_INFO $fastcgi_path_info;
+        fastcgi_pass 127.0.0.1:9000;
+    }
+
+    location ~* \.(css|js|jpg|jpeg|png|gif|ico|svg|webp|woff|woff2)$ {
+        expires 7d;
+        access_log off;
+    }
+}
diff --git a/docker/nginx/default.conf b/docker/nginx/default.conf
new file mode 100644
index 0000000..c566336
--- /dev/null
+++ b/docker/nginx/default.conf
@@ -0,0 +1,23 @@
+server {
+    listen 80;
+    server_name _;
+
+    root /app/public;
+    index index.php index.html;
+
+    location / {
+        try_files $uri $uri/ /index.php?$query_string;
+    }
+
+    location ~ \.php$ {
+        include fastcgi_params;
+        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
+        fastcgi_param PATH_INFO $fastcgi_path_info;
+        fastcgi_pass 127.0.0.1:9000;
+    }
+
+    location ~* \.(css|js|jpg|jpeg|png|gif|ico|svg|webp|woff|woff2)$ {
+        expires 7d;
+        access_log off;
+    }
+}
diff --git a/dockerfile b/dockerfile
index 8ed6940..01d69e4 100644
--- a/dockerfile
+++ b/dockerfile
@@ -1,7 +1,5 @@
-# Imagen base con PHP 8.4 FPM
 FROM php:8.4-fpm
 
-# Instalar dependencias del sistema y extensiones necesarias para Laravel
 RUN apt-get update && apt-get install -y \
     git \
     unzip \
@@ -10,23 +8,27 @@ RUN apt-get update && apt-get install -y \
     libpq-dev \
     libcurl4-openssl-dev \
     libxml2-dev \
+    nginx \
+    openssl \
     && docker-php-ext-install pdo_mysql mbstring zip exif pcntl bcmath sockets \
     && docker-php-ext-enable pdo_mysql mbstring zip exif pcntl bcmath sockets
 
-# Instalar Composer globalmente
 COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
 
-# Crear directorio de la aplicación
 WORKDIR /app
 
-# Copiar archivos de Laravel
 COPY . .
 
-# Dar permisos de almacenamiento
 RUN chown -R www-data:www-data /app/storage /app/bootstrap/cache
 
-# Exponer puerto PHP-FPM
-EXPOSE 9000
+# Nginx config
+COPY docker/nginx/default.conf /etc/nginx/conf.d/default.conf
+COPY docker/nginx/default-ssl.conf /etc/nginx/conf.d/default-ssl.conf
 
-# Comando por defecto
-CMD ["php-fpm"]
\ No newline at end of file
+# Entrypoint para ejecutar php-fpm y nginx
+COPY docker/entrypoint.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
+
+EXPOSE 80
+
+CMD ["/entrypoint.sh"]

From 36509732fb7884bfa0ad891f949c1439533e1c70 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 27 Jan 2026 23:22:58 +0100
Subject: [PATCH 040/132] chore: remove unused openssl package and ssl config.

---
 dockerfile | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/dockerfile b/dockerfile
index 01d69e4..00a8ceb 100644
--- a/dockerfile
+++ b/dockerfile
@@ -9,7 +9,6 @@ RUN apt-get update && apt-get install -y \
     libcurl4-openssl-dev \
     libxml2-dev \
     nginx \
-    openssl \
     && docker-php-ext-install pdo_mysql mbstring zip exif pcntl bcmath sockets \
     && docker-php-ext-enable pdo_mysql mbstring zip exif pcntl bcmath sockets
 
@@ -23,7 +22,7 @@ RUN chown -R www-data:www-data /app/storage /app/bootstrap/cache
 
 # Nginx config
 COPY docker/nginx/default.conf /etc/nginx/conf.d/default.conf
-COPY docker/nginx/default-ssl.conf /etc/nginx/conf.d/default-ssl.conf
+ 
 
 # Entrypoint para ejecutar php-fpm y nginx
 COPY docker/entrypoint.sh /entrypoint.sh

From 85dba63db3d79cfaf3abf3f3d7c91237ec080d21 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 28 Jan 2026 00:36:04 +0100
Subject: [PATCH 041/132] build: update PHP version requirement to ^8.4

---
 composer.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/composer.json b/composer.json
index 61d193a..93e56e6 100755
--- a/composer.json
+++ b/composer.json
@@ -12,7 +12,7 @@
     }
     ],
     "require": {
-        "php": "^8.2",
+        "php": "^8.4",
         "laravel/framework": "12.40.2",
         "laravel/pulse": "^1.4",
         "laravel/tinker": "2.10.1",

From afbaca97dccefb3de8b379103f47f3585feffd3c Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 28 Jan 2026 00:47:09 +0100
Subject: [PATCH 042/132] chore(docker): remove docker configuration files

---
 docker/entrypoint.sh          |  6 ------
 docker/nginx/default-ssl.conf | 26 --------------------------
 docker/nginx/default.conf     | 23 -----------------------
 dockerfile                    | 33 ---------------------------------
 4 files changed, 88 deletions(-)
 delete mode 100644 docker/entrypoint.sh
 delete mode 100644 docker/nginx/default-ssl.conf
 delete mode 100644 docker/nginx/default.conf
 delete mode 100644 dockerfile

diff --git a/docker/entrypoint.sh b/docker/entrypoint.sh
deleted file mode 100644
index eae7051..0000000
--- a/docker/entrypoint.sh
+++ /dev/null
@@ -1,6 +0,0 @@
-#!/usr/bin/env bash
-set -e
-
-php-fpm &
-nginx -g "daemon off;"
-
diff --git a/docker/nginx/default-ssl.conf b/docker/nginx/default-ssl.conf
deleted file mode 100644
index 1cdca8a..0000000
--- a/docker/nginx/default-ssl.conf
+++ /dev/null
@@ -1,26 +0,0 @@
-server {
-    listen 443 ssl;
-    server_name _;
-
-    ssl_certificate /etc/ssl/certs/selfsigned.crt;
-    ssl_certificate_key /etc/ssl/private/selfsigned.key;
-
-    root /app/public;
-    index index.php index.html;
-
-    location / {
-        try_files $uri $uri/ /index.php?$query_string;
-    }
-
-    location ~ \.php$ {
-        include fastcgi_params;
-        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
-        fastcgi_param PATH_INFO $fastcgi_path_info;
-        fastcgi_pass 127.0.0.1:9000;
-    }
-
-    location ~* \.(css|js|jpg|jpeg|png|gif|ico|svg|webp|woff|woff2)$ {
-        expires 7d;
-        access_log off;
-    }
-}
diff --git a/docker/nginx/default.conf b/docker/nginx/default.conf
deleted file mode 100644
index c566336..0000000
--- a/docker/nginx/default.conf
+++ /dev/null
@@ -1,23 +0,0 @@
-server {
-    listen 80;
-    server_name _;
-
-    root /app/public;
-    index index.php index.html;
-
-    location / {
-        try_files $uri $uri/ /index.php?$query_string;
-    }
-
-    location ~ \.php$ {
-        include fastcgi_params;
-        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
-        fastcgi_param PATH_INFO $fastcgi_path_info;
-        fastcgi_pass 127.0.0.1:9000;
-    }
-
-    location ~* \.(css|js|jpg|jpeg|png|gif|ico|svg|webp|woff|woff2)$ {
-        expires 7d;
-        access_log off;
-    }
-}
diff --git a/dockerfile b/dockerfile
deleted file mode 100644
index 00a8ceb..0000000
--- a/dockerfile
+++ /dev/null
@@ -1,33 +0,0 @@
-FROM php:8.4-fpm
-
-RUN apt-get update && apt-get install -y \
-    git \
-    unzip \
-    libzip-dev \
-    libonig-dev \
-    libpq-dev \
-    libcurl4-openssl-dev \
-    libxml2-dev \
-    nginx \
-    && docker-php-ext-install pdo_mysql mbstring zip exif pcntl bcmath sockets \
-    && docker-php-ext-enable pdo_mysql mbstring zip exif pcntl bcmath sockets
-
-COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
-
-WORKDIR /app
-
-COPY . .
-
-RUN chown -R www-data:www-data /app/storage /app/bootstrap/cache
-
-# Nginx config
-COPY docker/nginx/default.conf /etc/nginx/conf.d/default.conf
- 
-
-# Entrypoint para ejecutar php-fpm y nginx
-COPY docker/entrypoint.sh /entrypoint.sh
-RUN chmod +x /entrypoint.sh
-
-EXPOSE 80
-
-CMD ["/entrypoint.sh"]

From bf2430b6ab54a8a96ec272acc69fe0f087bc6ce5 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 28 Jan 2026 00:47:59 +0100
Subject: [PATCH 043/132] refactor(Admin): remove unused API service class

---
 app/Modules/Admin/Services/apiService.php | 46 -----------------------
 1 file changed, 46 deletions(-)
 delete mode 100644 app/Modules/Admin/Services/apiService.php

diff --git a/app/Modules/Admin/Services/apiService.php b/app/Modules/Admin/Services/apiService.php
deleted file mode 100644
index 2fb24a9..0000000
--- a/app/Modules/Admin/Services/apiService.php
+++ /dev/null
@@ -1,46 +0,0 @@
-<?php
-
-namespace Modules\Admin\Services;
-
-use Illuminate\Support\Facades\Http;
-
-class ApiService
-{
-    protected string $baseUrl = 'http://wowcms-apiwowcms-rtpsnl-03dd1f-188-245-113-32.traefik.me/api/github';
-
-    public function latestRelease(): array
-    {
-        $response = Http::timeout(5)->acceptJson()->get($this->baseUrl . '/wow-cms/nexuscms/latest');
-
-        if (!$response->ok()) {
-            return [];
-        }
-
-        $data = $response->json();
-
-        return is_array($data) ? $data : [];
-    }
-
-    public function checkVersion(string $owner, string $repo, string $current): array
-    {
-        $response = Http::timeout(5)->acceptJson()->get("{$this->baseUrl}/{$owner}/{$repo}/check-version", [
-            'current' => $current,
-        ]);
-
-        if (!$response->ok()) {
-            return [];
-        }
-
-        $data = $response->json();
-
-        if (!is_array($data)) {
-            return [];
-        }
-
-        return [
-            'current'  => $data['current']  ?? '',
-            'latest'   => $data['latest']   ?? '',
-            'outdated' => $data['outdated'] ?? false,
-        ];
-    }
-}

From da92424593e90d8f4342ad7327d7a51887d3b8f7 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 28 Jan 2026 00:48:24 +0100
Subject: [PATCH 044/132] feat(admin): add ApiService for checking GitHub
 releases and versions.

---
 app/Modules/Admin/Services/ApiService.php | 46 +++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 app/Modules/Admin/Services/ApiService.php

diff --git a/app/Modules/Admin/Services/ApiService.php b/app/Modules/Admin/Services/ApiService.php
new file mode 100644
index 0000000..2fb24a9
--- /dev/null
+++ b/app/Modules/Admin/Services/ApiService.php
@@ -0,0 +1,46 @@
+<?php
+
+namespace Modules\Admin\Services;
+
+use Illuminate\Support\Facades\Http;
+
+class ApiService
+{
+    protected string $baseUrl = 'http://wowcms-apiwowcms-rtpsnl-03dd1f-188-245-113-32.traefik.me/api/github';
+
+    public function latestRelease(): array
+    {
+        $response = Http::timeout(5)->acceptJson()->get($this->baseUrl . '/wow-cms/nexuscms/latest');
+
+        if (!$response->ok()) {
+            return [];
+        }
+
+        $data = $response->json();
+
+        return is_array($data) ? $data : [];
+    }
+
+    public function checkVersion(string $owner, string $repo, string $current): array
+    {
+        $response = Http::timeout(5)->acceptJson()->get("{$this->baseUrl}/{$owner}/{$repo}/check-version", [
+            'current' => $current,
+        ]);
+
+        if (!$response->ok()) {
+            return [];
+        }
+
+        $data = $response->json();
+
+        if (!is_array($data)) {
+            return [];
+        }
+
+        return [
+            'current'  => $data['current']  ?? '',
+            'latest'   => $data['latest']   ?? '',
+            'outdated' => $data['outdated'] ?? false,
+        ];
+    }
+}

From c02da300f7ff3a510afd928320a082498f446862 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 28 Jan 2026 01:20:40 +0100
Subject: [PATCH 045/132] feat(api): add configurable API key support for
 external requests

- Extract HTTP client configuration into reusable method
- Load API key and header from services configuration
- Maintain backward compatibility with optional API key
---
 app/Modules/Admin/Services/ApiService.php | 21 +++++++++++++++++++--
 config/services.php                       |  4 ++++
 2 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/app/Modules/Admin/Services/ApiService.php b/app/Modules/Admin/Services/ApiService.php
index 2fb24a9..0eda964 100644
--- a/app/Modules/Admin/Services/ApiService.php
+++ b/app/Modules/Admin/Services/ApiService.php
@@ -7,10 +7,27 @@
 class ApiService
 {
     protected string $baseUrl = 'http://wowcms-apiwowcms-rtpsnl-03dd1f-188-245-113-32.traefik.me/api/github';
+    protected ?string $apiKey;
+    protected string $apiKeyHeader;
+
+    public function __construct()
+    {
+        $this->apiKey = config('services.nexus_api.key');
+        $this->apiKeyHeader = config('services.nexus_api.header', 'X-API-Key');
+    }
+
+    protected function http()
+    {
+        $client = Http::timeout(5)->acceptJson();
+        if (!empty($this->apiKey)) {
+            $client = $client->withHeaders([$this->apiKeyHeader => $this->apiKey]);
+        }
+        return $client;
+    }
 
     public function latestRelease(): array
     {
-        $response = Http::timeout(5)->acceptJson()->get($this->baseUrl . '/wow-cms/nexuscms/latest');
+        $response = $this->http()->get($this->baseUrl . '/wow-cms/nexuscms/latest');
 
         if (!$response->ok()) {
             return [];
@@ -23,7 +40,7 @@ public function latestRelease(): array
 
     public function checkVersion(string $owner, string $repo, string $current): array
     {
-        $response = Http::timeout(5)->acceptJson()->get("{$this->baseUrl}/{$owner}/{$repo}/check-version", [
+        $response = $this->http()->get("{$this->baseUrl}/{$owner}/{$repo}/check-version", [
             'current' => $current,
         ]);
 
diff --git a/config/services.php b/config/services.php
index 27a3617..9ecebf0 100755
--- a/config/services.php
+++ b/config/services.php
@@ -35,4 +35,8 @@
         ],
     ],
 
+    'nexus_api' => [
+        'key' => env('NEXUS_API_KEY'),
+        'header' => env('NEXUS_API_KEY_HEADER', 'X-API-Key'),
+    ],
 ];

From 0527ed9230e5d55bfe39e5c5b578c37e45ccd6f2 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 28 Jan 2026 02:08:25 +0100
Subject: [PATCH 046/132] fix(admin): correct release notes and update links to
 open in new tab

Update the "Release notes" and "Update now" links to point to the correct GitHub release URL and open in a new tab for better user experience.
---
 app/Modules/Admin/Resources/views/index.blade.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/app/Modules/Admin/Resources/views/index.blade.php b/app/Modules/Admin/Resources/views/index.blade.php
index 06ef1ae..e716f1b 100644
--- a/app/Modules/Admin/Resources/views/index.blade.php
+++ b/app/Modules/Admin/Resources/views/index.blade.php
@@ -259,7 +259,7 @@
                             <div class="flex items-center gap-3">
                                 <a href="{{ $latestRelease['html_url'] ?? '#' }}" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
                                 <span class="text-gray-300">•</span>
-                                <a href="#" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Update now</a>
+                                <a href="https://github.com/WoW-CMS/NexusCMS/releases/tag/{{ $latestRelease['tag_name'] ?? 'N/A' }}" target="_blank" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Update now</a>
                             </div>
                         </div>
                     </div>
@@ -273,7 +273,7 @@
                             <p class="text-sm text-gray-600">Version {{ $latestRelease['tag_name'] ?? 'N/A' }}</p>
                             <p class="text-sm text-gray-600">Released on {{ $latestRelease['published_at'] ?? 'N/A' }}</p>
                             <div class="flex items-center gap-3">
-                                <a href="{{ $latestRelease['html_url'] ?? '#' }}" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
+                                <a href="https://github.com/WoW-CMS/NexusCMS/releases/tag/{{ $latestRelease['tag_name'] ?? 'N/A' }}" target="_blank" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
                                 <span class="text-gray-300">•</span>
                             </div>
                         </div>

From dc6c8fcd1702d97a5547cbbe41ca00f09b973c2e Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 28 Jan 2026 02:09:42 +0100
Subject: [PATCH 047/132] fix(admin): update admin panel link and simplify
 release notes

---
 app/Modules/Admin/Resources/views/index.blade.php | 4 +---
 resources/views/ucp/components/sidebar.blade.php  | 2 +-
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/app/Modules/Admin/Resources/views/index.blade.php b/app/Modules/Admin/Resources/views/index.blade.php
index e716f1b..967fa32 100644
--- a/app/Modules/Admin/Resources/views/index.blade.php
+++ b/app/Modules/Admin/Resources/views/index.blade.php
@@ -257,9 +257,7 @@
                             <p class="text-base text-gray-800 font-semibold mb-1">NexusCMS v{{ $latestRelease['tag_name'] ?? 'N/A' }} is now available</p>
                             <p class="text-sm text-gray-600 mb-3">{{ $latestRelease['body'] ?? 'N/A' }}</p>
                             <div class="flex items-center gap-3">
-                                <a href="{{ $latestRelease['html_url'] ?? '#' }}" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
-                                <span class="text-gray-300">•</span>
-                                <a href="https://github.com/WoW-CMS/NexusCMS/releases/tag/{{ $latestRelease['tag_name'] ?? 'N/A' }}" target="_blank" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Update now</a>
+                                <a href="https://github.com/WoW-CMS/NexusCMS/releases/tag/{{ $latestRelease['tag_name'] ?? 'N/A' }}" target="_blank" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
                             </div>
                         </div>
                     </div>
diff --git a/resources/views/ucp/components/sidebar.blade.php b/resources/views/ucp/components/sidebar.blade.php
index c7bcb5c..6a518e1 100755
--- a/resources/views/ucp/components/sidebar.blade.php
+++ b/resources/views/ucp/components/sidebar.blade.php
@@ -46,7 +46,7 @@
             @if($user->hasRole('Admin'))
             <div class="mt-6 pt-6 border-t border-slate-700/50">
                 <p class="px-4 text-xs font-semibold text-gray-500 uppercase tracking-wider mb-3">ADMIN</p>
-                <a href="#" class="flex items-center space-x-3 px-4 py-3 rounded-xl text-gray-400 hover:bg-slate-700/50 hover:text-white transition-all duration-200">
+                <a href="{{ route('admin.index') }}" class="flex items-center space-x-3 px-4 py-3 rounded-xl text-gray-400 hover:bg-slate-700/50 hover:text-white transition-all duration-200">
                     <i class="fas fa-cog w-5"></i>
                     <span class="font-medium">Admin Panel</span>
                 </a>

From 224238b67333500050d737a6296f44cdb60240c5 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 28 Jan 2026 18:33:53 +0100
Subject: [PATCH 048/132] refactor(admin): replace role checks with
 authorization gates

- Use Laravel's `@can` directives instead of direct role checks in sidebar
- Add named route for admin index to improve maintainability
---
 app/Modules/Admin/Http/Controllers/AdminController.php | 9 ++++++++-
 app/Modules/Admin/Http/routes.php                      | 2 +-
 resources/views/ucp/components/sidebar.blade.php       | 8 ++++----
 3 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/app/Modules/Admin/Http/Controllers/AdminController.php b/app/Modules/Admin/Http/Controllers/AdminController.php
index 7a9796a..b8eb0b7 100644
--- a/app/Modules/Admin/Http/Controllers/AdminController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminController.php
@@ -4,6 +4,7 @@
 
 use App\Http\Controllers\Controller;
 use Modules\Admin\Services\ApiService;
+use Illuminate\Http\Request;
 
 class AdminController extends Controller
 {
@@ -14,8 +15,14 @@ public function __construct(ApiService $apiService)
         $this->apiService = $apiService;
     }
 
-    public function index()
+    public function index(Request $request)
     {
+        dump($request->user()->cannot('access.admin.panel'));
+        die();
+        if (!$request->user()->cannot('access.admin.panel')) {
+            return abort(403);
+        }
+
         $latestRelease = $this->apiService->latestRelease();
         $checkVersion = $this->apiService->checkVersion('wow-cms', 'nexuscms', config('app.version'));
 
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index bc52a2d..971309d 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -6,7 +6,7 @@
 Route::middleware(['auth', 'role:Admin', 'web'])
     ->prefix(strtolower('acp'))
     ->group(function () {
-        Route::get('/', [\Modules\Admin\Http\Controllers\AdminController::class, 'index']);
+        Route::get('/', [\Modules\Admin\Http\Controllers\AdminController::class, 'index'])->name('admin.index');
         Route::get('/permissions', [\Modules\Admin\Http\Controllers\PermissionController::class, 'index'])->name('admin.permissions');
         
         // Roles
diff --git a/resources/views/ucp/components/sidebar.blade.php b/resources/views/ucp/components/sidebar.blade.php
index 6a518e1..b3079dc 100755
--- a/resources/views/ucp/components/sidebar.blade.php
+++ b/resources/views/ucp/components/sidebar.blade.php
@@ -33,7 +33,7 @@
                 </a>
             </div>
 
-            @if($user->hasRole(['GameMaster', 'Admin']))
+            @can('access.gm.panel')
             <div class="mt-6 pt-6 border-t border-slate-700/50">
                 <p class="px-4 text-xs font-semibold text-gray-500 uppercase tracking-wider mb-3">GAMEMASTER</p>
                 <a href="#" class="flex items-center space-x-3 px-4 py-3 rounded-xl text-gray-400 hover:bg-slate-700/50 hover:text-white transition-all duration-200">
@@ -41,9 +41,9 @@
                     <span class="font-medium">GM Panel</span>
                 </a>
             </div>
-            @endif
+            @endcan
 
-            @if($user->hasRole('Admin'))
+            @can('access.admin.panel')
             <div class="mt-6 pt-6 border-t border-slate-700/50">
                 <p class="px-4 text-xs font-semibold text-gray-500 uppercase tracking-wider mb-3">ADMIN</p>
                 <a href="{{ route('admin.index') }}" class="flex items-center space-x-3 px-4 py-3 rounded-xl text-gray-400 hover:bg-slate-700/50 hover:text-white transition-all duration-200">
@@ -51,7 +51,7 @@
                     <span class="font-medium">Admin Panel</span>
                 </a>
             </div>
-            @endif
+            @endcan
         </nav>
     </div>
 </aside>
\ No newline at end of file

From 2ff1ca9426a5ca5060399e44fdbedac748cf0e87 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 28 Jan 2026 18:34:48 +0100
Subject: [PATCH 049/132] fix(admin): remove debug code and incorrect
 permission check

---
 app/Modules/Admin/Http/Controllers/AdminController.php | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/app/Modules/Admin/Http/Controllers/AdminController.php b/app/Modules/Admin/Http/Controllers/AdminController.php
index b8eb0b7..5dfdca4 100644
--- a/app/Modules/Admin/Http/Controllers/AdminController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminController.php
@@ -17,12 +17,6 @@ public function __construct(ApiService $apiService)
 
     public function index(Request $request)
     {
-        dump($request->user()->cannot('access.admin.panel'));
-        die();
-        if (!$request->user()->cannot('access.admin.panel')) {
-            return abort(403);
-        }
-
         $latestRelease = $this->apiService->latestRelease();
         $checkVersion = $this->apiService->checkVersion('wow-cms', 'nexuscms', config('app.version'));
 

From 4a2c06596d54fd5c97e0cbdcb36d3aee61bb7ff5 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 29 Jan 2026 00:26:44 +0100
Subject: [PATCH 050/132] feat(admin): add user management module

- Add migration to extend users table with status, last_login_at, is_banned, and notes
- Create AdminUserController with full CRUD operations for administrative users
- Add user management routes and navigation link in admin sidebar
- Implement create, edit, and index views for user administration
- Extend permission seeder with additional admin and user permissions
- Include DonationPlansSeeder in database seeder
---
 .../Http/Controllers/AdminUserController.php  |  92 +++++++++++
 app/Modules/Admin/Http/routes.php             |   8 +
 .../Resources/views/layouts/app.blade.php     |   2 +-
 .../Resources/views/users/create.blade.php    |  67 ++++++++
 .../Resources/views/users/edit.blade.php      |  69 +++++++++
 .../Resources/views/users/index.blade.php     | 144 ++++++++++++++++++
 ..._170000_alter_users_add_status_options.php |  26 ++++
 database/seeders/DatabaseSeeder.php           |   1 +
 .../seeders/RolesAndPermissionsSeeder.php     |  37 ++++-
 9 files changed, 443 insertions(+), 3 deletions(-)
 create mode 100644 app/Modules/Admin/Http/Controllers/AdminUserController.php
 create mode 100644 app/Modules/Admin/Resources/views/users/create.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/users/edit.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/users/index.blade.php
 create mode 100644 database/migrations/2026_01_28_170000_alter_users_add_status_options.php

diff --git a/app/Modules/Admin/Http/Controllers/AdminUserController.php b/app/Modules/Admin/Http/Controllers/AdminUserController.php
new file mode 100644
index 0000000..e4f5625
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/AdminUserController.php
@@ -0,0 +1,92 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Models\User;
+use Illuminate\Http\Request;
+use Illuminate\Validation\Rule;
+use Spatie\Permission\Models\Role;
+
+class AdminUserController extends Controller
+{
+    public function index()
+    {
+        $users = User::orderBy('name')->paginate(15);
+        return view('admin::users.index', compact('users'));
+    }
+
+    public function create()
+    {
+        $roles = Role::orderBy('name')->get();
+        return view('admin::users.create', compact('roles'));
+    }
+
+    public function store(Request $request)
+    {
+        $validated = $request->validate([
+            'name' => ['required', 'string', 'max:100'],
+            'email' => ['required', 'email', 'max:255', 'unique:users,email'],
+            'password' => ['required', 'string', 'min:8'],
+            'roles' => ['array'],
+            'roles.*' => ['string', 'exists:roles,name'],
+        ]);
+
+        $user = new User();
+        $user->name = $validated['name'];
+        $user->email = $validated['email'];
+        $user->password = $validated['password'];
+        $user->save();
+
+        $roles = $validated['roles'] ?? [];
+        if (!in_array('Admin', $roles, true)) {
+            $roles[] = 'Admin';
+        }
+        $user->syncRoles($roles);
+
+        return redirect()->route('admin.users.index')->with('success', 'Administrador creado');
+    }
+
+    public function edit(User $user)
+    {
+        $roles = Role::orderBy('name')->get();
+        $assigned = $user->roles()->pluck('name')->toArray();
+        return view('admin::users.edit', compact('user', 'roles', 'assigned'));
+    }
+
+    public function update(Request $request, User $user)
+    {
+        $validated = $request->validate([
+            'name' => ['required', 'string', 'max:100'],
+            'email' => ['required', 'email', 'max:255', Rule::unique('users', 'email')->ignore($user->id)],
+            'password' => ['nullable', 'string', 'min:8'],
+            'roles' => ['array'],
+            'roles.*' => ['string', 'exists:roles,name'],
+        ]);
+
+        $user->name = $validated['name'];
+        $user->email = $validated['email'];
+        if (!empty($validated['password'])) {
+            $user->password = $validated['password'];
+        }
+        $user->save();
+
+        $roles = $validated['roles'] ?? [];
+        if (!in_array('Admin', $roles, true)) {
+            $roles[] = 'Admin';
+        }
+        $user->syncRoles($roles);
+
+        return redirect()->route('admin.users.index')->with('success', 'Administrador actualizado');
+    }
+
+    public function destroy(User $user)
+    {
+        if ($user->hasRole('Admin')) {
+            $user->delete();
+            return redirect()->route('admin.users.index')->with('success', 'Administrador eliminado');
+        }
+        return redirect()->route('admin.users.index')->with('error', 'El usuario no es administrador');
+    }
+}
+
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index 971309d..a080335 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -16,4 +16,12 @@
         Route::get('/roles/{role}/edit', [\Modules\Admin\Http\Controllers\RoleController::class, 'edit'])->name('admin.roles.edit');
         Route::put('/roles/{role}', [\Modules\Admin\Http\Controllers\RoleController::class, 'update'])->name('admin.roles.update');
         Route::delete('/roles/{role}', [\Modules\Admin\Http\Controllers\RoleController::class, 'destroy'])->name('admin.roles.destroy');
+        
+        // Administrative Users
+        Route::get('/users', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'index'])->name('admin.users.index');
+        Route::get('/users/create', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'create'])->name('admin.users.create');
+        Route::post('/users', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'store'])->name('admin.users.store');
+        Route::get('/users/{user}/edit', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'edit'])->name('admin.users.edit');
+        Route::put('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'update'])->name('admin.users.update');
+        Route::delete('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'destroy'])->name('admin.users.destroy');
     });
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index 5376bbc..7a0c6a7 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -60,7 +60,7 @@
 
                 <div class="px-3 mb-4">
                     <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Management</h3>
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                    <a href="{{ route('admin.users.index') }}" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-users w-5"></i>
                         <span>Users</span>
                     </a>
diff --git a/app/Modules/Admin/Resources/views/users/create.blade.php b/app/Modules/Admin/Resources/views/users/create.blade.php
new file mode 100644
index 0000000..ca22fe5
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/users/create.blade.php
@@ -0,0 +1,67 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Crear Administrador')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">Crear administrador</h1>
+    </div>
+    <div class="flex items-center gap-3">
+        <a href="{{ route('admin.users.index') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
+            Volver
+        </a>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <form method="POST" action="{{ route('admin.users.store') }}" class="space-y-6">
+        @csrf
+        <div class="bg-white rounded-lg shadow">
+            <div class="p-6 border-b border-gray-200">
+                <h2 class="text-lg font-bold text-gray-800">Datos</h2>
+            </div>
+            <div class="p-6 grid grid-cols-1 md:grid-cols-2 gap-4">
+                <div>
+                    <label class="block text-sm font-medium text-gray-700">Nombre</label>
+                    <input name="name" value="{{ old('name') }}" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    @error('name')<p class="text-sm text-red-600 mt-1">{{ $message }}</p>@enderror
+                </div>
+                <div>
+                    <label class="block text-sm font-medium text-gray-700">Email</label>
+                    <input type="email" name="email" value="{{ old('email') }}" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    @error('email')<p class="text-sm text-red-600 mt-1">{{ $message }}</p>@enderror
+                </div>
+                <div>
+                    <label class="block text-sm font-medium text-gray-700">Password</label>
+                    <input type="password" name="password" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    @error('password')<p class="text-sm text-red-600 mt-1">{{ $message }}</p>@enderror
+                </div>
+            </div>
+        </div>
+
+        <div class="bg-white rounded-lg shadow">
+            <div class="p-6 border-b border-gray-200">
+                <h2 class="text-lg font-bold text-gray-800">Roles</h2>
+                <p class="text-sm text-gray-600">Admin se asigna automáticamente.</p>
+            </div>
+            <div class="p-6">
+                <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-3">
+                    @foreach($roles as $role)
+                        <label class="flex items-center gap-2 p-3 bg-gray-50 border border-gray-200 rounded">
+                            <input type="checkbox" name="roles[]" value="{{ $role->name }}" class="rounded">
+                            <span class="text-sm text-gray-800">{{ $role->name }}</span>
+                        </label>
+                    @endforeach
+                </div>
+            </div>
+            <div class="p-6 border-t border-gray-200 flex items-center justify-end gap-3">
+                <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                    Crear
+                </button>
+            </div>
+        </div>
+    </form>
+</main>
+@endsection
+
diff --git a/app/Modules/Admin/Resources/views/users/edit.blade.php b/app/Modules/Admin/Resources/views/users/edit.blade.php
new file mode 100644
index 0000000..dde383e
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/users/edit.blade.php
@@ -0,0 +1,69 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Editar Administrador')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">Editar administrador</h1>
+    </div>
+    <div class="flex items-center gap-3">
+        <a href="{{ route('admin.users.index') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
+            Volver
+        </a>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <form method="POST" action="{{ route('admin.users.update', $user) }}" class="space-y-6">
+        @csrf
+        @method('PUT')
+        <div class="bg-white rounded-lg shadow">
+            <div class="p-6 border-b border-gray-200">
+                <h2 class="text-lg font-bold text-gray-800">Datos</h2>
+            </div>
+            <div class="p-6 grid grid-cols-1 md:grid-cols-2 gap-4">
+                <div>
+                    <label class="block text-sm font-medium text-gray-700">Nombre</label>
+                    <input name="name" value="{{ old('name', $user->name) }}" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    @error('name')<p class="text-sm text-red-600 mt-1">{{ $message }}</p>@enderror
+                </div>
+                <div>
+                    <label class="block text-sm font-medium text-gray-700">Email</label>
+                    <input type="email" name="email" value="{{ old('email', $user->email) }}" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    @error('email')<p class="text-sm text-red-600 mt-1">{{ $message }}</p>@enderror
+                </div>
+                <div>
+                    <label class="block text-sm font-medium text-gray-700">Password (opcional)</label>
+                    <input type="password" name="password" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    @error('password')<p class="text-sm text-red-600 mt-1">{{ $message }}</p>@enderror
+                </div>
+            </div>
+        </div>
+
+        <div class="bg-white rounded-lg shadow">
+            <div class="p-6 border-b border-gray-200">
+                <h2 class="text-lg font-bold text-gray-800">Roles</h2>
+                <p class="text-sm text-gray-600">Admin se mantiene asignado.</p>
+            </div>
+            <div class="p-6">
+                <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-3">
+                    @foreach($roles as $role)
+                        <label class="flex items-center gap-2 p-3 bg-gray-50 border border-gray-200 rounded">
+                            <input type="checkbox" name="roles[]" value="{{ $role->name }}" class="rounded"
+                                   @checked(in_array($role->name, $assigned))>
+                            <span class="text-sm text-gray-800">{{ $role->name }}</span>
+                        </label>
+                    @endforeach
+                </div>
+            </div>
+            <div class="p-6 border-t border-gray-200 flex items-center justify-end gap-3">
+                <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                    Guardar
+                </button>
+            </div>
+        </div>
+    </form>
+</main>
+@endsection
+
diff --git a/app/Modules/Admin/Resources/views/users/index.blade.php b/app/Modules/Admin/Resources/views/users/index.blade.php
new file mode 100644
index 0000000..ea39c94
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/users/index.blade.php
@@ -0,0 +1,144 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Users')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">Users</h1>
+    </div>
+    <div class="flex items-center gap-3">
+        <a href="{{ route('admin.users.create') }}" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+            Create User
+        </a>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if(session('success'))                
+        <div class="mb-4 p-3 bg-green-50 text-green-700 border border-green-200 rounded-lg flex items-center gap-2">
+            <i class="fas fa-check-circle text-green-500"></i>
+            {{ session('success') }}
+        </div>
+    @endif
+    @if(session('error'))
+        <div class="mb-4 p-3 bg-red-50 text-red-700 border border-red-200 rounded-lg flex items-center gap-2">
+            <i class="fas fa-exclamation-circle text-red-500"></i>
+            {{ session('error') }}
+        </div>
+    @endif
+    <div class="bg-white rounded-lg shadow mb-6 p-6">
+        <div class="grid grid-cols-1 md:grid-cols-4 gap-4">
+            <div class="relative">
+                <i class="fas fa-search absolute left-3 top-1/2 -translate-y-1/2 text-gray-400"></i>
+                <input type="text" placeholder="Search by name or email..." class="w-full pl-10 pr-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+            </div>
+            <select class="px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <option>All Status</option>
+                <option>Active</option>
+                <option>Banned</option>
+                <option>Suspended</option>
+            </select>
+            <select class="px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <option>All Roles</option>
+                <option>Admin</option>
+                <option>Moderator</option>
+                <option>User</option>
+            </select>
+            <button class="px-4 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300 font-medium flex items-center justify-center gap-2">
+                <i class="fas fa-redo"></i>
+                Reset Filters
+            </button>
+        </div>
+    </div>
+    
+    <!-- Users Table -->
+    <div class="bg-white rounded-lg shadow">
+        <div class="p-6 border-b border-gray-200 flex items-center justify-between">
+            <h2 class="text-lg font-bold text-gray-800">User List</h2>
+            <div class="flex items-center gap-2">
+                <button class="px-3 py-1 text-sm text-gray-600 hover:text-gray-800">
+                    <i class="fas fa-download mr-1"></i> Export
+                </button>
+                <button class="px-3 py-1 text-sm text-gray-600 hover:text-gray-800">
+                    <i class="fas fa-filter mr-1"></i> Filter
+                </button>
+            </div>
+        </div>
+        
+        <div class="p-6">
+            <div class="overflow-x-auto">
+                <table class="min-w-full">
+                    <thead>
+                        <tr class="text-left text-gray-600 text-sm border-b">
+                            <th class="px-4 py-3 font-semibold">
+                                <input type="checkbox" class="rounded border-gray-300">
+                            </th>
+                            <th class="px-4 py-3 font-semibold">User</th>
+                            <th class="px-4 py-3 font-semibold">Email</th>
+                            <th class="px-4 py-3 font-semibold">Status</th>
+                            <th class="px-4 py-3 font-semibold">Role</th>
+                            <th class="px-4 py-3 font-semibold">Registered</th>
+                            <th class="px-4 py-3 font-semibold">Actions</th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        @forelse($users as $user)
+                            <!-- User Row 1 -->
+                            <tr class="border-b hover:bg-gray-50">
+                                <td class="px-4 py-4">
+                                    <input type="checkbox" class="rounded border-gray-300">
+                                </td>
+                                <td class="px-4 py-4">
+                                    <div class="flex items-center gap-3">
+                                        <div class="w-10 h-10 bg-blue-600 rounded-full flex items-center justify-center text-white font-bold">
+                                            JD
+                                        </div>
+                                        <div>
+                                            <div class="font-semibold text-gray-800">{{ $user->name }}</div>
+                                            <div class="text-xs text-gray-500">ID: {{ $user->id }}</div>
+                                        </div>
+                                    </div>
+                                </td>
+                                <td class="px-4 py-4 text-gray-600">{{ $user->email }}</td>
+                                <td class="px-4 py-4">
+                                    @if($user->status === 'active')
+                                        <span class="px-2 py-1 bg-green-100 text-green-700 rounded-full text-xs font-medium">
+                                            Active
+                                        </span>
+                                    @else
+                                        <span class="px-2 py-1 bg-red-100 text-red-700 rounded-full text-xs font-medium">
+                                            {{ $user->status }}
+                                        </span>
+                                    @endif
+                                </td>
+                                <td class="px-4 py-4">
+                                    <span class="px-2 py-1 bg-blue-100 text-blue-700 rounded text-xs font-medium">{{ $user->roles->pluck('name')->implode(', ') }}</span>
+                                </td>
+                                <td class="px-4 py-4 text-gray-600 text-sm">{{ $user->created_at->format('d/m/Y H:i:s') }}</td>    
+                                <td class="px-4 py-4">
+                                    <div class="flex items-center gap-2">
+                                        <a href="{{ route('admin.users.edit', $user->id) }}" class="px-3 py-1 bg-blue-100 text-blue-700 rounded hover:bg-blue-200 text-xs font-medium">
+                                            <i class="fas fa-edit"></i> Edit
+                                        </a>
+                                        <a href="{{ route('admin.users.destroy', $user->id) }}" class="px-3 py-1 bg-red-100 text-red-700 rounded hover:bg-red-200 text-xs font-medium">
+                                            <i class="fas fa-trash"></i> Delete
+                                        </a>
+                                    </div>
+                                </td>
+                            </tr>
+                        @empty
+                            <tr>
+                                <td colspan="4" class="px-3 py-4 text-gray-600">No hay usuarios.</td>
+                            </tr>
+                        @endforelse
+                    </tbody>
+                </table>
+            </div>
+            <div class="mt-4">
+                {{ $users->links() }}
+            </div>
+        </div>
+    </div>
+</main>
+@endsection
diff --git a/database/migrations/2026_01_28_170000_alter_users_add_status_options.php b/database/migrations/2026_01_28_170000_alter_users_add_status_options.php
new file mode 100644
index 0000000..868e270
--- /dev/null
+++ b/database/migrations/2026_01_28_170000_alter_users_add_status_options.php
@@ -0,0 +1,26 @@
+<?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::table('users', function (Blueprint $table) {
+            $table->string('status')->default('active')->index();
+            $table->timestamp('last_login_at')->nullable();
+            $table->boolean('is_banned')->default(false);
+            $table->text('notes')->nullable();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            $table->dropColumn(['status', 'last_login_at', 'is_banned', 'notes']);
+        });
+    }
+};
+
diff --git a/database/seeders/DatabaseSeeder.php b/database/seeders/DatabaseSeeder.php
index 048cb4a..a5e99e1 100755
--- a/database/seeders/DatabaseSeeder.php
+++ b/database/seeders/DatabaseSeeder.php
@@ -9,6 +9,7 @@ class DatabaseSeeder extends Seeder
     public function run(): void
     {
         $this->call([
+            DonationPlansSeeder::class,
             RolesAndPermissionsSeeder::class,
         ]);
     }
diff --git a/database/seeders/RolesAndPermissionsSeeder.php b/database/seeders/RolesAndPermissionsSeeder.php
index 3f1c2eb..ef89b9d 100755
--- a/database/seeders/RolesAndPermissionsSeeder.php
+++ b/database/seeders/RolesAndPermissionsSeeder.php
@@ -20,6 +20,19 @@ public function run(): void
         Permission::create(['name' => 'manage.users']);
         Permission::create(['name' => 'manage.news']);
         Permission::create(['name' => 'manage.settings']);
+        Permission::create(['name' => 'manage.admin.users']);
+        Permission::create(['name' => 'manage.roles']);
+        Permission::create(['name' => 'manage.permissions']);
+        Permission::create(['name' => 'manage.pages']);
+        Permission::create(['name' => 'manage.announcements']);
+        Permission::create(['name' => 'view.logs']);
+        Permission::create(['name' => 'manage.backups']);
+        Permission::create(['name' => 'manage.realms']);
+        Permission::create(['name' => 'manage.bans']);
+        Permission::create(['name' => 'manage.reports']);
+        Permission::create(['name' => 'manage.store.products']);
+        Permission::create(['name' => 'manage.store.categories']);
+        Permission::create(['name' => 'view.store.transactions']);
         
         // Permisos para GameMasters
         Permission::create(['name' => 'access.gm.panel']);
@@ -31,6 +44,16 @@ public function run(): void
         Permission::create(['name' => 'access.ucp']);
         Permission::create(['name' => 'manage.own.account']);
         Permission::create(['name' => 'view.characters']);
+        Permission::create(['name' => 'view.news']);
+        Permission::create(['name' => 'comment.news']);
+        Permission::create(['name' => 'forums.create.thread']);
+        Permission::create(['name' => 'forums.reply.post']);
+        Permission::create(['name' => 'forums.edit.own.post']);
+        Permission::create(['name' => 'forums.delete.own.post']);
+        Permission::create(['name' => 'store.browse']);
+        Permission::create(['name' => 'store.purchase']);
+        Permission::create(['name' => 'donate.browse']);
+        Permission::create(['name' => 'donate.purchase']);
 
         // Crear roles y asignar permisos
         $adminRole = Role::create(['name' => 'Admin']);
@@ -51,7 +74,17 @@ public function run(): void
         $userRole->givePermissionTo([
             'access.ucp',
             'manage.own.account',
-            'view.characters'
+            'view.characters',
+            'view.news',
+            'comment.news',
+            'forums.create.thread',
+            'forums.reply.post',
+            'forums.edit.own.post',
+            'forums.delete.own.post',
+            'store.browse',
+            'store.purchase',
+            'donate.browse',
+            'donate.purchase',
         ]);
     }
-}
\ No newline at end of file
+}

From 785cf258ed08f98c982ae836274b2c35180df869 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 29 Jan 2026 20:09:31 +0100
Subject: [PATCH 051/132] refactor(admin): remove automatic Admin role
 assignment and update messages

---
 .../Http/Controllers/AdminUserController.php      | 15 +++++----------
 1 file changed, 5 insertions(+), 10 deletions(-)

diff --git a/app/Modules/Admin/Http/Controllers/AdminUserController.php b/app/Modules/Admin/Http/Controllers/AdminUserController.php
index e4f5625..de117f6 100644
--- a/app/Modules/Admin/Http/Controllers/AdminUserController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminUserController.php
@@ -39,12 +39,9 @@ public function store(Request $request)
         $user->save();
 
         $roles = $validated['roles'] ?? [];
-        if (!in_array('Admin', $roles, true)) {
-            $roles[] = 'Admin';
-        }
         $user->syncRoles($roles);
 
-        return redirect()->route('admin.users.index')->with('success', 'Administrador creado');
+        return redirect()->route('admin.users.index')->with('success', 'User created successfully');
     }
 
     public function edit(User $user)
@@ -72,21 +69,19 @@ public function update(Request $request, User $user)
         $user->save();
 
         $roles = $validated['roles'] ?? [];
-        if (!in_array('Admin', $roles, true)) {
-            $roles[] = 'Admin';
-        }
+
         $user->syncRoles($roles);
 
-        return redirect()->route('admin.users.index')->with('success', 'Administrador actualizado');
+        return redirect()->route('admin.users.index')->with('success', 'User updated successfully');
     }
 
     public function destroy(User $user)
     {
         if ($user->hasRole('Admin')) {
             $user->delete();
-            return redirect()->route('admin.users.index')->with('success', 'Administrador eliminado');
+            return redirect()->route('admin.users.index')->with('success', 'User deleted successfully');
         }
-        return redirect()->route('admin.users.index')->with('error', 'El usuario no es administrador');
+        return redirect()->route('admin.users.index')->with('error', 'The user is not an administrator');
     }
 }
 

From 394704431f4c18fb9bbc46ac3c5abc1f0a8b882f Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 29 Jan 2026 20:11:39 +0100
Subject: [PATCH 052/132] fix(seeder): prevent duplicate permissions and roles
 on re-run

---
 .../seeders/RolesAndPermissionsSeeder.php     | 80 +++++++++----------
 1 file changed, 40 insertions(+), 40 deletions(-)

diff --git a/database/seeders/RolesAndPermissionsSeeder.php b/database/seeders/RolesAndPermissionsSeeder.php
index ef89b9d..4a52b76 100755
--- a/database/seeders/RolesAndPermissionsSeeder.php
+++ b/database/seeders/RolesAndPermissionsSeeder.php
@@ -16,51 +16,51 @@ public function run(): void
 
         // Crear permisos
         // Permisos para administración general
-        Permission::create(['name' => 'access.admin.panel']);
-        Permission::create(['name' => 'manage.users']);
-        Permission::create(['name' => 'manage.news']);
-        Permission::create(['name' => 'manage.settings']);
-        Permission::create(['name' => 'manage.admin.users']);
-        Permission::create(['name' => 'manage.roles']);
-        Permission::create(['name' => 'manage.permissions']);
-        Permission::create(['name' => 'manage.pages']);
-        Permission::create(['name' => 'manage.announcements']);
-        Permission::create(['name' => 'view.logs']);
-        Permission::create(['name' => 'manage.backups']);
-        Permission::create(['name' => 'manage.realms']);
-        Permission::create(['name' => 'manage.bans']);
-        Permission::create(['name' => 'manage.reports']);
-        Permission::create(['name' => 'manage.store.products']);
-        Permission::create(['name' => 'manage.store.categories']);
-        Permission::create(['name' => 'view.store.transactions']);
+        Permission::firstOrCreate(['name' => 'access.admin.panel']);
+        Permission::firstOrCreate(['name' => 'manage.users']);
+        Permission::firstOrCreate(['name' => 'manage.news']);
+        Permission::firstOrCreate(['name' => 'manage.settings']);
+        Permission::firstOrCreate(['name' => 'manage.admin.users']);
+        Permission::firstOrCreate(['name' => 'manage.roles']);
+        Permission::firstOrCreate(['name' => 'manage.permissions']);
+        Permission::firstOrCreate(['name' => 'manage.pages']);
+        Permission::firstOrCreate(['name' => 'manage.announcements']);
+        Permission::firstOrCreate(['name' => 'view.logs']);
+        Permission::firstOrCreate(['name' => 'manage.backups']);
+        Permission::firstOrCreate(['name' => 'manage.realms']);
+        Permission::firstOrCreate(['name' => 'manage.bans']);
+        Permission::firstOrCreate(['name' => 'manage.reports']);
+        Permission::firstOrCreate(['name' => 'manage.store.products']);
+        Permission::firstOrCreate(['name' => 'manage.store.categories']);
+        Permission::firstOrCreate(['name' => 'view.store.transactions']);
         
         // Permisos para GameMasters
-        Permission::create(['name' => 'access.gm.panel']);
-        Permission::create(['name' => 'manage.characters']);
-        Permission::create(['name' => 'manage.items']);
-        Permission::create(['name' => 'moderate.chat']);
+        Permission::firstOrCreate(['name' => 'access.gm.panel']);
+        Permission::firstOrCreate(['name' => 'manage.characters']);
+        Permission::firstOrCreate(['name' => 'manage.items']);
+        Permission::firstOrCreate(['name' => 'moderate.chat']);
         
         // Permisos para usuarios normales
-        Permission::create(['name' => 'access.ucp']);
-        Permission::create(['name' => 'manage.own.account']);
-        Permission::create(['name' => 'view.characters']);
-        Permission::create(['name' => 'view.news']);
-        Permission::create(['name' => 'comment.news']);
-        Permission::create(['name' => 'forums.create.thread']);
-        Permission::create(['name' => 'forums.reply.post']);
-        Permission::create(['name' => 'forums.edit.own.post']);
-        Permission::create(['name' => 'forums.delete.own.post']);
-        Permission::create(['name' => 'store.browse']);
-        Permission::create(['name' => 'store.purchase']);
-        Permission::create(['name' => 'donate.browse']);
-        Permission::create(['name' => 'donate.purchase']);
+        Permission::firstOrCreate(['name' => 'access.ucp']);
+        Permission::firstOrCreate(['name' => 'manage.own.account']);
+        Permission::firstOrCreate(['name' => 'view.characters']);
+        Permission::firstOrCreate(['name' => 'view.news']);
+        Permission::firstOrCreate(['name' => 'comment.news']);
+        Permission::firstOrCreate(['name' => 'forums.create.thread']);
+        Permission::firstOrCreate(['name' => 'forums.reply.post']);
+        Permission::firstOrCreate(['name' => 'forums.edit.own.post']);
+        Permission::firstOrCreate(['name' => 'forums.delete.own.post']);
+        Permission::firstOrCreate(['name' => 'store.browse']);
+        Permission::firstOrCreate(['name' => 'store.purchase']);
+        Permission::firstOrCreate(['name' => 'donate.browse']);
+        Permission::firstOrCreate(['name' => 'donate.purchase']);
 
         // Crear roles y asignar permisos
-        $adminRole = Role::create(['name' => 'Admin']);
-        $adminRole->givePermissionTo(Permission::all());
+        $adminRole = Role::firstOrCreate(['name' => 'Admin']);
+        $adminRole->syncPermissions(Permission::all());
 
-        $gmRole = Role::create(['name' => 'GameMaster']);
-        $gmRole->givePermissionTo([
+        $gmRole = Role::firstOrCreate(['name' => 'GameMaster']);
+        $gmRole->syncPermissions([
             'access.gm.panel',
             'manage.characters',
             'manage.items',
@@ -70,8 +70,8 @@ public function run(): void
             'view.characters'
         ]);
 
-        $userRole = Role::create(['name' => 'User']);
-        $userRole->givePermissionTo([
+        $userRole = Role::firstOrCreate(['name' => 'User']);
+        $userRole->syncPermissions([
             'access.ucp',
             'manage.own.account',
             'view.characters',

From fdab27371d70d9033a4538e7bf1fd0b3b9ac49e8 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 30 Jan 2026 01:37:01 +0100
Subject: [PATCH 053/132] docs: update README with project background and
 installation guide

---
 README.md | 44 +++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 39 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 35c1df1..22f26da 100755
--- a/README.md
+++ b/README.md
@@ -8,14 +8,48 @@
 
 ## About NexusCMS
 
-NexusCMS is a modern Content Management System built with Laravel. Currently under active development, this project aims to provide a flexible and powerful solution for managing digital content.
+Born from our earlier BlizzCMS, a PHP/CodeIgniter 3 project, NexusCMS is a Laravel-based platform engineered for teams that demand reliability, flexibility, and developer-friendly architecture. We have distilled years of client feedback, security audits, and performance tuning into a single codebase that grows with your business, not against it.
 
-## Project Status
+## Key Highlights
 
-🚧 **Currently Under Development** 🚧
+- **Years of Expertise** – Over a decade of focused development on CMS architecture and implementation.  
+- **Laravel 12.x Core** – Modern PHP foundation with strict PSR standards and battle-tested packages.  
+- **Scalable Infrastructure** – Multi-database, Redis cache, queue workers, and horizontal scaling support.  
 
-This project is in its early stages of development. Features and documentation will be updated regularly.
+## Project Maturity
 
-## Installation
+NexusCMS is currently in **public alpha** and is **not recommended for production use**. While core functionality is stable and has been tested in several mid-scale environments, the software is still under active development. We are expanding modules, refining documentation, and welcoming community contributions.
+
+## Quick Start
 
 1. Clone the repository:
+   ```bash
+   git clone https://github.com/yourusername/NexusCMS.git
+   cd NexusCMS
+   ```
+
+2. Install dependencies:
+   ```bash
+   composer install
+   npm install && npm run build
+   ```
+
+3. Configure your environment:
+   ```bash
+   cp .env.example .env
+   php artisan key:generate
+   ```
+
+4. Run migrations (configure your database in `.env` first):
+   ```bash
+   php artisan migrate
+   ```
+
+5. Start the local server:
+   ```bash
+   php artisan serve
+   ```
+
+Visit [http://localhost:8000](http://localhost:8000) and log in with the default admin credentials provided in the `.env` file.
+
+For detailed setup instructions, Docker deployment, and advanced configuration, see the [full documentation]().

From 0eecb867c64c87c0200e455b019e8b29b6ee8685 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 30 Jan 2026 01:41:01 +0100
Subject: [PATCH 054/132] docs: update README with refined project description
 and community focus.

---
 README.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 22f26da..390603e 100755
--- a/README.md
+++ b/README.md
@@ -8,7 +8,13 @@
 
 ## About NexusCMS
 
-Born from our earlier BlizzCMS, a PHP/CodeIgniter 3 project, NexusCMS is a Laravel-based platform engineered for teams that demand reliability, flexibility, and developer-friendly architecture. We have distilled years of client feedback, security audits, and performance tuning into a single codebase that grows with your business, not against it.
+Born from our earlier BlizzCMS, a PHP/CodeIgniter 3 project, NexusCMS is a Laravel-based platform designed for teams seeking reliability, flexibility, and a developer-friendly workflow. Over time, we’ve gathered years of community feedback, feature requests, and performance improvements, shaping a single, cohesive codebase that grows with your project, rather than getting in the way.
+
+Our focus has always been on making development easier and more approachable. While we are a team with technical training and experience, we are not “gurus”—we build tools that make sense for real people working on real projects. This philosophy has guided every decision in NexusCMS, from its architecture to its user interface.
+
+In addition to supporting modern features, we’ve ensured compatibility with all World of Warcraft expansions, including Classic, Retail, and Wrath of the Lich King, as well as the legacy versions of the game. Whether you’re managing a private server, building a community project, or experimenting with new ideas, NexusCMS provides a flexible, stable foundation to help you succeed.
+
+With a strong focus on community-driven development, we continue to refine and expand NexusCMS based on the feedback and needs of the people who use it, making it not just a tool, but a platform built with the community, for the community.
 
 ## Key Highlights
 

From 31f25837ee2f5d49df41f82dee8c6ca9979b796e Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 30 Jan 2026 18:48:23 +0100
Subject: [PATCH 055/132] Add MIT License to the project

---
 LICENSE.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 LICENSE.md

diff --git a/LICENSE.md b/LICENSE.md
new file mode 100644
index 0000000..ead012f
--- /dev/null
+++ b/LICENSE.md
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WoW-CMS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

From 436112896117685681ba98cf054d3fe05912f1f1 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 30 Jan 2026 18:49:57 +0100
Subject: [PATCH 056/132] docs: update Packagist package links in README

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 390603e..b2feb32 100755
--- a/README.md
+++ b/README.md
@@ -2,8 +2,8 @@
 
 <p align="center">
 <a href="https://github.com/yourusername/NexusCMS/actions"><img src="https://github.com/yourusername/NexusCMS/workflows/tests/badge.svg" alt="Build Status"></a>
-<a href="https://packagist.org/packages/yourusername/nexuscms"><img src="https://img.shields.io/packagist/v/yourusername/nexuscms" alt="Latest Stable Version"></a>
-<a href="https://packagist.org/packages/yourusername/nexuscms"><img src="https://img.shields.io/packagist/l/yourusername/nexuscms" alt="License"></a>
+<a href="https://packagist.org/packages/wow-cms/nexuscms"><img src="https://img.shields.io/packagist/v/wow-cms/nexuscms" alt="Latest Stable Version"></a>
+<a href="https://packagist.org/packages/wow-cms/nexuscms"><img src="https://img.shields.io/packagist/l/wow-cms/nexuscms" alt="License"></a>
 </p>
 
 ## About NexusCMS

From a57ac1a20416c91da950dfe1f62e5cfc58ae3910 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 30 Jan 2026 18:52:45 +0100
Subject: [PATCH 057/132] docs: update README badges to use GitHub-native
 shields

---
 README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index b2feb32..2af8985 100755
--- a/README.md
+++ b/README.md
@@ -1,9 +1,9 @@
 # NexusCMS
 
 <p align="center">
-<a href="https://github.com/yourusername/NexusCMS/actions"><img src="https://github.com/yourusername/NexusCMS/workflows/tests/badge.svg" alt="Build Status"></a>
-<a href="https://packagist.org/packages/wow-cms/nexuscms"><img src="https://img.shields.io/packagist/v/wow-cms/nexuscms" alt="Latest Stable Version"></a>
-<a href="https://packagist.org/packages/wow-cms/nexuscms"><img src="https://img.shields.io/packagist/l/wow-cms/nexuscms" alt="License"></a>
+![Downloads](https://img.shields.io/github/downloads/wow-cms/nexuscms/total)
+![License](https://img.shields.io/github/license/wow-cms/nexuscms)
+![Release](https://img.shields.io/github/v/release/wow-cms/nexuscms)
 </p>
 
 ## About NexusCMS

From a20a080514f87c74117ce62cfc0aaa89c272e20b Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 30 Jan 2026 19:04:24 +0100
Subject: [PATCH 058/132] docs: update README with new badges and structure

---
 README.md | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 2af8985..3d1a087 100755
--- a/README.md
+++ b/README.md
@@ -1,10 +1,5 @@
 # NexusCMS
 
-<p align="center">
-![Downloads](https://img.shields.io/github/downloads/wow-cms/nexuscms/total)
-![License](https://img.shields.io/github/license/wow-cms/nexuscms)
-![Release](https://img.shields.io/github/v/release/wow-cms/nexuscms)
-</p>
 
 ## About NexusCMS
 
@@ -26,7 +21,15 @@ With a strong focus on community-driven development, we continue to refine and e
 
 NexusCMS is currently in **public alpha** and is **not recommended for production use**. While core functionality is stable and has been tested in several mid-scale environments, the software is still under active development. We are expanding modules, refining documentation, and welcoming community contributions.
 
-## Quick Start
+
+[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
+![GitHub repo size](https://img.shields.io/github/repo-size/WOW-CMS/NexusCMS)
+![GitHub commits since latest release](https://img.shields.io/github/commits-since/WOW-CMS/NexusCMS/latest/feat/0.1.6)
+![Release](https://img.shields.io/github/v/release/WOW-CMS/NexusCMS)
+
+
+
+## Installation
 
 1. Clone the repository:
    ```bash
@@ -58,4 +61,7 @@ NexusCMS is currently in **public alpha** and is **not recommended for productio
 
 Visit [http://localhost:8000](http://localhost:8000) and log in with the default admin credentials provided in the `.env` file.
 
-For detailed setup instructions, Docker deployment, and advanced configuration, see the [full documentation]().
+## Documentation
+
+[Documentation]()
+

From cc5ee589d9f2cb8aa57b391697a3eb76acc8f3ae Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 30 Jan 2026 19:05:29 +0100
Subject: [PATCH 059/132] docs: move badges to top of README for better
 visibility

---
 README.md | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 3d1a087..110e903 100755
--- a/README.md
+++ b/README.md
@@ -1,5 +1,11 @@
 # NexusCMS
 
+<p align="center">
+[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
+![GitHub repo size](https://img.shields.io/github/repo-size/WOW-CMS/NexusCMS)
+![GitHub commits since latest release](https://img.shields.io/github/commits-since/WOW-CMS/NexusCMS/latest/feat/0.1.6)
+![Release](https://img.shields.io/github/v/release/WOW-CMS/NexusCMS)
+</p>
 
 ## About NexusCMS
 
@@ -22,13 +28,6 @@ With a strong focus on community-driven development, we continue to refine and e
 NexusCMS is currently in **public alpha** and is **not recommended for production use**. While core functionality is stable and has been tested in several mid-scale environments, the software is still under active development. We are expanding modules, refining documentation, and welcoming community contributions.
 
 
-[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
-![GitHub repo size](https://img.shields.io/github/repo-size/WOW-CMS/NexusCMS)
-![GitHub commits since latest release](https://img.shields.io/github/commits-since/WOW-CMS/NexusCMS/latest/feat/0.1.6)
-![Release](https://img.shields.io/github/v/release/WOW-CMS/NexusCMS)
-
-
-
 ## Installation
 
 1. Clone the repository:

From 61f44f85543b8c48dbc75edf457548ac9a563228 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 30 Jan 2026 19:06:18 +0100
Subject: [PATCH 060/132] docs: remove paragraph tags from badge section in
 README

---
 README.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/README.md b/README.md
index 110e903..e122272 100755
--- a/README.md
+++ b/README.md
@@ -1,11 +1,9 @@
 # NexusCMS
 
-<p align="center">
 [![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
 ![GitHub repo size](https://img.shields.io/github/repo-size/WOW-CMS/NexusCMS)
 ![GitHub commits since latest release](https://img.shields.io/github/commits-since/WOW-CMS/NexusCMS/latest/feat/0.1.6)
 ![Release](https://img.shields.io/github/v/release/WOW-CMS/NexusCMS)
-</p>
 
 ## About NexusCMS
 

From adbd3c41390f8a8e73ded7100266d0c2bd3d7d2b Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 30 Jan 2026 19:12:59 +0100
Subject: [PATCH 061/132] docs: update license badge from MIT to GPL-3.0 in
 README

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index e122272..df12e73 100755
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # NexusCMS
 
-[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
+[![GPL-3.0 License](https://img.shields.io/badge/License-GPL--3.0-green.svg)](https://choosealicense.com/licenses/gpl-3.0/)
 ![GitHub repo size](https://img.shields.io/github/repo-size/WOW-CMS/NexusCMS)
 ![GitHub commits since latest release](https://img.shields.io/github/commits-since/WOW-CMS/NexusCMS/latest/feat/0.1.6)
 ![Release](https://img.shields.io/github/v/release/WOW-CMS/NexusCMS)

From b0a4a336e6e844932f7d2ad02c61fcdf6aff9efc Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 30 Jan 2026 19:16:16 +0100
Subject: [PATCH 062/132] Add GNU GPL v3 license

Added the GNU General Public License version 3 to the project.
---
 LICENSE | 674 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 674 insertions(+)
 create mode 100644 LICENSE

diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..f288702
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,674 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<https://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<https://www.gnu.org/licenses/why-not-lgpl.html>.

From 75775b475a7cbcfa35110ce57d2d3b932e15d7a0 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 30 Jan 2026 19:16:55 +0100
Subject: [PATCH 063/132] chore: remove LICENSE.md file

---
 LICENSE.md | 21 ---------------------
 1 file changed, 21 deletions(-)
 delete mode 100644 LICENSE.md

diff --git a/LICENSE.md b/LICENSE.md
deleted file mode 100644
index ead012f..0000000
--- a/LICENSE.md
+++ /dev/null
@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 WoW-CMS
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

From 258004d0d2295e48bdbc139c73f12e2a83cf1517 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 31 Jan 2026 00:47:30 +0100
Subject: [PATCH 064/132] feat(admin): enhance user management with DP/VP
 points and improved UI.

---
 .../Http/Controllers/AdminUserController.php  |  90 ++++-
 .../Resources/views/users/create.blade.php    | 217 ++++++++---
 .../Resources/views/users/edit.blade.php      | 219 ++++++++---
 .../Resources/views/users/index.blade.php     | 360 +++++++++++++-----
 4 files changed, 657 insertions(+), 229 deletions(-)

diff --git a/app/Modules/Admin/Http/Controllers/AdminUserController.php b/app/Modules/Admin/Http/Controllers/AdminUserController.php
index de117f6..9731c56 100644
--- a/app/Modules/Admin/Http/Controllers/AdminUserController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminUserController.php
@@ -5,45 +5,76 @@
 use App\Http\Controllers\Controller;
 use App\Models\User;
 use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Hash;
 use Illuminate\Validation\Rule;
 use Spatie\Permission\Models\Role;
 
 class AdminUserController extends Controller
 {
+    /**
+     * Display a listing of the resource.
+     * 
+     * @return \Illuminate\Http\Response
+     */
     public function index()
     {
         $users = User::orderBy('name')->paginate(15);
         return view('admin::users.index', compact('users'));
     }
 
+    /**
+     * Show the form for creating a new resource.
+     * 
+     * @return \Illuminate\Http\Response
+     */
     public function create()
     {
         $roles = Role::orderBy('name')->get();
         return view('admin::users.create', compact('roles'));
     }
 
+    /**
+     * Store a newly created resource in storage.
+     * 
+     * @param Request $request
+     * @return \Illuminate\Http\Response
+     */
     public function store(Request $request)
     {
         $validated = $request->validate([
-            'name' => ['required', 'string', 'max:100'],
+            'name' => ['required', 'string', 'max:100', 'unique:users,name'],
             'email' => ['required', 'email', 'max:255', 'unique:users,email'],
             'password' => ['required', 'string', 'min:8'],
-            'roles' => ['array'],
-            'roles.*' => ['string', 'exists:roles,name'],
+            'dp' => ['nullable', 'numeric'],
+            'vp' => ['nullable', 'numeric'],
+            'roles.*' => ['integer', 'exists:roles,id'],
         ]);
 
-        $user = new User();
-        $user->name = $validated['name'];
-        $user->email = $validated['email'];
-        $user->password = $validated['password'];
-        $user->save();
+        $user = User::create([
+            'name' => $validated['name'],
+            'email' => $validated['email'],
+            'password' => Hash::make($validated['password']),
+            'dp' => $validated['dp'] ?? 0,
+            'vp' => $validated['vp'] ?? 0,
+        ]);
 
-        $roles = $validated['roles'] ?? [];
-        $user->syncRoles($roles);
+        if (!empty($validated['roles'])) {
+            $roles = \Spatie\Permission\Models\Role::whereIn('id', $validated['roles'])
+                ->pluck('name');
+            $user->syncRoles($roles);
+        }
 
-        return redirect()->route('admin.users.index')->with('success', 'User created successfully');
+        return redirect()
+            ->route('admin.users.index')
+            ->with('success', 'User created successfully');
     }
 
+    /**
+     * Show the form for editing the specified resource.
+     * 
+     * @param User $user
+     * @return \Illuminate\Http\Response
+     */
     public function edit(User $user)
     {
         $roles = Role::orderBy('name')->get();
@@ -51,30 +82,53 @@ public function edit(User $user)
         return view('admin::users.edit', compact('user', 'roles', 'assigned'));
     }
 
+    /**
+     * Update the specified resource in storage.
+     * 
+     * @param Request $request
+     * @param User $user
+     * @return \Illuminate\Http\Response
+     */
     public function update(Request $request, User $user)
     {
         $validated = $request->validate([
-            'name' => ['required', 'string', 'max:100'],
+            'name' => ['required', 'string', 'max:100', Rule::unique('users', 'name')->ignore($user->id)],
             'email' => ['required', 'email', 'max:255', Rule::unique('users', 'email')->ignore($user->id)],
             'password' => ['nullable', 'string', 'min:8'],
+            'dp' => ['nullable', 'numeric'],
+            'vp' => ['nullable', 'numeric'],
             'roles' => ['array'],
-            'roles.*' => ['string', 'exists:roles,name'],
+            'roles.*' => ['integer', 'exists:roles,id'],
         ]);
 
         $user->name = $validated['name'];
         $user->email = $validated['email'];
+
         if (!empty($validated['password'])) {
-            $user->password = $validated['password'];
+            $user->password = Hash::make($validated['password']);
         }
-        $user->save();
 
-        $roles = $validated['roles'] ?? [];
+        $user->dp = $validated['dp'] ?? 0;
+        $user->vp = $validated['vp'] ?? 0;
+        $user->save();
 
-        $user->syncRoles($roles);
+        if (!empty($validated['roles'])) {
+            $roles = \Spatie\Permission\Models\Role::whereIn('id', $validated['roles'])
+                ->pluck('name');
+            $user->syncRoles($roles);
+        }
 
-        return redirect()->route('admin.users.index')->with('success', 'User updated successfully');
+        return redirect()
+            ->route('admin.users.index')
+            ->with('success', 'User updated successfully');
     }
 
+    /**
+     * Remove the specified resource from storage.
+     * 
+     * @param User $user
+     * @return \Illuminate\Http\Response
+     */
     public function destroy(User $user)
     {
         if ($user->hasRole('Admin')) {
diff --git a/app/Modules/Admin/Resources/views/users/create.blade.php b/app/Modules/Admin/Resources/views/users/create.blade.php
index ca22fe5..f0a4152 100644
--- a/app/Modules/Admin/Resources/views/users/create.blade.php
+++ b/app/Modules/Admin/Resources/views/users/create.blade.php
@@ -1,67 +1,170 @@
 @extends('admin::layouts.app')
 
-@section('title', 'Crear Administrador')
+@section('title', 'Create User')
 
 @section('content')
-<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
-    <div class="flex items-center gap-4">
-        <h1 class="text-2xl font-bold text-gray-800">Crear administrador</h1>
-    </div>
-    <div class="flex items-center gap-3">
-        <a href="{{ route('admin.users.index') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
-            Volver
-        </a>
-    </div>
-</header>
-
-<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
-    <form method="POST" action="{{ route('admin.users.store') }}" class="space-y-6">
-        @csrf
-        <div class="bg-white rounded-lg shadow">
-            <div class="p-6 border-b border-gray-200">
-                <h2 class="text-lg font-bold text-gray-800">Datos</h2>
-            </div>
-            <div class="p-6 grid grid-cols-1 md:grid-cols-2 gap-4">
-                <div>
-                    <label class="block text-sm font-medium text-gray-700">Nombre</label>
-                    <input name="name" value="{{ old('name') }}" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
-                    @error('name')<p class="text-sm text-red-600 mt-1">{{ $message }}</p>@enderror
-                </div>
-                <div>
-                    <label class="block text-sm font-medium text-gray-700">Email</label>
-                    <input type="email" name="email" value="{{ old('email') }}" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
-                    @error('email')<p class="text-sm text-red-600 mt-1">{{ $message }}</p>@enderror
-                </div>
-                <div>
-                    <label class="block text-sm font-medium text-gray-700">Password</label>
-                    <input type="password" name="password" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
-                    @error('password')<p class="text-sm text-red-600 mt-1">{{ $message }}</p>@enderror
+<div class="min-h-screen bg-gray-50">
+    <!-- Header -->
+    <div class="bg-white border-b border-gray-200">
+        <div class="max-w-6xl mx-auto px-6 py-5">
+            <div class="flex items-center justify-between">
+                <div class="flex items-center gap-4">
+                    <div class="w-12 h-12 bg-blue-100 rounded-lg flex items-center justify-center">
+                        <svg class="w-6 h-6 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M18 9v3m0 0v3m0-3h3m-3 0h-3m-2-5a4 4 0 11-8 0 4 4 0 018 0zM3 20a6 6 0 0112 0v1H3v-1z"/>
+                        </svg>
+                    </div>
+                    <div>
+                        <h1 class="text-2xl font-semibold text-gray-900">Create New User</h1>
+                        <p class="text-sm text-gray-500 mt-0.5">Fill in the details to create a user account</p>
+                    </div>
                 </div>
+                <a href="{{ route('admin.users.index') }}" class="px-4 py-2 text-sm font-medium text-gray-700 bg-white border border-gray-300 rounded-lg hover:bg-gray-50">
+                    ← Back
+                </a>
             </div>
         </div>
+    </div>
 
-        <div class="bg-white rounded-lg shadow">
-            <div class="p-6 border-b border-gray-200">
-                <h2 class="text-lg font-bold text-gray-800">Roles</h2>
-                <p class="text-sm text-gray-600">Admin se asigna automáticamente.</p>
-            </div>
-            <div class="p-6">
-                <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-3">
-                    @foreach($roles as $role)
-                        <label class="flex items-center gap-2 p-3 bg-gray-50 border border-gray-200 rounded">
-                            <input type="checkbox" name="roles[]" value="{{ $role->name }}" class="rounded">
-                            <span class="text-sm text-gray-800">{{ $role->name }}</span>
-                        </label>
-                    @endforeach
+    <!-- Form -->
+    <div class="max-w-6xl mx-auto px-6 py-8">
+        <form method="POST" action="{{ route('admin.users.store') }}">
+            @csrf
+            
+            <div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
+                <!-- Left: User Info -->
+                <div class="lg:col-span-2 space-y-6">
+                    <!-- Account Information -->
+                    <div class="bg-white border border-gray-200 rounded-xl overflow-hidden">
+                        <div class="bg-gray-50 px-6 py-4 border-b border-gray-200">
+                            <h2 class="text-base font-semibold text-gray-900">Account Information</h2>
+                        </div>
+                        <div class="p-6 space-y-5">
+                            <div>
+                                <label class="block text-sm font-medium text-gray-900 mb-2">Full Name</label>
+                                <input 
+                                    type="text" 
+                                    name="name" 
+                                    value="{{ old('name') }}" 
+                                    class="w-full px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white"
+                                    placeholder="e.g., John Doe"
+                                    required
+                                >
+                                @error('name')<p class="text-sm text-red-600 mt-1.5">{{ $message }}</p>@enderror
+                            </div>
+
+                            <div>
+                                <label class="block text-sm font-medium text-gray-900 mb-2">Email Address</label>
+                                <input 
+                                    type="email" 
+                                    name="email" 
+                                    value="{{ old('email') }}" 
+                                    class="w-full px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white"
+                                    placeholder="email@example.com"
+                                    required
+                                >
+                                @error('email')<p class="text-sm text-red-600 mt-1.5">{{ $message }}</p>@enderror
+                            </div>
+
+                            <div>
+                                <label class="block text-sm font-medium text-gray-900 mb-2">Password</label>
+                                <input 
+                                    type="password" 
+                                    name="password" 
+                                    class="w-full px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white"
+                                    placeholder="Minimum 8 characters"
+                                    required
+                                >
+                                @error('password')<p class="text-sm text-red-600 mt-1.5">{{ $message }}</p>@enderror
+                            </div>
+
+                            <div>
+                                <!-- Selectable roles -->
+                                 <label class="block text-sm font-medium text-gray-900 mb-2">Roles</label>
+                                 <select 
+                                    name="roles[]" 
+                                    class="w-full px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white"
+                                    required
+                                >
+                                    @foreach($roles as $role)
+                                        <option value="{{ $role->id }}" {{ strtolower($role->name) === 'user' ? 'selected' : '' }}>{{ $role->name }}</option>
+                                    @endforeach
+                                </select>
+                                @error('roles')<p class="text-sm text-red-600 mt-1.5">{{ $message }}</p>@enderror
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- Points -->
+                    <div class="bg-white border border-gray-200 rounded-xl overflow-hidden">
+                        <div class="bg-gray-50 px-6 py-4 border-b border-gray-200">
+                            <h2 class="text-base font-semibold text-gray-900">Initial Points</h2>
+                            <p class="text-xs text-gray-500 mt-1">Optional: Set starting balance for the user</p>
+                        </div>
+                        <div class="p-6">
+                            <div class="grid grid-cols-2 gap-4">
+                                <div>
+                                    <label class="block text-sm font-medium text-gray-900 mb-2">
+                                        <span class="flex items-center gap-2">
+                                            <svg class="w-4 h-4 text-yellow-500" fill="currentColor" viewBox="0 0 20 20">
+                                                <path d="M8.433 7.418c.155-.103.346-.196.567-.267v1.698a2.305 2.305 0 01-.567-.267C8.07 8.34 8 8.114 8 8c0-.114.07-.34.433-.582zM11 12.849v-1.698c.22.071.412.164.567.267.364.243.433.468.433.582 0 .114-.07.34-.433.582a2.305 2.305 0 01-.567.267z"/>
+                                                <path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm1-13a1 1 0 10-2 0v.092a4.535 4.535 0 00-1.676.662C6.602 6.234 6 7.009 6 8c0 .99.602 1.765 1.324 2.246.48.32 1.054.545 1.676.662v1.941c-.391-.127-.68-.317-.843-.504a1 1 0 10-1.51 1.31c.562.649 1.413 1.076 2.353 1.253V15a1 1 0 102 0v-.092a4.535 4.535 0 001.676-.662C13.398 13.766 14 12.991 14 12c0-.99-.602-1.765-1.324-2.246A4.535 4.535 0 0011 9.092V7.151c.391.127.68.317.843.504a1 1 0 101.511-1.31c-.563-.649-1.413-1.076-2.354-1.253V5z" clip-rule="evenodd"/>
+                                            </svg>
+                                            DP (Donation Points)
+                                        </span>
+                                    </label>
+                                    <input 
+                                        type="number" 
+                                        name="dp" 
+                                        value="{{ old('dp', 0) }}" 
+                                        min="0"
+                                        step="1"
+                                        class="w-full px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white"
+                                        placeholder="0"
+                                    >
+                                    @error('dp')<p class="text-sm text-red-600 mt-1.5">{{ $message }}</p>@enderror
+                                </div>
+
+                                <div>
+                                    <label class="block text-sm font-medium text-gray-900 mb-2">
+                                        <span class="flex items-center gap-2">
+                                            <svg class="w-4 h-4 text-purple-500" fill="currentColor" viewBox="0 0 20 20">
+                                                <path d="M9.049 2.927c.3-.921 1.603-.921 1.902 0l1.07 3.292a1 1 0 00.95.69h3.462c.969 0 1.371 1.24.588 1.81l-2.8 2.034a1 1 0 00-.364 1.118l1.07 3.292c.3.921-.755 1.688-1.54 1.118l-2.8-2.034a1 1 0 00-1.175 0l-2.8 2.034c-.784.57-1.838-.197-1.539-1.118l1.07-3.292a1 1 0 00-.364-1.118L2.98 8.72c-.783-.57-.38-1.81.588-1.81h3.461a1 1 0 00.951-.69l1.07-3.292z"/>
+                                            </svg>
+                                            VP (Vote Points)
+                                        </span>
+                                    </label>
+                                    <input 
+                                        type="number" 
+                                        name="vp" 
+                                        value="{{ old('vp', 0) }}" 
+                                        min="0"
+                                        step="1"
+                                        class="w-full px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white"
+                                        placeholder="0"
+                                    >
+                                    @error('vp')<p class="text-sm text-red-600 mt-1.5">{{ $message }}</p>@enderror
+                                </div>
+                            </div>
+                        </div>
+                    </div>
                 </div>
-            </div>
-            <div class="p-6 border-t border-gray-200 flex items-center justify-end gap-3">
-                <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
-                    Crear
-                </button>
-            </div>
-        </div>
-    </form>
-</main>
-@endsection
 
+                <!-- Right: Role Selection -->
+                <div class="lg:col-span-1">
+                    <div class="bg-white border border-gray-200 rounded-xl overflow-hidden sticky top-6">
+                        <div class="p-4 border-t border-gray-200 space-y-2">
+                            <button type="submit" class="w-full px-4 py-3 text-sm font-semibold text-white bg-blue-600 rounded-lg hover:bg-blue-700 focus:ring-4 focus:ring-blue-100">
+                                Create User
+                            </button>
+                            <a href="{{ route('admin.users.index') }}" class="block w-full px-4 py-3 text-sm font-medium text-center text-gray-700 bg-white border border-gray-300 rounded-lg hover:bg-gray-50">
+                                Cancel
+                            </a>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </form>
+    </div>
+</div>
+@endsection
\ No newline at end of file
diff --git a/app/Modules/Admin/Resources/views/users/edit.blade.php b/app/Modules/Admin/Resources/views/users/edit.blade.php
index dde383e..51a49aa 100644
--- a/app/Modules/Admin/Resources/views/users/edit.blade.php
+++ b/app/Modules/Admin/Resources/views/users/edit.blade.php
@@ -1,69 +1,170 @@
 @extends('admin::layouts.app')
 
-@section('title', 'Editar Administrador')
+@section('title', 'Edit User')
 
 @section('content')
-<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
-    <div class="flex items-center gap-4">
-        <h1 class="text-2xl font-bold text-gray-800">Editar administrador</h1>
-    </div>
-    <div class="flex items-center gap-3">
-        <a href="{{ route('admin.users.index') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
-            Volver
-        </a>
-    </div>
-</header>
-
-<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
-    <form method="POST" action="{{ route('admin.users.update', $user) }}" class="space-y-6">
-        @csrf
-        @method('PUT')
-        <div class="bg-white rounded-lg shadow">
-            <div class="p-6 border-b border-gray-200">
-                <h2 class="text-lg font-bold text-gray-800">Datos</h2>
-            </div>
-            <div class="p-6 grid grid-cols-1 md:grid-cols-2 gap-4">
-                <div>
-                    <label class="block text-sm font-medium text-gray-700">Nombre</label>
-                    <input name="name" value="{{ old('name', $user->name) }}" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
-                    @error('name')<p class="text-sm text-red-600 mt-1">{{ $message }}</p>@enderror
-                </div>
-                <div>
-                    <label class="block text-sm font-medium text-gray-700">Email</label>
-                    <input type="email" name="email" value="{{ old('email', $user->email) }}" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
-                    @error('email')<p class="text-sm text-red-600 mt-1">{{ $message }}</p>@enderror
-                </div>
-                <div>
-                    <label class="block text-sm font-medium text-gray-700">Password (opcional)</label>
-                    <input type="password" name="password" class="mt-1 w-full border border-gray-300 rounded-lg px-3 py-2 focus:outline-none focus:ring-2 focus:ring-blue-500">
-                    @error('password')<p class="text-sm text-red-600 mt-1">{{ $message }}</p>@enderror
+<div class="min-h-screen bg-gray-50">
+    <!-- Header -->
+    <div class="bg-white border-b border-gray-200">
+        <div class="max-w-6xl mx-auto px-6 py-5">
+            <div class="flex items-center justify-between">
+                <div class="flex items-center gap-4">
+                    <div class="w-12 h-12 bg-blue-100 rounded-lg flex items-center justify-center">
+                        <svg class="w-6 h-6 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z"/>
+                        </svg>
+                    </div>
+                    <div>
+                        <h1 class="text-2xl font-semibold text-gray-900">Edit User</h1>
+                        <p class="text-sm text-gray-500 mt-0.5">Update the details for this user account</p>
+                    </div>
                 </div>
+                <a href="{{ route('admin.users.index') }}" class="px-4 py-2 text-sm font-medium text-gray-700 bg-white border border-gray-300 rounded-lg hover:bg-gray-50">
+                    ← Back
+                </a>
             </div>
         </div>
+    </div>
 
-        <div class="bg-white rounded-lg shadow">
-            <div class="p-6 border-b border-gray-200">
-                <h2 class="text-lg font-bold text-gray-800">Roles</h2>
-                <p class="text-sm text-gray-600">Admin se mantiene asignado.</p>
-            </div>
-            <div class="p-6">
-                <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-3">
-                    @foreach($roles as $role)
-                        <label class="flex items-center gap-2 p-3 bg-gray-50 border border-gray-200 rounded">
-                            <input type="checkbox" name="roles[]" value="{{ $role->name }}" class="rounded"
-                                   @checked(in_array($role->name, $assigned))>
-                            <span class="text-sm text-gray-800">{{ $role->name }}</span>
-                        </label>
-                    @endforeach
+    <!-- Form -->
+    <div class="max-w-6xl mx-auto px-6 py-8">
+        <form method="POST" action="{{ route('admin.users.update', $user) }}">
+            @csrf
+            @method('PUT')
+            
+            <div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
+                <!-- Left: User Info -->
+                <div class="lg:col-span-2 space-y-6">
+                    <!-- Account Information -->
+                    <div class="bg-white border border-gray-200 rounded-xl overflow-hidden">
+                        <div class="bg-gray-50 px-6 py-4 border-b border-gray-200">
+                            <h2 class="text-base font-semibold text-gray-900">Account Information</h2>
+                        </div>
+                        <div class="p-6 space-y-5">
+                            <div>
+                                <label class="block text-sm font-medium text-gray-900 mb-2">Full Name</label>
+                                <input 
+                                    type="text" 
+                                    name="name" 
+                                    value="{{ old('name', $user->name) }}" 
+                                    class="w-full px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white"
+                                    placeholder="e.g., John Doe"
+                                    required
+                                >
+                                @error('name')<p class="text-sm text-red-600 mt-1.5">{{ $message }}</p>@enderror
+                            </div>
+
+                            <div>
+                                <label class="block text-sm font-medium text-gray-900 mb-2">Email Address</label>
+                                <input 
+                                    type="email" 
+                                    name="email" 
+                                    value="{{ old('email', $user->email) }}" 
+                                    class="w-full px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white"
+                                    placeholder="email@example.com"
+                                    required
+                                >
+                                @error('email')<p class="text-sm text-red-600 mt-1.5">{{ $message }}</p>@enderror
+                            </div>
+
+                            <div>
+                                <label class="block text-sm font-medium text-gray-900 mb-2">Password</label>
+                                <input 
+                                    type="password" 
+                                    name="password" 
+                                    class="w-full px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white"
+                                    placeholder="Leave blank to keep current password"
+                                >
+                                @error('password')<p class="text-sm text-red-600 mt-1.5">{{ $message }}</p>@enderror
+                            </div>
+
+                            <div>
+                                <!-- Selectable roles -->
+                                 <label class="block text-sm font-medium text-gray-900 mb-2">Roles</label>
+                                 <select 
+                                    name="roles[]" 
+                                    class="w-full px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white"
+                                    required
+                                >
+                                    @foreach($roles as $role)
+                                        <option value="{{ $role->id }}" {{ $user->roles->contains($role->id) ? 'selected' : '' }}>{{ $role->name }}</option>
+                                    @endforeach
+                                </select>
+                                @error('roles')<p class="text-sm text-red-600 mt-1.5">{{ $message }}</p>@enderror
+                            </div>
+                        </div>
+                    </div>
+
+                    <!-- Points -->
+                    <div class="bg-white border border-gray-200 rounded-xl overflow-hidden">
+                        <div class="bg-gray-50 px-6 py-4 border-b border-gray-200">
+                            <h2 class="text-base font-semibold text-gray-900">User Points</h2>
+                            <p class="text-xs text-gray-500 mt-1">Update the current balance for the user</p>
+                        </div>
+                        <div class="p-6">
+                            <div class="grid grid-cols-2 gap-4">
+                                <div>
+                                    <label class="block text-sm font-medium text-gray-900 mb-2">
+                                        <span class="flex items-center gap-2">
+                                            <svg class="w-4 h-4 text-yellow-500" fill="currentColor" viewBox="0 0 20 20">
+                                                <path d="M8.433 7.418c.155-.103.346-.196.567-.267v1.698a2.305 2.305 0 01-.567-.267C8.07 8.34 8 8.114 8 8c0-.114.07-.34.433-.582zM11 12.849v-1.698c.22.071.412.164.567.267.364.243.433.468.433.582 0 .114-.07.34-.433.582a2.305 2.305 0 01-.567.267z"/>
+                                                <path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm1-13a1 1 0 10-2 0v.092a4.535 4.535 0 00-1.676.662C6.602 6.234 6 7.009 6 8c0 .99.602 1.765 1.324 2.246.48.32 1.054.545 1.676.662v1.941c-.391-.127-.68-.317-.843-.504a1 1 0 10-1.51 1.31c.562.649 1.413 1.076 2.353 1.253V15a1 1 0 102 0v-.092a4.535 4.535 0 001.676-.662C13.398 13.766 14 12.991 14 12c0-.99-.602-1.765-1.324-2.246A4.535 4.535 0 0011 9.092V7.151c.391.127.68.317.843.504a1 1 0 101.511-1.31c-.563-.649-1.413-1.076-2.354-1.253V5z" clip-rule="evenodd"/>
+                                            </svg>
+                                            DP (Donation Points)
+                                        </span>
+                                    </label>
+                                    <input 
+                                        type="number" 
+                                        name="dp" 
+                                        value="{{ old('dp', $user->dp ?? 0) }}" 
+                                        min="0"
+                                        step="1"
+                                        class="w-full px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white"
+                                        placeholder="0"
+                                    >
+                                    @error('dp')<p class="text-sm text-red-600 mt-1.5">{{ $message }}</p>@enderror
+                                </div>
+
+                                <div>
+                                    <label class="block text-sm font-medium text-gray-900 mb-2">
+                                        <span class="flex items-center gap-2">
+                                            <svg class="w-4 h-4 text-purple-500" fill="currentColor" viewBox="0 0 20 20">
+                                                <path d="M9.049 2.927c.3-.921 1.603-.921 1.902 0l1.07 3.292a1 1 0 00.95.69h3.462c.969 0 1.371 1.24.588 1.81l-2.8 2.034a1 1 0 00-.364 1.118l1.07 3.292c.3.921-.755 1.688-1.54 1.118l-2.8-2.034a1 1 0 00-1.175 0l-2.8 2.034c-.784.57-1.838-.197-1.539-1.118l1.07-3.292a1 1 0 00-.364-1.118L2.98 8.72c-.783-.57-.38-1.81.588-1.81h3.461a1 1 0 00.951-.69l1.07-3.292z"/>
+                                            </svg>
+                                            VP (Vote Points)
+                                        </span>
+                                    </label>
+                                    <input 
+                                        type="number" 
+                                        name="vp" 
+                                        value="{{ old('vp', $user->vp ?? 0) }}" 
+                                        min="0"
+                                        step="1"
+                                        class="w-full px-4 py-3 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white"
+                                        placeholder="0"
+                                    >
+                                    @error('vp')<p class="text-sm text-red-600 mt-1.5">{{ $message }}</p>@enderror
+                                </div>
+                            </div>
+                        </div>
+                    </div>
                 </div>
-            </div>
-            <div class="p-6 border-t border-gray-200 flex items-center justify-end gap-3">
-                <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
-                    Guardar
-                </button>
-            </div>
-        </div>
-    </form>
-</main>
-@endsection
 
+                <!-- Right: Role Selection -->
+                <div class="lg:col-span-1">
+                    <div class="bg-white border border-gray-200 rounded-xl overflow-hidden sticky top-6">
+                        <div class="p-4 border-t border-gray-200 space-y-2">
+                            <button type="submit" class="w-full px-4 py-3 text-sm font-semibold text-white bg-blue-600 rounded-lg hover:bg-blue-700 focus:ring-4 focus:ring-blue-100">
+                                Update User
+                            </button>
+                            <a href="{{ route('admin.users.index') }}" class="block w-full px-4 py-3 text-sm font-medium text-center text-gray-700 bg-white border border-gray-300 rounded-lg hover:bg-gray-50">
+                                Cancel
+                            </a>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </form>
+    </div>
+</div>
+@endsection
\ No newline at end of file
diff --git a/app/Modules/Admin/Resources/views/users/index.blade.php b/app/Modules/Admin/Resources/views/users/index.blade.php
index ea39c94..1c13ae0 100644
--- a/app/Modules/Admin/Resources/views/users/index.blade.php
+++ b/app/Modules/Admin/Resources/views/users/index.blade.php
@@ -3,142 +3,312 @@
 @section('title', 'Users')
 
 @section('content')
-<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
-    <div class="flex items-center gap-4">
-        <h1 class="text-2xl font-bold text-gray-800">Users</h1>
-    </div>
-    <div class="flex items-center gap-3">
-        <a href="{{ route('admin.users.create') }}" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
-            Create User
-        </a>
-    </div>
-</header>
-
-<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
-    @if(session('success'))                
-        <div class="mb-4 p-3 bg-green-50 text-green-700 border border-green-200 rounded-lg flex items-center gap-2">
-            <i class="fas fa-check-circle text-green-500"></i>
-            {{ session('success') }}
-        </div>
-    @endif
-    @if(session('error'))
-        <div class="mb-4 p-3 bg-red-50 text-red-700 border border-red-200 rounded-lg flex items-center gap-2">
-            <i class="fas fa-exclamation-circle text-red-500"></i>
-            {{ session('error') }}
-        </div>
-    @endif
-    <div class="bg-white rounded-lg shadow mb-6 p-6">
-        <div class="grid grid-cols-1 md:grid-cols-4 gap-4">
-            <div class="relative">
-                <i class="fas fa-search absolute left-3 top-1/2 -translate-y-1/2 text-gray-400"></i>
-                <input type="text" placeholder="Search by name or email..." class="w-full pl-10 pr-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+<div class="min-h-screen bg-gray-50">
+    <!-- Header -->
+    <div class="bg-white border-b border-gray-200">
+        <div class="max-w-7xl mx-auto px-6 py-5">
+            <div class="flex items-center justify-between">
+                <div class="flex items-center gap-4">
+                    <div class="w-12 h-12 bg-blue-100 rounded-lg flex items-center justify-center">
+                        <svg class="w-6 h-6 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4.354a4 4 0 110 5.292M15 21H3v-1a6 6 0 0112 0v1zm0 0h6v-1a6 6 0 00-9-5.197M13 7a4 4 0 11-8 0 4 4 0 018 0z"/>
+                        </svg>
+                    </div>
+                    <div>
+                        <h1 class="text-2xl font-semibold text-gray-900">Users Management</h1>
+                        <p class="text-sm text-gray-500 mt-0.5">Manage and monitor all user accounts</p>
+                    </div>
+                </div>
+                <a href="{{ route('admin.users.create') }}" class="inline-flex items-center gap-2 px-4 py-2.5 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                    <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 4v16m8-8H4"/>
+                    </svg>
+                    Create User
+                </a>
             </div>
-            <select class="px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                <option>All Status</option>
-                <option>Active</option>
-                <option>Banned</option>
-                <option>Suspended</option>
-            </select>
-            <select class="px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                <option>All Roles</option>
-                <option>Admin</option>
-                <option>Moderator</option>
-                <option>User</option>
-            </select>
-            <button class="px-4 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300 font-medium flex items-center justify-center gap-2">
-                <i class="fas fa-redo"></i>
-                Reset Filters
-            </button>
         </div>
     </div>
-    
-    <!-- Users Table -->
-    <div class="bg-white rounded-lg shadow">
-        <div class="p-6 border-b border-gray-200 flex items-center justify-between">
-            <h2 class="text-lg font-bold text-gray-800">User List</h2>
-            <div class="flex items-center gap-2">
-                <button class="px-3 py-1 text-sm text-gray-600 hover:text-gray-800">
-                    <i class="fas fa-download mr-1"></i> Export
+
+    <div class="max-w-7xl mx-auto px-6 py-8">
+        <!-- Alerts -->
+        @if(session('success'))                
+            <div class="mb-6 p-4 bg-green-50 border-l-4 border-green-500 rounded-lg flex items-start gap-3">
+                <svg class="w-5 h-5 text-green-600 mt-0.5" fill="currentColor" viewBox="0 0 20 20">
+                    <path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm3.707-9.293a1 1 0 00-1.414-1.414L9 10.586 7.707 9.293a1 1 0 00-1.414 1.414l2 2a1 1 0 001.414 0l4-4z" clip-rule="evenodd"/>
+                </svg>
+                <div class="flex-1">
+                    <p class="text-sm font-medium text-green-800">{{ session('success') }}</p>
+                </div>
+            </div>
+        @endif
+        @if(session('error'))
+            <div class="mb-6 p-4 bg-red-50 border-l-4 border-red-500 rounded-lg flex items-start gap-3">
+                <svg class="w-5 h-5 text-red-600 mt-0.5" fill="currentColor" viewBox="0 0 20 20">
+                    <path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zM8.707 7.293a1 1 0 00-1.414 1.414L8.586 10l-1.293 1.293a1 1 0 101.414 1.414L10 11.414l1.293 1.293a1 1 0 001.414-1.414L11.414 10l1.293-1.293a1 1 0 00-1.414-1.414L10 8.586 8.707 7.293z" clip-rule="evenodd"/>
+                </svg>
+                <div class="flex-1">
+                    <p class="text-sm font-medium text-red-800">{{ session('error') }}</p>
+                </div>
+            </div>
+        @endif
+
+        <!-- Filters Card -->
+        <div class="bg-white border border-gray-200 rounded-xl p-6 mb-6">
+            <div class="flex items-center justify-between mb-4">
+                <h2 class="text-base font-semibold text-gray-900">Filters</h2>
+                <button class="text-sm text-gray-600 hover:text-gray-900 flex items-center gap-1">
+                    <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15"/>
+                    </svg>
+                    Reset
                 </button>
-                <button class="px-3 py-1 text-sm text-gray-600 hover:text-gray-800">
-                    <i class="fas fa-filter mr-1"></i> Filter
+            </div>
+            <div class="grid grid-cols-1 md:grid-cols-4 gap-4">
+                <div class="relative">
+                    <svg class="absolute left-3 top-1/2 -translate-y-1/2 w-5 h-5 text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z"/>
+                    </svg>
+                    <input 
+                        type="text" 
+                        placeholder="Search users..." 
+                        class="w-full pl-10 pr-4 py-2.5 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 focus:bg-white text-sm"
+                    >
+                </div>
+                <select class="px-4 py-2.5 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 text-sm">
+                    <option>All Status</option>
+                    <option>Active</option>
+                    <option>Banned</option>
+                    <option>Suspended</option>
+                </select>
+                <select class="px-4 py-2.5 bg-gray-50 border border-gray-200 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 text-sm">
+                    <option>All Roles</option>
+                    <option>Admin</option>
+                    <option>Moderator</option>
+                    <option>User</option>
+                </select>
+                <button class="px-4 py-2.5 bg-gray-50 border border-gray-200 text-gray-700 rounded-lg hover:bg-gray-100 font-medium flex items-center justify-center gap-2 text-sm">
+                    <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 4a1 1 0 011-1h16a1 1 0 011 1v2.586a1 1 0 01-.293.707l-6.414 6.414a1 1 0 00-.293.707V17l-4 4v-6.586a1 1 0 00-.293-.707L3.293 7.293A1 1 0 013 6.586V4z"/>
+                    </svg>
+                    More Filters
                 </button>
             </div>
         </div>
         
-        <div class="p-6">
+        <!-- Users Table -->
+        <div class="bg-white border border-gray-200 rounded-xl overflow-hidden">
+            <div class="px-6 py-4 border-b border-gray-200 flex items-center justify-between">
+                <div class="flex items-center gap-4">
+                    <h2 class="text-base font-semibold text-gray-900">User List</h2>
+                    <span class="px-2.5 py-1 bg-gray-100 text-gray-600 rounded-full text-xs font-medium">
+                        {{ $users->total() }} users
+                    </span>
+                </div>
+                <div class="flex items-center gap-2">
+                    <button onclick="toggleColumnsModal()" class="inline-flex items-center gap-2 px-3 py-2 text-sm text-gray-700 bg-gray-50 border border-gray-200 rounded-lg hover:bg-gray-100">
+                        <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 17V7m0 10a2 2 0 01-2 2H5a2 2 0 01-2-2V7a2 2 0 012-2h2a2 2 0 012 2m0 10a2 2 0 002 2h2a2 2 0 002-2M9 7a2 2 0 012-2h2a2 2 0 012 2m0 10V7m0 10a2 2 0 002 2h2a2 2 0 002-2V7a2 2 0 00-2-2h-2a2 2 0 00-2 2"/>
+                        </svg>
+                        Columns
+                    </button>
+                    <button class="inline-flex items-center gap-2 px-3 py-2 text-sm text-gray-700 bg-gray-50 border border-gray-200 rounded-lg hover:bg-gray-100">
+                        <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4"/>
+                        </svg>
+                        Export
+                    </button>
+                </div>
+            </div>
+            
             <div class="overflow-x-auto">
-                <table class="min-w-full">
-                    <thead>
-                        <tr class="text-left text-gray-600 text-sm border-b">
-                            <th class="px-4 py-3 font-semibold">
-                                <input type="checkbox" class="rounded border-gray-300">
+                <table class="min-w-full divide-y divide-gray-200">
+                    <thead class="bg-gray-50">
+                        <tr>
+                            <th class="px-6 py-3 text-left">
+                                <input type="checkbox" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
                             </th>
-                            <th class="px-4 py-3 font-semibold">User</th>
-                            <th class="px-4 py-3 font-semibold">Email</th>
-                            <th class="px-4 py-3 font-semibold">Status</th>
-                            <th class="px-4 py-3 font-semibold">Role</th>
-                            <th class="px-4 py-3 font-semibold">Registered</th>
-                            <th class="px-4 py-3 font-semibold">Actions</th>
+                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-700 uppercase tracking-wider">User</th>
+                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-700 uppercase tracking-wider column-email">Email</th>
+                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-700 uppercase tracking-wider column-status">Status</th>
+                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-700 uppercase tracking-wider column-role">Role</th>
+                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-700 uppercase tracking-wider column-points">Points</th>
+                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-700 uppercase tracking-wider column-registered">Registered</th>
+                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-700 uppercase tracking-wider">Actions</th>
                         </tr>
                     </thead>
-                    <tbody>
+                    <tbody class="bg-white divide-y divide-gray-200">
                         @forelse($users as $user)
-                            <!-- User Row 1 -->
-                            <tr class="border-b hover:bg-gray-50">
-                                <td class="px-4 py-4">
-                                    <input type="checkbox" class="rounded border-gray-300">
+                            <tr class="hover:bg-gray-50">
+                                <td class="px-6 py-4">
+                                    <input type="checkbox" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
                                 </td>
-                                <td class="px-4 py-4">
+                                <td class="px-6 py-4">
                                     <div class="flex items-center gap-3">
-                                        <div class="w-10 h-10 bg-blue-600 rounded-full flex items-center justify-center text-white font-bold">
-                                            JD
+                                        <div class="w-10 h-10 bg-gradient-to-br from-blue-500 to-blue-600 rounded-full flex items-center justify-center text-white font-semibold text-sm">
+                                            {{ strtoupper(substr($user->name, 0, 2)) }}
                                         </div>
                                         <div>
-                                            <div class="font-semibold text-gray-800">{{ $user->name }}</div>
-                                            <div class="text-xs text-gray-500">ID: {{ $user->id }}</div>
+                                            <div class="font-medium text-gray-900">{{ $user->name }}</div>
+                                            <div class="text-xs text-gray-500">ID: #{{ $user->id }}</div>
                                         </div>
                                     </div>
                                 </td>
-                                <td class="px-4 py-4 text-gray-600">{{ $user->email }}</td>
-                                <td class="px-4 py-4">
+                                <td class="px-6 py-4 text-sm text-gray-600 column-email">{{ $user->email }}</td>
+                                <td class="px-6 py-4 column-status">
                                     @if($user->status === 'active')
-                                        <span class="px-2 py-1 bg-green-100 text-green-700 rounded-full text-xs font-medium">
+                                        <span class="inline-flex items-center gap-1.5 px-2.5 py-1 bg-green-100 text-green-700 rounded-full text-xs font-medium">
+                                            <span class="w-1.5 h-1.5 bg-green-500 rounded-full"></span>
                                             Active
                                         </span>
+                                    @elseif($user->status === 'banned')
+                                        <span class="inline-flex items-center gap-1.5 px-2.5 py-1 bg-red-100 text-red-700 rounded-full text-xs font-medium">
+                                            <span class="w-1.5 h-1.5 bg-red-500 rounded-full"></span>
+                                            Banned
+                                        </span>
                                     @else
-                                        <span class="px-2 py-1 bg-red-100 text-red-700 rounded-full text-xs font-medium">
-                                            {{ $user->status }}
+                                        <span class="inline-flex items-center gap-1.5 px-2.5 py-1 bg-yellow-100 text-yellow-700 rounded-full text-xs font-medium">
+                                            <span class="w-1.5 h-1.5 bg-yellow-500 rounded-full"></span>
+                                            {{ ucfirst($user->status) }}
                                         </span>
                                     @endif
                                 </td>
-                                <td class="px-4 py-4">
-                                    <span class="px-2 py-1 bg-blue-100 text-blue-700 rounded text-xs font-medium">{{ $user->roles->pluck('name')->implode(', ') }}</span>
+                                <td class="px-6 py-4 column-role">
+                                    <span class="px-2.5 py-1 bg-blue-100 text-blue-700 rounded-lg text-xs font-medium">
+                                        {{ $user->roles->pluck('name')->implode(', ') }}
+                                    </span>
                                 </td>
-                                <td class="px-4 py-4 text-gray-600 text-sm">{{ $user->created_at->format('d/m/Y H:i:s') }}</td>    
-                                <td class="px-4 py-4">
+                                <td class="px-6 py-4 column-points">
+                                    <div class="flex items-center gap-3">
+                                        <div class="flex items-center gap-1 text-xs">
+                                            <svg class="w-4 h-4 text-yellow-500" fill="currentColor" viewBox="0 0 20 20">
+                                                <path d="M8.433 7.418c.155-.103.346-.196.567-.267v1.698a2.305 2.305 0 01-.567-.267C8.07 8.34 8 8.114 8 8c0-.114.07-.34.433-.582zM11 12.849v-1.698c.22.071.412.164.567.267.364.243.433.468.433.582 0 .114-.07.34-.433.582a2.305 2.305 0 01-.567.267z"/>
+                                                <path fill-rule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zm1-13a1 1 0 10-2 0v.092a4.535 4.535 0 00-1.676.662C6.602 6.234 6 7.009 6 8c0 .99.602 1.765 1.324 2.246.48.32 1.054.545 1.676.662v1.941c-.391-.127-.68-.317-.843-.504a1 1 0 10-1.51 1.31c.562.649 1.413 1.076 2.353 1.253V15a1 1 0 102 0v-.092a4.535 4.535 0 001.676-.662C13.398 13.766 14 12.991 14 12c0-.99-.602-1.765-1.324-2.246A4.535 4.535 0 0011 9.092V7.151c.391.127.68.317.843.504a1 1 0 101.511-1.31c-.563-.649-1.413-1.076-2.354-1.253V5z" clip-rule="evenodd"/>
+                                            </svg>
+                                            <span class="font-medium text-gray-900">{{ $user->dp ?? 0 }}</span>
+                                        </div>
+                                        <div class="flex items-center gap-1 text-xs">
+                                            <svg class="w-4 h-4 text-purple-500" fill="currentColor" viewBox="0 0 20 20">
+                                                <path d="M9.049 2.927c.3-.921 1.603-.921 1.902 0l1.07 3.292a1 1 0 00.95.69h3.462c.969 0 1.371 1.24.588 1.81l-2.8 2.034a1 1 0 00-.364 1.118l1.07 3.292c.3.921-.755 1.688-1.54 1.118l-2.8-2.034a1 1 0 00-1.175 0l-2.8 2.034c-.784.57-1.838-.197-1.539-1.118l1.07-3.292a1 1 0 00-.364-1.118L2.98 8.72c-.783-.57-.38-1.81.588-1.81h3.461a1 1 0 00.951-.69l1.07-3.292z"/>
+                                            </svg>
+                                            <span class="font-medium text-gray-900">{{ $user->vp ?? 0 }}</span>
+                                        </div>
+                                    </div>
+                                </td>
+                                <td class="px-6 py-4 text-sm text-gray-600 column-registered">{{ $user->created_at->format('M d, Y') }}</td>    
+                                <td class="px-6 py-4">
                                     <div class="flex items-center gap-2">
-                                        <a href="{{ route('admin.users.edit', $user->id) }}" class="px-3 py-1 bg-blue-100 text-blue-700 rounded hover:bg-blue-200 text-xs font-medium">
-                                            <i class="fas fa-edit"></i> Edit
-                                        </a>
-                                        <a href="{{ route('admin.users.destroy', $user->id) }}" class="px-3 py-1 bg-red-100 text-red-700 rounded hover:bg-red-200 text-xs font-medium">
-                                            <i class="fas fa-trash"></i> Delete
+                                        <a href="{{ route('admin.users.edit', $user->id) }}" class="inline-flex items-center gap-1 px-3 py-1.5 bg-blue-50 text-blue-700 rounded-lg hover:bg-blue-100 text-xs font-medium">
+                                            <svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z"/>
+                                            </svg>
+                                            Edit
                                         </a>
+                                        <button onclick="confirmDelete({{ $user->id }})" class="inline-flex items-center gap-1 px-3 py-1.5 bg-red-50 text-red-700 rounded-lg hover:bg-red-100 text-xs font-medium">
+                                            <svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16"/>
+                                            </svg>
+                                            Delete
+                                        </button>
                                     </div>
                                 </td>
                             </tr>
                         @empty
                             <tr>
-                                <td colspan="4" class="px-3 py-4 text-gray-600">No hay usuarios.</td>
+                                <td colspan="8" class="px-6 py-12 text-center">
+                                    <div class="flex flex-col items-center justify-center">
+                                        <svg class="w-12 h-12 text-gray-400 mb-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M20 13V6a2 2 0 00-2-2H6a2 2 0 00-2 2v7m16 0v5a2 2 0 01-2 2H6a2 2 0 01-2-2v-5m16 0h-2.586a1 1 0 00-.707.293l-2.414 2.414a1 1 0 01-.707.293h-3.172a1 1 0 01-.707-.293l-2.414-2.414A1 1 0 006.586 13H4"/>
+                                        </svg>
+                                        <p class="text-gray-500 font-medium">No users found</p>
+                                        <p class="text-sm text-gray-400 mt-1">Try adjusting your filters</p>
+                                    </div>
+                                </td>
                             </tr>
                         @endforelse
                     </tbody>
                 </table>
             </div>
-            <div class="mt-4">
+            
+            <!-- Pagination -->
+            <div class="px-6 py-4 border-t border-gray-200">
                 {{ $users->links() }}
             </div>
         </div>
     </div>
-</main>
-@endsection
+</div>
+
+<!-- Column Visibility Modal -->
+<div id="columnsModal" class="hidden fixed inset-0 bg-black bg-opacity-50 z-50 flex items-center justify-center p-4">
+    <div class="bg-white rounded-xl shadow-xl max-w-md w-full">
+        <div class="px-6 py-4 border-b border-gray-200 flex items-center justify-between">
+            <h3 class="text-lg font-semibold text-gray-900">Customize Columns</h3>
+            <button onclick="toggleColumnsModal()" class="text-gray-400 hover:text-gray-600">
+                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
+                </svg>
+            </button>
+        </div>
+        <div class="p-6 space-y-3">
+            <label class="flex items-center gap-3 p-3 bg-gray-50 rounded-lg cursor-pointer hover:bg-gray-100">
+                <input type="checkbox" checked onchange="toggleColumn('email')" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
+                <span class="text-sm font-medium text-gray-900">Email</span>
+            </label>
+            <label class="flex items-center gap-3 p-3 bg-gray-50 rounded-lg cursor-pointer hover:bg-gray-100">
+                <input type="checkbox" checked onchange="toggleColumn('status')" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
+                <span class="text-sm font-medium text-gray-900">Status</span>
+            </label>
+            <label class="flex items-center gap-3 p-3 bg-gray-50 rounded-lg cursor-pointer hover:bg-gray-100">
+                <input type="checkbox" checked onchange="toggleColumn('role')" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
+                <span class="text-sm font-medium text-gray-900">Role</span>
+            </label>
+            <label class="flex items-center gap-3 p-3 bg-gray-50 rounded-lg cursor-pointer hover:bg-gray-100">
+                <input type="checkbox" checked onchange="toggleColumn('points')" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
+                <span class="text-sm font-medium text-gray-900">Points (DP/VP)</span>
+            </label>
+            <label class="flex items-center gap-3 p-3 bg-gray-50 rounded-lg cursor-pointer hover:bg-gray-100">
+                <input type="checkbox" checked onchange="toggleColumn('registered')" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
+                <span class="text-sm font-medium text-gray-900">Registered Date</span>
+            </label>
+        </div>
+        <div class="px-6 py-4 border-t border-gray-200 flex items-center justify-end gap-3">
+            <button onclick="resetColumns()" class="px-4 py-2 text-sm font-medium text-gray-700 bg-gray-100 rounded-lg hover:bg-gray-200">
+                Reset
+            </button>
+            <button onclick="toggleColumnsModal()" class="px-4 py-2 text-sm font-medium text-white bg-blue-600 rounded-lg hover:bg-blue-700">
+                Apply
+            </button>
+        </div>
+    </div>
+</div>
+
+<script>
+function toggleColumnsModal() {
+    const modal = document.getElementById('columnsModal');
+    modal.classList.toggle('hidden');
+}
+
+function toggleColumn(columnName) {
+    const columns = document.querySelectorAll('.column-' + columnName);
+    columns.forEach(col => {
+        col.classList.toggle('hidden');
+    });
+}
+
+function resetColumns() {
+    const checkboxes = document.querySelectorAll('#columnsModal input[type="checkbox"]');
+    checkboxes.forEach(cb => {
+        cb.checked = true;
+    });
+    const allColumns = document.querySelectorAll('[class*="column-"]');
+    allColumns.forEach(col => {
+        col.classList.remove('hidden');
+    });
+}
+
+function confirmDelete(userId) {
+    if (confirm('Are you sure you want to delete this user? This action cannot be undone.')) {
+        window.location.href = '{{ route("admin.users.destroy", ":id") }}'.replace(':id', userId);
+    }
+}
+</script>
+@endsection
\ No newline at end of file

From f14d9ce1fe4eb58c02afaaaa447211f200b73489 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 31 Jan 2026 01:01:48 +0100
Subject: [PATCH 065/132] fix(admin): correct user deletion logic and update UI

The previous logic allowed deletion only for admin users, which was incorrect. Now non-admin users can be deleted while admins are protected. Also replaced the JavaScript confirm with a proper form submission for better security and user experience.
---
 .../Http/Controllers/AdminUserController.php     |  5 +++--
 .../Admin/Resources/views/users/index.blade.php  | 16 ++++++++++------
 2 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/app/Modules/Admin/Http/Controllers/AdminUserController.php b/app/Modules/Admin/Http/Controllers/AdminUserController.php
index 9731c56..bfe93c5 100644
--- a/app/Modules/Admin/Http/Controllers/AdminUserController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminUserController.php
@@ -131,11 +131,12 @@ public function update(Request $request, User $user)
      */
     public function destroy(User $user)
     {
-        if ($user->hasRole('Admin')) {
+        if (!$user->hasRole('Admin')) {
             $user->delete();
             return redirect()->route('admin.users.index')->with('success', 'User deleted successfully');
         }
-        return redirect()->route('admin.users.index')->with('error', 'The user is not an administrator');
+
+        return redirect()->route('admin.users.index')->with('error', 'The user is an administrator and cannot be deleted');
     }
 }
 
diff --git a/app/Modules/Admin/Resources/views/users/index.blade.php b/app/Modules/Admin/Resources/views/users/index.blade.php
index 1c13ae0..e190b1d 100644
--- a/app/Modules/Admin/Resources/views/users/index.blade.php
+++ b/app/Modules/Admin/Resources/views/users/index.blade.php
@@ -203,12 +203,16 @@ class="w-full pl-10 pr-4 py-2.5 bg-gray-50 border border-gray-200 rounded-lg foc
                                             </svg>
                                             Edit
                                         </a>
-                                        <button onclick="confirmDelete({{ $user->id }})" class="inline-flex items-center gap-1 px-3 py-1.5 bg-red-50 text-red-700 rounded-lg hover:bg-red-100 text-xs font-medium">
-                                            <svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16"/>
-                                            </svg>
-                                            Delete
-                                        </button>
+                                        <form action="{{ route('admin.users.destroy', $user->id) }}" method="POST" onsubmit="return confirm('Are you sure you want to delete this user? This action cannot be undone.');" style="display: inline;">
+                                            @csrf
+                                            @method('DELETE')
+                                            <button type="submit" class="inline-flex items-center gap-1 px-3 py-1.5 bg-red-50 text-red-700 rounded-lg hover:bg-red-100 text-xs font-medium">
+                                                <svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16"/>
+                                                </svg>
+                                                Delete
+                                            </button>
+                                        </form>
                                     </div>
                                 </td>
                             </tr>

From fe202bd26a09acf99e3837e973e0d00e26fbaa8a Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 31 Jan 2026 01:05:07 +0100
Subject: [PATCH 066/132] style(auth): enhance register page UI with improved
 visual design

- Add icons to form fields for better visual cues
- Implement password visibility toggle functionality
- Improve error message display with icons and better styling
- Enhance spacing, shadows, and gradient effects for modern look
- Add terms/privacy policy links and better divider styling
---
 resources/views/auth/register.blade.php | 173 ++++++++++++++++++++----
 1 file changed, 144 insertions(+), 29 deletions(-)

diff --git a/resources/views/auth/register.blade.php b/resources/views/auth/register.blade.php
index c6ca2e4..0c899ba 100755
--- a/resources/views/auth/register.blade.php
+++ b/resources/views/auth/register.blade.php
@@ -1,64 +1,179 @@
 @extends('layouts.main')
 
 @section('content')
-<div class="min-h-screen flex items-center justify-center px-4">
+<div class="min-h-screen flex items-center justify-center px-4 py-12">
     <div class="max-w-md w-full">
-        <div class="bg-gray-800/50 backdrop-blur-sm rounded-lg border border-gray-700 p-8">
-            <h2 class="text-4xl font-extrabold text-transparent bg-clip-text bg-gradient-to-r from-blue-400 to-purple-500">
-                Create Account
-            </h2>
+        <div class="bg-gray-800/50 backdrop-blur-sm rounded-2xl border border-gray-700 p-8 shadow-2xl">
+            <!-- Header -->
+            <div class="text-center mb-8">
+                <h2 class="text-4xl font-extrabold text-transparent bg-clip-text bg-gradient-to-r from-blue-400 to-purple-500 mb-2">
+                    Create Account
+                </h2>
+                <p class="text-gray-400 text-sm">Join us and start your journey today</p>
+            </div>
 
-            <form method="POST" action="{{ route('register') }}" class="space-y-6">
+            <form method="POST" action="{{ route('register') }}" class="space-y-5">
                 @csrf
 
+                <!-- Name Field -->
                 <div>
-                    <label for="name" class="block text-sm font-medium text-gray-300">Name</label>
-                    <input type="text" name="name" id="name" required
-                        class="w-full bg-gray-900/50 border border-gray-700 rounded-lg py-2 px-4 text-black placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent pl-10">
+                    <label for="name" class="block text-sm font-medium text-gray-300 mb-2">
+                        Full Name
+                    </label>
+                    <div class="relative">
+                        <div class="absolute inset-y-0 left-0 pl-3 flex items-center pointer-events-none">
+                            <svg class="h-5 w-5 text-gray-500" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M16 7a4 4 0 11-8 0 4 4 0 018 0zM12 14a7 7 0 00-7 7h14a7 7 0 00-7-7z"/>
+                            </svg>
+                        </div>
+                        <input type="text" name="name" id="name" value="{{ old('name') }}" required
+                            class="w-full bg-gray-900/50 border border-gray-700 rounded-lg py-3 px-4 pl-10 text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition-all duration-200"
+                            placeholder="John Doe">
+                    </div>
                     @error('name')
-                        <p class="mt-1 text-sm text-red-500">{{ $message }}</p>
+                        <p class="mt-2 text-sm text-red-400 flex items-center">
+                            <svg class="w-4 h-4 mr-1" fill="currentColor" viewBox="0 0 20 20">
+                                <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7 4a1 1 0 11-2 0 1 1 0 012 0zm-1-9a1 1 0 00-1 1v4a1 1 0 102 0V6a1 1 0 00-1-1z" clip-rule="evenodd"/>
+                            </svg>
+                            {{ $message }}
+                        </p>
                     @enderror
                 </div>
 
+                <!-- Email Field -->
                 <div>
-                    <label for="email" class="block text-sm font-medium text-gray-300">Email</label>
-                    <input type="email" name="email" id="email" required
-                        class="w-full bg-gray-900/50 border border-gray-700 rounded-lg py-2 px-4 text-black placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent pl-10">
+                    <label for="email" class="block text-sm font-medium text-gray-300 mb-2">
+                        Email Address
+                    </label>
+                    <div class="relative">
+                        <div class="absolute inset-y-0 left-0 pl-3 flex items-center pointer-events-none">
+                            <svg class="h-5 w-5 text-gray-500" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 8l7.89 5.26a2 2 0 002.22 0L21 8M5 19h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z"/>
+                            </svg>
+                        </div>
+                        <input type="email" name="email" id="email" value="{{ old('email') }}" required
+                            class="w-full bg-gray-900/50 border border-gray-700 rounded-lg py-3 px-4 pl-10 text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition-all duration-200"
+                            placeholder="you@example.com">
+                    </div>
                     @error('email')
-                        <p class="mt-1 text-sm text-red-500">{{ $message }}</p>
+                        <p class="mt-2 text-sm text-red-400 flex items-center">
+                            <svg class="w-4 h-4 mr-1" fill="currentColor" viewBox="0 0 20 20">
+                                <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7 4a1 1 0 11-2 0 1 1 0 012 0zm-1-9a1 1 0 00-1 1v4a1 1 0 102 0V6a1 1 0 00-1-1z" clip-rule="evenodd"/>
+                            </svg>
+                            {{ $message }}
+                        </p>
                     @enderror
                 </div>
 
+                <!-- Password Field -->
                 <div>
-                    <label for="password" class="block text-sm font-medium text-gray-300">Password</label>
-                    <input type="password" name="password" id="password" required
-                        class="w-full bg-gray-900/50 border border-gray-700 rounded-lg py-2 px-4 text-black placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent pl-10">
+                    <label for="password" class="block text-sm font-medium text-gray-300 mb-2">
+                        Password
+                    </label>
+                    <div class="relative">
+                        <div class="absolute inset-y-0 left-0 pl-3 flex items-center pointer-events-none">
+                            <svg class="h-5 w-5 text-gray-500" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 15v2m-6 4h12a2 2 0 002-2v-6a2 2 0 00-2-2H6a2 2 0 00-2 2v6a2 2 0 002 2zm10-10V7a4 4 0 00-8 0v4h8z"/>
+                            </svg>
+                        </div>
+                        <input type="password" name="password" id="password" required
+                            class="w-full bg-gray-900/50 border border-gray-700 rounded-lg py-3 px-4 pl-10 pr-10 text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition-all duration-200"
+                            placeholder="••••••••">
+                        <button type="button" onclick="togglePassword('password')" class="absolute inset-y-0 right-0 pr-3 flex items-center">
+                            <svg id="eye-password" class="h-5 w-5 text-gray-500 hover:text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/>
+                            </svg>
+                        </button>
+                    </div>
+                    <p class="mt-2 text-xs text-gray-500">Must be at least 8 characters</p>
                     @error('password')
-                        <p class="mt-1 text-sm text-red-500">{{ $message }}</p>
+                        <p class="mt-2 text-sm text-red-400 flex items-center">
+                            <svg class="w-4 h-4 mr-1" fill="currentColor" viewBox="0 0 20 20">
+                                <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7 4a1 1 0 11-2 0 1 1 0 012 0zm-1-9a1 1 0 00-1 1v4a1 1 0 102 0V6a1 1 0 00-1-1z" clip-rule="evenodd"/>
+                            </svg>
+                            {{ $message }}
+                        </p>
                     @enderror
                 </div>
 
+                <!-- Confirm Password Field -->
                 <div>
-                    <label for="password_confirmation" class="block text-sm font-medium text-gray-300">Confirm Password</label>
-                    <input type="password" name="password_confirmation" id="password_confirmation" required
-                        class="w-full bg-gray-900/50 border border-gray-700 rounded-lg py-2 px-4 text-black placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent pl-10">
+                    <label for="password_confirmation" class="block text-sm font-medium text-gray-300 mb-2">
+                        Confirm Password
+                    </label>
+                    <div class="relative">
+                        <div class="absolute inset-y-0 left-0 pl-3 flex items-center pointer-events-none">
+                            <svg class="h-5 w-5 text-gray-500" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z"/>
+                            </svg>
+                        </div>
+                        <input type="password" name="password_confirmation" id="password_confirmation" required
+                            class="w-full bg-gray-900/50 border border-gray-700 rounded-lg py-3 px-4 pl-10 pr-10 text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition-all duration-200"
+                            placeholder="••••••••">
+                        <button type="button" onclick="togglePassword('password_confirmation')" class="absolute inset-y-0 right-0 pr-3 flex items-center">
+                            <svg id="eye-password_confirmation" class="h-5 w-5 text-gray-500 hover:text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/>
+                            </svg>
+                        </button>
+                    </div>
                 </div>
 
+                <!-- Submit Button -->
                 <button type="submit"
-                    class="w-full flex items-center justify-center space-x-2 bg-blue-600 hover:bg-blue-700 text-white rounded-lg py-2 px-4 transition-colors">
+                    class="w-full flex items-center justify-center space-x-2 bg-gradient-to-r from-blue-600 to-purple-600 hover:from-blue-700 hover:to-purple-700 text-white font-semibold rounded-lg py-3 px-4 transition-all duration-200 transform hover:scale-[1.02] focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-offset-2 focus:ring-offset-gray-800 shadow-lg">
+                    <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M18 9v3m0 0v3m0-3h3m-3 0h-3m-2-5a4 4 0 11-8 0 4 4 0 018 0zM3 20a6 6 0 0112 0v1H3v-1z"/>
+                    </svg>
                     <span>Create Account</span>
                 </button>
 
-                <div class="text-center mt-4">
-                    <p class="text-sm text-gray-400">
-                        Already have an account?
-                        <a href="{{ route('login') }}" class="font-medium text-indigo-400 hover:text-indigo-300">
-                            Sign in here
-                        </a>
-                    </p>
+                <!-- Divider -->
+                <div class="relative my-6">
+                    <div class="absolute inset-0 flex items-center">
+                        <div class="w-full border-t border-gray-700"></div>
+                    </div>
+                    <div class="relative flex justify-center text-sm">
+                        <span class="px-2 bg-gray-800/50 text-gray-400">Already registered?</span>
+                    </div>
+                </div>
+
+                <!-- Login Link -->
+                <div class="text-center">
+                    <a href="{{ route('login') }}" 
+                        class="inline-flex items-center space-x-2 text-sm font-medium text-blue-400 hover:text-blue-300 transition-colors">
+                        <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 16l-4-4m0 0l4-4m-4 4h14m-5 4v1a3 3 0 01-3 3H6a3 3 0 01-3-3V7a3 3 0 013-3h7a3 3 0 013 3v1"/>
+                        </svg>
+                        <span>Sign in to your account</span>
+                    </a>
                 </div>
             </form>
         </div>
+
+        <!-- Optional: Terms and Privacy -->
+        <p class="mt-6 text-center text-xs text-gray-500">
+            By creating an account, you agree to our 
+            <a href="#" class="text-blue-400 hover:text-blue-300">Terms of Service</a> 
+            and 
+            <a href="#" class="text-blue-400 hover:text-blue-300">Privacy Policy</a>
+        </p>
     </div>
 </div>
+
+<script>
+function togglePassword(fieldId) {
+    const field = document.getElementById(fieldId);
+    const eye = document.getElementById('eye-' + fieldId);
+    
+    if (field.type === 'password') {
+        field.type = 'text';
+        eye.innerHTML = '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13.875 18.825A10.05 10.05 0 0112 19c-4.478 0-8.268-2.943-9.543-7a9.97 9.97 0 011.563-3.029m5.858.908a3 3 0 114.243 4.243M9.878 9.878l4.242 4.242M9.88 9.88l-3.29-3.29m7.532 7.532l3.29 3.29M3 3l3.59 3.59m0 0A9.953 9.953 0 0112 5c4.478 0 8.268 2.943 9.543 7a10.025 10.025 0 01-4.132 5.411m0 0L21 21"/>';
+    } else {
+        field.type = 'password';
+        eye.innerHTML = '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/>';
+    }
+}
+</script>
 @endsection
\ No newline at end of file

From e83470d49f6d7999b80d0af1cdd30714de64aaf2 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 1 Feb 2026 04:20:22 +0100
Subject: [PATCH 067/132] feat(admin): add settings module with model,
 controller, views, and migration

Add new Setting model, migration, and AdminSettingsController to manage system settings.
Create settings index view with sidebar navigation and placeholder views for general, email, database, realms, and other settings sections.
Add route for admin settings page.
---
 app/Modules/Admin/Domain/Models/Setting.php   |  15 +++
 .../Controllers/AdminSettingsController.php   |  67 +++++++++++
 app/Modules/Admin/Http/routes.php             |   3 +
 .../views/settings/advanced.blade.php         |  13 +++
 .../Resources/views/settings/api.blade.php    |  13 +++
 .../views/settings/appearance.blade.php       |  13 +++
 .../views/settings/database.blade.php         |  85 ++++++++++++++
 .../Resources/views/settings/email.blade.php  |  51 +++++++++
 .../views/settings/extends/menu.blade.php     |  31 +++++
 .../views/settings/general.blade.php          |  62 ++++++++++
 .../Resources/views/settings/index.blade.php  |  26 +++++
 .../views/settings/localization.blade.php     |  13 +++
 .../views/settings/maintenance.blade.php      |  13 +++
 .../views/settings/payment.blade.php          |  13 +++
 .../Resources/views/settings/realms.blade.php | 107 ++++++++++++++++++
 .../views/settings/security.blade.php         |  13 +++
 .../Resources/views/settings/seo.blade.php    |  13 +++
 .../migrations/2026_02_01_025016_settings.php |  29 +++++
 18 files changed, 580 insertions(+)
 create mode 100644 app/Modules/Admin/Domain/Models/Setting.php
 create mode 100644 app/Modules/Admin/Http/Controllers/AdminSettingsController.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/advanced.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/api.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/appearance.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/database.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/email.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/general.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/index.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/localization.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/maintenance.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/payment.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/realms.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/security.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/seo.blade.php
 create mode 100644 database/migrations/2026_02_01_025016_settings.php

diff --git a/app/Modules/Admin/Domain/Models/Setting.php b/app/Modules/Admin/Domain/Models/Setting.php
new file mode 100644
index 0000000..b4e54c0
--- /dev/null
+++ b/app/Modules/Admin/Domain/Models/Setting.php
@@ -0,0 +1,15 @@
+<?php
+
+namespace App\Modules\Admin\Domain\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class Setting extends Model
+{
+    protected $table = 'settings';
+
+    protected $fillable = [
+        'name',
+        'value',
+    ];
+}
\ No newline at end of file
diff --git a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
new file mode 100644
index 0000000..1b51a07
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
@@ -0,0 +1,67 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Modules\Admin\Domain\Models\Setting;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+class AdminSettingsController extends Controller
+{
+
+    protected $view = [
+        'general' => 'admin::settings.general',
+        'email' => 'admin::settings.email',
+        'database' => 'admin::settings.database',
+        'realms' => 'admin::settings.realms',
+        'payment' => 'admin::settings.payment',
+        'security' => 'admin::settings.security',
+        'appearance' => 'admin::settings.appearance',
+        'seo' => 'admin::settings.seo',
+        'api' => 'admin::settings.api',
+        'maintenance' => 'admin::settings.maintenance',
+        'localization' => 'admin::settings.localization',
+        'advanced' => 'admin::settings.advanced',
+    ];
+
+    /**
+     * Display a listing of the resource.
+     */
+    public function index(Request $request)
+    {
+        $view = $request->get('view', 'general');
+
+        if (!array_key_exists($view, $this->view)) {
+            abort(404);
+        }
+
+        $settings = Setting::all();
+        return view($this->view[$view], compact('settings', 'view'));
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     */
+    public function store(Request $request)
+    {
+        //
+    }
+
+    /**
+     * Update the specified resource in storage.
+     */
+    public function update(Request $request, string $id)
+    {
+        //
+    }
+    
+
+    /**
+     * Remove the specified resource from storage.
+     */
+    public function destroy(string $id)
+    {
+        //
+    }
+}
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index a080335..8aebedb 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -24,4 +24,7 @@
         Route::get('/users/{user}/edit', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'edit'])->name('admin.users.edit');
         Route::put('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'update'])->name('admin.users.update');
         Route::delete('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'destroy'])->name('admin.users.destroy');
+    
+        // Settings
+        Route::get('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'index'])->name('admin.settings.index');
     });
diff --git a/app/Modules/Admin/Resources/views/settings/advanced.blade.php b/app/Modules/Admin/Resources/views/settings/advanced.blade.php
new file mode 100644
index 0000000..ab5902b
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/advanced.blade.php
@@ -0,0 +1,13 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+    </div>
+    <div class="p-6">
+        <p class="text-gray-500 italic">This section is under construction.</p>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/api.blade.php b/app/Modules/Admin/Resources/views/settings/api.blade.php
new file mode 100644
index 0000000..ab5902b
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/api.blade.php
@@ -0,0 +1,13 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+    </div>
+    <div class="p-6">
+        <p class="text-gray-500 italic">This section is under construction.</p>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/appearance.blade.php b/app/Modules/Admin/Resources/views/settings/appearance.blade.php
new file mode 100644
index 0000000..ab5902b
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/appearance.blade.php
@@ -0,0 +1,13 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+    </div>
+    <div class="p-6">
+        <p class="text-gray-500 italic">This section is under construction.</p>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/database.blade.php b/app/Modules/Admin/Resources/views/settings/database.blade.php
new file mode 100644
index 0000000..188649c
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/database.blade.php
@@ -0,0 +1,85 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">Database Configuration</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure database connections</p>
+    </div>
+    <div class="p-6 space-y-6">
+        <!-- Auth Database -->
+        <div class="border-l-4 border-blue-500 pl-4">
+            <h3 class="font-bold text-gray-800 mb-4">Authentication Database</h3>
+            <div class="grid md:grid-cols-2 gap-4">
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Host</label>
+                    <input type="text" value="localhost" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Port</label>
+                    <input type="number" value="3306" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Database Name</label>
+                    <input type="text" value="auth" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Username</label>
+                    <input type="text" value="trinity" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+            </div>
+            <div class="mt-4">
+                <button class="px-4 py-2 bg-blue-100 text-blue-700 rounded-lg hover:bg-blue-200 font-medium text-sm">
+                    <i class="fas fa-check-circle mr-2"></i>Test Connection
+                </button>
+            </div>
+        </div>
+
+        <!-- Characters Database -->
+        <div class="border-l-4 border-green-500 pl-4">
+            <h3 class="font-bold text-gray-800 mb-4">Characters Database</h3>
+            <div class="grid md:grid-cols-2 gap-4">
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Host</label>
+                    <input type="text" value="localhost" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Port</label>
+                    <input type="number" value="3306" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Database Name</label>
+                    <input type="text" value="characters" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Username</label>
+                    <input type="text" value="trinity" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+            </div>
+        </div>
+
+        <!-- World Database -->
+        <div class="border-l-4 border-purple-500 pl-4">
+            <h3 class="font-bold text-gray-800 mb-4">World Database</h3>
+            <div class="grid md:grid-cols-2 gap-4">
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Host</label>
+                    <input type="text" value="localhost" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Port</label>
+                    <input type="number" value="3306" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Database Name</label>
+                    <input type="text" value="world" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Username</label>
+                    <input type="text" value="trinity" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/email.blade.php b/app/Modules/Admin/Resources/views/settings/email.blade.php
new file mode 100644
index 0000000..efa3666
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/email.blade.php
@@ -0,0 +1,51 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">Email Configuration</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure SMTP settings for outgoing emails</p>
+    </div>
+    <div class="p-6 space-y-4">
+        <div class="grid md:grid-cols-2 gap-4">
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">SMTP Host</label>
+                <input type="text" placeholder="smtp.example.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+            </div>
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">SMTP Port</label>
+                <input type="number" value="587" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+            </div>
+        </div>
+        <div class="grid md:grid-cols-2 gap-4">
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">SMTP Username</label>
+                <input type="text" placeholder="noreply@nexuscms.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+            </div>
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">SMTP Password</label>
+                <input type="password" placeholder="••••••••" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+            </div>
+        </div>
+        <div class="grid md:grid-cols-2 gap-4">
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">Encryption</label>
+                <select class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <option>TLS</option>
+                    <option>SSL</option>
+                    <option>None</option>
+                </select>
+            </div>
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">From Name</label>
+                <input type="text" value="NexusCMS" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+            </div>
+        </div>
+        <div>
+            <button class="px-4 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300 font-medium">
+                <i class="fas fa-paper-plane mr-2"></i>Send Test Email
+            </button>
+        </div>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php b/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
new file mode 100644
index 0000000..7ebf74f
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
@@ -0,0 +1,31 @@
+<div class="flex">
+    <!-- Settings Sidebar -->
+    <div class="w-64 bg-white border-r border-gray-200 p-4">
+        <nav class="space-y-1">
+            @php
+                $currentView = request('view', 'general');
+                $menuItems = [
+                    'general' => ['icon' => 'globe', 'label' => 'General'],
+                    'email' => ['icon' => 'envelope', 'label' => 'Email'],
+                    'database' => ['icon' => 'database', 'label' => 'Database'],
+                    'realms' => ['icon' => 'server', 'label' => 'Realms'],
+                    'payment' => ['icon' => 'credit-card', 'label' => 'Payment'],
+                    'security' => ['icon' => 'shield-alt', 'label' => 'Security'],
+                    'appearance' => ['icon' => 'palette', 'label' => 'Appearance'],
+                    'seo' => ['icon' => 'search', 'label' => 'SEO'],
+                    'api' => ['icon' => 'code', 'label' => 'API'],
+                    'maintenance' => ['icon' => 'tools', 'label' => 'Maintenance'],
+                    'localization' => ['icon' => 'language', 'label' => 'Localization'],
+                    'advanced' => ['icon' => 'cogs', 'label' => 'Advanced'],
+                ];
+            @endphp
+
+            @foreach($menuItems as $key => $item)
+                <a href="{{ route('admin.settings.index', ['view' => $key]) }}" 
+                   class="flex items-center gap-3 px-3 py-2 rounded-lg {{ $currentView === $key ? 'bg-blue-50 text-blue-700 font-medium' : 'text-gray-700 hover:bg-gray-50' }}">
+                    <i class="fas fa-{{ $item['icon'] }} w-5"></i>{{ $item['label'] }}
+                </a>
+            @endforeach
+        </nav>
+    </div>
+</div>
\ No newline at end of file
diff --git a/app/Modules/Admin/Resources/views/settings/general.blade.php b/app/Modules/Admin/Resources/views/settings/general.blade.php
new file mode 100644
index 0000000..54acbe6
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/general.blade.php
@@ -0,0 +1,62 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">General Settings</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure basic site information and settings</p>
+    </div>
+    <div class="p-6 space-y-4">
+        <div class="grid md:grid-cols-2 gap-4">
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">Site Name</label>
+                <input type="text" value="NexusCMS" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+            </div>
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">Site URL</label>
+                <input type="text" value="https://nexuscms.example.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+            </div>
+        </div>
+        <div>
+            <label class="block text-sm font-semibold text-gray-700 mb-2">Site Description</label>
+            <textarea rows="3" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">The ultimate World of Warcraft private server experience with custom content and balanced gameplay.</textarea>
+        </div>
+        <div class="grid md:grid-cols-2 gap-4">
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">Admin Email</label>
+                <input type="email" value="admin@nexuscms.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+            </div>
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">Time Zone</label>
+                <select class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <option>UTC</option>
+                    <option>Europe/Madrid</option>
+                    <option>America/New_York</option>
+                    <option>America/Los_Angeles</option>
+                </select>
+            </div>
+        </div>
+        <div class="grid md:grid-cols-2 gap-4">
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">Date Format</label>
+                <select class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <option>Y-m-d (2024-01-29)</option>
+                    <option>d/m/Y (29/01/2024)</option>
+                    <option>m/d/Y (01/29/2024)</option>
+                </select>
+            </div>
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">Time Format</label>
+                <select class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <option>24-hour (14:30)</option>
+                    <option>12-hour (2:30 PM)</option>
+                </select>
+            </div>
+        </div>
+        <div class="flex items-center gap-2">
+            <input type="checkbox" id="registration" checked class="rounded border-gray-300">
+            <label for="registration" class="text-sm text-gray-700">Allow new user registrations</label>
+        </div>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/index.blade.php b/app/Modules/Admin/Resources/views/settings/index.blade.php
new file mode 100644
index 0000000..d424ba8
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/index.blade.php
@@ -0,0 +1,26 @@
+@extends('admin::layouts.app')
+
+@section('Title', 'Settings')
+
+@section('content')
+<div class="flex-1 flex flex-col overflow-hidden">
+    <!-- Top Bar -->
+    <header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+        <div class="flex items-center gap-4">
+            <h1 class="text-2xl font-bold text-gray-800">System Settings</h1>
+        </div>
+        <div class="flex items-center gap-3">
+            <button class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium flex items-center gap-2">
+                <i class="fas fa-save"></i> Save All Changes
+            </button>
+        </div>
+    </header>
+    <main class="flex-1 flex overflow-hidden bg-gray-50">
+        @include('admin::settings.extends.menu')
+
+        <div class="flex-1 p-6 space-y-6 overflow-y-auto">
+            @yield('settings_content')
+        </div>
+    </main>
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/localization.blade.php b/app/Modules/Admin/Resources/views/settings/localization.blade.php
new file mode 100644
index 0000000..ab5902b
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/localization.blade.php
@@ -0,0 +1,13 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+    </div>
+    <div class="p-6">
+        <p class="text-gray-500 italic">This section is under construction.</p>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/maintenance.blade.php b/app/Modules/Admin/Resources/views/settings/maintenance.blade.php
new file mode 100644
index 0000000..ab5902b
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/maintenance.blade.php
@@ -0,0 +1,13 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+    </div>
+    <div class="p-6">
+        <p class="text-gray-500 italic">This section is under construction.</p>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/payment.blade.php b/app/Modules/Admin/Resources/views/settings/payment.blade.php
new file mode 100644
index 0000000..ab5902b
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/payment.blade.php
@@ -0,0 +1,13 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+    </div>
+    <div class="p-6">
+        <p class="text-gray-500 italic">This section is under construction.</p>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/realms.blade.php b/app/Modules/Admin/Resources/views/settings/realms.blade.php
new file mode 100644
index 0000000..2188ffd
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/realms.blade.php
@@ -0,0 +1,107 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">Realm Configuration</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure your game server realms</p>
+    </div>
+    <div class="p-6">
+        <div class="mb-4 flex items-center justify-between">
+            <h3 class="font-bold text-gray-800">Active Realms</h3>
+            <button class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                <i class="fas fa-plus mr-2"></i>Add Realm
+            </button>
+        </div>
+        <div class="space-y-4">
+            <!-- Realm 1 -->
+            <div class="border border-gray-200 rounded-lg p-4">
+                <div class="flex items-center justify-between mb-4">
+                    <div class="flex items-center gap-3">
+                        <div class="w-3 h-3 bg-green-500 rounded-full"></div>
+                        <h4 class="font-bold text-gray-800">Realm 1 - FireStorm</h4>
+                    </div>
+                    <div class="flex items-center gap-2">
+                        <button class="px-3 py-1 bg-blue-100 text-blue-700 rounded hover:bg-blue-200 text-xs font-medium">
+                            <i class="fas fa-edit"></i> Edit
+                        </button>
+                        <button class="px-3 py-1 bg-red-100 text-red-700 rounded hover:bg-red-200 text-xs font-medium">
+                            <i class="fas fa-trash"></i> Delete
+                        </button>
+                    </div>
+                </div>
+                <div class="grid md:grid-cols-3 gap-4 text-sm">
+                    <div>
+                        <span class="text-gray-600">Host:</span>
+                        <span class="font-semibold text-gray-800 ml-2">127.0.0.1</span>
+                    </div>
+                    <div>
+                        <span class="text-gray-600">Port:</span>
+                        <span class="font-semibold text-gray-800 ml-2">8085</span>
+                    </div>
+                    <div>
+                        <span class="text-gray-600">Version:</span>
+                        <span class="font-semibold text-gray-800 ml-2">3.3.5a</span>
+                    </div>
+                    <div>
+                        <span class="text-gray-600">Type:</span>
+                        <span class="font-semibold text-gray-800 ml-2">PvP</span>
+                    </div>
+                    <div>
+                        <span class="text-gray-600">Rates:</span>
+                        <span class="font-semibold text-gray-800 ml-2">1x</span>
+                    </div>
+                    <div>
+                        <span class="text-gray-600">Players:</span>
+                        <span class="font-semibold text-gray-800 ml-2">850/2000</span>
+                    </div>
+                </div>
+            </div>
+
+            <!-- Realm 2 -->
+            <div class="border border-gray-200 rounded-lg p-4">
+                <div class="flex items-center justify-between mb-4">
+                    <div class="flex items-center gap-3">
+                        <div class="w-3 h-3 bg-green-500 rounded-full"></div>
+                        <h4 class="font-bold text-gray-800">Realm 2 - Frostmourne</h4>
+                    </div>
+                    <div class="flex items-center gap-2">
+                        <button class="px-3 py-1 bg-blue-100 text-blue-700 rounded hover:bg-blue-200 text-xs font-medium">
+                            <i class="fas fa-edit"></i> Edit
+                        </button>
+                        <button class="px-3 py-1 bg-red-100 text-red-700 rounded hover:bg-red-200 text-xs font-medium">
+                            <i class="fas fa-trash"></i> Delete
+                        </button>
+                    </div>
+                </div>
+                <div class="grid md:grid-cols-3 gap-4 text-sm">
+                    <div>
+                        <span class="text-gray-600">Host:</span>
+                        <span class="font-semibold text-gray-800 ml-2">127.0.0.1</span>
+                    </div>
+                    <div>
+                        <span class="text-gray-600">Port:</span>
+                        <span class="font-semibold text-gray-800 ml-2">8086</span>
+                    </div>
+                    <div>
+                        <span class="text-gray-600">Version:</span>
+                        <span class="font-semibold text-gray-800 ml-2">3.3.5a</span>
+                    </div>
+                    <div>
+                        <span class="text-gray-600">Type:</span>
+                        <span class="font-semibold text-gray-800 ml-2">PvE</span>
+                    </div>
+                    <div>
+                        <span class="text-gray-600">Rates:</span>
+                        <span class="font-semibold text-gray-800 ml-2">5x</span>
+                    </div>
+                    <div>
+                        <span class="text-gray-600">Players:</span>
+                        <span class="font-semibold text-gray-800 ml-2">420/1000</span>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/security.blade.php b/app/Modules/Admin/Resources/views/settings/security.blade.php
new file mode 100644
index 0000000..ab5902b
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/security.blade.php
@@ -0,0 +1,13 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+    </div>
+    <div class="p-6">
+        <p class="text-gray-500 italic">This section is under construction.</p>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/seo.blade.php b/app/Modules/Admin/Resources/views/settings/seo.blade.php
new file mode 100644
index 0000000..ab5902b
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/seo.blade.php
@@ -0,0 +1,13 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+    </div>
+    <div class="p-6">
+        <p class="text-gray-500 italic">This section is under construction.</p>
+    </div>
+</div>
+@endsection
diff --git a/database/migrations/2026_02_01_025016_settings.php b/database/migrations/2026_02_01_025016_settings.php
new file mode 100644
index 0000000..2ae121f
--- /dev/null
+++ b/database/migrations/2026_02_01_025016_settings.php
@@ -0,0 +1,29 @@
+<?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->string('value');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('settings');
+    }
+};

From 0c0501c08fe37280cb00c3121dd6a6e1e68393e8 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 1 Feb 2026 04:49:44 +0100
Subject: [PATCH 068/132] feat(admin): implement settings management with save
 functionality

---
 app/Modules/Admin/Domain/Models/Setting.php   |  2 +-
 .../Controllers/AdminSettingsController.php   | 23 ++++-
 app/Modules/Admin/Http/routes.php             |  1 +
 .../Resources/views/layouts/app.blade.php     |  2 +
 .../views/settings/database.blade.php         | 85 -------------------
 .../Resources/views/settings/email.blade.php  | 20 ++---
 .../views/settings/extends/menu.blade.php     |  1 -
 .../views/settings/general.blade.php          | 35 ++++----
 .../Resources/views/settings/index.blade.php  | 45 +++++++++-
 9 files changed, 93 insertions(+), 121 deletions(-)
 delete mode 100644 app/Modules/Admin/Resources/views/settings/database.blade.php

diff --git a/app/Modules/Admin/Domain/Models/Setting.php b/app/Modules/Admin/Domain/Models/Setting.php
index b4e54c0..1910f0a 100644
--- a/app/Modules/Admin/Domain/Models/Setting.php
+++ b/app/Modules/Admin/Domain/Models/Setting.php
@@ -9,7 +9,7 @@ class Setting extends Model
     protected $table = 'settings';
 
     protected $fillable = [
-        'name',
+        'key',
         'value',
     ];
 }
\ No newline at end of file
diff --git a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
index 1b51a07..90b21b9 100644
--- a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
@@ -13,7 +13,6 @@ class AdminSettingsController extends Controller
     protected $view = [
         'general' => 'admin::settings.general',
         'email' => 'admin::settings.email',
-        'database' => 'admin::settings.database',
         'realms' => 'admin::settings.realms',
         'payment' => 'admin::settings.payment',
         'security' => 'admin::settings.security',
@@ -36,7 +35,7 @@ public function index(Request $request)
             abort(404);
         }
 
-        $settings = Setting::all();
+        $settings = Setting::all()->pluck('value', 'key');
         return view($this->view[$view], compact('settings', 'view'));
     }
 
@@ -45,7 +44,25 @@ public function index(Request $request)
      */
     public function store(Request $request)
     {
-        //
+        $view = $request->get('view');
+
+        // Prevent storage for specific views that handle their own data or are read-only here
+        if (in_array($view, ['realms'])) {
+            return redirect()->route('admin.settings.index', ['view' => $view])
+                ->with('warning', 'Settings for this section cannot be saved via this form.');
+        }
+
+        $data = $request->except(['_token', 'view']);
+
+        foreach ($data as $key => $value) {
+            Setting::updateOrCreate(
+                ['key' => $key],
+                ['value' => $value]
+            );
+        }
+
+        return redirect()->route('admin.settings.index', ['view' => $view])
+            ->with('success', 'Settings updated successfully.');
     }
 
     /**
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index 8aebedb..8ef1901 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -27,4 +27,5 @@
     
         // Settings
         Route::get('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'index'])->name('admin.settings.index');
+        Route::post('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'store'])->name('admin.settings.store');
     });
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index 7a0c6a7..388826c 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -168,4 +168,6 @@
             @yield('content')
         </div>
     </div>
+    @stack('scripts')
 </body>
+</html>
diff --git a/app/Modules/Admin/Resources/views/settings/database.blade.php b/app/Modules/Admin/Resources/views/settings/database.blade.php
deleted file mode 100644
index 188649c..0000000
--- a/app/Modules/Admin/Resources/views/settings/database.blade.php
+++ /dev/null
@@ -1,85 +0,0 @@
-@extends('admin::settings.index')
-
-@section('settings_content')
-<div class="bg-white rounded-lg shadow">
-    <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">Database Configuration</h2>
-        <p class="text-sm text-gray-600 mt-1">Configure database connections</p>
-    </div>
-    <div class="p-6 space-y-6">
-        <!-- Auth Database -->
-        <div class="border-l-4 border-blue-500 pl-4">
-            <h3 class="font-bold text-gray-800 mb-4">Authentication Database</h3>
-            <div class="grid md:grid-cols-2 gap-4">
-                <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Host</label>
-                    <input type="text" value="localhost" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                </div>
-                <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Port</label>
-                    <input type="number" value="3306" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                </div>
-                <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Database Name</label>
-                    <input type="text" value="auth" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                </div>
-                <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Username</label>
-                    <input type="text" value="trinity" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                </div>
-            </div>
-            <div class="mt-4">
-                <button class="px-4 py-2 bg-blue-100 text-blue-700 rounded-lg hover:bg-blue-200 font-medium text-sm">
-                    <i class="fas fa-check-circle mr-2"></i>Test Connection
-                </button>
-            </div>
-        </div>
-
-        <!-- Characters Database -->
-        <div class="border-l-4 border-green-500 pl-4">
-            <h3 class="font-bold text-gray-800 mb-4">Characters Database</h3>
-            <div class="grid md:grid-cols-2 gap-4">
-                <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Host</label>
-                    <input type="text" value="localhost" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                </div>
-                <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Port</label>
-                    <input type="number" value="3306" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                </div>
-                <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Database Name</label>
-                    <input type="text" value="characters" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                </div>
-                <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Username</label>
-                    <input type="text" value="trinity" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                </div>
-            </div>
-        </div>
-
-        <!-- World Database -->
-        <div class="border-l-4 border-purple-500 pl-4">
-            <h3 class="font-bold text-gray-800 mb-4">World Database</h3>
-            <div class="grid md:grid-cols-2 gap-4">
-                <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Host</label>
-                    <input type="text" value="localhost" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                </div>
-                <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Port</label>
-                    <input type="number" value="3306" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                </div>
-                <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Database Name</label>
-                    <input type="text" value="world" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                </div>
-                <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Username</label>
-                    <input type="text" value="trinity" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                </div>
-            </div>
-        </div>
-    </div>
-</div>
-@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/email.blade.php b/app/Modules/Admin/Resources/views/settings/email.blade.php
index efa3666..84fb402 100644
--- a/app/Modules/Admin/Resources/views/settings/email.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/email.blade.php
@@ -10,39 +10,39 @@
         <div class="grid md:grid-cols-2 gap-4">
             <div>
                 <label class="block text-sm font-semibold text-gray-700 mb-2">SMTP Host</label>
-                <input type="text" placeholder="smtp.example.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <input type="text" name="smtp_host" value="{{ $settings['smtp_host'] ?? '' }}" placeholder="smtp.example.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
             <div>
                 <label class="block text-sm font-semibold text-gray-700 mb-2">SMTP Port</label>
-                <input type="number" value="587" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <input type="number" name="smtp_port" value="{{ $settings['smtp_port'] ?? '587' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
         </div>
         <div class="grid md:grid-cols-2 gap-4">
             <div>
                 <label class="block text-sm font-semibold text-gray-700 mb-2">SMTP Username</label>
-                <input type="text" placeholder="noreply@nexuscms.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <input type="text" name="smtp_username" value="{{ $settings['smtp_username'] ?? '' }}" placeholder="noreply@nexuscms.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
             <div>
                 <label class="block text-sm font-semibold text-gray-700 mb-2">SMTP Password</label>
-                <input type="password" placeholder="••••••••" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <input type="password" name="smtp_password" value="{{ $settings['smtp_password'] ?? '' }}" placeholder="••••••••" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
         </div>
         <div class="grid md:grid-cols-2 gap-4">
             <div>
                 <label class="block text-sm font-semibold text-gray-700 mb-2">Encryption</label>
-                <select class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                    <option>TLS</option>
-                    <option>SSL</option>
-                    <option>None</option>
+                <select name="smtp_encryption" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <option value="tls" {{ ($settings['smtp_encryption'] ?? '') == 'tls' ? 'selected' : '' }}>TLS</option>
+                    <option value="ssl" {{ ($settings['smtp_encryption'] ?? '') == 'ssl' ? 'selected' : '' }}>SSL</option>
+                    <option value="none" {{ ($settings['smtp_encryption'] ?? '') == 'none' ? 'selected' : '' }}>None</option>
                 </select>
             </div>
             <div>
                 <label class="block text-sm font-semibold text-gray-700 mb-2">From Name</label>
-                <input type="text" value="NexusCMS" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <input type="text" name="mail_from_name" value="{{ $settings['mail_from_name'] ?? 'NexusCMS' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
         </div>
         <div>
-            <button class="px-4 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300 font-medium">
+            <button type="button" class="px-4 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300 font-medium">
                 <i class="fas fa-paper-plane mr-2"></i>Send Test Email
             </button>
         </div>
diff --git a/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php b/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
index 7ebf74f..9955e04 100644
--- a/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
@@ -7,7 +7,6 @@
                 $menuItems = [
                     'general' => ['icon' => 'globe', 'label' => 'General'],
                     'email' => ['icon' => 'envelope', 'label' => 'Email'],
-                    'database' => ['icon' => 'database', 'label' => 'Database'],
                     'realms' => ['icon' => 'server', 'label' => 'Realms'],
                     'payment' => ['icon' => 'credit-card', 'label' => 'Payment'],
                     'security' => ['icon' => 'shield-alt', 'label' => 'Security'],
diff --git a/app/Modules/Admin/Resources/views/settings/general.blade.php b/app/Modules/Admin/Resources/views/settings/general.blade.php
index 54acbe6..3169fac 100644
--- a/app/Modules/Admin/Resources/views/settings/general.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/general.blade.php
@@ -10,51 +10,52 @@
         <div class="grid md:grid-cols-2 gap-4">
             <div>
                 <label class="block text-sm font-semibold text-gray-700 mb-2">Site Name</label>
-                <input type="text" value="NexusCMS" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <input type="text" name="site_name" value="{{ $settings['site_name'] ?? 'NexusCMS' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
             <div>
                 <label class="block text-sm font-semibold text-gray-700 mb-2">Site URL</label>
-                <input type="text" value="https://nexuscms.example.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <input type="text" name="site_url" value="{{ $settings['site_url'] ?? 'https://nexuscms.example.com' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
         </div>
         <div>
             <label class="block text-sm font-semibold text-gray-700 mb-2">Site Description</label>
-            <textarea rows="3" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">The ultimate World of Warcraft private server experience with custom content and balanced gameplay.</textarea>
+            <textarea name="site_description" rows="3" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">{{ $settings['site_description'] ?? 'The ultimate World of Warcraft private server experience with custom content and balanced gameplay.' }}</textarea>
         </div>
         <div class="grid md:grid-cols-2 gap-4">
             <div>
                 <label class="block text-sm font-semibold text-gray-700 mb-2">Admin Email</label>
-                <input type="email" value="admin@nexuscms.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <input type="email" name="admin_email" value="{{ $settings['admin_email'] ?? 'admin@nexuscms.com' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
             <div>
                 <label class="block text-sm font-semibold text-gray-700 mb-2">Time Zone</label>
-                <select class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                    <option>UTC</option>
-                    <option>Europe/Madrid</option>
-                    <option>America/New_York</option>
-                    <option>America/Los_Angeles</option>
+                <select name="timezone" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <option value="UTC" {{ ($settings['timezone'] ?? '') == 'UTC' ? 'selected' : '' }}>UTC</option>
+                    <option value="Europe/Madrid" {{ ($settings['timezone'] ?? '') == 'Europe/Madrid' ? 'selected' : '' }}>Europe/Madrid</option>
+                    <option value="America/New_York" {{ ($settings['timezone'] ?? '') == 'America/New_York' ? 'selected' : '' }}>America/New_York</option>
+                    <option value="America/Los_Angeles" {{ ($settings['timezone'] ?? '') == 'America/Los_Angeles' ? 'selected' : '' }}>America/Los_Angeles</option>
                 </select>
             </div>
         </div>
         <div class="grid md:grid-cols-2 gap-4">
             <div>
                 <label class="block text-sm font-semibold text-gray-700 mb-2">Date Format</label>
-                <select class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                    <option>Y-m-d (2024-01-29)</option>
-                    <option>d/m/Y (29/01/2024)</option>
-                    <option>m/d/Y (01/29/2024)</option>
+                <select name="date_format" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <option value="Y-m-d" {{ ($settings['date_format'] ?? '') == 'Y-m-d' ? 'selected' : '' }}>Y-m-d (2024-01-29)</option>
+                    <option value="d/m/Y" {{ ($settings['date_format'] ?? '') == 'd/m/Y' ? 'selected' : '' }}>d/m/Y (29/01/2024)</option>
+                    <option value="m/d/Y" {{ ($settings['date_format'] ?? '') == 'm/d/Y' ? 'selected' : '' }}>m/d/Y (01/29/2024)</option>
                 </select>
             </div>
             <div>
                 <label class="block text-sm font-semibold text-gray-700 mb-2">Time Format</label>
-                <select class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                    <option>24-hour (14:30)</option>
-                    <option>12-hour (2:30 PM)</option>
+                <select name="time_format" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <option value="H:i" {{ ($settings['time_format'] ?? '') == 'H:i' ? 'selected' : '' }}>24-hour (14:30)</option>
+                    <option value="h:i A" {{ ($settings['time_format'] ?? '') == 'h:i A' ? 'selected' : '' }}>12-hour (2:30 PM)</option>
                 </select>
             </div>
         </div>
         <div class="flex items-center gap-2">
-            <input type="checkbox" id="registration" checked class="rounded border-gray-300">
+            <input type="hidden" name="allow_registration" value="0">
+            <input type="checkbox" name="allow_registration" value="1" id="registration" {{ ($settings['allow_registration'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
             <label for="registration" class="text-sm text-gray-700">Allow new user registrations</label>
         </div>
     </div>
diff --git a/app/Modules/Admin/Resources/views/settings/index.blade.php b/app/Modules/Admin/Resources/views/settings/index.blade.php
index d424ba8..6045ff2 100644
--- a/app/Modules/Admin/Resources/views/settings/index.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/index.blade.php
@@ -10,17 +10,54 @@
             <h1 class="text-2xl font-bold text-gray-800">System Settings</h1>
         </div>
         <div class="flex items-center gap-3">
-            <button class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium flex items-center gap-2">
-                <i class="fas fa-save"></i> Save All Changes
-            </button>
+            @if(!in_array(request('view', 'general'), ['realms']))
+                <button id="save-settings-btn" form="settings-form" type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium flex items-center gap-2 disabled:opacity-50 disabled:cursor-not-allowed">
+                    <i class="fas fa-save"></i> Save All Changes
+                </button>
+            @endif
         </div>
     </header>
     <main class="flex-1 flex overflow-hidden bg-gray-50">
         @include('admin::settings.extends.menu')
 
         <div class="flex-1 p-6 space-y-6 overflow-y-auto">
-            @yield('settings_content')
+            <form id="settings-form" action="{{ route('admin.settings.store') }}" method="POST">
+                @csrf
+                <input type="hidden" name="view" value="{{ request('view', 'general') }}">
+                @yield('settings_content')
+            </form>
         </div>
     </main>
 </div>
+
+@push('scripts')
+<script>
+    document.addEventListener('DOMContentLoaded', function() {
+        const form = document.getElementById('settings-form');
+        const saveBtn = document.getElementById('save-settings-btn');
+        
+        if (!form || !saveBtn) return;
+
+        function checkFormValidity() {
+            const inputs = form.querySelectorAll('input:not([type="hidden"]):not([type="checkbox"]), select, textarea');
+            let isValid = true;
+
+            inputs.forEach(input => {
+                if (!input.value.trim()) {
+                    isValid = false;
+                }
+            });
+
+            saveBtn.disabled = !isValid;
+        }
+
+        // Check initially
+        checkFormValidity();
+
+        // Listen for changes
+        form.addEventListener('input', checkFormValidity);
+        form.addEventListener('change', checkFormValidity);
+    });
+</script>
+@endpush
 @endsection

From 0971d50d4c2177e0e3f0d84bf7b30c30e3fdaff2 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 4 Feb 2026 00:01:25 +0100
Subject: [PATCH 069/132] feat: add maintenance mode and settings helper with
 caching

- Add maintenance mode middleware with admin bypass and logout fix
- Implement settings helper with caching for improved performance
- Add maintenance settings page to admin panel
- Remove realms settings section from menu and views
- Add column customization JavaScript module for user management
- Update composer autoload to include SettingsHelper
- Add logout button to admin layout
---
 app/Helpers/SettingsHelper.php                |  35 ++++++
 app/Http/Middleware/CheckMaintenanceMode.php  |  44 +++++++
 .../Controllers/AdminSettingsController.php   |   6 +-
 .../Resources/views/layouts/app.blade.php     |  12 +-
 .../views/settings/extends/menu.blade.php     |   1 -
 .../Resources/views/settings/index.blade.php  |   8 +-
 .../views/settings/maintenance.blade.php      |  17 ++-
 .../Resources/views/settings/realms.blade.php | 107 ------------------
 .../Resources/views/users/index.blade.php     |  49 ++------
 bootstrap/app.php                             |   4 +
 composer.json                                 |   5 +-
 resources/js/scripts/listColumns.js           |  72 ++++++++++++
 resources/views/errors/maintenance.blade.php  |  67 +++++++++++
 vite.config.js                                |   3 +-
 14 files changed, 268 insertions(+), 162 deletions(-)
 create mode 100644 app/Helpers/SettingsHelper.php
 create mode 100644 app/Http/Middleware/CheckMaintenanceMode.php
 delete mode 100644 app/Modules/Admin/Resources/views/settings/realms.blade.php
 create mode 100644 resources/js/scripts/listColumns.js
 create mode 100644 resources/views/errors/maintenance.blade.php

diff --git a/app/Helpers/SettingsHelper.php b/app/Helpers/SettingsHelper.php
new file mode 100644
index 0000000..2e2b52c
--- /dev/null
+++ b/app/Helpers/SettingsHelper.php
@@ -0,0 +1,35 @@
+<?php
+
+use App\Modules\Admin\Domain\Models\Setting;
+use Illuminate\Support\Facades\Cache;
+
+if (!function_exists('settings')) {
+    /**
+     * Get a setting value or all settings.
+     *
+     * @param string|null $key
+     * @param mixed $default
+     * @return mixed
+     */
+    function settings($key = null, $default = null)
+    {
+        // Cache settings for performance (forever until updated)
+        $settings = Cache::rememberForever('site_settings', function () {
+            try {
+                // Check if table exists to avoid errors during migration/installation
+                if (!\Illuminate\Support\Facades\Schema::hasTable('settings')) {
+                    return collect([]);
+                }
+                return Setting::all()->pluck('value', 'key');
+            } catch (\Exception $e) {
+                return collect([]);
+            }
+        });
+
+        if (is_null($key)) {
+            return $settings;
+        }
+
+        return $settings->get($key, $default);
+    }
+}
diff --git a/app/Http/Middleware/CheckMaintenanceMode.php b/app/Http/Middleware/CheckMaintenanceMode.php
new file mode 100644
index 0000000..f896417
--- /dev/null
+++ b/app/Http/Middleware/CheckMaintenanceMode.php
@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class CheckMaintenanceMode
+{
+    /**
+     * Handle an incoming request.
+     *
+     * @param  \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response)  $next
+     */
+    public function handle(Request $request, Closure $next): Response
+    {
+        // Skip if maintenance mode is not enabled
+        if (settings('maintenance_mode') !== '1') {
+            return $next($request);
+        }
+
+        // Skip for admin routes (assuming /admin prefix or Admin module routes)
+        if ($request->is('acp') || $request->is('acp/*')) {
+            return $next($request);
+        }
+
+        // Skip auth login routes and check role admin
+        if ($request->is('auth/login') || $request->user()?->hasRole('admin')) {
+            return $next($request);
+        }
+
+        // Fixed prevent not logout when maintenance mode is enabled
+        if ($request->is('auth/logout')) {
+            return $next($request);
+        }
+
+        // Return 503 Service Unavailable with maintenance view
+        return response()->view('errors.maintenance', [
+            'message' => settings('maintenance_message', 'We are currently performing scheduled maintenance. We will be back shortly.'),
+            'title' => settings('site_name', 'NexusCMS') . ' - Maintenance'
+        ], 503);
+    }
+}
diff --git a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
index 90b21b9..c228734 100644
--- a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
@@ -5,7 +5,8 @@
 use App\Http\Controllers\Controller;
 use App\Modules\Admin\Domain\Models\Setting;
 use Illuminate\Http\Request;
-use Illuminate\View\View;
+
+use Illuminate\Support\Facades\Cache;
 
 class AdminSettingsController extends Controller
 {
@@ -61,6 +62,9 @@ public function store(Request $request)
             );
         }
 
+        // Clear settings cache
+        Cache::forget('site_settings');
+
         return redirect()->route('admin.settings.index', ['view' => $view])
             ->with('success', 'Settings updated successfully.');
     }
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index 388826c..c816fb8 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -158,9 +158,15 @@
                         <div class="text-sm font-semibold truncate">{{ Auth::user()->name }}</div>
                         <div class="text-xs text-gray-400">{{ Auth::user()->roles->pluck('name')->join(', ') }}</div>
                     </div>
-                    <a href="#" class="text-gray-400 hover:text-white">
-                        <i class="fas fa-sign-out-alt"></i>
-                    </a>
+                    <a href="" class="text-gray-400 hover:text-white">
+                        <i class="fas fa-cog"></i>
+                    </a>
+                    <form method="POST" action="{{ route('logout') }}" class="inline">
+                        @csrf
+                        <button type="submit" class="text-gray-400 hover:text-white">
+                            <i class="fas fa-sign-out-alt"></i>
+                        </button>
+                    </form>
                 </div>
             </div>
         </aside>
diff --git a/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php b/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
index 9955e04..b957ed9 100644
--- a/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
@@ -7,7 +7,6 @@
                 $menuItems = [
                     'general' => ['icon' => 'globe', 'label' => 'General'],
                     'email' => ['icon' => 'envelope', 'label' => 'Email'],
-                    'realms' => ['icon' => 'server', 'label' => 'Realms'],
                     'payment' => ['icon' => 'credit-card', 'label' => 'Payment'],
                     'security' => ['icon' => 'shield-alt', 'label' => 'Security'],
                     'appearance' => ['icon' => 'palette', 'label' => 'Appearance'],
diff --git a/app/Modules/Admin/Resources/views/settings/index.blade.php b/app/Modules/Admin/Resources/views/settings/index.blade.php
index 6045ff2..9398bc3 100644
--- a/app/Modules/Admin/Resources/views/settings/index.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/index.blade.php
@@ -10,11 +10,9 @@
             <h1 class="text-2xl font-bold text-gray-800">System Settings</h1>
         </div>
         <div class="flex items-center gap-3">
-            @if(!in_array(request('view', 'general'), ['realms']))
-                <button id="save-settings-btn" form="settings-form" type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium flex items-center gap-2 disabled:opacity-50 disabled:cursor-not-allowed">
-                    <i class="fas fa-save"></i> Save All Changes
-                </button>
-            @endif
+            <button id="save-settings-btn" form="settings-form" type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium flex items-center gap-2 disabled:opacity-50 disabled:cursor-not-allowed">
+                <i class="fas fa-save"></i> Save All Changes
+            </button>
         </div>
     </header>
     <main class="flex-1 flex overflow-hidden bg-gray-50">
diff --git a/app/Modules/Admin/Resources/views/settings/maintenance.blade.php b/app/Modules/Admin/Resources/views/settings/maintenance.blade.php
index ab5902b..b405af9 100644
--- a/app/Modules/Admin/Resources/views/settings/maintenance.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/maintenance.blade.php
@@ -3,11 +3,20 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
-        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+        <h2 class="text-xl font-bold text-gray-800">Maintenance Settings</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure maintenance mode and access settings</p>
     </div>
-    <div class="p-6">
-        <p class="text-gray-500 italic">This section is under construction.</p>
+    <div class="p-6 space-y-6">
+        <div class="flex items-center gap-2">
+            <input type="hidden" name="maintenance_mode" value="0">
+            <input type="checkbox" name="maintenance_mode" value="1" id="maintenance_mode" {{ ($settings['maintenance_mode'] ?? '0') == '1' ? 'checked' : '' }} class="rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+            <label for="maintenance_mode" class="text-sm font-medium text-gray-700">Enable Maintenance Mode</label>
+        </div>
+        <div>
+            <label class="block text-sm font-semibold text-gray-700 mb-2">Maintenance Message</label>
+            <textarea name="maintenance_message" rows="4" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">{{ $settings['maintenance_message'] ?? 'We are currently performing scheduled maintenance. We will be back shortly.' }}</textarea>
+            <p class="text-xs text-gray-500 mt-1">This message will be displayed to users when maintenance mode is active.</p>
+        </div>
     </div>
 </div>
 @endsection
diff --git a/app/Modules/Admin/Resources/views/settings/realms.blade.php b/app/Modules/Admin/Resources/views/settings/realms.blade.php
deleted file mode 100644
index 2188ffd..0000000
--- a/app/Modules/Admin/Resources/views/settings/realms.blade.php
+++ /dev/null
@@ -1,107 +0,0 @@
-@extends('admin::settings.index')
-
-@section('settings_content')
-<div class="bg-white rounded-lg shadow">
-    <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">Realm Configuration</h2>
-        <p class="text-sm text-gray-600 mt-1">Configure your game server realms</p>
-    </div>
-    <div class="p-6">
-        <div class="mb-4 flex items-center justify-between">
-            <h3 class="font-bold text-gray-800">Active Realms</h3>
-            <button class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
-                <i class="fas fa-plus mr-2"></i>Add Realm
-            </button>
-        </div>
-        <div class="space-y-4">
-            <!-- Realm 1 -->
-            <div class="border border-gray-200 rounded-lg p-4">
-                <div class="flex items-center justify-between mb-4">
-                    <div class="flex items-center gap-3">
-                        <div class="w-3 h-3 bg-green-500 rounded-full"></div>
-                        <h4 class="font-bold text-gray-800">Realm 1 - FireStorm</h4>
-                    </div>
-                    <div class="flex items-center gap-2">
-                        <button class="px-3 py-1 bg-blue-100 text-blue-700 rounded hover:bg-blue-200 text-xs font-medium">
-                            <i class="fas fa-edit"></i> Edit
-                        </button>
-                        <button class="px-3 py-1 bg-red-100 text-red-700 rounded hover:bg-red-200 text-xs font-medium">
-                            <i class="fas fa-trash"></i> Delete
-                        </button>
-                    </div>
-                </div>
-                <div class="grid md:grid-cols-3 gap-4 text-sm">
-                    <div>
-                        <span class="text-gray-600">Host:</span>
-                        <span class="font-semibold text-gray-800 ml-2">127.0.0.1</span>
-                    </div>
-                    <div>
-                        <span class="text-gray-600">Port:</span>
-                        <span class="font-semibold text-gray-800 ml-2">8085</span>
-                    </div>
-                    <div>
-                        <span class="text-gray-600">Version:</span>
-                        <span class="font-semibold text-gray-800 ml-2">3.3.5a</span>
-                    </div>
-                    <div>
-                        <span class="text-gray-600">Type:</span>
-                        <span class="font-semibold text-gray-800 ml-2">PvP</span>
-                    </div>
-                    <div>
-                        <span class="text-gray-600">Rates:</span>
-                        <span class="font-semibold text-gray-800 ml-2">1x</span>
-                    </div>
-                    <div>
-                        <span class="text-gray-600">Players:</span>
-                        <span class="font-semibold text-gray-800 ml-2">850/2000</span>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Realm 2 -->
-            <div class="border border-gray-200 rounded-lg p-4">
-                <div class="flex items-center justify-between mb-4">
-                    <div class="flex items-center gap-3">
-                        <div class="w-3 h-3 bg-green-500 rounded-full"></div>
-                        <h4 class="font-bold text-gray-800">Realm 2 - Frostmourne</h4>
-                    </div>
-                    <div class="flex items-center gap-2">
-                        <button class="px-3 py-1 bg-blue-100 text-blue-700 rounded hover:bg-blue-200 text-xs font-medium">
-                            <i class="fas fa-edit"></i> Edit
-                        </button>
-                        <button class="px-3 py-1 bg-red-100 text-red-700 rounded hover:bg-red-200 text-xs font-medium">
-                            <i class="fas fa-trash"></i> Delete
-                        </button>
-                    </div>
-                </div>
-                <div class="grid md:grid-cols-3 gap-4 text-sm">
-                    <div>
-                        <span class="text-gray-600">Host:</span>
-                        <span class="font-semibold text-gray-800 ml-2">127.0.0.1</span>
-                    </div>
-                    <div>
-                        <span class="text-gray-600">Port:</span>
-                        <span class="font-semibold text-gray-800 ml-2">8086</span>
-                    </div>
-                    <div>
-                        <span class="text-gray-600">Version:</span>
-                        <span class="font-semibold text-gray-800 ml-2">3.3.5a</span>
-                    </div>
-                    <div>
-                        <span class="text-gray-600">Type:</span>
-                        <span class="font-semibold text-gray-800 ml-2">PvE</span>
-                    </div>
-                    <div>
-                        <span class="text-gray-600">Rates:</span>
-                        <span class="font-semibold text-gray-800 ml-2">5x</span>
-                    </div>
-                    <div>
-                        <span class="text-gray-600">Players:</span>
-                        <span class="font-semibold text-gray-800 ml-2">420/1000</span>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </div>
-</div>
-@endsection
diff --git a/app/Modules/Admin/Resources/views/users/index.blade.php b/app/Modules/Admin/Resources/views/users/index.blade.php
index e190b1d..60577d9 100644
--- a/app/Modules/Admin/Resources/views/users/index.blade.php
+++ b/app/Modules/Admin/Resources/views/users/index.blade.php
@@ -105,7 +105,7 @@ class="w-full pl-10 pr-4 py-2.5 bg-gray-50 border border-gray-200 rounded-lg foc
                     </span>
                 </div>
                 <div class="flex items-center gap-2">
-                    <button onclick="toggleColumnsModal()" class="inline-flex items-center gap-2 px-3 py-2 text-sm text-gray-700 bg-gray-50 border border-gray-200 rounded-lg hover:bg-gray-100">
+                    <button class="toggle-columns-modal inline-flex items-center gap-2 px-3 py-2 text-sm text-gray-700 bg-gray-50 border border-gray-200 rounded-lg hover:bg-gray-100">
                         <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                             <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 17V7m0 10a2 2 0 01-2 2H5a2 2 0 01-2-2V7a2 2 0 012-2h2a2 2 0 012 2m0 10a2 2 0 002 2h2a2 2 0 002-2M9 7a2 2 0 012-2h2a2 2 0 012 2m0 10V7m0 10a2 2 0 002 2h2a2 2 0 002-2V7a2 2 0 00-2-2h-2a2 2 0 00-2 2"/>
                         </svg>
@@ -246,7 +246,7 @@ class="w-full pl-10 pr-4 py-2.5 bg-gray-50 border border-gray-200 rounded-lg foc
     <div class="bg-white rounded-xl shadow-xl max-w-md w-full">
         <div class="px-6 py-4 border-b border-gray-200 flex items-center justify-between">
             <h3 class="text-lg font-semibold text-gray-900">Customize Columns</h3>
-            <button onclick="toggleColumnsModal()" class="text-gray-400 hover:text-gray-600">
+            <button class="toggle-columns-modal text-gray-400 hover:text-gray-600">
                 <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                     <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12"/>
                 </svg>
@@ -254,65 +254,36 @@ class="w-full pl-10 pr-4 py-2.5 bg-gray-50 border border-gray-200 rounded-lg foc
         </div>
         <div class="p-6 space-y-3">
             <label class="flex items-center gap-3 p-3 bg-gray-50 rounded-lg cursor-pointer hover:bg-gray-100">
-                <input type="checkbox" checked onchange="toggleColumn('email')" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
+                <input type="checkbox" checked data-column="email" class="column-toggle w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
                 <span class="text-sm font-medium text-gray-900">Email</span>
             </label>
             <label class="flex items-center gap-3 p-3 bg-gray-50 rounded-lg cursor-pointer hover:bg-gray-100">
-                <input type="checkbox" checked onchange="toggleColumn('status')" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
+                <input type="checkbox" checked data-column="status" class="column-toggle w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
                 <span class="text-sm font-medium text-gray-900">Status</span>
             </label>
             <label class="flex items-center gap-3 p-3 bg-gray-50 rounded-lg cursor-pointer hover:bg-gray-100">
-                <input type="checkbox" checked onchange="toggleColumn('role')" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
+                <input type="checkbox" checked data-column="role" class="column-toggle w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
                 <span class="text-sm font-medium text-gray-900">Role</span>
             </label>
             <label class="flex items-center gap-3 p-3 bg-gray-50 rounded-lg cursor-pointer hover:bg-gray-100">
-                <input type="checkbox" checked onchange="toggleColumn('points')" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
+                <input type="checkbox" checked data-column="points" class="column-toggle w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
                 <span class="text-sm font-medium text-gray-900">Points (DP/VP)</span>
             </label>
             <label class="flex items-center gap-3 p-3 bg-gray-50 rounded-lg cursor-pointer hover:bg-gray-100">
-                <input type="checkbox" checked onchange="toggleColumn('registered')" class="w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
+                <input type="checkbox" checked data-column="registered" class="column-toggle w-4 h-4 rounded border-gray-300 text-blue-600 focus:ring-2 focus:ring-blue-500">
                 <span class="text-sm font-medium text-gray-900">Registered Date</span>
             </label>
         </div>
         <div class="px-6 py-4 border-t border-gray-200 flex items-center justify-end gap-3">
-            <button onclick="resetColumns()" class="px-4 py-2 text-sm font-medium text-gray-700 bg-gray-100 rounded-lg hover:bg-gray-200">
+            <button class="reset-columns px-4 py-2 text-sm font-medium text-gray-700 bg-gray-100 rounded-lg hover:bg-gray-200">
                 Reset
             </button>
-            <button onclick="toggleColumnsModal()" class="px-4 py-2 text-sm font-medium text-white bg-blue-600 rounded-lg hover:bg-blue-700">
+            <button class="toggle-columns-modal px-4 py-2 text-sm font-medium text-white bg-blue-600 rounded-lg hover:bg-blue-700">
                 Apply
             </button>
         </div>
     </div>
 </div>
 
-<script>
-function toggleColumnsModal() {
-    const modal = document.getElementById('columnsModal');
-    modal.classList.toggle('hidden');
-}
-
-function toggleColumn(columnName) {
-    const columns = document.querySelectorAll('.column-' + columnName);
-    columns.forEach(col => {
-        col.classList.toggle('hidden');
-    });
-}
-
-function resetColumns() {
-    const checkboxes = document.querySelectorAll('#columnsModal input[type="checkbox"]');
-    checkboxes.forEach(cb => {
-        cb.checked = true;
-    });
-    const allColumns = document.querySelectorAll('[class*="column-"]');
-    allColumns.forEach(col => {
-        col.classList.remove('hidden');
-    });
-}
-
-function confirmDelete(userId) {
-    if (confirm('Are you sure you want to delete this user? This action cannot be undone.')) {
-        window.location.href = '{{ route("admin.users.destroy", ":id") }}'.replace(':id', userId);
-    }
-}
-</script>
+@vite('resources/js/scripts/listColumns.js')
 @endsection
\ No newline at end of file
diff --git a/bootstrap/app.php b/bootstrap/app.php
index d709ffb..c21c1d1 100755
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -11,6 +11,10 @@
         health: '/up',
     )
     ->withMiddleware(function (Middleware $middleware) {
+        $middleware->web(append: [
+            \App\Http\Middleware\CheckMaintenanceMode::class,
+        ]);
+
         $middleware->alias([
             'role' => \App\Http\Middleware\CheckRole::class,
         ]);
diff --git a/composer.json b/composer.json
index 93e56e6..893ea11 100755
--- a/composer.json
+++ b/composer.json
@@ -37,7 +37,10 @@
             "Database\\Factories\\": "database/factories/",
             "Database\\Seeders\\": "database/seeders/",
             "Modules\\": "app/Modules/"
-        }
+        },
+        "files": [
+            "app/Helpers/SettingsHelper.php"
+        ]
     },
     "autoload-dev": {
         "psr-4": {
diff --git a/resources/js/scripts/listColumns.js b/resources/js/scripts/listColumns.js
new file mode 100644
index 0000000..29bc498
--- /dev/null
+++ b/resources/js/scripts/listColumns.js
@@ -0,0 +1,72 @@
+class ListColumns {
+    constructor() {
+        this.modal = document.getElementById('columnsModal');
+        this.checkboxes = document.querySelectorAll('.column-toggle');
+        this.toggleButtons = document.querySelectorAll('.toggle-columns-modal');
+        this.resetButton = document.querySelector('.reset-columns');
+    }
+
+    init() {
+        if (!this.modal) return;
+
+        // Toggle Modal Listeners
+        this.toggleButtons.forEach(btn => {
+            btn.addEventListener('click', (e) => {
+                e.preventDefault();
+                this.toggleModal();
+            });
+        });
+
+        // Reset Button Listener
+        if (this.resetButton) {
+            this.resetButton.addEventListener('click', (e) => {
+                e.preventDefault();
+                this.resetColumns();
+            });
+        }
+
+        // Checkbox Listeners
+        this.checkboxes.forEach(checkbox => {
+            checkbox.addEventListener('change', (e) => {
+                this.toggleColumn(e.target);
+            });
+        });
+    }
+
+    toggleModal() {
+        this.modal.classList.toggle('hidden');
+    }
+
+    toggleColumn(checkbox) {
+        const columnName = checkbox.getAttribute('data-column');
+        if (!columnName) return;
+
+        const columns = document.querySelectorAll('.column-' + columnName);
+        const isVisible = checkbox.checked;
+
+        columns.forEach(col => {
+            if (isVisible) {
+                col.classList.remove('hidden');
+            } else {
+                col.classList.add('hidden');
+            }
+        });
+    }
+
+    resetColumns() {
+        this.checkboxes.forEach(checkbox => {
+            checkbox.checked = true;
+            this.toggleColumn(checkbox);
+        });
+    }
+}
+
+// Initialize
+const listColumns = new ListColumns();
+if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', () => listColumns.init());
+} else {
+    listColumns.init();
+}
+
+export default ListColumns;
diff --git a/resources/views/errors/maintenance.blade.php b/resources/views/errors/maintenance.blade.php
new file mode 100644
index 0000000..9bcbafa
--- /dev/null
+++ b/resources/views/errors/maintenance.blade.php
@@ -0,0 +1,67 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{ $title ?? 'Maintenance Mode' }}</title>
+    <link href="https://fonts.googleapis.com/css2?family=Cinzel:wght@400;700&family=Inter:wght@300;400;600&display=swap" rel="stylesheet">
+    <script src="https://cdn.tailwindcss.com"></script>
+    <style>
+        body {
+            font-family: 'Inter', sans-serif;
+            background-color: #0f172a;
+            color: #e2e8f0;
+            background-image: url('https://images.unsplash.com/photo-1519074069444-1ba4fff66d16?ixlib=rb-4.0.3&auto=format&fit=crop&w=2070&q=80');
+            background-size: cover;
+            background-position: center;
+            background-blend-mode: overlay;
+        }
+        .cinzel {
+            font-family: 'Cinzel', serif;
+        }
+    </style>
+</head>
+<body class="min-h-screen flex items-center justify-center p-4">
+    <div class="max-w-md w-full bg-gray-900/90 backdrop-blur-md p-8 rounded-2xl shadow-2xl border border-gray-700 text-center">
+        <div class="mb-6">
+            <div class="w-16 h-16 bg-blue-600 rounded-full flex items-center justify-center mx-auto mb-4 animate-pulse">
+                <svg class="w-8 h-8 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19.428 15.428a2 2 0 00-1.022-.547l-2.384-.477a6 6 0 00-3.86.517l-.318.158a6 6 0 01-3.86.517L6.05 15.21a2 2 0 00-1.806.547M8 4h8l-1 1v5.172a2 2 0 00.586 1.414l5 5c1.26 1.26.367 3.414-1.415 3.414H4.828c-1.782 0-2.674-2.154-1.414-3.414l5-5A2 2 0 009 10.172V5L8 4z"/>
+                </svg>
+            </div>
+            <h1 class="text-3xl font-bold text-white cinzel mb-2">Maintenance Mode</h1>
+            <div class="h-1 w-20 bg-blue-600 mx-auto rounded-full"></div>
+        </div>
+        
+        <p class="text-gray-300 mb-8 leading-relaxed">
+            {{ $message }}
+        </p>
+
+        <!-- Links -->
+         <div class="mt-8 mb-6">
+            @can('access.admin.panel')
+                <a href="{{ route('admin.index') }}" class="inline-block px-6 py-3 bg-yellow-600 text-white rounded-full font-semibold hover:bg-yellow-700 transition duration-300 ml-4">
+                    Admin Panel
+                </a>
+            @endcan
+
+            @if(auth()->check())
+            <form method="POST" action="{{ route('logout') }}" class="inline">
+                @csrf
+                <button type="submit" class="inline-block px-6 py-3 bg-green-600 text-white rounded-full font-semibold hover:bg-green-700 transition duration-300 ml-4">
+                    Logout
+                </button>
+            </form>
+            @else
+                <a href="{{ route('login') }}" class="inline-block px-6 py-3 bg-green-600 text-white rounded-full font-semibold hover:bg-green-700 transition duration-300 ml-4">
+                    Login
+                </a>
+            @endif
+        </div>
+        
+        <div class="text-sm text-gray-500">
+            &copy; {{ date('Y') }} {{ settings('site_name', 'NexusCMS') }}. All rights reserved.
+        </div>
+    </div>
+</body>
+</html>
diff --git a/vite.config.js b/vite.config.js
index 9863e5c..637a8c9 100755
--- a/vite.config.js
+++ b/vite.config.js
@@ -10,7 +10,8 @@ export default defineConfig({
                 'resources/js/app.js',
                 'resources/css/ckeditor.css',
                 'resources/css/main.css',
-                'resources/js/editor/ckeditor.js'
+                'resources/js/editor/ckeditor.js',
+                'resources/js/scripts/listColumns.js'
             ],
             refresh: true,
         }),

From 0f41c70b2347e72d1cbb59d5111c87d9833411fc Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 5 Feb 2026 18:43:25 +0100
Subject: [PATCH 070/132] feat(admin): add success message display to settings
 page.

---
 app/Modules/Admin/Resources/views/settings/index.blade.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/app/Modules/Admin/Resources/views/settings/index.blade.php b/app/Modules/Admin/Resources/views/settings/index.blade.php
index 9398bc3..9a47424 100644
--- a/app/Modules/Admin/Resources/views/settings/index.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/index.blade.php
@@ -19,12 +19,19 @@
         @include('admin::settings.extends.menu')
 
         <div class="flex-1 p-6 space-y-6 overflow-y-auto">
+            @if(session('success'))
+                <div class="bg-green-100 border-l-4 border-green-500 text-green-700 p-4 mb-4" role="alert">
+                    <p class="font-bold">Success!</p>
+                    <p>{{ session('success') }}</p>
+                </div>
+            @endif
             <form id="settings-form" action="{{ route('admin.settings.store') }}" method="POST">
                 @csrf
                 <input type="hidden" name="view" value="{{ request('view', 'general') }}">
                 @yield('settings_content')
             </form>
         </div>
+
     </main>
 </div>
 

From f340577dacba2e7a7cbdb2e8cd44bc46e8ffc3e2 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 5 Feb 2026 20:15:33 +0100
Subject: [PATCH 071/132] feat(admin): implement localization, security, and
 seo settings UI

---
 .../views/settings/localization.blade.php     | 59 +++++++++++-
 .../views/settings/security.blade.php         | 81 +++++++++++++++-
 .../Resources/views/settings/seo.blade.php    | 93 ++++++++++++++++++-
 app/Providers/AppServiceProvider.php          |  1 -
 4 files changed, 223 insertions(+), 11 deletions(-)

diff --git a/app/Modules/Admin/Resources/views/settings/localization.blade.php b/app/Modules/Admin/Resources/views/settings/localization.blade.php
index ab5902b..f841216 100644
--- a/app/Modules/Admin/Resources/views/settings/localization.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/localization.blade.php
@@ -4,10 +4,63 @@
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
         <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
-        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+        <p class="text-sm text-gray-600 mt-1">Configure language, time, and currency preferences</p>
     </div>
-    <div class="p-6">
-        <p class="text-gray-500 italic">This section is under construction.</p>
+    <div class="p-6 space-y-4">
+        <div class="grid md:grid-cols-2 gap-4">
+            <div>
+                <label for="default_locale" class="block text-sm font-semibold text-gray-700 mb-2">Default Locale</label>
+                <select id="default_locale" name="default_locale" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    @foreach(config('app.available_locales', ['en' => 'English', 'es' => 'Español', 'fr' => 'Français']) as $code => $name)
+                        <option value="{{ $code }}" {{ ($settings['default_locale'] ?? config('app.locale')) == $code ? 'selected' : '' }}>{{ $name }}</option>
+                    @endforeach
+                </select>
+                <p class="mt-1 text-xs text-gray-500">The default language for the application.</p>
+            </div>
+
+            <div>
+                <label for="fallback_locale" class="block text-sm font-semibold text-gray-700 mb-2">Fallback Locale</label>
+                <select id="fallback_locale" name="fallback_locale" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    @foreach(config('app.available_locales', ['en' => 'English', 'es' => 'Español', 'fr' => 'Français']) as $code => $name)
+                        <option value="{{ $code }}" {{ ($settings['fallback_locale'] ?? config('app.fallback_locale')) == $code ? 'selected' : '' }}>{{ $name }}</option>
+                    @endforeach
+                </select>
+                <p class="mt-1 text-xs text-gray-500">Language used when a translation is missing.</p>
+            </div>
+        </div>
+
+        <div class="grid md:grid-cols-2 gap-4">
+            <div>
+                <label for="timezone" class="block text-sm font-semibold text-gray-700 mb-2">Timezone</label>
+                <select id="timezone" name="timezone" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    @foreach(timezone_identifiers_list() as $tz)
+                        <option value="{{ $tz }}" {{ ($settings['timezone'] ?? config('app.timezone')) == $tz ? 'selected' : '' }}>{{ $tz }}</option>
+                    @endforeach
+                </select>
+                <p class="mt-1 text-xs text-gray-500">System-wide timezone setting.</p>
+            </div>
+        </div>
+
+        <div class="grid md:grid-cols-2 gap-4">
+            <div>
+                <label for="date_format" class="block text-sm font-semibold text-gray-700 mb-2">Date Format</label>
+                <select id="date_format" name="date_format" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <option value="Y-m-d" {{ ($settings['date_format'] ?? 'Y-m-d') == 'Y-m-d' ? 'selected' : '' }}>Y-m-d ({{ date('Y-m-d') }})</option>
+                    <option value="d/m/Y" {{ ($settings['date_format'] ?? '') == 'd/m/Y' ? 'selected' : '' }}>d/m/Y ({{ date('d/m/Y') }})</option>
+                    <option value="m/d/Y" {{ ($settings['date_format'] ?? '') == 'm/d/Y' ? 'selected' : '' }}>m/d/Y ({{ date('m/d/Y') }})</option>
+                </select>
+                <p class="mt-1 text-xs text-gray-500">Display format for dates.</p>
+            </div>
+
+            <div>
+                <label for="time_format" class="block text-sm font-semibold text-gray-700 mb-2">Time Format</label>
+                <select id="time_format" name="time_format" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <option value="H:i" {{ ($settings['time_format'] ?? 'H:i') == 'H:i' ? 'selected' : '' }}>24-hour ({{ date('H:i') }})</option>
+                    <option value="h:i A" {{ ($settings['time_format'] ?? '') == 'h:i A' ? 'selected' : '' }}>12-hour ({{ date('h:i A') }})</option>
+                </select>
+                <p class="mt-1 text-xs text-gray-500">Display format for times.</p>
+            </div>
+        </div>
     </div>
 </div>
 @endsection
diff --git a/app/Modules/Admin/Resources/views/settings/security.blade.php b/app/Modules/Admin/Resources/views/settings/security.blade.php
index ab5902b..c0d331a 100644
--- a/app/Modules/Admin/Resources/views/settings/security.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/security.blade.php
@@ -3,11 +3,84 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
-        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+        <h2 class="text-xl font-bold text-gray-800">Security Settings</h2>
+        <p class="text-sm text-gray-600 mt-1">Configure authentication, password policies y protección de cuentas</p>
     </div>
-    <div class="p-6">
-        <p class="text-gray-500 italic">This section is under construction.</p>
+    <div class="p-6 space-y-8">
+        <div>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">Password Policy</h3>
+            <div class="grid md:grid-cols-2 gap-4">
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Minimum Password Length</label>
+                    <select name="password_min_length" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                        @php $min = (int)($settings['password_min_length'] ?? 12); @endphp
+                        <option value="8" {{ $min === 8 ? 'selected' : '' }}>8</option>
+                        <option value="10" {{ $min === 10 ? 'selected' : '' }}>10</option>
+                        <option value="12" {{ $min === 12 ? 'selected' : '' }}>12</option>
+                        <option value="14" {{ $min === 14 ? 'selected' : '' }}>14</option>
+                        <option value="16" {{ $min === 16 ? 'selected' : '' }}>16</option>
+                    </select>
+                </div>
+                <div class="space-y-3">
+                    <div class="flex items-center gap-2">
+                        <input type="hidden" name="password_require_uppercase" value="0">
+                        <input type="checkbox" name="password_require_uppercase" value="1" id="password_uppercase" {{ ($settings['password_require_uppercase'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
+                        <label for="password_uppercase" class="text-sm text-gray-700">Require Uppercase Letters</label>
+                    </div>
+                    <div class="flex items-center gap-2">
+                        <input type="hidden" name="password_require_numbers" value="0">
+                        <input type="checkbox" name="password_require_numbers" value="1" id="password_numbers" {{ ($settings['password_require_numbers'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
+                        <label for="password_numbers" class="text-sm text-gray-700">Require Numbers</label>
+                    </div>
+                    <div class="flex items-center gap-2">
+                        <input type="hidden" name="password_require_special" value="0">
+                        <input type="checkbox" name="password_require_special" value="1" id="password_special" {{ ($settings['password_require_special'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
+                        <label for="password_special" class="text-sm text-gray-700">Require Special Characters</label>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        <div>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">Account Protection</h3>
+            <div class="grid md:grid-cols-2 gap-4">
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Max Login Attempts</label>
+                    <input type="number" min="1" max="20" name="max_login_attempts" value="{{ $settings['max_login_attempts'] ?? 5 }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Lockout Duration (minutes)</label>
+                    <input type="number" min="1" max="240" name="lockout_duration_minutes" value="{{ $settings['lockout_duration_minutes'] ?? 15 }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+            </div>
+        </div>
+
+        <div>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">Session and Authentication</h3>
+            <div class="grid md:grid-cols-2 gap-4">
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Session Timeout (minutes)</label>
+                    <input type="number" min="5" max="720" name="session_timeout_minutes" value="{{ $settings['session_timeout_minutes'] ?? 30 }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+                <div class="space-y-3">
+                    <div class="flex items-center gap-2">
+                        <input type="hidden" name="force_https" value="0">
+                        <input type="checkbox" name="force_https" value="1" id="force_https" {{ ($settings['force_https'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
+                        <label for="force_https" class="text-sm text-gray-700">Force HTTPS</label>
+                    </div>
+                    <div class="flex items-center gap-2">
+                        <input type="hidden" name="enable_2fa" value="0">
+                        <input type="checkbox" disabled name="enable_2fa" value="1" id="enable_2fa" {{ ($settings['enable_2fa'] ?? '0') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
+                        <label for="enable_2fa" class="text-sm text-gray-700">Enable 2FA</label>
+                    </div>
+                    <div class="flex items-center gap-2">
+                        <input type="hidden" name="require_email_verification" value="0">
+                        <input type="checkbox" disabled name="require_email_verification" value="1" id="require_email_verification" {{ ($settings['require_email_verification'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
+                        <label for="require_email_verification" class="text-sm text-gray-700">Require Email Verification</label>
+                    </div>
+                </div>
+            </div>
+        </div>
     </div>
 </div>
 @endsection
diff --git a/app/Modules/Admin/Resources/views/settings/seo.blade.php b/app/Modules/Admin/Resources/views/settings/seo.blade.php
index ab5902b..2d730a1 100644
--- a/app/Modules/Admin/Resources/views/settings/seo.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/seo.blade.php
@@ -4,10 +4,97 @@
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
         <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
-        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+        <p class="text-sm text-gray-600 mt-1">Configure search engine optimization and social sharing preferences</p>
     </div>
-    <div class="p-6">
-        <p class="text-gray-500 italic">This section is under construction.</p>
+    <div class="p-6 space-y-8">
+        <!-- Global Meta Tags -->
+        <div>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">Global Meta Tags</h3>
+            <div class="space-y-4">
+                <div>
+                    <label for="seo_meta_title" class="block text-sm font-semibold text-gray-700 mb-2">Default Meta Title</label>
+                    <input type="text" id="seo_meta_title" name="seo_meta_title" value="{{ $settings['seo_meta_title'] ?? '' }}" placeholder="{{ $settings['site_name'] ?? 'NexusCMS' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <p class="mt-1 text-xs text-gray-500">Used as the default title tag if no specific title is set for a page.</p>
+                </div>
+                
+                <div>
+                    <label for="seo_meta_description" class="block text-sm font-semibold text-gray-700 mb-2">Default Meta Description</label>
+                    <textarea id="seo_meta_description" name="seo_meta_description" rows="3" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">{{ $settings['seo_meta_description'] ?? '' }}</textarea>
+                    <p class="mt-1 text-xs text-gray-500">A brief summary of your site (recommended 150-160 characters).</p>
+                </div>
+
+                <div>
+                    <label for="seo_meta_keywords" class="block text-sm font-semibold text-gray-700 mb-2">Meta Keywords</label>
+                    <input type="text" id="seo_meta_keywords" name="seo_meta_keywords" value="{{ $settings['seo_meta_keywords'] ?? '' }}" placeholder="wow, server, mmorpg, game" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <p class="mt-1 text-xs text-gray-500">Comma-separated list of keywords.</p>
+                </div>
+            </div>
+        </div>
+
+        <!-- Social Media -->
+        <div>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">Social Media (Open Graph & Twitter)</h3>
+            <div class="grid md:grid-cols-2 gap-4">
+                <div>
+                    <label for="seo_og_image" class="block text-sm font-semibold text-gray-700 mb-2">Default Social Image URL</label>
+                    <input type="text" id="seo_og_image" name="seo_og_image" value="{{ $settings['seo_og_image'] ?? '' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <p class="mt-1 text-xs text-gray-500">Absolute URL to an image used when sharing on social media.</p>
+                </div>
+
+                <div>
+                    <label for="seo_twitter_handle" class="block text-sm font-semibold text-gray-700 mb-2">Twitter Handle</label>
+                    <div class="relative">
+                        <span class="absolute inset-y-0 left-0 pl-3 flex items-center text-gray-500">@</span>
+                        <input type="text" id="seo_twitter_handle" name="seo_twitter_handle" value="{{ $settings['seo_twitter_handle'] ?? '' }}" class="w-full pl-8 px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    </div>
+                    <p class="mt-1 text-xs text-gray-500">Your site's Twitter username.</p>
+                </div>
+            </div>
+        </div>
+
+        <!-- Analytics & Tracking -->
+        <div>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">Analytics & Tracking</h3>
+            <div class="grid md:grid-cols-2 gap-4">
+                <div>
+                    <label for="seo_google_analytics" class="block text-sm font-semibold text-gray-700 mb-2">Google Analytics ID</label>
+                    <input type="text" id="seo_google_analytics" name="seo_google_analytics" value="{{ $settings['seo_google_analytics'] ?? '' }}" placeholder="G-XXXXXXXXXX" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <p class="mt-1 text-xs text-gray-500">Your Google Analytics 4 Measurement ID.</p>
+                </div>
+                <div>
+                    <label for="seo_gtm_id" class="block text-sm font-semibold text-gray-700 mb-2">Google Tag Manager ID</label>
+                    <input type="text" id="seo_gtm_id" name="seo_gtm_id" value="{{ $settings['seo_gtm_id'] ?? '' }}" placeholder="GTM-XXXXXX" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+            </div>
+        </div>
+
+        <!-- Custom Scripts -->
+        <div>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">Custom Scripts</h3>
+            <div class="space-y-4">
+                <div>
+                    <label for="seo_custom_head" class="block text-sm font-semibold text-gray-700 mb-2">Header Scripts</label>
+                    <textarea id="seo_custom_head" name="seo_custom_head" rows="4" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 font-mono text-xs">{{ $settings['seo_custom_head'] ?? '' }}</textarea>
+                    <p class="mt-1 text-xs text-gray-500">Code to be inserted before the closing &lt;/head&gt; tag.</p>
+                </div>
+                <div>
+                    <label for="seo_custom_body" class="block text-sm font-semibold text-gray-700 mb-2">Body Scripts</label>
+                    <textarea id="seo_custom_body" name="seo_custom_body" rows="4" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 font-mono text-xs">{{ $settings['seo_custom_body'] ?? '' }}</textarea>
+                    <p class="mt-1 text-xs text-gray-500">Code to be inserted before the closing &lt;/body&gt; tag.</p>
+                </div>
+            </div>
+        </div>
+
+        <!-- Indexing -->
+        <div>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">Indexing</h3>
+            <div class="flex items-center gap-2">
+                <input type="hidden" name="seo_allow_indexing" value="0">
+                <input type="checkbox" id="seo_allow_indexing" name="seo_allow_indexing" value="1" {{ ($settings['seo_allow_indexing'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300 text-blue-600 shadow-sm focus:border-blue-300 focus:ring focus:ring-blue-200 focus:ring-opacity-50">
+                <label for="seo_allow_indexing" class="text-sm text-gray-700">Allow search engines to index this site</label>
+            </div>
+            <p class="mt-1 text-xs text-gray-500 ml-6">Uncheck this to add &lt;meta name="robots" content="noindex, nofollow"&gt; to your pages.</p>
+        </div>
     </div>
 </div>
 @endsection
diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php
index 9d518b4..1e4b7cd 100755
--- a/app/Providers/AppServiceProvider.php
+++ b/app/Providers/AppServiceProvider.php
@@ -45,7 +45,6 @@ public function register(): void
     public function boot(): void
     {
         if (!file_exists(storage_path('installed.lock'))) {
-            // Durante la instalación forzamos sesiones en archivos
             Config::set('session.driver', 'file');
             Config::set('cache.default', 'file');
             Config::set('queue.default', 'sync');

From 8f5821ffd263d4a8d2cb23dcafb1ae903e79c446 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 6 Feb 2026 00:11:53 +0100
Subject: [PATCH 072/132] feat(admin): add multi-language support for admin
 settings

- Enable translation loading in Admin module configuration
- Add JSON translation files for English and Spanish
- Update all admin settings Blade views to use __() helper
- Set application locale based on settings in ModuleServiceProvider
- Extend BaseModuleServiceProvider to load module translations
---
 app/Modules/Admin/Resources/lang/en.json      | 55 ++++++++++++++++++
 app/Modules/Admin/Resources/lang/es.json      | 57 +++++++++++++++++++
 .../views/settings/advanced.blade.php         |  6 +-
 .../Resources/views/settings/email.blade.php  | 18 +++---
 .../views/settings/general.blade.php          | 22 +++----
 .../views/settings/localization.blade.php     | 32 ++++-------
 .../views/settings/maintenance.blade.php      | 12 ++--
 .../views/settings/security.blade.php         | 30 +++++-----
 app/Modules/Admin/module.json                 |  1 +
 app/Providers/BaseModuleServiceProvider.php   | 12 ++++
 app/Providers/ModuleServiceProvider.php       |  6 ++
 resources/lang/en.json                        |  4 ++
 12 files changed, 189 insertions(+), 66 deletions(-)
 create mode 100644 app/Modules/Admin/Resources/lang/en.json
 create mode 100644 app/Modules/Admin/Resources/lang/es.json
 create mode 100644 resources/lang/en.json

diff --git a/app/Modules/Admin/Resources/lang/en.json b/app/Modules/Admin/Resources/lang/en.json
new file mode 100644
index 0000000..dcf36e7
--- /dev/null
+++ b/app/Modules/Admin/Resources/lang/en.json
@@ -0,0 +1,55 @@
+{
+  "Localization Settings": "Localization Settings",
+  "Configure language, time, and currency preferences": "Configure language, time, and currency preferences",
+  "Default Locale": "Default Locale",
+  "The default language for the application.": "The default language for the application.",
+  "Fallback Locale": "Fallback Locale",
+  "Language used when a translation is missing.": "Language used when a translation is missing.",
+  "Timezone": "Timezone",
+  "System-wide timezone setting.": "System-wide timezone setting.",
+  "Date Format": "Date Format",
+  "Display format for dates.": "Display format for dates.",
+  "Time Format": "Time Format",
+  "Display format for times.": "Display format for times.",
+  "Advanced Settings": "Advanced Settings",
+  "Configure advanced settings": "Configure advanced settings",
+  "This section is under construction.": "This section is under construction.",
+  "Maintenance Settings": "Maintenance Settings",
+  "Configure maintenance mode and access settings": "Configure maintenance mode and access settings",
+  "Enable Maintenance Mode": "Enable Maintenance Mode",
+  "Maintenance Message": "Maintenance Message",
+  "This message will be displayed to users when maintenance mode is active.": "This message will be displayed to users when maintenance mode is active.",
+  "Email Settings": "Email Settings",
+  "Configure SMTP settings for outgoing emails.": "Configure SMTP settings for outgoing emails.",
+  "SMTP Host": "SMTP Host",
+  "Hostname or IP address of the SMTP server.": "Hostname or IP address of the SMTP server.",
+  "SMTP Port": "SMTP Port",
+  "Port number for the SMTP server.": "Port number for the SMTP server.",
+  "SMTP Username": "SMTP Username",
+  "SMTP Password": "SMTP Password",
+  "Encryption": "Encryption",
+  "From Name": "From Name",
+  "Send Test Email": "Send Test Email",
+  "General Settings": "General Settings",
+  "Configure basic site information and settings": "Configure basic site information and settings.",
+  "Site Name": "Site Name",
+  "Site URL": "Site URL",
+  "Site Description": "Site Description",
+  "Admin Email": "Admin Email",
+  "Allow new user registrations": "Allow new user registrations",
+  "Security Settings": "Security Settings",
+  "Configure authentication, password policies, and account protection settings": "Configure authentication, password policies, and account protection settings.",
+  "Password Policies": "Password Policies",
+  "Minimum Password Length": "Minimum Password Length",
+  "Require Uppercase Letters": "Require Uppercase Letters",
+  "Require Numbers": "Require Numbers",
+  "Require Special Characters": "Require Special Characters",
+  "Account Protection": "Account Protection",
+  "Max Login Attempts": "Max Login Attempts",
+  "Lockout Duration (minutes)": "Lockout Duration (minutes)",
+  "Session and Authentication": "Session and Authentication",
+  "Session Timeout (minutes)": "Session Timeout (minutes)",
+  "Force HTTPS": "Force HTTPS",
+  "Enable 2FA": "Enable 2FA",
+  "Require Email Verification": "Require Email Verification"
+}
diff --git a/app/Modules/Admin/Resources/lang/es.json b/app/Modules/Admin/Resources/lang/es.json
new file mode 100644
index 0000000..413b1af
--- /dev/null
+++ b/app/Modules/Admin/Resources/lang/es.json
@@ -0,0 +1,57 @@
+{
+  "Localization Settings": "Configuración de Localización",
+  "Configure language, time, and currency preferences": "Configura preferencias de idioma, hora y moneda",
+  "Default Locale": "Idioma por defecto",
+  "The default language for the application.": "El idioma por defecto de la aplicación.",
+  "Fallback Locale": "Idioma de respaldo",
+  "Language used when a translation is missing.": "Idioma usado cuando falta una traducción.",
+  "Available Locales": "Idiomas disponibles",
+  "Comma-separated list of enabled locales.": "Lista de idiomas habilitados separada por comas.",
+  "Timezone": "Zona horaria",
+  "System-wide timezone setting.": "Ajuste de zona horaria del sistema.",
+  "Date Format": "Formato de fecha",
+  "Display format for dates.": "Formato de visualización para fechas.",
+  "Time Format": "Formato de hora",
+  "Display format for times.": "Formato de visualización para horas.",
+  "Advanced Settings": "Configuración Avanzada",
+  "Configure advanced settings": "Configura ajustes avanzados",
+  "This section is under construction.": "Esta sección está en construcción.",
+  "Maintenance Settings": "Configuración de Mantenimiento",
+  "Configure maintenance mode and access settings": "Configura el modo de mantenimiento y los ajustes de acceso",
+  "Enable Maintenance Mode": "Habilitar Modo de Mantenimiento",
+  "Maintenance Message": "Mensaje de Mantenimiento",
+  "This message will be displayed to users when maintenance mode is active.": "Este mensaje se mostrará a los usuarios cuando el modo de mantenimiento esté activo.",
+  "Email Settings": "Configuración de Correo",
+  "Configure SMTP settings for outgoing emails.": "Configura los ajustes de correo para el envío de correos.",
+  "SMTP Host": "Host SMTP",
+  "Hostname or IP address of the SMTP server.": "Nombre de host o dirección IP del servidor SMTP.",
+  "SMTP Port": "Puerto SMTP",
+  "Port number for the SMTP server.": "Número de puerto para el servidor SMTP.",
+  "SMTP Username": "Nombre de usuario SMTP",
+  "SMTP Password": "Contraseña SMTP",
+  "Encryption": "Encriptación",
+  "From Name": "Nombre de Origen",
+  "Send Test Email": "Enviar Correo de Prueba",
+  "General Settings": "Configuración General",
+  "Configure basic site information and settings": "Configura la información básica del sitio y los ajustes.",
+  "Site Name": "Nombre del Sitio",
+  "Site URL": "URL del Sitio",
+  "Site Description": "Descripción del Sitio",
+  "Admin Email": "Correo Electrónico del Administrador",
+  "Allow new user registrations": "Permitir registros de nuevos usuarios",
+  "Security Settings": "Configuración de Seguridad",
+  "Configure authentication, password policies, and account protection settings": "Configura la autenticación, políticas de contraseña y protección de cuenta.",
+  "Password Policies": "Políticas de Contraseña",
+  "Minimum Password Length": "Longitud Mínima de Contraseña",   
+  "Require Uppercase Letters": "Requerir Letras Mayúsculas",
+  "Require Numbers": "Requerir Números",
+  "Require Special Characters": "Requerir Caracteres Especiales",
+  "Account Protection": "Protección de Cuenta",
+  "Max Login Attempts": "Máximo de Intentos de Inicio de Sesión",
+  "Lockout Duration (minutes)": "Duración de Bloqueo (minutos)",
+  "Session and Authentication": "Configuración de Sesión y Autenticación",  
+  "Session Timeout (minutes)": "Timeout de Sesión (minutos)",
+  "Force HTTPS": "Forzar HTTPS",
+  "Enable 2FA": "Habilitar 2FA",
+  "Require Email Verification": "Requerir Verificación de Correo Electrónico"
+}
\ No newline at end of file
diff --git a/app/Modules/Admin/Resources/views/settings/advanced.blade.php b/app/Modules/Admin/Resources/views/settings/advanced.blade.php
index ab5902b..d5c9ac5 100644
--- a/app/Modules/Admin/Resources/views/settings/advanced.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/advanced.blade.php
@@ -3,11 +3,11 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
-        <p class="text-sm text-gray-600 mt-1">Configure {{ $view }} settings</p>
+        <h2 class="text-xl font-bold text-gray-800">{{ __('Advanced Settings') }}</h2>
+        <p class="text-sm text-gray-600 mt-1">{{ __('Configure advanced settings') }}</p>
     </div>
     <div class="p-6">
-        <p class="text-gray-500 italic">This section is under construction.</p>
+        <p class="text-gray-500 italic">{{ __('This section is under construction.') }}</p>
     </div>
 </div>
 @endsection
diff --git a/app/Modules/Admin/Resources/views/settings/email.blade.php b/app/Modules/Admin/Resources/views/settings/email.blade.php
index 84fb402..7995118 100644
--- a/app/Modules/Admin/Resources/views/settings/email.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/email.blade.php
@@ -3,33 +3,33 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">Email Configuration</h2>
-        <p class="text-sm text-gray-600 mt-1">Configure SMTP settings for outgoing emails</p>
+        <h2 class="text-xl font-bold text-gray-800">{{ __('Email Settings') }}</h2> 
+        <p class="text-sm text-gray-600 mt-1">{{ __('Configure SMTP settings for outgoing emails') }}</p>
     </div>
     <div class="p-6 space-y-4">
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">SMTP Host</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('SMTP Host') }}</label>
                 <input type="text" name="smtp_host" value="{{ $settings['smtp_host'] ?? '' }}" placeholder="smtp.example.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">SMTP Port</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('SMTP Port') }}</label>
                 <input type="number" name="smtp_port" value="{{ $settings['smtp_port'] ?? '587' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
         </div>
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">SMTP Username</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('SMTP Username') }}</label>
                 <input type="text" name="smtp_username" value="{{ $settings['smtp_username'] ?? '' }}" placeholder="noreply@nexuscms.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">SMTP Password</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('SMTP Password') }}</label>
                 <input type="password" name="smtp_password" value="{{ $settings['smtp_password'] ?? '' }}" placeholder="••••••••" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
         </div>
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">Encryption</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Encryption') }}</label>
                 <select name="smtp_encryption" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="tls" {{ ($settings['smtp_encryption'] ?? '') == 'tls' ? 'selected' : '' }}>TLS</option>
                     <option value="ssl" {{ ($settings['smtp_encryption'] ?? '') == 'ssl' ? 'selected' : '' }}>SSL</option>
@@ -37,13 +37,13 @@
                 </select>
             </div>
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">From Name</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('From Name') }}</label>
                 <input type="text" name="mail_from_name" value="{{ $settings['mail_from_name'] ?? 'NexusCMS' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
         </div>
         <div>
             <button type="button" class="px-4 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300 font-medium">
-                <i class="fas fa-paper-plane mr-2"></i>Send Test Email
+                <i class="fas fa-paper-plane mr-2"></i>{{ __('Send Test Email') }}
             </button>
         </div>
     </div>
diff --git a/app/Modules/Admin/Resources/views/settings/general.blade.php b/app/Modules/Admin/Resources/views/settings/general.blade.php
index 3169fac..d0810d2 100644
--- a/app/Modules/Admin/Resources/views/settings/general.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/general.blade.php
@@ -3,31 +3,31 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">General Settings</h2>
-        <p class="text-sm text-gray-600 mt-1">Configure basic site information and settings</p>
+        <h2 class="text-xl font-bold text-gray-800">{{ __('General Settings') }}</h2>
+        <p class="text-sm text-gray-600 mt-1">{{ __('Configure basic site information and settings') }}</p>
     </div>
     <div class="p-6 space-y-4">
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">Site Name</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Site Name') }}</label>
                 <input type="text" name="site_name" value="{{ $settings['site_name'] ?? 'NexusCMS' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">Site URL</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Site URL') }}</label>
                 <input type="text" name="site_url" value="{{ $settings['site_url'] ?? 'https://nexuscms.example.com' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
         </div>
         <div>
-            <label class="block text-sm font-semibold text-gray-700 mb-2">Site Description</label>
-            <textarea name="site_description" rows="3" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">{{ $settings['site_description'] ?? 'The ultimate World of Warcraft private server experience with custom content and balanced gameplay.' }}</textarea>
+            <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Site Description') }}</label>
+            <textarea name="site_description" rows="3" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">{{ $settings['site_description'] ?? __('The ultimate World of Warcraft private server experience with custom content and balanced gameplay.') }}</textarea>
         </div>
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">Admin Email</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Admin Email') }}</label>
                 <input type="email" name="admin_email" value="{{ $settings['admin_email'] ?? 'admin@nexuscms.com' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">Time Zone</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Timezone') }}</label>
                 <select name="timezone" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="UTC" {{ ($settings['timezone'] ?? '') == 'UTC' ? 'selected' : '' }}>UTC</option>
                     <option value="Europe/Madrid" {{ ($settings['timezone'] ?? '') == 'Europe/Madrid' ? 'selected' : '' }}>Europe/Madrid</option>
@@ -38,7 +38,7 @@
         </div>
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">Date Format</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Date Format') }}</label>
                 <select name="date_format" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="Y-m-d" {{ ($settings['date_format'] ?? '') == 'Y-m-d' ? 'selected' : '' }}>Y-m-d (2024-01-29)</option>
                     <option value="d/m/Y" {{ ($settings['date_format'] ?? '') == 'd/m/Y' ? 'selected' : '' }}>d/m/Y (29/01/2024)</option>
@@ -46,7 +46,7 @@
                 </select>
             </div>
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">Time Format</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Time Format') }}</label>
                 <select name="time_format" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="H:i" {{ ($settings['time_format'] ?? '') == 'H:i' ? 'selected' : '' }}>24-hour (14:30)</option>
                     <option value="h:i A" {{ ($settings['time_format'] ?? '') == 'h:i A' ? 'selected' : '' }}>12-hour (2:30 PM)</option>
@@ -56,7 +56,7 @@
         <div class="flex items-center gap-2">
             <input type="hidden" name="allow_registration" value="0">
             <input type="checkbox" name="allow_registration" value="1" id="registration" {{ ($settings['allow_registration'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-            <label for="registration" class="text-sm text-gray-700">Allow new user registrations</label>
+            <label for="registration" class="text-sm text-gray-700">{{ __('Allow new user registrations') }}</label>
         </div>
     </div>
 </div>
diff --git a/app/Modules/Admin/Resources/views/settings/localization.blade.php b/app/Modules/Admin/Resources/views/settings/localization.blade.php
index f841216..3a0f982 100644
--- a/app/Modules/Admin/Resources/views/settings/localization.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/localization.blade.php
@@ -3,62 +3,50 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">{{ ucfirst($view) }} Settings</h2>
-        <p class="text-sm text-gray-600 mt-1">Configure language, time, and currency preferences</p>
+        <h2 class="text-xl font-bold text-gray-800">{{ __('Localization Settings') }}</h2>
+        <p class="text-sm text-gray-600 mt-1">{{ __('Configure language, time, and currency preferences') }}</p>
     </div>
     <div class="p-6 space-y-4">
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label for="default_locale" class="block text-sm font-semibold text-gray-700 mb-2">Default Locale</label>
+                <label for="default_locale" class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Default Locale') }}</label>
                 <select id="default_locale" name="default_locale" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     @foreach(config('app.available_locales', ['en' => 'English', 'es' => 'Español', 'fr' => 'Français']) as $code => $name)
                         <option value="{{ $code }}" {{ ($settings['default_locale'] ?? config('app.locale')) == $code ? 'selected' : '' }}>{{ $name }}</option>
                     @endforeach
                 </select>
-                <p class="mt-1 text-xs text-gray-500">The default language for the application.</p>
+                <p class="mt-1 text-xs text-gray-500">{{ __('The default language for the application.') }}</p>
             </div>
 
             <div>
-                <label for="fallback_locale" class="block text-sm font-semibold text-gray-700 mb-2">Fallback Locale</label>
-                <select id="fallback_locale" name="fallback_locale" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
-                    @foreach(config('app.available_locales', ['en' => 'English', 'es' => 'Español', 'fr' => 'Français']) as $code => $name)
-                        <option value="{{ $code }}" {{ ($settings['fallback_locale'] ?? config('app.fallback_locale')) == $code ? 'selected' : '' }}>{{ $name }}</option>
-                    @endforeach
-                </select>
-                <p class="mt-1 text-xs text-gray-500">Language used when a translation is missing.</p>
-            </div>
-        </div>
-
-        <div class="grid md:grid-cols-2 gap-4">
-            <div>
-                <label for="timezone" class="block text-sm font-semibold text-gray-700 mb-2">Timezone</label>
+                <label for="timezone" class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Timezone') }}</label>
                 <select id="timezone" name="timezone" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     @foreach(timezone_identifiers_list() as $tz)
                         <option value="{{ $tz }}" {{ ($settings['timezone'] ?? config('app.timezone')) == $tz ? 'selected' : '' }}>{{ $tz }}</option>
                     @endforeach
                 </select>
-                <p class="mt-1 text-xs text-gray-500">System-wide timezone setting.</p>
+                <p class="mt-1 text-xs text-gray-500">{{ __('System-wide timezone setting.') }}</p> 
             </div>
         </div>
 
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label for="date_format" class="block text-sm font-semibold text-gray-700 mb-2">Date Format</label>
+                <label for="date_format" class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Date Format') }}</label>
                 <select id="date_format" name="date_format" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="Y-m-d" {{ ($settings['date_format'] ?? 'Y-m-d') == 'Y-m-d' ? 'selected' : '' }}>Y-m-d ({{ date('Y-m-d') }})</option>
                     <option value="d/m/Y" {{ ($settings['date_format'] ?? '') == 'd/m/Y' ? 'selected' : '' }}>d/m/Y ({{ date('d/m/Y') }})</option>
                     <option value="m/d/Y" {{ ($settings['date_format'] ?? '') == 'm/d/Y' ? 'selected' : '' }}>m/d/Y ({{ date('m/d/Y') }})</option>
                 </select>
-                <p class="mt-1 text-xs text-gray-500">Display format for dates.</p>
+                <p class="mt-1 text-xs text-gray-500">{{ __('Display format for dates.') }}</p>
             </div>
 
             <div>
-                <label for="time_format" class="block text-sm font-semibold text-gray-700 mb-2">Time Format</label>
+                <label for="time_format" class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Time Format') }}</label>
                 <select id="time_format" name="time_format" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="H:i" {{ ($settings['time_format'] ?? 'H:i') == 'H:i' ? 'selected' : '' }}>24-hour ({{ date('H:i') }})</option>
                     <option value="h:i A" {{ ($settings['time_format'] ?? '') == 'h:i A' ? 'selected' : '' }}>12-hour ({{ date('h:i A') }})</option>
                 </select>
-                <p class="mt-1 text-xs text-gray-500">Display format for times.</p>
+                <p class="mt-1 text-xs text-gray-500">{{ __('Display format for times.') }}</p>
             </div>
         </div>
     </div>
diff --git a/app/Modules/Admin/Resources/views/settings/maintenance.blade.php b/app/Modules/Admin/Resources/views/settings/maintenance.blade.php
index b405af9..f88c28f 100644
--- a/app/Modules/Admin/Resources/views/settings/maintenance.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/maintenance.blade.php
@@ -3,19 +3,19 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">Maintenance Settings</h2>
-        <p class="text-sm text-gray-600 mt-1">Configure maintenance mode and access settings</p>
+        <h2 class="text-xl font-bold text-gray-800">{{ __('Maintenance Settings') }}</h2>
+        <p class="text-sm text-gray-600 mt-1">{{ __('Configure maintenance mode and access settings') }}</p>
     </div>
     <div class="p-6 space-y-6">
         <div class="flex items-center gap-2">
             <input type="hidden" name="maintenance_mode" value="0">
             <input type="checkbox" name="maintenance_mode" value="1" id="maintenance_mode" {{ ($settings['maintenance_mode'] ?? '0') == '1' ? 'checked' : '' }} class="rounded border-gray-300 text-blue-600 focus:ring-blue-500">
-            <label for="maintenance_mode" class="text-sm font-medium text-gray-700">Enable Maintenance Mode</label>
+            <label for="maintenance_mode" class="text-sm font-medium text-gray-700">{{ __('Enable Maintenance Mode') }}</label>
         </div>
         <div>
-            <label class="block text-sm font-semibold text-gray-700 mb-2">Maintenance Message</label>
-            <textarea name="maintenance_message" rows="4" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">{{ $settings['maintenance_message'] ?? 'We are currently performing scheduled maintenance. We will be back shortly.' }}</textarea>
-            <p class="text-xs text-gray-500 mt-1">This message will be displayed to users when maintenance mode is active.</p>
+            <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Maintenance Message') }}</label>
+            <textarea name="maintenance_message" rows="4" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">{{ $settings['maintenance_message'] ?? __('We are currently performing scheduled maintenance. We will be back shortly.') }}</textarea>
+            <p class="text-xs text-gray-500 mt-1">{{ __('This message will be displayed to users when maintenance mode is active.') }}</p>
         </div>
     </div>
 </div>
diff --git a/app/Modules/Admin/Resources/views/settings/security.blade.php b/app/Modules/Admin/Resources/views/settings/security.blade.php
index c0d331a..45fd49b 100644
--- a/app/Modules/Admin/Resources/views/settings/security.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/security.blade.php
@@ -3,15 +3,15 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">Security Settings</h2>
-        <p class="text-sm text-gray-600 mt-1">Configure authentication, password policies y protección de cuentas</p>
+        <h2 class="text-xl font-bold text-gray-800">{{ __('Security Settings') }}</h2>
+        <p class="text-sm text-gray-600 mt-1">{{ __('Configure authentication, password policies, and account protection settings') }}</p>
     </div>
     <div class="p-6 space-y-8">
         <div>
-            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">Password Policy</h3>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">{{ __('Password Policies') }}</h3>
             <div class="grid md:grid-cols-2 gap-4">
                 <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Minimum Password Length</label>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Minimum Password Length') }}</label>
                     <select name="password_min_length" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                         @php $min = (int)($settings['password_min_length'] ?? 12); @endphp
                         <option value="8" {{ $min === 8 ? 'selected' : '' }}>8</option>
@@ -25,58 +25,58 @@
                     <div class="flex items-center gap-2">
                         <input type="hidden" name="password_require_uppercase" value="0">
                         <input type="checkbox" name="password_require_uppercase" value="1" id="password_uppercase" {{ ($settings['password_require_uppercase'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-                        <label for="password_uppercase" class="text-sm text-gray-700">Require Uppercase Letters</label>
+                        <label for="password_uppercase" class="text-sm text-gray-700">{{ __('Require Uppercase Letters') }}</label>
                     </div>
                     <div class="flex items-center gap-2">
                         <input type="hidden" name="password_require_numbers" value="0">
                         <input type="checkbox" name="password_require_numbers" value="1" id="password_numbers" {{ ($settings['password_require_numbers'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-                        <label for="password_numbers" class="text-sm text-gray-700">Require Numbers</label>
+                        <label for="password_numbers" class="text-sm text-gray-700">{{ __('Require Numbers') }}</label>
                     </div>
                     <div class="flex items-center gap-2">
                         <input type="hidden" name="password_require_special" value="0">
                         <input type="checkbox" name="password_require_special" value="1" id="password_special" {{ ($settings['password_require_special'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-                        <label for="password_special" class="text-sm text-gray-700">Require Special Characters</label>
+                        <label for="password_special" class="text-sm text-gray-700">{{ __('Require Special Characters') }}</label>
                     </div>
                 </div>
             </div>
         </div>
 
         <div>
-            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">Account Protection</h3>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">{{ __('Account Protection') }}</h3>
             <div class="grid md:grid-cols-2 gap-4">
                 <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Max Login Attempts</label>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Max Login Attempts') }}</label>
                     <input type="number" min="1" max="20" name="max_login_attempts" value="{{ $settings['max_login_attempts'] ?? 5 }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                 </div>
                 <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Lockout Duration (minutes)</label>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Lockout Duration (minutes)') }}</label>
                     <input type="number" min="1" max="240" name="lockout_duration_minutes" value="{{ $settings['lockout_duration_minutes'] ?? 15 }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                 </div>
             </div>
         </div>
 
         <div>
-            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">Session and Authentication</h3>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">{{ __('Session and Authentication') }}</h3>
             <div class="grid md:grid-cols-2 gap-4">
                 <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">Session Timeout (minutes)</label>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Session Timeout (minutes)') }}</label>
                     <input type="number" min="5" max="720" name="session_timeout_minutes" value="{{ $settings['session_timeout_minutes'] ?? 30 }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                 </div>
                 <div class="space-y-3">
                     <div class="flex items-center gap-2">
                         <input type="hidden" name="force_https" value="0">
                         <input type="checkbox" name="force_https" value="1" id="force_https" {{ ($settings['force_https'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-                        <label for="force_https" class="text-sm text-gray-700">Force HTTPS</label>
+                        <label for="force_https" class="text-sm text-gray-700">{{ __('Force HTTPS') }}</label>
                     </div>
                     <div class="flex items-center gap-2">
                         <input type="hidden" name="enable_2fa" value="0">
                         <input type="checkbox" disabled name="enable_2fa" value="1" id="enable_2fa" {{ ($settings['enable_2fa'] ?? '0') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-                        <label for="enable_2fa" class="text-sm text-gray-700">Enable 2FA</label>
+                        <label for="enable_2fa" class="text-sm text-gray-700">{{ __('Enable 2FA') }}</label>
                     </div>
                     <div class="flex items-center gap-2">
                         <input type="hidden" name="require_email_verification" value="0">
                         <input type="checkbox" disabled name="require_email_verification" value="1" id="require_email_verification" {{ ($settings['require_email_verification'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-                        <label for="require_email_verification" class="text-sm text-gray-700">Require Email Verification</label>
+                        <label for="require_email_verification" class="text-sm text-gray-700">{{ __('Require Email Verification') }}</label>
                     </div>
                 </div>
             </div>
diff --git a/app/Modules/Admin/module.json b/app/Modules/Admin/module.json
index 406aa95..5a2385a 100644
--- a/app/Modules/Admin/module.json
+++ b/app/Modules/Admin/module.json
@@ -4,5 +4,6 @@
     "routes": true,
     "migrations": true,
     "views": true,
+    "translations": true,
     "namespace": "Modules\\Admin"
 }
\ No newline at end of file
diff --git a/app/Providers/BaseModuleServiceProvider.php b/app/Providers/BaseModuleServiceProvider.php
index 952f175..148bcd3 100644
--- a/app/Providers/BaseModuleServiceProvider.php
+++ b/app/Providers/BaseModuleServiceProvider.php
@@ -36,6 +36,10 @@ public function boot(): void
         if ($this->config['views'] ?? false) {
             $this->loadViews();
         }
+
+        if ($this->config['translations'] ?? false) {
+            $this->loadTranslations();
+        }
     }
 
     private function loadModuleConfig(): void
@@ -71,4 +75,12 @@ private function loadViews(): void
             $this->loadViewsFrom($path, strtolower($this->moduleName));
         }
     }
+
+    private function loadTranslations(): void
+    {
+        $path = $this->modulePath . '/Resources/lang';
+        if (is_dir($path)) {
+            $this->loadJsonTranslationsFrom($path, strtolower($this->moduleName));
+        }
+    }
 }
diff --git a/app/Providers/ModuleServiceProvider.php b/app/Providers/ModuleServiceProvider.php
index 634ac24..04c68f3 100644
--- a/app/Providers/ModuleServiceProvider.php
+++ b/app/Providers/ModuleServiceProvider.php
@@ -13,4 +13,10 @@ public function register(): void
             $this->app->register($provider);
         }
     }
+
+    public function boot(): void
+    {
+        $locale = settings('default_locale') ?? 'es';
+        $this->app->setLocale($locale);
+    }
 }
diff --git a/resources/lang/en.json b/resources/lang/en.json
new file mode 100644
index 0000000..d617170
--- /dev/null
+++ b/resources/lang/en.json
@@ -0,0 +1,4 @@
+{
+    "Latest News": "Latest News 213",
+    "Stay up to date with the latest server news, events, and updates.": "Stay up to date with the latest server news, events, and updates."
+}
\ No newline at end of file

From e8344f238e9de277e5ba8674a819d7fea3bd1449 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 7 Feb 2026 04:56:20 +0100
Subject: [PATCH 073/132] feat(admin): externalize settings translations to
 language files

- Replace hardcoded strings in admin settings blade templates with translation keys
- Add English and Spanish translation files for settings module
- Fix translation loading method in BaseModuleServiceProvider to use loadTranslationsFrom instead of loadJsonTranslationsFrom
---
 .../Admin/Resources/lang/en/settings.php      | 95 ++++++++++++++++++
 .../Admin/Resources/lang/es/settings.php      | 96 +++++++++++++++++++
 .../views/settings/advanced.blade.php         |  6 +-
 .../Resources/views/settings/email.blade.php  | 20 ++--
 .../views/settings/general.blade.php          | 20 ++--
 .../views/settings/maintenance.blade.php      | 10 +-
 .../views/settings/security.blade.php         | 30 +++---
 app/Providers/BaseModuleServiceProvider.php   |  6 +-
 8 files changed, 239 insertions(+), 44 deletions(-)
 create mode 100644 app/Modules/Admin/Resources/lang/en/settings.php
 create mode 100644 app/Modules/Admin/Resources/lang/es/settings.php

diff --git a/app/Modules/Admin/Resources/lang/en/settings.php b/app/Modules/Admin/Resources/lang/en/settings.php
new file mode 100644
index 0000000..5f299d3
--- /dev/null
+++ b/app/Modules/Admin/Resources/lang/en/settings.php
@@ -0,0 +1,95 @@
+<?php
+
+return [
+    'localization' => [
+        'title' => 'Localization Settings',
+        'description' => 'Configure language, time, and currency preferences',
+        'default_locale' => [
+            'label' => 'Default Locale',
+            'help'  => 'The default language for the application.',
+        ],
+        'fallback_locale' => [
+            'label' => 'Fallback Locale',
+            'help'  => 'Language used when a translation is missing.',
+        ],
+        'timezone' => [
+            'label' => 'Timezone',
+            'help'  => 'System-wide timezone setting.',
+        ],
+        'date_format' => [
+            'label' => 'Date Format',
+            'help'  => 'Display format for dates.',
+        ],
+        'time_format' => [
+            'label' => 'Time Format',
+            'help'  => 'Display format for times.',
+        ],
+    ],
+
+    'advanced' => [
+        'title' => 'Advanced Settings',
+        'description' => 'Configure advanced settings',
+        'under_construction' => 'This section is under construction.',
+    ],
+
+    'maintenance' => [
+        'title' => 'Maintenance Settings',
+        'description' => 'Configure maintenance mode and access settings',
+        'enabled' => 'Enable Maintenance Mode',
+        'message' => [
+            'label' => 'Maintenance Message',
+            'help'  => 'This message will be displayed to users when maintenance mode is active.',
+        ],
+    ],
+
+    'email' => [
+        'title' => 'Email Settings',
+        'description' => 'Configure SMTP settings for outgoing emails.',
+        'smtp_host' => [
+            'label' => 'SMTP Host',
+            'help'  => 'Hostname or IP address of the SMTP server.',
+        ],
+        'smtp_port' => [
+            'label' => 'SMTP Port',
+            'help'  => 'Port number for the SMTP server.',
+        ],
+        'smtp_username' => 'SMTP Username',
+        'smtp_password' => 'SMTP Password',
+        'smtp_encryption' => 'Encryption',
+        'mail_from_name' => 'From Name',
+        'send_test' => 'Send Test Email',
+    ],
+
+    'general' => [
+        'title' => 'General Settings',
+        'description' => 'Configure basic site information and settings',
+        'site_name' => 'Site Name',
+        'site_url' => 'Site URL',
+        'site_description' => 'Site Description',
+        'admin_email' => 'Admin Email',
+        'allow_registration' => 'Allow new user registrations',
+    ],
+    'security' => [
+        'title' => 'Security Settings',
+        'description' => 'Configure authentication, password policies, and account protection settings',
+        'password_policies' => [
+            'title' => 'Password Policies',
+            'min_length' => 'Minimum Password Length',
+            'require_uppercase' => 'Require Uppercase Letters',
+            'require_numbers' => 'Require Numbers',
+            'require_special' => 'Require Special Characters',
+        ],
+        'account_protection' => [
+            'title' => 'Account Protection',
+            'max_login_attempts' => 'Max Login Attempts',
+            'lockout_duration' => 'Lockout Duration (minutes)',
+        ],
+        'session' => [
+            'title' => 'Session and Authentication',
+            'timeout' => 'Session Timeout (minutes)',
+            'force_https' => 'Force HTTPS',
+            'enable_2fa' => 'Enable 2FA',
+            'require_email_verification' => 'Require Email Verification',
+        ],
+    ],
+];
diff --git a/app/Modules/Admin/Resources/lang/es/settings.php b/app/Modules/Admin/Resources/lang/es/settings.php
new file mode 100644
index 0000000..c30488a
--- /dev/null
+++ b/app/Modules/Admin/Resources/lang/es/settings.php
@@ -0,0 +1,96 @@
+<?php
+
+return [
+    'localization' => [
+        'title' => 'Configuración de localización',
+        'description' => 'Configura las preferencias de idioma, hora y moneda',
+        'default_locale' => [
+            'label' => 'Idioma predeterminado',
+            'help'  => 'El idioma predeterminado de la aplicación.',
+        ],
+        'fallback_locale' => [
+            'label' => 'Idioma de respaldo',
+            'help'  => 'Idioma utilizado cuando falta una traducción.',
+        ],
+        'timezone' => [
+            'label' => 'Zona horaria',
+            'help'  => 'Configuración de la zona horaria a nivel del sistema.',
+        ],
+        'date_format' => [
+            'label' => 'Formato de fecha',
+            'help'  => 'Formato de visualización para las fechas.',
+        ],
+        'time_format' => [
+            'label' => 'Formato de hora',
+            'help'  => 'Formato de visualización para las horas.',
+        ],
+    ],
+
+    'advanced' => [
+        'title' => 'Configuración avanzada',
+        'description' => 'Configura las opciones avanzadas',
+        'under_construction' => 'Esta sección está en construcción.',
+    ],
+
+    'maintenance' => [
+        'title' => 'Configuración de mantenimiento',
+        'description' => 'Configura el modo de mantenimiento y los ajustes de acceso',
+        'enabled' => 'Habilitar modo de mantenimiento',
+        'message' => [
+            'label' => 'Mensaje de mantenimiento',
+            'help'  => 'Este mensaje se mostrará a los usuarios cuando el modo de mantenimiento esté activo.',
+        ],
+    ],
+
+    'email' => [
+        'title' => 'Configuración de correo electrónico',
+        'description' => 'Configura los ajustes SMTP para el envío de correos.',
+        'smtp_host' => [
+            'label' => 'Servidor SMTP',
+            'help'  => 'Nombre de host o dirección IP del servidor SMTP.',
+        ],
+        'smtp_port' => [
+            'label' => 'Puerto SMTP',
+            'help'  => 'Número de puerto del servidor SMTP.',
+        ],
+        'smtp_username' => 'Usuario SMTP',
+        'smtp_password' => 'Contraseña SMTP',
+        'smtp_encryption' => 'Cifrado',
+        'mail_from_name' => 'Nombre del remitente',
+        'send_test' => 'Enviar correo de prueba',
+    ],
+
+    'general' => [
+        'title' => 'Configuración general',
+        'description' => 'Configura la información básica y los ajustes del sitio',
+        'site_name' => 'Nombre del sitio',
+        'site_url' => 'URL del sitio',
+        'site_description' => 'Descripción del sitio',
+        'admin_email' => 'Correo del administrador',
+        'allow_registration' => 'Permitir el registro de nuevos usuarios',
+    ],
+
+    'security' => [
+        'title' => 'Configuración de seguridad',
+        'description' => 'Configura la autenticación, las políticas de contraseñas y la protección de cuentas',
+        'password_policies' => [
+            'title' => 'Políticas de contraseñas',
+            'min_length' => 'Longitud mínima de la contraseña',
+            'require_uppercase' => 'Requerir letras mayúsculas',
+            'require_numbers' => 'Requerir números',
+            'require_special' => 'Requerir caracteres especiales',
+        ],
+        'account_protection' => [
+            'title' => 'Protección de la cuenta',
+            'max_login_attempts' => 'Máximo de intentos de inicio de sesión',
+            'lockout_duration' => 'Duración del bloqueo (minutos)',
+        ],
+        'session' => [
+            'title' => 'Sesión y autenticación',
+            'timeout' => 'Tiempo de espera de la sesión (minutos)',
+            'force_https' => 'Forzar HTTPS',
+            'enable_2fa' => 'Habilitar 2FA',
+            'require_email_verification' => 'Requerir verificación de correo electrónico',
+        ],
+    ],
+];
diff --git a/app/Modules/Admin/Resources/views/settings/advanced.blade.php b/app/Modules/Admin/Resources/views/settings/advanced.blade.php
index d5c9ac5..560434e 100644
--- a/app/Modules/Admin/Resources/views/settings/advanced.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/advanced.blade.php
@@ -3,11 +3,11 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">{{ __('Advanced Settings') }}</h2>
-        <p class="text-sm text-gray-600 mt-1">{{ __('Configure advanced settings') }}</p>
+        <h2 class="text-xl font-bold text-gray-800">{{ __('admin::settings.advanced.title') }}</h2>
+        <p class="text-sm text-gray-600 mt-1">{{ __('admin::settings.advanced.description') }}</p>
     </div>
     <div class="p-6">
-        <p class="text-gray-500 italic">{{ __('This section is under construction.') }}</p>
+        <p class="text-gray-500 italic">{{ __('admin::settings.advanced.under_construction') }}</p>
     </div>
 </div>
 @endsection
diff --git a/app/Modules/Admin/Resources/views/settings/email.blade.php b/app/Modules/Admin/Resources/views/settings/email.blade.php
index 7995118..e378951 100644
--- a/app/Modules/Admin/Resources/views/settings/email.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/email.blade.php
@@ -3,33 +3,33 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">{{ __('Email Settings') }}</h2> 
-        <p class="text-sm text-gray-600 mt-1">{{ __('Configure SMTP settings for outgoing emails') }}</p>
+        <h2 class="text-xl font-bold text-gray-800">{{ __('admin::settings.email.title') }}</h2> 
+        <p class="text-sm text-gray-600 mt-1">{{ __('admin::settings.email.description') }}</p> 
     </div>
     <div class="p-6 space-y-4">
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('SMTP Host') }}</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.email.smtp_host.label') }}</label>
                 <input type="text" name="smtp_host" value="{{ $settings['smtp_host'] ?? '' }}" placeholder="smtp.example.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('SMTP Port') }}</label>
-                <input type="number" name="smtp_port" value="{{ $settings['smtp_port'] ?? '587' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.email.smtp_port.label') }}</label>
+                <input type="number" name="smtp_port" value="{{ $settings['smtp_port'] ?? '589' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
         </div>
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('SMTP Username') }}</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.email.smtp_username') }}</label>
                 <input type="text" name="smtp_username" value="{{ $settings['smtp_username'] ?? '' }}" placeholder="noreply@nexuscms.com" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('SMTP Password') }}</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.email.smtp_password') }}</label>
                 <input type="password" name="smtp_password" value="{{ $settings['smtp_password'] ?? '' }}" placeholder="••••••••" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
         </div>
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Encryption') }}</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.email.smtp_encryption') }}</label>
                 <select name="smtp_encryption" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="tls" {{ ($settings['smtp_encryption'] ?? '') == 'tls' ? 'selected' : '' }}>TLS</option>
                     <option value="ssl" {{ ($settings['smtp_encryption'] ?? '') == 'ssl' ? 'selected' : '' }}>SSL</option>
@@ -37,13 +37,13 @@
                 </select>
             </div>
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('From Name') }}</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.email.mail_from_name') }}</label>
                 <input type="text" name="mail_from_name" value="{{ $settings['mail_from_name'] ?? 'NexusCMS' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
         </div>
         <div>
             <button type="button" class="px-4 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300 font-medium">
-                <i class="fas fa-paper-plane mr-2"></i>{{ __('Send Test Email') }}
+                <i class="fas fa-paper-plane mr-2"></i>{{ __('admin::settings.email.send_test') }}
             </button>
         </div>
     </div>
diff --git a/app/Modules/Admin/Resources/views/settings/general.blade.php b/app/Modules/Admin/Resources/views/settings/general.blade.php
index d0810d2..1c6482a 100644
--- a/app/Modules/Admin/Resources/views/settings/general.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/general.blade.php
@@ -3,31 +3,31 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">{{ __('General Settings') }}</h2>
-        <p class="text-sm text-gray-600 mt-1">{{ __('Configure basic site information and settings') }}</p>
+        <h2 class="text-xl font-bold text-gray-800">{{ __('admin::settings.general.title') }}</h2>
+        <p class="text-sm text-gray-600 mt-1">{{ __('admin::settings.general.description') }}</p>
     </div>
     <div class="p-6 space-y-4">
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Site Name') }}</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.general.site_name') }}</label>
                 <input type="text" name="site_name" value="{{ $settings['site_name'] ?? 'NexusCMS' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Site URL') }}</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.general.site_url') }}</label>
                 <input type="text" name="site_url" value="{{ $settings['site_url'] ?? 'https://nexuscms.example.com' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
         </div>
         <div>
-            <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Site Description') }}</label>
+            <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.general.site_description') }}</label>
             <textarea name="site_description" rows="3" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">{{ $settings['site_description'] ?? __('The ultimate World of Warcraft private server experience with custom content and balanced gameplay.') }}</textarea>
         </div>
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Admin Email') }}</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.general.admin_email') }}</label>
                 <input type="email" name="admin_email" value="{{ $settings['admin_email'] ?? 'admin@nexuscms.com' }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
             </div>
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Timezone') }}</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.localization.timezone.label') }}</label>
                 <select name="timezone" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="UTC" {{ ($settings['timezone'] ?? '') == 'UTC' ? 'selected' : '' }}>UTC</option>
                     <option value="Europe/Madrid" {{ ($settings['timezone'] ?? '') == 'Europe/Madrid' ? 'selected' : '' }}>Europe/Madrid</option>
@@ -38,7 +38,7 @@
         </div>
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Date Format') }}</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.localization.date_format.label') }}</label>
                 <select name="date_format" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="Y-m-d" {{ ($settings['date_format'] ?? '') == 'Y-m-d' ? 'selected' : '' }}>Y-m-d (2024-01-29)</option>
                     <option value="d/m/Y" {{ ($settings['date_format'] ?? '') == 'd/m/Y' ? 'selected' : '' }}>d/m/Y (29/01/2024)</option>
@@ -46,7 +46,7 @@
                 </select>
             </div>
             <div>
-                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Time Format') }}</label>
+                <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.localization.time_format.label') }}</label>
                 <select name="time_format" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="H:i" {{ ($settings['time_format'] ?? '') == 'H:i' ? 'selected' : '' }}>24-hour (14:30)</option>
                     <option value="h:i A" {{ ($settings['time_format'] ?? '') == 'h:i A' ? 'selected' : '' }}>12-hour (2:30 PM)</option>
@@ -56,7 +56,7 @@
         <div class="flex items-center gap-2">
             <input type="hidden" name="allow_registration" value="0">
             <input type="checkbox" name="allow_registration" value="1" id="registration" {{ ($settings['allow_registration'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-            <label for="registration" class="text-sm text-gray-700">{{ __('Allow new user registrations') }}</label>
+            <label for="registration" class="text-sm text-gray-700">{{ __('admin::settings.general.allow_registration') }}</label>
         </div>
     </div>
 </div>
diff --git a/app/Modules/Admin/Resources/views/settings/maintenance.blade.php b/app/Modules/Admin/Resources/views/settings/maintenance.blade.php
index f88c28f..5b8d5f5 100644
--- a/app/Modules/Admin/Resources/views/settings/maintenance.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/maintenance.blade.php
@@ -3,19 +3,19 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">{{ __('Maintenance Settings') }}</h2>
-        <p class="text-sm text-gray-600 mt-1">{{ __('Configure maintenance mode and access settings') }}</p>
+        <h2 class="text-xl font-bold text-gray-800">{{ __('admin::settings.maintenance.title') }}</h2>
+        <p class="text-sm text-gray-600 mt-1">{{ __('admin::settings.maintenance.description') }}</p>
     </div>
     <div class="p-6 space-y-6">
         <div class="flex items-center gap-2">
             <input type="hidden" name="maintenance_mode" value="0">
             <input type="checkbox" name="maintenance_mode" value="1" id="maintenance_mode" {{ ($settings['maintenance_mode'] ?? '0') == '1' ? 'checked' : '' }} class="rounded border-gray-300 text-blue-600 focus:ring-blue-500">
-            <label for="maintenance_mode" class="text-sm font-medium text-gray-700">{{ __('Enable Maintenance Mode') }}</label>
+            <label for="maintenance_mode" class="text-sm font-medium text-gray-700">{{ __('admin::settings.maintenance.enabled') }}</label>
         </div>
         <div>
-            <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Maintenance Message') }}</label>
+            <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.maintenance.message.label') }}</label>
             <textarea name="maintenance_message" rows="4" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">{{ $settings['maintenance_message'] ?? __('We are currently performing scheduled maintenance. We will be back shortly.') }}</textarea>
-            <p class="text-xs text-gray-500 mt-1">{{ __('This message will be displayed to users when maintenance mode is active.') }}</p>
+            <p class="text-xs text-gray-500 mt-1">{{ __('admin::settings.maintenance.message.help') }}</p>
         </div>
     </div>
 </div>
diff --git a/app/Modules/Admin/Resources/views/settings/security.blade.php b/app/Modules/Admin/Resources/views/settings/security.blade.php
index 45fd49b..6ac6d34 100644
--- a/app/Modules/Admin/Resources/views/settings/security.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/security.blade.php
@@ -3,15 +3,15 @@
 @section('settings_content')
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">{{ __('Security Settings') }}</h2>
-        <p class="text-sm text-gray-600 mt-1">{{ __('Configure authentication, password policies, and account protection settings') }}</p>
+        <h2 class="text-xl font-bold text-gray-800">{{ __('admin::settings.security.title') }}</h2>
+        <p class="text-sm text-gray-600 mt-1">{{ __('admin::settings.security.description') }}</p>
     </div>
     <div class="p-6 space-y-8">
         <div>
-            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">{{ __('Password Policies') }}</h3>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">{{ __('admin::settings.security.password_policies.title') }}</h3>
             <div class="grid md:grid-cols-2 gap-4">
                 <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Minimum Password Length') }}</label>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.security.password_policies.min_length') }}</label>
                     <select name="password_min_length" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                         @php $min = (int)($settings['password_min_length'] ?? 12); @endphp
                         <option value="8" {{ $min === 8 ? 'selected' : '' }}>8</option>
@@ -25,58 +25,58 @@
                     <div class="flex items-center gap-2">
                         <input type="hidden" name="password_require_uppercase" value="0">
                         <input type="checkbox" name="password_require_uppercase" value="1" id="password_uppercase" {{ ($settings['password_require_uppercase'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-                        <label for="password_uppercase" class="text-sm text-gray-700">{{ __('Require Uppercase Letters') }}</label>
+                        <label for="password_uppercase" class="text-sm text-gray-700">{{ __('admin::settings.security.password_policies.require_uppercase') }}</label>
                     </div>
                     <div class="flex items-center gap-2">
                         <input type="hidden" name="password_require_numbers" value="0">
                         <input type="checkbox" name="password_require_numbers" value="1" id="password_numbers" {{ ($settings['password_require_numbers'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-                        <label for="password_numbers" class="text-sm text-gray-700">{{ __('Require Numbers') }}</label>
+                        <label for="password_numbers" class="text-sm text-gray-700">{{ __('admin::settings.security.password_policies.require_numbers') }}</label>
                     </div>
                     <div class="flex items-center gap-2">
                         <input type="hidden" name="password_require_special" value="0">
                         <input type="checkbox" name="password_require_special" value="1" id="password_special" {{ ($settings['password_require_special'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-                        <label for="password_special" class="text-sm text-gray-700">{{ __('Require Special Characters') }}</label>
+                        <label for="password_special" class="text-sm text-gray-700">{{ __('admin::settings.security.password_policies.require_special') }}</label>
                     </div>
                 </div>
             </div>
         </div>
 
         <div>
-            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">{{ __('Account Protection') }}</h3>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">{{ __('admin::settings.security.account_protection.title') }}</h3>
             <div class="grid md:grid-cols-2 gap-4">
                 <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Max Login Attempts') }}</label>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.security.account_protection.max_login_attempts') }}</label>
                     <input type="number" min="1" max="20" name="max_login_attempts" value="{{ $settings['max_login_attempts'] ?? 5 }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                 </div>
                 <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Lockout Duration (minutes)') }}</label>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.security.account_protection.lockout_duration') }}</label>
                     <input type="number" min="1" max="240" name="lockout_duration_minutes" value="{{ $settings['lockout_duration_minutes'] ?? 15 }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                 </div>
             </div>
         </div>
 
         <div>
-            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">{{ __('Session and Authentication') }}</h3>
+            <h3 class="text-lg font-medium text-gray-900 mb-4 border-b pb-2">{{ __('admin::settings.security.session.title') }}</h3>
             <div class="grid md:grid-cols-2 gap-4">
                 <div>
-                    <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Session Timeout (minutes)') }}</label>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.security.session.timeout') }}</label>
                     <input type="number" min="5" max="720" name="session_timeout_minutes" value="{{ $settings['session_timeout_minutes'] ?? 30 }}" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                 </div>
                 <div class="space-y-3">
                     <div class="flex items-center gap-2">
                         <input type="hidden" name="force_https" value="0">
                         <input type="checkbox" name="force_https" value="1" id="force_https" {{ ($settings['force_https'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-                        <label for="force_https" class="text-sm text-gray-700">{{ __('Force HTTPS') }}</label>
+                        <label for="force_https" class="text-sm text-gray-700">{{ __('admin::settings.security.session.force_https') }}</label>
                     </div>
                     <div class="flex items-center gap-2">
                         <input type="hidden" name="enable_2fa" value="0">
                         <input type="checkbox" disabled name="enable_2fa" value="1" id="enable_2fa" {{ ($settings['enable_2fa'] ?? '0') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-                        <label for="enable_2fa" class="text-sm text-gray-700">{{ __('Enable 2FA') }}</label>
+                        <label for="enable_2fa" class="text-sm text-gray-700">{{ __('admin::settings.security.session.enable_2fa') }}</label>
                     </div>
                     <div class="flex items-center gap-2">
                         <input type="hidden" name="require_email_verification" value="0">
                         <input type="checkbox" disabled name="require_email_verification" value="1" id="require_email_verification" {{ ($settings['require_email_verification'] ?? '1') == '1' ? 'checked' : '' }} class="rounded border-gray-300">
-                        <label for="require_email_verification" class="text-sm text-gray-700">{{ __('Require Email Verification') }}</label>
+                        <label for="require_email_verification" class="text-sm text-gray-700">{{ __('admin::settings.security.session.require_email_verification') }}</label>
                     </div>
                 </div>
             </div>
diff --git a/app/Providers/BaseModuleServiceProvider.php b/app/Providers/BaseModuleServiceProvider.php
index 148bcd3..3fdeb60 100644
--- a/app/Providers/BaseModuleServiceProvider.php
+++ b/app/Providers/BaseModuleServiceProvider.php
@@ -79,8 +79,12 @@ private function loadViews(): void
     private function loadTranslations(): void
     {
         $path = $this->modulePath . '/Resources/lang';
+
         if (is_dir($path)) {
-            $this->loadJsonTranslationsFrom($path, strtolower($this->moduleName));
+            $this->loadTranslationsFrom(
+                $path,
+                strtolower($this->moduleName)
+            );
         }
     }
 }

From 564f83fb0c4f402357ad4cada083b25628b3e55f Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 7 Feb 2026 04:56:43 +0100
Subject: [PATCH 074/132] chore: remove unused admin translation files

The English (en.json) and Spanish (es.json) translation files for the Admin module have been deleted as they are no longer used by the application, likely due to a change in the localization strategy or module structure.
---
 app/Modules/Admin/Resources/lang/en.json | 55 -----------------------
 app/Modules/Admin/Resources/lang/es.json | 57 ------------------------
 2 files changed, 112 deletions(-)
 delete mode 100644 app/Modules/Admin/Resources/lang/en.json
 delete mode 100644 app/Modules/Admin/Resources/lang/es.json

diff --git a/app/Modules/Admin/Resources/lang/en.json b/app/Modules/Admin/Resources/lang/en.json
deleted file mode 100644
index dcf36e7..0000000
--- a/app/Modules/Admin/Resources/lang/en.json
+++ /dev/null
@@ -1,55 +0,0 @@
-{
-  "Localization Settings": "Localization Settings",
-  "Configure language, time, and currency preferences": "Configure language, time, and currency preferences",
-  "Default Locale": "Default Locale",
-  "The default language for the application.": "The default language for the application.",
-  "Fallback Locale": "Fallback Locale",
-  "Language used when a translation is missing.": "Language used when a translation is missing.",
-  "Timezone": "Timezone",
-  "System-wide timezone setting.": "System-wide timezone setting.",
-  "Date Format": "Date Format",
-  "Display format for dates.": "Display format for dates.",
-  "Time Format": "Time Format",
-  "Display format for times.": "Display format for times.",
-  "Advanced Settings": "Advanced Settings",
-  "Configure advanced settings": "Configure advanced settings",
-  "This section is under construction.": "This section is under construction.",
-  "Maintenance Settings": "Maintenance Settings",
-  "Configure maintenance mode and access settings": "Configure maintenance mode and access settings",
-  "Enable Maintenance Mode": "Enable Maintenance Mode",
-  "Maintenance Message": "Maintenance Message",
-  "This message will be displayed to users when maintenance mode is active.": "This message will be displayed to users when maintenance mode is active.",
-  "Email Settings": "Email Settings",
-  "Configure SMTP settings for outgoing emails.": "Configure SMTP settings for outgoing emails.",
-  "SMTP Host": "SMTP Host",
-  "Hostname or IP address of the SMTP server.": "Hostname or IP address of the SMTP server.",
-  "SMTP Port": "SMTP Port",
-  "Port number for the SMTP server.": "Port number for the SMTP server.",
-  "SMTP Username": "SMTP Username",
-  "SMTP Password": "SMTP Password",
-  "Encryption": "Encryption",
-  "From Name": "From Name",
-  "Send Test Email": "Send Test Email",
-  "General Settings": "General Settings",
-  "Configure basic site information and settings": "Configure basic site information and settings.",
-  "Site Name": "Site Name",
-  "Site URL": "Site URL",
-  "Site Description": "Site Description",
-  "Admin Email": "Admin Email",
-  "Allow new user registrations": "Allow new user registrations",
-  "Security Settings": "Security Settings",
-  "Configure authentication, password policies, and account protection settings": "Configure authentication, password policies, and account protection settings.",
-  "Password Policies": "Password Policies",
-  "Minimum Password Length": "Minimum Password Length",
-  "Require Uppercase Letters": "Require Uppercase Letters",
-  "Require Numbers": "Require Numbers",
-  "Require Special Characters": "Require Special Characters",
-  "Account Protection": "Account Protection",
-  "Max Login Attempts": "Max Login Attempts",
-  "Lockout Duration (minutes)": "Lockout Duration (minutes)",
-  "Session and Authentication": "Session and Authentication",
-  "Session Timeout (minutes)": "Session Timeout (minutes)",
-  "Force HTTPS": "Force HTTPS",
-  "Enable 2FA": "Enable 2FA",
-  "Require Email Verification": "Require Email Verification"
-}
diff --git a/app/Modules/Admin/Resources/lang/es.json b/app/Modules/Admin/Resources/lang/es.json
deleted file mode 100644
index 413b1af..0000000
--- a/app/Modules/Admin/Resources/lang/es.json
+++ /dev/null
@@ -1,57 +0,0 @@
-{
-  "Localization Settings": "Configuración de Localización",
-  "Configure language, time, and currency preferences": "Configura preferencias de idioma, hora y moneda",
-  "Default Locale": "Idioma por defecto",
-  "The default language for the application.": "El idioma por defecto de la aplicación.",
-  "Fallback Locale": "Idioma de respaldo",
-  "Language used when a translation is missing.": "Idioma usado cuando falta una traducción.",
-  "Available Locales": "Idiomas disponibles",
-  "Comma-separated list of enabled locales.": "Lista de idiomas habilitados separada por comas.",
-  "Timezone": "Zona horaria",
-  "System-wide timezone setting.": "Ajuste de zona horaria del sistema.",
-  "Date Format": "Formato de fecha",
-  "Display format for dates.": "Formato de visualización para fechas.",
-  "Time Format": "Formato de hora",
-  "Display format for times.": "Formato de visualización para horas.",
-  "Advanced Settings": "Configuración Avanzada",
-  "Configure advanced settings": "Configura ajustes avanzados",
-  "This section is under construction.": "Esta sección está en construcción.",
-  "Maintenance Settings": "Configuración de Mantenimiento",
-  "Configure maintenance mode and access settings": "Configura el modo de mantenimiento y los ajustes de acceso",
-  "Enable Maintenance Mode": "Habilitar Modo de Mantenimiento",
-  "Maintenance Message": "Mensaje de Mantenimiento",
-  "This message will be displayed to users when maintenance mode is active.": "Este mensaje se mostrará a los usuarios cuando el modo de mantenimiento esté activo.",
-  "Email Settings": "Configuración de Correo",
-  "Configure SMTP settings for outgoing emails.": "Configura los ajustes de correo para el envío de correos.",
-  "SMTP Host": "Host SMTP",
-  "Hostname or IP address of the SMTP server.": "Nombre de host o dirección IP del servidor SMTP.",
-  "SMTP Port": "Puerto SMTP",
-  "Port number for the SMTP server.": "Número de puerto para el servidor SMTP.",
-  "SMTP Username": "Nombre de usuario SMTP",
-  "SMTP Password": "Contraseña SMTP",
-  "Encryption": "Encriptación",
-  "From Name": "Nombre de Origen",
-  "Send Test Email": "Enviar Correo de Prueba",
-  "General Settings": "Configuración General",
-  "Configure basic site information and settings": "Configura la información básica del sitio y los ajustes.",
-  "Site Name": "Nombre del Sitio",
-  "Site URL": "URL del Sitio",
-  "Site Description": "Descripción del Sitio",
-  "Admin Email": "Correo Electrónico del Administrador",
-  "Allow new user registrations": "Permitir registros de nuevos usuarios",
-  "Security Settings": "Configuración de Seguridad",
-  "Configure authentication, password policies, and account protection settings": "Configura la autenticación, políticas de contraseña y protección de cuenta.",
-  "Password Policies": "Políticas de Contraseña",
-  "Minimum Password Length": "Longitud Mínima de Contraseña",   
-  "Require Uppercase Letters": "Requerir Letras Mayúsculas",
-  "Require Numbers": "Requerir Números",
-  "Require Special Characters": "Requerir Caracteres Especiales",
-  "Account Protection": "Protección de Cuenta",
-  "Max Login Attempts": "Máximo de Intentos de Inicio de Sesión",
-  "Lockout Duration (minutes)": "Duración de Bloqueo (minutos)",
-  "Session and Authentication": "Configuración de Sesión y Autenticación",  
-  "Session Timeout (minutes)": "Timeout de Sesión (minutos)",
-  "Force HTTPS": "Forzar HTTPS",
-  "Enable 2FA": "Habilitar 2FA",
-  "Require Email Verification": "Requerir Verificación de Correo Electrónico"
-}
\ No newline at end of file

From 97314db582cccdbf493804b02a74b9da8d196b27 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 7 Feb 2026 13:43:55 +0100
Subject: [PATCH 075/132] feat(admin): add localization support for settings
 menu items

---
 .../Admin/Resources/lang/en/settings.php      | 13 ++++++
 .../Admin/Resources/lang/es/settings.php      | 13 ++++++
 .../views/settings/extends/menu.blade.php     | 21 +++++-----
 app/Providers/BaseModuleServiceProvider.php   | 41 +++++++++++++++++++
 4 files changed, 78 insertions(+), 10 deletions(-)

diff --git a/app/Modules/Admin/Resources/lang/en/settings.php b/app/Modules/Admin/Resources/lang/en/settings.php
index 5f299d3..8e0d541 100644
--- a/app/Modules/Admin/Resources/lang/en/settings.php
+++ b/app/Modules/Admin/Resources/lang/en/settings.php
@@ -1,6 +1,19 @@
 <?php
 
 return [
+    'menu' => [
+        'general' => 'General',
+        'email' => 'Email',
+        'payment' => 'Payment',
+        'security' => 'Security',
+        'appearance' => 'Appearance',
+        'seo' => 'SEO',
+        'api' => 'API',
+        'maintenance' => 'Maintenance',
+        'localization' => 'Localization',
+        'advanced' => 'Advanced',
+    ],
+
     'localization' => [
         'title' => 'Localization Settings',
         'description' => 'Configure language, time, and currency preferences',
diff --git a/app/Modules/Admin/Resources/lang/es/settings.php b/app/Modules/Admin/Resources/lang/es/settings.php
index c30488a..bb1574b 100644
--- a/app/Modules/Admin/Resources/lang/es/settings.php
+++ b/app/Modules/Admin/Resources/lang/es/settings.php
@@ -1,6 +1,19 @@
 <?php
 
 return [
+    'menu' => [
+        'general' => 'General',
+        'email' => 'Email',
+        'payment' => 'Pago',
+        'security' => 'Seguridad',
+        'appearance' => 'Apariencia',
+        'seo' => 'SEO',
+        'api' => 'API',
+        'maintenance' => 'Mantenimiento',
+        'localization' => 'Localización',
+        'advanced' => 'Avanzado',
+    ],
+
     'localization' => [
         'title' => 'Configuración de localización',
         'description' => 'Configura las preferencias de idioma, hora y moneda',
diff --git a/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php b/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
index b957ed9..426a9f7 100644
--- a/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
@@ -5,16 +5,17 @@
             @php
                 $currentView = request('view', 'general');
                 $menuItems = [
-                    'general' => ['icon' => 'globe', 'label' => 'General'],
-                    'email' => ['icon' => 'envelope', 'label' => 'Email'],
-                    'payment' => ['icon' => 'credit-card', 'label' => 'Payment'],
-                    'security' => ['icon' => 'shield-alt', 'label' => 'Security'],
-                    'appearance' => ['icon' => 'palette', 'label' => 'Appearance'],
-                    'seo' => ['icon' => 'search', 'label' => 'SEO'],
-                    'api' => ['icon' => 'code', 'label' => 'API'],
-                    'maintenance' => ['icon' => 'tools', 'label' => 'Maintenance'],
-                    'localization' => ['icon' => 'language', 'label' => 'Localization'],
-                    'advanced' => ['icon' => 'cogs', 'label' => 'Advanced'],
+                    'general' => ['icon' => 'globe', 'label' => __('admin::settings.menu.general')],
+                    'email' => ['icon' => 'envelope', 'label' => __('admin::settings.menu.email')],
+                    'payment' => ['icon' => 'credit-card', 'label' => __('admin::settings.menu.payment')],
+                    'security' => ['icon' => 'shield-alt', 'label' => __('admin::settings.menu.security')],  
+                    'appearance' => ['icon' => 'palette', 'label' => __('admin::settings.menu.appearance')],
+                    'seo' => ['icon' => 'search', 'label' => __('admin::settings.menu.seo')],  
+                    'api' => ['icon' => 'code', 'label' => __('admin::settings.menu.api')],
+                    'maintenance' => ['icon' => 'tools', 'label' => __('admin::settings.menu.maintenance')],        
+                    'maintenance' => ['icon' => 'tools', 'label' => __('admin::settings.menu.maintenance')],        
+                    'localization' => ['icon' => 'language', 'label' => __('admin::settings.menu.localization')],
+                    'advanced' => ['icon' => 'cogs', 'label' => __('admin::settings.menu.advanced')],
                 ];
             @endphp
 
diff --git a/app/Providers/BaseModuleServiceProvider.php b/app/Providers/BaseModuleServiceProvider.php
index 3fdeb60..612f82e 100644
--- a/app/Providers/BaseModuleServiceProvider.php
+++ b/app/Providers/BaseModuleServiceProvider.php
@@ -21,27 +21,48 @@ public function boot(): void
         $this->modulePath = base_path("app/Modules/{$this->moduleName}");
         $this->loadModuleConfig();
 
+        /**
+         * Check if the module is enabled.
+         * If not, skip loading any resources.
+         */
         if (!($this->config['enabled'] ?? true)) {
             return;
         }
 
+        /**
+         * Load module routes if enabled.
+         */
         if ($this->config['routes'] ?? false) {
             $this->loadRoutes();
         }
 
+        /**
+         * Load module migrations if enabled.
+         */
         if ($this->config['migrations'] ?? false) {
             $this->loadMigrations();
         }
 
+        /**
+         * Load module views if enabled.
+         */
         if ($this->config['views'] ?? false) {
             $this->loadViews();
         }
 
+        /**
+         * Load module translations if enabled.
+         */
         if ($this->config['translations'] ?? false) {
             $this->loadTranslations();
         }
     }
 
+    /**
+     * Load module configuration from the module.json file.
+     * 
+     * @return void
+     */
     private function loadModuleConfig(): void
     {
         $configFile = $this->modulePath . '/module.json';
@@ -50,6 +71,11 @@ private function loadModuleConfig(): void
         }
     }
 
+    /**
+     * Load routes from the module's Http/routes.php file.
+     * 
+     * @return void
+     */
     private function loadRoutes(): void
     {
         $routesPath = $this->modulePath . '/Http/routes.php';
@@ -60,6 +86,11 @@ private function loadRoutes(): void
         }
     }
 
+    /**
+     * Load migrations from the module's Infrastructure/Database/migrations directory.
+     * 
+     * @return void
+     */
     private function loadMigrations(): void
     {
         $path = $this->modulePath . '/Infrastructure/Database/migrations';
@@ -68,6 +99,11 @@ private function loadMigrations(): void
         }
     }
 
+    /**
+     * Load views from the module's resources/views directory.
+     * 
+     * @return void
+     */
     private function loadViews(): void
     {
         $path = $this->modulePath . '/Resources/views';
@@ -76,6 +112,11 @@ private function loadViews(): void
         }
     }
 
+    /**
+     * Load translations from the module's lang directory.
+     * 
+     * @return void
+     */
     private function loadTranslations(): void
     {
         $path = $this->modulePath . '/Resources/lang';

From 397bdf0165b93ff6ca354475e287970d1619259b Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 8 Feb 2026 15:28:11 +0100
Subject: [PATCH 076/132] feat(auth): replace role-based with permission-based
 middleware

- Add new ModulePermission middleware for granular permission checks
- Update routes to use permission middleware instead of role-based checks
- Add permission checks to admin panel navigation and settings menu
- Remove forum-related routes and links from main layout
- Restructure admin routes with specific permission requirements
---
 app/Http/Middleware/ModulePermission.php      | 19 ++++++++++
 app/Modules/Admin/Http/routes.php             | 34 ++++++++---------
 .../Resources/views/layouts/app.blade.php     | 38 +++++++++++++++++++
 .../views/settings/extends/menu.blade.php     |  4 +-
 bootstrap/app.php                             |  1 +
 resources/views/layouts/main.blade.php        |  2 -
 routes/web.php                                | 20 ++--------
 7 files changed, 82 insertions(+), 36 deletions(-)
 create mode 100644 app/Http/Middleware/ModulePermission.php

diff --git a/app/Http/Middleware/ModulePermission.php b/app/Http/Middleware/ModulePermission.php
new file mode 100644
index 0000000..a70ff65
--- /dev/null
+++ b/app/Http/Middleware/ModulePermission.php
@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class ModulePermission
+{
+    public function handle(Request $request, Closure $next, string $permission): Response
+    {
+        if (! $request->user()?->can($permission)) {
+            abort(403);
+        }
+
+        return $next($request);
+    }
+}
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index 8ef1901..bab56df 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -3,29 +3,29 @@
 use Illuminate\Support\Facades\Route;
 
 
-Route::middleware(['auth', 'role:Admin', 'web'])
+Route::middleware(['auth', 'permission:access.admin.panel', 'web'])
     ->prefix(strtolower('acp'))
     ->group(function () {
-        Route::get('/', [\Modules\Admin\Http\Controllers\AdminController::class, 'index'])->name('admin.index');
-        Route::get('/permissions', [\Modules\Admin\Http\Controllers\PermissionController::class, 'index'])->name('admin.permissions');
+        Route::get('/', [\Modules\Admin\Http\Controllers\AdminController::class, 'index'])->middleware('permission:access.admin.panel')->name('admin.index');
+        Route::get('/permissions', [\Modules\Admin\Http\Controllers\PermissionController::class, 'index'])->middleware('permission:manage.permissions')->name('admin.permissions');
         
         // Roles
-        Route::get('/roles', [\Modules\Admin\Http\Controllers\RoleController::class, 'index'])->name('admin.roles.index');
-        Route::get('/roles/create', [\Modules\Admin\Http\Controllers\RoleController::class, 'create'])->name('admin.roles.create');
-        Route::post('/roles', [\Modules\Admin\Http\Controllers\RoleController::class, 'store'])->name('admin.roles.store');
-        Route::get('/roles/{role}/edit', [\Modules\Admin\Http\Controllers\RoleController::class, 'edit'])->name('admin.roles.edit');
-        Route::put('/roles/{role}', [\Modules\Admin\Http\Controllers\RoleController::class, 'update'])->name('admin.roles.update');
-        Route::delete('/roles/{role}', [\Modules\Admin\Http\Controllers\RoleController::class, 'destroy'])->name('admin.roles.destroy');
+        Route::get('/roles', [\Modules\Admin\Http\Controllers\RoleController::class, 'index'])->middleware('permission:manage.roles')->name('admin.roles.index');
+        Route::get('/roles/create', [\Modules\Admin\Http\Controllers\RoleController::class, 'create'])->middleware('permission:manage.roles')->name('admin.roles.create');
+        Route::post('/roles', [\Modules\Admin\Http\Controllers\RoleController::class, 'store'])->middleware('permission:manage.roles')->name('admin.roles.store');
+        Route::get('/roles/{role}/edit', [\Modules\Admin\Http\Controllers\RoleController::class, 'edit'])->middleware('permission:manage.roles')->name('admin.roles.edit');
+        Route::put('/roles/{role}', [\Modules\Admin\Http\Controllers\RoleController::class, 'update'])->middleware('permission:manage.roles')->name('admin.roles.update');
+        Route::delete('/roles/{role}', [\Modules\Admin\Http\Controllers\RoleController::class, 'destroy'])->middleware('permission:manage.roles')->name('admin.roles.destroy');
         
         // Administrative Users
-        Route::get('/users', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'index'])->name('admin.users.index');
-        Route::get('/users/create', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'create'])->name('admin.users.create');
-        Route::post('/users', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'store'])->name('admin.users.store');
-        Route::get('/users/{user}/edit', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'edit'])->name('admin.users.edit');
-        Route::put('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'update'])->name('admin.users.update');
-        Route::delete('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'destroy'])->name('admin.users.destroy');
+        Route::get('/users', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'index'])->middleware('permission:manage.admin.users')->name('admin.users.index');
+        Route::get('/users/create', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'create'])->middleware('permission:manage.admin.users')->name('admin.users.create');
+        Route::post('/users', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'store'])->middleware('permission:manage.admin.users')->name('admin.users.store');
+        Route::get('/users/{user}/edit', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'edit'])->middleware('permission:manage.admin.users')->name('admin.users.edit');
+        Route::put('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'update'])->middleware('permission:manage.admin.users')->name('admin.users.update');
+        Route::delete('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'destroy'])->middleware('permission:manage.admin.users')->name('admin.users.destroy');
     
         // Settings
-        Route::get('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'index'])->name('admin.settings.index');
-        Route::post('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'store'])->name('admin.settings.store');
+        Route::get('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'index'])->middleware('permission:manage.settings')->name('admin.settings.index');
+        Route::post('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'store'])->middleware('permission:manage.settings')->name('admin.settings.store');
     });
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index c816fb8..08dd420 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -48,103 +48,141 @@
             <nav class="flex-1 overflow-y-auto py-4 custom-scrollbar">
                 <div class="px-3 mb-4">
                     <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Main</h3>
+                    @can('access.admin.panel')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 bg-blue-600 rounded-lg mb-1">
                         <i class="fas fa-home w-5"></i>
                         <span>Dashboard</span>
                     </a>
+                    @endcan
+                    @can('access.admin.panel')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-chart-line w-5"></i>
                         <span>Analytics</span>
                     </a>
+                    @endcan
                 </div>
 
                 <div class="px-3 mb-4">
                     <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Management</h3>
+                    @can('manage.admin.users')
                     <a href="{{ route('admin.users.index') }}" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-users w-5"></i>
                         <span>Users</span>
                     </a>
+                    @endcan
+                    @can('manage.characters')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-user-shield w-5"></i>
                         <span>Characters</span>
                     </a>
+                    @endcan
+                    @can('manage.bans')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-ban w-5"></i>
                         <span>Bans</span>
                     </a>
+                    @endcan
+                    @can('manage.reports')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-exclamation-triangle w-5"></i>
                         <span>Reports</span>
                         <span class="ml-auto bg-red-500 text-xs px-2 py-0.5 rounded-full">12</span>
                     </a>
+                    @endcan
                 </div>
 
                 <div class="px-3 mb-4">
                     <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Content</h3>
+                    @can('manage.news')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-newspaper w-5"></i>
                         <span>News</span>
                     </a>
+                    @endcan
+                    @can('manage.pages')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-file-alt w-5"></i>
                         <span>Pages</span>
                     </a>
+                    @endcan
+                    @can('manage.announcements')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-bullhorn w-5"></i>
                         <span>Announcements</span>
                     </a>
+                    @endcan
                 </div>
 
                 <div class="px-3 mb-4">
                     <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Store</h3>
+                    @can('manage.store.products')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-shopping-cart w-5"></i>
                         <span>Products</span>
                     </a>
+                    @endcan
+                    @can('manage.store.categories')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-tags w-5"></i>
                         <span>Categories</span>
                     </a>
+                    @endcan
+                    @can('view.store.transactions')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-receipt w-5"></i>
                         <span>Transactions</span>
                     </a>
+                    @endcan
                 </div>
 
                 <div class="px-3 mb-4">
                     <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Realms</h3>
+                    @can('manage.realms')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-server w-5"></i>
                         <span>Realm Management</span>
                     </a>
+                    @endcan
+                    @can('manage.realms')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-database w-5"></i>
                         <span>Database</span>
                     </a>
+                    @endcan
+                    @can('manage.realms')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-envelope w-5"></i>
                         <span>In-Game Mail</span>
                     </a>
+                    @endcan
                 </div>
 
                 <div class="px-3 mb-4">
                     <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">System</h3>
+                    @can('manage.roles')
                     <a href="{{ route('admin.roles.index') }}" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-user-shield w-5"></i>
                         <span>Roles & Permissions</span>
                     </a>
+                    @endcan
+                    @can('manage.settings')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-cog w-5"></i>
                         <span>Settings</span>
                     </a>
+                    @endcan
+                    @can('view.logs')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-terminal w-5"></i>
                         <span>Logs</span>
                     </a>
+                    @endcan
+                    @can('manage.backups')
                     <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-download w-5"></i>
                         <span>Backups</span>
                     </a>
+                    @endcan
                 </div>
             </nav>
 
diff --git a/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php b/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
index 426a9f7..fa5bdd3 100644
--- a/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
@@ -1,6 +1,7 @@
 <div class="flex">
     <!-- Settings Sidebar -->
     <div class="w-64 bg-white border-r border-gray-200 p-4">
+        @can('manage.settings')
         <nav class="space-y-1">
             @php
                 $currentView = request('view', 'general');
@@ -26,5 +27,6 @@ class="flex items-center gap-3 px-3 py-2 rounded-lg {{ $currentView === $key ? '
                 </a>
             @endforeach
         </nav>
+        @endcan
     </div>
-</div>
\ No newline at end of file
+</div>
diff --git a/bootstrap/app.php b/bootstrap/app.php
index c21c1d1..d34f240 100755
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -17,6 +17,7 @@
 
         $middleware->alias([
             'role' => \App\Http\Middleware\CheckRole::class,
+            'permission' => \App\Http\Middleware\ModulePermission::class,
         ]);
     })
     ->withExceptions(function (Exceptions $exceptions) {
diff --git a/resources/views/layouts/main.blade.php b/resources/views/layouts/main.blade.php
index 4edbd99..6f0ef8e 100644
--- a/resources/views/layouts/main.blade.php
+++ b/resources/views/layouts/main.blade.php
@@ -26,7 +26,6 @@
                         <a href="{{ route('home') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">HOME</a>
                         <a href="{{ route('news') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">NEWS</a>
                         <a href="{{ route('howtoplay') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">HOW TO PLAY</a>
-                        <!-- <a href="{{ route('forums') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">FORUMS</a> -->
                         <a href="{{ route('armory') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">ARMORY</a>
                         <a href="{{ route('donate') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">DONATE</a>
                     </div>
@@ -109,7 +108,6 @@
                     <ul class="space-y-2 text-slate-400 text-sm">
                         <li><a href="{{ route('home') }}" class="hover:text-white transition-colors">Home</a></li>
                         <li><a href="{{ route('news') }}" class="hover:text-white transition-colors">News</a></li>
-                        <li><a href="{{ route('forums') }}" class="hover:text-white transition-colors">Forums</a></li>
                         <li><a href="#" class="hover:text-white transition-colors">Download</a></li>
                     </ul>
                 </div>
diff --git a/routes/web.php b/routes/web.php
index 02b0c94..4587f7d 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -40,7 +40,7 @@
     }
 });
 
-Route::prefix('news')->group(function () {
+Route::prefix('news')->middleware(['auth', 'permission:view.news'])->group(function () {
     Route::get('/', [NewsController::class, 'index'])->name('news');
     Route::get('/{slug}', [NewsController::class, 'show'])->name('news.show');
     Route::post('/{slug}/comment', [CommentController::class, 'store'])->name('news.comment.store');
@@ -58,23 +58,11 @@
     Route::post('/logout', [AuthController::class, 'logout'])->name('logout');
 });
 
-Route::prefix('ucp')->middleware(['auth', 'role:User,GameMaster,Admin'])->group(function () {
+Route::prefix('ucp')->middleware(['auth', 'permission:access.ucp'])->group(function () {
     Route::get('/', [UserController::class, 'show'])->name('ucp.dashboard');
     Route::get('/gameaccount', [UserController::class, 'gameAccount'])->name('ucp.gameaccount');
     Route::get('/donations', [UserController::class, 'transaction'])->name('ucp.transaction');
     Route::get('/gameaccount/create', [UserController::class, 'createAction'])->name('ucp.gameaccount.create');
     Route::post('/gameaccount/create', [UserController::class, 'createGameAccount'])->name('ucp.gameaccount.store');
-    Route::get('/manage', [UserController::class, 'manage'])->name('ucp.manageAccount');
-});
-
-Route::prefix('forums')->group(function () {
-    Route::get('/', [ForumsController::class, 'index'])->name('forums');
-    Route::prefix('ucp')->middleware(['auth', 'role:User,GameMaster,Admin'])->group(function () {
-        Route::get('/{slug}/create', [ForumsController::class, 'createThread'])->name('forums.create_thread');
-        Route::post('/{slug}/create', [ForumsController::class, 'storeThread'])->name('forums.store_thread');
-        Route::post('/{forumSlug}/{threadSlug}/reply', [ForumsController::class, 'storePost'])->name('forums.store_post');
-    });
-    
-    Route::get('/{forumSlug}/{threadSlug}', [ForumsController::class, 'showThread'])->name('forums.thread');
-    Route::get('/{slug}', [ForumsController::class, 'showForum'])->name('forums.show');
-});
+    Route::get('/manage', [UserController::class, 'manage'])->middleware('permission:manage.own.account')->name('ucp.manageAccount');
+});
\ No newline at end of file

From c19a650faab51b027bbec465000b2069503aaaf6 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Mon, 9 Feb 2026 01:28:31 +0100
Subject: [PATCH 077/132] fix: increase homepage news pagination limit from 2
 to 5 items

Additionally, updated the footer "Download" link to point to the correct "howtoplay" route and fixed the empty state styling on the news grid.
---
 app/Http/Controllers/Frontend/HomeController.php | 2 +-
 resources/views/home/index.blade.php             | 4 ++--
 resources/views/layouts/main.blade.php           | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/app/Http/Controllers/Frontend/HomeController.php b/app/Http/Controllers/Frontend/HomeController.php
index 4bfcf03..7b8ce9b 100644
--- a/app/Http/Controllers/Frontend/HomeController.php
+++ b/app/Http/Controllers/Frontend/HomeController.php
@@ -37,7 +37,7 @@ class HomeController extends Controller
      *
      * @var int
      */
-    protected $perPage = 2;
+    protected $perPage = 5;
 
     /**
      * Display the homepage.
diff --git a/resources/views/home/index.blade.php b/resources/views/home/index.blade.php
index 5a8d25b..dc8fa5e 100755
--- a/resources/views/home/index.blade.php
+++ b/resources/views/home/index.blade.php
@@ -133,12 +133,12 @@ class="absolute top-1/2 left-1/2 w-80 h-80 rounded-full bg-cyan-500/10 opacity-5
                         </a>
                     </div>
                     @empty
-                    <div class="bg-slate-800/30 backdrop-blur-sm rounded-xl p-5 border border-slate-700/50 hover:border-slate-600 cursor-pointer">
+                    <div class="col-span-full bg-slate-800/30 backdrop-blur-sm rounded-xl p-5 border border-slate-700/50 hover:border-slate-600 cursor-pointer">
                         <p class="text-slate-400 text-sm">No news available.</p>
                     </div>
                     @endforelse
                 </div>
-
+                
                 <div class="text-center pt-4">
                     <a href="{{ route('news') }}" class="px-6 py-3 bg-slate-800/50 hover:bg-slate-700/50 text-white rounded-lg transition-all duration-300 font-medium border border-slate-700">
                         View All News
diff --git a/resources/views/layouts/main.blade.php b/resources/views/layouts/main.blade.php
index 6f0ef8e..b60b0ed 100644
--- a/resources/views/layouts/main.blade.php
+++ b/resources/views/layouts/main.blade.php
@@ -108,7 +108,7 @@
                     <ul class="space-y-2 text-slate-400 text-sm">
                         <li><a href="{{ route('home') }}" class="hover:text-white transition-colors">Home</a></li>
                         <li><a href="{{ route('news') }}" class="hover:text-white transition-colors">News</a></li>
-                        <li><a href="#" class="hover:text-white transition-colors">Download</a></li>
+                        <li><a href="{{ route('howtoplay') }}" class="hover:text-white transition-colors">Download</a></li>
                     </ul>
                 </div>
                 <div>

From 7ec623245ac4a954cb70444d87a6677266e2a188 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Mon, 9 Feb 2026 02:00:16 +0100
Subject: [PATCH 078/132] fix: remove auth middleware from news routes and
 adjust featured news layout

---
 resources/views/home/index.blade.php | 11 ++++++++++-
 routes/web.php                       |  2 +-
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/resources/views/home/index.blade.php b/resources/views/home/index.blade.php
index dc8fa5e..774fdb9 100755
--- a/resources/views/home/index.blade.php
+++ b/resources/views/home/index.blade.php
@@ -101,9 +101,18 @@ class="absolute top-1/2 left-1/2 w-80 h-80 rounded-full bg-cyan-500/10 opacity-5
                         @if(!empty($data['featuredNews']->image))
                         <img src="{{ asset('storage/images/' . $data['featuredNews']->image) }}" alt="{{ $data['featuredNews']->title }}" class="w-full h-64 object-cover group-hover:scale-105 transition-transform duration-500">
                         @endif
-                        <div class="absolute top-4 left-4">
+
+                        @if(!empty($data['featuredNews']->image))
+                        <div class="absolute top-4 left-10">
                             <span class="bg-blue-600 text-white text-xs font-bold px-3 py-1 rounded-full uppercase tracking-wide">Featured</span>
                         </div>
+                        @else
+                        <div class="mb-2">
+                            <span class="bg-blue-600 text-white text-xs font-bold px-3 py-1 rounded-full">
+                                Featured
+                            </span>
+                        </div>    
+                        @endif                   
                     </div>
                     <div class="p-6 space-y-3">
                         <div class="text-sm text-slate-400">{{ $data['featuredNews']->published_at ? $data['featuredNews']->published_at->format('F d, Y') : 'Draft' }}</div>
diff --git a/routes/web.php b/routes/web.php
index 4587f7d..557b76b 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -40,7 +40,7 @@
     }
 });
 
-Route::prefix('news')->middleware(['auth', 'permission:view.news'])->group(function () {
+Route::prefix('news')->group(function () {
     Route::get('/', [NewsController::class, 'index'])->name('news');
     Route::get('/{slug}', [NewsController::class, 'show'])->name('news.show');
     Route::post('/{slug}/comment', [CommentController::class, 'store'])->name('news.comment.store');

From bede901f9d342307c8c9238d8cac036af5a19acb Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 17 Feb 2026 22:52:50 +0100
Subject: [PATCH 079/132] feat(console): add artisan command to fix Laravel
 directory permissions

---
 app/Console/Commands/PermissionsCommand.php | 68 +++++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 app/Console/Commands/PermissionsCommand.php

diff --git a/app/Console/Commands/PermissionsCommand.php b/app/Console/Commands/PermissionsCommand.php
new file mode 100644
index 0000000..85941f9
--- /dev/null
+++ b/app/Console/Commands/PermissionsCommand.php
@@ -0,0 +1,68 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+use Illuminate\Filesystem\Filesystem;
+
+class PermissionsCommand extends Command
+{
+    protected $signature = 'nexus:permissions';
+
+    protected $description = 'Fix Laravel directory permissions for NexusCMS';
+
+    protected $files;
+
+    public function __construct(Filesystem $files)
+    {
+        parent::__construct();
+        $this->files = $files;
+    }
+
+    public function handle()
+    {
+        $this->info('Setting required directory permissions...');
+
+        $directories = [
+            storage_path(),
+            storage_path('app'),
+            storage_path('framework'),
+            storage_path('logs'),
+            base_path('bootstrap/cache'),
+        ];
+
+        foreach ($directories as $directory) {
+            if (!$directory) {
+                continue;
+            }
+
+            if (!$this->files->exists($directory)) {
+                $this->files->makeDirectory($directory, 0775, true, true);
+            }
+
+            $this->setPermissions($directory);
+        }
+
+        $this->info('Directory permissions updated successfully.');
+
+        return self::SUCCESS;
+    }
+
+    protected function setPermissions(string $directory): void
+    {
+        if (!$this->files->isDirectory($directory)) {
+            return;
+        }
+
+        $this->files->chmod($directory, 0775);
+
+        foreach ($this->files->directories($directory) as $dir) {
+            $this->setPermissions($dir);
+        }
+
+        foreach ($this->files->files($directory) as $file) {
+            $this->files->chmod($file->getPathname(), 0664);
+        }
+    }
+}
+

From 51550428d949f41755c46d44c83de8be3381919a Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 17 Feb 2026 23:44:00 +0100
Subject: [PATCH 080/132] fix(donations): replace Laravel collection methods
 with array functions

The view was expecting an array but receiving a Collection, causing method call errors. Use empty() and array functions for compatibility with both array and Collection types.
---
 resources/views/ucp/donations.blade.php | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/resources/views/ucp/donations.blade.php b/resources/views/ucp/donations.blade.php
index c194968..b3f181d 100644
--- a/resources/views/ucp/donations.blade.php
+++ b/resources/views/ucp/donations.blade.php
@@ -6,7 +6,7 @@
         @include('ucp.components.sidebar')
 
         <main class="lg:col-span-3 space-y-6">
-                <!-- Stats Overview -->
+            <!-- Stats Overview -->
             <div class="grid grid-cols-1 sm:grid-cols-3 gap-4">
                 <!-- Total Donated -->
                 <div class="bg-gradient-to-br from-emerald-500/10 to-emerald-600/5 rounded-xl p-6 border border-emerald-500/20 hover:border-emerald-500/40 transition-all duration-200">
@@ -16,7 +16,9 @@
                         </div>
                     </div>
                     <p class="text-sm text-gray-400 mb-1">Total Donated</p>
-                    <p class="text-3xl font-bold text-white">{{ $transactions->isEmpty() ? '0.00' : number_format($transactions->sum('amount'), 2) }}</p>
+                    <p class="text-3xl font-bold text-white">
+                        {{ empty($transactions) ? '0.00' : number_format(array_sum(array_column($transactions, 'amount')), 2) }}
+                    </p>
                 </div>
 
                 <!-- Total Coins -->
@@ -27,7 +29,9 @@
                         </div>
                     </div>
                     <p class="text-sm text-gray-400 mb-1">Total Coins Earned</p>
-                    <p class="text-3xl font-bold text-white">{{ $transactions->isEmpty() ? '0' : number_format($transactions->sum('dp_awarded')) }}</p>
+                    <p class="text-3xl font-bold text-white">
+                        {{ empty($transactions) ? '0' : number_format(array_sum(array_column($transactions, 'dp_awarded'))) }}
+                    </p>
                 </div>
 
                 <!-- Transactions -->
@@ -38,10 +42,13 @@
                         </div>
                     </div>
                     <p class="text-sm text-gray-400 mb-1">Total Transactions</p>
-                    <p class="text-3xl font-bold text-white">{{ $transactions->isEmpty() ? '0' : number_format($transactions->count()) }}</p>
+                    <p class="text-3xl font-bold text-white">
+                        {{ empty($transactions) ? '0' : count($transactions) }}
+                    </p>
                 </div>
             </div>
 
+
             <!-- Transactions Table -->
             <div class="bg-slate-800/50 backdrop-blur-sm rounded-2xl border border-slate-700/50 overflow-hidden shadow-xl">
                 <div class="p-6 border-b border-slate-700/50 flex justify-between items-center">

From 73665b0ccae4eabebaf88a3ec11c0337e86ab8aa Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 17 Feb 2026 23:45:49 +0100
Subject: [PATCH 081/132] fix(views): handle null values in donations
 transaction table

Replace object property access with array access and null coalescing operators to prevent errors when transaction data contains null values. Add empty state message when no transactions exist.
---
 resources/views/ucp/donations.blade.php | 97 +++++++++++++------------
 1 file changed, 51 insertions(+), 46 deletions(-)

diff --git a/resources/views/ucp/donations.blade.php b/resources/views/ucp/donations.blade.php
index b3f181d..2e646e8 100644
--- a/resources/views/ucp/donations.blade.php
+++ b/resources/views/ucp/donations.blade.php
@@ -72,53 +72,58 @@
                             </tr>
                         </thead>
                         <tbody class="divide-y divide-slate-700/50">
-                            @foreach ($transactions as $transaction)
-                            <!-- Transaction 1 -->
-                            <tr class="hover:bg-slate-700/20 transition-colors duration-200">
-                                <td class="px-6 py-4">
-                                    <div class="flex items-center space-x-3">
-                                        <div class="w-10 h-10 rounded-lg bg-blue-500/20 flex items-center justify-center">
-                                            <i class="fas fa-hashtag text-blue-400"></i>
+                            @forelse ($transactions as $transaction)
+                                <tr class="hover:bg-slate-700/20 transition-colors duration-200">
+                                    <td class="px-6 py-4">
+                                        <div class="flex items-center space-x-3">
+                                            <div class="w-10 h-10 rounded-lg bg-blue-500/20 flex items-center justify-center">
+                                                <i class="fas fa-hashtag text-blue-400"></i>
+                                            </div>
+                                            <span class="text-sm font-mono text-gray-300">{{ $transaction['transaction_id'] ?? 'N/A' }}</span>
                                         </div>
-                                        <span class="text-sm font-mono text-gray-300">{{ $transaction->transaction_id }}</span>
-                                    </div>
-                                </td>
-                                <td class="px-6 py-4">
-                                    <div class="text-sm text-gray-300">{{ $transaction->created_at->format('M d, Y') }}</div>
-                                    <div class="text-xs text-gray-500">{{ $transaction->created_at->format('h:i A') }}</div>
-                                </td>
-                                <td class="px-6 py-4">
-                                    <span class="text-sm font-bold text-emerald-400">${{ number_format($transaction->amount, 2) }}</span>
-                                </td>
-                                <td class="px-6 py-4">
-                                    <div class="flex items-center space-x-2">
-                                        <i class="fas fa-coins text-amber-400"></i>
-                                        <span class="text-sm font-semibold text-white">{{ number_format($transaction->dp_awarded, 0) }}</span>
-                                    </div>
-                                </td>
-                                <td class="px-6 py-4">
-                                    <div class="text-sm font-medium text-gray-300 text-capitalize">{{ ucfirst($transaction->gateway) }}</div>
-                                </td>
-                                <td class="px-6 py-4">
-                                    @if($transaction->status == 'completed')
-                                    <span class="inline-flex items-center px-3 py-1 rounded-full text-xs font-medium bg-green-500/20 text-green-300 border border-green-500/30">
-                                        <div class="w-1.5 h-1.5 bg-green-400 rounded-full mr-2"></div>
-                                        Completed
-                                    </span>
-                                    @else
-                                    <span class="inline-flex items-center px-3 py-1 rounded-full text-xs font-medium bg-amber-500/20 text-amber-300 border border-amber-500/30">
-                                        <div class="w-1.5 h-1.5 bg-amber-400 rounded-full mr-2 animate-pulse"></div>
-                                        Pending
-                                    </span>
-                                    @endif
-                                </td>
-                                <td class="px-6 py-4 text-right">
-                                    <button class="text-gray-400 hover:text-blue-400 transition-colors duration-200">
-                                        <i class="fas fa-eye"></i>
-                                    </button>
-                                </td>
-                            </tr>
-                            @endforeach
+                                    </td>
+                                    <td class="px-6 py-4">
+                                        <div class="text-sm text-gray-300">{{ isset($transaction['created_at']) ? \Carbon\Carbon::parse($transaction['created_at'])->format('M d, Y') : '-' }}</div>
+                                        <div class="text-xs text-gray-500">{{ isset($transaction['created_at']) ? \Carbon\Carbon::parse($transaction['created_at'])->format('h:i A') : '-' }}</div>
+                                    </td>
+                                    <td class="px-6 py-4">
+                                        <span class="text-sm font-bold text-emerald-400">${{ number_format($transaction['amount'] ?? 0, 2) }}</span>
+                                    </td>
+                                    <td class="px-6 py-4">
+                                        <div class="flex items-center space-x-2">
+                                            <i class="fas fa-coins text-amber-400"></i>
+                                            <span class="text-sm font-semibold text-white">{{ number_format($transaction['dp_awarded'] ?? 0, 0) }}</span>
+                                        </div>
+                                    </td>
+                                    <td class="px-6 py-4">
+                                        <div class="text-sm font-medium text-gray-300 text-capitalize">{{ ucfirst($transaction['gateway'] ?? '-') }}</div>
+                                    </td>
+                                    <td class="px-6 py-4">
+                                        @if(($transaction['status'] ?? '') == 'completed')
+                                            <span class="inline-flex items-center px-3 py-1 rounded-full text-xs font-medium bg-green-500/20 text-green-300 border border-green-500/30">
+                                                <div class="w-1.5 h-1.5 bg-green-400 rounded-full mr-2"></div>
+                                                Completed
+                                            </span>
+                                        @else
+                                            <span class="inline-flex items-center px-3 py-1 rounded-full text-xs font-medium bg-amber-500/20 text-amber-300 border border-amber-500/30">
+                                                <div class="w-1.5 h-1.5 bg-amber-400 rounded-full mr-2 animate-pulse"></div>
+                                                Pending
+                                            </span>
+                                        @endif
+                                    </td>
+                                    <td class="px-6 py-4 text-right">
+                                        <button class="text-gray-400 hover:text-blue-400 transition-colors duration-200">
+                                            <i class="fas fa-eye"></i>
+                                        </button>
+                                    </td>
+                                </tr>
+                            @empty
+                                <tr>
+                                    <td colspan="7" class="text-center text-gray-500 py-4">
+                                        No transactions found.
+                                    </td>
+                                </tr>
+                            @endforelse
                         </tbody>
                     </table>
                 </div>

From d17e239342a03713cb5039b76338339436f75c61 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 21 Feb 2026 01:39:20 +0100
Subject: [PATCH 082/132] feat(armory): add realm existence middleware and
 clean up views

Add middleware to check if realms exist before accessing armory routes
and remove unused view files to reduce codebase clutter

- Add EnsureRealmsExist middleware to redirect to home if realms table or records are missing
- Register middleware in ArmoryServiceProvider with alias 'realms.exists'
- Update routes to use new middleware instead of 'web' middleware group
- Change default realm value from 1 to false in ArmoryController
- Delete all armory view files (index, show, and partials) as they appear to be unused or placeholder content
---
 .../Http/Controllers/ArmoryController.php     |   2 +-
 .../Http/Middleware/EnsureRealmsExist.php     |  30 ++++
 app/Modules/Armory/Http/routes.php            |  12 +-
 .../Providers/ArmoryServiceProvider.php       |  10 +-
 resources/views/armory/index.blade.php        | 166 ------------------
 .../armory/partials/achievements.blade.php    |  15 --
 .../armory/partials/equipment-slot.blade.php  |  36 ----
 .../views/armory/partials/equipment.blade.php |  80 ---------
 .../armory/partials/professions.blade.php     |  26 ---
 resources/views/armory/partials/pvp.blade.php |  97 ----------
 .../armory/partials/statistics.blade.php      |  85 ---------
 resources/views/armory/show.blade.php         | 117 ------------
 12 files changed, 45 insertions(+), 631 deletions(-)
 create mode 100644 app/Modules/Armory/Http/Middleware/EnsureRealmsExist.php
 delete mode 100644 resources/views/armory/index.blade.php
 delete mode 100644 resources/views/armory/partials/achievements.blade.php
 delete mode 100644 resources/views/armory/partials/equipment-slot.blade.php
 delete mode 100644 resources/views/armory/partials/equipment.blade.php
 delete mode 100644 resources/views/armory/partials/professions.blade.php
 delete mode 100644 resources/views/armory/partials/pvp.blade.php
 delete mode 100644 resources/views/armory/partials/statistics.blade.php
 delete mode 100644 resources/views/armory/show.blade.php

diff --git a/app/Modules/Armory/Http/Controllers/ArmoryController.php b/app/Modules/Armory/Http/Controllers/ArmoryController.php
index db0c026..27bcd25 100644
--- a/app/Modules/Armory/Http/Controllers/ArmoryController.php
+++ b/app/Modules/Armory/Http/Controllers/ArmoryController.php
@@ -75,7 +75,7 @@ public function index(Request $request)
     {
         $q = $request->input('q');
         $faction = $request->input('faction') ?: null;
-        $realm = $request->input('realm') ?: 1;
+        $realm = $request->input('realm') ?: false;
         $class = $request->input('class') ?: null;
         $minLevel = $request->input('min_level') ?: null;
 
diff --git a/app/Modules/Armory/Http/Middleware/EnsureRealmsExist.php b/app/Modules/Armory/Http/Middleware/EnsureRealmsExist.php
new file mode 100644
index 0000000..d97d766
--- /dev/null
+++ b/app/Modules/Armory/Http/Middleware/EnsureRealmsExist.php
@@ -0,0 +1,30 @@
+<?php
+
+namespace Modules\Armory\Http\Middleware;
+
+use App\Models\Realm;
+use Closure;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Schema;
+use Symfony\Component\HttpFoundation\Response;
+
+class EnsureRealmsExist
+{
+    public function handle(Request $request, Closure $next): Response
+    {
+        try {
+            if (!Schema::hasTable('realms')) {
+                return redirect()->route('home');
+            }
+
+            if (!Realm::query()->exists()) {
+                return redirect()->route('home');
+            }
+        } catch (\Throwable $e) {
+            return redirect()->route('home');
+        }
+
+        return $next($request);
+    }
+}
+
diff --git a/app/Modules/Armory/Http/routes.php b/app/Modules/Armory/Http/routes.php
index 0aa2e79..e79e50d 100644
--- a/app/Modules/Armory/Http/routes.php
+++ b/app/Modules/Armory/Http/routes.php
@@ -3,10 +3,8 @@
 use Illuminate\Support\Facades\Route;
 use Modules\Armory\Http\Controllers\ArmoryController;
 
-Route::middleware('web')->group(function () {
-    Route::prefix('armory')->group(function () {
-        Route::get('/', [ArmoryController::class, 'index'])->name('armory');
-        Route::get('{id}', [ArmoryController::class, 'show'])->where('id', '[0-9]+')->name('armory.show');
-        Route::get('{id}/{realm?}', [ArmoryController::class, 'show'])->where('id', '[0-9]+')->where('realm', '[0-9]+')->name('armory.show.realm');
-    });
-});
\ No newline at end of file
+Route::middleware('realms.exists')->prefix('armory')->group(function () {
+    Route::get('/', [ArmoryController::class, 'index'])->name('armory');
+    Route::get('{id}', [ArmoryController::class, 'show'])->where('id', '[0-9]+')->name('armory.show');
+    Route::get('{id}/{realm?}', [ArmoryController::class, 'show'])->where('id', '[0-9]+')->where('realm', '[0-9]+')->name('armory.show.realm');
+});
diff --git a/app/Modules/Armory/Providers/ArmoryServiceProvider.php b/app/Modules/Armory/Providers/ArmoryServiceProvider.php
index 2b9b547..67460ef 100644
--- a/app/Modules/Armory/Providers/ArmoryServiceProvider.php
+++ b/app/Modules/Armory/Providers/ArmoryServiceProvider.php
@@ -7,11 +7,19 @@
 use Modules\Armory\Domain\Interfaces\ArmoryRepositoryInterface;
 use App\Models\Realm;
 use App\Enums\Emulator;
+use Modules\Armory\Http\Middleware\EnsureRealmsExist;
 
 class ArmoryServiceProvider extends BaseModuleServiceProvider
 {
     protected string $moduleName = 'Armory';
 
+    public function boot(): void
+    {
+        parent::boot();
+
+        $router = $this->app->make('router');
+        $router->aliasMiddleware('realms.exists', EnsureRealmsExist::class);
+    }
 
     public function register(): void
     {
@@ -41,4 +49,4 @@ public function register(): void
             };
         });
     } 
-}
\ No newline at end of file
+}
diff --git a/resources/views/armory/index.blade.php b/resources/views/armory/index.blade.php
deleted file mode 100644
index 5491a1e..0000000
--- a/resources/views/armory/index.blade.php
+++ /dev/null
@@ -1,166 +0,0 @@
-@extends('layouts.main')
-
-@section('content')
-<!-- Hero Section with Search -->
-<div class="bg-gradient-to-b from-gray-800 to-gray-900 py-16 border-b border-gray-700">
-    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
-        <div class="text-center mb-12">
-            <h1 class="text-6xl font-bold cinzel mb-4 bg-gradient-to-r from-blue-400 to-purple-500 bg-clip-text text-transparent">
-                Character Armory
-            </h1>
-            <p class="text-gray-400 text-xl">Search and explore character profiles across all realms</p>
-        </div>
-
-        <!-- Advanced Search -->
-        <form action="{{ route('armory') }}" method="GET" class="search-container max-w-4xl mx-auto p-8 rounded-2xl shadow-2xl border border-gray-700">
-            <div class="grid grid-cols-1 md:grid-cols-3 gap-4 mb-6">
-                <div class="md:col-span-2">
-                    <label class="block text-sm font-medium text-gray-400 mb-2">Character Name</label>
-                    <input type="text"
-                           name="q"
-                           id="searchInput"
-                           placeholder="Enter character name..."
-                           value="{{ old('q', request('q')) }}"
-                           class="w-full px-6 py-4 rounded-lg bg-gray-800 border border-gray-700 text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent text-lg">
-                </div>
-                <div class="md:col-span-1">
-                    <label class="block text-sm font-medium text-gray-400 mb-2">Realm</label>
-                    <select name="realm" class="w-full px-4 py-3 rounded-lg bg-gray-800 border border-gray-700 text-white focus:outline-none focus:ring-2 focus:ring-blue-500">
-                        <option value="">Any</option>
-                        @foreach(App\Models\Realm::all() as $realm)
-                            <option value="{{ $realm->id }}" {{ request('realm') == $realm->id ? 'selected' : '' }}>{{ $realm->name }}</option>
-                        @endforeach
-                    </select>
-                </div>
-            </div>
-
-            <div class="grid grid-cols-1 md:grid-cols-3 gap-4 mb-6">
-                <div>
-                    <label class="block text-sm font-medium text-gray-400 mb-2">Faction</label>
-                    <select name="faction" class="w-full px-4 py-3 rounded-lg bg-gray-800 border border-gray-700 text-white focus:outline-none focus:ring-2 focus:ring-blue-500">
-                        <option value="">All Factions</option>
-                        <option value="horde" {{ request('faction') == 'horde' ? 'selected' : '' }}>Horde</option>
-                        <option value="alliance" {{ request('faction') == 'alliance' ? 'selected' : '' }}>Alliance</option>
-                    </select>
-                </div>
-                <div>
-                    <label class="block text-sm font-medium text-gray-400 mb-2">Class</label>
-                    <select name="class" class="w-full px-4 py-3 rounded-lg bg-gray-800 border border-gray-700 text-white focus:outline-none focus:ring-2 focus:ring-blue-500">
-                        <option value="">All Classes</option>
-                        <option value="1" {{ request('class') == '1' ? 'selected' : '' }}>Warrior</option>
-                        <option value="2" {{ request('class') == '2' ? 'selected' : '' }}>Paladin</option>
-                        <option value="3" {{ request('class') == '3' ? 'selected' : '' }}>Hunter</option>
-                        <option value="4" {{ request('class') == '4' ? 'selected' : '' }}>Rogue</option>
-                        <option value="5" {{ request('class') == '5' ? 'selected' : '' }}>Priest</option>
-                        <option value="6" {{ request('class') == '6' ? 'selected' : '' }}>Death Knight</option>
-                        <option value="7" {{ request('class') == '7' ? 'selected' : '' }}>Shaman</option>
-                        <option value="8" {{ request('class') == '8' ? 'selected' : '' }}>Mage</option>
-                        <option value="9" {{ request('class') == '9' ? 'selected' : '' }}>Warlock</option>
-                        <option value="11" {{ request('class') == '11' ? 'selected' : '' }}>Druid</option>
-                    </select>
-                </div>
-                <div>
-                    <label class="block text-sm font-medium text-gray-400 mb-2">Min Level</label>
-                    <select name="min_level" class="w-full px-4 py-3 rounded-lg bg-gray-800 border border-gray-700 text-white focus:outline-none focus:ring-2 focus:ring-blue-500">
-                        <option value="">Any</option>
-                        <option value="80" {{ request('min_level') == '80' ? 'selected' : '' }}>80</option>
-                        <option value="70" {{ request('min_level') == '70' ? 'selected' : '' }}>70</option>
-                        <option value="60" {{ request('min_level') == '60' ? 'selected' : '' }}>60</option>
-                    </select>
-                </div>
-            </div>
-
-            <button type="submit"
-                    class="w-full bg-gradient-to-r from-blue-600 to-purple-600 hover:from-blue-700 hover:to-purple-700 text-white px-8 py-4 rounded-lg font-bold text-lg transition-all duration-300 transform hover:scale-105 shadow-lg hover:shadow-2xl">
-                <i class="fas fa-search mr-3"></i> Search Characters
-            </button>
-        </form>
-    </div>
-</div>
-
-<!-- Results Section -->
-<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-12">
-    <div class="flex items-center justify-between mb-8">
-        <div>
-            <h2 class="text-3xl font-bold cinzel mb-2">Search Results</h2>
-            <p class="text-gray-400">
-                Found <span class="text-blue-400 font-bold"></span> characters
-            </p>
-        </div>
-    </div>
-
-    @if(filled(request('q')) || filled(request('faction')) || filled(request('class')) || filled(request('min_level')))
-        @if($data->count())
-            <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6" id="characterGrid">
-                @foreach($data as $player)
-                    <div class="bg-gray-800 rounded-xl p-6 border border-gray-700 hover:border-gray-600 transition-all">
-                        <div class="flex items-start gap-4 mb-4">
-                            <img src="https://wow.zamimg.com/images/wow/icons/large/achievement_character_{{ strtolower(App\Helpers\RealmHelper::getWoWConstant('race', $player->race)) }}_{{ strtolower($player->gender == 1 ? 'male' : 'female') }}.jpg"
-                                 alt="{{ $player->name }}"
-                                 class="w-20 h-20 rounded-lg border-2 {{ App\Helpers\RealmHelper::getFactionByRace($player->race) === 'horde' ? 'border-red-600' : 'border-blue-600' }}">
-                            <div class="flex-1">
-                                <div class="flex items-center gap-2 mb-1">
-                                    <h3 class="text-2xl font-bold class-{{ strtolower($player->class) }}">{{ $player->name }}</h3>
-                                    <span class="level-badge bg-gray-700 text-white px-2 py-1 rounded text-xs font-bold">{{ $player->level }}</span>
-                                </div>
-                                <p class="text-gray-400 text-sm mb-2">{{ App\Helpers\RealmHelper::getWoWConstant('race', $player->race) }} {{ App\Helpers\RealmHelper::getWoWConstant('class', $player->class) }}</p>
-                                <div class="guild-tag inline-block px-3 py-1 rounded-full text-xs font-medium bg-gray-700 text-gray-300">
-                                    <i class="fas fa-shield-alt mr-1"></i> &lt;{{ $player->guild_name ?? 'N/A' }}&gt;
-                                </div>
-                            </div>
-                        </div>
-
-                        <div class="border-t border-gray-700 pt-4 mb-4">
-                            <div class="flex items-center justify-between text-sm mb-2">
-                                <span class="text-gray-400">Realm</span>
-                                <span class="text-white font-medium">{{ $player->realm_name ?? 'N/A' }}</span>
-                            </div>
-                            <div class="flex items-center justify-between text-sm mb-2">
-                                <span class="text-gray-400">Item Level</span>
-                                <span class="text-purple-400 font-bold">{{ $player->item_level ?? 'N/A' }}</span>
-                            </div>
-                            <div class="flex items-center justify-between text-sm">
-                                <span class="text-gray-400">Achievement Points</span>
-                                <span class="text-yellow-500 font-bold">{{ number_format($player->achievement_points ?? 0) }}</span>
-                            </div>
-                        </div>
-
-                        <div class="flex gap-2 mb-4">
-                            <div class="stats-pill flex-1 px-3 py-2 rounded-lg text-center bg-gray-700">
-                                <div class="text-xs text-gray-400">Arena</div>
-                                <div class="text-sm font-bold text-purple-400">{{ $player->arena_points ?? 0 }}</div>
-                            </div>
-                            <div class="stats-pill flex-1 px-3 py-2 rounded-lg text-center bg-gray-700">
-                                <div class="text-xs text-gray-400">HKs</div>
-                                <div class="text-sm font-bold text-red-400">{{ number_format($player->honorable_kills ?? 0) }}</div>
-                            </div>
-                        </div>
-
-                        <a href="{{ route('armory.show.realm', [$player->guid, $player->realm_id ?? 1]) }}"
-                           class="w-full bg-blue-600 hover:bg-blue-700 text-white py-3 rounded-lg font-medium transition-all duration-300 transform hover:scale-105 inline-block text-center">
-                            <i class="fas fa-eye mr-2"></i> View Profile
-                        </a>
-                    </div>
-                @endforeach
-            </div>
-
-            <!-- Pagination -->
-            <div class="mt-8">
-            </div>
-        @else
-            <div class="max-w-md mx-auto">
-                <div class="bg-yellow-900/30 border border-yellow-700 rounded-lg p-4 text-center">
-                    <div class="flex items-center justify-center mb-2">
-                        <svg class="w-6 h-6 text-yellow-400 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
-                                  d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
-                        </svg>
-                        <h3 class="text-yellow-400 font-semibold">No Character Found</h3>
-                    </div>
-                    <p class="text-yellow-200 text-sm">We couldn't find any character matching your criteria. Please adjust your filters and try again.</p>
-                </div>
-            </div>
-        @endif
-    @endif
-</div>
-@endsection
diff --git a/resources/views/armory/partials/achievements.blade.php b/resources/views/armory/partials/achievements.blade.php
deleted file mode 100644
index 8965776..0000000
--- a/resources/views/armory/partials/achievements.blade.php
+++ /dev/null
@@ -1,15 +0,0 @@
-<div id="achievements-tab" class="tab-content hidden">
-    <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
-        <!-- Achievement 1 -->
-        @foreach($achievements as $item)
-        <div class="achievement-badge rounded-xl p-6">
-            <div class="flex items-start gap-4">
-                <a class="text-xl font-bold text-yellow-400 mb-2" href="https://www.wowhead.com/achievement={{ $item['id'] }}" data-wh-icon-size="large" data-wowhead="achievement={{ $item['id'] }}">
-                    <img src="https://wow.zamimg.com/images/wow/icons/large/{{ $item['icon'] ?? 'achievement_boss_lichking' }}.jpg" 
-                        class="w-20 h-20 rounded-lg border-2 border-yellow-500">
-                </a>
-            </div>
-        </div>
-        @endforeach
-    </div>
-</div>
\ No newline at end of file
diff --git a/resources/views/armory/partials/equipment-slot.blade.php b/resources/views/armory/partials/equipment-slot.blade.php
deleted file mode 100644
index ba60440..0000000
--- a/resources/views/armory/partials/equipment-slot.blade.php
+++ /dev/null
@@ -1,36 +0,0 @@
-@php
-    $qualityName = $equip['wowhead']['quality']['name'] ?? 'Common';
-    $qualityClass = 'item-quality-' . strtolower($qualityName);
-    $icon = $equip['wowhead']['icon']['name'] ?? 'inv_misc_questionmark';
-    $iconUrl = "https://wow.zamimg.com/images/wow/icons/large/{$icon}.jpg";
-@endphp
-
-<div class="item-slot rounded-xl p-3 flex items-center gap-3 cursor-pointer
-    {{ $equip ? $qualityClass : 'border border-gray-700 text-gray-500' }}"
-    @if($equip) data-wowhead="item={{ $equip['entry'] }}" @endif>
-    
-    <img src="{{ $iconUrl }}" class="w-16 h-16 rounded-lg">
-    
-    <div class="flex-1 min-w-0">
-        <div class="text-xs text-gray-400">{{ $label }}</div>
-        <div class="font-bold truncate
-            @switch(strtolower($qualityName))
-                @case('legendary') text-orange-400 @break
-                @case('epic') text-purple-400 @break
-                @case('rare') text-blue-400 @break
-                @case('uncommon') text-green-400 @break
-                @default text-gray-200
-            @endswitch">
-            {{ $equip['wowhead']['name'] ?? 'No equipado' }}
-        </div>
-        @if(isset($equip['wowhead']['level']))
-            <div class="text-xs text-gray-500">Item Level {{ $equip['wowhead']['level'] }}</div>
-        @endif
-    </div>
-
-    @if($equip && in_array(strtolower($qualityName), ['epic', 'legendary']))
-        <div class="text-2xl {{ strtolower($qualityName) === 'legendary' ? 'text-orange-400' : 'text-purple-400' }}">
-            <i class="fas fa-gem"></i>
-        </div>
-    @endif
-</div>
diff --git a/resources/views/armory/partials/equipment.blade.php b/resources/views/armory/partials/equipment.blade.php
deleted file mode 100644
index 846b4e2..0000000
--- a/resources/views/armory/partials/equipment.blade.php
+++ /dev/null
@@ -1,80 +0,0 @@
-<div id="equipment-tab" class="tab-content">
-    @php
-        // Orden de slots (según el orden visual clásico de WoW)
-        $slotOrder = [
-            'Head', 'Neck', 'Shoulders', 'Back', 'Chest', 'Wrist',
-            'Hands', 'Waist', 'Legs', 'Feet', 'Finger 1', 'Finger 2',
-            'Trinket 1', 'Trinket 2', 'Main Hand', 'Off Hand'
-        ];
-
-        // Indexación de ítems por slot numérico si lo necesitas más adelante
-        $equippedBySlot = [];
-        foreach ($item as $equip) {
-            $equippedBySlot[$equip['slot']] = $equip;
-        }
-
-        // Conversión simple para mostrar nombre de slot (slot numérico → texto)
-        $slotNames = [
-            0 => 'Head', 1 => 'Neck', 2 => 'Shoulders', 14 => 'Back',
-            4 => 'Chest', 8 => 'Wrist', 9 => 'Hands', 5 => 'Waist',
-            6 => 'Legs', 7 => 'Feet', 10 => 'Finger 1', 11 => 'Finger 2',
-            12 => 'Trinket 1', 13 => 'Trinket 2', 15 => 'Main Hand', 16 => 'Off Hand'
-        ];
-    @endphp
-
-    <div class="grid grid-cols-1 lg:grid-cols-3 gap-8">
-        <!-- LEFT EQUIPMENT -->
-        <div class="space-y-3">
-            @foreach (array_slice($slotNames, 0, 6, true) as $slot => $label)
-                @php $equip = $equippedBySlot[$slot] ?? null; @endphp
-                @include('armory.partials.equipment-slot', ['equip' => $equip, 'label' => $label])
-            @endforeach
-        </div>
-
-        <!-- CENTER - CHARACTER MODEL -->
-        <div class="character-model rounded-2xl p-8 flex items-center justify-center relative overflow-hidden border border-gray-700">
-            <div class="absolute inset-0 bg-gradient-to-b from-transparent via-transparent to-gray-900 opacity-30"></div>
-            <div class="relative z-10 text-center">
-                <img src="https://wow.zamimg.com/images/wow/icons/large/achievement_character_human_male.jpg"
-                     alt="Character Model" class="w-80 h-80 mx-auto mb-6 opacity-90 rounded-full border-4 border-red-600 shadow-2xl">
-            </div>
-        </div>
-
-        <!-- RIGHT EQUIPMENT -->
-        <div class="space-y-3">
-            @foreach (array_slice($slotNames, 6, 6, true) as $slot => $label)
-                @php $equip = $equippedBySlot[$slot] ?? null; @endphp
-                @include('armory.partials.equipment-slot', ['equip' => $equip, 'label' => $label])
-            @endforeach
-        </div>
-    </div>
-
-    <!-- BOTTOM ROW -->
-    <div class="grid grid-cols-2 md:grid-cols-4 gap-4 mt-8">
-        @foreach (array_slice($slotNames, 12, 4, true) as $slot => $label)
-            @php $equip = $equippedBySlot[$slot] ?? null; @endphp
-            <div class="item-slot rounded-xl p-3 cursor-pointer text-center {{ $equip ? 'item-quality-' . strtolower($equip['wowhead']['quality']['name'] ?? 'common') : 'border border-gray-700 text-gray-500' }}"
-                 @if($equip) data-wowhead="item={{ $equip['entry'] }}" @endif>
-                <img src="{{ $equip && isset($equip['wowhead']['icon']['name'])
-                    ? 'https://wow.zamimg.com/images/wow/icons/large/' . $equip['wowhead']['icon']['name'] . '.jpg'
-                    : 'https://wow.zamimg.com/images/wow/icons/large/inv_misc_questionmark.jpg' }}"
-                    class="w-16 h-16 rounded-lg mx-auto mb-2">
-                <div>
-                    <div class="text-xs text-gray-400">{{ $label }}</div>
-                    <div class="font-bold text-sm truncate @switch(strtolower($equip['wowhead']['quality']['name'] ?? 'common'))
-                        @case('legendary') text-orange-400 @break
-                        @case('epic') text-purple-400 @break
-                        @case('rare') text-blue-400 @break
-                        @case('uncommon') text-green-400 @break
-                        @default text-gray-200
-                    @endswitch">
-                        {{ $equip['wowhead']['name'] ?? 'No equipado' }}
-                    </div>
-                    @if(isset($equip['wowhead']['level']))
-                        <div class="text-xs text-gray-500">iLvl {{ $equip['wowhead']['level'] }}</div>
-                    @endif
-                </div>
-            </div>
-        @endforeach
-    </div>
-</div>
diff --git a/resources/views/armory/partials/professions.blade.php b/resources/views/armory/partials/professions.blade.php
deleted file mode 100644
index 8c88901..0000000
--- a/resources/views/armory/partials/professions.blade.php
+++ /dev/null
@@ -1,26 +0,0 @@
-<div id="professions-tab" class="tab-content hidden">
-    <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
-        <!-- Engineering -->
-        @foreach($skill as $item)
-        <div class="stat-card rounded-xl p-6">
-            <div class="flex items-center gap-4 mb-6">
-                <img src="{{ $item['icon'] }}" 
-                    class="w-20 h-20 rounded-lg border-2 border-orange-500">
-                <div>
-                    <h3 class="text-2xl font-bold">{{ $item['name'] }}</h3>
-                    <p class="text-gray-400">{{ ucfirst($item['type']) }}</p>
-                </div>
-            </div>
-            <div class="mb-6">
-                <div class="flex justify-between mb-2">
-                    <span class="text-gray-400 font-medium">Skill Level</span>
-                    <span class="font-bold text-green-400 text-xl">{{ $item['value'] }} / {{ $item['max'] }}</span>
-                </div>
-                <div class="w-full bg-gray-700 rounded-full h-4">
-                    <div class="bg-gradient-to-r from-green-500 to-green-600 h-4 rounded-full" style="width: {{ $item['value'] / $item['max'] * 100 }}%"></div>
-                </div>
-            </div>
-        </div>
-        @endforeach
-    </div>
-</div>
\ No newline at end of file
diff --git a/resources/views/armory/partials/pvp.blade.php b/resources/views/armory/partials/pvp.blade.php
deleted file mode 100644
index 47f1f31..0000000
--- a/resources/views/armory/partials/pvp.blade.php
+++ /dev/null
@@ -1,97 +0,0 @@
-<div id="pvp-tab" class="tab-content hidden">
-    <div class="grid grid-cols-1 md:grid-cols-3 gap-6 mb-8">
-        <div class="stat-card rounded-xl p-6 text-center border-2 border-purple-600">
-            <i class="fas fa-trophy text-yellow-500 text-5xl mb-4"></i>
-            <div class="text-4xl font-bold mb-2">2,456</div>
-            <div class="text-gray-400">Arena Rating (3v3)</div>
-        </div>
-        <div class="stat-card rounded-xl p-6 text-center border-2 border-red-600">
-            <i class="fas fa-skull text-red-500 text-5xl mb-4"></i>
-            <div class="text-4xl font-bold mb-2">15,234</div>
-            <div class="text-gray-400">Honorable Kills</div>
-        </div>
-        <div class="stat-card rounded-xl p-6 text-center border-2 border-yellow-600">
-            <i class="fas fa-medal text-yellow-500 text-5xl mb-4"></i>
-            <div class="text-4xl font-bold mb-2">High Warlord</div>
-            <div class="text-gray-400">PvP Rank</div>
-        </div>
-    </div>
-
-    <div class="grid grid-cols-1 lg:grid-cols-2 gap-8">
-        <!-- Arena Stats -->
-        <div class="stat-card rounded-xl p-6">
-            <h3 class="text-2xl font-bold mb-6 flex items-center gap-2">
-                <i class="fas fa-swords text-purple-500"></i> Arena Statistics
-            </h3>
-            <div class="space-y-4">
-                <div class="bg-gray-900 p-4 rounded-lg">
-                    <div class="flex justify-between items-center mb-3">
-                        <span class="text-gray-400 font-medium">2v2 Rating</span>
-                        <span class="text-3xl font-bold text-purple-400">2,287</span>
-                    </div>
-                    <div class="flex justify-between text-sm mb-2">
-                        <span class="text-green-400"><i class="fas fa-check-circle mr-1"></i> Wins: 456</span>
-                        <span class="text-red-400"><i class="fas fa-times-circle mr-1"></i> Losses: 234</span>
-                        <span class="text-gray-400">Win Rate: 66%</span>
-                    </div>
-                    <div class="w-full bg-gray-700 rounded-full h-2">
-                        <div class="progress-bar h-2 rounded-full" style="width: 66%"></div>
-                    </div>
-                </div>
-
-                <div class="bg-gray-900 p-4 rounded-lg">
-                    <div class="flex justify-between items-center mb-3">
-                        <span class="text-gray-400 font-medium">3v3 Rating</span>
-                        <span class="text-3xl font-bold text-purple-400">2,456</span>
-                    </div>
-                    <div class="flex justify-between text-sm mb-2">
-                        <span class="text-green-400"><i class="fas fa-check-circle mr-1"></i> Wins: 532</span>
-                        <span class="text-red-400"><i class="fas fa-times-circle mr-1"></i> Losses: 198</span>
-                        <span class="text-gray-400">Win Rate: 73%</span>
-                    </div>
-                    <div class="w-full bg-gray-700 rounded-full h-2">
-                        <div class="progress-bar h-2 rounded-full" style="width: 73%"></div>
-                    </div>
-                </div>
-
-                <div class="bg-gray-900 p-4 rounded-lg">
-                    <div class="flex justify-between items-center mb-3">
-                        <span class="text-gray-400 font-medium">5v5 Rating</span>
-                        <span class="text-3xl font-bold text-purple-400">2,145</span>
-                    </div>
-                    <div class="flex justify-between text-sm mb-2">
-                        <span class="text-green-400"><i class="fas fa-check-circle mr-1"></i> Wins: 321</span>
-                        <span class="text-red-400"><i class="fas fa-times-circle mr-1"></i> Losses: 123</span>
-                        <span class="text-gray-400">Win Rate: 72%</span>
-                    </div>
-                    <div class="w-full bg-gray-700 rounded-full h-2">
-                        <div class="progress-bar h-2 rounded-full" style="width: 72%"></div>
-                    </div>
-                </div>
-            </div>
-        </div>
-
-        <!-- Rated Battlegrounds -->
-        <div class="stat-card rounded-xl p-6">
-            <h3 class="text-2xl font-bold mb-6 flex items-center gap-2">
-                <i class="fas fa-battlefield text-yellow-500"></i> Rated Battlegrounds
-            </h3>
-            <div class="space-y-4">
-                <div class="bg-gray-900 p-4 rounded-lg">
-                    <div class="flex justify-between items-center mb-3">
-                        <span class="text-gray-400 font-medium">2v2 Rating</span>
-                        <span class="text-3xl font-bold text-yellow-400">2,345</span>
-                    </div>
-                    <div class="flex justify-between text-sm mb-2">
-                        <span class="text-green-400"><i class="fas fa-check-circle mr-1"></i> Wins: 456</span>
-                        <span class="text-red-400"><i class="fas fa-times-circle mr-1"></i> Losses: 234</span>
-                        <span class="text-gray-400">Win Rate: 66%</span>
-                    </div>
-                    <div class="w-full bg-gray-700 rounded-full h-2">
-                        <div class="progress-bar h-2 rounded-full" style="width: 66%"></div>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </div>
-</div>
diff --git a/resources/views/armory/partials/statistics.blade.php b/resources/views/armory/partials/statistics.blade.php
deleted file mode 100644
index 5796946..0000000
--- a/resources/views/armory/partials/statistics.blade.php
+++ /dev/null
@@ -1,85 +0,0 @@
-<div id="stats-tab" class="tab-content hidden">
-    <div class="grid grid-cols-1 lg:grid-cols-2 gap-8">
-        <!-- Attributes -->
-        <div class="stat-card rounded-xl p-6">
-            <h3 class="text-2xl font-bold mb-6 flex items-center gap-2">
-                <i class="fas fa-user-shield text-blue-500"></i> Attributes
-            </h3>
-            <div class="space-y-4">
-                <div>
-                    <div class="flex justify-between mb-2">
-                        <span class="text-green-400"><i class="fas fa-check-circle mr-1"></i> Wins: 387</span>
-                        <span class="text-red-400"><i class="fas fa-times-circle mr-1"></i> Losses: 256</span>
-                        <span class="text-gray-400">Win Rate: 60%</span>
-                    </div>
-                    <div class="w-full bg-gray-700 rounded-full h-2">
-                        <div class="progress-bar h-2 rounded-full" style="width: 60%"></div>
-                    </div>
-                </div>
-            </div>
-        </div>
-
-        <!-- Battleground Stats -->
-        <div class="stat-card rounded-xl p-6">
-            <h3 class="text-2xl font-bold mb-6 flex items-center gap-2">
-                <i class="fas fa-flag text-red-500"></i> Battleground Statistics
-            </h3>
-            <div class="space-y-3">
-                <div class="flex justify-between items-center py-3 border-b border-gray-700">
-                    <div>
-                        <div class="font-medium">Warsong Gulch</div>
-                        <div class="text-sm text-gray-400">234 wins / 110 losses</div>
-                    </div>
-                    <div class="text-right">
-                        <div class="font-bold text-green-400 text-xl">68%</div>
-                        <div class="text-xs text-gray-400">Win Rate</div>
-                    </div>
-                </div>
-
-                <div class="flex justify-between items-center py-3 border-b border-gray-700">
-                    <div>
-                        <div class="font-medium">Arathi Basin</div>
-                        <div class="text-sm text-gray-400">198 wins / 111 losses</div>
-                    </div>
-                    <div class="text-right">
-                        <div class="font-bold text-green-400 text-xl">64%</div>
-                        <div class="text-xs text-gray-400">Win Rate</div>
-                    </div>
-                </div>
-
-                <div class="flex justify-between items-center py-3 border-b border-gray-700">
-                    <div>
-                        <div class="font-medium">Alterac Valley</div>
-                        <div class="text-sm text-gray-400">156 wins / 108 losses</div>
-                    </div>
-                    <div class="text-right">
-                        <div class="font-bold text-yellow-400 text-xl">59%</div>
-                        <div class="text-xs text-gray-400">Win Rate</div>
-                    </div>
-                </div>
-
-                <div class="flex justify-between items-center py-3 border-b border-gray-700">
-                    <div>
-                        <div class="font-medium">Eye of the Storm</div>
-                        <div class="text-sm text-gray-400">167 wins / 102 losses</div>
-                    </div>
-                    <div class="text-right">
-                        <div class="font-bold text-green-400 text-xl">62%</div>
-                        <div class="text-xs text-gray-400">Win Rate</div>
-                    </div>
-                </div>
-
-                <div class="flex justify-between items-center py-3">
-                    <div>
-                        <div class="font-medium">Strand of the Ancients</div>
-                        <div class="text-sm text-gray-400">143 wins / 58 losses</div>
-                    </div>
-                    <div class="text-right">
-                        <div class="font-bold text-green-400 text-xl">71%</div>
-                        <div class="text-xs text-gray-400">Win Rate</div>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </div>
-</div>
\ No newline at end of file
diff --git a/resources/views/armory/show.blade.php b/resources/views/armory/show.blade.php
deleted file mode 100644
index c70defd..0000000
--- a/resources/views/armory/show.blade.php
+++ /dev/null
@@ -1,117 +0,0 @@
-@extends('layouts.main')
-
-@section('content')
-<div class="hero-bg pt-32 pb-16 relative">
-    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 relative z-10">
-        <div class="flex items-start gap-8 flex-wrap lg:flex-nowrap">
-            <!-- Character Portrait -->
-            <div class="flex-shrink-0">
-                <div class="relative">
-                    <img src="https://wow.zamimg.com/images/wow/icons/large/achievement_character_{{ strtolower(App\Helpers\RealmHelper::getWoWConstant('race', $character->race)) }}_{{ strtolower($character->gender == 1 ? 'male' : 'female') }}.jpg" 
-                        alt="Character" class="w-48 h-48 rounded-2xl border-4 border-red-600 shadow-2xl">
-                    <div class="absolute -bottom-4 -right-4 bg-gradient-to-br from-yellow-500 to-orange-600 rounded-full w-20 h-20 flex items-center justify-center border-4 border-gray-900 shadow-xl">
-                        <span class="text-3xl font-bold">{{ $character->level ?? '??' }}</span>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Character Info -->
-            <div class="flex-1">
-                <div class="flex items-center gap-4 mb-4">
-                    <h1 class="text-6xl font-bold cinzel class-{{ strtolower(App\Helpers\RealmHelper::getWoWConstant('class', $character->class ?? 1)) }}">{{ $character->name ?? 'Unknown' }}</h1>
-                    <span class="px-4 py-2 {{ App\Helpers\RealmHelper::getFactionByRace($character->race ?? 1) === 'horde' ? 'bg-red-600' : 'bg-blue-600' }} rounded-lg font-bold text-lg">
-                        <i class="fas fa-fist-raised mr-2"></i> {{ strtoupper(App\Helpers\RealmHelper::getFactionByRace($character->race ?? 1)) }}
-                    </span>
-                </div>
-                
-                <div class="flex items-center gap-6 text-xl mb-6">
-                    <span class="flex items-center gap-2">
-                        <i class="fas fa-user text-red-400"></i> {{ App\Helpers\RealmHelper::getWoWConstant('race', $character->race ?? 1) }} / {{ App\Helpers\RealmHelper::getWoWConstant('class', $character->class ?? 1) }}
-                    </span>
-                    <span class="flex items-center gap-2">
-                        <i class="fas fa-server text-purple-400"></i> {{ App\Helpers\RealmHelper::find($realm)->name }}
-                    </span>
-                </div>
-
-                <!-- Guild -->
-                @if($guild && $memberRank)
-                <div class="guild-banner inline-block px-6 py-3 rounded-xl mb-6">
-                    <div class="flex items-center gap-3">
-                        <i class="fas fa-shield-alt text-2xl"></i>
-                        <div>
-                            <div class="text-sm text-purple-200">{{ $memberRank->rname ?? 'Member' }} of</div>
-                            <div class="text-xl font-bold">&lt;{{ $guild->name ?? 'Unknown Guild' }}&gt;</div>
-                        </div>
-                    </div>
-                </div>
-                @endif
-
-                <!-- Quick Stats -->
-                <div class="grid grid-cols-1 md:grid-cols-3 gap-4">
-                    <div class="stat-card p-4 rounded-xl">
-                        <div class="text-gray-400 text-sm mb-1">Item Level</div>
-                        <div class="text-3xl font-bold text-purple-400">{{ $promedItemLevel ?? '0' }}</div>
-                    </div>
-                    <div class="stat-card p-4 rounded-xl">
-                        <div class="text-gray-400 text-sm mb-1">Arena Rating</div>
-                        <div class="text-3xl font-bold text-purple-500">{{ $arenaTeam[0]['personalRating'] ?? '0' }}</div>
-                    </div>
-                    <div class="stat-card p-4 rounded-xl">
-                        <div class="text-gray-400 text-sm mb-1">Honorable Kills</div>
-                        <div class="text-3xl font-bold text-red-400">{{ $character->totalKills ?? '0' }}</div>
-                    </div>
-                </div>
-            </div>
-        </div>
-    </div>
-</div>
-<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8">
-    <!-- Tabs -->
-    <div class="mb-8 overflow-x-full">
-        <div class="flex gap-2 border-b border-gray-700 min-w-max">
-            <button class="tab-btn active px-8 py-4 font-bold rounded-t-lg" onclick="switchTab('equipment')">
-                <i class="fas fa-vest mr-2"></i> Equipment
-            </button>
-            <button class="tab-btn px-8 py-4 font-bold rounded-t-lg text-gray-400 hover:text-white hover:bg-gray-800" onclick="switchTab('achievements')">
-                <i class="fas fa-trophy mr-2"></i> Achievements
-            </button>
-            <button class="tab-btn px-8 py-4 font-bold rounded-t-lg text-gray-400 hover:text-white hover:bg-gray-800" onclick="switchTab('professions')">
-                <i class="fas fa-hammer mr-2"></i> Professions
-            </button>
-        </div>
-    </div>
-
-    @include('armory.partials.equipment', ['item' => $items ?? collect()])
-    @include('armory.partials.achievements', ['achievements' => $achievement ?? collect()])
-    @include('armory.partials.professions', ['skill' => $skill ?? collect()])
-</div>
-
-<script>
-    function switchTab(tabName) {
-        // Hide all tabs
-        document.querySelectorAll('.tab-content').forEach(tab => {
-            tab.classList.add('hidden');
-        });
-        
-        // Remove active class from all buttons
-        document.querySelectorAll('.tab-btn').forEach(btn => {
-            btn.classList.remove('active');
-            btn.classList.add('text-gray-400', 'hover:text-white', 'hover:bg-gray-800');
-        });
-        
-        // Show selected tab
-        document.getElementById(tabName + '-tab').classList.remove('hidden');
-        
-        // Add active class to clicked button
-        event.target.closest('.tab-btn').classList.add('active');
-        event.target.closest('.tab-btn').classList.remove('text-gray-400', 'hover:text-white', 'hover:bg-gray-800');
-    }
-    
-    const whTooltips = {
-        colorLinks: true,
-        iconizeLinks: true,
-        renameLinks: true
-    };
-</script>
-<script src="https://wow.zamimg.com/js/tooltips.js"></script>
-@endsection
\ No newline at end of file

From 42c3f52ed48653c45fa1f7761c696b643502faed Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 22 Feb 2026 19:24:43 +0100
Subject: [PATCH 083/132] feat(forum): implement forum module with index view
 and routing

- Add forum index view with enhanced UI and statistics
- Set up route for forum show page
- Update controller to use module-based view paths
- Replace config calls with settings helper in main layout
---
 .../Http/Controllers/ForumController.php      |   6 +-
 app/Modules/Forum/Http/routes.php             |   1 +
 .../Forum/Resources/views/index.blade.php     | 245 ++++++++++++
 .../Forum/Resources/views/show.blade.php      |   0
 resources/views/forums/index.blade.php        | 352 +++++++++++-------
 resources/views/layouts/main.blade.php        |   4 +-
 6 files changed, 466 insertions(+), 142 deletions(-)
 create mode 100644 app/Modules/Forum/Resources/views/index.blade.php
 create mode 100644 app/Modules/Forum/Resources/views/show.blade.php

diff --git a/app/Modules/Forum/Http/Controllers/ForumController.php b/app/Modules/Forum/Http/Controllers/ForumController.php
index 99e05d7..613b739 100644
--- a/app/Modules/Forum/Http/Controllers/ForumController.php
+++ b/app/Modules/Forum/Http/Controllers/ForumController.php
@@ -13,11 +13,7 @@ class ForumController extends Controller
     protected ForumService $forumService;
 
     protected array $views = [
-        'index'         => 'forums.index',
-        'forum'         => 'forums.forum',
-        'thread'        => 'forums.thread',
-        'create_thread' => 'forums.create_thread',
-        'create_post'   => 'forums.create_post',
+        'index'         => 'forum::index',
     ];
 
     public function __construct(ForumService $forumService)
diff --git a/app/Modules/Forum/Http/routes.php b/app/Modules/Forum/Http/routes.php
index fd607c4..125a740 100644
--- a/app/Modules/Forum/Http/routes.php
+++ b/app/Modules/Forum/Http/routes.php
@@ -6,4 +6,5 @@
     ->prefix(strtolower('Forum'))
     ->group(function () {
         Route::get('/', [\Modules\Forum\Http\Controllers\ForumController::class, 'index']);
+        Route::get('/{slug}', [\Modules\Forum\Http\Controllers\ForumController::class, 'forum'])->name('forum.show');
     });
\ No newline at end of file
diff --git a/app/Modules/Forum/Resources/views/index.blade.php b/app/Modules/Forum/Resources/views/index.blade.php
new file mode 100644
index 0000000..2a4f232
--- /dev/null
+++ b/app/Modules/Forum/Resources/views/index.blade.php
@@ -0,0 +1,245 @@
+@extends('layouts.main')
+
+@section('title', 'Forums')
+
+@section('content')
+<div class="min-h-screen bg-gradient-to-br from-gray-900 via-gray-800 to-gray-900">
+    <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-12">
+        {{-- Header Section --}}
+        <div class="mb-12">
+            <div class="flex items-center space-x-2 text-sm text-gray-400 mb-6">
+                <a href="{{ route('home') }}" class="hover:text-blue-400 transition-colors duration-200 flex items-center">
+                    <i class="fas fa-home mr-1"></i>
+                    <span>Home</span>
+                </a>
+                <svg class="w-4 h-4 text-gray-600" fill="currentColor" viewBox="0 0 20 20">
+                    <path fill-rule="evenodd" d="M7.293 14.707a1 1 0 010-1.414L10.586 10 7.293 6.707a1 1 0 011.414-1.414l4 4a1 1 0 010 1.414l-4 4a1 1 0 01-1.414 0z" clip-rule="evenodd"/>
+                </svg>
+                <span class="text-gray-300">Forums</span>
+            </div>
+
+            <div class="relative overflow-hidden rounded-2xl bg-gradient-to-r from-blue-900/40 via-gray-800/60 to-gray-900/40 backdrop-blur-sm border border-blue-500/20 shadow-2xl">
+                <div class="absolute inset-0 bg-gradient-to-r from-blue-600/5 to-purple-600/5 animate-pulse"></div>
+                <div class="relative px-8 py-10">
+                    <div class="flex flex-col lg:flex-row lg:items-center lg:justify-between">
+                        <div class="flex items-start space-x-6">
+                            <div class="relative">
+                                <div class="absolute -inset-1 bg-gradient-to-r from-blue-500 to-purple-500 rounded-full blur opacity-30"></div>
+                                <div class="relative bg-gray-800 p-4 rounded-full border-2 border-blue-400/30">
+                                    <i class="fas fa-comments text-3xl text-blue-400"></i>
+                                </div>
+                            </div>
+                            <div class="flex-1">
+                                <h1 class="text-5xl font-bold text-white mb-3 bg-gradient-to-r from-blue-400 to-purple-400 bg-clip-text text-transparent">
+                                    Community Forums
+                                </h1>
+                                <p class="text-gray-300 text-lg leading-relaxed max-w-2xl">
+                                    Connect, share, and learn with thousands of passionate members in our vibrant community.
+                                </p>
+                            </div>
+                        </div>
+                        <div class="mt-8 lg:mt-0">
+                            <div class="bg-gray-800/50 backdrop-blur-sm rounded-xl p-6 border border-gray-700/50 shadow-lg">
+                                <div class="flex items-center space-x-4">
+                                    <div class="relative">
+                                        <div class="absolute inset-0 bg-green-500 rounded-full animate-ping opacity-75"></div>
+                                        <div class="relative bg-green-500 w-3 h-3 rounded-full"></div>
+                                    </div>
+                                    <div class="text-gray-300">
+                                        <span class="text-green-400 font-bold text-xl">{{ App\Models\User::where('updated_at', '>=', now()->subMinutes(15))->count() }}</span>
+                                        <span class="text-sm ml-1">members online</span>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        {{-- Forum Categories --}}
+        <div class="space-y-8">
+            @foreach($categories as $category)
+            <div class="group">
+                <div class="relative overflow-hidden rounded-t-2xl bg-gradient-to-r from-blue-900/60 to-purple-900/40 backdrop-blur-sm border border-blue-500/30 shadow-lg">
+                    <div class="absolute inset-0 bg-gradient-to-r from-blue-600/10 to-purple-600/10 group-hover:from-blue-600/20 group-hover:to-purple-600/20 transition-all duration-500"></div>
+                    <div class="relative px-8 py-6">
+                        <div class="flex items-center space-x-4">
+                            <div class="relative">
+                                <div class="absolute -inset-1 bg-gradient-to-r from-blue-400 to-purple-400 rounded-lg blur opacity-25 group-hover:opacity-40 transition-opacity duration-300"></div>
+                                <div class="relative bg-gray-800 p-3 rounded-lg border border-blue-400/30">
+                                    <i class="fas fa-folder-open text-2xl text-blue-400"></i>
+                                </div>
+                            </div>
+                            <h2 class="text-2xl font-bold text-white group-hover:text-blue-300 transition-colors duration-300">
+                                {{ $category->name }}
+                            </h2>
+                            <div class="ml-auto">
+                                <span class="bg-blue-500/20 text-blue-300 px-4 py-2 rounded-full text-sm font-medium border border-blue-500/30">
+                                    {{ $category->subforums->count() }} {{ Str::plural('forum', $category->subforums->count()) }}
+                                </span>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <div class="bg-gray-800/40 backdrop-blur-sm rounded-b-2xl border border-t-0 border-gray-700/50 shadow-xl">
+                    <div class="divide-y divide-gray-700/30">
+                        @foreach($category->subforums as $forum)
+                        <div class="group/forum hover:bg-gray-800/60 transition-all duration-300 first:rounded-t-none last:rounded-b-xl">
+                            <div class="p-8">
+                                <div class="flex flex-col xl:flex-row xl:items-center xl:justify-between space-y-6 xl:space-y-0">
+                                    <div class="flex items-start space-x-6 flex-1">
+                                        <div class="relative flex-shrink-0">
+                                            <div class="absolute -inset-1 bg-gradient-to-r from-blue-500 to-purple-500 rounded-xl blur opacity-20 group-hover/forum:opacity-40 transition-opacity duration-300"></div>
+                                            <div class="relative bg-gray-700 p-4 rounded-xl border border-gray-600/50 group-hover/forum:border-blue-500/50 transition-colors duration-300">
+                                                <i class="fas fa-comments text-3xl text-blue-400 group-hover/forum:text-blue-300 transition-colors duration-300"></i>
+                                            </div>
+                                        </div>
+                                        <div class="flex-1">
+                                            <div class="flex items-center space-x-3 mb-3">
+                                                <a href="{{ route('forum.show', $forum->slug) }}" 
+                                                   class="text-2xl font-bold text-white hover:text-blue-400 transition-all duration-300 hover:translate-x-1 transform">
+                                                    {{ $forum->name }}
+                                                </a>
+                                                <span class="bg-gray-700 text-gray-300 px-3 py-1 rounded-full text-xs font-medium">
+                                                    {{ $forum->threads()->count() }} {{ Str::plural('thread', $forum->threads()->count()) }}
+                                                </span>
+                                            </div>
+                                            <p class="text-gray-400 leading-relaxed text-sm">
+                                                {{ $forum->description }}
+                                            </p>
+                                        </div>
+                                    </div>
+
+                                    <div class="xl:ml-8 xl:text-right">
+                                        @if($forum->latest_thread)
+                                        <div class="bg-gray-900/50 backdrop-blur-sm rounded-xl p-6 border border-gray-700/50 shadow-lg hover:shadow-xl transition-all duration-300">
+                                            <div class="flex items-start space-x-4 xl:flex-col xl:items-end xl:space-x-0 xl:space-y-2">
+                                                <div class="flex-1 xl:w-full">
+                                                    <div class="text-xs text-gray-500 mb-2">Latest Thread</div>
+                                                    <a href="{{ route('forums.thread', ['forumSlug' => $forum->slug, 'threadSlug' => $forum->latestThread->slug]) }}" 
+                                                       class="text-blue-400 hover:text-blue-300 font-semibold transition-colors duration-200 block">
+                                                        {{ Str::limit($forum->latestThread->title, 40) }}
+                                                    </a>
+                                                </div>
+                                                <div class="text-sm text-gray-400">
+                                                    <div class="flex items-center space-x-2 xl:justify-end">
+                                                        <img src="https://ui-avatars.com/api/?name={{ urlencode($forum->latestThread->user->name) }}&background=3B82F6&color=fff&size=32" 
+                                                             alt="{{ $forum->latestThread->user->name }}" 
+                                                             class="w-6 h-6 rounded-full">
+                                                        <span>by <span class="font-medium text-gray-300">{{ $forum->latestThread->user->name }}</span></span>
+                                                    </div>
+                                                    <div class="text-xs mt-1 xl:text-right">
+                                                        {{ $forum->latestThread->created_at->diffForHumans() }}
+                                                    </div>
+                                                </div>
+                                            </div>
+                                        </div>
+                                        @else
+                                        <div class="bg-gray-900/30 rounded-xl p-6 border border-dashed border-gray-700 text-center">
+                                            <i class="fas fa-comment-slash text-3xl text-gray-600 mb-3"></i>
+                                            <p class="text-gray-500 text-sm">No threads yet</p>
+                                            <p class="text-xs text-gray-600 mt-1">Be the first to start a discussion!</p>
+                                        </div>
+                                        @endif
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+                        @endforeach
+                    </div>
+                </div>
+            </div>
+            @endforeach
+        </div>
+
+        {{-- Statistics Section --}}
+        <div class="mt-16">
+            <div class="relative overflow-hidden rounded-2xl bg-gradient-to-br from-gray-800/60 via-gray-900/40 to-blue-900/30 backdrop-blur-sm border border-gray-700/50 shadow-2xl">
+                <div class="absolute inset-0">
+                    <div class="absolute inset-0 bg-gradient-to-r from-blue-600/5 to-purple-600/5"></div>
+                    <div class="absolute top-0 right-0 w-96 h-96 bg-blue-500/10 rounded-full filter blur-3xl"></div>
+                    <div class="absolute bottom-0 left-0 w-96 h-96 bg-purple-500/10 rounded-full filter blur-3xl"></div>
+                </div>
+                
+                <div class="relative px-8 py-12">
+                    <div class="text-center mb-12">
+                        <div class="inline-flex items-center space-x-4 mb-4">
+                            <div class="relative">
+                                <div class="absolute -inset-1 bg-gradient-to-r from-blue-400 to-purple-400 rounded-lg blur opacity-30"></div>
+                                <div class="relative bg-gray-800 p-4 rounded-lg border border-blue-400/30">
+                                    <i class="fas fa-chart-line text-3xl text-blue-400"></i>
+                                </div>
+                            </div>
+                            <div>
+                                <h2 class="text-3xl font-bold text-white">Community Statistics</h2>
+                                <p class="text-gray-400 mt-2">Our growing family by the numbers</p>
+                            </div>
+                        </div>
+                    </div>
+
+                    <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
+                        <div class="group/stat">
+                            <div class="relative overflow-hidden rounded-xl bg-gray-800/50 backdrop-blur-sm border border-gray-700/50 p-8 text-center hover:border-blue-500/50 transition-all duration-300 hover:shadow-xl hover:shadow-blue-500/10">
+                                <div class="absolute -top-8 -right-8 w-24 h-24 bg-blue-500/10 rounded-full filter blur-2xl group-hover/stat:bg-blue-500/20 transition-colors duration-300"></div>
+                                <div class="relative">
+                                    <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-blue-400 to-blue-600 bg-clip-text mb-2">
+                                        {{ number_format(App\Models\User::count()) }}
+                                    </div>
+                                    <div class="flex items-center justify-center space-x-2 text-gray-300">
+                                        <i class="fas fa-users text-blue-400"></i>
+                                        <span class="font-medium">Registered Members</span>
+                                    </div>
+                                    <div class="mt-4 text-xs text-gray-500">
+                                        <i class="fas fa-arrow-up text-green-400 mr-1"></i>
+                                        Growing every day
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+
+                        <div class="group/stat">
+                            <div class="relative overflow-hidden rounded-xl bg-gray-800/50 backdrop-blur-sm border border-gray-700/50 p-8 text-center hover:border-green-500/50 transition-all duration-300 hover:shadow-xl hover:shadow-green-500/10">
+                                <div class="absolute -top-8 -right-8 w-24 h-24 bg-green-500/10 rounded-full filter blur-2xl group-hover/stat:bg-green-500/20 transition-colors duration-300"></div>
+                                <div class="relative">
+                                    <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-green-400 to-green-600 bg-clip-text mb-2">
+                                        {{ number_format(App\Models\Thread::count()) }}
+                                    </div>
+                                    <div class="flex items-center justify-center space-x-2 text-gray-300">
+                                        <i class="fas fa-comments text-green-400"></i>
+                                        <span class="font-medium">Active Threads</span>
+                                    </div>
+                                    <div class="mt-4 text-xs text-gray-500">
+                                        <i class="fas fa-fire text-orange-400 mr-1"></i>
+                                        Full of discussions
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+
+                        <div class="group/stat">
+                            <div class="relative overflow-hidden rounded-xl bg-gray-800/50 backdrop-blur-sm border border-gray-700/50 p-8 text-center hover:border-purple-500/50 transition-all duration-300 hover:shadow-xl hover:shadow-purple-500/10">
+                                <div class="absolute -top-8 -right-8 w-24 h-24 bg-purple-500/10 rounded-full filter blur-2xl group-hover/stat:bg-purple-500/20 transition-colors duration-300"></div>
+                                <div class="relative">
+                                    <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-purple-400 to-purple-600 bg-clip-text mb-2">
+                                        {{ number_format(App\Models\Post::count()) }}
+                                    </div>
+                                    <div class="flex items-center justify-center space-x-2 text-gray-300">
+                                        <i class="fas fa-comment-dots text-purple-400"></i>
+                                        <span class="font-medium">Total Posts</span>
+                                    </div>
+                                    <div class="mt-4 text-xs text-gray-500">
+                                        <i class="fas fa-heart text-red-400 mr-1"></i>
+                                        Community contributions
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
+@endsection
\ No newline at end of file
diff --git a/app/Modules/Forum/Resources/views/show.blade.php b/app/Modules/Forum/Resources/views/show.blade.php
new file mode 100644
index 0000000..e69de29
diff --git a/resources/views/forums/index.blade.php b/resources/views/forums/index.blade.php
index 512c6fe..144f2d0 100755
--- a/resources/views/forums/index.blade.php
+++ b/resources/views/forums/index.blade.php
@@ -2,158 +2,240 @@
 
 @section('title', 'Forums')
 
-@section('styles')
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@tailwindcss/typography@0.5.0/dist/typography.min.css">
-<style>
-    .forum-card {
-        transition: all 0.3s ease;
-    }
-    .forum-card:hover {
-        transform: translateY(-2px);
-        box-shadow: 0 10px 25px -5px rgba(59, 130, 246, 0.1);
-    }
-    .category-header {
-        position: relative;
-        overflow: hidden;
-    }
-    .category-header::after {
-        content: '';
-        position: absolute;
-        top: 0;
-        right: 0;
-        width: 30%;
-        height: 100%;
-        background: linear-gradient(90deg, rgba(30, 58, 138, 0) 0%, rgba(30, 58, 138, 0.3) 100%);
-        pointer-events: none;
-    }
-    .stat-card {
-        transition: all 0.3s ease;
-    }
-    .stat-card:hover {
-        transform: translateY(-2px);
-        box-shadow: 0 8px 20px -5px rgba(59, 130, 246, 0.15);
-    }
-    .forum-icon {
-        transition: all 0.3s ease;
-    }
-    .forum-card:hover .forum-icon {
-        transform: scale(1.1);
-    }
-</style>
-@endsection
-
 @section('content')
-<div class="container mx-auto px-4 py-8">
-    <div class="mb-8">
-        <h1 class="text-4xl font-bold text-white mb-3 text-shadow">Community Forums</h1>
-        <div class="flex items-center text-gray-400 text-sm mb-6">
-            <a href="{{ route('home') }}" class="hover:text-blue-400 transition duration-200">Home</a>
-            <span class="mx-2 text-gray-600">&raquo;</span>
-            <span class="text-gray-300">Forums</span>
-        </div>
-        
-        <div class="bg-gradient-to-r from-gray-800 to-gray-750 rounded-lg p-5 border border-gray-700 shadow-lg">
-            <div class="flex flex-wrap items-center justify-between">
-                <div class="flex items-center space-x-4 mb-3 sm:mb-0">
-                    <div class="text-blue-400 bg-blue-900 bg-opacity-30 p-3 rounded-full">
-                        <i class="fas fa-info-circle text-xl"></i>
-                    </div>
-                    <div>
-                        <h3 class="text-white font-medium mb-1">Welcome to our community!</h3>
-                        <p class="text-gray-300">Join the discussion and connect with other members in our forums.</p>
+<div class="min-h-screen bg-gradient-to-br from-gray-900 via-gray-800 to-gray-900">
+    <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-12">
+        {{-- Header Section --}}
+        <div class="mb-12">
+            <div class="flex items-center space-x-2 text-sm text-gray-400 mb-6">
+                <a href="{{ route('home') }}" class="hover:text-blue-400 transition-colors duration-200 flex items-center">
+                    <i class="fas fa-home mr-1"></i>
+                    <span>Home</span>
+                </a>
+                <svg class="w-4 h-4 text-gray-600" fill="currentColor" viewBox="0 0 20 20">
+                    <path fill-rule="evenodd" d="M7.293 14.707a1 1 0 010-1.414L10.586 10 7.293 6.707a1 1 0 011.414-1.414l4 4a1 1 0 010 1.414l-4 4a1 1 0 01-1.414 0z" clip-rule="evenodd"/>
+                </svg>
+                <span class="text-gray-300">Forums</span>
+            </div>
+
+            <div class="relative overflow-hidden rounded-2xl bg-gradient-to-r from-blue-900/40 via-gray-800/60 to-gray-900/40 backdrop-blur-sm border border-blue-500/20 shadow-2xl">
+                <div class="absolute inset-0 bg-gradient-to-r from-blue-600/5 to-purple-600/5 animate-pulse"></div>
+                <div class="relative px-8 py-10">
+                    <div class="flex flex-col lg:flex-row lg:items-center lg:justify-between">
+                        <div class="flex items-start space-x-6">
+                            <div class="relative">
+                                <div class="absolute -inset-1 bg-gradient-to-r from-blue-500 to-purple-500 rounded-full blur opacity-30"></div>
+                                <div class="relative bg-gray-800 p-4 rounded-full border-2 border-blue-400/30">
+                                    <i class="fas fa-comments text-3xl text-blue-400"></i>
+                                </div>
+                            </div>
+                            <div class="flex-1">
+                                <h1 class="text-5xl font-bold text-white mb-3 bg-gradient-to-r from-blue-400 to-purple-400 bg-clip-text text-transparent">
+                                    Community Forums
+                                </h1>
+                                <p class="text-gray-300 text-lg leading-relaxed max-w-2xl">
+                                    Connect, share, and learn with thousands of passionate members in our vibrant community.
+                                </p>
+                            </div>
+                        </div>
+                        <div class="mt-8 lg:mt-0">
+                            <div class="bg-gray-800/50 backdrop-blur-sm rounded-xl p-6 border border-gray-700/50 shadow-lg">
+                                <div class="flex items-center space-x-4">
+                                    <div class="relative">
+                                        <div class="absolute inset-0 bg-green-500 rounded-full animate-ping opacity-75"></div>
+                                        <div class="relative bg-green-500 w-3 h-3 rounded-full"></div>
+                                    </div>
+                                    <div class="text-gray-300">
+                                        <span class="text-green-400 font-bold text-xl">{{ App\Models\User::where('updated_at', '>=', now()->subMinutes(15))->count() }}</span>
+                                        <span class="text-sm ml-1">members online</span>
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
                     </div>
                 </div>
-                <div class="flex items-center space-x-3 bg-gray-750 px-4 py-2 rounded-lg border border-gray-700">
-                    <span class="text-gray-300 text-sm font-medium flex items-center">
-                        <i class="fas fa-users mr-2 text-blue-400"></i> 
-                        <span class="text-blue-400 font-bold mr-1">{{ App\Models\User::where('updated_at', '>=', now()->subMinutes(15))->count() }}</span> online now
-                    </span>
-                </div>
             </div>
         </div>
-    </div>
 
-    @foreach($categories as $category)
-    <div class="bg-gray-800 rounded-lg shadow-xl mb-8 overflow-hidden border border-gray-700">
-        <div class="bg-gradient-to-r from-blue-900 to-gray-800 px-6 py-4 category-header">
-            <h2 class="text-xl font-bold text-white flex items-center">
-                <i class="fas fa-folder mr-3 text-blue-400"></i>
-                {{ $category->name }}
-            </h2>
-        </div>
-        
-        <div class="divide-y divide-gray-700">
-            @foreach($category->subforums as $forum)
-            <div class="p-5 hover:bg-gray-750 transition duration-300 forum-card">
-                <div class="flex flex-col md:flex-row md:items-center">
-                    <div class="text-blue-400 mr-5 mb-3 md:mb-0">
-                        <div class="w-12 h-12 rounded-full bg-gradient-to-br from-blue-900 to-blue-800 bg-opacity-30 flex items-center justify-center border border-blue-700 shadow-md forum-icon">
-                            <i class="fas fa-comments text-2xl"></i>
+        {{-- Forum Categories --}}
+        <div class="space-y-8">
+            @foreach($categories as $category)
+            <div class="group">
+                <div class="relative overflow-hidden rounded-t-2xl bg-gradient-to-r from-blue-900/60 to-purple-900/40 backdrop-blur-sm border border-blue-500/30 shadow-lg">
+                    <div class="absolute inset-0 bg-gradient-to-r from-blue-600/10 to-purple-600/10 group-hover:from-blue-600/20 group-hover:to-purple-600/20 transition-all duration-500"></div>
+                    <div class="relative px-8 py-6">
+                        <div class="flex items-center space-x-4">
+                            <div class="relative">
+                                <div class="absolute -inset-1 bg-gradient-to-r from-blue-400 to-purple-400 rounded-lg blur opacity-25 group-hover:opacity-40 transition-opacity duration-300"></div>
+                                <div class="relative bg-gray-800 p-3 rounded-lg border border-blue-400/30">
+                                    <i class="fas fa-folder-open text-2xl text-blue-400"></i>
+                                </div>
+                            </div>
+                            <h2 class="text-2xl font-bold text-white group-hover:text-blue-300 transition-colors duration-300">
+                                {{ $category->name }}
+                            </h2>
+                            <div class="ml-auto">
+                                <span class="bg-blue-500/20 text-blue-300 px-4 py-2 rounded-full text-sm font-medium border border-blue-500/30">
+                                    {{ $category->subforums->count() }} {{ Str::plural('forum', $category->subforums->count()) }}
+                                </span>
+                            </div>
                         </div>
                     </div>
-                    <div class="flex-grow mb-3 md:mb-0">
-                        <a href="{{ route('forums.show', $forum->slug) }}" class="text-xl font-semibold text-blue-400 hover:text-blue-300 transition duration-200 flex items-center">
-                            {{ $forum->name }}
-                            <span class="ml-2 text-xs bg-gray-700 text-gray-300 px-2 py-1 rounded-full">
-                                {{ $forum->threads()->count() }} {{ Str::plural('thread', $forum->threads()->count()) }}
-                            </span>
-                        </a>
-                        <p class="text-gray-400 text-sm mt-2">{{ $forum->description }}</p>
-                    </div>
-                    <div class="text-sm text-gray-400 md:text-right md:ml-4 bg-gradient-to-r from-gray-750 to-gray-700 rounded-lg p-3 border border-gray-700 shadow-md">
-                        @if($forum->latest_thread)
-                        <div class="flex items-center md:justify-end mb-1">
-                            <span class="text-gray-500 mr-2">Latest:</span>
-                            <a href="{{ route('forums.thread', ['forumSlug' => $forum->slug, 'threadSlug' => $forum->latestThread->slug]) }}" class="text-blue-400 hover:text-blue-300 transition duration-200 font-medium">
-                                {{ Str::limit($forum->latestThread->title, 30) }}
-                            </a>
-                        </div>
-                        <div class="flex items-center md:justify-end">
-                            <span class="text-gray-500 mr-2">by</span>
-                            <span class="font-medium">{{ $forum->latestThread->user->name }}</span>
-                            <span class="text-xs ml-2 text-gray-500">{{ $forum->latestThread->created_at->diffForHumans() }}</span>
-                        </div>
-                        @else
-                        <div class="text-center flex items-center justify-center text-gray-500">
-                            <i class="fas fa-comment-slash mr-2"></i> No threads yet
+                </div>
+
+                <div class="bg-gray-800/40 backdrop-blur-sm rounded-b-2xl border border-t-0 border-gray-700/50 shadow-xl">
+                    <div class="divide-y divide-gray-700/30">
+                        @foreach($category->subforums as $forum)
+                        <div class="group/forum hover:bg-gray-800/60 transition-all duration-300 first:rounded-t-none last:rounded-b-xl">
+                            <div class="p-8">
+                                <div class="flex flex-col xl:flex-row xl:items-center xl:justify-between space-y-6 xl:space-y-0">
+                                    <div class="flex items-start space-x-6 flex-1">
+                                        <div class="relative flex-shrink-0">
+                                            <div class="absolute -inset-1 bg-gradient-to-r from-blue-500 to-purple-500 rounded-xl blur opacity-20 group-hover/forum:opacity-40 transition-opacity duration-300"></div>
+                                            <div class="relative bg-gray-700 p-4 rounded-xl border border-gray-600/50 group-hover/forum:border-blue-500/50 transition-colors duration-300">
+                                                <i class="fas fa-comments text-3xl text-blue-400 group-hover/forum:text-blue-300 transition-colors duration-300"></i>
+                                            </div>
+                                        </div>
+                                        <div class="flex-1">
+                                            <div class="flex items-center space-x-3 mb-3">
+                                                <a href="{{ route('forums.show', $forum->slug) }}" 
+                                                   class="text-2xl font-bold text-white hover:text-blue-400 transition-all duration-300 hover:translate-x-1 transform">
+                                                    {{ $forum->name }}
+                                                </a>
+                                                <span class="bg-gray-700 text-gray-300 px-3 py-1 rounded-full text-xs font-medium">
+                                                    {{ $forum->threads()->count() }} {{ Str::plural('thread', $forum->threads()->count()) }}
+                                                </span>
+                                            </div>
+                                            <p class="text-gray-400 leading-relaxed text-sm">
+                                                {{ $forum->description }}
+                                            </p>
+                                        </div>
+                                    </div>
+
+                                    <div class="xl:ml-8 xl:text-right">
+                                        @if($forum->latest_thread)
+                                        <div class="bg-gray-900/50 backdrop-blur-sm rounded-xl p-6 border border-gray-700/50 shadow-lg hover:shadow-xl transition-all duration-300">
+                                            <div class="flex items-start space-x-4 xl:flex-col xl:items-end xl:space-x-0 xl:space-y-2">
+                                                <div class="flex-1 xl:w-full">
+                                                    <div class="text-xs text-gray-500 mb-2">Latest Thread</div>
+                                                    <a href="{{ route('forums.thread', ['forumSlug' => $forum->slug, 'threadSlug' => $forum->latestThread->slug]) }}" 
+                                                       class="text-blue-400 hover:text-blue-300 font-semibold transition-colors duration-200 block">
+                                                        {{ Str::limit($forum->latestThread->title, 40) }}
+                                                    </a>
+                                                </div>
+                                                <div class="text-sm text-gray-400">
+                                                    <div class="flex items-center space-x-2 xl:justify-end">
+                                                        <img src="https://ui-avatars.com/api/?name={{ urlencode($forum->latestThread->user->name) }}&background=3B82F6&color=fff&size=32" 
+                                                             alt="{{ $forum->latestThread->user->name }}" 
+                                                             class="w-6 h-6 rounded-full">
+                                                        <span>by <span class="font-medium text-gray-300">{{ $forum->latestThread->user->name }}</span></span>
+                                                    </div>
+                                                    <div class="text-xs mt-1 xl:text-right">
+                                                        {{ $forum->latestThread->created_at->diffForHumans() }}
+                                                    </div>
+                                                </div>
+                                            </div>
+                                        </div>
+                                        @else
+                                        <div class="bg-gray-900/30 rounded-xl p-6 border border-dashed border-gray-700 text-center">
+                                            <i class="fas fa-comment-slash text-3xl text-gray-600 mb-3"></i>
+                                            <p class="text-gray-500 text-sm">No threads yet</p>
+                                            <p class="text-xs text-gray-600 mt-1">Be the first to start a discussion!</p>
+                                        </div>
+                                        @endif
+                                    </div>
+                                </div>
+                            </div>
                         </div>
-                        @endif
+                        @endforeach
                     </div>
                 </div>
             </div>
             @endforeach
         </div>
-    </div>
-    @endforeach
 
-    <div class="mt-10 bg-gradient-to-r from-gray-800 to-gray-750 rounded-lg p-6 border border-gray-700 shadow-xl">
-        <div class="flex flex-col md:flex-row items-center justify-between">
-            <div class="flex items-center mb-6 md:mb-0">
-                <div class="text-blue-400 mr-4 bg-blue-900 bg-opacity-30 p-3 rounded-full border border-blue-800 shadow-md">
-                    <i class="fas fa-chart-bar text-2xl"></i>
+        {{-- Statistics Section --}}
+        <div class="mt-16">
+            <div class="relative overflow-hidden rounded-2xl bg-gradient-to-br from-gray-800/60 via-gray-900/40 to-blue-900/30 backdrop-blur-sm border border-gray-700/50 shadow-2xl">
+                <div class="absolute inset-0">
+                    <div class="absolute inset-0 bg-gradient-to-r from-blue-600/5 to-purple-600/5"></div>
+                    <div class="absolute top-0 right-0 w-96 h-96 bg-blue-500/10 rounded-full filter blur-3xl"></div>
+                    <div class="absolute bottom-0 left-0 w-96 h-96 bg-purple-500/10 rounded-full filter blur-3xl"></div>
                 </div>
-                <div>
-                    <h3 class="text-lg font-semibold text-white">Forum Statistics</h3>
-                    <p class="text-gray-400 text-sm">Join our growing community</p>
-                </div>
-            </div>
-            <div class="grid grid-cols-2 md:grid-cols-3 gap-6 text-center w-full md:w-auto">
-                <div class="bg-gradient-to-br from-gray-750 to-gray-700 rounded-lg p-4 border border-gray-700 shadow-md stat-card">
-                    <div class="text-3xl font-bold text-blue-400 mb-1">{{ App\Models\User::count() }}</div>
-                    <div class="text-gray-300 text-sm font-medium flex items-center justify-center">
-                        <i class="fas fa-users mr-2 text-blue-500"></i> Members
-                    </div>
-                </div>
-                <div class="bg-gradient-to-br from-gray-750 to-gray-700 rounded-lg p-4 border border-gray-700 shadow-md stat-card">
-                    <div class="text-3xl font-bold text-green-400 mb-1">{{ App\Models\Thread::count() }}</div>
-                    <div class="text-gray-300 text-sm font-medium flex items-center justify-center">
-                        <i class="fas fa-comments mr-2 text-green-500"></i> Threads
+                
+                <div class="relative px-8 py-12">
+                    <div class="text-center mb-12">
+                        <div class="inline-flex items-center space-x-4 mb-4">
+                            <div class="relative">
+                                <div class="absolute -inset-1 bg-gradient-to-r from-blue-400 to-purple-400 rounded-lg blur opacity-30"></div>
+                                <div class="relative bg-gray-800 p-4 rounded-lg border border-blue-400/30">
+                                    <i class="fas fa-chart-line text-3xl text-blue-400"></i>
+                                </div>
+                            </div>
+                            <div>
+                                <h2 class="text-3xl font-bold text-white">Community Statistics</h2>
+                                <p class="text-gray-400 mt-2">Our growing family by the numbers</p>
+                            </div>
+                        </div>
                     </div>
-                </div>
-                <div class="bg-gradient-to-br from-gray-750 to-gray-700 rounded-lg p-4 border border-gray-700 shadow-md stat-card">
-                    <div class="text-3xl font-bold text-purple-400 mb-1">{{ App\Models\Post::count() }}</div>
-                    <div class="text-gray-300 text-sm font-medium flex items-center justify-center">
-                        <i class="fas fa-comment-dots mr-2 text-purple-500"></i> Posts
+
+                    <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
+                        <div class="group/stat">
+                            <div class="relative overflow-hidden rounded-xl bg-gray-800/50 backdrop-blur-sm border border-gray-700/50 p-8 text-center hover:border-blue-500/50 transition-all duration-300 hover:shadow-xl hover:shadow-blue-500/10">
+                                <div class="absolute -top-8 -right-8 w-24 h-24 bg-blue-500/10 rounded-full filter blur-2xl group-hover/stat:bg-blue-500/20 transition-colors duration-300"></div>
+                                <div class="relative">
+                                    <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-blue-400 to-blue-600 bg-clip-text mb-2">
+                                        {{ number_format(App\Models\User::count()) }}
+                                    </div>
+                                    <div class="flex items-center justify-center space-x-2 text-gray-300">
+                                        <i class="fas fa-users text-blue-400"></i>
+                                        <span class="font-medium">Registered Members</span>
+                                    </div>
+                                    <div class="mt-4 text-xs text-gray-500">
+                                        <i class="fas fa-arrow-up text-green-400 mr-1"></i>
+                                        Growing every day
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+
+                        <div class="group/stat">
+                            <div class="relative overflow-hidden rounded-xl bg-gray-800/50 backdrop-blur-sm border border-gray-700/50 p-8 text-center hover:border-green-500/50 transition-all duration-300 hover:shadow-xl hover:shadow-green-500/10">
+                                <div class="absolute -top-8 -right-8 w-24 h-24 bg-green-500/10 rounded-full filter blur-2xl group-hover/stat:bg-green-500/20 transition-colors duration-300"></div>
+                                <div class="relative">
+                                    <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-green-400 to-green-600 bg-clip-text mb-2">
+                                        {{ number_format(App\Models\Thread::count()) }}
+                                    </div>
+                                    <div class="flex items-center justify-center space-x-2 text-gray-300">
+                                        <i class="fas fa-comments text-green-400"></i>
+                                        <span class="font-medium">Active Threads</span>
+                                    </div>
+                                    <div class="mt-4 text-xs text-gray-500">
+                                        <i class="fas fa-fire text-orange-400 mr-1"></i>
+                                        Full of discussions
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
+
+                        <div class="group/stat">
+                            <div class="relative overflow-hidden rounded-xl bg-gray-800/50 backdrop-blur-sm border border-gray-700/50 p-8 text-center hover:border-purple-500/50 transition-all duration-300 hover:shadow-xl hover:shadow-purple-500/10">
+                                <div class="absolute -top-8 -right-8 w-24 h-24 bg-purple-500/10 rounded-full filter blur-2xl group-hover/stat:bg-purple-500/20 transition-colors duration-300"></div>
+                                <div class="relative">
+                                    <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-purple-400 to-purple-600 bg-clip-text mb-2">
+                                        {{ number_format(App\Models\Post::count()) }}
+                                    </div>
+                                    <div class="flex items-center justify-center space-x-2 text-gray-300">
+                                        <i class="fas fa-comment-dots text-purple-400"></i>
+                                        <span class="font-medium">Total Posts</span>
+                                    </div>
+                                    <div class="mt-4 text-xs text-gray-500">
+                                        <i class="fas fa-heart text-red-400 mr-1"></i>
+                                        Community contributions
+                                    </div>
+                                </div>
+                            </div>
+                        </div>
                     </div>
                 </div>
             </div>
diff --git a/resources/views/layouts/main.blade.php b/resources/views/layouts/main.blade.php
index b60b0ed..36067f2 100644
--- a/resources/views/layouts/main.blade.php
+++ b/resources/views/layouts/main.blade.php
@@ -3,7 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>{{ config('app.name', 'NexusCMS') }} - @yield('title', 'World of Warcraft Private Server')</title>
+    <title>{{ settings('site_name') }} - @yield('title', 'World of Warcraft Private Server')</title>
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css">
     <link href="https://fonts.googleapis.com/css2?family=Cinzel:wght@400;700&family=Inter:wght@300;400;600&display=swap" rel="stylesheet">
     @vite(['resources/css/app.css', 'resources/js/app.js'])
@@ -19,7 +19,7 @@
                 <div class="flex items-center gap-8">
                     <div class="flex items-center gap-2">
                         <div class="rounded-lg flex items-center justify-center text-2xl font-bold shadow-lg shadow-red-900/50">
-                            {{ config('app.name', 'NexusCMS') }}
+                            {{ settings('site_name') }}
                         </div>
                     </div>
                     <div class="hidden md:flex gap-6">

From fe572b97ea04ad0a4bb5fced7cb3edb74f7ca456 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 22 Feb 2026 19:35:03 +0100
Subject: [PATCH 084/132] test: replace example tests with specific helper
 tests

- Remove generic ExampleTest.php files from both Unit and Feature directories
- Add comprehensive SettingsHelperTest with caching and database interactions
- Add extensive GeneralHelperTest covering reading time and social sharing functions
---
 tests/Feature/ExampleTest.php        | 19 --------
 tests/Feature/SettingsHelperTest.php | 45 ++++++++++++++++++
 tests/Unit/ExampleTest.php           | 16 -------
 tests/Unit/GeneralHelperTest.php     | 71 ++++++++++++++++++++++++++++
 4 files changed, 116 insertions(+), 35 deletions(-)
 delete mode 100755 tests/Feature/ExampleTest.php
 create mode 100644 tests/Feature/SettingsHelperTest.php
 delete mode 100755 tests/Unit/ExampleTest.php
 create mode 100644 tests/Unit/GeneralHelperTest.php

diff --git a/tests/Feature/ExampleTest.php b/tests/Feature/ExampleTest.php
deleted file mode 100755
index 8364a84..0000000
--- a/tests/Feature/ExampleTest.php
+++ /dev/null
@@ -1,19 +0,0 @@
-<?php
-
-namespace Tests\Feature;
-
-// use Illuminate\Foundation\Testing\RefreshDatabase;
-use Tests\TestCase;
-
-class ExampleTest extends TestCase
-{
-    /**
-     * A basic test example.
-     */
-    public function test_the_application_returns_a_successful_response(): void
-    {
-        $response = $this->get('/');
-
-        $response->assertStatus(200);
-    }
-}
diff --git a/tests/Feature/SettingsHelperTest.php b/tests/Feature/SettingsHelperTest.php
new file mode 100644
index 0000000..6ed9689
--- /dev/null
+++ b/tests/Feature/SettingsHelperTest.php
@@ -0,0 +1,45 @@
+<?php
+
+namespace Tests\Feature;
+
+use Tests\TestCase;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\Cache;
+use App\Modules\Admin\Domain\Models\Setting;
+
+class SettingsHelperTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_returns_setting_value(): void
+    {
+        Cache::forget('site_settings');
+
+        Setting::create([
+            'key' => 'site_name',
+            'value' => 'Corex Dev'
+        ]);
+
+        $this->assertEquals('Corex Dev', settings('site_name'));
+    }
+
+    public function test_returns_default_when_not_exists(): void
+    {
+        Cache::forget('site_settings');
+
+        $this->assertEquals('default', settings('unknown_key', 'default'));
+    }
+
+    public function test_returns_all_settings_when_no_key_provided(): void
+    {
+        Cache::forget('site_settings');
+
+        Setting::create(['key' => 'a', 'value' => '1']);
+        Setting::create(['key' => 'b', 'value' => '2']);
+
+        $all = settings();
+
+        $this->assertCount(2, $all);
+        $this->assertEquals('1', $all->get('a'));
+    }
+}
\ No newline at end of file
diff --git a/tests/Unit/ExampleTest.php b/tests/Unit/ExampleTest.php
deleted file mode 100755
index 5773b0c..0000000
--- a/tests/Unit/ExampleTest.php
+++ /dev/null
@@ -1,16 +0,0 @@
-<?php
-
-namespace Tests\Unit;
-
-use PHPUnit\Framework\TestCase;
-
-class ExampleTest extends TestCase
-{
-    /**
-     * A basic test example.
-     */
-    public function test_that_true_is_true(): void
-    {
-        $this->assertTrue(true);
-    }
-}
diff --git a/tests/Unit/GeneralHelperTest.php b/tests/Unit/GeneralHelperTest.php
new file mode 100644
index 0000000..35e7c3a
--- /dev/null
+++ b/tests/Unit/GeneralHelperTest.php
@@ -0,0 +1,71 @@
+<?php
+
+namespace Tests\Unit;
+
+use PHPUnit\Framework\TestCase;
+use App\Helpers\GeneralHelper;
+
+class GeneralHelperTest extends TestCase
+{
+    public function test_reading_time_calculates_correctly(): void
+    {
+        $text = str_repeat('word ', 400);
+
+        $minutes = GeneralHelper::readingTime($text);
+
+        $this->assertEquals(2, $minutes);
+    }
+
+    public function test_reading_time_returns_at_least_one(): void
+    {
+        $this->assertEquals(1, GeneralHelper::readingTime(''));
+    }
+
+    public function test_share_social_twitter(): void
+    {
+        $result = GeneralHelper::shareSocial(
+            'twitter',
+            'https://example.com',
+            'Test Title'
+        );
+
+        $this->assertStringContainsString('x.com/intent/tweet', $result['url']);
+        $this->assertEquals('fab fa-x', $result['icon']);
+    }
+
+    public function test_share_social_facebook(): void
+    {
+        $result = GeneralHelper::shareSocial(
+            'facebook',
+            'https://example.com',
+            'Test Title'
+        );
+
+        $this->assertStringContainsString('facebook.com/sharer/sharer.php', $result['url']);
+        $this->assertEquals('fab fa-facebook-f', $result['icon']);
+    }
+
+    public function test_share_social_pinterest(): void
+    {
+        $result = GeneralHelper::shareSocial(
+            'pinterest',
+            'https://example.com',
+            'Test Title'
+        );
+
+        $this->assertStringContainsString('pinterest.com/pin/create/button', $result['url']);
+        $this->assertEquals('fab fa-pinterest-p', $result['icon']);
+    }
+
+    public function test_share_social_reddit(): void
+    {
+        $result = GeneralHelper::shareSocial(
+            'reddit',
+            'https://example.com',
+            'Test Title'
+        );
+
+        $this->assertStringContainsString('www.reddit.com/submit', $result['url']);
+        $this->assertEquals('fab fa-reddit-alien', $result['icon']);
+    }
+}
\ No newline at end of file

From bd0b372c373fda4d9affe149caea6d95b2dfe9e2 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Mon, 23 Feb 2026 22:40:34 +0100
Subject: [PATCH 085/132] style(views): fix permission selection container
 heights

Change min-height to fixed height and add overflow-y-auto to ensure consistent container sizing and enable scrolling when many permissions are present.
---
 app/Modules/Admin/Resources/views/roles/create.blade.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/app/Modules/Admin/Resources/views/roles/create.blade.php b/app/Modules/Admin/Resources/views/roles/create.blade.php
index 8cf7904..8e9cd98 100644
--- a/app/Modules/Admin/Resources/views/roles/create.blade.php
+++ b/app/Modules/Admin/Resources/views/roles/create.blade.php
@@ -43,7 +43,7 @@
             <div class="p-6 grid grid-cols-1 lg:grid-cols-2 gap-6">
                 <div>
                     <h3 class="text-sm font-semibold text-gray-700 mb-2">Available Permissions</h3>
-                    <div id="available" class="min-h-[300px] p-3 border border-gray-200 rounded-lg bg-gray-50 flex flex-col gap-2">
+                    <div id="available" class="h-[300px] overflow-y-auto p-3 border border-gray-200 rounded-lg bg-gray-50 flex flex-col gap-2">
                         @foreach($permissions as $permission)
                             <div class="perm-item flex items-center justify-between p-2 bg-white border border-gray-200 rounded cursor-move"
                                  draggable="true"
@@ -61,7 +61,7 @@
                 </div>
                 <div>
                     <h3 class="text-sm font-semibold text-gray-700 mb-2">Role Permissions</h3>
-                    <div id="selected" class="min-h-[300px] p-3 border border-blue-300 rounded-lg bg-blue-50 flex flex-col gap-2">
+                    <div id="selected" class="h-[300px] overflow-y-auto p-3 border border-blue-300 rounded-lg bg-blue-50 flex flex-col gap-2">
                         <div class="text-sm text-blue-700" id="selected-empty">Drag permissions here to add them to the role</div>
                     </div>
                 </div>

From 369f5a94c2f8454d2dc86d1c0951e291c862dadd Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Mon, 23 Feb 2026 22:49:43 +0100
Subject: [PATCH 086/132] refactor(roles): simplify JS logic and fix
 drag-and-drop state

- Replace verbose if-else with ternary operator for empty state display
- Ensure hidden inputs are always updated after drop
- Reset dragging references to allow clearing the selected container
---
 .../Admin/Resources/views/roles/create.blade.php    | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/app/Modules/Admin/Resources/views/roles/create.blade.php b/app/Modules/Admin/Resources/views/roles/create.blade.php
index 8e9cd98..c94e2f8 100644
--- a/app/Modules/Admin/Resources/views/roles/create.blade.php
+++ b/app/Modules/Admin/Resources/views/roles/create.blade.php
@@ -66,6 +66,7 @@
                     </div>
                 </div>
             </div>
+
             <div class="p-6 border-t border-gray-200 flex items-center justify-end gap-3">
                 <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
                     Crear rol
@@ -87,11 +88,7 @@
     function updateHiddenInputs() {
         hiddenInputs.innerHTML = '';
         const names = Array.from(selected.querySelectorAll('.perm-item')).map(el => el.dataset.name);
-        if (names.length === 0) {
-            selectedEmpty.style.display = '';
-        } else {
-            selectedEmpty.style.display = 'none';
-        }
+        selectedEmpty.style.display = names.length === 0 ? '' : 'none';
         names.forEach(name => {
             const input = document.createElement('input');
             input.type = 'hidden';
@@ -123,11 +120,15 @@ function makeDraggable(container) {
         container.addEventListener('drop', (e) => {
             e.preventDefault();
             container.classList.remove('ring-2', 'ring-blue-300');
+            
             const dragging = available._dragging || selected._dragging;
             if (dragging && dragging.parentElement !== container) {
                 container.appendChild(dragging);
-                updateHiddenInputs();
             }
+
+            updateHiddenInputs();
+            available._dragging = null;
+            selected._dragging = null;
         });
     }
 

From 3d75e2a38466f7f8b4586111e5911c98dfcfc513 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Mon, 23 Feb 2026 22:58:32 +0100
Subject: [PATCH 087/132] fix(roles): improve permission selection UI and fix
 drag-drop behavior

- Replace min-height with fixed height and add overflow-y-auto for consistent scrollable containers
- Fix drag-drop by clearing dragging state after drop and ensuring proper drop effect
- Refactor empty state handling to dynamically create/remove placeholder element
- Prevent duplicate double-click listeners by cloning nodes and reattaching events
---
 .../Resources/views/roles/edit.blade.php      | 61 +++++++++++++------
 1 file changed, 44 insertions(+), 17 deletions(-)

diff --git a/app/Modules/Admin/Resources/views/roles/edit.blade.php b/app/Modules/Admin/Resources/views/roles/edit.blade.php
index 464820c..c10f422 100644
--- a/app/Modules/Admin/Resources/views/roles/edit.blade.php
+++ b/app/Modules/Admin/Resources/views/roles/edit.blade.php
@@ -44,7 +44,7 @@
             <div class="p-6 grid grid-cols-1 lg:grid-cols-2 gap-6">
                 <div>
                     <h3 class="text-sm font-semibold text-gray-700 mb-2">Available Permissions</h3>
-                    <div id="available" class="min-h-[300px] p-3 border border-gray-200 rounded-lg bg-gray-50 flex flex-col gap-2">
+                    <div id="available" class="h-[300px] overflow-y-auto p-3 border border-gray-200 rounded-lg bg-gray-50 flex flex-col gap-2">
                         @php
                             $selectedSet = collect($selected);
                         @endphp
@@ -67,7 +67,7 @@
                 </div>
                 <div>
                     <h3 class="text-sm font-semibold text-gray-700 mb-2">Role Permissions</h3>
-                    <div id="selected" class="min-h-[300px] p-3 border border-blue-300 rounded-lg bg-blue-50 flex flex-col gap-2">
+                    <div id="selected" class="h-[300px] overflow-y-auto p-3 border border-blue-300 rounded-lg bg-blue-50 flex flex-col gap-2">
                         @forelse($permissions as $permission)
                             @if($selectedSet->contains($permission->name))
                                 <div class="perm-item flex items-center justify-between p-2 bg-white border border-gray-200 rounded cursor-move"
@@ -108,24 +108,39 @@
     const available = document.getElementById('available');
     const selected = document.getElementById('selected');
     const hiddenInputs = document.getElementById('hidden-inputs');
-    const selectedEmpty = document.getElementById('selected-empty');
+    
+    function createEmptyPlaceholder() {
+        let placeholder = selected.querySelector('#selected-empty');
+        if (!placeholder) {
+            placeholder = document.createElement('div');
+            placeholder.id = 'selected-empty';
+            placeholder.className = 'text-sm text-blue-700';
+            placeholder.textContent = 'Drag permissions here to add them to the role';
+            selected.appendChild(placeholder);
+        }
+    }
 
     function updateHiddenInputs() {
         hiddenInputs.innerHTML = '';
-        const names = Array.from(selected.querySelectorAll('.perm-item')).map(el => el.dataset.name);
-        if (selectedEmpty) {
-            selectedEmpty.style.display = names.length === 0 ? '' : 'none';
-        }
-        names.forEach(name => {
+        const items = Array.from(selected.querySelectorAll('.perm-item'));
+        items.forEach(item => {
             const input = document.createElement('input');
             input.type = 'hidden';
             input.name = 'permissions[]';
-            input.value = name;
+            input.value = item.dataset.name;
             hiddenInputs.appendChild(input);
         });
+
+        // Mostrar placeholder si no hay permisos
+        if (items.length === 0) {
+            createEmptyPlaceholder();
+        } else {
+            const placeholder = selected.querySelector('#selected-empty');
+            if (placeholder) placeholder.remove();
+        }
     }
 
-    function makeDraggable(container) {
+    function enableDragAndDrop(container) {
         container.addEventListener('dragstart', (e) => {
             const target = e.target.closest('.perm-item');
             if (!target) return;
@@ -136,7 +151,6 @@ function makeDraggable(container) {
 
         container.addEventListener('dragover', (e) => {
             e.preventDefault();
-            e.dataTransfer.dropEffect = 'move';
             container.classList.add('ring-2', 'ring-blue-300');
         });
 
@@ -150,22 +164,35 @@ function makeDraggable(container) {
             const dragging = available._dragging || selected._dragging;
             if (dragging && dragging.parentElement !== container) {
                 container.appendChild(dragging);
-                updateHiddenInputs();
             }
+            available._dragging = null;
+            selected._dragging = null;
+            updateHiddenInputs();
+            enableDoubleClickAll();
         });
     }
 
-    makeDraggable(available);
-    makeDraggable(selected);
-
-    document.querySelectorAll('.perm-item').forEach(item => {
+    function enableDoubleClick(item) {
         item.addEventListener('dblclick', () => {
             const targetContainer = item.parentElement.id === 'available' ? selected : available;
             targetContainer.appendChild(item);
             updateHiddenInputs();
+            enableDoubleClickAll();
+        });
+    }
+
+    function enableDoubleClickAll() {
+        document.querySelectorAll('.perm-item').forEach(item => {
+            // Remueve listener anterior para evitar duplicados
+            item.replaceWith(item.cloneNode(true));
         });
-    });
+        document.querySelectorAll('.perm-item').forEach(enableDoubleClick);
+    }
+
+    enableDragAndDrop(available);
+    enableDragAndDrop(selected);
 
+    enableDoubleClickAll();
     updateHiddenInputs();
 });
 </script>

From a96c72cef625b2bb04fa8facac24b50ff4019775 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 13 Mar 2026 23:25:51 +0100
Subject: [PATCH 088/132] feat: Add backup and logging management features

- Created a new view for managing backups with functionality to create, download, and delete backups.
- Updated the admin layout to include a link to the backups management page.
- Added a new view for displaying system logs with filtering options for log files and levels.
- Implemented an AnalyticsService to gather and format analytics data, including visitor statistics and page views.
- Created migrations for analytics sessions and page views tables.
- Added a seeder for generating sample analytics data.
- Updated routes to track analytics for specific pages.
- Introduced middleware for tracking analytics across various routes.
- Added permissions for viewing analytics in the roles and permissions seeder.
---
 app/Helpers/SettingsHelper.php                |  12 +
 app/Http/Middleware/ModulePermission.php      |  19 --
 app/Http/Middleware/Permission.php            |  27 ++
 app/Http/Middleware/TrackAnalytics.php        | 168 +++++++++++
 app/Models/AnalyticsPageView.php              |  37 +++
 app/Models/AnalyticsSession.php               |  39 +++
 .../Http/Controllers/AnalyticsController.php  |  41 +++
 .../Http/Controllers/BackupController.php     | 181 ++++++++++++
 .../Admin/Http/Controllers/LogController.php  |  71 +++++
 app/Modules/Admin/Http/routes.php             |  12 +
 .../Resources/views/analytics/index.blade.php | 163 +++++++++++
 .../Resources/views/backups/index.blade.php   | 137 +++++++++
 .../Resources/views/layouts/app.blade.php     |   4 +-
 .../Resources/views/logs/index.blade.php      | 178 ++++++++++++
 app/Services/AnalyticsService.php             | 263 ++++++++++++++++++
 bootstrap/app.php                             |   3 +-
 ...000000_create_analytics_sessions_table.php |  37 +++
 ...0001_create_analytics_page_views_table.php |  37 +++
 database/seeders/AnalyticsSeeder.php          |  76 +++++
 .../seeders/RolesAndPermissionsSeeder.php     |   2 +-
 routes/web.php                                |   8 +-
 21 files changed, 1488 insertions(+), 27 deletions(-)
 delete mode 100644 app/Http/Middleware/ModulePermission.php
 create mode 100644 app/Http/Middleware/Permission.php
 create mode 100644 app/Http/Middleware/TrackAnalytics.php
 create mode 100644 app/Models/AnalyticsPageView.php
 create mode 100644 app/Models/AnalyticsSession.php
 create mode 100644 app/Modules/Admin/Http/Controllers/AnalyticsController.php
 create mode 100644 app/Modules/Admin/Http/Controllers/BackupController.php
 create mode 100644 app/Modules/Admin/Http/Controllers/LogController.php
 create mode 100644 app/Modules/Admin/Resources/views/analytics/index.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/backups/index.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/logs/index.blade.php
 create mode 100644 app/Services/AnalyticsService.php
 create mode 100644 database/migrations/2026_03_12_000000_create_analytics_sessions_table.php
 create mode 100644 database/migrations/2026_03_12_000001_create_analytics_page_views_table.php
 create mode 100644 database/seeders/AnalyticsSeeder.php

diff --git a/app/Helpers/SettingsHelper.php b/app/Helpers/SettingsHelper.php
index 2e2b52c..3e6f64d 100644
--- a/app/Helpers/SettingsHelper.php
+++ b/app/Helpers/SettingsHelper.php
@@ -3,6 +3,18 @@
 use App\Modules\Admin\Domain\Models\Setting;
 use Illuminate\Support\Facades\Cache;
 
+if (!function_exists('formatBytes')) {
+    function formatBytes(int $bytes, int $precision = 2): string
+    {
+        $units = ['B', 'KB', 'MB', 'GB', 'TB'];
+        $bytes = max($bytes, 0);
+        $pow = $bytes > 0 ? floor(log($bytes, 1024)) : 0;
+        $pow = min($pow, count($units) - 1);
+
+        return round($bytes / (1024 ** $pow), $precision) . ' ' . $units[$pow];
+    }
+}
+
 if (!function_exists('settings')) {
     /**
      * Get a setting value or all settings.
diff --git a/app/Http/Middleware/ModulePermission.php b/app/Http/Middleware/ModulePermission.php
deleted file mode 100644
index a70ff65..0000000
--- a/app/Http/Middleware/ModulePermission.php
+++ /dev/null
@@ -1,19 +0,0 @@
-<?php
-
-namespace App\Http\Middleware;
-
-use Closure;
-use Illuminate\Http\Request;
-use Symfony\Component\HttpFoundation\Response;
-
-class ModulePermission
-{
-    public function handle(Request $request, Closure $next, string $permission): Response
-    {
-        if (! $request->user()?->can($permission)) {
-            abort(403);
-        }
-
-        return $next($request);
-    }
-}
diff --git a/app/Http/Middleware/Permission.php b/app/Http/Middleware/Permission.php
new file mode 100644
index 0000000..1117555
--- /dev/null
+++ b/app/Http/Middleware/Permission.php
@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class Permission
+{
+    public function handle(Request $request, Closure $next, ...$permissions)
+    {
+        $user = $request->user();
+
+        if (!$user) {
+            return redirect()->route('login');
+        }
+
+        foreach ($permissions as $permission) {
+            if ($user->hasPermissionTo($permission)) {
+                return $next($request);
+            }
+        }
+
+        abort(403, 'You don`t have permissions.');
+    }
+}
\ No newline at end of file
diff --git a/app/Http/Middleware/TrackAnalytics.php b/app/Http/Middleware/TrackAnalytics.php
new file mode 100644
index 0000000..9a14b10
--- /dev/null
+++ b/app/Http/Middleware/TrackAnalytics.php
@@ -0,0 +1,168 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Http;
+use App\Models\AnalyticsSession;
+use App\Models\AnalyticsPageView;
+use Symfony\Component\HttpFoundation\Response;
+
+class TrackAnalytics
+{
+    /**
+     * Handle an incoming request.
+     */
+    public function handle(Request $request, Closure $next): Response
+    {
+        $response = $next($request);
+
+        // Don't track admin panel, API, or debug bar requests
+        if ($this->shouldTrack($request)) {
+            [$visitorId, $isNew] = $this->getOrCreateVisitorId($request);
+            $this->trackPageView($request, $visitorId);
+
+            if ($isNew) {
+                $response->headers->setCookie(
+                    cookie('analytics_visitor_id', $visitorId, 60 * 24 * 365, '/', null, false, true)
+                );
+            }
+        }
+
+        return $response;
+    }
+
+    /**
+     * Determine if the request should be tracked
+     */
+    protected function shouldTrack(Request $request): bool
+    {
+        // Skip admin routes, API routes, and static assets
+        $path = $request->path();
+
+        $skipPaths = [
+            'acp',  // Admin control panel
+            'api',  // API routes
+            'admin',
+        ];
+
+        foreach ($skipPaths as $skipPath) {
+            if (str_starts_with($path, $skipPath)) {
+                return false;
+            }
+        }
+
+        // Skip if user agent is a bot
+        if ($this->isBot($request->userAgent())) {
+            return false;
+        }
+
+        return true;
+    }
+
+    /**
+     * Track a page view
+     */
+    protected function trackPageView(Request $request, string $visitorId): void
+    {
+        try {
+            // visitorId is passed in from handle()
+
+            // Get or create session
+            $session = AnalyticsSession::firstOrCreate(
+                ['visitor_id' => $visitorId],
+                [
+                    'ip_address' => $request->ip(),
+                    'user_agent' => $request->userAgent(),
+                    'is_bot' => $this->isBot($request->userAgent()),
+                ]
+            );
+
+            // Increment page views count
+            $session->increment('page_views');
+            $session->touch('updated_at');
+
+            // Create page view record
+            AnalyticsPageView::create([
+                'session_id' => $session->id,
+                'page_url' => $request->path(),
+                'page_title' => $this->getPageTitle($request),
+                'referrer' => $request->headers->get('referer'),
+                'time_on_page' => 0, // Will be updated on next page view
+                'bounced' => false,
+            ]);
+        } catch (\Exception $e) {
+            // Silently fail - analytics tracking shouldn't break the app
+            \Log::debug('Analytics tracking failed: ' . $e->getMessage());
+        }
+    }
+
+    /**
+     * Get or create a visitor ID from cookie.
+     * Returns [visitorId, isNew].
+     */
+    protected function getOrCreateVisitorId(Request $request): array
+    {
+        $visitorId = $request->cookie('analytics_visitor_id');
+
+        if ($visitorId) {
+            return [$visitorId, false];
+        }
+
+        $visitorId = 'visitor_' . bin2hex(random_bytes(16));
+        return [$visitorId, true];
+    }
+
+    /**
+     * Get page title from request
+     */
+    protected function getPageTitle(Request $request): string
+    {
+        // Try to extract title from route
+        $route = $request->route();
+
+        if ($route && $route->getName()) {
+            return ucwords(str_replace('.', ' ', $route->getName()));
+        }
+
+        // Fallback to path
+        return ucwords(str_replace('/', ' ', trim($request->path(), '/'))) ?: 'Home';
+    }
+
+    /**
+     * Check if user agent is a bot
+     */
+    protected function isBot(string $userAgent): bool
+    {
+        $botPatterns = [
+            'bot',
+            'crawler',
+            'spider',
+            'scraper',
+            'curl',
+            'wget',
+            'python',
+            'java',
+            'perl',
+            'ruby',
+            'google',
+            'bing',
+            'yandex',
+            'baidu',
+            'facebook',
+            'twitter',
+            'linkedin',
+        ];
+
+        $userAgent = strtolower($userAgent);
+
+        foreach ($botPatterns as $pattern) {
+            if (str_contains($userAgent, $pattern)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+}
diff --git a/app/Models/AnalyticsPageView.php b/app/Models/AnalyticsPageView.php
new file mode 100644
index 0000000..6caeb1a
--- /dev/null
+++ b/app/Models/AnalyticsPageView.php
@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class AnalyticsPageView extends Model
+{
+    use HasFactory;
+
+    protected $table = 'analytics_page_views';
+
+    protected $fillable = [
+        'session_id',
+        'page_url',
+        'page_title',
+        'referrer',
+        'time_on_page',
+        'bounced',
+    ];
+
+    protected $casts = [
+        'bounced' => 'boolean',
+        'created_at' => 'datetime',
+        'updated_at' => 'datetime',
+    ];
+
+    /**
+     * Get the session this page view belongs to
+     */
+    public function session(): BelongsTo
+    {
+        return $this->belongsTo(AnalyticsSession::class, 'session_id');
+    }
+}
diff --git a/app/Models/AnalyticsSession.php b/app/Models/AnalyticsSession.php
new file mode 100644
index 0000000..10adc8d
--- /dev/null
+++ b/app/Models/AnalyticsSession.php
@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class AnalyticsSession extends Model
+{
+    use HasFactory;
+
+    protected $table = 'analytics_sessions';
+
+    protected $fillable = [
+        'visitor_id',
+        'ip_address',
+        'user_agent',
+        'country',
+        'city',
+        'duration_seconds',
+        'page_views',
+        'is_bot',
+    ];
+
+    protected $casts = [
+        'is_bot' => 'boolean',
+        'created_at' => 'datetime',
+        'updated_at' => 'datetime',
+    ];
+
+    /**
+     * Get the page views for this session
+     */
+    public function pageViews(): HasMany
+    {
+        return $this->hasMany(AnalyticsPageView::class, 'session_id');
+    }
+}
diff --git a/app/Modules/Admin/Http/Controllers/AnalyticsController.php b/app/Modules/Admin/Http/Controllers/AnalyticsController.php
new file mode 100644
index 0000000..b560d95
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/AnalyticsController.php
@@ -0,0 +1,41 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Services\AnalyticsService;
+use Illuminate\Http\Request;
+
+class AnalyticsController extends Controller
+{
+    protected AnalyticsService $analyticsService;
+
+    public function __construct(AnalyticsService $analyticsService)
+    {
+        $this->analyticsService = $analyticsService;
+    }
+
+    /**
+     * Display the analytics dashboard
+     */
+    public function index(Request $request)
+    {
+        $period = $request->query('period', '30d');
+        $startDate = $this->analyticsService->getStartDate($period);
+
+        $totalVisitors = $this->analyticsService->getTotalVisitors($startDate);
+        $pageViews = $this->analyticsService->getPageViews($startDate);
+        $avgSessionDuration = $this->analyticsService->getAverageSessionDuration($startDate);
+        $bounceRate = $this->analyticsService->getBounceRate($startDate);
+        $topPages = $this->analyticsService->getTopPages($startDate);
+
+        return view('admin::analytics.index', compact(
+            'topPages',
+            'totalVisitors',
+            'pageViews',
+            'avgSessionDuration',
+            'bounceRate',
+            'period'
+        ));
+    }
+}
diff --git a/app/Modules/Admin/Http/Controllers/BackupController.php b/app/Modules/Admin/Http/Controllers/BackupController.php
new file mode 100644
index 0000000..8fec4df
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/BackupController.php
@@ -0,0 +1,181 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\DB;
+use Symfony\Component\Process\Process;
+use ZipArchive;
+
+class BackupController extends Controller
+{
+    protected string $backupPath;
+
+    public function __construct()
+    {
+        $this->backupPath = storage_path('app/backups');
+    }
+
+    public function index()
+    {
+        File::ensureDirectoryExists($this->backupPath);
+
+        $backups = collect(File::glob($this->backupPath . '/backup-*.zip'))
+            ->map(function ($file) {
+                return [
+                    'filename' => basename($file),
+                    'size' => File::size($file),
+                    'date' => File::lastModified($file),
+                ];
+            })
+            ->sortByDesc('date')
+            ->values();
+
+        $totalSize = $backups->sum('size');
+        $latestBackup = $backups->first();
+
+        return view('admin::backups.index', compact('backups', 'totalSize', 'latestBackup'));
+    }
+
+    public function create()
+    {
+        File::ensureDirectoryExists($this->backupPath);
+
+        $timestamp = now()->format('Y-m-d-His');
+        $filename = "backup-{$timestamp}.zip";
+        $zipPath = $this->backupPath . '/' . $filename;
+        $tempDir = storage_path("app/backup-temp-{$timestamp}");
+
+        try {
+            File::ensureDirectoryExists($tempDir);
+
+            // Database dump
+            $this->dumpDatabase($tempDir);
+
+            // Create ZIP
+            $zip = new ZipArchive();
+            if ($zip->open($zipPath, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== true) {
+                throw new \RuntimeException('Could not create ZIP archive.');
+            }
+
+            // Add DB dump
+            $dumpFile = $tempDir . '/database.sql';
+            if (File::exists($dumpFile)) {
+                $zip->addFile($dumpFile, 'database.sql');
+            }
+
+            // Add .env
+            $envPath = base_path('.env');
+            if (File::exists($envPath)) {
+                $zip->addFile($envPath, '.env');
+            }
+
+            // Add config files
+            $this->addDirectoryToZip($zip, config_path(), 'config');
+
+            // Add migrations
+            $this->addDirectoryToZip($zip, database_path('migrations'), 'migrations');
+
+            // Add public uploads
+            $publicStorage = storage_path('app/public');
+            if (File::isDirectory($publicStorage)) {
+                $this->addDirectoryToZip($zip, $publicStorage, 'storage/public');
+            }
+
+            $zip->close();
+
+            // Cleanup temp
+            File::deleteDirectory($tempDir);
+
+            return redirect()->route('admin.backups.index')
+                ->with('success', "Backup '{$filename}' created successfully.");
+
+        } catch (\Exception $e) {
+            File::deleteDirectory($tempDir);
+            if (File::exists($zipPath)) {
+                File::delete($zipPath);
+            }
+
+            return redirect()->route('admin.backups.index')
+                ->with('error', 'Backup failed: ' . $e->getMessage());
+        }
+    }
+
+    public function download(string $filename)
+    {
+        if (!preg_match('/^backup-[\d-]+\.zip$/', $filename)) {
+            abort(403);
+        }
+
+        $path = $this->backupPath . '/' . $filename;
+
+        if (!File::exists($path)) {
+            abort(404);
+        }
+
+        return response()->download($path);
+    }
+
+    public function destroy(string $filename)
+    {
+        if (!preg_match('/^backup-[\d-]+\.zip$/', $filename)) {
+            abort(403);
+        }
+
+        $path = $this->backupPath . '/' . $filename;
+
+        if (!File::exists($path)) {
+            abort(404);
+        }
+
+        File::delete($path);
+
+        return redirect()->route('admin.backups.index')
+            ->with('success', "Backup '{$filename}' deleted successfully.");
+    }
+
+    protected function dumpDatabase(string $targetDir): void
+    {
+        $connection = config('database.default');
+        $config = config("database.connections.{$connection}");
+
+        if ($config['driver'] !== 'mysql') {
+            return;
+        }
+
+        $dumpFile = $targetDir . '/database.sql';
+
+        $process = new Process([
+            'mysqldump',
+            '--host=' . $config['host'],
+            '--port=' . ($config['port'] ?? 3306),
+            '--user=' . $config['username'],
+            '--password=' . $config['password'],
+            $config['database'],
+        ]);
+
+        $process->setTimeout(300);
+        $process->run();
+
+        if ($process->isSuccessful()) {
+            File::put($dumpFile, $process->getOutput());
+        } else {
+            throw new \RuntimeException('Database dump failed: ' . $process->getErrorOutput());
+        }
+    }
+
+    protected function addDirectoryToZip(ZipArchive $zip, string $directory, string $prefix): void
+    {
+        if (!File::isDirectory($directory)) {
+            return;
+        }
+
+        $files = File::allFiles($directory);
+        foreach ($files as $file) {
+            $relativePath = $prefix . '/' . $file->getRelativePathname();
+            $zip->addFile($file->getRealPath(), str_replace('\\', '/', $relativePath));
+        }
+    }
+}
diff --git a/app/Modules/Admin/Http/Controllers/LogController.php b/app/Modules/Admin/Http/Controllers/LogController.php
new file mode 100644
index 0000000..88cc185
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/LogController.php
@@ -0,0 +1,71 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\File;
+
+class LogController extends Controller
+{
+    public function index(Request $request)
+    {
+        $logPath = storage_path('logs');
+        $logFiles = collect(File::glob($logPath . '/laravel*.log'))
+            ->map(fn($file) => basename($file))
+            ->sortDesc()
+            ->values();
+
+        $selectedFile = $request->get('file', $logFiles->first());
+
+        if ($selectedFile && !preg_match('/^laravel[a-zA-Z0-9\-_.]*\.log$/', $selectedFile)) {
+            abort(403);
+        }
+
+        $entries = collect();
+        $filePath = $logPath . '/' . $selectedFile;
+
+        if ($selectedFile && File::exists($filePath)) {
+            $content = File::get($filePath);
+            $pattern = '/\[(\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}\.?\d*\+?\d*:?\d*)\]\s+\w+\.(\w+):\s(.*?)(?=\[\d{4}-\d{2}-\d{2}[T ]|\z)/s';
+
+            preg_match_all($pattern, $content, $matches, PREG_SET_ORDER);
+
+            $entries = collect($matches)->map(function ($match) {
+                return [
+                    'timestamp' => $match[1],
+                    'level' => strtolower($match[2]),
+                    'message' => trim($match[3]),
+                ];
+            })->reverse()->values();
+        }
+
+        $levelFilter = $request->get('level');
+        if ($levelFilter) {
+            $entries = $entries->where('level', $levelFilter)->values();
+        }
+
+        $searchQuery = $request->get('search');
+        if ($searchQuery) {
+            $entries = $entries->filter(function ($entry) use ($searchQuery) {
+                return stripos($entry['message'], $searchQuery) !== false;
+            })->values();
+        }
+
+        $page = (int) $request->get('page', 1);
+        $perPage = 25;
+        $total = $entries->count();
+        $entries = $entries->slice(($page - 1) * $perPage, $perPage)->values();
+
+        return view('admin::logs.index', compact(
+            'logFiles',
+            'selectedFile',
+            'entries',
+            'levelFilter',
+            'searchQuery',
+            'page',
+            'perPage',
+            'total',
+        ));
+    }
+}
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index bab56df..70b082b 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -25,6 +25,18 @@
         Route::put('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'update'])->middleware('permission:manage.admin.users')->name('admin.users.update');
         Route::delete('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'destroy'])->middleware('permission:manage.admin.users')->name('admin.users.destroy');
     
+        // Logs
+        Route::get('/logs', [\Modules\Admin\Http\Controllers\LogController::class, 'index'])->middleware('permission:view.logs')->name('admin.logs.index');
+
+        // Analytics
+        Route::get('/analytics', [\Modules\Admin\Http\Controllers\AnalyticsController::class, 'index'])->name('admin.analytics.index');
+
+        // Backups
+        Route::get('/backups', [\Modules\Admin\Http\Controllers\BackupController::class, 'index'])->middleware('permission:manage.backups')->name('admin.backups.index');
+        Route::post('/backups', [\Modules\Admin\Http\Controllers\BackupController::class, 'create'])->middleware('permission:manage.backups')->name('admin.backups.create');
+        Route::get('/backups/{filename}/download', [\Modules\Admin\Http\Controllers\BackupController::class, 'download'])->middleware('permission:manage.backups')->name('admin.backups.download');
+        Route::delete('/backups/{filename}', [\Modules\Admin\Http\Controllers\BackupController::class, 'destroy'])->middleware('permission:manage.backups')->name('admin.backups.destroy');
+
         // Settings
         Route::get('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'index'])->middleware('permission:manage.settings')->name('admin.settings.index');
         Route::post('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'store'])->middleware('permission:manage.settings')->name('admin.settings.store');
diff --git a/app/Modules/Admin/Resources/views/analytics/index.blade.php b/app/Modules/Admin/Resources/views/analytics/index.blade.php
new file mode 100644
index 0000000..21900c2
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/analytics/index.blade.php
@@ -0,0 +1,163 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Analytics')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">Analytics</h1>
+    </div>
+    <div class="flex items-center gap-3">
+        <select class="px-4 py-2 border border-gray-300 rounded-lg text-sm font-medium text-gray-700 hover:border-gray-400 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+            <option value="7d">Last 7 Days</option>
+            <option value="30d" selected>Last 30 Days</option>
+            <option value="90d">Last 90 Days</option>
+            <option value="1y">Last Year</option>
+        </select>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    {{-- Flash Messages --}}
+    @if(session('success'))
+        <div class="mb-6 p-4 bg-green-50 border-l-4 border-green-500 rounded-lg flex items-center gap-3">
+            <i class="fas fa-check-circle text-green-600"></i>
+            <p class="text-green-700 text-sm font-medium">{{ session('success') }}</p>
+        </div>
+    @endif
+
+    @if(session('error'))
+        <div class="mb-6 p-4 bg-red-50 border-l-4 border-red-500 rounded-lg flex items-center gap-3">
+            <i class="fas fa-exclamation-circle text-red-600"></i>
+            <p class="text-red-700 text-sm font-medium">{{ session('error') }}</p>
+        </div>
+    @endif
+
+    {{-- Key Metrics --}}
+    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4 mb-6">
+        {{-- Total Visitors --}}
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4 hover:shadow-md transition-shadow">
+            <div class="w-10 h-10 bg-blue-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-users text-blue-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Total Visitors</p>
+                <p class="text-2xl font-bold text-gray-800">{{ $totalVisitors ?? 0 }}</p>
+                <p class="text-xs text-green-600 mt-1"><i class="fas fa-arrow-up"></i> +12.5%</p>
+            </div>
+        </div>
+
+        {{-- Page Views --}}
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4 hover:shadow-md transition-shadow">
+            <div class="w-10 h-10 bg-purple-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-eye text-purple-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Page Views</p>
+                <p class="text-2xl font-bold text-gray-800">{{ $pageViews ?? 0 }}</p>
+                <p class="text-xs text-green-600 mt-1"><i class="fas fa-arrow-up"></i> +8.3%</p>
+            </div>
+        </div>
+
+        {{-- Average Session Duration --}}
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4 hover:shadow-md transition-shadow">
+            <div class="w-10 h-10 bg-orange-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-clock text-orange-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Avg. Session Duration</p>
+                <p class="text-2xl font-bold text-gray-800">{{ $avgSessionDuration ?? '0:00' }}</p>
+                <p class="text-xs text-red-600 mt-1"><i class="fas fa-arrow-down"></i> -2.1%</p>
+            </div>
+        </div>
+
+        {{-- Bounce Rate --}}
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4 hover:shadow-md transition-shadow">
+            <div class="w-10 h-10 bg-red-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-sign-out-alt text-red-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Bounce Rate</p>
+                <p class="text-2xl font-bold text-gray-800">{{ $bounceRate ?? '0' }}%</p>
+                <p class="text-xs text-green-600 mt-1"><i class="fas fa-arrow-down"></i> -3.2%</p>
+            </div>
+        </div>
+    </div>
+
+    {{-- Top Pages --}}
+    <div class="bg-white rounded-lg shadow mb-6">
+        <div class="p-6 border-b border-gray-200 flex items-center justify-between">
+            <h2 class="text-lg font-bold text-gray-800">Top Pages</h2>
+            <span class="text-sm text-gray-500">This period</span>
+        </div>
+        <div class="p-6">
+            <div class="overflow-x-auto">
+                <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 tracking-wider">Page</th>
+                            <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Views</th>
+                            <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Unique Visitors</th>
+                            <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Avg. Duration</th>
+                            <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Bounce Rate</th>
+                        </tr>
+                    </thead>
+                    <tbody class="bg-white divide-y divide-gray-200">
+                        @forelse($topPages ?? [] as $page)
+                            <tr class="hover:bg-gray-50">
+                                <td class="px-6 py-4 whitespace-nowrap">
+                                    <div class="flex items-center gap-3">
+                                        <i class="fas fa-file-alt text-gray-400"></i>
+                                        <div>
+                                            <p class="text-sm font-medium text-gray-900">{{ $page['title'] ?? 'Page Title' }}</p>
+                                            <p class="text-xs text-gray-500">{{ $page['url'] ?? '/path/to/page' }}</p>
+                                        </div>
+                                    </div>
+                                </td>
+                                <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-900 font-medium">
+                                    {{ $page['views'] ?? 0 }}
+                                </td>
+                                <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
+                                    {{ $page['unique_visitors'] ?? 0 }}
+                                </td>
+                                <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
+                                    {{ $page['avg_duration'] ?? '0:00' }}
+                                </td>
+                                <td class="px-6 py-4 whitespace-nowrap">
+                                    <div class="flex items-center gap-2">
+                                        <span class="text-sm text-gray-900 font-medium">{{ $page['bounce_rate'] ?? '0' }}%</span>
+                                        @if(($page['bounce_rate'] ?? 0) < 40)
+                                            <span class="inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium bg-green-100 text-green-800">
+                                                Good
+                                            </span>
+                                        @elseif(($page['bounce_rate'] ?? 0) < 60)
+                                            <span class="inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium bg-yellow-100 text-yellow-800">
+                                                Medium
+                                            </span>
+                                        @else
+                                            <span class="inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium bg-red-100 text-red-800">
+                                                High
+                                            </span>
+                                        @endif
+                                    </div>
+                                </td>
+                            </tr>
+                        @empty
+                            <tr>
+                                <td colspan="5" class="px-6 py-12 text-center">
+                                    <div class="w-16 h-16 bg-gray-100 rounded-full flex items-center justify-center mx-auto mb-4">
+                                        <i class="fas fa-chart-bar text-2xl text-gray-400"></i>
+                                    </div>
+                                    <p class="text-gray-500 font-medium">No data available</p>
+                                    <p class="text-sm text-gray-400 mt-1">Analytics data will appear once tracking is enabled.</p>
+                                </td>
+                            </tr>
+                        @endforelse
+                    </tbody>
+                </table>
+            </div>
+        </div>
+    </div>
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/backups/index.blade.php b/app/Modules/Admin/Resources/views/backups/index.blade.php
new file mode 100644
index 0000000..d7aab3a
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/backups/index.blade.php
@@ -0,0 +1,137 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Backups')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">Backups</h1>
+    </div>
+    <div class="flex items-center gap-3">
+        <form method="POST" action="{{ route('admin.backups.create') }}">
+            @csrf
+            <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium"
+                onclick="this.disabled=true; this.innerText='Creating...'; this.form.submit();">
+                <i class="fas fa-plus mr-2"></i>Create Backup
+            </button>
+        </form>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    {{-- Flash Messages --}}
+    @if(session('success'))
+        <div class="mb-6 p-4 bg-green-50 border-l-4 border-green-500 rounded-lg flex items-center gap-3">
+            <i class="fas fa-check-circle text-green-600"></i>
+            <p class="text-green-700 text-sm font-medium">{{ session('success') }}</p>
+        </div>
+    @endif
+
+    @if(session('error'))
+        <div class="mb-6 p-4 bg-red-50 border-l-4 border-red-500 rounded-lg flex items-center gap-3">
+            <i class="fas fa-exclamation-circle text-red-600"></i>
+            <p class="text-red-700 text-sm font-medium">{{ session('error') }}</p>
+        </div>
+    @endif
+
+    {{-- Stats --}}
+    <div class="grid grid-cols-1 md:grid-cols-3 gap-4 mb-6">
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4">
+            <div class="w-10 h-10 bg-blue-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-archive text-blue-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Total Backups</p>
+                <p class="text-xl font-bold text-gray-800">{{ $backups->count() }}</p>
+            </div>
+        </div>
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4">
+            <div class="w-10 h-10 bg-purple-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-hdd text-purple-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Storage Used</p>
+                <p class="text-xl font-bold text-gray-800">{{ formatBytes($totalSize) }}</p>
+            </div>
+        </div>
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4">
+            <div class="w-10 h-10 bg-green-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-clock text-green-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Latest Backup</p>
+                <p class="text-xl font-bold text-gray-800">
+                    {{ $latestBackup ? \Carbon\Carbon::createFromTimestamp($latestBackup['date'])->diffForHumans() : 'Never' }}
+                </p>
+            </div>
+        </div>
+    </div>
+
+    {{-- Backup List --}}
+    <div class="bg-white rounded-lg shadow">
+        <div class="p-6 border-b border-gray-200 flex items-center justify-between">
+            <h2 class="text-lg font-bold text-gray-800">Backup Files</h2>
+            <span class="text-sm text-gray-500">{{ $backups->count() }} {{ Str::plural('backup', $backups->count()) }}</span>
+        </div>
+        <div class="p-6">
+            @if($backups->count() > 0)
+                <div class="overflow-x-auto">
+                    <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 tracking-wider">Filename</th>
+                                <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Size</th>
+                                <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Date</th>
+                                <th class="px-6 py-3 text-right text-xs font-medium text-gray-500 uppercase tracking-wider">Actions</th>
+                            </tr>
+                        </thead>
+                        <tbody class="bg-white divide-y divide-gray-200">
+                            @foreach($backups as $backup)
+                                <tr class="hover:bg-gray-50">
+                                    <td class="px-6 py-4 whitespace-nowrap">
+                                        <div class="flex items-center gap-3">
+                                            <i class="fas fa-file-archive text-gray-400"></i>
+                                            <span class="text-sm font-medium text-gray-900">{{ $backup['filename'] }}</span>
+                                        </div>
+                                    </td>
+                                    <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
+                                        {{ formatBytes($backup['size']) }}
+                                    </td>
+                                    <td class="px-6 py-4 whitespace-nowrap text-sm text-gray-500">
+                                        {{ \Carbon\Carbon::createFromTimestamp($backup['date'])->format('M d, Y H:i:s') }}
+                                        <span class="text-gray-400 ml-1">({{ \Carbon\Carbon::createFromTimestamp($backup['date'])->diffForHumans() }})</span>
+                                    </td>
+                                    <td class="px-6 py-4 whitespace-nowrap text-right">
+                                        <div class="flex items-center justify-end gap-2">
+                                            <a href="{{ route('admin.backups.download', $backup['filename']) }}"
+                                                class="px-3 py-1.5 bg-blue-50 text-blue-700 rounded-lg hover:bg-blue-100 text-sm font-medium">
+                                                <i class="fas fa-download mr-1"></i>Download
+                                            </a>
+                                            <form method="POST" action="{{ route('admin.backups.destroy', $backup['filename']) }}"
+                                                onsubmit="return confirm('Are you sure you want to delete this backup? This action cannot be undone.')">
+                                                @csrf
+                                                @method('DELETE')
+                                                <button type="submit" class="px-3 py-1.5 bg-red-50 text-red-700 rounded-lg hover:bg-red-100 text-sm font-medium">
+                                                    <i class="fas fa-trash mr-1"></i>Delete
+                                                </button>
+                                            </form>
+                                        </div>
+                                    </td>
+                                </tr>
+                            @endforeach
+                        </tbody>
+                    </table>
+                </div>
+            @else
+                <div class="text-center py-12">
+                    <div class="w-16 h-16 bg-gray-100 rounded-full flex items-center justify-center mx-auto mb-4">
+                        <i class="fas fa-archive text-2xl text-gray-400"></i>
+                    </div>
+                    <p class="text-gray-500 font-medium">No backups found</p>
+                    <p class="text-sm text-gray-400 mt-1">Create your first backup to get started.</p>
+                </div>
+            @endif
+        </div>
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index 08dd420..3209336 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -172,13 +172,13 @@
                     </a>
                     @endcan
                     @can('view.logs')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                    <a href="{{ route('admin.logs.index') }}" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-terminal w-5"></i>
                         <span>Logs</span>
                     </a>
                     @endcan
                     @can('manage.backups')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                    <a href="{{ route('admin.backups.index') }}" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
                         <i class="fas fa-download w-5"></i>
                         <span>Backups</span>
                     </a>
diff --git a/app/Modules/Admin/Resources/views/logs/index.blade.php b/app/Modules/Admin/Resources/views/logs/index.blade.php
new file mode 100644
index 0000000..1c44473
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/logs/index.blade.php
@@ -0,0 +1,178 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Logs')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">System Logs</h1>
+    </div>
+    <div class="flex items-center gap-3">
+        <form method="GET" action="{{ route('admin.logs.index') }}" class="flex items-center gap-3">
+            {{-- Log file selector --}}
+            <select name="file" onchange="this.form.submit()" class="pl-3 pr-8 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 text-sm">
+                @foreach($logFiles as $file)
+                    <option value="{{ $file }}" @selected($file === $selectedFile)>{{ $file }}</option>
+                @endforeach
+            </select>
+
+            {{-- Level filter --}}
+            <select name="level" onchange="this.form.submit()" class="pl-3 pr-8 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 text-sm">
+                <option value="">All Levels</option>
+                @foreach(['emergency', 'alert', 'critical', 'error', 'warning', 'notice', 'info', 'debug'] as $level)
+                    <option value="{{ $level }}" @selected($level === $levelFilter)>{{ ucfirst($level) }}</option>
+                @endforeach
+            </select>
+
+            {{-- Search --}}
+            <div class="relative">
+                <input type="search" name="search" value="{{ $searchQuery }}" placeholder="Search logs..."
+                    class="pl-10 pr-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 w-64 text-sm">
+                <i class="fas fa-search absolute left-3 top-1/2 -translate-y-1/2 text-gray-400"></i>
+            </div>
+
+            <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                Filter
+            </button>
+        </form>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    {{-- Stats --}}
+    <div class="grid grid-cols-1 md:grid-cols-4 gap-4 mb-6">
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4">
+            <div class="w-10 h-10 bg-blue-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-file-alt text-blue-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Log Files</p>
+                <p class="text-xl font-bold text-gray-800">{{ $logFiles->count() }}</p>
+            </div>
+        </div>
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4">
+            <div class="w-10 h-10 bg-gray-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-list text-gray-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Total Entries</p>
+                <p class="text-xl font-bold text-gray-800">{{ $total }}</p>
+            </div>
+        </div>
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4">
+            <div class="w-10 h-10 bg-red-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-exclamation-circle text-red-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Current File</p>
+                <p class="text-xl font-bold text-gray-800 truncate max-w-[140px]" title="{{ $selectedFile }}">{{ $selectedFile ?? 'None' }}</p>
+            </div>
+        </div>
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4">
+            <div class="w-10 h-10 bg-green-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-filter text-green-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Active Filter</p>
+                <p class="text-xl font-bold text-gray-800">{{ $levelFilter ? ucfirst($levelFilter) : 'None' }}</p>
+            </div>
+        </div>
+    </div>
+
+    {{-- Log Entries --}}
+    <div class="bg-white rounded-lg shadow">
+        <div class="p-6 border-b border-gray-200 flex items-center justify-between">
+            <h2 class="text-lg font-bold text-gray-800">Log Entries</h2>
+            <span class="text-sm text-gray-500">
+                Showing {{ $entries->count() }} of {{ $total }} entries
+                @if($total > $perPage)
+                    (Page {{ $page }} of {{ ceil($total / $perPage) }})
+                @endif
+            </span>
+        </div>
+        <div class="p-6">
+            <div class="space-y-3">
+                @forelse($entries as $entry)
+                    @php
+                        $levelColors = [
+                            'emergency' => ['bg' => 'bg-red-100', 'text' => 'text-red-700', 'border' => 'border-red-500', 'badge' => 'bg-red-600'],
+                            'alert'     => ['bg' => 'bg-red-50', 'text' => 'text-red-600', 'border' => 'border-red-400', 'badge' => 'bg-red-500'],
+                            'critical'  => ['bg' => 'bg-red-50', 'text' => 'text-red-600', 'border' => 'border-red-400', 'badge' => 'bg-red-500'],
+                            'error'     => ['bg' => 'bg-red-50', 'text' => 'text-red-600', 'border' => 'border-red-300', 'badge' => 'bg-red-400'],
+                            'warning'   => ['bg' => 'bg-yellow-50', 'text' => 'text-yellow-700', 'border' => 'border-yellow-400', 'badge' => 'bg-yellow-500'],
+                            'notice'    => ['bg' => 'bg-blue-50', 'text' => 'text-blue-600', 'border' => 'border-blue-300', 'badge' => 'bg-blue-400'],
+                            'info'      => ['bg' => 'bg-blue-50', 'text' => 'text-blue-600', 'border' => 'border-blue-300', 'badge' => 'bg-blue-500'],
+                            'debug'     => ['bg' => 'bg-gray-50', 'text' => 'text-gray-600', 'border' => 'border-gray-300', 'badge' => 'bg-gray-400'],
+                        ];
+                        $colors = $levelColors[$entry['level']] ?? $levelColors['debug'];
+
+                        $lines = explode("\n", $entry['message']);
+                        $firstLine = $lines[0];
+                        $stackTrace = count($lines) > 1 ? implode("\n", array_slice($lines, 1)) : null;
+                    @endphp
+
+                    <div class="p-4 {{ $colors['bg'] }} rounded-lg border-l-4 {{ $colors['border'] }}">
+                        <div class="flex items-start justify-between mb-1">
+                            <div class="flex items-center gap-2">
+                                <span class="px-2 py-0.5 {{ $colors['badge'] }} text-white rounded text-xs font-semibold uppercase">
+                                    {{ $entry['level'] }}
+                                </span>
+                                <span class="text-xs text-gray-500">
+                                    <i class="fas fa-clock mr-1"></i>{{ $entry['timestamp'] }}
+                                </span>
+                            </div>
+                        </div>
+                        <p class="text-sm {{ $colors['text'] }} font-medium mt-2 break-all">{{ $firstLine }}</p>
+
+                        @if($stackTrace)
+                            <details class="mt-2">
+                                <summary class="text-xs text-gray-500 cursor-pointer hover:text-gray-700">
+                                    <i class="fas fa-code mr-1"></i>Stack Trace
+                                </summary>
+                                <pre class="mt-2 p-3 bg-gray-900 text-gray-100 rounded text-xs overflow-x-auto max-h-64 overflow-y-auto"><code>{{ $stackTrace }}</code></pre>
+                            </details>
+                        @endif
+                    </div>
+                @empty
+                    <div class="text-center py-12">
+                        <div class="w-16 h-16 bg-gray-100 rounded-full flex items-center justify-center mx-auto mb-4">
+                            <i class="fas fa-terminal text-2xl text-gray-400"></i>
+                        </div>
+                        <p class="text-gray-500 font-medium">No log entries found</p>
+                        <p class="text-sm text-gray-400 mt-1">
+                            @if($levelFilter || $searchQuery)
+                                Try adjusting your filters or search query.
+                            @else
+                                No log files available.
+                            @endif
+                        </p>
+                    </div>
+                @endforelse
+            </div>
+
+            {{-- Pagination --}}
+            @if($total > $perPage)
+                <div class="flex items-center justify-between mt-6 pt-4 border-t border-gray-200">
+                    <div class="text-sm text-gray-500">
+                        Showing {{ (($page - 1) * $perPage) + 1 }} to {{ min($page * $perPage, $total) }} of {{ $total }} entries
+                    </div>
+                    <div class="flex items-center gap-2">
+                        @if($page > 1)
+                            <a href="{{ route('admin.logs.index', array_merge(request()->query(), ['page' => $page - 1])) }}"
+                                class="px-3 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300 text-sm">
+                                <i class="fas fa-chevron-left mr-1"></i> Previous
+                            </a>
+                        @endif
+                        @if($page < ceil($total / $perPage))
+                            <a href="{{ route('admin.logs.index', array_merge(request()->query(), ['page' => $page + 1])) }}"
+                                class="px-3 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm">
+                                Next <i class="fas fa-chevron-right ml-1"></i>
+                            </a>
+                        @endif
+                    </div>
+                </div>
+            @endif
+        </div>
+    </div>
+</main>
+@endsection
diff --git a/app/Services/AnalyticsService.php b/app/Services/AnalyticsService.php
new file mode 100644
index 0000000..e8ed2d9
--- /dev/null
+++ b/app/Services/AnalyticsService.php
@@ -0,0 +1,263 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\AnalyticsSession;
+use App\Models\AnalyticsPageView;
+use Carbon\Carbon;
+use Illuminate\Support\Facades\DB;
+
+class AnalyticsService
+{
+    /**
+     * Get analytics data for a given period
+     */
+    public function getAnalyticsData(string $period = '30d'): array
+    {
+        $startDate = $this->getStartDate($period);
+
+        return [
+            'period' => $period,
+            'start_date' => $startDate,
+            'total_visitors' => $this->getTotalVisitors($startDate),
+            'page_views' => $this->getPageViews($startDate),
+            'avg_session_duration' => $this->getAverageSessionDuration($startDate),
+            'bounce_rate' => $this->getBounceRate($startDate),
+            'top_pages' => $this->getTopPages($startDate),
+            'visitor_growth' => $this->getVisitorGrowth($startDate),
+            'traffic_by_device' => $this->getTrafficByDevice($startDate),
+            'traffic_by_source' => $this->getTrafficBySource($startDate),
+        ];
+    }
+
+    /**
+     * Get the start date based on period
+     */
+    public function getStartDate(string $period): Carbon
+    {
+        return match($period) {
+            '7d' => Carbon::now()->subDays(7),
+            '90d' => Carbon::now()->subDays(90),
+            '1y' => Carbon::now()->subYear(),
+            default => Carbon::now()->subDays(30),
+        };
+    }
+
+    /**
+     * Get total visitors count
+     */
+    public function getTotalVisitors(Carbon $startDate): int
+    {
+        return AnalyticsSession::where('created_at', '>=', $startDate)
+            ->where('is_bot', false)
+            ->distinct('visitor_id')
+            ->count('visitor_id');
+    }
+
+    /**
+     * Get total page views
+     */
+    public function getPageViews(Carbon $startDate): int
+    {
+        return AnalyticsPageView::whereHas('session', function ($query) use ($startDate) {
+            $query->where('created_at', '>=', $startDate)
+                  ->where('is_bot', false);
+        })->count();
+    }
+
+    /**
+     * Get average session duration in seconds
+     */
+    public function getAverageSessionDurationSeconds(Carbon $startDate): int
+    {
+        return (int) AnalyticsSession::where('created_at', '>=', $startDate)
+            ->where('is_bot', false)
+            ->avg('duration_seconds') ?? 0;
+    }
+
+    /**
+     * Get average session duration formatted
+     */
+    public function getAverageSessionDuration(Carbon $startDate): string
+    {
+        return $this->formatSeconds($this->getAverageSessionDurationSeconds($startDate));
+    }
+
+    /**
+     * Get bounce rate percentage
+     */
+    public function getBounceRate(Carbon $startDate): float
+    {
+        $totalPageViews = AnalyticsPageView::whereHas('session', function ($query) use ($startDate) {
+            $query->where('created_at', '>=', $startDate)
+                  ->where('is_bot', false);
+        })->count();
+
+        if ($totalPageViews === 0) {
+            return 0;
+        }
+
+        $bouncedPageViews = AnalyticsPageView::where('bounced', true)
+            ->whereHas('session', function ($query) use ($startDate) {
+                $query->where('created_at', '>=', $startDate)
+                      ->where('is_bot', false);
+            })->count();
+
+        return round(($bouncedPageViews / $totalPageViews) * 100, 2);
+    }
+
+    /**
+     * Get top pages with analytics data
+     */
+    public function getTopPages(Carbon $startDate, int $limit = 10): array
+    {
+        return AnalyticsPageView::select(
+            'page_url as url',
+            'page_title as title',
+            DB::raw('COUNT(*) as views'),
+            DB::raw('COUNT(DISTINCT session_id) as unique_visitors'),
+            DB::raw('AVG(time_on_page) as avg_duration'),
+            DB::raw('SUM(CASE WHEN bounced = 1 THEN 1 ELSE 0 END) / COUNT(*) * 100 as bounce_rate')
+        )
+        ->whereHas('session', function ($query) use ($startDate) {
+            $query->where('created_at', '>=', $startDate)
+                  ->where('is_bot', false);
+        })
+        ->groupBy('page_url', 'page_title')
+        ->orderByDesc('views')
+        ->limit($limit)
+        ->get()
+        ->map(fn($page) => [
+            'url' => $page->url,
+            'title' => $page->title,
+            'views' => (int)$page->views,
+            'unique_visitors' => (int)$page->unique_visitors,
+            'avg_duration' => $this->formatSeconds((int)$page->avg_duration),
+            'bounce_rate' => round($page->bounce_rate ?? 0, 2),
+        ])
+        ->toArray();
+    }
+
+    /**
+     * Get visitor growth over time
+     */
+    public function getVisitorGrowth(Carbon $startDate): array
+    {
+        $days = now()->diffInDays($startDate) ?: 30;
+
+        return AnalyticsSession::select(
+            DB::raw('DATE(created_at) as date'),
+            DB::raw('COUNT(DISTINCT visitor_id) as visitors')
+        )
+        ->where('created_at', '>=', $startDate)
+        ->where('is_bot', false)
+        ->groupBy('date')
+        ->orderBy('date')
+        ->get()
+        ->map(fn($row) => [
+            'date' => $row->date,
+            'visitors' => (int)$row->visitors,
+        ])
+        ->toArray();
+    }
+
+    /**
+     * Get traffic by device type
+     */
+    public function getTrafficByDevice(Carbon $startDate): array
+    {
+        $total = AnalyticsSession::where('created_at', '>=', $startDate)
+            ->where('is_bot', false)
+            ->count();
+
+        if ($total === 0) {
+            return [];
+        }
+
+        // Parse device types from user agent
+        $devices = [];
+
+        // This is simplified - for production use a proper device detection library
+        $sessions = AnalyticsSession::where('created_at', '>=', $startDate)
+            ->where('is_bot', false)
+            ->get();
+
+        foreach ($sessions as $session) {
+            $device = $this->detectDevice($session->user_agent);
+            $devices[$device] = ($devices[$device] ?? 0) + 1;
+        }
+
+        return collect($devices)
+            ->map(function ($count, $device) use ($total) {
+                return [
+                    'device' => $device,
+                    'count' => $count,
+                    'percentage' => round(($count / $total) * 100, 2),
+                ];
+            })
+            ->toArray();
+    }
+
+    /**
+     * Get traffic by source (referrer)
+     */
+    public function getTrafficBySource(Carbon $startDate): array
+    {
+        $total = AnalyticsPageView::whereHas('session', function ($query) use ($startDate) {
+            $query->where('created_at', '>=', $startDate)
+                  ->where('is_bot', false);
+        })->count();
+
+        if ($total === 0) {
+            return [];
+        }
+
+        return AnalyticsPageView::select(
+            DB::raw('COALESCE(referrer, "direct") as source'),
+            DB::raw('COUNT(*) as count')
+        )
+        ->whereHas('session', function ($query) use ($startDate) {
+            $query->where('created_at', '>=', $startDate)
+                  ->where('is_bot', false);
+        })
+        ->groupBy('source')
+        ->orderByDesc('count')
+        ->limit(10)
+        ->get()
+        ->map(fn($row) => [
+            'source' => $row->source,
+            'count' => (int)$row->count,
+            'percentage' => round(($row->count / $total) * 100, 2),
+        ])
+        ->toArray();
+    }
+
+    /**
+     * Format seconds to MM:SS format
+     */
+    public function formatSeconds(int $seconds): string
+    {
+        $minutes = intdiv($seconds, 60);
+        $secs = $seconds % 60;
+
+        return sprintf('%d:%02d', $minutes, $secs);
+    }
+
+    /**
+     * Detect device type from user agent
+     */
+    protected function detectDevice(string $userAgent): string
+    {
+        $userAgent = strtolower($userAgent);
+
+        if (str_contains($userAgent, 'mobile') || str_contains($userAgent, 'android')) {
+            return 'Mobile';
+        }
+
+        if (str_contains($userAgent, 'tablet') || str_contains($userAgent, 'ipad')) {
+            return 'Tablet';
+        }
+
+        return 'Desktop';
+    }
+}
diff --git a/bootstrap/app.php b/bootstrap/app.php
index d34f240..2d1f849 100755
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -17,7 +17,8 @@
 
         $middleware->alias([
             'role' => \App\Http\Middleware\CheckRole::class,
-            'permission' => \App\Http\Middleware\ModulePermission::class,
+            'permission' => \App\Http\Middleware\Permission::class,
+            'track.analytics' => \App\Http\Middleware\TrackAnalytics::class,
         ]);
     })
     ->withExceptions(function (Exceptions $exceptions) {
diff --git a/database/migrations/2026_03_12_000000_create_analytics_sessions_table.php b/database/migrations/2026_03_12_000000_create_analytics_sessions_table.php
new file mode 100644
index 0000000..f1c4d73
--- /dev/null
+++ b/database/migrations/2026_03_12_000000_create_analytics_sessions_table.php
@@ -0,0 +1,37 @@
+<?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('analytics_sessions', function (Blueprint $table) {
+            $table->id();
+            $table->string('visitor_id')->unique();
+            $table->string('ip_address')->nullable();
+            $table->string('user_agent')->nullable();
+            $table->integer('duration_seconds')->default(0);
+            $table->integer('page_views')->default(0);
+            $table->boolean('is_bot')->default(false);
+            $table->timestamps();
+
+            $table->index('visitor_id');
+            $table->index('country');
+            $table->index('created_at');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('analytics_sessions');
+    }
+};
diff --git a/database/migrations/2026_03_12_000001_create_analytics_page_views_table.php b/database/migrations/2026_03_12_000001_create_analytics_page_views_table.php
new file mode 100644
index 0000000..fb7aeb0
--- /dev/null
+++ b/database/migrations/2026_03_12_000001_create_analytics_page_views_table.php
@@ -0,0 +1,37 @@
+<?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('analytics_page_views', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('session_id')->constrained('analytics_sessions')->onDelete('cascade');
+            $table->string('page_url');
+            $table->string('page_title')->nullable();
+            $table->string('referrer')->nullable();
+            $table->integer('time_on_page')->default(0);
+            $table->boolean('bounced')->default(false);
+            $table->timestamps();
+
+            $table->index('session_id');
+            $table->index('page_url');
+            $table->index('created_at');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('analytics_page_views');
+    }
+};
diff --git a/database/seeders/AnalyticsSeeder.php b/database/seeders/AnalyticsSeeder.php
new file mode 100644
index 0000000..28a5942
--- /dev/null
+++ b/database/seeders/AnalyticsSeeder.php
@@ -0,0 +1,76 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Models\AnalyticsSession;
+use App\Models\AnalyticsPageView;
+use Illuminate\Database\Seeder;
+use Carbon\Carbon;
+
+class AnalyticsSeeder extends Seeder
+{
+    /**
+     * Run the database seeds.
+     */
+    public function run(): void
+    {
+        $pages = [
+            ['url' => '/', 'title' => 'Home'],
+            ['url' => '/blog', 'title' => 'Blog'],
+            ['url' => '/products', 'title' => 'Products'],
+            ['url' => '/about', 'title' => 'About Us'],
+            ['url' => '/contact', 'title' => 'Contact'],
+            ['url' => '/blog/getting-started', 'title' => 'Getting Started Guide'],
+            ['url' => '/products/premium', 'title' => 'Premium Plan'],
+            ['url' => '/news', 'title' => 'News'],
+        ];
+
+        $countries = [
+            'United States',
+            'Spain',
+            'Mexico',
+            'Argentina',
+            'Colombia',
+            'Chile',
+        ];
+
+        // Create 100 sample sessions with page views
+        for ($i = 0; $i < 100; $i++) {
+            $session = AnalyticsSession::create([
+                'visitor_id' => 'visitor_' . generateUniqueId()(),
+                'ip_address' => fake()->ipv4(),
+                'user_agent' => fake()->userAgent(),
+                'country' => fake()->randomElement($countries),
+                'city' => fake()->city(),
+                'duration_seconds' => fake()->numberBetween(60, 1800),
+                'page_views' => fake()->numberBetween(1, 10),
+                'is_bot' => fake()->boolean(5),
+                'created_at' => Carbon::now()->subDays(fake()->numberBetween(0, 30)),
+                'updated_at' => Carbon::now()->subDays(fake()->numberBetween(0, 30)),
+            ]);
+
+            // Create 1-5 page views per session
+            $pageCount = fake()->numberBetween(1, 5);
+            for ($j = 0; $j < $pageCount; $j++) {
+                $page = fake()->randomElement($pages);
+                AnalyticsPageView::create([
+                    'session_id' => $session->id,
+                    'page_url' => $page['url'],
+                    'page_title' => $page['title'],
+                    'referrer' => fake()->randomElement([null, 'google.com', 'facebook.com', 'twitter.com']),
+                    'time_on_page' => fake()->numberBetween(10, 600),
+                    'bounced' => $pageCount === 1 ? fake()->boolean(40) : false,
+                    'created_at' => Carbon::now()->subDays(fake()->numberBetween(0, 30)),
+                    'updated_at' => Carbon::now()->subDays(fake()->numberBetween(0, 30)),
+                ]);
+            }
+        }
+    }
+}
+
+// Helper function to generate unique IDs
+function generateUniqueId(): callable
+{
+    static $counter = 0;
+    return fn() => ++$counter;
+}
diff --git a/database/seeders/RolesAndPermissionsSeeder.php b/database/seeders/RolesAndPermissionsSeeder.php
index 4a52b76..d9ddd22 100755
--- a/database/seeders/RolesAndPermissionsSeeder.php
+++ b/database/seeders/RolesAndPermissionsSeeder.php
@@ -33,7 +33,7 @@ public function run(): void
         Permission::firstOrCreate(['name' => 'manage.store.products']);
         Permission::firstOrCreate(['name' => 'manage.store.categories']);
         Permission::firstOrCreate(['name' => 'view.store.transactions']);
-        
+        Permission::firstOrCreate(['name' => 'view.analytics']);
         // Permisos para GameMasters
         Permission::firstOrCreate(['name' => 'access.gm.panel']);
         Permission::firstOrCreate(['name' => 'manage.characters']);
diff --git a/routes/web.php b/routes/web.php
index 557b76b..5ae7b06 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -11,8 +11,8 @@
 use Illuminate\Support\Facades\Redis;
 use Illuminate\Support\Facades\Route;
 
-Route::get('/', [HomeController::class, 'index'])->name('home');
-Route::get('/howtoplay', [HomeController::class, 'howToPlay'])->name('howtoplay');
+Route::get('/', [HomeController::class, 'index'])->middleware(['track.analytics'])->name('home');
+Route::get('/howtoplay', [HomeController::class, 'howToPlay'])->middleware(['track.analytics'])->name('howtoplay');
 
 Route::get('/test-redis', function() {
     try {
@@ -40,7 +40,7 @@
     }
 });
 
-Route::prefix('news')->group(function () {
+Route::prefix('news')->middleware(['track.analytics'])->group(function () {
     Route::get('/', [NewsController::class, 'index'])->name('news');
     Route::get('/{slug}', [NewsController::class, 'show'])->name('news.show');
     Route::post('/{slug}/comment', [CommentController::class, 'store'])->name('news.comment.store');
@@ -58,7 +58,7 @@
     Route::post('/logout', [AuthController::class, 'logout'])->name('logout');
 });
 
-Route::prefix('ucp')->middleware(['auth', 'permission:access.ucp'])->group(function () {
+Route::prefix('ucp')->middleware(['auth', 'permission:access.ucp', 'track.analytics'])->group(function () {
     Route::get('/', [UserController::class, 'show'])->name('ucp.dashboard');
     Route::get('/gameaccount', [UserController::class, 'gameAccount'])->name('ucp.gameaccount');
     Route::get('/donations', [UserController::class, 'transaction'])->name('ucp.transaction');

From def9d3b6c1353cfa8d7534f3a4dd87e1a4882ab3 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 13 Mar 2026 23:47:21 +0100
Subject: [PATCH 089/132] fix(nav): update navigation links to use route
 helpers and improve active state styling

---
 .../Admin/Resources/views/layouts/app.blade.php    | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index 3209336..7dd1b52 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -49,13 +49,13 @@
                 <div class="px-3 mb-4">
                     <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Main</h3>
                     @can('access.admin.panel')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 bg-blue-600 rounded-lg mb-1">
+                    <a href="{{ route('admin.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.index') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
                         <i class="fas fa-home w-5"></i>
                         <span>Dashboard</span>
                     </a>
                     @endcan
                     @can('access.admin.panel')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                    <a href="{{ route('admin.analytics.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.analytics.index') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
                         <i class="fas fa-chart-line w-5"></i>
                         <span>Analytics</span>
                     </a>
@@ -65,7 +65,7 @@
                 <div class="px-3 mb-4">
                     <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Management</h3>
                     @can('manage.admin.users')
-                    <a href="{{ route('admin.users.index') }}" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                    <a href="{{ route('admin.users.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.users.*') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
                         <i class="fas fa-users w-5"></i>
                         <span>Users</span>
                     </a>
@@ -160,25 +160,25 @@
                 <div class="px-3 mb-4">
                     <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">System</h3>
                     @can('manage.roles')
-                    <a href="{{ route('admin.roles.index') }}" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                    <a href="{{ route('admin.roles.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.roles.*') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
                         <i class="fas fa-user-shield w-5"></i>
                         <span>Roles & Permissions</span>
                     </a>
                     @endcan
                     @can('manage.settings')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                    <a href="{{ route('admin.settings.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.settings.*') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
                         <i class="fas fa-cog w-5"></i>
                         <span>Settings</span>
                     </a>
                     @endcan
                     @can('view.logs')
-                    <a href="{{ route('admin.logs.index') }}" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                    <a href="{{ route('admin.logs.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.logs.*') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
                         <i class="fas fa-terminal w-5"></i>
                         <span>Logs</span>
                     </a>
                     @endcan
                     @can('manage.backups')
-                    <a href="{{ route('admin.backups.index') }}" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
+                    <a href="{{ route('admin.backups.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.backups.*') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
                         <i class="fas fa-download w-5"></i>
                         <span>Backups</span>
                     </a>

From fea0851eb221ce8991c475f14c3a011e434f56a1 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 14 Mar 2026 02:09:35 +0100
Subject: [PATCH 090/132] fix(migrations): remove unused index on country from
 analytics_sessions table

---
 .../2026_03_12_000000_create_analytics_sessions_table.php        | 1 -
 1 file changed, 1 deletion(-)

diff --git a/database/migrations/2026_03_12_000000_create_analytics_sessions_table.php b/database/migrations/2026_03_12_000000_create_analytics_sessions_table.php
index f1c4d73..5b22fec 100644
--- a/database/migrations/2026_03_12_000000_create_analytics_sessions_table.php
+++ b/database/migrations/2026_03_12_000000_create_analytics_sessions_table.php
@@ -22,7 +22,6 @@ public function up(): void
             $table->timestamps();
 
             $table->index('visitor_id');
-            $table->index('country');
             $table->index('created_at');
         });
     }

From 2febab6352d5f75fc54ac27a6085368f57bf2997 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 14 Mar 2026 20:21:51 +0100
Subject: [PATCH 091/132] feat: Implement Menu Manager and Module Configuration
 UI

- Added a new Menu Manager interface for configuring web and UCP menus with safety rules for disabled modules.
- Created partials for menu item rows to facilitate dynamic addition and editing of menu items.
- Introduced a Module Configuration page to manage module settings, including enabling/disabling modules and loading capabilities.
- Enhanced the Modules index page to display module statistics and actions.
- Updated layout files to dynamically generate menu items based on configuration.
- Added migration to alter settings value type to LONGTEXT for better flexibility.
- Seeded new permissions for module management.
- Updated module.json files for various modules to reflect changes in enabled status.
---
 app/Console/Commands/MakeModuleCommand.php    |   1 +
 .../Commands/MakeModuleCrudCommand.php        |   0
 app/Helpers/ModuleLoader.php                  |  17 +
 app/Helpers/SettingsHelper.php                | 148 ++++++
 app/Models/ManagedModule.php                  |  20 +
 .../Controllers/MenuManagerController.php     | 148 ++++++
 .../Controllers/ModuleManagerController.php   | 234 +++++++++
 app/Modules/Admin/Http/routes.php             |  12 +
 .../Resources/views/layouts/app.blade.php     | 496 +++++++++++-------
 .../Resources/views/menus/index.blade.php     | 183 +++++++
 .../views/menus/partials/row.blade.php        |  52 ++
 .../Resources/views/modules/edit.blade.php    | 110 ++++
 .../Resources/views/modules/index.blade.php   | 198 +++++++
 app/Modules/Admin/module.json                 |   4 +-
 app/Modules/Armory/module.json                |   4 +-
 app/Modules/Donate/module.json                |   2 +-
 app/Modules/Forum/module.json                 |   2 +-
 app/Modules/Store/module.json                 |   2 +-
 app/Providers/BaseModuleServiceProvider.php   |   3 +-
 app/Services/ModuleRegistryService.php        | 213 ++++++++
 ...14_030000_alter_settings_value_to_text.php |  45 ++
 ...14_120000_create_managed_modules_table.php |  25 +
 .../seeders/RolesAndPermissionsSeeder.php     |   1 +
 resources/views/layouts/main.blade.php        |  16 +-
 .../views/ucp/components/sidebar.blade.php    |  22 +-
 25 files changed, 1736 insertions(+), 222 deletions(-)
 create mode 100644 app/Console/Commands/MakeModuleCrudCommand.php
 create mode 100644 app/Models/ManagedModule.php
 create mode 100644 app/Modules/Admin/Http/Controllers/MenuManagerController.php
 create mode 100644 app/Modules/Admin/Http/Controllers/ModuleManagerController.php
 create mode 100644 app/Modules/Admin/Resources/views/menus/index.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/menus/partials/row.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/modules/edit.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/modules/index.blade.php
 create mode 100644 app/Services/ModuleRegistryService.php
 create mode 100644 database/migrations/2026_03_14_030000_alter_settings_value_to_text.php
 create mode 100644 database/migrations/2026_03_14_120000_create_managed_modules_table.php

diff --git a/app/Console/Commands/MakeModuleCommand.php b/app/Console/Commands/MakeModuleCommand.php
index 56db658..e316828 100644
--- a/app/Console/Commands/MakeModuleCommand.php
+++ b/app/Console/Commands/MakeModuleCommand.php
@@ -69,6 +69,7 @@ public function handle(): int
         $moduleJson = [
             'name' => $name,
             'enabled' => true,
+            'module_type' => 'third_party',
             'routes' => true,
             'migrations' => true,
             'views' => true,
diff --git a/app/Console/Commands/MakeModuleCrudCommand.php b/app/Console/Commands/MakeModuleCrudCommand.php
new file mode 100644
index 0000000..e69de29
diff --git a/app/Helpers/ModuleLoader.php b/app/Helpers/ModuleLoader.php
index d36c0a2..eafff69 100644
--- a/app/Helpers/ModuleLoader.php
+++ b/app/Helpers/ModuleLoader.php
@@ -2,6 +2,9 @@
 
 namespace App\Helpers;
 
+use App\Services\ModuleRegistryService;
+use Illuminate\Support\Facades\File;
+
 class ModuleLoader
 {
     public static function getProviders(): array
@@ -15,6 +18,20 @@ public static function getProviders(): array
 
         foreach (glob("$modulesPath/*", GLOB_ONLYDIR) as $moduleDir) {
             $moduleName = basename($moduleDir);
+            $configPath = $moduleDir . DIRECTORY_SEPARATOR . 'module.json';
+            $config = [];
+
+            if (File::exists($configPath)) {
+                $decoded = json_decode(File::get($configPath), true);
+                if (is_array($decoded)) {
+                    $config = $decoded;
+                }
+            }
+
+            if (!ModuleRegistryService::isModuleEnabled($moduleName, (bool) ($config['enabled'] ?? true))) {
+                continue;
+            }
+
             $namespace = "Modules\\{$moduleName}\\Providers";
             $expectedFile = "{$moduleDir}/Providers/{$moduleName}ServiceProvider.php";
             $expectedClass = "{$namespace}\\{$moduleName}ServiceProvider";
diff --git a/app/Helpers/SettingsHelper.php b/app/Helpers/SettingsHelper.php
index 3e6f64d..58205da 100644
--- a/app/Helpers/SettingsHelper.php
+++ b/app/Helpers/SettingsHelper.php
@@ -1,7 +1,10 @@
 <?php
 
 use App\Modules\Admin\Domain\Models\Setting;
+use App\Services\ModuleRegistryService;
 use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\Route;
 
 if (!function_exists('formatBytes')) {
     function formatBytes(int $bytes, int $precision = 2): string
@@ -45,3 +48,148 @@ function settings($key = null, $default = null)
         return $settings->get($key, $default);
     }
 }
+
+if (!function_exists('menu_defaults')) {
+    function menu_defaults(): array
+    {
+        return [
+            'web' => [
+                ['label' => 'HOME', 'route' => 'home', 'url' => '', 'icon' => '', 'module' => '', 'auth' => 'any', 'permission' => '', 'enabled' => true],
+                ['label' => 'NEWS', 'route' => 'news', 'url' => '', 'icon' => '', 'module' => '', 'auth' => 'any', 'permission' => '', 'enabled' => true],
+                ['label' => 'HOW TO PLAY', 'route' => 'howtoplay', 'url' => '', 'icon' => '', 'module' => '', 'auth' => 'any', 'permission' => '', 'enabled' => true],
+                ['label' => 'ARMORY', 'route' => 'armory', 'url' => '', 'icon' => '', 'module' => 'Armory', 'auth' => 'any', 'permission' => '', 'enabled' => true],
+                ['label' => 'DONATE', 'route' => 'donate', 'url' => '', 'icon' => '', 'module' => 'Donate', 'auth' => 'any', 'permission' => '', 'enabled' => true],
+            ],
+            'ucp' => [
+                ['label' => 'Dashboard', 'route' => 'ucp.dashboard', 'url' => '', 'icon' => 'fas fa-home w-5', 'module' => '', 'auth' => 'auth', 'permission' => '', 'enabled' => true],
+                ['label' => 'Game Account', 'route' => 'ucp.gameaccount', 'url' => '', 'icon' => 'fas fa-gamepad w-5', 'module' => '', 'auth' => 'auth', 'permission' => '', 'enabled' => true],
+                ['label' => 'Donations', 'route' => 'ucp.transaction', 'url' => '', 'icon' => 'fas fa-hand-holding-usd w-5', 'module' => 'Donate', 'auth' => 'auth', 'permission' => '', 'enabled' => true],
+            ],
+        ];
+    }
+}
+
+if (!function_exists('menu_module_states')) {
+    function menu_module_states(): array
+    {
+        static $states = null;
+
+        if (is_array($states)) {
+            return $states;
+        }
+
+        $states = [];
+        $modulesPath = base_path('app/Modules');
+
+        if (!is_dir($modulesPath)) {
+            return $states;
+        }
+
+        foreach (glob($modulesPath . '/*', GLOB_ONLYDIR) as $moduleDir) {
+            $moduleName = basename($moduleDir);
+            $configPath = $moduleDir . DIRECTORY_SEPARATOR . 'module.json';
+            $fallbackEnabled = true;
+
+            if (File::exists($configPath)) {
+                $decoded = json_decode(File::get($configPath), true);
+                if (is_array($decoded) && array_key_exists('enabled', $decoded)) {
+                    $fallbackEnabled = (bool) $decoded['enabled'];
+                }
+            }
+
+            $states[$moduleName] = ModuleRegistryService::isModuleEnabled($moduleName, $fallbackEnabled);
+        }
+
+        return $states;
+    }
+}
+
+if (!function_exists('menu_module_enabled')) {
+    function menu_module_enabled(string $module): bool
+    {
+        $module = trim($module);
+        if ($module === '') {
+            return true;
+        }
+
+        $states = menu_module_states();
+
+        return array_key_exists($module, $states) && $states[$module] === true;
+    }
+}
+
+if (!function_exists('menu_config')) {
+    function menu_config(string $menu): array
+    {
+        $defaults = menu_defaults();
+        $fallback = $defaults[$menu] ?? [];
+        $value = settings("menu.{$menu}");
+
+        if (!is_string($value) || trim($value) === '') {
+            return $fallback;
+        }
+
+        $decoded = json_decode($value, true);
+
+        return is_array($decoded) ? $decoded : $fallback;
+    }
+}
+
+if (!function_exists('menu_items')) {
+    function menu_items(string $menu): array
+    {
+        $items = menu_config($menu);
+        $user = auth()->user();
+
+        return array_values(array_filter($items, function ($item) use ($user) {
+            if (!is_array($item)) {
+                return false;
+            }
+
+            if (!(bool) ($item['enabled'] ?? true)) {
+                return false;
+            }
+
+            $authRule = $item['auth'] ?? 'any';
+            if ($authRule === 'auth' && !$user) {
+                return false;
+            }
+
+            if ($authRule === 'guest' && $user) {
+                return false;
+            }
+
+            $permission = trim((string) ($item['permission'] ?? ''));
+            if ($permission !== '' && (!$user || !$user->can($permission))) {
+                return false;
+            }
+
+            $module = trim((string) ($item['module'] ?? ''));
+            if (!menu_module_enabled($module)) {
+                return false;
+            }
+
+            $routeName = trim((string) ($item['route'] ?? ''));
+            $url = trim((string) ($item['url'] ?? ''));
+
+            if ($routeName !== '') {
+                return Route::has($routeName);
+            }
+
+            return $url !== '';
+        }));
+    }
+}
+
+if (!function_exists('menu_item_href')) {
+    function menu_item_href(array $item): string
+    {
+        $routeName = trim((string) ($item['route'] ?? ''));
+        if ($routeName !== '' && Route::has($routeName)) {
+            return route($routeName);
+        }
+
+        $url = trim((string) ($item['url'] ?? ''));
+        return $url !== '' ? $url : '#';
+    }
+}
diff --git a/app/Models/ManagedModule.php b/app/Models/ManagedModule.php
new file mode 100644
index 0000000..a5e7a15
--- /dev/null
+++ b/app/Models/ManagedModule.php
@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class ManagedModule extends Model
+{
+    protected $table = 'managed_modules';
+
+    protected $fillable = [
+        'module_name',
+        'enabled',
+        'module_type',
+    ];
+
+    protected $casts = [
+        'enabled' => 'boolean',
+    ];
+}
diff --git a/app/Modules/Admin/Http/Controllers/MenuManagerController.php b/app/Modules/Admin/Http/Controllers/MenuManagerController.php
new file mode 100644
index 0000000..03fb0a8
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/MenuManagerController.php
@@ -0,0 +1,148 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Modules\Admin\Domain\Models\Setting;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\File;
+
+class MenuManagerController extends Controller
+{
+    public function index()
+    {
+        $webMenu = menu_config('web');
+        $ucpMenu = menu_config('ucp');
+        $modules = $this->discoverModules();
+
+        return view('admin::menus.index', compact('webMenu', 'ucpMenu', 'modules'));
+    }
+
+    public function update(Request $request)
+    {
+        $action = (string) $request->input('action', 'save');
+        $modules = $this->discoverModules();
+
+        $webItems = $this->normalizeItems($request->input('web_items', []));
+        $ucpItems = $this->normalizeItems($request->input('ucp_items', []));
+
+        $affected = 0;
+        if (in_array($action, ['disable-disabled-modules', 'remove-disabled-modules'], true)) {
+            [$webItems, $webAffected] = $this->handleDisabledModuleItems($webItems, $modules, $action);
+            [$ucpItems, $ucpAffected] = $this->handleDisabledModuleItems($ucpItems, $modules, $action);
+            $affected = $webAffected + $ucpAffected;
+        }
+
+        Setting::updateOrCreate(
+            ['key' => 'menu.web'],
+            ['value' => json_encode($webItems, JSON_UNESCAPED_SLASHES)]
+        );
+
+        Setting::updateOrCreate(
+            ['key' => 'menu.ucp'],
+            ['value' => json_encode($ucpItems, JSON_UNESCAPED_SLASHES)]
+        );
+
+        Cache::forget('site_settings');
+
+        $message = 'Menus updated successfully.';
+        if ($action === 'disable-disabled-modules') {
+            $message = "Menus updated. {$affected} item(s) were disabled because their module is disabled or missing.";
+        }
+
+        if ($action === 'remove-disabled-modules') {
+            $message = "Menus updated. {$affected} item(s) were removed because their module is disabled or missing.";
+        }
+
+        return redirect()
+            ->route('admin.menus.index')
+            ->with('success', $message);
+    }
+
+    protected function normalizeItems(array $items): array
+    {
+        $normalized = [];
+
+        foreach ($items as $item) {
+            $label = trim((string) ($item['label'] ?? ''));
+            $route = trim((string) ($item['route'] ?? ''));
+            $url = trim((string) ($item['url'] ?? ''));
+
+            if ($label === '' || ($route === '' && $url === '')) {
+                continue;
+            }
+
+            $normalized[] = [
+                'label' => $label,
+                'route' => $route,
+                'url' => $url,
+                'icon' => trim((string) ($item['icon'] ?? '')),
+                'module' => preg_replace('/[^A-Za-z0-9_]/', '', trim((string) ($item['module'] ?? ''))),
+                'auth' => in_array(($item['auth'] ?? 'any'), ['any', 'auth', 'guest'], true)
+                    ? $item['auth']
+                    : 'any',
+                'permission' => trim((string) ($item['permission'] ?? '')),
+                'enabled' => isset($item['enabled']) && (string) $item['enabled'] === '1',
+            ];
+        }
+
+        return $normalized;
+    }
+
+    protected function discoverModules(): array
+    {
+        $modulesPath = base_path('app/Modules');
+        if (!is_dir($modulesPath)) {
+            return [];
+        }
+
+        $modules = [];
+
+        foreach (glob($modulesPath . '/*', GLOB_ONLYDIR) as $moduleDir) {
+            $moduleName = basename($moduleDir);
+            $configPath = $moduleDir . DIRECTORY_SEPARATOR . 'module.json';
+            $enabled = true;
+
+            if (File::exists($configPath)) {
+                $decoded = json_decode(File::get($configPath), true);
+                if (is_array($decoded) && array_key_exists('enabled', $decoded)) {
+                    $enabled = (bool) $decoded['enabled'];
+                }
+            }
+
+            $modules[$moduleName] = $enabled;
+        }
+
+        ksort($modules);
+
+        return $modules;
+    }
+
+    protected function handleDisabledModuleItems(array $items, array $modules, string $action): array
+    {
+        $result = [];
+        $affected = 0;
+
+        foreach ($items as $item) {
+            $module = trim((string) ($item['module'] ?? ''));
+            $isProblematic = $module !== '' && (!array_key_exists($module, $modules) || !$modules[$module]);
+
+            if ($isProblematic) {
+                if ($action === 'remove-disabled-modules') {
+                    $affected++;
+                    continue;
+                }
+
+                if ($action === 'disable-disabled-modules' && (bool) ($item['enabled'] ?? true)) {
+                    $item['enabled'] = false;
+                    $affected++;
+                }
+            }
+
+            $result[] = $item;
+        }
+
+        return [$result, $affected];
+    }
+}
diff --git a/app/Modules/Admin/Http/Controllers/ModuleManagerController.php b/app/Modules/Admin/Http/Controllers/ModuleManagerController.php
new file mode 100644
index 0000000..d94d6f2
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/ModuleManagerController.php
@@ -0,0 +1,234 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Services\ModuleRegistryService;
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Artisan;
+use Illuminate\Support\Facades\File;
+
+class ModuleManagerController extends Controller
+{
+    protected string $modulesPath;
+
+    public function __construct()
+    {
+        $this->modulesPath = base_path('app/Modules');
+    }
+
+    public function index()
+    {
+        $discoveredModules = $this->discoverModules();
+        ModuleRegistryService::syncDiscoveredModules($discoveredModules);
+
+        $modules = collect($discoveredModules)
+            ->sortBy('name')
+            ->values();
+
+        return view('admin::modules.index', compact('modules'));
+    }
+
+    public function edit(string $module)
+    {
+        $moduleData = $this->getModuleDataOrFail($module);
+
+        return view('admin::modules.edit', ['module' => $moduleData]);
+    }
+
+    public function update(Request $request, string $module)
+    {
+        $moduleData = $this->getModuleDataOrFail($module);
+
+        $validated = $request->validate([
+            'name' => ['required', 'string', 'max:100'],
+            'namespace' => ['required', 'string', 'max:255'],
+            'module_type' => ['required', 'string', 'in:core,third_party'],
+            'enabled' => ['nullable', 'boolean'],
+            'routes' => ['nullable', 'boolean'],
+            'migrations' => ['nullable', 'boolean'],
+            'views' => ['nullable', 'boolean'],
+            'translations' => ['nullable', 'boolean'],
+        ]);
+
+        $config = $moduleData['config'];
+        $config['name'] = $validated['name'];
+        $config['namespace'] = $validated['namespace'];
+        $config['enabled'] = $request->boolean('enabled');
+        $config['module_type'] = $validated['module_type'];
+        $config['routes'] = $request->boolean('routes');
+        $config['migrations'] = $request->boolean('migrations');
+        $config['views'] = $request->boolean('views');
+        $config['translations'] = $request->boolean('translations');
+
+        ModuleRegistryService::upsertState(
+            $moduleData['folder'],
+            $request->boolean('enabled'),
+            $validated['module_type']
+        );
+
+        $this->saveConfig($moduleData, $config);
+
+        return redirect()
+            ->route('admin.modules.edit', $moduleData['folder'])
+            ->with('success', "Module '{$moduleData['folder']}' configuration updated successfully.");
+    }
+
+    public function toggle(string $module)
+    {
+        $moduleData = $this->getModuleDataOrFail($module);
+
+        $config = $moduleData['config'];
+        $isEnabled = (bool) $moduleData['enabled'];
+        $config['enabled'] = !$isEnabled;
+
+        ModuleRegistryService::upsertState(
+            $moduleData['folder'],
+            !$isEnabled,
+            (string) $moduleData['module_type']
+        );
+
+        $this->saveConfig($moduleData, $config);
+
+        $status = $config['enabled'] ? 'enabled' : 'disabled';
+
+        return redirect()
+            ->route('admin.modules.index')
+            ->with('success', "Module '{$moduleData['folder']}' {$status} successfully.");
+    }
+
+    public function migrate(string $module)
+    {
+        $moduleData = $this->getModuleDataOrFail($module);
+        $migrationsPath = $moduleData['migrations_path'];
+
+        if (!is_dir($migrationsPath)) {
+            return redirect()
+                ->route('admin.modules.index')
+                ->with('warning', "Module '{$moduleData['folder']}' does not have migrations.");
+        }
+
+        Artisan::call('migrate', [
+            '--path' => $migrationsPath,
+            '--realpath' => true,
+            '--force' => true,
+        ]);
+
+        $output = trim(Artisan::output());
+
+        return redirect()
+            ->route('admin.modules.index')
+            ->with('success', "Migrations executed for '{$moduleData['folder']}'. " . ($output !== '' ? $output : 'Done.'));
+    }
+
+    public function destroy(Request $request, string $module)
+    {
+        $moduleData = $this->getModuleDataOrFail($module);
+
+        if ($moduleData['folder'] === 'Admin') {
+            return redirect()
+                ->route('admin.modules.index')
+                ->with('error', 'The Admin module cannot be deleted.');
+        }
+
+        $request->validate([
+            'confirmation' => ['required', 'string'],
+        ]);
+
+        if ($request->input('confirmation') !== $moduleData['folder']) {
+            return redirect()
+                ->route('admin.modules.index')
+                ->with('error', "Confirmation text must match '{$moduleData['folder']}'.");
+        }
+
+        File::deleteDirectory($moduleData['path']);
+        ModuleRegistryService::deleteState($moduleData['folder']);
+
+        return redirect()
+            ->route('admin.modules.index')
+            ->with('success', "Module '{$moduleData['folder']}' deleted successfully.");
+    }
+
+    protected function discoverModules(): array
+    {
+        if (!is_dir($this->modulesPath)) {
+            return [];
+        }
+
+        $modules = [];
+
+        foreach (glob($this->modulesPath . '/*', GLOB_ONLYDIR) as $moduleDir) {
+            $modules[] = $this->buildModuleData(basename($moduleDir));
+        }
+
+        return $modules;
+    }
+
+    protected function getModuleDataOrFail(string $module): array
+    {
+        if (!$this->isValidModuleName($module)) {
+            abort(404);
+        }
+
+        $modulePath = $this->modulesPath . DIRECTORY_SEPARATOR . $module;
+
+        if (!is_dir($modulePath)) {
+            abort(404);
+        }
+
+        ModuleRegistryService::syncDiscoveredModules();
+
+        return $this->buildModuleData($module);
+    }
+
+    protected function buildModuleData(string $module): array
+    {
+        $modulePath = $this->modulesPath . DIRECTORY_SEPARATOR . $module;
+        $configPath = $modulePath . DIRECTORY_SEPARATOR . 'module.json';
+        $migrationsPath = $modulePath . DIRECTORY_SEPARATOR . 'Infrastructure/Database/migrations';
+
+        $config = [];
+
+        if (File::exists($configPath)) {
+            $decoded = json_decode(File::get($configPath), true);
+            if (is_array($decoded)) {
+                $config = $decoded;
+            }
+        }
+
+        $moduleState = ModuleRegistryService::getModuleState($module, [
+            'enabled' => (bool) ($config['enabled'] ?? true),
+            'module_type' => (string) ($config['module_type'] ?? 'core'),
+        ]);
+
+        return [
+            'folder' => $module,
+            'name' => $config['name'] ?? $module,
+            'enabled' => (bool) ($moduleState['enabled'] ?? true),
+            'module_type' => (string) ($moduleState['module_type'] ?? 'core'),
+            'routes' => (bool) ($config['routes'] ?? false),
+            'migrations' => (bool) ($config['migrations'] ?? false),
+            'views' => (bool) ($config['views'] ?? false),
+            'translations' => (bool) ($config['translations'] ?? false),
+            'namespace' => $config['namespace'] ?? "Modules\\{$module}",
+            'has_migrations' => is_dir($migrationsPath),
+            'migrations_path' => $migrationsPath,
+            'config_path' => $configPath,
+            'config' => $config,
+            'path' => $modulePath,
+        ];
+    }
+
+    protected function saveConfig(array $moduleData, array $config): void
+    {
+        File::put(
+            $moduleData['config_path'],
+            json_encode($config, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES) . PHP_EOL
+        );
+    }
+
+    protected function isValidModuleName(string $module): bool
+    {
+        return preg_match('/^[A-Za-z0-9_]+$/', $module) === 1;
+    }
+}
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index 70b082b..8e5082e 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -40,4 +40,16 @@
         // Settings
         Route::get('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'index'])->middleware('permission:manage.settings')->name('admin.settings.index');
         Route::post('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'store'])->middleware('permission:manage.settings')->name('admin.settings.store');
+
+        // Menus
+        Route::get('/menus', [\Modules\Admin\Http\Controllers\MenuManagerController::class, 'index'])->middleware('permission:manage.settings')->name('admin.menus.index');
+        Route::put('/menus', [\Modules\Admin\Http\Controllers\MenuManagerController::class, 'update'])->middleware('permission:manage.settings')->name('admin.menus.update');
+
+        // Modules
+        Route::get('/modules', [\Modules\Admin\Http\Controllers\ModuleManagerController::class, 'index'])->middleware('permission:manage.modules')->name('admin.modules.index');
+        Route::get('/modules/{module}/edit', [\Modules\Admin\Http\Controllers\ModuleManagerController::class, 'edit'])->middleware('permission:manage.modules')->name('admin.modules.edit');
+        Route::put('/modules/{module}', [\Modules\Admin\Http\Controllers\ModuleManagerController::class, 'update'])->middleware('permission:manage.modules')->name('admin.modules.update');
+        Route::patch('/modules/{module}/toggle', [\Modules\Admin\Http\Controllers\ModuleManagerController::class, 'toggle'])->middleware('permission:manage.modules')->name('admin.modules.toggle');
+        Route::post('/modules/{module}/migrate', [\Modules\Admin\Http\Controllers\ModuleManagerController::class, 'migrate'])->middleware('permission:manage.modules')->name('admin.modules.migrate');
+        Route::delete('/modules/{module}', [\Modules\Admin\Http\Controllers\ModuleManagerController::class, 'destroy'])->middleware('permission:manage.modules')->name('admin.modules.destroy');
     });
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index 7dd1b52..1b24cd1 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -3,215 +3,327 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>{{ config('app.name', 'NexusCMS') }} - @yield('title', 'AdminCP - Dashboard')</title>
-    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css">
-    <link href="https://fonts.googleapis.com/css2?family=Cinzel:wght@400;700&family=Inter:wght@300;400;600&display=swap" rel="stylesheet">
+    <title>{{ config('app.name', 'NexusCMS') }} · @yield('title', 'Dashboard')</title>
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.0/css/all.min.css">
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
     @vite(['resources/css/app.css', 'resources/js/app.js'])
     @yield('styles')
     <style>
-        /* Custom scrollbar for webkit browsers */
-        .custom-scrollbar::-webkit-scrollbar {
-            width: 6px;
-        }
-        .custom-scrollbar::-webkit-scrollbar-track {
-            background: #1f2937; /* gray-800 */
-        }
-        .custom-scrollbar::-webkit-scrollbar-thumb {
-            background-color: #4b5563; /* gray-600 */
-            border-radius: 3px;
-        }
-        .custom-scrollbar::-webkit-scrollbar-thumb:hover {
-            background-color: #6b7280; /* gray-500 */
-        }
-        /* Firefox */
-        .custom-scrollbar {
-            scrollbar-width: thin;
-            scrollbar-color: #4b5563 #1f2937;
+        body { font-family: 'Inter', sans-serif; }
+
+        /* Sidebar scrollbar */
+        .sidebar-scroll::-webkit-scrollbar { width: 4px; }
+        .sidebar-scroll::-webkit-scrollbar-track { background: transparent; }
+        .sidebar-scroll::-webkit-scrollbar-thumb { background: #374151; border-radius: 4px; }
+        .sidebar-scroll::-webkit-scrollbar-thumb:hover { background: #4b5563; }
+        .sidebar-scroll { scrollbar-width: thin; scrollbar-color: #374151 transparent; }
+
+        /* Nav item active indicator */
+        .nav-item-active::before {
+            content: '';
+            position: absolute;
+            left: 0;
+            top: 50%;
+            transform: translateY(-50%);
+            width: 3px;
+            height: 60%;
+            background: #3b82f6;
+            border-radius: 0 3px 3px 0;
         }
+
+        /* Mobile overlay */
+        #sidebar-overlay { transition: opacity 0.2s ease; }
+
+        /* Sidebar slide */
+        #sidebar { transition: transform 0.25s cubic-bezier(0.4,0,0.2,1); }
     </style>
 </head>
-<body class="bg-gray-100">
-    <div class="flex h-screen overflow-hidden">
-        <!-- Sidebar -->
-        <aside class="w-64 bg-gray-900 text-white flex-shrink-0 hidden md:flex flex-col">
-            <!-- Logo -->
-            <div class="h-16 flex items-center px-6 bg-gray-800 border-b border-gray-700">
-                <div class="flex items-center gap-2">
-                    <div class="w-8 h-8 bg-blue-600 rounded flex items-center justify-center font-bold">
-                        N
-                    </div>
-                    <span class="text-lg font-bold">AdminCP</span>
-                </div>
+<body class="bg-gray-50 text-gray-900 antialiased">
+
+<div class="flex h-screen overflow-hidden">
+
+    {{-- ─── Mobile overlay ─────────────────────────────────────────────── --}}
+    <div id="sidebar-overlay"
+         class="fixed inset-0 bg-black/50 z-20 hidden md:hidden"
+         onclick="closeSidebar()"></div>
+
+    {{-- ─── Sidebar ─────────────────────────────────────────────────────── --}}
+    <aside id="sidebar"
+           class="fixed md:relative z-30 w-64 h-full bg-[#0f1117] text-white flex flex-col flex-shrink-0
+                  -translate-x-full md:translate-x-0">
+
+        {{-- Logo / Brand --}}
+        <div class="flex items-center gap-3 px-5 h-16 border-b border-white/[0.06] shrink-0">
+            <div class="w-8 h-8 rounded-lg bg-blue-600 flex items-center justify-center shrink-0">
+                <svg class="w-4 h-4 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2.5"
+                          d="M13 10V3L4 14h7v7l9-11h-7z"/>
+                </svg>
             </div>
+            <div class="leading-tight">
+                <span class="text-sm font-bold tracking-tight text-white">{{ config('app.name', 'NexusCMS') }}</span>
+                <span class="block text-[10px] font-medium text-blue-400 uppercase tracking-widest">Admin Panel</span>
+            </div>
+        </div>
 
-            <!-- Navigation -->
-            <nav class="flex-1 overflow-y-auto py-4 custom-scrollbar">
-                <div class="px-3 mb-4">
-                    <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Main</h3>
-                    @can('access.admin.panel')
-                    <a href="{{ route('admin.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.index') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
-                        <i class="fas fa-home w-5"></i>
-                        <span>Dashboard</span>
-                    </a>
-                    @endcan
-                    @can('access.admin.panel')
-                    <a href="{{ route('admin.analytics.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.analytics.index') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
-                        <i class="fas fa-chart-line w-5"></i>
-                        <span>Analytics</span>
-                    </a>
-                    @endcan
-                </div>
+        {{-- Navigation --}}
+        <nav class="flex-1 overflow-y-auto sidebar-scroll py-4 px-3 space-y-6">
 
-                <div class="px-3 mb-4">
-                    <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Management</h3>
-                    @can('manage.admin.users')
-                    <a href="{{ route('admin.users.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.users.*') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
-                        <i class="fas fa-users w-5"></i>
-                        <span>Users</span>
-                    </a>
-                    @endcan
-                    @can('manage.characters')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
-                        <i class="fas fa-user-shield w-5"></i>
-                        <span>Characters</span>
-                    </a>
-                    @endcan
-                    @can('manage.bans')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
-                        <i class="fas fa-ban w-5"></i>
-                        <span>Bans</span>
-                    </a>
-                    @endcan
-                    @can('manage.reports')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
-                        <i class="fas fa-exclamation-triangle w-5"></i>
-                        <span>Reports</span>
-                        <span class="ml-auto bg-red-500 text-xs px-2 py-0.5 rounded-full">12</span>
-                    </a>
-                    @endcan
-                </div>
+            {{-- ── Main ── --}}
+            <div>
+                <p class="px-3 mb-1.5 text-[10px] font-semibold uppercase tracking-widest text-gray-500 select-none">Main</p>
+                @can('access.admin.panel')
+                @php $active = request()->routeIs('admin.index'); @endphp
+                <a href="{{ route('admin.index') }}"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                    <i class="fas fa-house-chimney w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
+                    Dashboard
+                </a>
+                @endcan
+                @can('access.admin.panel')
+                @php $active = request()->routeIs('admin.analytics.index'); @endphp
+                <a href="{{ route('admin.analytics.index') }}"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                    <i class="fas fa-chart-line w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
+                    Analytics
+                </a>
+                @endcan
+            </div>
 
-                <div class="px-3 mb-4">
-                    <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Content</h3>
-                    @can('manage.news')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
-                        <i class="fas fa-newspaper w-5"></i>
-                        <span>News</span>
-                    </a>
-                    @endcan
-                    @can('manage.pages')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
-                        <i class="fas fa-file-alt w-5"></i>
-                        <span>Pages</span>
-                    </a>
-                    @endcan
-                    @can('manage.announcements')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
-                        <i class="fas fa-bullhorn w-5"></i>
-                        <span>Announcements</span>
-                    </a>
-                    @endcan
-                </div>
+            {{-- ── Management ── --}}
+            <div>
+                <p class="px-3 mb-1.5 text-[10px] font-semibold uppercase tracking-widest text-gray-500 select-none">Management</p>
+                @can('manage.admin.users')
+                @php $active = request()->routeIs('admin.users.*'); @endphp
+                <a href="{{ route('admin.users.index') }}"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                    <i class="fas fa-users w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
+                    Users
+                </a>
+                @endcan
+                @can('manage.characters')
+                <a href="#"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
+                    <i class="fas fa-shield-halved w-4 text-center"></i>
+                    Characters
+                </a>
+                @endcan
+                @can('manage.bans')
+                <a href="#"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
+                    <i class="fas fa-ban w-4 text-center"></i>
+                    Bans
+                </a>
+                @endcan
+                @can('manage.reports')
+                <a href="#"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
+                    <i class="fas fa-flag w-4 text-center"></i>
+                    Reports
+                    <span class="ml-auto inline-flex items-center justify-center w-5 h-5 text-[10px] font-bold bg-red-500 text-white rounded-full">12</span>
+                </a>
+                @endcan
+            </div>
 
-                <div class="px-3 mb-4">
-                    <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Store</h3>
-                    @can('manage.store.products')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
-                        <i class="fas fa-shopping-cart w-5"></i>
-                        <span>Products</span>
-                    </a>
-                    @endcan
-                    @can('manage.store.categories')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
-                        <i class="fas fa-tags w-5"></i>
-                        <span>Categories</span>
-                    </a>
-                    @endcan
-                    @can('view.store.transactions')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
-                        <i class="fas fa-receipt w-5"></i>
-                        <span>Transactions</span>
-                    </a>
-                    @endcan
-                </div>
+            {{-- ── Content ── --}}
+            <div>
+                <p class="px-3 mb-1.5 text-[10px] font-semibold uppercase tracking-widest text-gray-500 select-none">Content</p>
+                @can('manage.news')
+                <a href="#"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
+                    <i class="fas fa-newspaper w-4 text-center"></i>
+                    News
+                </a>
+                @endcan
+                @can('manage.pages')
+                <a href="#"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
+                    <i class="fas fa-file-lines w-4 text-center"></i>
+                    Pages
+                </a>
+                @endcan
+                @can('manage.announcements')
+                <a href="#"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
+                    <i class="fas fa-bullhorn w-4 text-center"></i>
+                    Announcements
+                </a>
+                @endcan
+            </div>
 
-                <div class="px-3 mb-4">
-                    <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">Realms</h3>
-                    @can('manage.realms')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
-                        <i class="fas fa-server w-5"></i>
-                        <span>Realm Management</span>
-                    </a>
-                    @endcan
-                    @can('manage.realms')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
-                        <i class="fas fa-database w-5"></i>
-                        <span>Database</span>
-                    </a>
-                    @endcan
-                    @can('manage.realms')
-                    <a href="#" class="flex items-center gap-3 px-3 py-2 hover:bg-gray-800 rounded-lg mb-1 text-gray-300 hover:text-white transition">
-                        <i class="fas fa-envelope w-5"></i>
-                        <span>In-Game Mail</span>
-                    </a>
-                    @endcan
-                </div>
+            {{-- ── Store ── --}}
+            <div>
+                <p class="px-3 mb-1.5 text-[10px] font-semibold uppercase tracking-widest text-gray-500 select-none">Store</p>
+                @can('manage.store.products')
+                <a href="#"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
+                    <i class="fas fa-bag-shopping w-4 text-center"></i>
+                    Products
+                </a>
+                @endcan
+                @can('manage.store.categories')
+                <a href="#"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
+                    <i class="fas fa-tags w-4 text-center"></i>
+                    Categories
+                </a>
+                @endcan
+                @can('view.store.transactions')
+                <a href="#"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
+                    <i class="fas fa-receipt w-4 text-center"></i>
+                    Transactions
+                </a>
+                @endcan
+            </div>
+
+            {{-- ── Realms ── --}}
+            <div>
+                <p class="px-3 mb-1.5 text-[10px] font-semibold uppercase tracking-widest text-gray-500 select-none">Realms</p>
+                @can('manage.realms')
+                <a href="#"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
+                    <i class="fas fa-server w-4 text-center"></i>
+                    Realm Management
+                </a>
+                <a href="#"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
+                    <i class="fas fa-database w-4 text-center"></i>
+                    Database
+                </a>
+                <a href="#"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
+                    <i class="fas fa-envelope w-4 text-center"></i>
+                    In-Game Mail
+                </a>
+                @endcan
+            </div>
+
+            {{-- ── System ── --}}
+            <div>
+                <p class="px-3 mb-1.5 text-[10px] font-semibold uppercase tracking-widest text-gray-500 select-none">System</p>
+                @can('manage.roles')
+                @php $active = request()->routeIs('admin.roles.*'); @endphp
+                <a href="{{ route('admin.roles.index') }}"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                    <i class="fas fa-user-lock w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
+                    Roles & Permissions
+                </a>
+                @endcan
+                @can('manage.settings')
+                @php $active = request()->routeIs('admin.settings.*'); @endphp
+                <a href="{{ route('admin.settings.index') }}"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                    <i class="fas fa-sliders w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
+                    Settings
+                </a>
+                @endcan
+                @can('view.logs')
+                @php $active = request()->routeIs('admin.logs.*'); @endphp
+                <a href="{{ route('admin.logs.index') }}"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                    <i class="fas fa-terminal w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
+                    Logs
+                </a>
+                @endcan
+                @can('manage.backups')
+                @php $active = request()->routeIs('admin.backups.*'); @endphp
+                <a href="{{ route('admin.backups.index') }}"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                    <i class="fas fa-cloud-arrow-down w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
+                    Backups
+                </a>
+                @endcan
+                @can('manage.modules')
+                @php $active = request()->routeIs('admin.modules.*'); @endphp
+                <a href="{{ route('admin.modules.index') }}"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                    <i class="fas fa-puzzle-piece w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
+                    Modules
+                </a>
+                @endcan
+            </div>
 
-                <div class="px-3 mb-4">
-                    <h3 class="text-xs font-semibold text-gray-400 uppercase tracking-wider mb-2">System</h3>
-                    @can('manage.roles')
-                    <a href="{{ route('admin.roles.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.roles.*') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
-                        <i class="fas fa-user-shield w-5"></i>
-                        <span>Roles & Permissions</span>
-                    </a>
-                    @endcan
-                    @can('manage.settings')
-                    <a href="{{ route('admin.settings.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.settings.*') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
-                        <i class="fas fa-cog w-5"></i>
-                        <span>Settings</span>
-                    </a>
-                    @endcan
-                    @can('view.logs')
-                    <a href="{{ route('admin.logs.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.logs.*') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
-                        <i class="fas fa-terminal w-5"></i>
-                        <span>Logs</span>
-                    </a>
-                    @endcan
-                    @can('manage.backups')
-                    <a href="{{ route('admin.backups.index') }}" class="flex items-center gap-3 px-3 py-2 rounded-lg mb-1 transition {{ request()->routeIs('admin.backups.*') ? 'bg-blue-600 text-white' : 'text-gray-300 hover:bg-gray-800 hover:text-white' }}">
-                        <i class="fas fa-download w-5"></i>
-                        <span>Backups</span>
-                    </a>
-                    @endcan
+        </nav>
+
+        {{-- User footer --}}
+        <div class="shrink-0 border-t border-white/[0.06] px-4 py-3">
+            <div class="flex items-center gap-3">
+                {{-- Avatar with initials --}}
+                <div class="w-8 h-8 rounded-full bg-gradient-to-br from-blue-500 to-blue-700 flex items-center justify-center text-xs font-bold shrink-0 uppercase select-none">
+                    {{ substr(Auth::user()->name, 0, 1) }}
                 </div>
-            </nav>
-
-            <!-- User Info -->
-            <div class="p-4 bg-gray-800 border-t border-gray-700">
-                <div class="flex items-center gap-3">
-                    <div class="w-10 h-10 bg-blue-600 rounded-full flex items-center justify-center font-bold">
-                        A
-                    </div>
-                    <div class="flex-1 min-w-0">
-                        <div class="text-sm font-semibold truncate">{{ Auth::user()->name }}</div>
-                        <div class="text-xs text-gray-400">{{ Auth::user()->roles->pluck('name')->join(', ') }}</div>
-                    </div>
-                    <a href="" class="text-gray-400 hover:text-white">
-                        <i class="fas fa-cog"></i>
-                    </a>
-                    <form method="POST" action="{{ route('logout') }}" class="inline">
-                        @csrf
-                        <button type="submit" class="text-gray-400 hover:text-white">
-                            <i class="fas fa-sign-out-alt"></i>
-                        </button>
-                    </form>
+                <div class="flex-1 min-w-0">
+                    <p class="text-sm font-semibold text-white truncate leading-tight">{{ Auth::user()->name }}</p>
+                    <p class="text-[11px] text-gray-500 truncate leading-tight">{{ Auth::user()->roles->pluck('name')->join(', ') }}</p>
                 </div>
+                <form method="POST" action="{{ route('logout') }}" class="shrink-0">
+                    @csrf
+                    <button type="submit"
+                            title="Sign out"
+                            class="w-7 h-7 flex items-center justify-center rounded-md text-gray-500 hover:text-red-400 hover:bg-red-400/10 transition">
+                        <i class="fas fa-arrow-right-from-bracket text-xs"></i>
+                    </button>
+                </form>
             </div>
-        </aside>
-        <div class="flex-1 flex flex-col overflow-hidden">
-            @yield('content')
         </div>
+
+    </aside>
+
+    {{-- ─── Main area ───────────────────────────────────────────────────── --}}
+    <div class="flex-1 flex flex-col min-w-0 overflow-hidden">
+
+        {{-- Top bar (mobile) --}}
+        <header class="md:hidden h-14 bg-white border-b border-gray-200 flex items-center justify-between px-4 shrink-0 z-10">
+            <button onclick="openSidebar()"
+                    class="w-9 h-9 flex items-center justify-center rounded-lg text-gray-500 hover:bg-gray-100 transition">
+                <i class="fas fa-bars"></i>
+            </button>
+            <span class="text-sm font-semibold text-gray-800">@yield('title', 'Dashboard')</span>
+            <div class="w-9 h-9 rounded-full bg-blue-600 flex items-center justify-center text-xs font-bold text-white uppercase">
+                {{ substr(Auth::user()->name, 0, 1) }}
+            </div>
+        </header>
+
+        {{-- Page content --}}
+        <main class="flex-1 overflow-y-auto">
+            @yield('content')
+        </main>
+
     </div>
-    @stack('scripts')
+</div>
+
+<script>
+    function openSidebar() {
+        document.getElementById('sidebar').classList.remove('-translate-x-full');
+        document.getElementById('sidebar-overlay').classList.remove('hidden');
+    }
+    function closeSidebar() {
+        document.getElementById('sidebar').classList.add('-translate-x-full');
+        document.getElementById('sidebar-overlay').classList.add('hidden');
+    }
+</script>
+
+@stack('scripts')
 </body>
 </html>
diff --git a/app/Modules/Admin/Resources/views/menus/index.blade.php b/app/Modules/Admin/Resources/views/menus/index.blade.php
new file mode 100644
index 0000000..d7db0a8
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/menus/index.blade.php
@@ -0,0 +1,183 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Menu Manager')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div>
+        <h1 class="text-2xl font-bold text-gray-800">Menu Manager</h1>
+        <p class="text-sm text-gray-500">Configure Web and UCP menus with module-aware safety rules.</p>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if(session('success'))
+        <div class="mb-6 p-4 bg-green-50 border-l-4 border-green-500 rounded-lg flex items-center gap-3">
+            <i class="fas fa-check-circle text-green-600"></i>
+            <p class="text-green-700 text-sm font-medium">{{ session('success') }}</p>
+        </div>
+    @endif
+
+    <div class="grid grid-cols-1 md:grid-cols-4 gap-4 mb-6">
+        <div class="bg-white rounded-xl border border-gray-200 p-4">
+            <p class="text-xs uppercase tracking-wider text-gray-500">Modules</p>
+            <p class="text-2xl font-bold text-gray-800 mt-1">{{ count($modules) }}</p>
+        </div>
+        <div class="bg-white rounded-xl border border-gray-200 p-4">
+            <p class="text-xs uppercase tracking-wider text-gray-500">Enabled Modules</p>
+            <p class="text-2xl font-bold text-green-700 mt-1">{{ collect($modules)->filter(fn ($enabled) => $enabled === true)->count() }}</p>
+        </div>
+        <div class="bg-white rounded-xl border border-gray-200 p-4">
+            <p class="text-xs uppercase tracking-wider text-gray-500">Disabled Modules</p>
+            <p class="text-2xl font-bold text-red-700 mt-1">{{ collect($modules)->filter(fn ($enabled) => $enabled === false)->count() }}</p>
+        </div>
+        <div class="bg-white rounded-xl border border-gray-200 p-4">
+            <p class="text-xs uppercase tracking-wider text-gray-500">Menu Items</p>
+            <p class="text-2xl font-bold text-blue-700 mt-1">{{ count($webMenu) + count($ucpMenu) }}</p>
+        </div>
+    </div>
+
+    <form method="POST" action="{{ route('admin.menus.update') }}" class="space-y-6">
+        @csrf
+        @method('PUT')
+
+        <div class="bg-amber-50 border border-amber-200 rounded-xl p-4 flex flex-col lg:flex-row lg:items-center lg:justify-between gap-3">
+            <div>
+                <p class="text-sm font-semibold text-amber-900">Disabled module safety tools</p>
+                <p class="text-xs text-amber-800">Use these actions to avoid broken links when a module is disabled or removed.</p>
+            </div>
+            <div class="flex gap-2">
+                <button type="submit" name="action" value="disable-disabled-modules" class="px-3 py-2 rounded-lg text-sm bg-yellow-100 text-yellow-800 hover:bg-yellow-200">
+                    <i class="fas fa-toggle-off mr-1"></i>Disable Items of Disabled Modules
+                </button>
+                <button type="submit" name="action" value="remove-disabled-modules" class="px-3 py-2 rounded-lg text-sm bg-red-100 text-red-800 hover:bg-red-200" onclick="return confirm('This will permanently remove all menu items linked to disabled or missing modules. Continue?')">
+                    <i class="fas fa-trash mr-1"></i>Delete Items of Disabled Modules
+                </button>
+            </div>
+        </div>
+
+        <div class="bg-white rounded-xl shadow border border-gray-200">
+            <div class="p-6 border-b border-gray-200 flex items-center justify-between bg-gradient-to-r from-slate-50 to-white">
+                <div>
+                    <h2 class="text-lg font-bold text-gray-800">Web Menu</h2>
+                    <p class="text-sm text-gray-500">Top navigation in frontend layout.</p>
+                </div>
+                <button type="button" onclick="addMenuRow('web-menu-body', 'web_items')" class="px-3 py-2 rounded-lg text-sm bg-blue-50 text-blue-700 hover:bg-blue-100 border border-blue-200">
+                    <i class="fas fa-plus mr-1"></i>Add Item
+                </button>
+            </div>
+            <div class="p-6 overflow-x-auto">
+                <table class="min-w-full divide-y divide-gray-200 text-sm">
+                    <thead class="bg-gray-50">
+                        <tr>
+                            <th class="px-3 py-2 text-left">Label</th>
+                            <th class="px-3 py-2 text-left">Module</th>
+                            <th class="px-3 py-2 text-left">Route</th>
+                            <th class="px-3 py-2 text-left">URL</th>
+                            <th class="px-3 py-2 text-left">Icon</th>
+                            <th class="px-3 py-2 text-left">Auth</th>
+                            <th class="px-3 py-2 text-left">Permission</th>
+                            <th class="px-3 py-2 text-left">Enabled</th>
+                            <th class="px-3 py-2 text-right">Action</th>
+                        </tr>
+                    </thead>
+                    <tbody id="web-menu-body" class="divide-y divide-gray-100">
+                        @foreach($webMenu as $index => $item)
+                            @include('admin::menus.partials.row', ['prefix' => 'web_items', 'index' => $index, 'item' => $item, 'modules' => $modules])
+                        @endforeach
+                    </tbody>
+                </table>
+            </div>
+        </div>
+
+        <div class="bg-white rounded-xl shadow border border-gray-200">
+            <div class="p-6 border-b border-gray-200 flex items-center justify-between bg-gradient-to-r from-slate-50 to-white">
+                <div>
+                    <h2 class="text-lg font-bold text-gray-800">UCP Menu</h2>
+                    <p class="text-sm text-gray-500">Sidebar navigation in UCP pages.</p>
+                </div>
+                <button type="button" onclick="addMenuRow('ucp-menu-body', 'ucp_items')" class="px-3 py-2 rounded-lg text-sm bg-blue-50 text-blue-700 hover:bg-blue-100 border border-blue-200">
+                    <i class="fas fa-plus mr-1"></i>Add Item
+                </button>
+            </div>
+            <div class="p-6 overflow-x-auto">
+                <table class="min-w-full divide-y divide-gray-200 text-sm">
+                    <thead class="bg-gray-50">
+                        <tr>
+                            <th class="px-3 py-2 text-left">Label</th>
+                            <th class="px-3 py-2 text-left">Module</th>
+                            <th class="px-3 py-2 text-left">Route</th>
+                            <th class="px-3 py-2 text-left">URL</th>
+                            <th class="px-3 py-2 text-left">Icon</th>
+                            <th class="px-3 py-2 text-left">Auth</th>
+                            <th class="px-3 py-2 text-left">Permission</th>
+                            <th class="px-3 py-2 text-left">Enabled</th>
+                            <th class="px-3 py-2 text-right">Action</th>
+                        </tr>
+                    </thead>
+                    <tbody id="ucp-menu-body" class="divide-y divide-gray-100">
+                        @foreach($ucpMenu as $index => $item)
+                            @include('admin::menus.partials.row', ['prefix' => 'ucp_items', 'index' => $index, 'item' => $item, 'modules' => $modules])
+                        @endforeach
+                    </tbody>
+                </table>
+            </div>
+        </div>
+
+        <div class="flex items-center justify-end">
+            <button type="submit" name="action" value="save" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                <i class="fas fa-save mr-2"></i>Save Menus
+            </button>
+        </div>
+    </form>
+</main>
+
+<template id="menu-row-template">
+    <tr>
+        <td class="px-3 py-2"><input type="text" class="w-full rounded border-gray-300" data-field="label" placeholder="Label"></td>
+        <td class="px-3 py-2">
+            <select class="w-full rounded border-gray-300" data-field="module">
+                <option value="">Core / No Module</option>
+                @foreach($modules as $moduleName => $isEnabled)
+                    <option value="{{ $moduleName }}">{{ $moduleName }} {{ $isEnabled ? '(enabled)' : '(disabled)' }}</option>
+                @endforeach
+            </select>
+        </td>
+        <td class="px-3 py-2"><input type="text" class="w-full rounded border-gray-300" data-field="route" placeholder="route.name"></td>
+        <td class="px-3 py-2"><input type="text" class="w-full rounded border-gray-300" data-field="url" placeholder="/custom-url"></td>
+        <td class="px-3 py-2"><input type="text" class="w-full rounded border-gray-300" data-field="icon" placeholder="fas fa-home"></td>
+        <td class="px-3 py-2">
+            <select class="w-full rounded border-gray-300" data-field="auth">
+                <option value="any">Any</option>
+                <option value="auth">Auth</option>
+                <option value="guest">Guest</option>
+            </select>
+        </td>
+        <td class="px-3 py-2"><input type="text" class="w-full rounded border-gray-300" data-field="permission" placeholder="permission.name"></td>
+        <td class="px-3 py-2 text-center"><input type="checkbox" value="1" data-field="enabled" checked></td>
+        <td class="px-3 py-2 text-right">
+            <button type="button" class="px-2 py-1 text-xs rounded bg-red-50 text-red-700 hover:bg-red-100" onclick="this.closest('tr').remove()">Remove</button>
+        </td>
+    </tr>
+</template>
+@endsection
+
+@push('scripts')
+<script>
+    function bindRowInputs(row, prefix, index) {
+        row.querySelectorAll('[data-field]').forEach((element) => {
+            const field = element.getAttribute('data-field');
+            element.setAttribute('name', `${prefix}[${index}][${field}]`);
+        });
+    }
+
+    function addMenuRow(tbodyId, prefix) {
+        const tbody = document.getElementById(tbodyId);
+        const template = document.getElementById('menu-row-template');
+        const row = template.content.firstElementChild.cloneNode(true);
+        const index = tbody.querySelectorAll('tr').length;
+        bindRowInputs(row, prefix, index);
+        tbody.appendChild(row);
+    }
+</script>
+@endpush
diff --git a/app/Modules/Admin/Resources/views/menus/partials/row.blade.php b/app/Modules/Admin/Resources/views/menus/partials/row.blade.php
new file mode 100644
index 0000000..2890d12
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/menus/partials/row.blade.php
@@ -0,0 +1,52 @@
+<tr>
+    <td class="px-3 py-2">
+        <input type="text" name="{{ $prefix }}[{{ $index }}][label]" value="{{ $item['label'] ?? '' }}" class="w-full rounded border-gray-300" placeholder="Label">
+    </td>
+    <td class="px-3 py-2">
+        @php
+            $selectedModule = $item['module'] ?? '';
+            $moduleExists = $selectedModule === '' || array_key_exists($selectedModule, $modules);
+            $moduleEnabled = $selectedModule === '' || (($modules[$selectedModule] ?? false) === true);
+        @endphp
+        <div class="space-y-1">
+            <select name="{{ $prefix }}[{{ $index }}][module]" class="w-full rounded border-gray-300">
+                <option value="">Core / No Module</option>
+                @foreach($modules as $moduleName => $isEnabled)
+                    <option value="{{ $moduleName }}" {{ $selectedModule === $moduleName ? 'selected' : '' }}>
+                        {{ $moduleName }} {{ $isEnabled ? '(enabled)' : '(disabled)' }}
+                    </option>
+                @endforeach
+            </select>
+            @if(!$moduleExists)
+                <p class="text-xs text-red-600">Assigned module does not exist.</p>
+            @elseif(!$moduleEnabled)
+                <p class="text-xs text-amber-600">Assigned module is disabled.</p>
+            @endif
+        </div>
+    </td>
+    <td class="px-3 py-2">
+        <input type="text" name="{{ $prefix }}[{{ $index }}][route]" value="{{ $item['route'] ?? '' }}" class="w-full rounded border-gray-300" placeholder="route.name">
+    </td>
+    <td class="px-3 py-2">
+        <input type="text" name="{{ $prefix }}[{{ $index }}][url]" value="{{ $item['url'] ?? '' }}" class="w-full rounded border-gray-300" placeholder="/custom-url">
+    </td>
+    <td class="px-3 py-2">
+        <input type="text" name="{{ $prefix }}[{{ $index }}][icon]" value="{{ $item['icon'] ?? '' }}" class="w-full rounded border-gray-300" placeholder="fas fa-home">
+    </td>
+    <td class="px-3 py-2">
+        <select name="{{ $prefix }}[{{ $index }}][auth]" class="w-full rounded border-gray-300">
+            <option value="any" {{ ($item['auth'] ?? 'any') === 'any' ? 'selected' : '' }}>Any</option>
+            <option value="auth" {{ ($item['auth'] ?? 'any') === 'auth' ? 'selected' : '' }}>Auth</option>
+            <option value="guest" {{ ($item['auth'] ?? 'any') === 'guest' ? 'selected' : '' }}>Guest</option>
+        </select>
+    </td>
+    <td class="px-3 py-2">
+        <input type="text" name="{{ $prefix }}[{{ $index }}][permission]" value="{{ $item['permission'] ?? '' }}" class="w-full rounded border-gray-300" placeholder="permission.name">
+    </td>
+    <td class="px-3 py-2 text-center">
+        <input type="checkbox" name="{{ $prefix }}[{{ $index }}][enabled]" value="1" {{ ($item['enabled'] ?? true) ? 'checked' : '' }}>
+    </td>
+    <td class="px-3 py-2 text-right">
+        <button type="button" class="px-2 py-1 text-xs rounded bg-red-50 text-red-700 hover:bg-red-100" onclick="this.closest('tr').remove()">Remove</button>
+    </td>
+</tr>
diff --git a/app/Modules/Admin/Resources/views/modules/edit.blade.php b/app/Modules/Admin/Resources/views/modules/edit.blade.php
new file mode 100644
index 0000000..a1d570f
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/modules/edit.blade.php
@@ -0,0 +1,110 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Configure Module')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">Configure Module</h1>
+    </div>
+    <a href="{{ route('admin.modules.index') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
+        <i class="fas fa-arrow-left mr-2"></i>Back to Modules
+    </a>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if(session('success'))
+        <div class="mb-6 p-4 bg-green-50 border-l-4 border-green-500 rounded-lg flex items-center gap-3">
+            <i class="fas fa-check-circle text-green-600"></i>
+            <p class="text-green-700 text-sm font-medium">{{ session('success') }}</p>
+        </div>
+    @endif
+
+    @if($errors->any())
+        <div class="mb-6 p-4 bg-red-50 border-l-4 border-red-500 rounded-lg">
+            <p class="text-red-700 text-sm font-medium mb-2">Please fix the following errors:</p>
+            <ul class="text-sm text-red-700 list-disc list-inside">
+                @foreach($errors->all() as $error)
+                    <li>{{ $error }}</li>
+                @endforeach
+            </ul>
+        </div>
+    @endif
+
+    <div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
+        <div class="lg:col-span-2 bg-white rounded-lg shadow p-6">
+            <h2 class="text-lg font-bold text-gray-800 mb-4">{{ $module['name'] }} <span class="text-sm font-medium text-gray-500">({{ $module['folder'] }})</span></h2>
+
+            <form method="POST" action="{{ route('admin.modules.update', $module['folder']) }}" class="space-y-6">
+                @csrf
+                @method('PUT')
+
+                <div>
+                    <label for="name" class="block text-sm font-medium text-gray-700 mb-1">Display Name</label>
+                    <input type="text" id="name" name="name" value="{{ old('name', $module['name']) }}" class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500" required>
+                </div>
+
+                <div>
+                    <label for="namespace" class="block text-sm font-medium text-gray-700 mb-1">Namespace</label>
+                    <input type="text" id="namespace" name="namespace" value="{{ old('namespace', $module['namespace']) }}" class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500" required>
+                </div>
+
+                <div>
+                    <label for="module_type" class="block text-sm font-medium text-gray-700 mb-1">Module Type</label>
+                    <select id="module_type" name="module_type" class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500" required>
+                        <option value="core" {{ old('module_type', $module['module_type']) === 'core' ? 'selected' : '' }}>Core</option>
+                        <option value="third_party" {{ old('module_type', $module['module_type']) === 'third_party' ? 'selected' : '' }}>Third Party</option>
+                    </select>
+                </div>
+
+                <div class="grid grid-cols-1 md:grid-cols-2 gap-4">
+                    <label class="flex items-center gap-2 text-sm text-gray-700">
+                        <input type="checkbox" name="enabled" value="1" class="rounded border-gray-300 text-blue-600 focus:ring-blue-500" {{ old('enabled', $module['enabled']) ? 'checked' : '' }}>
+                        Enabled
+                    </label>
+                    <label class="flex items-center gap-2 text-sm text-gray-700">
+                        <input type="checkbox" name="routes" value="1" class="rounded border-gray-300 text-blue-600 focus:ring-blue-500" {{ old('routes', $module['routes']) ? 'checked' : '' }}>
+                        Load Routes
+                    </label>
+                    <label class="flex items-center gap-2 text-sm text-gray-700">
+                        <input type="checkbox" name="migrations" value="1" class="rounded border-gray-300 text-blue-600 focus:ring-blue-500" {{ old('migrations', $module['migrations']) ? 'checked' : '' }}>
+                        Load Migrations
+                    </label>
+                    <label class="flex items-center gap-2 text-sm text-gray-700">
+                        <input type="checkbox" name="views" value="1" class="rounded border-gray-300 text-blue-600 focus:ring-blue-500" {{ old('views', $module['views']) ? 'checked' : '' }}>
+                        Load Views
+                    </label>
+                    <label class="flex items-center gap-2 text-sm text-gray-700 md:col-span-2">
+                        <input type="checkbox" name="translations" value="1" class="rounded border-gray-300 text-blue-600 focus:ring-blue-500" {{ old('translations', $module['translations']) ? 'checked' : '' }}>
+                        Load Translations
+                    </label>
+                </div>
+
+                <div class="pt-2">
+                    <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                        <i class="fas fa-save mr-2"></i>Save Configuration
+                    </button>
+                </div>
+            </form>
+        </div>
+
+        <div class="bg-white rounded-lg shadow p-6">
+            <h3 class="text-md font-bold text-gray-800 mb-3">Module Info</h3>
+            <dl class="space-y-2 text-sm">
+                <div>
+                    <dt class="text-gray-500">Folder</dt>
+                    <dd class="text-gray-800 font-medium">{{ $module['folder'] }}</dd>
+                </div>
+                <div>
+                    <dt class="text-gray-500">Config file</dt>
+                    <dd class="text-gray-800 break-all">{{ $module['config_path'] }}</dd>
+                </div>
+                <div>
+                    <dt class="text-gray-500">Migrations path</dt>
+                    <dd class="text-gray-800 break-all">{{ $module['migrations_path'] }}</dd>
+                </div>
+            </dl>
+        </div>
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/modules/index.blade.php b/app/Modules/Admin/Resources/views/modules/index.blade.php
new file mode 100644
index 0000000..41007b8
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/modules/index.blade.php
@@ -0,0 +1,198 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Modules')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">Modules</h1>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if(session('success'))
+        <div class="mb-6 p-4 bg-green-50 border-l-4 border-green-500 rounded-lg flex items-center gap-3">
+            <i class="fas fa-check-circle text-green-600"></i>
+            <p class="text-green-700 text-sm font-medium">{{ session('success') }}</p>
+        </div>
+    @endif
+
+    @if(session('warning'))
+        <div class="mb-6 p-4 bg-yellow-50 border-l-4 border-yellow-500 rounded-lg flex items-center gap-3">
+            <i class="fas fa-exclamation-triangle text-yellow-600"></i>
+            <p class="text-yellow-700 text-sm font-medium">{{ session('warning') }}</p>
+        </div>
+    @endif
+
+    @if(session('error'))
+        <div class="mb-6 p-4 bg-red-50 border-l-4 border-red-500 rounded-lg flex items-center gap-3">
+            <i class="fas fa-exclamation-circle text-red-600"></i>
+            <p class="text-red-700 text-sm font-medium">{{ session('error') }}</p>
+        </div>
+    @endif
+
+    <div class="grid grid-cols-1 md:grid-cols-3 gap-4 mb-6">
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4">
+            <div class="w-10 h-10 bg-blue-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-puzzle-piece text-blue-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Total Modules</p>
+                <p class="text-xl font-bold text-gray-800">{{ $modules->count() }}</p>
+            </div>
+        </div>
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4">
+            <div class="w-10 h-10 bg-green-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-toggle-on text-green-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Enabled</p>
+                <p class="text-xl font-bold text-gray-800">{{ $modules->where('enabled', true)->count() }}</p>
+            </div>
+        </div>
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4">
+            <div class="w-10 h-10 bg-red-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-toggle-off text-red-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Disabled</p>
+                <p class="text-xl font-bold text-gray-800">{{ $modules->where('enabled', false)->count() }}</p>
+            </div>
+        </div>
+    </div>
+
+    <div class="grid grid-cols-1 md:grid-cols-2 gap-4 mb-6">
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4">
+            <div class="w-10 h-10 bg-indigo-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-cubes text-indigo-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Core</p>
+                <p class="text-xl font-bold text-gray-800">{{ $modules->where('module_type', 'core')->count() }}</p>
+            </div>
+        </div>
+        <div class="bg-white rounded-lg shadow p-4 flex items-center gap-4">
+            <div class="w-10 h-10 bg-amber-100 rounded-lg flex items-center justify-center">
+                <i class="fas fa-plug text-amber-600"></i>
+            </div>
+            <div>
+                <p class="text-sm text-gray-500">Third Party</p>
+                <p class="text-xl font-bold text-gray-800">{{ $modules->where('module_type', 'third_party')->count() }}</p>
+            </div>
+        </div>
+    </div>
+
+    <div class="bg-white rounded-lg shadow">
+        <div class="p-6 border-b border-gray-200 flex items-center justify-between">
+            <h2 class="text-lg font-bold text-gray-800">Installed Modules</h2>
+            <span class="text-sm text-gray-500">{{ $modules->count() }} modules</span>
+        </div>
+
+        <div class="p-6">
+            @if($modules->isNotEmpty())
+                <div class="overflow-x-auto">
+                    <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 tracking-wider">Module</th>
+                                <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Status</th>
+                                <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Type</th>
+                                <th class="px-6 py-3 text-left text-xs font-medium text-gray-500 uppercase tracking-wider">Capabilities</th>
+                                <th class="px-6 py-3 text-right text-xs font-medium text-gray-500 uppercase tracking-wider">Actions</th>
+                            </tr>
+                        </thead>
+                        <tbody class="bg-white divide-y divide-gray-200">
+                            @foreach($modules as $module)
+                                <tr class="hover:bg-gray-50 align-top">
+                                    <td class="px-6 py-4 whitespace-nowrap">
+                                        <p class="text-sm font-semibold text-gray-900">{{ $module['name'] }}</p>
+                                        <p class="text-xs text-gray-500">{{ $module['folder'] }}</p>
+                                    </td>
+                                    <td class="px-6 py-4 whitespace-nowrap">
+                                        @if($module['enabled'])
+                                            <span class="px-2.5 py-1 text-xs font-semibold rounded-full bg-green-100 text-green-800">Enabled</span>
+                                        @else
+                                            <span class="px-2.5 py-1 text-xs font-semibold rounded-full bg-gray-200 text-gray-700">Disabled</span>
+                                        @endif
+                                    </td>
+                                    <td class="px-6 py-4 whitespace-nowrap">
+                                        @if($module['module_type'] === 'third_party')
+                                            <span class="px-2.5 py-1 text-xs font-semibold rounded-full bg-amber-100 text-amber-800">Third Party</span>
+                                        @else
+                                            <span class="px-2.5 py-1 text-xs font-semibold rounded-full bg-indigo-100 text-indigo-800">Core</span>
+                                        @endif
+                                    </td>
+                                    <td class="px-6 py-4 text-sm text-gray-600">
+                                        <div class="flex flex-wrap gap-2">
+                                            <span class="px-2 py-1 rounded bg-gray-100 {{ $module['routes'] ? 'text-blue-700' : 'text-gray-400' }}">Routes</span>
+                                            <span class="px-2 py-1 rounded bg-gray-100 {{ $module['migrations'] ? 'text-blue-700' : 'text-gray-400' }}">Migrations</span>
+                                            <span class="px-2 py-1 rounded bg-gray-100 {{ $module['views'] ? 'text-blue-700' : 'text-gray-400' }}">Views</span>
+                                            <span class="px-2 py-1 rounded bg-gray-100 {{ $module['translations'] ? 'text-blue-700' : 'text-gray-400' }}">Translations</span>
+                                        </div>
+                                    </td>
+                                    <td class="px-6 py-4 whitespace-nowrap text-right">
+                                        <div class="flex flex-wrap justify-end gap-2">
+                                            @if($module['folder'] !== 'Admin')
+                                            <form method="POST" action="{{ route('admin.modules.toggle', $module['folder']) }}">
+                                                @csrf
+                                                @method('PATCH')
+                                                    <button type="submit" class="px-3 py-1.5 rounded-lg text-sm font-medium {{ $module['enabled'] ? 'bg-yellow-50 text-yellow-700 hover:bg-yellow-100' : 'bg-green-50 text-green-700 hover:bg-green-100' }}">
+                                                        <i class="fas {{ $module['enabled'] ? 'fa-toggle-off' : 'fa-toggle-on' }} mr-1"></i>
+                                                        {{ $module['enabled'] ? 'Disable' : 'Enable' }}
+                                                    </button>
+                                            </form>
+
+                                            <form method="POST" action="{{ route('admin.modules.migrate', $module['folder']) }}">
+                                                @csrf
+                                                <button type="submit" class="px-3 py-1.5 rounded-lg text-sm font-medium bg-blue-50 text-blue-700 hover:bg-blue-100 {{ !$module['has_migrations'] ? 'opacity-50 cursor-not-allowed' : '' }}" {{ !$module['has_migrations'] ? 'disabled' : '' }}>
+                                                    <i class="fas fa-database mr-1"></i>Migrate
+                                                </button>
+                                            </form>
+
+                                            <a href="{{ route('admin.modules.edit', $module['folder']) }}" class="px-3 py-1.5 rounded-lg text-sm font-medium bg-gray-100 text-gray-700 hover:bg-gray-200">
+                                                <i class="fas fa-cog mr-1"></i>Configure
+                                            </a>
+
+                                            <form method="POST" action="{{ route('admin.modules.destroy', $module['folder']) }}" onsubmit="return confirmModuleDeletion(this, '{{ $module['folder'] }}');">
+                                                @csrf
+                                                @method('DELETE')
+                                                <input type="hidden" name="confirmation" value="">
+                                                <button type="submit" class="px-3 py-1.5 rounded-lg text-sm font-medium bg-red-50 text-red-700 hover:bg-red-100 {{ $module['folder'] === 'Admin' ? 'opacity-50 cursor-not-allowed' : '' }}" {{ $module['folder'] === 'Admin' ? 'disabled' : '' }}>
+                                                    <i class="fas fa-trash mr-1"></i>Delete
+                                                </button>
+                                            </form>
+                                            @endif
+                                        </div>
+                                    </td>
+                                </tr>
+                            @endforeach
+                        </tbody>
+                    </table>
+                </div>
+            @else
+                <div class="text-center py-12">
+                    <div class="w-16 h-16 bg-gray-100 rounded-full flex items-center justify-center mx-auto mb-4">
+                        <i class="fas fa-box-open text-2xl text-gray-400"></i>
+                    </div>
+                    <p class="text-gray-500 font-medium">No modules found.</p>
+                </div>
+            @endif
+        </div>
+    </div>
+</main>
+@endsection
+
+@push('scripts')
+<script>
+    function confirmModuleDeletion(form, moduleName) {
+        const confirmation = prompt(`Type ${moduleName} to confirm module deletion.`);
+
+        if (confirmation === null) {
+            return false;
+        }
+
+        form.querySelector('input[name="confirmation"]').value = confirmation;
+        return true;
+    }
+</script>
+@endpush
diff --git a/app/Modules/Admin/module.json b/app/Modules/Admin/module.json
index 5a2385a..5c63f21 100644
--- a/app/Modules/Admin/module.json
+++ b/app/Modules/Admin/module.json
@@ -2,8 +2,8 @@
     "name": "Admin",
     "enabled": true,
     "routes": true,
-    "migrations": true,
+    "migrations": false,
     "views": true,
     "translations": true,
     "namespace": "Modules\\Admin"
-}
\ No newline at end of file
+}
diff --git a/app/Modules/Armory/module.json b/app/Modules/Armory/module.json
index 59c64ab..6c65e55 100644
--- a/app/Modules/Armory/module.json
+++ b/app/Modules/Armory/module.json
@@ -1,8 +1,8 @@
 {
     "name": "Armorytest",
-    "enabled": true,
+    "enabled": false,
     "routes": true,
     "migrations": true,
     "views": true,
     "namespace": "Modules\\Armorytest"
-}
\ No newline at end of file
+}
diff --git a/app/Modules/Donate/module.json b/app/Modules/Donate/module.json
index 9604e23..484f6f7 100644
--- a/app/Modules/Donate/module.json
+++ b/app/Modules/Donate/module.json
@@ -5,4 +5,4 @@
     "migrations": true,
     "views": true,
     "namespace": "Modules\\Donate"
-}
\ No newline at end of file
+}
diff --git a/app/Modules/Forum/module.json b/app/Modules/Forum/module.json
index 173734b..fb312ad 100644
--- a/app/Modules/Forum/module.json
+++ b/app/Modules/Forum/module.json
@@ -5,4 +5,4 @@
     "migrations": true,
     "views": true,
     "namespace": "Modules\\Forum"
-}
\ No newline at end of file
+}
diff --git a/app/Modules/Store/module.json b/app/Modules/Store/module.json
index e21d3a5..3fbca6a 100644
--- a/app/Modules/Store/module.json
+++ b/app/Modules/Store/module.json
@@ -5,4 +5,4 @@
     "migrations": true,
     "views": true,
     "namespace": "Modules\\Store"
-}
\ No newline at end of file
+}
diff --git a/app/Providers/BaseModuleServiceProvider.php b/app/Providers/BaseModuleServiceProvider.php
index 612f82e..04dc53f 100644
--- a/app/Providers/BaseModuleServiceProvider.php
+++ b/app/Providers/BaseModuleServiceProvider.php
@@ -2,6 +2,7 @@
 
 namespace App\Providers;
 
+use App\Services\ModuleRegistryService;
 use Illuminate\Support\ServiceProvider;
 use Illuminate\Support\Facades\Route;
 use Illuminate\Support\Facades\File;
@@ -25,7 +26,7 @@ public function boot(): void
          * Check if the module is enabled.
          * If not, skip loading any resources.
          */
-        if (!($this->config['enabled'] ?? true)) {
+        if (!ModuleRegistryService::isModuleEnabled($this->moduleName, (bool) ($this->config['enabled'] ?? true))) {
             return;
         }
 
diff --git a/app/Services/ModuleRegistryService.php b/app/Services/ModuleRegistryService.php
new file mode 100644
index 0000000..5f1f577
--- /dev/null
+++ b/app/Services/ModuleRegistryService.php
@@ -0,0 +1,213 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\ManagedModule;
+use Illuminate\Support\Facades\File;
+use Illuminate\Support\Facades\Schema;
+
+class ModuleRegistryService
+{
+    private static ?array $stateCache = null;
+
+    public static function getModuleState(string $module, ?array $fallbackConfig = null): array
+    {
+        $module = trim($module);
+        $fallbackConfig = $fallbackConfig ?? [];
+
+        $fallback = [
+            'enabled' => (bool) ($fallbackConfig['enabled'] ?? true),
+            'module_type' => self::normalizeType((string) ($fallbackConfig['module_type'] ?? $fallbackConfig['type'] ?? 'core')),
+        ];
+
+        if ($module === '') {
+            return $fallback;
+        }
+
+        $states = self::loadStates();
+
+        return $states[$module] ?? $fallback;
+    }
+
+    public static function isModuleEnabled(string $module, bool $fallbackEnabled = true): bool
+    {
+        $state = self::getModuleState($module, ['enabled' => $fallbackEnabled]);
+
+        return (bool) ($state['enabled'] ?? true);
+    }
+
+    public static function upsertState(string $module, bool $enabled, string $moduleType): void
+    {
+        if (!self::tableExists()) {
+            return;
+        }
+
+        $module = trim($module);
+        if ($module === '') {
+            return;
+        }
+
+        try {
+            ManagedModule::query()->updateOrCreate(
+                ['module_name' => $module],
+                [
+                    'enabled' => $enabled,
+                    'module_type' => self::normalizeType($moduleType),
+                ]
+            );
+        } catch (\Throwable $exception) {
+            return;
+        }
+
+        self::flushCache();
+    }
+
+    public static function deleteState(string $module): void
+    {
+        if (!self::tableExists()) {
+            return;
+        }
+
+        try {
+            ManagedModule::query()
+                ->where('module_name', trim($module))
+                ->delete();
+        } catch (\Throwable $exception) {
+            return;
+        }
+
+        self::flushCache();
+    }
+
+    public static function syncDiscoveredModules(?array $discoveredModules = null): void
+    {
+        if (!self::tableExists()) {
+            return;
+        }
+
+        $discoveredModules = $discoveredModules ?? self::discoverFromFilesystem();
+
+        foreach ($discoveredModules as $module) {
+            if (!is_array($module)) {
+                continue;
+            }
+
+            $moduleName = trim((string) ($module['folder'] ?? $module['module_name'] ?? ''));
+            if ($moduleName === '') {
+                continue;
+            }
+
+            $enabled = (bool) ($module['enabled'] ?? true);
+            $type = self::normalizeType((string) ($module['module_type'] ?? 'core'));
+
+            try {
+                ManagedModule::query()->firstOrCreate(
+                    ['module_name' => $moduleName],
+                    [
+                        'enabled' => $enabled,
+                        'module_type' => $type,
+                    ]
+                );
+            } catch (\Throwable $exception) {
+                continue;
+            }
+        }
+
+        self::flushCache();
+    }
+
+    public static function flushCache(): void
+    {
+        self::$stateCache = null;
+    }
+
+    private static function loadStates(): array
+    {
+        if (is_array(self::$stateCache)) {
+            return self::$stateCache;
+        }
+
+        if (!self::tableExists()) {
+            self::$stateCache = [];
+
+            return self::$stateCache;
+        }
+
+        try {
+            self::$stateCache = ManagedModule::query()
+                ->get(['module_name', 'enabled', 'module_type'])
+                ->mapWithKeys(function (ManagedModule $module) {
+                    return [
+                        $module->module_name => [
+                            'enabled' => (bool) $module->enabled,
+                            'module_type' => self::normalizeType((string) $module->module_type),
+                        ],
+                    ];
+                })
+                ->all();
+        } catch (\Throwable $exception) {
+            self::$stateCache = [];
+        }
+
+        return self::$stateCache;
+    }
+
+    private static function tableExists(): bool
+    {
+        try {
+            if (!self::databaseResolverAvailable()) {
+                return false;
+            }
+
+            return Schema::hasTable('managed_modules');
+        } catch (\Throwable $exception) {
+            return false;
+        }
+    }
+
+    private static function databaseResolverAvailable(): bool
+    {
+        try {
+            return ManagedModule::getConnectionResolver() !== null;
+        } catch (\Throwable $exception) {
+            return false;
+        }
+    }
+
+    private static function discoverFromFilesystem(): array
+    {
+        $modulesPath = base_path('app/Modules');
+
+        if (!is_dir($modulesPath)) {
+            return [];
+        }
+
+        $modules = [];
+
+        foreach (glob($modulesPath . '/*', GLOB_ONLYDIR) as $moduleDir) {
+            $moduleName = basename($moduleDir);
+            $configPath = $moduleDir . DIRECTORY_SEPARATOR . 'module.json';
+            $config = [];
+
+            if (File::exists($configPath)) {
+                $decoded = json_decode(File::get($configPath), true);
+                if (is_array($decoded)) {
+                    $config = $decoded;
+                }
+            }
+
+            $modules[] = [
+                'folder' => $moduleName,
+                'enabled' => (bool) ($config['enabled'] ?? true),
+                'module_type' => self::normalizeType((string) ($config['module_type'] ?? 'core')),
+            ];
+        }
+
+        return $modules;
+    }
+
+    private static function normalizeType(string $moduleType): string
+    {
+        return in_array($moduleType, ['core', 'third_party'], true) ? $moduleType : 'core';
+    }
+}
diff --git a/database/migrations/2026_03_14_030000_alter_settings_value_to_text.php b/database/migrations/2026_03_14_030000_alter_settings_value_to_text.php
new file mode 100644
index 0000000..c2af959
--- /dev/null
+++ b/database/migrations/2026_03_14_030000_alter_settings_value_to_text.php
@@ -0,0 +1,45 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        $driver = DB::getDriverName();
+
+        if ($driver === 'mysql') {
+            DB::statement('ALTER TABLE settings MODIFY value LONGTEXT NOT NULL');
+            return;
+        }
+
+        if ($driver === 'pgsql') {
+            DB::statement('ALTER TABLE settings ALTER COLUMN value TYPE TEXT');
+            return;
+        }
+
+        // SQLite stores strings dynamically and does not strictly enforce VARCHAR length.
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        $driver = DB::getDriverName();
+
+        if ($driver === 'mysql') {
+            DB::statement('ALTER TABLE settings MODIFY value VARCHAR(255) NOT NULL');
+            return;
+        }
+
+        if ($driver === 'pgsql') {
+            DB::statement('ALTER TABLE settings ALTER COLUMN value TYPE VARCHAR(255)');
+            return;
+        }
+    }
+};
diff --git a/database/migrations/2026_03_14_120000_create_managed_modules_table.php b/database/migrations/2026_03_14_120000_create_managed_modules_table.php
new file mode 100644
index 0000000..1084ca8
--- /dev/null
+++ b/database/migrations/2026_03_14_120000_create_managed_modules_table.php
@@ -0,0 +1,25 @@
+<?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('managed_modules', function (Blueprint $table) {
+            $table->id();
+            $table->string('module_name', 100)->unique();
+            $table->boolean('enabled')->default(true);
+            $table->string('module_type', 20)->default('core');
+            $table->timestamps();
+
+            $table->index('module_type');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('managed_modules');
+    }
+};
diff --git a/database/seeders/RolesAndPermissionsSeeder.php b/database/seeders/RolesAndPermissionsSeeder.php
index d9ddd22..bd2b1a6 100755
--- a/database/seeders/RolesAndPermissionsSeeder.php
+++ b/database/seeders/RolesAndPermissionsSeeder.php
@@ -27,6 +27,7 @@ public function run(): void
         Permission::firstOrCreate(['name' => 'manage.announcements']);
         Permission::firstOrCreate(['name' => 'view.logs']);
         Permission::firstOrCreate(['name' => 'manage.backups']);
+        Permission::firstOrCreate(['name' => 'manage.modules']);
         Permission::firstOrCreate(['name' => 'manage.realms']);
         Permission::firstOrCreate(['name' => 'manage.bans']);
         Permission::firstOrCreate(['name' => 'manage.reports']);
diff --git a/resources/views/layouts/main.blade.php b/resources/views/layouts/main.blade.php
index 36067f2..23b3248 100644
--- a/resources/views/layouts/main.blade.php
+++ b/resources/views/layouts/main.blade.php
@@ -23,11 +23,9 @@
                         </div>
                     </div>
                     <div class="hidden md:flex gap-6">
-                        <a href="{{ route('home') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">HOME</a>
-                        <a href="{{ route('news') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">NEWS</a>
-                        <a href="{{ route('howtoplay') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">HOW TO PLAY</a>
-                        <a href="{{ route('armory') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">ARMORY</a>
-                        <a href="{{ route('donate') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">DONATE</a>
+                        @foreach(menu_items('web') as $item)
+                            <a href="{{ menu_item_href($item) }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">{{ $item['label'] ?? 'MENU' }}</a>
+                        @endforeach
                     </div>
                 </div>
                 <div class="flex items-center gap-3">
@@ -55,11 +53,9 @@
             <!-- Mobile Menu -->
             <div id="mobile-menu" class="hidden md:hidden pb-4">
                 <div class="flex flex-col gap-2">
-                    <a href="{{ route('home') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">HOME</a>
-                    <a href="{{ route('news') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">NEWS</a>
-                    <a href="{{ route('howtoplay') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">HOW TO PLAY</a>
-                    <a href="{{ route('armory') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">ARMORY</a>
-                    <a href="{{ route('donate') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">DONATE</a>
+                    @foreach(menu_items('web') as $item)
+                        <a href="{{ menu_item_href($item) }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">{{ $item['label'] ?? 'MENU' }}</a>
+                    @endforeach
                     @auth
                         <div class="flex flex-col gap-2 pt-2">
                             <a href="{{ route('ucp.dashboard') }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">
diff --git a/resources/views/ucp/components/sidebar.blade.php b/resources/views/ucp/components/sidebar.blade.php
index b3079dc..c193200 100755
--- a/resources/views/ucp/components/sidebar.blade.php
+++ b/resources/views/ucp/components/sidebar.blade.php
@@ -19,18 +19,16 @@
         
         <nav class="p-4">
             <div class="space-y-2">
-                <a href="{{ route('ucp.dashboard') }}" class="flex items-center space-x-3 px-4 py-3 rounded-xl bg-blue-500/20 text-blue-300 border border-blue-500/30 transition-all duration-200 hover:bg-blue-500/30">
-                    <i class="fas fa-home w-5"></i>
-                    <span class="font-medium">Dashboard</span>
-                </a>
-                <a href="{{ route('ucp.gameaccount') }}" class="flex items-center space-x-3 px-4 py-3 rounded-xl text-gray-400 hover:bg-slate-700/50 hover:text-white transition-all duration-200">
-                    <i class="fas fa-gamepad w-5"></i>
-                    <span class="font-medium">Game Account</span>
-                </a>
-                <a href="{{ route('ucp.transaction') }}" class="flex items-center space-x-3 px-4 py-3 rounded-xl text-gray-400 hover:bg-slate-700/50 hover:text-white transition-all duration-200">
-                    <i class="fas fa-hand-holding-usd w-5"></i>
-                    <span class="font-medium">Donations</span>
-                </a>
+                @foreach(menu_items('ucp') as $item)
+                    @php
+                        $isActive = !empty($item['route']) ? request()->routeIs($item['route']) : false;
+                        $iconClass = $item['icon'] ?? 'fas fa-link w-5';
+                    @endphp
+                    <a href="{{ menu_item_href($item) }}" class="flex items-center space-x-3 px-4 py-3 rounded-xl transition-all duration-200 {{ $isActive ? 'bg-blue-500/20 text-blue-300 border border-blue-500/30 hover:bg-blue-500/30' : 'text-gray-400 hover:bg-slate-700/50 hover:text-white' }}">
+                        <i class="{{ $iconClass }}"></i>
+                        <span class="font-medium">{{ $item['label'] ?? 'Menu' }}</span>
+                    </a>
+                @endforeach
             </div>
 
             @can('access.gm.panel')

From 01fe99f8d02e1db00d8920eaad7d2b4e59f6b14b Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 15 Mar 2026 23:46:43 +0100
Subject: [PATCH 092/132] refactor: Simplify module loading and enhance module
 management functionality

---
 app/Helpers/ModuleLoader.php                  |  51 +-----
 app/Helpers/SettingsHelper.php                |  22 +--
 .../Controllers/ModuleManagerController.php   |  74 ++++-----
 app/Providers/BaseModuleServiceProvider.php   |  49 ++----
 app/Providers/ModuleServiceProvider.php       |   4 +-
 app/Services/ModuleRegistryService.php        | 152 +++++++++++++++---
 resources/views/ucp/donations.blade.php       |   6 +-
 routes/web.php                                |   2 +-
 8 files changed, 186 insertions(+), 174 deletions(-)

diff --git a/app/Helpers/ModuleLoader.php b/app/Helpers/ModuleLoader.php
index eafff69..b4db24e 100644
--- a/app/Helpers/ModuleLoader.php
+++ b/app/Helpers/ModuleLoader.php
@@ -3,60 +3,11 @@
 namespace App\Helpers;
 
 use App\Services\ModuleRegistryService;
-use Illuminate\Support\Facades\File;
 
 class ModuleLoader
 {
     public static function getProviders(): array
     {
-        $providers = [];
-        $modulesPath = base_path('app/Modules');
-
-        if (!is_dir($modulesPath)) {
-            return $providers;
-        }
-
-        foreach (glob("$modulesPath/*", GLOB_ONLYDIR) as $moduleDir) {
-            $moduleName = basename($moduleDir);
-            $configPath = $moduleDir . DIRECTORY_SEPARATOR . 'module.json';
-            $config = [];
-
-            if (File::exists($configPath)) {
-                $decoded = json_decode(File::get($configPath), true);
-                if (is_array($decoded)) {
-                    $config = $decoded;
-                }
-            }
-
-            if (!ModuleRegistryService::isModuleEnabled($moduleName, (bool) ($config['enabled'] ?? true))) {
-                continue;
-            }
-
-            $namespace = "Modules\\{$moduleName}\\Providers";
-            $expectedFile = "{$moduleDir}/Providers/{$moduleName}ServiceProvider.php";
-            $expectedClass = "{$namespace}\\{$moduleName}ServiceProvider";
-
-            if (file_exists($expectedFile)) {
-                require_once $expectedFile;
-                if (class_exists($expectedClass)) {
-                    $providers[] = $expectedClass;
-                    continue;
-                }
-            }
-
-            $providersDir = "{$moduleDir}/Providers";
-            if (is_dir($providersDir)) {
-                foreach (glob("{$providersDir}/*ServiceProvider.php") as $providerFile) {
-                    require_once $providerFile;
-                    $className = pathinfo($providerFile, PATHINFO_FILENAME);
-                    $fullClass = "{$namespace}\\{$className}";
-                    if (class_exists($fullClass)) {
-                        $providers[] = $fullClass;
-                    }
-                }
-            }
-        }
-
-        return $providers;
+        return ModuleRegistryService::getEnabledProviders();
     }
 }
diff --git a/app/Helpers/SettingsHelper.php b/app/Helpers/SettingsHelper.php
index 58205da..273b916 100644
--- a/app/Helpers/SettingsHelper.php
+++ b/app/Helpers/SettingsHelper.php
@@ -3,7 +3,6 @@
 use App\Modules\Admin\Domain\Models\Setting;
 use App\Services\ModuleRegistryService;
 use Illuminate\Support\Facades\Cache;
-use Illuminate\Support\Facades\File;
 use Illuminate\Support\Facades\Route;
 
 if (!function_exists('formatBytes')) {
@@ -79,25 +78,14 @@ function menu_module_states(): array
         }
 
         $states = [];
-        $modulesPath = base_path('app/Modules');
 
-        if (!is_dir($modulesPath)) {
-            return $states;
-        }
-
-        foreach (glob($modulesPath . '/*', GLOB_ONLYDIR) as $moduleDir) {
-            $moduleName = basename($moduleDir);
-            $configPath = $moduleDir . DIRECTORY_SEPARATOR . 'module.json';
-            $fallbackEnabled = true;
-
-            if (File::exists($configPath)) {
-                $decoded = json_decode(File::get($configPath), true);
-                if (is_array($decoded) && array_key_exists('enabled', $decoded)) {
-                    $fallbackEnabled = (bool) $decoded['enabled'];
-                }
+        foreach (ModuleRegistryService::getAllModules() as $module) {
+            $moduleName = trim((string) ($module['folder'] ?? ''));
+            if ($moduleName === '') {
+                continue;
             }
 
-            $states[$moduleName] = ModuleRegistryService::isModuleEnabled($moduleName, $fallbackEnabled);
+            $states[$moduleName] = (bool) ($module['enabled'] ?? true);
         }
 
         return $states;
diff --git a/app/Modules/Admin/Http/Controllers/ModuleManagerController.php b/app/Modules/Admin/Http/Controllers/ModuleManagerController.php
index d94d6f2..85b85cf 100644
--- a/app/Modules/Admin/Http/Controllers/ModuleManagerController.php
+++ b/app/Modules/Admin/Http/Controllers/ModuleManagerController.php
@@ -10,13 +10,6 @@
 
 class ModuleManagerController extends Controller
 {
-    protected string $modulesPath;
-
-    public function __construct()
-    {
-        $this->modulesPath = base_path('app/Modules');
-    }
-
     public function index()
     {
         $discoveredModules = $this->discoverModules();
@@ -151,14 +144,10 @@ public function destroy(Request $request, string $module)
 
     protected function discoverModules(): array
     {
-        if (!is_dir($this->modulesPath)) {
-            return [];
-        }
-
         $modules = [];
 
-        foreach (glob($this->modulesPath . '/*', GLOB_ONLYDIR) as $moduleDir) {
-            $modules[] = $this->buildModuleData(basename($moduleDir));
+        foreach (ModuleRegistryService::getAllModules() as $module) {
+            $modules[] = $this->hydrateModuleData($module);
         }
 
         return $modules;
@@ -170,52 +159,49 @@ protected function getModuleDataOrFail(string $module): array
             abort(404);
         }
 
-        $modulePath = $this->modulesPath . DIRECTORY_SEPARATOR . $module;
+        ModuleRegistryService::syncDiscoveredModules();
 
-        if (!is_dir($modulePath)) {
+        $moduleData = ModuleRegistryService::getModule($module);
+        if (!is_array($moduleData)) {
             abort(404);
         }
 
-        ModuleRegistryService::syncDiscoveredModules();
-
-        return $this->buildModuleData($module);
+        return $this->hydrateModuleData($moduleData);
     }
 
     protected function buildModuleData(string $module): array
     {
-        $modulePath = $this->modulesPath . DIRECTORY_SEPARATOR . $module;
-        $configPath = $modulePath . DIRECTORY_SEPARATOR . 'module.json';
-        $migrationsPath = $modulePath . DIRECTORY_SEPARATOR . 'Infrastructure/Database/migrations';
-
-        $config = [];
+        $moduleData = ModuleRegistryService::getModule($module);
 
-        if (File::exists($configPath)) {
-            $decoded = json_decode(File::get($configPath), true);
-            if (is_array($decoded)) {
-                $config = $decoded;
-            }
+        if (!is_array($moduleData)) {
+            abort(404);
         }
 
-        $moduleState = ModuleRegistryService::getModuleState($module, [
-            'enabled' => (bool) ($config['enabled'] ?? true),
-            'module_type' => (string) ($config['module_type'] ?? 'core'),
-        ]);
+        return $this->hydrateModuleData($moduleData);
+    }
+
+    protected function hydrateModuleData(array $module): array
+    {
+        $folder = (string) ($module['folder'] ?? '');
+        $name = (string) ($module['name'] ?? $folder);
+        $config = is_array($module['config'] ?? null) ? $module['config'] : [];
+        $migrationsPath = (string) ($module['migrations_path'] ?? '');
 
         return [
-            'folder' => $module,
-            'name' => $config['name'] ?? $module,
-            'enabled' => (bool) ($moduleState['enabled'] ?? true),
-            'module_type' => (string) ($moduleState['module_type'] ?? 'core'),
-            'routes' => (bool) ($config['routes'] ?? false),
-            'migrations' => (bool) ($config['migrations'] ?? false),
-            'views' => (bool) ($config['views'] ?? false),
-            'translations' => (bool) ($config['translations'] ?? false),
-            'namespace' => $config['namespace'] ?? "Modules\\{$module}",
-            'has_migrations' => is_dir($migrationsPath),
+            'folder' => $folder,
+            'name' => $name,
+            'enabled' => (bool) ($module['enabled'] ?? true),
+            'module_type' => (string) ($module['module_type'] ?? 'core'),
+            'routes' => (bool) ($module['routes'] ?? false),
+            'migrations' => (bool) ($module['migrations'] ?? false),
+            'views' => (bool) ($module['views'] ?? false),
+            'translations' => (bool) ($module['translations'] ?? false),
+            'namespace' => (string) ($module['namespace'] ?? "Modules\\{$folder}"),
+            'has_migrations' => $migrationsPath !== '' && is_dir($migrationsPath),
             'migrations_path' => $migrationsPath,
-            'config_path' => $configPath,
+            'config_path' => (string) ($module['config_path'] ?? ''),
             'config' => $config,
-            'path' => $modulePath,
+            'path' => (string) ($module['path'] ?? ''),
         ];
     }
 
diff --git a/app/Providers/BaseModuleServiceProvider.php b/app/Providers/BaseModuleServiceProvider.php
index 04dc53f..a04c50c 100644
--- a/app/Providers/BaseModuleServiceProvider.php
+++ b/app/Providers/BaseModuleServiceProvider.php
@@ -5,7 +5,6 @@
 use App\Services\ModuleRegistryService;
 use Illuminate\Support\ServiceProvider;
 use Illuminate\Support\Facades\Route;
-use Illuminate\Support\Facades\File;
 
 abstract class BaseModuleServiceProvider extends ServiceProvider
 {
@@ -19,59 +18,37 @@ public function boot(): void
             throw new \RuntimeException('Module name not defined in ' . static::class);
         }
 
-        $this->modulePath = base_path("app/Modules/{$this->moduleName}");
-        $this->loadModuleConfig();
-
-        /**
-         * Check if the module is enabled.
-         * If not, skip loading any resources.
-         */
-        if (!ModuleRegistryService::isModuleEnabled($this->moduleName, (bool) ($this->config['enabled'] ?? true))) {
-            return;
+        $manifest = ModuleRegistryService::getModule($this->moduleName);
+
+        if (is_array($manifest)) {
+            $this->modulePath = (string) ($manifest['path'] ?? base_path("app/Modules/{$this->moduleName}"));
+            $this->config = is_array($manifest['config'] ?? null) ? $manifest['config'] : [];
+            $this->config['namespace'] = (string) ($manifest['namespace'] ?? ($this->config['namespace'] ?? "Modules\\{$this->moduleName}"));
+            $this->config['routes'] = (bool) ($manifest['routes'] ?? ($this->config['routes'] ?? false));
+            $this->config['migrations'] = (bool) ($manifest['migrations'] ?? ($this->config['migrations'] ?? false));
+            $this->config['views'] = (bool) ($manifest['views'] ?? ($this->config['views'] ?? false));
+            $this->config['translations'] = (bool) ($manifest['translations'] ?? ($this->config['translations'] ?? false));
+        } else {
+            $this->modulePath = base_path("app/Modules/{$this->moduleName}");
         }
 
-        /**
-         * Load module routes if enabled.
-         */
         if ($this->config['routes'] ?? false) {
             $this->loadRoutes();
         }
 
-        /**
-         * Load module migrations if enabled.
-         */
         if ($this->config['migrations'] ?? false) {
             $this->loadMigrations();
         }
 
-        /**
-         * Load module views if enabled.
-         */
         if ($this->config['views'] ?? false) {
             $this->loadViews();
         }
 
-        /**
-         * Load module translations if enabled.
-         */
         if ($this->config['translations'] ?? false) {
             $this->loadTranslations();
         }
     }
 
-    /**
-     * Load module configuration from the module.json file.
-     * 
-     * @return void
-     */
-    private function loadModuleConfig(): void
-    {
-        $configFile = $this->modulePath . '/module.json';
-        if (File::exists($configFile)) {
-            $this->config = json_decode(File::get($configFile), true) ?? [];
-        }
-    }
-
     /**
      * Load routes from the module's Http/routes.php file.
      * 
@@ -80,7 +57,7 @@ private function loadModuleConfig(): void
     private function loadRoutes(): void
     {
         $routesPath = $this->modulePath . '/Http/routes.php';
-        if (File::exists($routesPath)) {
+        if (is_file($routesPath)) {
             Route::middleware('web')
                 ->namespace(($this->config['namespace'] ?? "Modules\\{$this->moduleName}") . '\\Http\\Controllers')
                 ->group($routesPath);
diff --git a/app/Providers/ModuleServiceProvider.php b/app/Providers/ModuleServiceProvider.php
index 04c68f3..d8026a4 100644
--- a/app/Providers/ModuleServiceProvider.php
+++ b/app/Providers/ModuleServiceProvider.php
@@ -3,13 +3,13 @@
 namespace App\Providers;
 
 use Illuminate\Support\ServiceProvider;
-use App\Helpers\ModuleLoader;
+use App\Services\ModuleRegistryService;
 
 class ModuleServiceProvider extends ServiceProvider
 {
     public function register(): void
     {
-        foreach (ModuleLoader::getProviders() as $provider) {
+        foreach (ModuleRegistryService::getEnabledProviders() as $provider) {
             $this->app->register($provider);
         }
     }
diff --git a/app/Services/ModuleRegistryService.php b/app/Services/ModuleRegistryService.php
index 5f1f577..804ad87 100644
--- a/app/Services/ModuleRegistryService.php
+++ b/app/Services/ModuleRegistryService.php
@@ -9,12 +9,57 @@
 class ModuleRegistryService
 {
     private static ?array $stateCache = null;
+    private static ?array $manifestCache = null;
+
+    public static function getEnabledProviders(): array
+    {
+        $providers = [];
+
+        foreach (self::getEnabledModules() as $module) {
+            $provider = trim((string) ($module['provider'] ?? ''));
+            if ($provider !== '') {
+                $providers[] = $provider;
+            }
+        }
+
+        return array_values(array_unique($providers));
+    }
+
+    public static function getEnabledModules(): array
+    {
+        return array_values(array_filter(
+            self::getAllModules(),
+            static fn (array $module): bool => (bool) ($module['enabled'] ?? true)
+        ));
+    }
+
+    public static function getAllModules(): array
+    {
+        return array_values(self::loadManifest());
+    }
+
+    public static function getModule(string $module): ?array
+    {
+        $module = trim($module);
+        if ($module === '') {
+            return null;
+        }
+
+        $manifest = self::loadManifest();
+
+        return $manifest[$module] ?? null;
+    }
 
     public static function getModuleState(string $module, ?array $fallbackConfig = null): array
     {
         $module = trim($module);
         $fallbackConfig = $fallbackConfig ?? [];
 
+        $manifest = self::getModule($module);
+        if (is_array($manifest)) {
+            $fallbackConfig = array_merge($manifest, $fallbackConfig);
+        }
+
         $fallback = [
             'enabled' => (bool) ($fallbackConfig['enabled'] ?? true),
             'module_type' => self::normalizeType((string) ($fallbackConfig['module_type'] ?? $fallbackConfig['type'] ?? 'core')),
@@ -85,7 +130,7 @@ public static function syncDiscoveredModules(?array $discoveredModules = null):
             return;
         }
 
-        $discoveredModules = $discoveredModules ?? self::discoverFromFilesystem();
+        $discoveredModules = $discoveredModules ?? self::getAllModules();
 
         foreach ($discoveredModules as $module) {
             if (!is_array($module)) {
@@ -119,6 +164,56 @@ public static function syncDiscoveredModules(?array $discoveredModules = null):
     public static function flushCache(): void
     {
         self::$stateCache = null;
+        self::$manifestCache = null;
+    }
+
+    private static function loadManifest(): array
+    {
+        if (is_array(self::$manifestCache)) {
+            return self::$manifestCache;
+        }
+
+        $modulesPath = base_path('app/Modules');
+
+        if (!is_dir($modulesPath)) {
+            self::$manifestCache = [];
+
+            return self::$manifestCache;
+        }
+
+        $states = self::loadStates();
+        $manifest = [];
+
+        foreach (glob($modulesPath . '/*', GLOB_ONLYDIR) as $moduleDir) {
+            $moduleName = basename($moduleDir);
+            $config = self::readModuleConfig($moduleDir);
+            $state = $states[$moduleName] ?? [];
+            $namespace = (string) ($config['namespace'] ?? "Modules\\{$moduleName}");
+
+            $manifest[$moduleName] = [
+                'folder' => $moduleName,
+                'name' => (string) ($config['name'] ?? $moduleName),
+                'path' => $moduleDir,
+                'config_path' => $moduleDir . DIRECTORY_SEPARATOR . 'module.json',
+                'routes_path' => $moduleDir . DIRECTORY_SEPARATOR . 'Http/routes.php',
+                'migrations_path' => $moduleDir . DIRECTORY_SEPARATOR . 'Infrastructure/Database/migrations',
+                'views_path' => $moduleDir . DIRECTORY_SEPARATOR . 'Resources/views',
+                'translations_path' => $moduleDir . DIRECTORY_SEPARATOR . 'Resources/lang',
+                'namespace' => $namespace,
+                'provider' => self::resolveProviderClass($moduleName, $moduleDir, $namespace, $config),
+                'enabled' => (bool) ($state['enabled'] ?? $config['enabled'] ?? true),
+                'module_type' => self::normalizeType((string) ($state['module_type'] ?? $config['module_type'] ?? 'core')),
+                'routes' => (bool) ($config['routes'] ?? false),
+                'migrations' => (bool) ($config['migrations'] ?? false),
+                'views' => (bool) ($config['views'] ?? false),
+                'translations' => (bool) ($config['translations'] ?? false),
+                'config' => $config,
+            ];
+        }
+
+        self::$manifestCache = $manifest;
+
+        return self::$manifestCache;
     }
 
     private static function loadStates(): array
@@ -176,34 +271,49 @@ private static function databaseResolverAvailable(): bool
 
     private static function discoverFromFilesystem(): array
     {
-        $modulesPath = base_path('app/Modules');
+        return self::getAllModules();
+    }
 
-        if (!is_dir($modulesPath)) {
+    private static function readModuleConfig(string $moduleDir): array
+    {
+        $configPath = $moduleDir . DIRECTORY_SEPARATOR . 'module.json';
+
+        if (!File::exists($configPath)) {
             return [];
         }
 
-        $modules = [];
+        $decoded = json_decode(File::get($configPath), true);
 
-        foreach (glob($modulesPath . '/*', GLOB_ONLYDIR) as $moduleDir) {
-            $moduleName = basename($moduleDir);
-            $configPath = $moduleDir . DIRECTORY_SEPARATOR . 'module.json';
-            $config = [];
-
-            if (File::exists($configPath)) {
-                $decoded = json_decode(File::get($configPath), true);
-                if (is_array($decoded)) {
-                    $config = $decoded;
-                }
-            }
+        return is_array($decoded) ? $decoded : [];
+    }
 
-            $modules[] = [
-                'folder' => $moduleName,
-                'enabled' => (bool) ($config['enabled'] ?? true),
-                'module_type' => self::normalizeType((string) ($config['module_type'] ?? 'core')),
-            ];
+    private static function resolveProviderClass(string $moduleName, string $moduleDir, string $namespace, array $config): ?string
+    {
+        $configuredProvider = trim((string) ($config['provider'] ?? ''));
+        if ($configuredProvider !== '' && class_exists($configuredProvider)) {
+            return $configuredProvider;
+        }
+
+        $conventionalProvider = "{$namespace}\\Providers\\{$moduleName}ServiceProvider";
+        if (class_exists($conventionalProvider)) {
+            return $conventionalProvider;
+        }
+
+        $providersDir = $moduleDir . DIRECTORY_SEPARATOR . 'Providers';
+        if (!is_dir($providersDir)) {
+            return null;
+        }
+
+        foreach (glob($providersDir . DIRECTORY_SEPARATOR . '*ServiceProvider.php') as $providerFile) {
+            $className = pathinfo($providerFile, PATHINFO_FILENAME);
+            $fullClass = "{$namespace}\\Providers\\{$className}";
+
+            if (class_exists($fullClass)) {
+                return $fullClass;
+            }
         }
 
-        return $modules;
+        return null;
     }
 
     private static function normalizeType(string $moduleType): string
diff --git a/resources/views/ucp/donations.blade.php b/resources/views/ucp/donations.blade.php
index 2e646e8..d1c75da 100644
--- a/resources/views/ucp/donations.blade.php
+++ b/resources/views/ucp/donations.blade.php
@@ -17,7 +17,7 @@
                     </div>
                     <p class="text-sm text-gray-400 mb-1">Total Donated</p>
                     <p class="text-3xl font-bold text-white">
-                        {{ empty($transactions) ? '0.00' : number_format(array_sum(array_column($transactions, 'amount')), 2) }}
+                        {{ empty($transactions) ? '0.00' : number_format($transactions->sum('amount'), 2) }}                    
                     </p>
                 </div>
 
@@ -30,7 +30,7 @@
                     </div>
                     <p class="text-sm text-gray-400 mb-1">Total Coins Earned</p>
                     <p class="text-3xl font-bold text-white">
-                        {{ empty($transactions) ? '0' : number_format(array_sum(array_column($transactions, 'dp_awarded'))) }}
+                        {{ empty($transactions) ? '0' : number_format($transactions->sum('dp_awarded')) }}
                     </p>
                 </div>
 
@@ -43,7 +43,7 @@
                     </div>
                     <p class="text-sm text-gray-400 mb-1">Total Transactions</p>
                     <p class="text-3xl font-bold text-white">
-                        {{ empty($transactions) ? '0' : count($transactions) }}
+                        {{ empty($transactions) ? '0' : $transactions->count() }}
                     </p>
                 </div>
             </div>
diff --git a/routes/web.php b/routes/web.php
index 5ae7b06..40c6071 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -61,7 +61,7 @@
 Route::prefix('ucp')->middleware(['auth', 'permission:access.ucp', 'track.analytics'])->group(function () {
     Route::get('/', [UserController::class, 'show'])->name('ucp.dashboard');
     Route::get('/gameaccount', [UserController::class, 'gameAccount'])->name('ucp.gameaccount');
-    Route::get('/donations', [UserController::class, 'transaction'])->name('ucp.transaction');
+    Route::get('/transactions', [UserController::class, 'transaction'])->name('ucp.transaction');
     Route::get('/gameaccount/create', [UserController::class, 'createAction'])->name('ucp.gameaccount.create');
     Route::post('/gameaccount/create', [UserController::class, 'createGameAccount'])->name('ucp.gameaccount.store');
     Route::get('/manage', [UserController::class, 'manage'])->middleware('permission:manage.own.account')->name('ucp.manageAccount');

From 5a4317c25a0319f3e08a82f9413ce2cf0115afe5 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Mon, 23 Mar 2026 21:02:00 +0100
Subject: [PATCH 093/132] refactor: Remove deprecated Forum, Thread, and Post
 models; update service and controller references

---
 .../Controllers/Frontend/ForumsController.php | 129 --------
 app/Models/Forum.php                          |  54 ----
 app/Models/Post.php                           |  35 --
 app/Models/Thread.php                         |  63 ----
 .../Http/Controllers/ArmoryController.php     |   2 +-
 .../Armory/Services}/WowheadParserService.php |   0
 .../Forum/Resources/views/index.blade.php     |   4 +-
 app/Modules/Forum/Services/ForumService.php   |   6 +-
 app/Providers/AppServiceProvider.php          |   2 +-
 .../Armory/TrinityCoreArmoryRepository.php    | 300 ------------------
 app/Services/ForumService.php                 | 162 ----------
 database/seeders/ForumsSeeder.php             |   6 +-
 resources/views/forums/index.blade.php        |   4 +-
 routes/web.php                                |   1 -
 14 files changed, 12 insertions(+), 756 deletions(-)
 delete mode 100755 app/Http/Controllers/Frontend/ForumsController.php
 delete mode 100755 app/Models/Forum.php
 delete mode 100755 app/Models/Post.php
 delete mode 100755 app/Models/Thread.php
 rename app/{Services/Parser => Modules/Armory/Services}/WowheadParserService.php (100%)
 delete mode 100644 app/Repositories/Armory/TrinityCoreArmoryRepository.php
 delete mode 100644 app/Services/ForumService.php

diff --git a/app/Http/Controllers/Frontend/ForumsController.php b/app/Http/Controllers/Frontend/ForumsController.php
deleted file mode 100755
index 0079d8a..0000000
--- a/app/Http/Controllers/Frontend/ForumsController.php
+++ /dev/null
@@ -1,129 +0,0 @@
-<?php
-
-namespace App\Http\Controllers\Frontend;
-
-use App\Http\Controllers\Controller;
-use Illuminate\Http\Request;
-use Illuminate\View\View;
-use Illuminate\Support\Facades\View as ViewFacade;
-use App\Services\ForumService;
-use App\Models\Forum;
-use App\Models\Thread;
-
-class ForumsController extends Controller
-{
-    protected ForumService $forumService;
-
-    protected array $views = [
-        'index'         => 'forums.index',
-        'forum'         => 'forums.forum',
-        'thread'        => 'forums.thread',
-        'create_thread' => 'forums.create_thread',
-        'create_post'   => 'forums.create_post',
-    ];
-
-    public function __construct(ForumService $forumService)
-    {
-        $this->forumService = $forumService;
-    }
-
-    /**
-     * Display the forum index with all categories.
-     */
-    public function index(Request $request, ?string $view = null): View
-    {
-        $categories = $this->forumService->getCategories();
-
-        return $this->renderView($view ?? $this->views['index'], compact('categories'));
-    }
-
-    /**
-     * Display a forum with its threads.
-     */
-    public function showForum(string $slug, ?string $view = null): View
-    {
-        $data = $this->forumService->getForumWithThreads($slug);
-
-        return $this->renderView($view ?? $this->views['forum'], $data);
-    }
-
-    /**
-     * Display a thread with its posts.
-     */
-    public function showThread(string $forumSlug, string $threadSlug, ?string $view = null): View
-    {
-        $data = $this->forumService->getThreadWithPosts($forumSlug, $threadSlug);
-
-        return $this->renderView($view ?? $this->views['thread'], $data);
-    }
-
-    /**
-     * Show the form for creating a new thread.
-     */
-    public function createThread(string $slug, ?string $view = null): View
-    {
-        $forum = Forum::where('slug', $slug)->firstOrFail();
-
-        return $this->renderView($view ?? $this->views['create_thread'], compact('forum'));
-    }
-
-    /**
-     * Store a newly created thread.
-     */
-    public function storeThread(Request $request, string $slug)
-    {
-        $forum = Forum::where('slug', $slug)->firstOrFail();
-
-        $validated = $request->validate([
-            'title'   => 'required|min:3|max:255',
-            'content' => 'required|min:10',
-        ]);
-
-        $threadSlug = $this->forumService->createThread($forum, $validated);
-
-        return redirect()->route('forums.thread', [
-            'forumSlug'  => $forum->slug,
-            'threadSlug' => $threadSlug,
-        ])->with('success', 'Thread created successfully!');
-    }
-
-    /**
-     * Store a newly created post (reply).
-     */
-    public function storePost(Request $request, string $forumSlug, string $threadSlug)
-    {
-        $forum = Forum::where('slug', $forumSlug)->firstOrFail();
-        $thread = Thread::where('slug', $threadSlug)
-            ->where('forum_id', $forum->id)
-            ->firstOrFail();
-
-        $validated = $request->validate([
-            'content' => 'required|min:10',
-        ]);
-
-        try {
-            $this->forumService->createPost($thread, $validated);
-        } catch (\Exception $e) {
-            return back()->with('error', $e->getMessage());
-        }
-
-        return redirect()->route('forums.thread', [
-            'forumSlug'  => $forumSlug,
-            'threadSlug' => $threadSlug,
-        ])->with('success', 'Reply posted successfully!');
-    }
-
-    /**
-     * Render a Blade view safely.
-     *
-     * This replaces the renderView() inherited from BaseController.
-     */
-    protected function renderView(string $view, array $data = []): View
-    {
-        if (!ViewFacade::exists($view)) {
-            abort(404, "View [{$view}] not found.");
-        }
-
-        return view($view, $data);
-    }
-}
diff --git a/app/Models/Forum.php b/app/Models/Forum.php
deleted file mode 100755
index 5df523d..0000000
--- a/app/Models/Forum.php
+++ /dev/null
@@ -1,54 +0,0 @@
-<?php
-
-namespace App\Models;
-
-use Illuminate\Database\Eloquent\Factories\HasFactory;
-use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\HasMany;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
-
-class Forum extends Model
-{
-    use HasFactory;
-
-    protected $fillable = [
-        'name',
-        'description',
-        'slug',
-        'parent_id',
-        'order',
-        'is_category',
-    ];
-
-    /**
-     * Get all threads for this forum
-     */
-    public function threads(): HasMany
-    {
-        return $this->hasMany(Thread::class);
-    }
-
-    /**
-     * Get the parent forum if this is a subforum
-     */
-    public function parent(): BelongsTo
-    {
-        return $this->belongsTo(Forum::class, 'parent_id');
-    }
-
-    /**
-     * Get all subforums for this forum
-     */
-    public function subforums(): HasMany
-    {
-        return $this->hasMany(Forum::class, 'parent_id');
-    }
-
-    /**
-     * Get the latest thread in this forum
-     */
-    public function latestThread(): BelongsTo
-    {
-        return $this->belongsTo(Thread::class, 'latest_thread_id');
-    }
-}
\ No newline at end of file
diff --git a/app/Models/Post.php b/app/Models/Post.php
deleted file mode 100755
index 4655465..0000000
--- a/app/Models/Post.php
+++ /dev/null
@@ -1,35 +0,0 @@
-<?php
-
-namespace App\Models;
-
-use Illuminate\Database\Eloquent\Factories\HasFactory;
-use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
-
-class Post extends Model
-{
-    use HasFactory;
-
-    protected $fillable = [
-        'thread_id',
-        'user_id',
-        'content',
-        'is_first_post',
-    ];
-
-    /**
-     * Get the thread this post belongs to
-     */
-    public function thread(): BelongsTo
-    {
-        return $this->belongsTo(Thread::class);
-    }
-
-    /**
-     * Get the user who created this post
-     */
-    public function user(): BelongsTo
-    {
-        return $this->belongsTo(User::class);
-    }
-}
\ No newline at end of file
diff --git a/app/Models/Thread.php b/app/Models/Thread.php
deleted file mode 100755
index 6e18b66..0000000
--- a/app/Models/Thread.php
+++ /dev/null
@@ -1,63 +0,0 @@
-<?php
-
-namespace App\Models;
-
-use Illuminate\Database\Eloquent\Factories\HasFactory;
-use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\HasMany;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
-
-class Thread extends Model
-{
-    use HasFactory;
-
-    protected $fillable = [
-        'title',
-        'slug',
-        'forum_id',
-        'user_id',
-        'is_sticky',
-        'is_locked',
-        'view_count',
-    ];
-
-    /**
-     * Get all posts for this thread
-     */
-    public function posts(): HasMany
-    {
-        return $this->hasMany(Post::class);
-    }
-
-    /**
-     * Get the forum this thread belongs to
-     */
-    public function forum(): BelongsTo
-    {
-        return $this->belongsTo(Forum::class);
-    }
-
-    /**
-     * Get the user who created this thread
-     */
-    public function user(): BelongsTo
-    {
-        return $this->belongsTo(User::class);
-    }
-
-    /**
-     * Get the first post of this thread
-     */
-    public function firstPost(): BelongsTo
-    {
-        return $this->belongsTo(Post::class, 'first_post_id');
-    }
-
-    /**
-     * Get the latest post of this thread
-     */
-    public function latestPost(): BelongsTo
-    {
-        return $this->belongsTo(Post::class, 'latest_post_id');
-    }
-}
\ No newline at end of file
diff --git a/app/Modules/Armory/Http/Controllers/ArmoryController.php b/app/Modules/Armory/Http/Controllers/ArmoryController.php
index 27bcd25..e18f574 100644
--- a/app/Modules/Armory/Http/Controllers/ArmoryController.php
+++ b/app/Modules/Armory/Http/Controllers/ArmoryController.php
@@ -5,7 +5,7 @@
 use App\Http\Controllers\Controller;
 use Modules\Armory\Domain\Interfaces\ArmoryRepositoryInterface;
 use Illuminate\Http\Request;
-use App\Services\Parser\WowheadParserService;
+use Modules\Armory\Services\WowheadParserService;
 use Modules\Armory\Services\ArmoryService;
 
 class ArmoryController extends Controller
diff --git a/app/Services/Parser/WowheadParserService.php b/app/Modules/Armory/Services/WowheadParserService.php
similarity index 100%
rename from app/Services/Parser/WowheadParserService.php
rename to app/Modules/Armory/Services/WowheadParserService.php
diff --git a/app/Modules/Forum/Resources/views/index.blade.php b/app/Modules/Forum/Resources/views/index.blade.php
index 2a4f232..a7b05c0 100644
--- a/app/Modules/Forum/Resources/views/index.blade.php
+++ b/app/Modules/Forum/Resources/views/index.blade.php
@@ -204,7 +204,7 @@ class="w-6 h-6 rounded-full">
                                 <div class="absolute -top-8 -right-8 w-24 h-24 bg-green-500/10 rounded-full filter blur-2xl group-hover/stat:bg-green-500/20 transition-colors duration-300"></div>
                                 <div class="relative">
                                     <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-green-400 to-green-600 bg-clip-text mb-2">
-                                        {{ number_format(App\Models\Thread::count()) }}
+                                        {{ number_format(\Modules\Forum\Domain\Models\Thread::count()) }}
                                     </div>
                                     <div class="flex items-center justify-center space-x-2 text-gray-300">
                                         <i class="fas fa-comments text-green-400"></i>
@@ -223,7 +223,7 @@ class="w-6 h-6 rounded-full">
                                 <div class="absolute -top-8 -right-8 w-24 h-24 bg-purple-500/10 rounded-full filter blur-2xl group-hover/stat:bg-purple-500/20 transition-colors duration-300"></div>
                                 <div class="relative">
                                     <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-purple-400 to-purple-600 bg-clip-text mb-2">
-                                        {{ number_format(App\Models\Post::count()) }}
+                                        {{ number_format(\Modules\Forum\Domain\Models\Post::count()) }}
                                     </div>
                                     <div class="flex items-center justify-center space-x-2 text-gray-300">
                                         <i class="fas fa-comment-dots text-purple-400"></i>
diff --git a/app/Modules/Forum/Services/ForumService.php b/app/Modules/Forum/Services/ForumService.php
index 614d901..56a2234 100644
--- a/app/Modules/Forum/Services/ForumService.php
+++ b/app/Modules/Forum/Services/ForumService.php
@@ -2,9 +2,9 @@
 
 namespace Modules\Forum\Services;
 
-use App\Models\Forum;
-use App\Models\Thread;
-use App\Models\Post;
+use Modules\Forum\Domain\Models\Forum;
+use Modules\Forum\Domain\Models\Post;
+use Modules\Forum\Domain\Models\Thread;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Str;
diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php
index 1e4b7cd..1b43a8d 100755
--- a/app/Providers/AppServiceProvider.php
+++ b/app/Providers/AppServiceProvider.php
@@ -6,7 +6,7 @@
 use Illuminate\Support\ServiceProvider;
 use Illuminate\Support\Facades\Config;
 use Modules\Armory\Services\ArmoryService;
-use App\Services\Parser\WowheadParserService;
+use Modules\Armory\Services\WowheadParserService;
 use Modules\Armory\Domain\Interfaces\ArmoryRepositoryInterface;
 
 class AppServiceProvider extends ServiceProvider
diff --git a/app/Repositories/Armory/TrinityCoreArmoryRepository.php b/app/Repositories/Armory/TrinityCoreArmoryRepository.php
deleted file mode 100644
index 37ddbb2..0000000
--- a/app/Repositories/Armory/TrinityCoreArmoryRepository.php
+++ /dev/null
@@ -1,300 +0,0 @@
-<?php
-namespace App\Repositories\Armory;
-
-use App\Enums\Professions;
-use App\Interfaces\ArmoryRepositoryInterface;
-use App\Traits\ConnectsToExternalDatabase;
-use App\Enums\Achievement;
-use Illuminate\Database\Connection;
-use Illuminate\Support\Collection;
-
-class TrinityCoreArmoryRepository implements ArmoryRepositoryInterface
-{
-    /**
-     * Connect to external databases
-     */
-    use ConnectsToExternalDatabase;
-
-    /**
-     * Connection to auth database
-     */
-    protected ?Connection $auth = null;
-    
-    /**
-     * Connection to characters database
-     */
-    protected ?Connection $characters = null;
-
-    /**
-     * Connection to world database
-     */
-    protected ?Connection $world = null;
-    
-    /**
-     * Array with realm configuration
-     */
-    protected array $realmConfig;
-
-    /**
-     * Constructor
-     *
-     * @param array $realmConfig Array with realm configuration
-     */
-    public function __construct(array $realmConfig)
-    {
-        $this->realmConfig = $realmConfig;
-    }
-
-    /**
-     * Get connection to characters database
-     *
-     * @return ?Connection Connection to characters database or null if connection failed
-     */
-    protected function getCharacters(): ?Connection
-    {
-        if (!$this->characters) {
-            $this->characters = $this->connectToExternalDatabase($this->realmConfig['character_database'], 'characters');
-        }
-        return $this->characters;
-    }
-
-    /**
-     * Get connection to world database
-     *
-     * @return ?Connection Connection to world database or null if connection failed
-     */
-    protected function getWorld(): ?Connection
-    {
-        if (!$this->world) {
-            $this->world = $this->connectToExternalDatabase($this->realmConfig['world_database'], 'world');
-        }
-        return $this->world;
-    }
-
-    /**
-     * Get all characters from characters database
-     *
-     * @return Collection Collection of all characters or empty collection if connection failed
-     */
-    public function getAllCharacters()
-    {
-        $conn = $this->getCharacters();
-        if (!$conn) return collect();
-
-        return $conn->table('characters')->get();
-    }
-
-    /**
-     * Search characters by name
-     *
-     * @param string $q Search query
-     * @return Collection Collection of characters matching the query or empty collection if connection failed
-     */
-    public function search(string $q, ?string $faction, ?string $class, ?int $minLevel)
-    {
-        $conn = $this->getCharacters();
-        if (!$conn) return collect();
-
-        $query = $conn->table('characters');
-
-        if ($q) {
-            $query->where('name', 'like', "%{$q}%");
-        }
-
-        if (!empty($faction)) {
-            $races = $faction === 'horde'
-                ? [2, 5, 6, 8, 9, 10]
-                : [1, 3, 4, 7, 11];
-
-            $query->whereIn('race', $races);
-        }
-
-        if ($class) {
-            $query->where('class', $class);
-        }
-        if ($minLevel) {
-            $query->where('level', '>=', $minLevel);
-        }
-        
-        return $query->orderByDesc('level')->get();
-    }
-
-    /**
-     * Get character by GUID
-     *
-     * @param int $guid Character GUID
-     * @return Collection Collection of character or empty collection if connection failed
-     */
-    public function getCharacter(int $guid)
-    {
-        $conn = $this->getCharacters();
-        if (!$conn) return collect();
-
-        return $conn->table('characters')->where('guid', $guid)->first();
-    }
-
-    /**
-     * Get character items by GUID
-     *
-     * @param int $guid Character GUID
-     * @return Collection Collection of character items or empty collection if connection failed
-     */
-    public function getCharacterItems(int $guid)
-    {
-        $characters = $this->getCharacters();
-        $world = $this->getWorld();
-
-        if (!$characters || !$world) return collect();
-
-        $rows = $characters->table('character_inventory AS ci')
-            ->where('ci.guid', $guid)
-            ->whereBetween('ci.slot', [0, 18])
-            ->join('item_instance AS ii', 'ii.guid', '=', 'ci.item')
-            ->orderBy('ci.slot')
-            ->get([
-                'ci.bag',
-                'ci.slot',
-                'ii.itemEntry',
-            ]);
-        
-        return $rows->map(function ($row) {
-            return [
-                'bag'   => $row->bag,
-                'slot'  => $row->slot,
-                'entry' => $row->itemEntry,
-            ];
-        });
-    }
-
-    /**
-     * Get character achievements by GUID
-     *
-     * @param int $guid Character GUID
-     * @return Collection Collection of character achievements or empty collection if connection failed
-     */
-    public function getAchievementsCharacter(int $guid)
-    {
-        $characters = $this->getCharacters();
-        $world = $this->getWorld();
-
-        if (!$characters || !$world) return collect();
-
-        $rows = $characters->table('character_achievement')
-            ->where('guid', $guid)
-            ->whereNotIn('achievement', Achievement::BLOCK_ACHIEVEMENTS)
-            ->orderByDesc('date')
-            ->limit(10)
-            ->get([
-                'achievement',
-                'date'
-            ]);
-        
-        return $rows->map(function ($row) {
-            return [
-                'id' => $row->achievement,
-                'date' => $row->date,
-            ];
-        });
-    }
-
-    /**
-     * Get guild by ID
-     *
-     * @param int $guildId Guild ID
-     * @return Collection Collection of guild or empty collection if connection failed
-     */
-    public function getGuildByMember(int $memberGuid)
-    {
-        $conn = $this->getCharacters();
-        if (!$conn) return collect();
-
-        return $conn->table('guild as g')
-            ->join('guild_member as gm', 'gm.guildid', '=', 'g.guildid')
-            ->where('gm.guid', $memberGuid)
-            ->first();
-    }
-
-    /**
-     * Get guild rank of member
-     *
-     * @param int $guildId Guild ID
-     * @param int $memberGuid Member GUID
-     * @return Collection Collection of guild rank or empty collection if connection failed
-     */
-    public function getGuildRankMember(int $guildId, int $memberGuid)
-    {
-        $conn = $this->getCharacters();
-        if (!$conn) return collect();
-
-        return $conn->table('guild_member as gm')
-            ->join('guild_rank as gr', 'gr.guildid', '=', 'gm.guildid')
-            ->where('gm.guildid', $guildId)
-            ->where('gm.guid', $memberGuid)
-            ->get([
-                'gr.rname',
-            ])->first();
-    }
-
-    /**
-     * Get Skill of character
-     *
-     * @param int $guid Character GUID
-     * @return Collection Collection of skill or empty collection if connection failed
-     */
-    public function getSkillCharacter(int $guid)
-    {
-        $conn = $this->getCharacters();
-        if (!$conn) return collect();
-
-        $skill = $conn->table('character_skills')
-            ->where('guid', $guid) 
-            ->where('professionSlot', 0)
-            ->get([
-                'skill',
-                'max',
-                'value',
-            ]);
-        
-        return $skill->map(function ($row) {
-            return [
-                'id' => $row->skill,
-                'name' => Professions::getName($row->skill),
-                'type' => Professions::getType($row->skill),
-                'icon' => Professions::getIcon($row->skill),
-                'max' => $row->max,
-                'value' => $row->value,
-            ];
-        });
-    }
-
-    /**
-     * Get Arena Team of character
-     *
-     * @param int $guid Character GUID
-     * @return Collection Collection of arena team or empty collection if connection failed
-     */
-    public function getArenaTeam(int $guid)
-    {
-        $conn = $this->getCharacters();
-        if (!$conn) return collect();
-
-        $arenaTeam = $conn->table('arena_team')
-            ->join('arena_team_member as atm', 'atm.arenaTeamId', '=', 'arena_team.arenaTeamId')
-            ->where('atm.guid', $guid)
-            ->get([
-                'arena_team.arenaTeamId',
-                'arena_team.name',
-                'arena_team.rating',
-                'atm.personalRating',
-            ]);
-        
-        return $arenaTeam->map(function ($row) {
-            return [
-                'id' => $row->arenaTeamId,
-                'name' => $row->name,
-                'points' => $row->rating,
-                'personalRating' => $row->personalRating,
-            ];
-        });
-    }
-}
diff --git a/app/Services/ForumService.php b/app/Services/ForumService.php
deleted file mode 100644
index 9ceec55..0000000
--- a/app/Services/ForumService.php
+++ /dev/null
@@ -1,162 +0,0 @@
-<?php
-
-namespace App\Services;
-
-use App\Models\Forum;
-use App\Models\Thread;
-use App\Models\Post;
-use Illuminate\Support\Facades\Auth;
-use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Str;
-
-/**
- * Service for managing forums, threads, and posts.
- * 
- * Provides methods to:
- * - Retrieve categories and subforums.
- * - Retrieve forums with their threads.
- * - Retrieve threads with their posts.
- * - Create threads and posts.
- */
-class ForumService
-{
-    /**
-     * Get main categories with their subforums.
-     *
-     * @return \Illuminate\Database\Eloquent\Collection|Forum[]
-     */
-    public function getCategories()
-    {
-        return Forum::where('is_category', true)
-            ->orderBy('order')
-            ->with(['subforums' => function ($query) {
-                $query->orderBy('order');
-            }])
-            ->get();
-    }
-
-    /**
-     * Get a forum by slug with its threads.
-     *
-     * @param string $slug
-     * @return array{forum: Forum, threads: \Illuminate\Contracts\Pagination\LengthAwarePaginator}
-     */
-    public function getForumWithThreads(string $slug)
-    {
-        $forum = Forum::where('slug', $slug)
-            ->with(['subforums' => function ($query) {
-                $query->orderBy('order');
-            }])
-            ->firstOrFail();
-
-        $threads = Thread::where('forum_id', $forum->id)
-            ->orderBy('is_sticky', 'desc')
-            ->orderBy('created_at', 'desc')
-            ->with(['user', 'latestPost.user'])
-            ->paginate(20);
-
-        return compact('forum', 'threads');
-    }
-
-    /**
-     * Get a thread with its posts.
-     *
-     * @param string $forumSlug
-     * @param string $threadSlug
-     * @return array{forum: Forum, thread: Thread, posts: \Illuminate\Contracts\Pagination\LengthAwarePaginator}
-     */
-    public function getThreadWithPosts(string $forumSlug, string $threadSlug)
-    {
-        $forum = Forum::where('slug', $forumSlug)->firstOrFail();
-        $thread = Thread::where('slug', $threadSlug)
-            ->where('forum_id', $forum->id)
-            ->firstOrFail();
-
-        $thread->increment('view_count');
-
-        $posts = Post::where('thread_id', $thread->id)
-            ->orderBy('created_at')
-            ->with('user')
-            ->paginate(15);
-
-        return compact('forum', 'thread', 'posts');
-    }
-
-    /**
-     * Create a new thread with its first post.
-     *
-     * @param Forum $forum
-     * @param array $validated Validated thread data ['title' => string, 'content' => string]
-     * @return string The unique slug of the created thread
-     * @throws \Throwable
-     */
-    public function createThread(Forum $forum, array $validated)
-    {
-        $threadSlug = Str::slug($validated['title']);
-
-        // Make slug unique if it already exists
-        $count = Thread::where('slug', $threadSlug)->count();
-        if ($count > 0) {
-            $threadSlug .= '-' . time();
-        }
-
-        DB::transaction(function () use ($forum, $validated, $threadSlug) {
-            $thread = Thread::create([
-                'title'    => $validated['title'],
-                'slug'     => $threadSlug,
-                'forum_id' => $forum->id,
-                'user_id'  => Auth::id(),
-            ]);
-
-            $post = Post::create([
-                'thread_id'     => $thread->id,
-                'user_id'       => Auth::id(),
-                'content'       => $validated['content'],
-                'is_first_post' => true,
-            ]);
-
-            $thread->update([
-                'first_post_id'  => $post->id,
-                'latest_post_id' => $post->id,
-            ]);
-
-            $forum->update([
-                'latest_thread_id' => $thread->id,
-            ]);
-        });
-
-        return $threadSlug;
-    }
-
-    /**
-     * Create a new post in a thread.
-     *
-     * @param Thread $thread
-     * @param array $validated Validated post data ['content' => string]
-     * @return void
-     * @throws \Exception If the thread is locked
-     * @throws \Throwable
-     */
-    public function createPost(Thread $thread, array $validated)
-    {
-        if ($thread->is_locked) {
-            throw new \Exception('Thread is locked.');
-        }
-
-        DB::transaction(function () use ($thread, $validated) {
-            $post = Post::create([
-                'thread_id' => $thread->id,
-                'user_id'   => Auth::id(),
-                'content'   => $validated['content'],
-            ]);
-
-            $thread->update([
-                'latest_post_id' => $post->id,
-            ]);
-
-            $thread->forum->update([
-                'latest_thread_id' => $thread->id,
-            ]);
-        });
-    }
-}
diff --git a/database/seeders/ForumsSeeder.php b/database/seeders/ForumsSeeder.php
index 7633df9..01576bd 100755
--- a/database/seeders/ForumsSeeder.php
+++ b/database/seeders/ForumsSeeder.php
@@ -3,9 +3,9 @@
 namespace Database\Seeders;
 
 use Illuminate\Database\Seeder;
-use App\Models\Forum;
-use App\Models\Thread;
-use App\Models\Post;
+use Modules\Forum\Domain\Models\Forum;
+use Modules\Forum\Domain\Models\Post;
+use Modules\Forum\Domain\Models\Thread;
 use App\Models\User;
 use Illuminate\Support\Str;
 
diff --git a/resources/views/forums/index.blade.php b/resources/views/forums/index.blade.php
index 144f2d0..b015b86 100755
--- a/resources/views/forums/index.blade.php
+++ b/resources/views/forums/index.blade.php
@@ -204,7 +204,7 @@ class="w-6 h-6 rounded-full">
                                 <div class="absolute -top-8 -right-8 w-24 h-24 bg-green-500/10 rounded-full filter blur-2xl group-hover/stat:bg-green-500/20 transition-colors duration-300"></div>
                                 <div class="relative">
                                     <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-green-400 to-green-600 bg-clip-text mb-2">
-                                        {{ number_format(App\Models\Thread::count()) }}
+                                        {{ number_format(\Modules\Forum\Domain\Models\Thread::count()) }}
                                     </div>
                                     <div class="flex items-center justify-center space-x-2 text-gray-300">
                                         <i class="fas fa-comments text-green-400"></i>
@@ -223,7 +223,7 @@ class="w-6 h-6 rounded-full">
                                 <div class="absolute -top-8 -right-8 w-24 h-24 bg-purple-500/10 rounded-full filter blur-2xl group-hover/stat:bg-purple-500/20 transition-colors duration-300"></div>
                                 <div class="relative">
                                     <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-purple-400 to-purple-600 bg-clip-text mb-2">
-                                        {{ number_format(App\Models\Post::count()) }}
+                                        {{ number_format(\Modules\Forum\Domain\Models\Post::count()) }}
                                     </div>
                                     <div class="flex items-center justify-center space-x-2 text-gray-300">
                                         <i class="fas fa-comment-dots text-purple-400"></i>
diff --git a/routes/web.php b/routes/web.php
index 40c6071..d5fcfd5 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -5,7 +5,6 @@
 use App\Http\Controllers\Frontend\Users\UserController;
 use App\Http\Controllers\Frontend\Users\AuthController;
 use App\Http\Controllers\Frontend\InstallController;
-use App\Http\Controllers\Frontend\ForumsController;
 use App\Http\Controllers\Frontend\SubscriptionController;
 use App\Http\Controllers\Frontend\CommentController;
 use Illuminate\Support\Facades\Redis;

From 22340f2e9a6215cf367b38565788ecfddfaabf68 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Mon, 23 Mar 2026 21:20:45 +0100
Subject: [PATCH 094/132] test: Add feature tests for AnalyticsService,
 ModuleLoader, ModuleRegistryService, RealmHelper, and AuthService

---
 tests/Feature/AnalyticsServiceTest.php      | 133 ++++++++++++++++++++
 tests/Feature/ModuleLoaderTest.php          |  24 ++++
 tests/Feature/ModuleRegistryServiceTest.php | 112 +++++++++++++++++
 tests/Feature/RealmHelperDatabaseTest.php   |  64 ++++++++++
 tests/Unit/AuthServiceTest.php              |  53 ++++++++
 tests/Unit/GeneralHelperEdgeCaseTest.php    |  26 ++++
 tests/Unit/RealmHelperTest.php              |  42 +++++++
 7 files changed, 454 insertions(+)
 create mode 100644 tests/Feature/AnalyticsServiceTest.php
 create mode 100644 tests/Feature/ModuleLoaderTest.php
 create mode 100644 tests/Feature/ModuleRegistryServiceTest.php
 create mode 100644 tests/Feature/RealmHelperDatabaseTest.php
 create mode 100644 tests/Unit/AuthServiceTest.php
 create mode 100644 tests/Unit/GeneralHelperEdgeCaseTest.php
 create mode 100644 tests/Unit/RealmHelperTest.php

diff --git a/tests/Feature/AnalyticsServiceTest.php b/tests/Feature/AnalyticsServiceTest.php
new file mode 100644
index 0000000..1e5075b
--- /dev/null
+++ b/tests/Feature/AnalyticsServiceTest.php
@@ -0,0 +1,133 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\AnalyticsPageView;
+use App\Models\AnalyticsSession;
+use App\Services\AnalyticsService;
+use Carbon\Carbon;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class AnalyticsServiceTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_get_start_date_uses_period_rules(): void
+    {
+        Carbon::setTestNow(Carbon::create(2026, 3, 23, 0, 0, 0));
+
+        $service = new AnalyticsService();
+
+        $this->assertSame('2026-03-16', $service->getStartDate('7d')->toDateString());
+        $this->assertSame('2025-12-23', $service->getStartDate('90d')->toDateString());
+        $this->assertSame('2025-03-23', $service->getStartDate('1y')->toDateString());
+        $this->assertSame('2026-02-21', $service->getStartDate('invalid')->toDateString());
+
+        Carbon::setTestNow();
+    }
+
+    public function test_format_seconds_returns_mm_ss(): void
+    {
+        $service = new AnalyticsService();
+
+        $this->assertSame('0:00', $service->formatSeconds(0));
+        $this->assertSame('1:05', $service->formatSeconds(65));
+        $this->assertSame('10:00', $service->formatSeconds(600));
+    }
+
+    public function test_analytics_aggregates_ignore_bots_and_compute_metrics(): void
+    {
+        $startDate = now()->subDays(30);
+
+        $humanA = AnalyticsSession::create([
+            'visitor_id' => 'v-1',
+            'ip_address' => '127.0.0.1',
+            'user_agent' => 'Mozilla/5.0 (Windows NT 10.0)',
+            'duration_seconds' => 120,
+            'page_views' => 2,
+            'is_bot' => false,
+            'created_at' => now()->subDays(2),
+            'updated_at' => now()->subDays(2),
+        ]);
+
+        $humanB = AnalyticsSession::create([
+            'visitor_id' => 'v-2',
+            'ip_address' => '127.0.0.2',
+            'user_agent' => 'Mozilla/5.0 (iPhone; CPU iPhone OS) mobile',
+            'duration_seconds' => 60,
+            'page_views' => 1,
+            'is_bot' => false,
+            'created_at' => now()->subDays(1),
+            'updated_at' => now()->subDays(1),
+        ]);
+
+        AnalyticsSession::create([
+            'visitor_id' => 'v-bot',
+            'ip_address' => '127.0.0.3',
+            'user_agent' => 'Googlebot',
+            'duration_seconds' => 999,
+            'page_views' => 10,
+            'is_bot' => true,
+            'created_at' => now()->subDays(1),
+            'updated_at' => now()->subDays(1),
+        ]);
+
+        AnalyticsPageView::create([
+            'session_id' => $humanA->id,
+            'page_url' => '/news',
+            'page_title' => 'News',
+            'referrer' => 'google.com',
+            'time_on_page' => 40,
+            'bounced' => false,
+            'created_at' => now()->subDays(2),
+            'updated_at' => now()->subDays(2),
+        ]);
+
+        AnalyticsPageView::create([
+            'session_id' => $humanA->id,
+            'page_url' => '/forum',
+            'page_title' => 'Forum',
+            'referrer' => null,
+            'time_on_page' => 20,
+            'bounced' => true,
+            'created_at' => now()->subDays(2),
+            'updated_at' => now()->subDays(2),
+        ]);
+
+        AnalyticsPageView::create([
+            'session_id' => $humanB->id,
+            'page_url' => '/news',
+            'page_title' => 'News',
+            'referrer' => 'x.com',
+            'time_on_page' => 50,
+            'bounced' => false,
+            'created_at' => now()->subDay(),
+            'updated_at' => now()->subDay(),
+        ]);
+
+        $service = new AnalyticsService();
+
+        $this->assertSame(2, $service->getTotalVisitors($startDate));
+        $this->assertSame(3, $service->getPageViews($startDate));
+        $this->assertSame(33.33, $service->getBounceRate($startDate));
+        $this->assertSame('1:30', $service->getAverageSessionDuration($startDate));
+
+        $topPages = $service->getTopPages($startDate, 10);
+        $this->assertNotEmpty($topPages);
+        $this->assertArrayHasKey('url', $topPages[0]);
+        $this->assertArrayHasKey('views', $topPages[0]);
+
+        $byDevice = $service->getTrafficByDevice($startDate);
+        $this->assertNotEmpty($byDevice);
+
+        $bySource = $service->getTrafficBySource($startDate);
+        $this->assertNotEmpty($bySource);
+
+        $analytics = $service->getAnalyticsData('30d');
+        $this->assertSame('30d', $analytics['period']);
+        $this->assertArrayHasKey('total_visitors', $analytics);
+        $this->assertArrayHasKey('traffic_by_device', $analytics);
+        $this->assertArrayHasKey('traffic_by_source', $analytics);
+    }
+}
diff --git a/tests/Feature/ModuleLoaderTest.php b/tests/Feature/ModuleLoaderTest.php
new file mode 100644
index 0000000..f8cd1b6
--- /dev/null
+++ b/tests/Feature/ModuleLoaderTest.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Helpers\ModuleLoader;
+use App\Services\ModuleRegistryService;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class ModuleLoaderTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_get_providers_proxies_registry_service(): void
+    {
+        ModuleRegistryService::flushCache();
+
+        $expected = ModuleRegistryService::getEnabledProviders();
+        $actual = ModuleLoader::getProviders();
+
+        $this->assertSame($expected, $actual);
+        $this->assertIsArray($actual);
+    }
+}
diff --git a/tests/Feature/ModuleRegistryServiceTest.php b/tests/Feature/ModuleRegistryServiceTest.php
new file mode 100644
index 0000000..a693de7
--- /dev/null
+++ b/tests/Feature/ModuleRegistryServiceTest.php
@@ -0,0 +1,112 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Services\ModuleRegistryService;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Str;
+use Tests\TestCase;
+
+class ModuleRegistryServiceTest extends TestCase
+{
+    use RefreshDatabase;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        ModuleRegistryService::flushCache();
+    }
+
+    public function test_get_all_modules_returns_manifest_with_expected_shape(): void
+    {
+        $modules = ModuleRegistryService::getAllModules();
+
+        $this->assertNotEmpty($modules);
+
+        $first = $modules[0];
+        $this->assertArrayHasKey('folder', $first);
+        $this->assertArrayHasKey('name', $first);
+        $this->assertArrayHasKey('enabled', $first);
+        $this->assertArrayHasKey('module_type', $first);
+    }
+
+    public function test_get_module_returns_null_for_blank_and_module_for_valid_name(): void
+    {
+        $this->assertNull(ModuleRegistryService::getModule(''));
+
+        $forum = ModuleRegistryService::getModule('Forum');
+
+        $this->assertIsArray($forum);
+        $this->assertSame('Forum', $forum['folder']);
+    }
+
+    public function test_get_module_state_uses_fallback_and_normalizes_invalid_type(): void
+    {
+        $state = ModuleRegistryService::getModuleState('UnknownModule', [
+            'enabled' => false,
+            'module_type' => 'invalid_type',
+        ]);
+
+        $this->assertFalse($state['enabled']);
+        $this->assertSame('core', $state['module_type']);
+    }
+
+    public function test_upsert_state_and_is_module_enabled_work_with_database_state(): void
+    {
+        ModuleRegistryService::upsertState('Forum', false, 'third_party');
+
+        $state = ModuleRegistryService::getModuleState('Forum');
+
+        $this->assertFalse(ModuleRegistryService::isModuleEnabled('Forum', true));
+        $this->assertFalse($state['enabled']);
+        $this->assertSame('third_party', $state['module_type']);
+
+        ModuleRegistryService::upsertState('Forum', true, 'invalid_type');
+
+        $stateAfter = ModuleRegistryService::getModuleState('Forum');
+        $this->assertTrue($stateAfter['enabled']);
+        $this->assertSame('core', $stateAfter['module_type']);
+    }
+
+    public function test_delete_state_removes_custom_module_state(): void
+    {
+        ModuleRegistryService::upsertState('Store', false, 'core');
+
+        $this->assertFalse(ModuleRegistryService::isModuleEnabled('Store', true));
+
+        ModuleRegistryService::deleteState('Store');
+
+        $store = ModuleRegistryService::getModule('Store');
+        $fallbackEnabled = (bool) ($store['enabled'] ?? true);
+        $this->assertSame($fallbackEnabled, ModuleRegistryService::isModuleEnabled('Store', true));
+    }
+
+    public function test_get_enabled_providers_returns_unique_provider_list(): void
+    {
+        $providers = ModuleRegistryService::getEnabledProviders();
+
+        $this->assertIsArray($providers);
+        $this->assertSame(array_values(array_unique($providers)), $providers);
+
+        foreach ($providers as $provider) {
+            $this->assertIsString($provider);
+            $this->assertTrue($provider === '' || Str::contains($provider, '\\'));
+        }
+    }
+
+    public function test_sync_discovered_modules_persists_states_without_errors(): void
+    {
+        $modules = ModuleRegistryService::getAllModules();
+
+        ModuleRegistryService::syncDiscoveredModules($modules);
+
+        foreach ($modules as $module) {
+            $name = $module['folder'] ?? null;
+            if (is_string($name) && $name !== '') {
+                $state = ModuleRegistryService::getModuleState($name);
+                $this->assertArrayHasKey('enabled', $state);
+                $this->assertArrayHasKey('module_type', $state);
+            }
+        }
+    }
+}
diff --git a/tests/Feature/RealmHelperDatabaseTest.php b/tests/Feature/RealmHelperDatabaseTest.php
new file mode 100644
index 0000000..1f91e66
--- /dev/null
+++ b/tests/Feature/RealmHelperDatabaseTest.php
@@ -0,0 +1,64 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Helpers\RealmHelper;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\DB;
+use Tests\TestCase;
+
+class RealmHelperDatabaseTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_all_returns_realms_collection(): void
+    {
+        DB::table('realms')->insert([
+            'name' => 'Test Realm',
+            'hostname' => '127.0.0.1',
+            'expansion' => 2,
+            'emulator' => 'Trinity',
+            'port' => 8085,
+            'auth_database' => json_encode(['name' => 'auth']),
+            'world_database' => json_encode(['name' => 'world']),
+            'console_hostname' => '127.0.0.1',
+            'console_port' => 3443,
+            'console_username' => 'admin',
+            'console_password' => 'pass',
+            'console_urn' => 'urn:test',
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+
+        $all = RealmHelper::all();
+
+        $this->assertCount(1, $all);
+        $this->assertSame('Test Realm', $all->first()->name);
+    }
+
+    public function test_find_returns_realm_or_null(): void
+    {
+        $id = DB::table('realms')->insertGetId([
+            'name' => 'Find Realm',
+            'hostname' => '127.0.0.2',
+            'expansion' => 3,
+            'emulator' => 'AzerothCore',
+            'port' => 8086,
+            'auth_database' => json_encode(['name' => 'auth2']),
+            'world_database' => json_encode(['name' => 'world2']),
+            'console_hostname' => '127.0.0.2',
+            'console_port' => 3444,
+            'console_username' => 'admin2',
+            'console_password' => 'pass2',
+            'console_urn' => 'urn:test2',
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+
+        $realm = RealmHelper::find($id);
+
+        $this->assertNotNull($realm);
+        $this->assertSame('Find Realm', $realm->name);
+        $this->assertNull(RealmHelper::find(999999));
+    }
+}
diff --git a/tests/Unit/AuthServiceTest.php b/tests/Unit/AuthServiceTest.php
new file mode 100644
index 0000000..2c95739
--- /dev/null
+++ b/tests/Unit/AuthServiceTest.php
@@ -0,0 +1,53 @@
+<?php
+
+namespace Tests\Unit;
+
+use App\Services\AuthService;
+use Illuminate\Contracts\Auth\Factory as AuthFactory;
+use Illuminate\Contracts\Auth\StatefulGuard;
+use Illuminate\Contracts\Hashing\Hasher as HasherContract;
+use PHPUnit\Framework\TestCase;
+
+class AuthServiceTest extends TestCase
+{
+    public function test_attempt_login_uses_guard_attempt_and_returns_result(): void
+    {
+        $credentials = ['email' => 'test@example.com', 'password' => 'secret'];
+
+        $guard = $this->createMock(StatefulGuard::class);
+        $guard->expects($this->once())
+            ->method('attempt')
+            ->with($credentials)
+            ->willReturn(true);
+
+        $authFactory = $this->createMock(AuthFactory::class);
+        $authFactory->expects($this->once())
+            ->method('guard')
+            ->willReturn($guard);
+
+        $hasher = $this->createMock(HasherContract::class);
+
+        $service = new AuthService($authFactory, $hasher);
+
+        $this->assertTrue($service->attemptLogin($credentials));
+    }
+
+    public function test_logout_uses_guard_logout(): void
+    {
+        $guard = $this->createMock(StatefulGuard::class);
+        $guard->expects($this->once())
+            ->method('logout');
+
+        $authFactory = $this->createMock(AuthFactory::class);
+        $authFactory->expects($this->once())
+            ->method('guard')
+            ->willReturn($guard);
+
+        $hasher = $this->createMock(HasherContract::class);
+
+        $service = new AuthService($authFactory, $hasher);
+        $service->logout();
+
+        $this->assertTrue(true);
+    }
+}
diff --git a/tests/Unit/GeneralHelperEdgeCaseTest.php b/tests/Unit/GeneralHelperEdgeCaseTest.php
new file mode 100644
index 0000000..baa3300
--- /dev/null
+++ b/tests/Unit/GeneralHelperEdgeCaseTest.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace Tests\Unit;
+
+use App\Helpers\GeneralHelper;
+use PHPUnit\Framework\TestCase;
+
+class GeneralHelperEdgeCaseTest extends TestCase
+{
+    public function test_reading_time_ignores_html_and_honors_custom_wpm(): void
+    {
+        $html = '<p>' . str_repeat('word ', 300) . '</p>';
+
+        $minutes = GeneralHelper::readingTime($html, 150);
+
+        $this->assertSame(2, $minutes);
+    }
+
+    public function test_share_social_returns_default_for_unknown_network(): void
+    {
+        $result = GeneralHelper::shareSocial('mastodon', 'https://example.com', 'Title');
+
+        $this->assertSame('#', $result['url']);
+        $this->assertSame('', $result['icon']);
+    }
+}
diff --git a/tests/Unit/RealmHelperTest.php b/tests/Unit/RealmHelperTest.php
new file mode 100644
index 0000000..a4894a7
--- /dev/null
+++ b/tests/Unit/RealmHelperTest.php
@@ -0,0 +1,42 @@
+<?php
+
+namespace Tests\Unit;
+
+use App\Enums\WoWConstants;
+use App\Helpers\RealmHelper;
+use PHPUnit\Framework\TestCase;
+
+class RealmHelperTest extends TestCase
+{
+    public function test_get_wow_constant_returns_null_when_id_is_null(): void
+    {
+        $this->assertNull(RealmHelper::getWoWConstant('expansion', null));
+    }
+
+    public function test_get_wow_constant_returns_expected_values(): void
+    {
+        $this->assertSame('Vanilla', RealmHelper::getWoWConstant('expansion', WoWConstants::EXPANSION_VANILLA));
+        $this->assertSame('3.3.5a', RealmHelper::getWoWConstant('version', WoWConstants::EXPANSION_WOTLK));
+        $this->assertSame('Warrior', RealmHelper::getWoWConstant('class', WoWConstants::CLASS_WARRIOR));
+        $this->assertSame('Human', RealmHelper::getWoWConstant('race', WoWConstants::RACE_HUMAN));
+    }
+
+    public function test_get_wow_constant_returns_null_for_unknown_type_or_id(): void
+    {
+        $this->assertNull(RealmHelper::getWoWConstant('unknown', 1));
+        $this->assertNull(RealmHelper::getWoWConstant('expansion', 99999));
+    }
+
+    public function test_get_faction_by_race_returns_alliance_horde_or_null(): void
+    {
+        $this->assertSame('alliance', RealmHelper::getFactionByRace(WoWConstants::RACE_HUMAN));
+        $this->assertSame('horde', RealmHelper::getFactionByRace(WoWConstants::RACE_ORC));
+        $this->assertNull(RealmHelper::getFactionByRace(99999));
+    }
+
+    public function test_calculate_item_level_promed_handles_empty_and_valid_arrays(): void
+    {
+        $this->assertNull(RealmHelper::calculateItemLevelPromed([]));
+        $this->assertSame(250.0, RealmHelper::calculateItemLevelPromed([200, 250, 300]));
+    }
+}

From a390d051c08620bb2d92228033b214560bcb6296 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 5 Apr 2026 19:25:39 +0200
Subject: [PATCH 095/132] fix(security): remove debug route, add auth/throttle
 middleware, sanitize settings keys

- Remove exposed GET /test-redis route and unused Redis import
- Add auth middleware to POST/DELETE comment routes to prevent anonymous comments
- Add throttle:5,1 middleware to POST /auth/login and /auth/register
- Validate settings view before processing in AdminSettingsController
- Sanitize setting keys with regex whitelist and truncate values to 65535 chars
- Remove nullable fallback from Comment user_id (guaranteed by auth middleware)
---
 .../Frontend/CommentController.php            |  2 +-
 .../Controllers/AdminSettingsController.php   | 14 ++++++++++
 routes/web.php                                | 26 +++----------------
 3 files changed, 19 insertions(+), 23 deletions(-)

diff --git a/app/Http/Controllers/Frontend/CommentController.php b/app/Http/Controllers/Frontend/CommentController.php
index 50e62d1..b4426b9 100644
--- a/app/Http/Controllers/Frontend/CommentController.php
+++ b/app/Http/Controllers/Frontend/CommentController.php
@@ -27,7 +27,7 @@ public function store(Request $request, $slug)
 
         $comment = new Comment();
         $comment->comment = $request->body;
-        $comment->user_id = Auth::id() ?? null;
+        $comment->user_id = Auth::id();
         $comment->commentable_id = $news->id;
         $comment->commentable_type = News::class;
         $comment->save();
diff --git a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
index c228734..9ad9b72 100644
--- a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
@@ -47,6 +47,10 @@ public function store(Request $request)
     {
         $view = $request->get('view');
 
+        if (!array_key_exists($view, $this->view)) {
+            abort(404);
+        }
+
         // Prevent storage for specific views that handle their own data or are read-only here
         if (in_array($view, ['realms'])) {
             return redirect()->route('admin.settings.index', ['view' => $view])
@@ -56,6 +60,16 @@ public function store(Request $request)
         $data = $request->except(['_token', 'view']);
 
         foreach ($data as $key => $value) {
+            // Only allow keys matching the pattern: lowercase letters, digits, underscores and dots
+            if (!preg_match('/^[a-z][a-z0-9_.]*$/i', (string) $key)) {
+                continue;
+            }
+
+            // Limit value length to prevent oversized payloads
+            if (is_string($value)) {
+                $value = mb_substr($value, 0, 65535);
+            }
+
             Setting::updateOrCreate(
                 ['key' => $key],
                 ['value' => $value]
diff --git a/routes/web.php b/routes/web.php
index d5fcfd5..0e541c8 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -7,29 +7,11 @@
 use App\Http\Controllers\Frontend\InstallController;
 use App\Http\Controllers\Frontend\SubscriptionController;
 use App\Http\Controllers\Frontend\CommentController;
-use Illuminate\Support\Facades\Redis;
 use Illuminate\Support\Facades\Route;
 
 Route::get('/', [HomeController::class, 'index'])->middleware(['track.analytics'])->name('home');
 Route::get('/howtoplay', [HomeController::class, 'howToPlay'])->middleware(['track.analytics'])->name('howtoplay');
 
-Route::get('/test-redis', function() {
-    try {
-        $pong = Redis::ping();
-        $keys = Redis::keys('*');
-        return response()->json([
-            'connected' => $pong === '+PONG',
-            'keys_count' => count($keys),
-            'keys' => $keys
-        ]);
-    } catch (\Exception $e) {
-        return response()->json([
-            'connected' => false,
-            'error' => $e->getMessage()
-        ]);
-    }
-});
-
 Route::middleware([])->group(function () {
     if (!file_exists(storage_path('installed.lock'))) {
         Route::get('/install', [InstallController::class, 'index'])->name('install.index');
@@ -42,8 +24,8 @@
 Route::prefix('news')->middleware(['track.analytics'])->group(function () {
     Route::get('/', [NewsController::class, 'index'])->name('news');
     Route::get('/{slug}', [NewsController::class, 'show'])->name('news.show');
-    Route::post('/{slug}/comment', [CommentController::class, 'store'])->name('news.comment.store');
-    Route::delete('/comment/{id}', [CommentController::class, 'destroy'])->name('news.comment.destroy');
+    Route::post('/{slug}/comment', [CommentController::class, 'store'])->middleware('auth')->name('news.comment.store');
+    Route::delete('/comment/{id}', [CommentController::class, 'destroy'])->middleware('auth')->name('news.comment.destroy');
     Route::post('/subscribe', [SubscriptionController::class, 'subscribe'])->name('subscribe');
     Route::get('/confirm-subscription/{token}', [SubscriptionController::class, 'confirmSubscription'])->name('confirm.subscription');
     Route::get('/unsubscribe/{token}', [SubscriptionController::class, 'unsubscribe'])->name('unsubscribe');
@@ -51,9 +33,9 @@
 
 Route::prefix('auth')->group(function () {
     Route::get('/login', [AuthController::class,'showLoginForm'])->name('login');
-    Route::post('/login', [AuthController::class, 'login']);
+    Route::post('/login', [AuthController::class, 'login'])->middleware('throttle:5,1');
     Route::get('/register', [AuthController::class,'showRegisterForm'])->name('register');
-    Route::post('/register', [AuthController::class,'register']);
+    Route::post('/register', [AuthController::class,'register'])->middleware('throttle:5,1');
     Route::post('/logout', [AuthController::class, 'logout'])->name('logout');
 });
 

From 25c4c921651b728cd103006cb55f1f706cf5d78f Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 5 Apr 2026 19:31:17 +0200
Subject: [PATCH 096/132] refactor(modules): normalize Setting model namespace
 to Modules\Admin\Domain\Models

---
 app/Helpers/SettingsHelper.php                                 | 2 +-
 app/Modules/Admin/Domain/Models/Setting.php                    | 2 +-
 app/Modules/Admin/Http/Controllers/AdminSettingsController.php | 2 +-
 app/Modules/Admin/Http/Controllers/MenuManagerController.php   | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/app/Helpers/SettingsHelper.php b/app/Helpers/SettingsHelper.php
index 273b916..dc7657e 100644
--- a/app/Helpers/SettingsHelper.php
+++ b/app/Helpers/SettingsHelper.php
@@ -1,6 +1,6 @@
 <?php
 
-use App\Modules\Admin\Domain\Models\Setting;
+use Modules\Admin\Domain\Models\Setting;
 use App\Services\ModuleRegistryService;
 use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\Route;
diff --git a/app/Modules/Admin/Domain/Models/Setting.php b/app/Modules/Admin/Domain/Models/Setting.php
index 1910f0a..782037d 100644
--- a/app/Modules/Admin/Domain/Models/Setting.php
+++ b/app/Modules/Admin/Domain/Models/Setting.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace App\Modules\Admin\Domain\Models;
+namespace Modules\Admin\Domain\Models;
 
 use Illuminate\Database\Eloquent\Model;
 
diff --git a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
index 9ad9b72..2aa6a2a 100644
--- a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
@@ -3,7 +3,7 @@
 namespace Modules\Admin\Http\Controllers;
 
 use App\Http\Controllers\Controller;
-use App\Modules\Admin\Domain\Models\Setting;
+use Modules\Admin\Domain\Models\Setting;
 use Illuminate\Http\Request;
 
 use Illuminate\Support\Facades\Cache;
diff --git a/app/Modules/Admin/Http/Controllers/MenuManagerController.php b/app/Modules/Admin/Http/Controllers/MenuManagerController.php
index 03fb0a8..5111891 100644
--- a/app/Modules/Admin/Http/Controllers/MenuManagerController.php
+++ b/app/Modules/Admin/Http/Controllers/MenuManagerController.php
@@ -3,7 +3,7 @@
 namespace Modules\Admin\Http\Controllers;
 
 use App\Http\Controllers\Controller;
-use App\Modules\Admin\Domain\Models\Setting;
+use Modules\Admin\Domain\Models\Setting;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\File;

From 8d006c2da5e1be809f56584ecefd7fa37da1e3af Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Mon, 20 Apr 2026 02:07:44 +0200
Subject: [PATCH 097/132] Implement forum thread display and creation features

- Added the forum show view to display forum details, subforums, and threads.
- Updated ForumService to include thread counts and latest threads in subforums.
- Created a new view for creating threads with validation error handling.
- Added a new view for displaying individual threads and their posts, including reply functionality.
- Updated DatabaseSeeder to include ForumsSeeder for initial data setup.
---
 app/Modules/Armory/module.json                |   2 +-
 app/Modules/Forum/Domain/Models/Forum.php     |  20 +-
 .../Http/Controllers/ForumController.php      |  39 ++-
 app/Modules/Forum/Http/routes.php             |  12 +-
 .../Resources/views/create-thread.blade.php   |  95 ++++++
 .../Forum/Resources/views/index.blade.php     | 320 +++++-------------
 .../Forum/Resources/views/show.blade.php      | 154 +++++++++
 .../Forum/Resources/views/thread.blade.php    | 176 ++++++++++
 app/Modules/Forum/Services/ForumService.php   |  15 +-
 database/seeders/DatabaseSeeder.php           |   1 +
 10 files changed, 576 insertions(+), 258 deletions(-)
 create mode 100644 app/Modules/Forum/Resources/views/create-thread.blade.php
 create mode 100644 app/Modules/Forum/Resources/views/thread.blade.php

diff --git a/app/Modules/Armory/module.json b/app/Modules/Armory/module.json
index 6c65e55..ddebc52 100644
--- a/app/Modules/Armory/module.json
+++ b/app/Modules/Armory/module.json
@@ -1,6 +1,6 @@
 {
     "name": "Armorytest",
-    "enabled": false,
+    "enabled": true,
     "routes": true,
     "migrations": true,
     "views": true,
diff --git a/app/Modules/Forum/Domain/Models/Forum.php b/app/Modules/Forum/Domain/Models/Forum.php
index 4a1bbbc..88f87d6 100644
--- a/app/Modules/Forum/Domain/Models/Forum.php
+++ b/app/Modules/Forum/Domain/Models/Forum.php
@@ -5,6 +5,7 @@
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\HasManyThrough;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class Forum extends Model
@@ -20,35 +21,28 @@ class Forum extends Model
         'is_category',
     ];
 
-    /**
-     * Get all threads for this forum
-     */
     public function threads(): HasMany
     {
         return $this->hasMany(Thread::class);
     }
 
-    /**
-     * Get the parent forum if this is a subforum
-     */
+    public function posts(): HasManyThrough
+    {
+        return $this->hasManyThrough(Post::class, Thread::class);
+    }
+
     public function parent(): BelongsTo
     {
         return $this->belongsTo(Forum::class, 'parent_id');
     }
 
-    /**
-     * Get all subforums for this forum
-     */
     public function subforums(): HasMany
     {
         return $this->hasMany(Forum::class, 'parent_id');
     }
 
-    /**
-     * Get the latest thread in this forum
-     */
     public function latestThread(): BelongsTo
     {
         return $this->belongsTo(Thread::class, 'latest_thread_id');
     }
-}
\ No newline at end of file
+}
diff --git a/app/Modules/Forum/Http/Controllers/ForumController.php b/app/Modules/Forum/Http/Controllers/ForumController.php
index 613b739..9a5838d 100644
--- a/app/Modules/Forum/Http/Controllers/ForumController.php
+++ b/app/Modules/Forum/Http/Controllers/ForumController.php
@@ -14,6 +14,9 @@ class ForumController extends Controller
 
     protected array $views = [
         'index'         => 'forum::index',
+        'forum'         => 'forum::show',
+        'thread'        => 'forum::thread',
+        'create_thread' => 'forum::create-thread',
     ];
 
     public function __construct(ForumService $forumService)
@@ -21,28 +24,28 @@ public function __construct(ForumService $forumService)
         $this->forumService = $forumService;
     }
 
-    public function index() : View
+    public function index(): View
     {
         $categories = $this->forumService->getCategories();
 
         return view($this->views['index'], compact('categories'));
     }
 
-    public function forum(string $slug) : View
+    public function forum(string $slug): View
     {
-        $forum = $this->forumService->getForumWithThreads($slug);
+        $data = $this->forumService->getForumWithThreads($slug);
 
-        return view($this->views['forum'], compact('forum'));
+        return view($this->views['forum'], $data);
     }
 
-    public function thread(string $forumSlug, string $threadSlug, ?string $view = null) : View
+    public function thread(string $forumSlug, string $threadSlug): View
     {
         $data = $this->forumService->getThreadWithPosts($forumSlug, $threadSlug);
 
-        return view($this->views['thread'], compact('thread'));
+        return view($this->views['thread'], $data);
     }
 
-    public function createThread(string $slug) : View
+    public function createThread(string $slug): View
     {
         $forum = Forum::where('slug', $slug)->firstOrFail();
 
@@ -51,7 +54,7 @@ public function createThread(string $slug) : View
 
     public function storeThread(Request $request, string $slug)
     {
-        $forum = Forum::where('slug', $slug)->firstOrFail();
+        $forum = Forum::where('slug', $slug)->where('is_category', false)->firstOrFail();
 
         $validated = $request->validate([
             'title'   => 'required|min:3|max:255',
@@ -60,9 +63,25 @@ public function storeThread(Request $request, string $slug)
 
         $threadSlug = $this->forumService->createThread($forum, $validated);
 
-        return redirect()->route('forums.thread', [
+        return redirect()->route('forum.thread', [
             'forumSlug'  => $forum->slug,
             'threadSlug' => $threadSlug,
         ])->with('success', 'Thread created successfully!');
     }
-}
\ No newline at end of file
+
+    public function storeReply(Request $request, string $forumSlug, string $threadSlug)
+    {
+        $data = $this->forumService->getThreadWithPosts($forumSlug, $threadSlug);
+
+        $validated = $request->validate([
+            'content' => 'required|min:2',
+        ]);
+
+        $this->forumService->createPost($data['thread'], $validated);
+
+        return redirect()->route('forum.thread', [
+            'forumSlug'  => $forumSlug,
+            'threadSlug' => $threadSlug,
+        ])->with('success', 'Reply posted!');
+    }
+}
diff --git a/app/Modules/Forum/Http/routes.php b/app/Modules/Forum/Http/routes.php
index 125a740..5672599 100644
--- a/app/Modules/Forum/Http/routes.php
+++ b/app/Modules/Forum/Http/routes.php
@@ -1,10 +1,16 @@
 <?php
 
 use Illuminate\Support\Facades\Route;
+use Modules\Forum\Http\Controllers\ForumController;
 
 Route::middleware('web')
-    ->prefix(strtolower('Forum'))
+    ->prefix('forum')
+    ->name('forum.')
     ->group(function () {
-        Route::get('/', [\Modules\Forum\Http\Controllers\ForumController::class, 'index']);
-        Route::get('/{slug}', [\Modules\Forum\Http\Controllers\ForumController::class, 'forum'])->name('forum.show');
+        Route::get('/', [ForumController::class, 'index'])->name('index');
+        Route::get('/{slug}', [ForumController::class, 'forum'])->name('show');
+        Route::get('/{slug}/create', [ForumController::class, 'createThread'])->name('create-thread')->middleware('auth');
+        Route::post('/{slug}/create', [ForumController::class, 'storeThread'])->name('store-thread')->middleware('auth');
+        Route::get('/{forumSlug}/{threadSlug}', [ForumController::class, 'thread'])->name('thread');
+        Route::post('/{forumSlug}/{threadSlug}/reply', [ForumController::class, 'storeReply'])->name('store-reply')->middleware('auth');
     });
\ No newline at end of file
diff --git a/app/Modules/Forum/Resources/views/create-thread.blade.php b/app/Modules/Forum/Resources/views/create-thread.blade.php
new file mode 100644
index 0000000..ab8cb2c
--- /dev/null
+++ b/app/Modules/Forum/Resources/views/create-thread.blade.php
@@ -0,0 +1,95 @@
+@extends('layouts.main')
+
+@section('title', 'New Thread — ' . $forum->name)
+
+@section('content')
+<div class="pt-16 min-h-screen bg-slate-950">
+    <div class="bg-slate-900 border-b border-slate-800/70">
+        <div class="max-w-3xl mx-auto px-4 sm:px-6 py-6">
+            <nav class="flex items-center gap-1.5 text-sm text-slate-500 mb-3">
+                <a href="{{ route('home') }}" class="hover:text-slate-300"><i class="fas fa-home"></i></a>
+                <i class="fas fa-chevron-right text-[10px]"></i>
+                <a href="{{ route('forum.index') }}" class="hover:text-slate-300">Forums</a>
+                <i class="fas fa-chevron-right text-[10px]"></i>
+                <a href="{{ route('forum.show', $forum->slug) }}" class="hover:text-slate-300">{{ $forum->name }}</a>
+                <i class="fas fa-chevron-right text-[10px]"></i>
+                <span class="text-slate-300">New Thread</span>
+            </nav>
+            <h1 class="text-xl font-bold text-white">Start a new thread</h1>
+            <p class="text-slate-400 text-sm mt-0.5">Posting in <span class="text-slate-300 font-medium">{{ $forum->name }}</span></p>
+        </div>
+    </div>
+
+    <div class="max-w-3xl mx-auto px-4 sm:px-6 py-8">
+        @if($errors->any())
+        <div class="mb-5 flex items-start gap-3 bg-red-900/30 border border-red-700/50 text-red-300 text-sm px-4 py-3 rounded-lg">
+            <i class="fas fa-exclamation-circle text-red-400 mt-0.5 flex-shrink-0"></i>
+            <ul class="space-y-0.5">
+                @foreach($errors->all() as $error)
+                    <li>{{ $error }}</li>
+                @endforeach
+            </ul>
+        </div>
+        @endif
+        <form action="{{ route('forum.store-thread', $forum->slug) }}" method="POST"
+              class="rounded-xl border border-slate-800 bg-slate-900 overflow-hidden shadow-xl">
+            @csrf
+            <div class="px-6 py-5 space-y-5">
+                <div>
+                    <label for="title" class="block text-sm font-medium text-slate-300 mb-1.5">
+                        Thread Title <span class="text-red-400">*</span>
+                    </label>
+                    <input
+                        type="text"
+                        id="title"
+                        name="title"
+                        value="{{ old('title') }}"
+                        placeholder="Enter a clear, descriptive title…"
+                        maxlength="255"
+                        class="w-full bg-slate-800/60 border {{ $errors->has('title') ? 'border-red-500' : 'border-slate-700' }} rounded-lg px-4 py-2.5 text-slate-100 text-sm placeholder-slate-600 focus:outline-none focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500/50"
+                        required>
+                    @error('title')
+                        <p class="text-red-400 text-xs mt-1.5">{{ $message }}</p>
+                    @enderror
+                </div>
+                <div>
+                    <label for="content" class="block text-sm font-medium text-slate-300 mb-1.5">
+                        Content <span class="text-red-400">*</span>
+                    </label>
+                    <textarea
+                        id="content"
+                        name="content"
+                        rows="12"
+                        placeholder="Write the body of your thread here…"
+                        class="w-full bg-slate-800/60 border {{ $errors->has('content') ? 'border-red-500' : 'border-slate-700' }} rounded-lg px-4 py-3 text-slate-100 text-sm placeholder-slate-600 focus:outline-none focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500/50 resize-y"
+                        required minlength="10">{{ old('content') }}</textarea>
+                    @error('content')
+                        <p class="text-red-400 text-xs mt-1.5">{{ $message }}</p>
+                    @enderror
+                </div>
+            </div>
+            <div class="flex items-center justify-between gap-3 px-6 py-4 bg-slate-900/80 border-t border-slate-800">
+                <a href="{{ route('forum.show', $forum->slug) }}"
+                   class="inline-flex items-center gap-2 px-4 py-2 text-slate-400 hover:text-slate-200 text-sm">
+                    <i class="fas fa-arrow-left text-xs"></i> Cancel
+                </a>
+                <button type="submit"
+                        class="inline-flex items-center gap-2 px-6 py-2 bg-indigo-600 hover:bg-indigo-500 text-white text-sm font-medium rounded-lg shadow-lg shadow-indigo-900/30">
+                    <i class="fas fa-paper-plane text-xs"></i> Post Thread
+                </button>
+            </div>
+        </form>
+        <div class="mt-5 rounded-xl border border-slate-800 bg-slate-900/40 px-5 py-4">
+            <h3 class="text-slate-400 text-xs font-semibold uppercase tracking-wider mb-3">
+                <i class="fas fa-shield-alt mr-1.5 text-slate-600"></i> Posting Guidelines
+            </h3>
+            <ul class="space-y-1.5 text-slate-500 text-xs">
+                <li class="flex items-start gap-2"><i class="fas fa-check text-emerald-500/70 mt-0.5 flex-shrink-0"></i> Be respectful and constructive.</li>
+                <li class="flex items-start gap-2"><i class="fas fa-check text-emerald-500/70 mt-0.5 flex-shrink-0"></i> Search before posting to avoid duplicates.</li>
+                <li class="flex items-start gap-2"><i class="fas fa-check text-emerald-500/70 mt-0.5 flex-shrink-0"></i> Use a clear, descriptive title.</li>
+                <li class="flex items-start gap-2"><i class="fas fa-times text-red-500/70 mt-0.5 flex-shrink-0"></i> Do not share personal information or violate privacy.</li>
+            </ul>
+        </div>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Forum/Resources/views/index.blade.php b/app/Modules/Forum/Resources/views/index.blade.php
index a7b05c0..003d515 100644
--- a/app/Modules/Forum/Resources/views/index.blade.php
+++ b/app/Modules/Forum/Resources/views/index.blade.php
@@ -1,245 +1,113 @@
-@extends('layouts.main')
+@extends('layouts.main')
 
-@section('title', 'Forums')
+@section('title', 'Community Forums')
+
+@php
+    $categoryColors = ['indigo','sky','emerald','amber','rose','violet','teal','orange'];
+@endphp
 
 @section('content')
-<div class="min-h-screen bg-gradient-to-br from-gray-900 via-gray-800 to-gray-900">
-    <div class="container mx-auto px-4 sm:px-6 lg:px-8 py-12">
-        {{-- Header Section --}}
-        <div class="mb-12">
-            <div class="flex items-center space-x-2 text-sm text-gray-400 mb-6">
-                <a href="{{ route('home') }}" class="hover:text-blue-400 transition-colors duration-200 flex items-center">
-                    <i class="fas fa-home mr-1"></i>
-                    <span>Home</span>
-                </a>
-                <svg class="w-4 h-4 text-gray-600" fill="currentColor" viewBox="0 0 20 20">
-                    <path fill-rule="evenodd" d="M7.293 14.707a1 1 0 010-1.414L10.586 10 7.293 6.707a1 1 0 011.414-1.414l4 4a1 1 0 010 1.414l-4 4a1 1 0 01-1.414 0z" clip-rule="evenodd"/>
-                </svg>
-                <span class="text-gray-300">Forums</span>
+<div class="pt-16 min-h-screen bg-slate-950">
+    <div class="bg-slate-900 border-b border-slate-800/70">
+        <div class="max-w-5xl mx-auto px-4 sm:px-6 py-8 flex flex-col sm:flex-row sm:items-center sm:justify-between gap-4">
+            <div>
+                {{-- Breadcrumb --}}
+                <nav class="flex items-center gap-1.5 text-sm text-slate-500 mb-3">
+                    <a href="{{ route('home') }}" class="hover:text-slate-300"><i class="fas fa-home"></i></a>
+                    <i class="fas fa-chevron-right text-[10px]"></i>
+                    <span class="text-slate-300">Forums</span>
+                </nav>
+                <h1 class="text-2xl font-bold text-white tracking-tight">Community Forums</h1>
+                <p class="text-slate-400 text-sm mt-1">Discussions, announcements &amp; support</p>
             </div>
-
-            <div class="relative overflow-hidden rounded-2xl bg-gradient-to-r from-blue-900/40 via-gray-800/60 to-gray-900/40 backdrop-blur-sm border border-blue-500/20 shadow-2xl">
-                <div class="absolute inset-0 bg-gradient-to-r from-blue-600/5 to-purple-600/5 animate-pulse"></div>
-                <div class="relative px-8 py-10">
-                    <div class="flex flex-col lg:flex-row lg:items-center lg:justify-between">
-                        <div class="flex items-start space-x-6">
-                            <div class="relative">
-                                <div class="absolute -inset-1 bg-gradient-to-r from-blue-500 to-purple-500 rounded-full blur opacity-30"></div>
-                                <div class="relative bg-gray-800 p-4 rounded-full border-2 border-blue-400/30">
-                                    <i class="fas fa-comments text-3xl text-blue-400"></i>
-                                </div>
-                            </div>
-                            <div class="flex-1">
-                                <h1 class="text-5xl font-bold text-white mb-3 bg-gradient-to-r from-blue-400 to-purple-400 bg-clip-text text-transparent">
-                                    Community Forums
-                                </h1>
-                                <p class="text-gray-300 text-lg leading-relaxed max-w-2xl">
-                                    Connect, share, and learn with thousands of passionate members in our vibrant community.
-                                </p>
-                            </div>
-                        </div>
-                        <div class="mt-8 lg:mt-0">
-                            <div class="bg-gray-800/50 backdrop-blur-sm rounded-xl p-6 border border-gray-700/50 shadow-lg">
-                                <div class="flex items-center space-x-4">
-                                    <div class="relative">
-                                        <div class="absolute inset-0 bg-green-500 rounded-full animate-ping opacity-75"></div>
-                                        <div class="relative bg-green-500 w-3 h-3 rounded-full"></div>
-                                    </div>
-                                    <div class="text-gray-300">
-                                        <span class="text-green-400 font-bold text-xl">{{ App\Models\User::where('updated_at', '>=', now()->subMinutes(15))->count() }}</span>
-                                        <span class="text-sm ml-1">members online</span>
-                                    </div>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
+            <div class="flex items-center gap-4">
+                <div class="hidden sm:flex items-center gap-2 text-sm text-slate-400">
+                    <span class="inline-block w-2 h-2 rounded-full bg-emerald-500"></span>
+                    <span>
+                        <strong class="text-emerald-400">{{ App\Models\User::where('updated_at', '>=', now()->subMinutes(15))->count() }}</strong>
+                        online
+                    </span>
                 </div>
             </div>
         </div>
+    </div>
 
-        {{-- Forum Categories --}}
-        <div class="space-y-8">
-            @foreach($categories as $category)
-            <div class="group">
-                <div class="relative overflow-hidden rounded-t-2xl bg-gradient-to-r from-blue-900/60 to-purple-900/40 backdrop-blur-sm border border-blue-500/30 shadow-lg">
-                    <div class="absolute inset-0 bg-gradient-to-r from-blue-600/10 to-purple-600/10 group-hover:from-blue-600/20 group-hover:to-purple-600/20 transition-all duration-500"></div>
-                    <div class="relative px-8 py-6">
-                        <div class="flex items-center space-x-4">
-                            <div class="relative">
-                                <div class="absolute -inset-1 bg-gradient-to-r from-blue-400 to-purple-400 rounded-lg blur opacity-25 group-hover:opacity-40 transition-opacity duration-300"></div>
-                                <div class="relative bg-gray-800 p-3 rounded-lg border border-blue-400/30">
-                                    <i class="fas fa-folder-open text-2xl text-blue-400"></i>
-                                </div>
-                            </div>
-                            <h2 class="text-2xl font-bold text-white group-hover:text-blue-300 transition-colors duration-300">
-                                {{ $category->name }}
-                            </h2>
-                            <div class="ml-auto">
-                                <span class="bg-blue-500/20 text-blue-300 px-4 py-2 rounded-full text-sm font-medium border border-blue-500/30">
-                                    {{ $category->subforums->count() }} {{ Str::plural('forum', $category->subforums->count()) }}
-                                </span>
-                            </div>
-                        </div>
-                    </div>
-                </div>
-
-                <div class="bg-gray-800/40 backdrop-blur-sm rounded-b-2xl border border-t-0 border-gray-700/50 shadow-xl">
-                    <div class="divide-y divide-gray-700/30">
-                        @foreach($category->subforums as $forum)
-                        <div class="group/forum hover:bg-gray-800/60 transition-all duration-300 first:rounded-t-none last:rounded-b-xl">
-                            <div class="p-8">
-                                <div class="flex flex-col xl:flex-row xl:items-center xl:justify-between space-y-6 xl:space-y-0">
-                                    <div class="flex items-start space-x-6 flex-1">
-                                        <div class="relative flex-shrink-0">
-                                            <div class="absolute -inset-1 bg-gradient-to-r from-blue-500 to-purple-500 rounded-xl blur opacity-20 group-hover/forum:opacity-40 transition-opacity duration-300"></div>
-                                            <div class="relative bg-gray-700 p-4 rounded-xl border border-gray-600/50 group-hover/forum:border-blue-500/50 transition-colors duration-300">
-                                                <i class="fas fa-comments text-3xl text-blue-400 group-hover/forum:text-blue-300 transition-colors duration-300"></i>
-                                            </div>
-                                        </div>
-                                        <div class="flex-1">
-                                            <div class="flex items-center space-x-3 mb-3">
-                                                <a href="{{ route('forum.show', $forum->slug) }}" 
-                                                   class="text-2xl font-bold text-white hover:text-blue-400 transition-all duration-300 hover:translate-x-1 transform">
-                                                    {{ $forum->name }}
-                                                </a>
-                                                <span class="bg-gray-700 text-gray-300 px-3 py-1 rounded-full text-xs font-medium">
-                                                    {{ $forum->threads()->count() }} {{ Str::plural('thread', $forum->threads()->count()) }}
-                                                </span>
-                                            </div>
-                                            <p class="text-gray-400 leading-relaxed text-sm">
-                                                {{ $forum->description }}
-                                            </p>
-                                        </div>
-                                    </div>
+    <div class="max-w-5xl mx-auto px-4 sm:px-6 py-6 space-y-5">
+        @forelse($categories as $i => $category)
+            @php $color = $categoryColors[$i % count($categoryColors)]; @endphp
+            <div class="rounded-xl overflow-hidden border border-slate-800 shadow-xl">
 
-                                    <div class="xl:ml-8 xl:text-right">
-                                        @if($forum->latest_thread)
-                                        <div class="bg-gray-900/50 backdrop-blur-sm rounded-xl p-6 border border-gray-700/50 shadow-lg hover:shadow-xl transition-all duration-300">
-                                            <div class="flex items-start space-x-4 xl:flex-col xl:items-end xl:space-x-0 xl:space-y-2">
-                                                <div class="flex-1 xl:w-full">
-                                                    <div class="text-xs text-gray-500 mb-2">Latest Thread</div>
-                                                    <a href="{{ route('forums.thread', ['forumSlug' => $forum->slug, 'threadSlug' => $forum->latestThread->slug]) }}" 
-                                                       class="text-blue-400 hover:text-blue-300 font-semibold transition-colors duration-200 block">
-                                                        {{ Str::limit($forum->latestThread->title, 40) }}
-                                                    </a>
-                                                </div>
-                                                <div class="text-sm text-gray-400">
-                                                    <div class="flex items-center space-x-2 xl:justify-end">
-                                                        <img src="https://ui-avatars.com/api/?name={{ urlencode($forum->latestThread->user->name) }}&background=3B82F6&color=fff&size=32" 
-                                                             alt="{{ $forum->latestThread->user->name }}" 
-                                                             class="w-6 h-6 rounded-full">
-                                                        <span>by <span class="font-medium text-gray-300">{{ $forum->latestThread->user->name }}</span></span>
-                                                    </div>
-                                                    <div class="text-xs mt-1 xl:text-right">
-                                                        {{ $forum->latestThread->created_at->diffForHumans() }}
-                                                    </div>
-                                                </div>
-                                            </div>
-                                        </div>
-                                        @else
-                                        <div class="bg-gray-900/30 rounded-xl p-6 border border-dashed border-gray-700 text-center">
-                                            <i class="fas fa-comment-slash text-3xl text-gray-600 mb-3"></i>
-                                            <p class="text-gray-500 text-sm">No threads yet</p>
-                                            <p class="text-xs text-gray-600 mt-1">Be the first to start a discussion!</p>
-                                        </div>
-                                        @endif
-                                    </div>
-                                </div>
-                            </div>
-                        </div>
-                        @endforeach
-                    </div>
+                <div class="bg-slate-900 px-5 py-3.5 flex items-center gap-3 border-b border-slate-800">
+                    <span class="w-1 h-5 rounded-full bg-{{ $color }}-500 flex-shrink-0"></span>
+                    <h2 class="text-slate-100 font-semibold text-sm uppercase tracking-widest">{{ $category->name }}</h2>
+                    <span class="ml-auto text-xs text-slate-500">{{ $category->subforums->count() }} {{ Str::plural('section', $category->subforums->count()) }}</span>
                 </div>
-            </div>
-            @endforeach
-        </div>
 
-        {{-- Statistics Section --}}
-        <div class="mt-16">
-            <div class="relative overflow-hidden rounded-2xl bg-gradient-to-br from-gray-800/60 via-gray-900/40 to-blue-900/30 backdrop-blur-sm border border-gray-700/50 shadow-2xl">
-                <div class="absolute inset-0">
-                    <div class="absolute inset-0 bg-gradient-to-r from-blue-600/5 to-purple-600/5"></div>
-                    <div class="absolute top-0 right-0 w-96 h-96 bg-blue-500/10 rounded-full filter blur-3xl"></div>
-                    <div class="absolute bottom-0 left-0 w-96 h-96 bg-purple-500/10 rounded-full filter blur-3xl"></div>
-                </div>
-                
-                <div class="relative px-8 py-12">
-                    <div class="text-center mb-12">
-                        <div class="inline-flex items-center space-x-4 mb-4">
-                            <div class="relative">
-                                <div class="absolute -inset-1 bg-gradient-to-r from-blue-400 to-purple-400 rounded-lg blur opacity-30"></div>
-                                <div class="relative bg-gray-800 p-4 rounded-lg border border-blue-400/30">
-                                    <i class="fas fa-chart-line text-3xl text-blue-400"></i>
-                                </div>
-                            </div>
-                            <div>
-                                <h2 class="text-3xl font-bold text-white">Community Statistics</h2>
-                                <p class="text-gray-400 mt-2">Our growing family by the numbers</p>
-                            </div>
-                        </div>
+                @forelse($category->subforums as $forum)
+                <div class="flex items-center gap-4 px-5 py-4 bg-slate-900/60 hover:bg-slate-800/60 border-b border-slate-800/50 last:border-b-0">
+                    <div class="flex-shrink-0 w-10 h-10 rounded-lg bg-{{ $color }}-600/15 border border-{{ $color }}-500/20 flex items-center justify-center">
+                        <i class="fas fa-comments text-{{ $color }}-400 text-sm"></i>
                     </div>
-
-                    <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
-                        <div class="group/stat">
-                            <div class="relative overflow-hidden rounded-xl bg-gray-800/50 backdrop-blur-sm border border-gray-700/50 p-8 text-center hover:border-blue-500/50 transition-all duration-300 hover:shadow-xl hover:shadow-blue-500/10">
-                                <div class="absolute -top-8 -right-8 w-24 h-24 bg-blue-500/10 rounded-full filter blur-2xl group-hover/stat:bg-blue-500/20 transition-colors duration-300"></div>
-                                <div class="relative">
-                                    <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-blue-400 to-blue-600 bg-clip-text mb-2">
-                                        {{ number_format(App\Models\User::count()) }}
-                                    </div>
-                                    <div class="flex items-center justify-center space-x-2 text-gray-300">
-                                        <i class="fas fa-users text-blue-400"></i>
-                                        <span class="font-medium">Registered Members</span>
-                                    </div>
-                                    <div class="mt-4 text-xs text-gray-500">
-                                        <i class="fas fa-arrow-up text-green-400 mr-1"></i>
-                                        Growing every day
-                                    </div>
-                                </div>
-                            </div>
-                        </div>
-
-                        <div class="group/stat">
-                            <div class="relative overflow-hidden rounded-xl bg-gray-800/50 backdrop-blur-sm border border-gray-700/50 p-8 text-center hover:border-green-500/50 transition-all duration-300 hover:shadow-xl hover:shadow-green-500/10">
-                                <div class="absolute -top-8 -right-8 w-24 h-24 bg-green-500/10 rounded-full filter blur-2xl group-hover/stat:bg-green-500/20 transition-colors duration-300"></div>
-                                <div class="relative">
-                                    <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-green-400 to-green-600 bg-clip-text mb-2">
-                                        {{ number_format(\Modules\Forum\Domain\Models\Thread::count()) }}
-                                    </div>
-                                    <div class="flex items-center justify-center space-x-2 text-gray-300">
-                                        <i class="fas fa-comments text-green-400"></i>
-                                        <span class="font-medium">Active Threads</span>
-                                    </div>
-                                    <div class="mt-4 text-xs text-gray-500">
-                                        <i class="fas fa-fire text-orange-400 mr-1"></i>
-                                        Full of discussions
-                                    </div>
-                                </div>
-                            </div>
-                        </div>
-
-                        <div class="group/stat">
-                            <div class="relative overflow-hidden rounded-xl bg-gray-800/50 backdrop-blur-sm border border-gray-700/50 p-8 text-center hover:border-purple-500/50 transition-all duration-300 hover:shadow-xl hover:shadow-purple-500/10">
-                                <div class="absolute -top-8 -right-8 w-24 h-24 bg-purple-500/10 rounded-full filter blur-2xl group-hover/stat:bg-purple-500/20 transition-colors duration-300"></div>
-                                <div class="relative">
-                                    <div class="text-5xl font-bold text-transparent bg-gradient-to-r from-purple-400 to-purple-600 bg-clip-text mb-2">
-                                        {{ number_format(\Modules\Forum\Domain\Models\Post::count()) }}
-                                    </div>
-                                    <div class="flex items-center justify-center space-x-2 text-gray-300">
-                                        <i class="fas fa-comment-dots text-purple-400"></i>
-                                        <span class="font-medium">Total Posts</span>
-                                    </div>
-                                    <div class="mt-4 text-xs text-gray-500">
-                                        <i class="fas fa-heart text-red-400 mr-1"></i>
-                                        Community contributions
-                                    </div>
-                                </div>
+                    <div class="flex-1 min-w-0">
+                        <a href="{{ route('forum.show', $forum->slug) }}"
+                           class="text-slate-100 font-semibold text-sm hover:text-{{ $color }}-400">
+                            {{ $forum->name }}
+                        </a>
+                        @if($forum->description)
+                            <p class="text-slate-500 text-xs mt-0.5 truncate">{{ $forum->description }}</p>
+                        @endif
+                    </div>
+                    <div class="hidden md:flex flex-shrink-0 items-center gap-5 text-xs text-slate-500">
+                        <span class="flex items-center gap-1.5">
+                            <i class="fas fa-comment-alt text-slate-600"></i>
+                            <strong class="text-slate-300">{{ number_format($forum->threads_count) }}</strong>
+                            {{ Str::plural('thread', $forum->threads_count) }}
+                        </span>
+                    </div>
+                    <div class="hidden lg:block flex-shrink-0 w-52 text-right">
+                        @if($forum->latestThread)
+                            <a href="{{ route('forum.thread', ['forumSlug' => $forum->slug, 'threadSlug' => $forum->latestThread->slug]) }}"
+                               class="text-slate-300 text-xs font-medium hover:text-{{ $color }}-400 line-clamp-1 block">
+                                {{ Str::limit($forum->latestThread->title, 38) }}
+                            </a>
+                            <div class="flex items-center justify-end gap-1.5 mt-1">
+                                <img src="https://ui-avatars.com/api/?name={{ urlencode($forum->latestThread->user->name ?? '?') }}&background=334155&color=94a3b8&size=24&bold=true"
+                                     alt="{{ $forum->latestThread->user->name ?? '' }}"
+                                     class="w-4 h-4 rounded-full">
+                                <span class="text-slate-500 text-xs">{{ $forum->latestThread->updated_at->diffForHumans(null, true) }}</span>
                             </div>
-                        </div>
+                        @else
+                            <span class="text-slate-600 text-xs italic">No threads yet</span>
+                        @endif
                     </div>
                 </div>
+                @empty
+                <div class="px-5 py-6 text-center text-slate-600 text-sm bg-slate-900/40">No forums in this category yet.</div>
+                @endforelse
             </div>
+        @empty
+        <div class="rounded-xl border border-slate-800 bg-slate-900/50 px-8 py-16 text-center">
+            <i class="fas fa-comments text-4xl text-slate-700 mb-4"></i>
+            <p class="text-slate-400 font-medium">No forums available yet.</p>
+        </div>
+        @endforelse
+
+        <div class="flex flex-wrap gap-5 items-center justify-center py-3 border-t border-slate-800/50 text-sm text-slate-500">
+            <span class="flex items-center gap-2">
+                <i class="fas fa-users text-indigo-500/70"></i>
+                <strong class="text-slate-300">{{ number_format(App\Models\User::count()) }}</strong> members
+            </span>
+            <span class="text-slate-700">·</span>
+            <span class="flex items-center gap-2">
+                <i class="fas fa-comment-dots text-sky-500/70"></i>
+                <strong class="text-slate-300">{{ number_format(\Modules\Forum\Domain\Models\Thread::count()) }}</strong> threads
+            </span>
+            <span class="text-slate-700">·</span>
+            <span class="flex items-center gap-2">
+                <i class="fas fa-comment text-emerald-500/70"></i>
+                <strong class="text-slate-300">{{ number_format(\Modules\Forum\Domain\Models\Post::count()) }}</strong> posts
+            </span>
         </div>
     </div>
 </div>
-@endsection
\ No newline at end of file
+@endsection
diff --git a/app/Modules/Forum/Resources/views/show.blade.php b/app/Modules/Forum/Resources/views/show.blade.php
index e69de29..de18b4b 100644
--- a/app/Modules/Forum/Resources/views/show.blade.php
+++ b/app/Modules/Forum/Resources/views/show.blade.php
@@ -0,0 +1,154 @@
+@extends('layouts.main')
+
+@section('title', $forum->name)
+
+@section('content')
+<div class="pt-16 min-h-screen bg-slate-950">
+    <div class="bg-slate-900 border-b border-slate-800/70">
+        <div class="max-w-5xl mx-auto px-4 sm:px-6 py-6">
+            <nav class="flex items-center gap-1.5 text-sm text-slate-500 mb-3">
+                <a href="{{ route('home') }}" class="hover:text-slate-300"><i class="fas fa-home"></i></a>
+                <i class="fas fa-chevron-right text-[10px]"></i>
+                <a href="{{ route('forum.index') }}" class="hover:text-slate-300">Forums</a>
+                @if($forum->parent)
+                    <i class="fas fa-chevron-right text-[10px]"></i>
+                    <span class="text-slate-500">{{ $forum->parent->name }}</span>
+                @endif
+                <i class="fas fa-chevron-right text-[10px]"></i>
+                <span class="text-slate-300">{{ $forum->name }}</span>
+            </nav>
+            <div class="flex items-start sm:items-center justify-between gap-4 flex-col sm:flex-row">
+                <div>
+                    <h1 class="text-xl font-bold text-white">{{ $forum->name }}</h1>
+                    @if($forum->description)
+                        <p class="text-slate-400 text-sm mt-0.5">{{ $forum->description }}</p>
+                    @endif
+                </div>
+                @auth
+                <a href="{{ route('forum.create-thread', $forum->slug) }}"
+                   class="inline-flex items-center gap-2 px-4 py-2 bg-indigo-600 hover:bg-indigo-500 text-white text-sm font-medium rounded-lg shadow-lg shadow-indigo-900/30 flex-shrink-0">
+                    <i class="fas fa-plus text-xs"></i>
+                    New Thread
+                </a>
+                @endauth
+            </div>
+        </div>
+    </div>
+
+    <div class="max-w-5xl mx-auto px-4 sm:px-6 py-6">
+        @if($forum->subforums->isNotEmpty())
+        <div class="mb-6 rounded-xl border border-slate-800 overflow-hidden">
+            <div class="bg-slate-900 px-5 py-3 border-b border-slate-800 flex items-center gap-2">
+                <i class="fas fa-sitemap text-slate-500 text-xs"></i>
+                <span class="text-slate-400 text-xs font-semibold uppercase tracking-wider">Subforums</span>
+            </div>
+            @foreach($forum->subforums as $sub)
+            <a href="{{ route('forum.show', $sub->slug) }}"
+               class="flex items-center gap-3 px-5 py-3.5 bg-slate-900/60 hover:bg-slate-800/50 border-b border-slate-800/50 last:border-b-0">
+                <i class="fas fa-comments text-indigo-400/60 text-sm flex-shrink-0"></i>
+                <span class="text-slate-200 text-sm font-medium">{{ $sub->name }}</span>
+                @if($sub->description)
+                    <span class="text-slate-500 text-xs truncate">— {{ $sub->description }}</span>
+                @endif
+                <span class="ml-auto text-slate-600 text-xs">{{ $sub->threads_count }} threads</span>
+            </a>
+            @endforeach
+        </div>
+        @endif
+
+        @if($threads->isEmpty())
+        <div class="rounded-xl border border-slate-800 bg-slate-900/50 px-8 py-16 text-center">
+            <i class="fas fa-comment-slash text-4xl text-slate-700 mb-4"></i>
+            <p class="text-slate-400 font-medium">No threads yet.</p>
+            @auth
+            <a href="{{ route('forum.create-thread', $forum->slug) }}"
+               class="inline-flex items-center gap-2 mt-4 px-4 py-2 bg-indigo-600 hover:bg-indigo-500 text-white text-sm font-medium rounded-lg">
+                <i class="fas fa-plus text-xs"></i> Start the first thread
+            </a>
+            @else
+            <p class="text-slate-600 text-sm mt-1"><a href="{{ route('login') }}" class="text-indigo-400 hover:underline">Log in</a> to create a thread.</p>
+            @endauth
+        </div>
+        @else
+
+        <div class="hidden sm:grid grid-cols-[1fr_auto_auto_auto] gap-4 px-4 py-2 text-xs font-semibold uppercase tracking-wider text-slate-600 border-b border-slate-800 mb-1">
+            <span>Thread</span>
+            <span class="text-center w-16">Replies</span>
+            <span class="text-center w-16">Views</span>
+            <span class="text-right w-44">Last post</span>
+        </div>
+
+        <div class="rounded-xl border border-slate-800 overflow-hidden">
+            @foreach($threads as $thread)
+            <div class="flex items-center gap-4 px-4 py-4 bg-slate-900/60 hover:bg-slate-800/50 border-b border-slate-800/50 last:border-b-0">
+                <div class="flex-shrink-0 w-8 h-8 rounded-lg flex items-center justify-center
+                    {{ $thread->is_locked ? 'bg-slate-800 text-slate-500' : 'bg-indigo-600/15 text-indigo-400' }}">
+                    @if($thread->is_sticky)
+                        <i class="fas fa-thumbtack text-amber-400 text-xs"></i>
+                    @elseif($thread->is_locked)
+                        <i class="fas fa-lock text-xs"></i>
+                    @else
+                        <i class="fas fa-comment text-xs"></i>
+                    @endif
+                </div>
+
+                <div class="flex-1 min-w-0">
+                    <div class="flex items-center flex-wrap gap-2">
+                        @if($thread->is_sticky)
+                            <span class="inline-flex items-center gap-1 px-1.5 py-0.5 bg-amber-500/15 text-amber-400 text-[10px] font-semibold rounded uppercase tracking-wide">
+                                <i class="fas fa-thumbtack text-[9px]"></i> Pinned
+                            </span>
+                        @endif
+                        @if($thread->is_locked)
+                            <span class="inline-flex items-center gap-1 px-1.5 py-0.5 bg-slate-700/60 text-slate-400 text-[10px] font-semibold rounded uppercase tracking-wide">
+                                <i class="fas fa-lock text-[9px]"></i> Locked
+                            </span>
+                        @endif
+                        <a href="{{ route('forum.thread', ['forumSlug' => $forum->slug, 'threadSlug' => $thread->slug]) }}"
+                           class="text-slate-100 font-semibold text-sm hover:text-indigo-400 truncate">
+                            {{ $thread->title }}
+                        </a>
+                    </div>
+                    <div class="flex items-center gap-2 mt-1">
+                        <img src="https://ui-avatars.com/api/?name={{ urlencode($thread->user->name ?? '?') }}&background=334155&color=94a3b8&size=24&bold=true"
+                             class="w-4 h-4 rounded-full" alt="{{ $thread->user->name ?? '' }}">
+                        <span class="text-slate-500 text-xs">
+                            by <span class="text-slate-400">{{ $thread->user->name ?? 'Unknown' }}</span>
+                            · {{ $thread->created_at->diffForHumans() }}
+                        </span>
+                    </div>
+                </div>
+
+                <div class="hidden sm:flex flex-shrink-0 w-16 flex-col items-center gap-0.5">
+                    <span class="text-slate-200 font-semibold text-sm">{{ max(0, ($thread->posts_count ?? 1) - 1) }}</span>
+                    <span class="text-slate-600 text-[10px]">replies</span>
+                </div>
+                <div class="hidden sm:flex flex-shrink-0 w-16 flex-col items-center gap-0.5">
+                    <span class="text-slate-200 font-semibold text-sm">{{ number_format($thread->view_count) }}</span>
+                    <span class="text-slate-600 text-[10px]">views</span>
+                </div>
+                <div class="hidden sm:block flex-shrink-0 w-44 text-right">
+                    @if($thread->latestPost && $thread->latestPost->user)
+                        <div class="flex items-center justify-end gap-2">
+                            <div class="min-w-0">
+                                <span class="text-slate-400 text-xs truncate block">{{ $thread->latestPost->user->name }}</span>
+                                <span class="text-slate-600 text-xs">{{ $thread->latestPost->created_at->diffForHumans() }}</span>
+                            </div>
+                            <img src="https://ui-avatars.com/api/?name={{ urlencode($thread->latestPost->user->name) }}&background=334155&color=94a3b8&size=24&bold=true"
+                                 class="w-6 h-6 rounded-full flex-shrink-0" alt="{{ $thread->latestPost->user->name }}">
+                        </div>
+                    @endif
+                </div>
+            </div>
+            @endforeach
+        </div>
+
+        @if($threads->hasPages())
+        <div class="mt-4 flex justify-center">
+            {{ $threads->links() }}
+        </div>
+        @endif
+        @endif
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Forum/Resources/views/thread.blade.php b/app/Modules/Forum/Resources/views/thread.blade.php
new file mode 100644
index 0000000..9ea210e
--- /dev/null
+++ b/app/Modules/Forum/Resources/views/thread.blade.php
@@ -0,0 +1,176 @@
+@extends('layouts.main')
+
+@section('title', $thread->title)
+
+@section('content')
+<div class="pt-16 min-h-screen bg-slate-950">
+    <div class="bg-slate-900 border-b border-slate-800/70">
+        <div class="max-w-4xl mx-auto px-4 sm:px-6 py-5">
+            <nav class="flex items-center flex-wrap gap-1.5 text-sm text-slate-500 mb-3">
+                <a href="{{ route('home') }}" class="hover:text-slate-300"><i class="fas fa-home"></i></a>
+                <i class="fas fa-chevron-right text-[10px]"></i>
+                <a href="{{ route('forum.index') }}" class="hover:text-slate-300">Forums</a>
+                @if($forum->parent)
+                    <i class="fas fa-chevron-right text-[10px]"></i>
+                    <span class="text-slate-500">{{ $forum->parent->name }}</span>
+                @endif
+                <i class="fas fa-chevron-right text-[10px]"></i>
+                <a href="{{ route('forum.show', $forum->slug) }}" class="hover:text-slate-300">{{ $forum->name }}</a>
+                <i class="fas fa-chevron-right text-[10px]"></i>
+                <span class="text-slate-300 truncate max-w-xs">{{ $thread->title }}</span>
+            </nav>
+
+            <div class="flex items-start gap-3">
+                <div class="flex-1 min-w-0">
+                    <div class="flex items-center flex-wrap gap-2 mb-1">
+                        @if($thread->is_sticky)
+                            <span class="inline-flex items-center gap-1 px-2 py-0.5 bg-amber-500/15 text-amber-400 text-xs font-semibold rounded">
+                                <i class="fas fa-thumbtack text-[10px]"></i> Pinned
+                            </span>
+                        @endif
+                        @if($thread->is_locked)
+                            <span class="inline-flex items-center gap-1 px-2 py-0.5 bg-slate-700 text-slate-400 text-xs font-semibold rounded">
+                                <i class="fas fa-lock text-[10px]"></i> Locked
+                            </span>
+                        @endif
+                    </div>
+                    <h1 class="text-lg font-bold text-white leading-tight">{{ $thread->title }}</h1>
+                    <p class="text-slate-500 text-xs mt-1">
+                        {{ $posts->total() }} {{ Str::plural('post', $posts->total()) }}
+                        · {{ number_format($thread->view_count) }} views
+                    </p>
+                </div>
+                @if($posts->currentPage() === $posts->lastPage() && !$thread->is_locked)
+                    @auth
+                    <a href="#reply-form"
+                       class="inline-flex items-center gap-2 px-4 py-2 bg-indigo-600 hover:bg-indigo-500 text-white text-sm font-medium rounded-lg flex-shrink-0">
+                        <i class="fas fa-reply text-xs"></i> Reply
+                    </a>
+                    @endauth
+                @endif
+            </div>
+        </div>
+    </div>
+
+    @if(session('success'))
+    <div class="max-w-4xl mx-auto px-4 sm:px-6 mt-4">
+        <div class="flex items-center gap-3 bg-emerald-900/30 border border-emerald-700/50 text-emerald-300 text-sm px-4 py-3 rounded-lg">
+            <i class="fas fa-check-circle text-emerald-400"></i>
+            {{ session('success') }}
+        </div>
+    </div>
+    @endif
+
+    <div class="max-w-4xl mx-auto px-4 sm:px-6 py-6 space-y-3">
+
+        @foreach($posts as $post)
+        @php $isOP = $post->is_first_post; @endphp
+        <div id="post-{{ $post->id }}"
+             class="flex gap-0 rounded-xl border {{ $isOP ? 'border-indigo-800/40' : 'border-slate-800' }} overflow-hidden">
+            <div class="flex-shrink-0 w-36 sm:w-44 bg-slate-900 border-r {{ $isOP ? 'border-indigo-800/30' : 'border-slate-800' }} px-4 py-5 flex flex-col items-center gap-3 text-center">
+                <img src="https://ui-avatars.com/api/?name={{ urlencode($post->user->name ?? '?') }}&background={{ $isOP ? '4f46e5' : '1e293b' }}&color={{ $isOP ? 'ffffff' : '94a3b8' }}&size=80&bold=true"
+                     alt="{{ $post->user->name ?? '' }}"
+                     class="w-12 h-12 sm:w-14 sm:h-14 rounded-full ring-2 {{ $isOP ? 'ring-indigo-500/50' : 'ring-slate-700' }}">
+                <div>
+                    <p class="text-slate-100 font-semibold text-xs sm:text-sm leading-tight">{{ $post->user->name ?? 'Deleted user' }}</p>
+                    @if($post->user && $post->user->roles->isNotEmpty())
+                        <span class="inline-block mt-1 px-2 py-0.5 bg-indigo-600/20 text-indigo-400 text-[10px] rounded font-medium">
+                            {{ $post->user->roles->first()->name }}
+                        </span>
+                    @elseif($isOP)
+                        <span class="inline-block mt-1 px-2 py-0.5 bg-slate-700 text-slate-400 text-[10px] rounded font-medium">
+                            Author
+                        </span>
+                    @endif
+                </div>
+                @if($post->user)
+                <div class="text-[10px] text-slate-600 space-y-0.5">
+                    <p>Joined {{ $post->user->created_at->format('M Y') }}</p>
+                </div>
+                @endif
+                <div class="mt-auto pt-2 text-[10px] text-slate-600 border-t border-slate-800 w-full text-center">
+                    #{{ ($posts->currentPage() - 1) * $posts->perPage() + $loop->iteration }}
+                </div>
+            </div>
+
+            <div class="flex-1 min-w-0 flex flex-col {{ $isOP ? 'bg-slate-900/70' : 'bg-slate-900/40' }}">
+                <div class="flex items-center justify-between gap-3 px-5 py-3 border-b {{ $isOP ? 'border-indigo-800/30' : 'border-slate-800/70' }}">
+                    <span class="text-slate-500 text-xs">
+                        <i class="far fa-clock mr-1"></i>
+                        {{ $post->created_at->format('M j, Y \a\t g:i A') }}
+                        @if($post->updated_at->ne($post->created_at))
+                            <span class="text-slate-600 ml-2">(edited {{ $post->updated_at->diffForHumans() }})</span>
+                        @endif
+                    </span>
+                    @auth
+                    @if(!$thread->is_locked)
+                    <button
+                        onclick="document.getElementById('reply-form').scrollIntoView({behavior:'smooth'}); document.getElementById('reply-content').value += '{{ '@' }}{{ addslashes($post->user->name ?? '') }}: ';"
+                        class="text-slate-600 hover:text-slate-300 text-xs flex items-center gap-1">
+                        <i class="fas fa-reply text-[10px]"></i> Quote
+                    </button>
+                    @endif
+                    @endauth
+                </div>
+                <div class="px-5 py-4 prose prose-sm prose-invert max-w-none flex-1
+                            prose-p:text-slate-300 prose-a:text-indigo-400 prose-strong:text-slate-100
+                            prose-code:bg-slate-800 prose-code:text-indigo-300 prose-code:rounded prose-code:px-1
+                            prose-pre:bg-slate-800 prose-pre:border prose-pre:border-slate-700">
+                    {!! nl2br(e($post->content)) !!}
+                </div>
+            </div>
+        </div>
+        @endforeach
+
+        @if($posts->hasPages())
+        <div class="flex justify-center pt-2">
+            {{ $posts->links() }}
+        </div>
+        @endif
+
+        @if($thread->is_locked)
+        <div class="rounded-xl border border-slate-800 bg-slate-900/50 px-6 py-8 text-center mt-4">
+            <i class="fas fa-lock text-2xl text-slate-600 mb-3"></i>
+            <p class="text-slate-400 text-sm font-medium">This thread is locked. No new replies can be posted.</p>
+        </div>
+        @else
+            @auth
+            <div id="reply-form" class="rounded-xl border border-slate-800 bg-slate-900 overflow-hidden mt-4">
+                <div class="px-5 py-3.5 border-b border-slate-800 flex items-center gap-2">
+                    <img src="https://ui-avatars.com/api/?name={{ urlencode(Auth::user()->name) }}&background=4f46e5&color=ffffff&size=32&bold=true"
+                         class="w-7 h-7 rounded-full" alt="{{ Auth::user()->name }}">
+                    <span class="text-slate-300 text-sm font-medium">{{ Auth::user()->name }}</span>
+                    <span class="text-slate-600 text-xs ml-1">— Post a reply</span>
+                </div>
+                <form action="{{ route('forum.store-reply', ['forumSlug' => $forum->slug, 'threadSlug' => $thread->slug]) }}" method="POST" class="p-5">
+                    @csrf
+                    <textarea
+                        id="reply-content"
+                        name="content"
+                        rows="5"
+                        placeholder="Write your reply here…"
+                        class="w-full bg-slate-800/60 border border-slate-700 rounded-lg px-4 py-3 text-slate-100 text-sm placeholder-slate-600 focus:outline-none focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500/50 resize-y"
+                        required minlength="2">{{ old('content') }}</textarea>
+                    @error('content')
+                        <p class="text-red-400 text-xs mt-1.5">{{ $message }}</p>
+                    @enderror
+                    <div class="flex justify-end mt-3">
+                        <button type="submit"
+                                class="inline-flex items-center gap-2 px-5 py-2 bg-indigo-600 hover:bg-indigo-500 text-white text-sm font-medium rounded-lg">
+                            <i class="fas fa-paper-plane text-xs"></i> Post Reply
+                        </button>
+                    </div>
+                </form>
+            </div>
+            @else
+            <div class="rounded-xl border border-slate-800 bg-slate-900/50 px-6 py-8 text-center mt-4">
+                <p class="text-slate-400 text-sm">
+                    <a href="{{ route('login') }}" class="text-indigo-400 hover:underline font-medium">Log in</a>
+                    or <a href="{{ route('register') }}" class="text-indigo-400 hover:underline font-medium">register</a> to reply.
+                </p>
+            </div>
+            @endauth
+        @endif
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Forum/Services/ForumService.php b/app/Modules/Forum/Services/ForumService.php
index 56a2234..653ff36 100644
--- a/app/Modules/Forum/Services/ForumService.php
+++ b/app/Modules/Forum/Services/ForumService.php
@@ -30,7 +30,11 @@ public function getCategories()
         return Forum::where('is_category', true)
             ->orderBy('order')
             ->with(['subforums' => function ($query) {
-                $query->orderBy('order');
+                $query->orderBy('order')
+                      ->withCount('threads')
+                      ->with(['latestThread' => function ($q) {
+                          $q->with('user')->select('id', 'title', 'slug', 'forum_id', 'user_id', 'updated_at');
+                      }]);
             }])
             ->get();
     }
@@ -44,16 +48,17 @@ public function getCategories()
     public function getForumWithThreads(string $slug)
     {
         $forum = Forum::where('slug', $slug)
-            ->with(['subforums' => function ($query) {
-                $query->orderBy('order');
+            ->with(['parent', 'subforums' => function ($query) {
+                $query->orderBy('order')->withCount('threads');
             }])
             ->firstOrFail();
 
         $threads = Thread::where('forum_id', $forum->id)
             ->orderBy('is_sticky', 'desc')
-            ->orderBy('created_at', 'desc')
+            ->orderBy('updated_at', 'desc')
+            ->withCount('posts')
             ->with(['user', 'latestPost.user'])
-            ->paginate(20);
+            ->paginate(25);
 
         return compact('forum', 'threads');
     }
diff --git a/database/seeders/DatabaseSeeder.php b/database/seeders/DatabaseSeeder.php
index a5e99e1..100e3e1 100755
--- a/database/seeders/DatabaseSeeder.php
+++ b/database/seeders/DatabaseSeeder.php
@@ -11,6 +11,7 @@ public function run(): void
         $this->call([
             DonationPlansSeeder::class,
             RolesAndPermissionsSeeder::class,
+            ForumsSeeder::class,
         ]);
     }
 }
\ No newline at end of file

From e152acd6810a386842cf7fa704efab5986eaa8fb Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 21 Apr 2026 21:44:54 +0200
Subject: [PATCH 098/132] feat: Add Realm Management and Character Armory views

- Created a new view for Realm Management with a list of registered realms, including actions for editing and deleting realms.
- Developed the Character Armory view with an advanced search form to filter characters by name, realm, faction, class, and level.
- Implemented partial views for displaying achievements, equipment slots, equipment, and professions.
- Enhanced character profile display with tabs for equipment, achievements, and professions, including dynamic content loading.
---
 app/Enums/Emulator.php                        |  15 ++
 .../Frontend/Users/UserController.php         |   6 +-
 app/Models/Realm.php                          |   4 +-
 .../Controllers/AdminSettingsController.php   |   7 -
 .../Controllers/RealmManagementController.php | 186 ++++++++++++++++
 app/Modules/Admin/Http/routes.php             |   8 +
 .../Resources/views/layouts/app.blade.php     |   7 +-
 .../Resources/views/realms/create.blade.php   | 187 +++++++++++++++++
 .../Resources/views/realms/edit.blade.php     | 198 ++++++++++++++++++
 .../Resources/views/realms/index.blade.php    |  95 +++++++++
 .../Http/Controllers/ArmoryController.php     |   4 +-
 app/Modules/Armory/Http/routes.php            |   8 +-
 .../views/{armory => }/index.blade.php        |   2 +-
 .../partials/achievements.blade.php           |   0
 .../partials/equipment-slot.blade.php         |   0
 .../{armory => }/partials/equipment.blade.php |   4 +-
 .../partials/professions.blade.php            |   0
 .../views/{armory => }/show.blade.php         |   6 +-
 app/Modules/Armory/Services/ArmoryService.php |   2 +-
 .../Armory/Services/WowheadParserService.php  |   2 +-
 app/Modules/Armory/module.json                |   4 +-
 21 files changed, 716 insertions(+), 29 deletions(-)
 create mode 100644 app/Modules/Admin/Http/Controllers/RealmManagementController.php
 create mode 100644 app/Modules/Admin/Resources/views/realms/create.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/realms/edit.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/realms/index.blade.php
 rename app/Modules/Armory/Resources/views/{armory => }/index.blade.php (98%)
 rename app/Modules/Armory/Resources/views/{armory => }/partials/achievements.blade.php (100%)
 rename app/Modules/Armory/Resources/views/{armory => }/partials/equipment-slot.blade.php (100%)
 rename app/Modules/Armory/Resources/views/{armory => }/partials/equipment.blade.php (94%)
 rename app/Modules/Armory/Resources/views/{armory => }/partials/professions.blade.php (100%)
 rename app/Modules/Armory/Resources/views/{armory => }/show.blade.php (95%)

diff --git a/app/Enums/Emulator.php b/app/Enums/Emulator.php
index 9506947..1228f5a 100644
--- a/app/Enums/Emulator.php
+++ b/app/Enums/Emulator.php
@@ -6,4 +6,19 @@ enum Emulator: string
 {
     case TRINITYCORE = 'TC';
     case AZEROTHCORE = 'AC';
+
+    public const LABELS = [
+        self::TRINITYCORE->value => 'TrinityCore',
+        self::AZEROTHCORE->value => 'AzerothCore',
+    ];
+
+    public const DESCRIPTIONS = [
+        self::TRINITYCORE->value => 'TrinityCore es un emulador de servidor de World of Warcraft que se centra en la estabilidad y el rendimiento, ofreciendo una experiencia de juego fluida y sin interrupciones.',
+        self::AZEROTHCORE->value => 'AzerothCore es un fork de TrinityCore que se enfoca en la innovación y la adición de nuevas características, proporcionando una experiencia de juego más dinámica y personalizada.',
+    ];
+
+    public const URN = [
+        self::TRINITYCORE->value => 'TC',
+        self::AZEROTHCORE->value => 'AC',
+    ];
 }
diff --git a/app/Http/Controllers/Frontend/Users/UserController.php b/app/Http/Controllers/Frontend/Users/UserController.php
index c4f78c2..c7b7cb8 100755
--- a/app/Http/Controllers/Frontend/Users/UserController.php
+++ b/app/Http/Controllers/Frontend/Users/UserController.php
@@ -196,9 +196,11 @@ private function getUserGameAccounts($user)
                 $characters = [];
 
                 try {
-                    if (!empty($realm->characters_database)) {
+                    $charactersDatabaseConfig = $realm->character_database ?? $realm->characters_database;
+
+                    if (!empty($charactersDatabaseConfig)) {
                         $charactersDb = $this->connectToExternalDatabase(
-                            json_decode($realm->characters_database, true),
+                            json_decode($charactersDatabaseConfig, true),
                             'characters'
                         );
                         
diff --git a/app/Models/Realm.php b/app/Models/Realm.php
index a0b22ed..c6d3da4 100755
--- a/app/Models/Realm.php
+++ b/app/Models/Realm.php
@@ -17,8 +17,10 @@ class Realm extends Model
         'expansion',
         'emulator',
         'port',
+        'bnet',
         'auth_database',
-        'characters_database',
+        'character_database',
+        'world_database',
         'console_hostname',
         'console_port',
         'console_username',
diff --git a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
index 2aa6a2a..d8e171e 100644
--- a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
@@ -14,7 +14,6 @@ class AdminSettingsController extends Controller
     protected $view = [
         'general' => 'admin::settings.general',
         'email' => 'admin::settings.email',
-        'realms' => 'admin::settings.realms',
         'payment' => 'admin::settings.payment',
         'security' => 'admin::settings.security',
         'appearance' => 'admin::settings.appearance',
@@ -51,12 +50,6 @@ public function store(Request $request)
             abort(404);
         }
 
-        // Prevent storage for specific views that handle their own data or are read-only here
-        if (in_array($view, ['realms'])) {
-            return redirect()->route('admin.settings.index', ['view' => $view])
-                ->with('warning', 'Settings for this section cannot be saved via this form.');
-        }
-
         $data = $request->except(['_token', 'view']);
 
         foreach ($data as $key => $value) {
diff --git a/app/Modules/Admin/Http/Controllers/RealmManagementController.php b/app/Modules/Admin/Http/Controllers/RealmManagementController.php
new file mode 100644
index 0000000..2c38bc4
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/RealmManagementController.php
@@ -0,0 +1,186 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Enums\Emulator;
+use App\Enums\WoWConstants;
+use App\Http\Controllers\Controller;
+use App\Models\Realm;
+use Illuminate\Http\Request;
+use Illuminate\Validation\Rule;
+
+class RealmManagementController extends Controller
+{
+    /**
+     * Display realms listing.
+     */
+    public function index()
+    {
+        $realms = Realm::query()->latest()->paginate(12);
+
+        return view('admin::realms.index', compact('realms'));
+    }
+
+    /**
+     * Show the create form for a realm.
+     */
+    public function create()
+    {
+        return view('admin::realms.create');
+    }
+
+    /**
+     * Store a newly created realm.
+     */
+    public function store(Request $request)
+    {
+        $validated = $request->validate($this->validationRules());
+
+        Realm::create($this->realmPayload($validated));
+
+        return redirect()
+            ->route('admin.realms.index')
+            ->with('success', 'Realm creado correctamente.');
+    }
+
+    /**
+     * Show edit form for a realm.
+     */
+    public function edit(Realm $realm)
+    {
+        return view('admin::realms.edit', [
+            'realm' => $realm,
+            'authConfig' => $this->decodeDatabaseConfig($realm->auth_database),
+            'charactersConfig' => $this->decodeDatabaseConfig($realm->character_database),
+            'worldConfig' => $this->decodeDatabaseConfig($realm->world_database),
+        ]);
+    }
+
+    /**
+     * Update an existing realm.
+     */
+    public function update(Request $request, Realm $realm)
+    {
+        $validated = $request->validate($this->validationRules($realm->id));
+
+        $realm->update($this->realmPayload($validated));
+
+        return redirect()
+            ->route('admin.realms.index')
+            ->with('success', 'Realm actualizado correctamente.');
+    }
+
+    /**
+     * Delete an existing realm.
+     */
+    public function destroy(Realm $realm)
+    {
+        $realm->delete();
+
+        return redirect()
+            ->route('admin.realms.index')
+            ->with('success', 'Realm eliminado correctamente.');
+    }
+
+    /**
+     * Shared validation rules for create and update.
+     */
+    private function validationRules(?int $realmId = null): array
+    {
+        return [
+            'name' => ['required', 'string', 'max:120', Rule::unique('realms', 'name')->ignore($realmId)],
+            'hostname' => ['required', 'string', 'max:255'],
+            'port' => ['required', 'integer', 'between:1,65535'],
+            'expansion' => ['required', 'integer', Rule::in(array_keys(WoWConstants::EXPANSION_NAMES))],
+            'emulator' => ['required', 'string', Rule::in(array_keys(Emulator::LABELS))],
+            'bnet' => ['nullable', 'boolean'],
+
+            'console_hostname' => ['required', 'string', 'max:255'],
+            'console_port' => ['nullable', 'integer', 'between:1,65535'],
+            'console_username' => ['required', 'string', 'max:255'],
+            'console_password' => ['required', 'string', 'max:255'],
+            'console_urn' => ['required', 'string', Rule::in(array_values(Emulator::URN))],
+
+            'auth.host' => ['required', 'string', 'max:255'],
+            'auth.port' => ['nullable', 'integer', 'between:1,65535'],
+            'auth.database' => ['required', 'string', 'max:255'],
+            'auth.username' => ['required', 'string', 'max:255'],
+            'auth.password' => ['required', 'string', 'max:255'],
+            'auth.charset' => ['nullable', 'string', 'max:64'],
+            'auth.collation' => ['nullable', 'string', 'max:64'],
+
+            'characters.host' => ['required', 'string', 'max:255'],
+            'characters.port' => ['nullable', 'integer', 'between:1,65535'],
+            'characters.database' => ['required', 'string', 'max:255'],
+            'characters.username' => ['required', 'string', 'max:255'],
+            'characters.password' => ['required', 'string', 'max:255'],
+            'characters.charset' => ['nullable', 'string', 'max:64'],
+            'characters.collation' => ['nullable', 'string', 'max:64'],
+
+            'world.host' => ['required', 'string', 'max:255'],
+            'world.port' => ['nullable', 'integer', 'between:1,65535'],
+            'world.database' => ['required', 'string', 'max:255'],
+            'world.username' => ['required', 'string', 'max:255'],
+            'world.password' => ['required', 'string', 'max:255'],
+            'world.charset' => ['nullable', 'string', 'max:64'],
+            'world.collation' => ['nullable', 'string', 'max:64'],
+        ];
+    }
+
+    /**
+     * Build payload for Realm model.
+     */
+    private function realmPayload(array $validated): array
+    {
+        return [
+            'name' => $validated['name'],
+            'hostname' => $validated['hostname'],
+            'port' => $validated['port'],
+            'expansion' => $validated['expansion'],
+            'emulator' => $validated['emulator'],
+            'bnet' => (bool) ($validated['bnet'] ?? false),
+            'auth_database' => json_encode($this->buildDatabaseConfig($validated['auth'])),
+            'character_database' => json_encode($this->buildDatabaseConfig($validated['characters'])),
+            'world_database' => json_encode($this->buildDatabaseConfig($validated['world'])),
+            'console_hostname' => $validated['console_hostname'],
+            'console_port' => $validated['console_port'] ?? null,
+            'console_username' => $validated['console_username'],
+            'console_password' => $validated['console_password'],
+            'console_urn' => $validated['console_urn'],
+        ];
+    }
+
+    /**
+     * Build a normalized database config payload.
+     */
+    private function buildDatabaseConfig(array $config): array
+    {
+        return [
+            'driver' => 'mysql',
+            'host' => $config['host'],
+            'port' => $config['port'] ?? 3306,
+            'database' => $config['database'],
+            'username' => $config['username'],
+            'password' => $config['password'],
+            'charset' => $config['charset'] ?? 'utf8mb4',
+            'collation' => $config['collation'] ?? 'utf8mb4_unicode_ci',
+            'prefix' => '',
+            'strict' => true,
+            'engine' => null,
+        ];
+    }
+
+    /**
+     * Decode stored JSON config into array for forms.
+     */
+    private function decodeDatabaseConfig(?string $config): array
+    {
+        $decoded = json_decode((string) $config, true);
+
+        if (!is_array($decoded)) {
+            return [];
+        }
+
+        return $decoded;
+    }
+}
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index 8e5082e..70ba090 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -41,6 +41,14 @@
         Route::get('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'index'])->middleware('permission:manage.settings')->name('admin.settings.index');
         Route::post('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'store'])->middleware('permission:manage.settings')->name('admin.settings.store');
 
+        // Realm Management
+        Route::get('/realms', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'index'])->middleware('permission:manage.realms')->name('admin.realms.index');
+        Route::get('/realms/create', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'create'])->middleware('permission:manage.realms')->name('admin.realms.create');
+        Route::post('/realms', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'store'])->middleware('permission:manage.realms')->name('admin.realms.store');
+        Route::get('/realms/{realm}/edit', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'edit'])->middleware('permission:manage.realms')->name('admin.realms.edit');
+        Route::put('/realms/{realm}', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'update'])->middleware('permission:manage.realms')->name('admin.realms.update');
+        Route::delete('/realms/{realm}', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'destroy'])->middleware('permission:manage.realms')->name('admin.realms.destroy');
+
         // Menus
         Route::get('/menus', [\Modules\Admin\Http\Controllers\MenuManagerController::class, 'index'])->middleware('permission:manage.settings')->name('admin.menus.index');
         Route::put('/menus', [\Modules\Admin\Http\Controllers\MenuManagerController::class, 'update'])->middleware('permission:manage.settings')->name('admin.menus.update');
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index 1b24cd1..5473cc8 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -193,10 +193,11 @@ class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium
             <div>
                 <p class="px-3 mb-1.5 text-[10px] font-semibold uppercase tracking-widest text-gray-500 select-none">Realms</p>
                 @can('manage.realms')
-                <a href="#"
+                @php $active = request()->routeIs('admin.realms.*'); @endphp
+                <a href="{{ route('admin.realms.index') }}"
                    class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
-                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
-                    <i class="fas fa-server w-4 text-center"></i>
+                          {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                    <i class="fas fa-server w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
                     Realm Management
                 </a>
                 <a href="#"
diff --git a/app/Modules/Admin/Resources/views/realms/create.blade.php b/app/Modules/Admin/Resources/views/realms/create.blade.php
new file mode 100644
index 0000000..576ddf7
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/realms/create.blade.php
@@ -0,0 +1,187 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Nuevo Realm')
+
+@section('content')
+<div class="min-h-screen bg-gray-50">
+    <div class="bg-white border-b border-gray-200">
+        <div class="max-w-7xl mx-auto px-6 py-5 flex items-center justify-between">
+            <div>
+                <h1 class="text-2xl font-semibold text-gray-900">Nuevo Realm</h1>
+                <p class="text-sm text-gray-500 mt-0.5">Alta de conexiones Auth, Characters y World</p>
+            </div>
+            <a href="{{ route('admin.realms.index') }}" class="inline-flex items-center gap-2 px-4 py-2 bg-gray-100 text-gray-700 rounded-lg hover:bg-gray-200 text-sm font-medium">
+                <i class="fas fa-arrow-left"></i>
+                Volver al listado
+            </a>
+        </div>
+    </div>
+
+    <div class="max-w-7xl mx-auto px-6 py-8 space-y-6">
+        @if($errors->any())
+            <div class="p-4 bg-red-50 border-l-4 border-red-500 rounded-lg text-red-800 text-sm">
+                <p class="font-semibold mb-2">No se pudo crear el realm:</p>
+                <ul class="list-disc list-inside space-y-1">
+                    @foreach($errors->all() as $error)
+                        <li>{{ $error }}</li>
+                    @endforeach
+                </ul>
+            </div>
+        @endif
+
+        <div class="bg-white border border-gray-200 rounded-xl overflow-hidden">
+            <div class="px-6 py-4 border-b border-gray-200">
+                <h2 class="text-base font-semibold text-gray-900">Formulario de alta</h2>
+            </div>
+
+            <form action="{{ route('admin.realms.store') }}" method="POST" class="p-6 space-y-6">
+                @csrf
+
+                <div class="grid grid-cols-1 md:grid-cols-3 gap-4">
+                    <div>
+                        <label class="block text-sm font-medium text-gray-700 mb-1">Nombre</label>
+                        <input type="text" name="name" value="{{ old('name') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                    </div>
+                    <div>
+                        <label class="block text-sm font-medium text-gray-700 mb-1">Hostname Realm</label>
+                        <input type="text" name="hostname" value="{{ old('hostname') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                    </div>
+                    <div>
+                        <label class="block text-sm font-medium text-gray-700 mb-1">Puerto Realm</label>
+                        <input type="number" name="port" value="{{ old('port', 8085) }}" min="1" max="65535" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                    </div>
+                    <div>
+                        <label class="block text-sm font-medium text-gray-700 mb-1">Expansion</label>
+                        <select name="expansion" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none bg-white">
+                            @foreach(\App\Enums\WoWConstants::EXPANSION_NAMES as $expansionId => $expansionName)
+                                <option value="{{ $expansionId }}" {{ (int) old('expansion', \App\Enums\WoWConstants::EXPANSION_CATA) === (int) $expansionId ? 'selected' : '' }}>
+                                    {{ $expansionName }}
+                                </option>
+                            @endforeach
+                        </select>
+                    </div>
+                    <div>
+                        <label class="block text-sm font-medium text-gray-700 mb-1">Emulador</label>
+                        <select id="emulator_select" name="emulator" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none bg-white">
+                            @foreach(\App\Enums\Emulator::LABELS as $emulatorValue => $emulatorLabel)
+                                <option value="{{ $emulatorValue }}" {{ old('emulator', \App\Enums\Emulator::TRINITYCORE->value) === $emulatorValue ? 'selected' : '' }}>
+                                    {{ $emulatorLabel }}
+                                </option>
+                            @endforeach
+                        </select>
+                    </div>
+                    <div class="flex items-center gap-2 pt-7">
+                        <input type="checkbox" id="bnet" name="bnet" value="1" {{ old('bnet') ? 'checked' : '' }} class="rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                        <label for="bnet" class="text-sm font-medium text-gray-700">Battle.net habilitado</label>
+                    </div>
+                </div>
+
+                <div class="border-t border-gray-200 pt-6">
+                    <h3 class="text-sm font-semibold text-gray-800 mb-4">Consola del Realm</h3>
+                    <div class="grid grid-cols-1 md:grid-cols-5 gap-4">
+                        <div>
+                            <label class="block text-sm font-medium text-gray-700 mb-1">Host</label>
+                            <input type="text" name="console_hostname" value="{{ old('console_hostname') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                        </div>
+                        <div>
+                            <label class="block text-sm font-medium text-gray-700 mb-1">Puerto</label>
+                            <input type="number" name="console_port" value="{{ old('console_port', 3443) }}" min="1" max="65535" class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                        </div>
+                        <div>
+                            <label class="block text-sm font-medium text-gray-700 mb-1">Usuario</label>
+                            <input type="text" name="console_username" value="{{ old('console_username') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                        </div>
+                        <div>
+                            <label class="block text-sm font-medium text-gray-700 mb-1">Password</label>
+                            <input type="password" name="console_password" value="{{ old('console_password') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                        </div>
+                        <div>
+                            <label class="block text-sm font-medium text-gray-700 mb-1">URN</label>
+                            <select id="console_urn_select" name="console_urn" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none bg-white">
+                                @foreach(\App\Enums\Emulator::URN as $emulatorValue => $urnValue)
+                                    <option value="{{ $urnValue }}" {{ old('console_urn', \App\Enums\Emulator::TRINITYCORE->value) === $urnValue ? 'selected' : '' }}>
+                                        {{ \App\Enums\Emulator::LABELS[$emulatorValue] ?? $emulatorValue }} ({{ $urnValue }})
+                                    </option>
+                                @endforeach
+                            </select>
+                        </div>
+                    </div>
+                </div>
+
+                @php
+                    $sections = [
+                        'auth' => 'Auth Database',
+                        'characters' => 'Characters Database',
+                        'world' => 'World Database',
+                    ];
+                @endphp
+
+                @foreach($sections as $key => $label)
+                    <div class="border-t border-gray-200 pt-6">
+                        <h3 class="text-sm font-semibold text-gray-800 mb-4">{{ $label }}</h3>
+                        <div class="grid grid-cols-1 md:grid-cols-4 gap-4">
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Host</label>
+                                <input type="text" name="{{ $key }}[host]" value="{{ old($key . '.host') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Puerto</label>
+                                <input type="number" name="{{ $key }}[port]" value="{{ old($key . '.port', 3306) }}" min="1" max="65535" class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Database</label>
+                                <input type="text" name="{{ $key }}[database]" value="{{ old($key . '.database') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Username</label>
+                                <input type="text" name="{{ $key }}[username]" value="{{ old($key . '.username') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Password</label>
+                                <input type="password" name="{{ $key }}[password]" value="{{ old($key . '.password') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Charset</label>
+                                <input type="text" name="{{ $key }}[charset]" value="{{ old($key . '.charset', 'utf8mb4') }}" class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Collation</label>
+                                <input type="text" name="{{ $key }}[collation]" value="{{ old($key . '.collation', 'utf8mb4_unicode_ci') }}" class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                        </div>
+                    </div>
+                @endforeach
+
+                <div class="pt-2 flex justify-end">
+                    <button type="submit" class="inline-flex items-center gap-2 px-4 py-2.5 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                        <i class="fas fa-plus"></i>
+                        Crear Realm
+                    </button>
+                </div>
+            </form>
+        </div>
+    </div>
+</div>
+@endsection
+
+@push('scripts')
+<script>
+    document.addEventListener('DOMContentLoaded', function () {
+        const emulatorSelect = document.getElementById('emulator_select');
+        const urnSelect = document.getElementById('console_urn_select');
+
+        if (!emulatorSelect || !urnSelect) {
+            return;
+        }
+
+        emulatorSelect.addEventListener('change', function () {
+            const emulatorValue = emulatorSelect.value;
+            const hasMatchingUrn = Array.from(urnSelect.options).some(option => option.value === emulatorValue);
+
+            if (hasMatchingUrn) {
+                urnSelect.value = emulatorValue;
+            }
+        });
+    });
+</script>
+@endpush
diff --git a/app/Modules/Admin/Resources/views/realms/edit.blade.php b/app/Modules/Admin/Resources/views/realms/edit.blade.php
new file mode 100644
index 0000000..4c10373
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/realms/edit.blade.php
@@ -0,0 +1,198 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Editar Realm')
+
+@section('content')
+@php
+    $selectedEmulator = old('emulator', $realm->emulator);
+    $selectedUrn = old('console_urn', $realm->console_urn);
+@endphp
+<div class="min-h-screen bg-gray-50">
+    <div class="bg-white border-b border-gray-200">
+        <div class="max-w-7xl mx-auto px-6 py-5 flex items-center justify-between">
+            <div>
+                <h1 class="text-2xl font-semibold text-gray-900">Editar Realm</h1>
+                <p class="text-sm text-gray-500 mt-0.5">Actualizar configuracion general, consola y conexiones de base de datos</p>
+            </div>
+            <a href="{{ route('admin.realms.index') }}" class="inline-flex items-center gap-2 px-4 py-2 bg-gray-100 text-gray-700 rounded-lg hover:bg-gray-200 text-sm font-medium">
+                <i class="fas fa-arrow-left"></i>
+                Volver
+            </a>
+        </div>
+    </div>
+
+    <div class="max-w-7xl mx-auto px-6 py-8">
+        @if($errors->any())
+            <div class="mb-6 p-4 bg-red-50 border-l-4 border-red-500 rounded-lg text-red-800 text-sm">
+                <p class="font-semibold mb-2">No se pudo actualizar el realm:</p>
+                <ul class="list-disc list-inside space-y-1">
+                    @foreach($errors->all() as $error)
+                        <li>{{ $error }}</li>
+                    @endforeach
+                </ul>
+            </div>
+        @endif
+
+        <div class="bg-white border border-gray-200 rounded-xl overflow-hidden">
+            <div class="px-6 py-4 border-b border-gray-200">
+                <h2 class="text-base font-semibold text-gray-900">{{ $realm->name }}</h2>
+            </div>
+
+            <form action="{{ route('admin.realms.update', $realm->id) }}" method="POST" class="p-6 space-y-6">
+                @csrf
+                @method('PUT')
+
+                <div class="grid grid-cols-1 md:grid-cols-3 gap-4">
+                    <div>
+                        <label class="block text-sm font-medium text-gray-700 mb-1">Nombre</label>
+                        <input type="text" name="name" value="{{ old('name', $realm->name) }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                    </div>
+                    <div>
+                        <label class="block text-sm font-medium text-gray-700 mb-1">Hostname Realm</label>
+                        <input type="text" name="hostname" value="{{ old('hostname', $realm->hostname) }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                    </div>
+                    <div>
+                        <label class="block text-sm font-medium text-gray-700 mb-1">Puerto Realm</label>
+                        <input type="number" name="port" value="{{ old('port', $realm->port) }}" min="1" max="65535" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                    </div>
+                    <div>
+                        <label class="block text-sm font-medium text-gray-700 mb-1">Expansion</label>
+                        <select name="expansion" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none bg-white">
+                            @foreach(\App\Enums\WoWConstants::EXPANSION_NAMES as $expansionId => $expansionName)
+                                <option value="{{ $expansionId }}" {{ (int) old('expansion', $realm->expansion) === (int) $expansionId ? 'selected' : '' }}>
+                                    {{ $expansionName }}
+                                </option>
+                            @endforeach
+                        </select>
+                    </div>
+                    <div>
+                        <label class="block text-sm font-medium text-gray-700 mb-1">Emulador</label>
+                        <select id="emulator_select" name="emulator" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none bg-white">
+                            @foreach(\App\Enums\Emulator::LABELS as $emulatorValue => $emulatorLabel)
+                                <option value="{{ $emulatorValue }}" {{ $selectedEmulator === $emulatorValue ? 'selected' : '' }}>
+                                    {{ $emulatorLabel }}
+                                </option>
+                            @endforeach
+                            @if(!array_key_exists($selectedEmulator, \App\Enums\Emulator::LABELS))
+                                <option value="{{ $selectedEmulator }}" selected>Valor actual ({{ $selectedEmulator }})</option>
+                            @endif
+                        </select>
+                    </div>
+                    <div class="flex items-center gap-2 pt-7">
+                        <input type="checkbox" id="bnet" name="bnet" value="1" {{ old('bnet', $realm->bnet) ? 'checked' : '' }} class="rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                        <label for="bnet" class="text-sm font-medium text-gray-700">Battle.net habilitado</label>
+                    </div>
+                </div>
+
+                <div class="border-t border-gray-200 pt-6">
+                    <h3 class="text-sm font-semibold text-gray-800 mb-4">Consola del Realm</h3>
+                    <div class="grid grid-cols-1 md:grid-cols-5 gap-4">
+                        <div>
+                            <label class="block text-sm font-medium text-gray-700 mb-1">Host</label>
+                            <input type="text" name="console_hostname" value="{{ old('console_hostname', $realm->console_hostname) }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                        </div>
+                        <div>
+                            <label class="block text-sm font-medium text-gray-700 mb-1">Puerto</label>
+                            <input type="number" name="console_port" value="{{ old('console_port', $realm->console_port) }}" min="1" max="65535" class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                        </div>
+                        <div>
+                            <label class="block text-sm font-medium text-gray-700 mb-1">Usuario</label>
+                            <input type="text" name="console_username" value="{{ old('console_username', $realm->console_username) }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                        </div>
+                        <div>
+                            <label class="block text-sm font-medium text-gray-700 mb-1">Password</label>
+                            <input type="password" name="console_password" value="{{ old('console_password', $realm->console_password) }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                        </div>
+                        <div>
+                            <label class="block text-sm font-medium text-gray-700 mb-1">URN</label>
+                            <select id="console_urn_select" name="console_urn" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none bg-white">
+                                @foreach(\App\Enums\Emulator::URN as $emulatorValue => $urnValue)
+                                    <option value="{{ $urnValue }}" {{ $selectedUrn === $urnValue ? 'selected' : '' }}>
+                                        {{ \App\Enums\Emulator::LABELS[$emulatorValue] ?? $emulatorValue }} ({{ $urnValue }})
+                                    </option>
+                                @endforeach
+                                @if(!in_array($selectedUrn, \App\Enums\Emulator::URN, true))
+                                    <option value="{{ $selectedUrn }}" selected>Valor actual ({{ $selectedUrn }})</option>
+                                @endif
+                            </select>
+                        </div>
+                    </div>
+                </div>
+
+                @php
+                    $sections = [
+                        'auth' => ['label' => 'Auth Database', 'config' => $authConfig],
+                        'characters' => ['label' => 'Characters Database', 'config' => $charactersConfig],
+                        'world' => ['label' => 'World Database', 'config' => $worldConfig],
+                    ];
+                @endphp
+
+                @foreach($sections as $key => $section)
+                    <div class="border-t border-gray-200 pt-6">
+                        <h3 class="text-sm font-semibold text-gray-800 mb-4">{{ $section['label'] }}</h3>
+                        <div class="grid grid-cols-1 md:grid-cols-4 gap-4">
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Host</label>
+                                <input type="text" name="{{ $key }}[host]" value="{{ old($key . '.host', $section['config']['host'] ?? '') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Puerto</label>
+                                <input type="number" name="{{ $key }}[port]" value="{{ old($key . '.port', $section['config']['port'] ?? 3306) }}" min="1" max="65535" class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Database</label>
+                                <input type="text" name="{{ $key }}[database]" value="{{ old($key . '.database', $section['config']['database'] ?? '') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Username</label>
+                                <input type="text" name="{{ $key }}[username]" value="{{ old($key . '.username', $section['config']['username'] ?? '') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Password</label>
+                                <input type="password" name="{{ $key }}[password]" value="{{ old($key . '.password', $section['config']['password'] ?? '') }}" required class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Charset</label>
+                                <input type="text" name="{{ $key }}[charset]" value="{{ old($key . '.charset', $section['config']['charset'] ?? 'utf8mb4') }}" class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                            <div>
+                                <label class="block text-sm font-medium text-gray-700 mb-1">Collation</label>
+                                <input type="text" name="{{ $key }}[collation]" value="{{ old($key . '.collation', $section['config']['collation'] ?? 'utf8mb4_unicode_ci') }}" class="w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:outline-none">
+                            </div>
+                        </div>
+                    </div>
+                @endforeach
+
+                <div class="pt-2 flex justify-end">
+                    <button type="submit" class="inline-flex items-center gap-2 px-4 py-2.5 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                        <i class="fas fa-save"></i>
+                        Guardar cambios
+                    </button>
+                </div>
+            </form>
+        </div>
+    </div>
+</div>
+@endsection
+
+@push('scripts')
+<script>
+    document.addEventListener('DOMContentLoaded', function () {
+        const emulatorSelect = document.getElementById('emulator_select');
+        const urnSelect = document.getElementById('console_urn_select');
+
+        if (!emulatorSelect || !urnSelect) {
+            return;
+        }
+
+        emulatorSelect.addEventListener('change', function () {
+            const emulatorValue = emulatorSelect.value;
+            const hasMatchingUrn = Array.from(urnSelect.options).some(option => option.value === emulatorValue);
+
+            if (hasMatchingUrn) {
+                urnSelect.value = emulatorValue;
+            }
+        });
+    });
+</script>
+@endpush
diff --git a/app/Modules/Admin/Resources/views/realms/index.blade.php b/app/Modules/Admin/Resources/views/realms/index.blade.php
new file mode 100644
index 0000000..629bc3e
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/realms/index.blade.php
@@ -0,0 +1,95 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Realm Management')
+
+@section('content')
+<div class="min-h-screen bg-gray-50">
+    <div class="bg-white border-b border-gray-200">
+        <div class="max-w-7xl mx-auto px-6 py-5 flex items-center justify-between">
+            <div>
+                <h1 class="text-2xl font-semibold text-gray-900">Realm Management</h1>
+                <p class="text-sm text-gray-500 mt-0.5">Listado y administracion de realms registrados</p>
+            </div>
+            <a href="{{ route('admin.realms.create') }}" class="inline-flex items-center gap-2 px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                <i class="fas fa-plus"></i>
+                Nuevo Realm
+            </a>
+        </div>
+    </div>
+
+    <div class="max-w-7xl mx-auto px-6 py-8 space-y-6">
+        @if(session('success'))
+            <div class="p-4 bg-green-50 border-l-4 border-green-500 rounded-lg text-green-800 text-sm">
+                {{ session('success') }}
+            </div>
+        @endif
+
+        <div class="bg-white border border-gray-200 rounded-xl overflow-hidden">
+            <div class="px-6 py-4 border-b border-gray-200 flex items-center justify-between">
+                <h2 class="text-base font-semibold text-gray-900">Realms registrados</h2>
+                <span class="text-xs font-medium text-gray-500">{{ $realms->total() }} total</span>
+            </div>
+
+            <div class="overflow-x-auto">
+                <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-semibold text-gray-700 uppercase tracking-wider">Realm</th>
+                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-700 uppercase tracking-wider">Host:Port</th>
+                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-700 uppercase tracking-wider">Emulator</th>
+                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-700 uppercase tracking-wider">Databases</th>
+                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-700 uppercase tracking-wider">Acciones</th>
+                        </tr>
+                    </thead>
+                    <tbody class="bg-white divide-y divide-gray-200">
+                        @forelse($realms as $realm)
+                            @php
+                                $auth = json_decode($realm->auth_database ?? '{}', true) ?: [];
+                                $characters = json_decode($realm->character_database ?? '{}', true) ?: [];
+                                $world = json_decode($realm->world_database ?? '{}', true) ?: [];
+                            @endphp
+                            <tr class="hover:bg-gray-50">
+                                <td class="px-6 py-4">
+                                    <div class="font-medium text-gray-900">{{ $realm->name }}</div>
+                                    <div class="text-xs text-gray-500">Expansion {{ $realm->expansion }}{{ $realm->bnet ? ' - BNET' : '' }}</div>
+                                </td>
+                                <td class="px-6 py-4 text-sm text-gray-700">{{ $realm->hostname }}:{{ $realm->port }}</td>
+                                <td class="px-6 py-4 text-sm text-gray-700">{{ $realm->emulator }}</td>
+                                <td class="px-6 py-4 text-xs text-gray-600 space-y-1">
+                                    <div><span class="font-semibold text-gray-700">Auth:</span> {{ $auth['database'] ?? '-' }} @ {{ $auth['host'] ?? '-' }}</div>
+                                    <div><span class="font-semibold text-gray-700">Characters:</span> {{ $characters['database'] ?? '-' }} @ {{ $characters['host'] ?? '-' }}</div>
+                                    <div><span class="font-semibold text-gray-700">World:</span> {{ $world['database'] ?? '-' }} @ {{ $world['host'] ?? '-' }}</div>
+                                </td>
+                                <td class="px-6 py-4">
+                                    <div class="flex items-center gap-2">
+                                        <a href="{{ route('admin.realms.edit', $realm->id) }}" class="inline-flex items-center gap-1 px-3 py-1.5 bg-blue-50 text-blue-700 rounded-lg hover:bg-blue-100 text-xs font-medium">
+                                            <i class="fas fa-pen"></i>
+                                            Editar
+                                        </a>
+                                        <form action="{{ route('admin.realms.destroy', $realm->id) }}" method="POST" onsubmit="return confirm('Esta accion eliminara el realm. Continuar?');">
+                                            @csrf
+                                            @method('DELETE')
+                                            <button type="submit" class="inline-flex items-center gap-1 px-3 py-1.5 bg-red-50 text-red-700 rounded-lg hover:bg-red-100 text-xs font-medium">
+                                                <i class="fas fa-trash"></i>
+                                                Eliminar
+                                            </button>
+                                        </form>
+                                    </div>
+                                </td>
+                            </tr>
+                        @empty
+                            <tr>
+                                <td colspan="5" class="px-6 py-10 text-center text-sm text-gray-500">No hay realms registrados.</td>
+                            </tr>
+                        @endforelse
+                    </tbody>
+                </table>
+            </div>
+
+            <div class="px-6 py-4 border-t border-gray-200">
+                {{ $realms->links() }}
+            </div>
+        </div>
+    </div>
+</div>
+@endsection
diff --git a/app/Modules/Armory/Http/Controllers/ArmoryController.php b/app/Modules/Armory/Http/Controllers/ArmoryController.php
index e18f574..47f0f3f 100644
--- a/app/Modules/Armory/Http/Controllers/ArmoryController.php
+++ b/app/Modules/Armory/Http/Controllers/ArmoryController.php
@@ -23,8 +23,8 @@ class ArmoryController extends Controller
      * @var array<string,string>
      */
     protected array $views = [
-        'index' => 'armory::armory.index',
-        'show'  => 'armory::armory.show',
+        'index' => 'armory::index',
+        'show'  => 'armory::show',
     ];
 
     /**
diff --git a/app/Modules/Armory/Http/routes.php b/app/Modules/Armory/Http/routes.php
index e79e50d..1a553b8 100644
--- a/app/Modules/Armory/Http/routes.php
+++ b/app/Modules/Armory/Http/routes.php
@@ -3,8 +3,8 @@
 use Illuminate\Support\Facades\Route;
 use Modules\Armory\Http\Controllers\ArmoryController;
 
-Route::middleware('realms.exists')->prefix('armory')->group(function () {
-    Route::get('/', [ArmoryController::class, 'index'])->name('armory');
-    Route::get('{id}', [ArmoryController::class, 'show'])->where('id', '[0-9]+')->name('armory.show');
-    Route::get('{id}/{realm?}', [ArmoryController::class, 'show'])->where('id', '[0-9]+')->where('realm', '[0-9]+')->name('armory.show.realm');
+Route::middleware(['web', 'realms.exists'])->prefix('armory')->name('armory.')->group(function () {
+    Route::get('/', [ArmoryController::class, 'index'])->name('index');
+    Route::get('{id}', [ArmoryController::class, 'show'])->where('id', '[0-9]+')->name('show');
+    Route::get('{id}/{realm?}', [ArmoryController::class, 'show'])->where('id', '[0-9]+')->where('realm', '[0-9]+')->name('show.realm');
 });
diff --git a/app/Modules/Armory/Resources/views/armory/index.blade.php b/app/Modules/Armory/Resources/views/index.blade.php
similarity index 98%
rename from app/Modules/Armory/Resources/views/armory/index.blade.php
rename to app/Modules/Armory/Resources/views/index.blade.php
index 187de5b..5a4801f 100644
--- a/app/Modules/Armory/Resources/views/armory/index.blade.php
+++ b/app/Modules/Armory/Resources/views/index.blade.php
@@ -12,7 +12,7 @@
         </div>
 
         <!-- Advanced Search -->
-        <form action="{{ route('armory') }}" method="GET" class="search-container max-w-4xl mx-auto p-8 rounded-2xl shadow-2xl border border-gray-700">
+        <form action="{{ route('armory.index') }}" method="GET" class="search-container max-w-4xl mx-auto p-8 rounded-2xl shadow-2xl border border-gray-700">
             <div class="grid grid-cols-1 md:grid-cols-3 gap-4 mb-6">
                 <div class="md:col-span-2">
                     <label class="block text-sm font-medium text-gray-400 mb-2">Character Name</label>
diff --git a/app/Modules/Armory/Resources/views/armory/partials/achievements.blade.php b/app/Modules/Armory/Resources/views/partials/achievements.blade.php
similarity index 100%
rename from app/Modules/Armory/Resources/views/armory/partials/achievements.blade.php
rename to app/Modules/Armory/Resources/views/partials/achievements.blade.php
diff --git a/app/Modules/Armory/Resources/views/armory/partials/equipment-slot.blade.php b/app/Modules/Armory/Resources/views/partials/equipment-slot.blade.php
similarity index 100%
rename from app/Modules/Armory/Resources/views/armory/partials/equipment-slot.blade.php
rename to app/Modules/Armory/Resources/views/partials/equipment-slot.blade.php
diff --git a/app/Modules/Armory/Resources/views/armory/partials/equipment.blade.php b/app/Modules/Armory/Resources/views/partials/equipment.blade.php
similarity index 94%
rename from app/Modules/Armory/Resources/views/armory/partials/equipment.blade.php
rename to app/Modules/Armory/Resources/views/partials/equipment.blade.php
index d092c67..32f78f9 100644
--- a/app/Modules/Armory/Resources/views/armory/partials/equipment.blade.php
+++ b/app/Modules/Armory/Resources/views/partials/equipment.blade.php
@@ -23,7 +23,7 @@
         <div class="space-y-3">
             @foreach (array_slice($slotNames, 0, 6, true) as $slot => $label)
                 @php $equip = $equippedBySlot[$slot] ?? null; @endphp
-                @include('armory.partials.equipment-slot', ['equip' => $equip, 'label' => $label])
+                @include('armory::partials.equipment-slot', ['equip' => $equip, 'label' => $label])
             @endforeach
         </div>
         <div class="character-model rounded-2xl p-8 flex items-center justify-center relative overflow-hidden border border-gray-700">
@@ -36,7 +36,7 @@
         <div class="space-y-3">
             @foreach (array_slice($slotNames, 6, 6, true) as $slot => $label)
                 @php $equip = $equippedBySlot[$slot] ?? null; @endphp
-                @include('armory::armory.partials.equipment-slot', ['equip' => $equip, 'label' => $label])
+                @include('armory::partials.equipment-slot', ['equip' => $equip, 'label' => $label])
             @endforeach
         </div>
     </div>
diff --git a/app/Modules/Armory/Resources/views/armory/partials/professions.blade.php b/app/Modules/Armory/Resources/views/partials/professions.blade.php
similarity index 100%
rename from app/Modules/Armory/Resources/views/armory/partials/professions.blade.php
rename to app/Modules/Armory/Resources/views/partials/professions.blade.php
diff --git a/app/Modules/Armory/Resources/views/armory/show.blade.php b/app/Modules/Armory/Resources/views/show.blade.php
similarity index 95%
rename from app/Modules/Armory/Resources/views/armory/show.blade.php
rename to app/Modules/Armory/Resources/views/show.blade.php
index f80bbd3..78fe120 100644
--- a/app/Modules/Armory/Resources/views/armory/show.blade.php
+++ b/app/Modules/Armory/Resources/views/show.blade.php
@@ -81,9 +81,9 @@
         </div>
     </div>
 
-    @include('armory::armory.partials.equipment', ['item' => $items ?? collect()])
-    @include('armory::armory.partials.achievements', ['achievements' => $achievement ?? collect()])
-    @include('armory::armory.partials.professions', ['skill' => $skill ?? collect()])
+    @include('armory::partials.equipment', ['item' => $items ?? collect()])
+    @include('armory::partials.achievements', ['achievements' => $achievement ?? collect()])
+    @include('armory::partials.professions', ['skill' => $skill ?? collect()])
 </div>
 
 <script>
diff --git a/app/Modules/Armory/Services/ArmoryService.php b/app/Modules/Armory/Services/ArmoryService.php
index 1081d4b..f6e3e02 100644
--- a/app/Modules/Armory/Services/ArmoryService.php
+++ b/app/Modules/Armory/Services/ArmoryService.php
@@ -4,7 +4,7 @@
 
 use Modules\Armory\Domain\Interfaces\ArmoryRepositoryInterface;
 use App\Helpers\RealmHelper;
-use App\Services\Parser\WowheadParserService;
+use Modules\Armory\Services\WowheadParserService;
 use Illuminate\Support\Collection;
 
 class ArmoryService
diff --git a/app/Modules/Armory/Services/WowheadParserService.php b/app/Modules/Armory/Services/WowheadParserService.php
index be7d3ea..3e3b2c0 100644
--- a/app/Modules/Armory/Services/WowheadParserService.php
+++ b/app/Modules/Armory/Services/WowheadParserService.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace App\Services\Parser;
+namespace Modules\Armory\Services;
 
 use Illuminate\Support\Facades\Http;
 
diff --git a/app/Modules/Armory/module.json b/app/Modules/Armory/module.json
index ddebc52..2d464d3 100644
--- a/app/Modules/Armory/module.json
+++ b/app/Modules/Armory/module.json
@@ -1,8 +1,8 @@
 {
-    "name": "Armorytest",
+    "name": "Armory",
     "enabled": true,
     "routes": true,
     "migrations": true,
     "views": true,
-    "namespace": "Modules\\Armorytest"
+    "namespace": "Modules\\Armory"
 }

From 92f41e3c5c97e551ef5aa4c7d8d96aef5099153d Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 21 Apr 2026 22:52:38 +0200
Subject: [PATCH 099/132] fix(cache): improve settings caching logic and handle
 empty fallbacks

---
 app/Helpers/SettingsHelper.php              | 26 ++++++++++++++-------
 app/Modules/Admin/Domain/Models/Setting.php | 12 ++++++++++
 2 files changed, 29 insertions(+), 9 deletions(-)

diff --git a/app/Helpers/SettingsHelper.php b/app/Helpers/SettingsHelper.php
index dc7657e..3d4814e 100644
--- a/app/Helpers/SettingsHelper.php
+++ b/app/Helpers/SettingsHelper.php
@@ -27,18 +27,26 @@ function formatBytes(int $bytes, int $precision = 2): string
      */
     function settings($key = null, $default = null)
     {
-        // Cache settings for performance (forever until updated)
-        $settings = Cache::rememberForever('site_settings', function () {
+        $cachedSettings = Cache::get('site_settings');
+
+        if ($cachedSettings instanceof \Illuminate\Support\Collection) {
+            $settings = $cachedSettings;
+        } elseif (is_array($cachedSettings)) {
+            $settings = collect($cachedSettings);
+        } else {
+            $settings = collect([]);
+
             try {
-                // Check if table exists to avoid errors during migration/installation
-                if (!\Illuminate\Support\Facades\Schema::hasTable('settings')) {
-                    return collect([]);
+                // Avoid caching an empty fallback forever when DB/table is temporarily unavailable.
+                if (\Illuminate\Support\Facades\Schema::hasTable('settings')) {
+                    $settings = Setting::query()->pluck('value', 'key');
+                    Cache::forever('site_settings', $settings);
                 }
-                return Setting::all()->pluck('value', 'key');
-            } catch (\Exception $e) {
-                return collect([]);
+            } catch (\Throwable $e) {
+                // Return in-memory fallback; next request can try rebuilding cache again.
+                $settings = collect([]);
             }
-        });
+        }
 
         if (is_null($key)) {
             return $settings;
diff --git a/app/Modules/Admin/Domain/Models/Setting.php b/app/Modules/Admin/Domain/Models/Setting.php
index 782037d..386886b 100644
--- a/app/Modules/Admin/Domain/Models/Setting.php
+++ b/app/Modules/Admin/Domain/Models/Setting.php
@@ -3,6 +3,7 @@
 namespace Modules\Admin\Domain\Models;
 
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Facades\Cache;
 
 class Setting extends Model
 {
@@ -12,4 +13,15 @@ class Setting extends Model
         'key',
         'value',
     ];
+
+    protected static function booted(): void
+    {
+        static::saved(function (): void {
+            Cache::forget('site_settings');
+        });
+
+        static::deleted(function (): void {
+            Cache::forget('site_settings');
+        });
+    }
 }
\ No newline at end of file

From de7b2b442ce6fc2cff0d1b0f67262a50a99d4edf Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 22 Apr 2026 20:27:55 +0200
Subject: [PATCH 100/132] feat(users): add user detail view with donation
 transactions and update routes

---
 .../Http/Controllers/AdminUserController.php  |  20 ++
 app/Modules/Admin/Http/routes.php             |   1 +
 .../Resources/views/users/index.blade.php     |   7 +
 .../Resources/views/users/show.blade.php      | 215 ++++++++++++++++++
 docs/roadmap/admin-roadmap.md                 |  89 ++++++++
 5 files changed, 332 insertions(+)
 create mode 100644 app/Modules/Admin/Resources/views/users/show.blade.php
 create mode 100644 docs/roadmap/admin-roadmap.md

diff --git a/app/Modules/Admin/Http/Controllers/AdminUserController.php b/app/Modules/Admin/Http/Controllers/AdminUserController.php
index bfe93c5..94a055e 100644
--- a/app/Modules/Admin/Http/Controllers/AdminUserController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminUserController.php
@@ -7,6 +7,7 @@
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Hash;
 use Illuminate\Validation\Rule;
+use Modules\Donate\Domain\Models\DonationTransaction;
 use Spatie\Permission\Models\Role;
 
 class AdminUserController extends Controller
@@ -33,6 +34,25 @@ public function create()
         return view('admin::users.create', compact('roles'));
     }
 
+    /**
+     * Display the specified resource.
+     *
+     * @param User $user
+     * @return \Illuminate\Http\Response
+     */
+    public function show(User $user)
+    {
+        $user->load('roles');
+
+        $donationTransactions = DonationTransaction::query()
+            ->where('user_id', $user->id)
+            ->latest()
+            ->take(10)
+            ->get();
+
+        return view('admin::users.show', compact('user', 'donationTransactions'));
+    }
+
     /**
      * Store a newly created resource in storage.
      * 
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index 70ba090..ac82b68 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -21,6 +21,7 @@
         Route::get('/users', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'index'])->middleware('permission:manage.admin.users')->name('admin.users.index');
         Route::get('/users/create', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'create'])->middleware('permission:manage.admin.users')->name('admin.users.create');
         Route::post('/users', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'store'])->middleware('permission:manage.admin.users')->name('admin.users.store');
+        Route::get('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'show'])->middleware('permission:manage.admin.users')->name('admin.users.show');
         Route::get('/users/{user}/edit', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'edit'])->middleware('permission:manage.admin.users')->name('admin.users.edit');
         Route::put('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'update'])->middleware('permission:manage.admin.users')->name('admin.users.update');
         Route::delete('/users/{user}', [\Modules\Admin\Http\Controllers\AdminUserController::class, 'destroy'])->middleware('permission:manage.admin.users')->name('admin.users.destroy');
diff --git a/app/Modules/Admin/Resources/views/users/index.blade.php b/app/Modules/Admin/Resources/views/users/index.blade.php
index 60577d9..2695fd3 100644
--- a/app/Modules/Admin/Resources/views/users/index.blade.php
+++ b/app/Modules/Admin/Resources/views/users/index.blade.php
@@ -197,6 +197,13 @@ class="w-full pl-10 pr-4 py-2.5 bg-gray-50 border border-gray-200 rounded-lg foc
                                 <td class="px-6 py-4 text-sm text-gray-600 column-registered">{{ $user->created_at->format('M d, Y') }}</td>    
                                 <td class="px-6 py-4">
                                     <div class="flex items-center gap-2">
+                                        <a href="{{ route('admin.users.show', $user->id) }}" class="inline-flex items-center gap-1 px-3 py-1.5 bg-emerald-50 text-emerald-700 rounded-lg hover:bg-emerald-100 text-xs font-medium">
+                                            <svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/>
+                                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/>
+                                            </svg>
+                                            View
+                                        </a>
                                         <a href="{{ route('admin.users.edit', $user->id) }}" class="inline-flex items-center gap-1 px-3 py-1.5 bg-blue-50 text-blue-700 rounded-lg hover:bg-blue-100 text-xs font-medium">
                                             <svg class="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                                                 <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z"/>
diff --git a/app/Modules/Admin/Resources/views/users/show.blade.php b/app/Modules/Admin/Resources/views/users/show.blade.php
new file mode 100644
index 0000000..696587c
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/users/show.blade.php
@@ -0,0 +1,215 @@
+@extends('admin::layouts.app')
+
+@section('title', 'User Details')
+
+@section('content')
+<div class="min-h-screen bg-gray-50">
+    @php
+        $userStatus = $user->status ?? 'unknown';
+        $donationCount = $donationTransactions->count();
+        $donationTotal = $donationTransactions->sum('amount');
+        $awardedTotal = $donationTransactions->sum('dp_awarded');
+    @endphp
+
+    <div class="max-w-6xl mx-auto px-6 py-8 space-y-6">
+        <div class="relative overflow-hidden rounded-2xl border border-slate-200 bg-gradient-to-r from-slate-900 via-slate-800 to-blue-900 p-6 md:p-8 text-white">
+            <div class="absolute -top-16 -right-16 w-56 h-56 rounded-full bg-white/10 blur-2xl"></div>
+            <div class="absolute -bottom-20 -left-16 w-64 h-64 rounded-full bg-blue-300/10 blur-2xl"></div>
+
+            <div class="relative flex flex-col lg:flex-row lg:items-center lg:justify-between gap-5">
+                <div class="flex items-start gap-4">
+                    <div class="w-14 h-14 rounded-xl bg-white/15 border border-white/20 flex items-center justify-center text-lg font-semibold">
+                        {{ strtoupper(substr($user->name, 0, 2)) }}
+                    </div>
+                    <div>
+                        <p class="text-xs uppercase tracking-[0.2em] text-blue-200">User Profile</p>
+                        <h1 class="mt-1 text-2xl md:text-3xl font-semibold">{{ $user->name }}</h1>
+                        <p class="mt-1 text-sm text-blue-100 break-all">{{ $user->email }}</p>
+                        <div class="mt-3 flex flex-wrap items-center gap-2">
+                            <span class="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-full text-xs font-medium border border-white/25 bg-white/10">
+                                ID #{{ $user->id }}
+                            </span>
+                            @if($userStatus === 'active')
+                                <span class="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-full text-xs font-medium bg-emerald-300/20 text-emerald-100 border border-emerald-200/30">Active</span>
+                            @elseif($userStatus === 'banned')
+                                <span class="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-full text-xs font-medium bg-rose-300/20 text-rose-100 border border-rose-200/30">Banned</span>
+                            @elseif($userStatus === 'pending')
+                                <span class="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-full text-xs font-medium bg-amber-300/20 text-amber-100 border border-amber-200/30">Pending</span>
+                            @else
+                                <span class="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-full text-xs font-medium bg-slate-300/20 text-slate-100 border border-slate-200/30">{{ ucfirst($userStatus) }}</span>
+                            @endif
+                        </div>
+                    </div>
+                </div>
+
+                <div class="flex flex-wrap items-center gap-2">
+                    <a href="{{ route('admin.users.edit', $user) }}" class="inline-flex items-center gap-2 px-4 py-2.5 text-sm font-medium bg-white text-slate-900 rounded-lg hover:bg-slate-100">
+                        <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z"/>
+                        </svg>
+                        Edit User
+                    </a>
+                    <a href="{{ route('admin.users.index') }}" class="inline-flex items-center gap-2 px-4 py-2.5 text-sm font-medium text-white rounded-lg border border-white/30 hover:bg-white/10">
+                        Back to Users
+                    </a>
+                </div>
+            </div>
+        </div>
+
+        <div class="grid grid-cols-1 md:grid-cols-2 xl:grid-cols-4 gap-4">
+            <div class="bg-white border border-gray-200 rounded-xl p-4">
+                <p class="text-xs uppercase tracking-wider text-gray-500">Donation Points</p>
+                <p class="mt-2 text-2xl font-semibold text-gray-900">{{ number_format($user->dp ?? 0) }}</p>
+            </div>
+            <div class="bg-white border border-gray-200 rounded-xl p-4">
+                <p class="text-xs uppercase tracking-wider text-gray-500">Vote Points</p>
+                <p class="mt-2 text-2xl font-semibold text-gray-900">{{ number_format($user->vp ?? 0) }}</p>
+            </div>
+            <div class="bg-white border border-gray-200 rounded-xl p-4">
+                <p class="text-xs uppercase tracking-wider text-gray-500">Donations</p>
+                <p class="mt-2 text-2xl font-semibold text-gray-900">{{ $donationCount }}</p>
+                <p class="text-xs text-gray-500 mt-1">Total awarded: {{ number_format($awardedTotal) }} DP</p>
+            </div>
+            <div class="bg-white border border-gray-200 rounded-xl p-4">
+                <p class="text-xs uppercase tracking-wider text-gray-500">Total Donated</p>
+                <p class="mt-2 text-2xl font-semibold text-gray-900">{{ number_format((float) $donationTotal, 2) }} USD</p>
+                <p class="text-xs text-gray-500 mt-1">Across all gateways</p>
+            </div>
+        </div>
+
+        <div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
+            <div class="lg:col-span-2 space-y-6">
+                <div class="bg-white border border-gray-200 rounded-xl overflow-hidden">
+                    <div class="px-6 py-4 border-b border-gray-200 bg-gray-50">
+                        <h2 class="text-sm font-semibold tracking-wide text-gray-900 uppercase">Account Information</h2>
+                    </div>
+                    <div class="p-6 grid grid-cols-1 md:grid-cols-2 gap-5">
+                        <div>
+                            <p class="text-xs uppercase tracking-wider text-gray-500">Registered</p>
+                            <p class="mt-1 text-sm font-medium text-gray-900">{{ optional($user->created_at)->format('M d, Y H:i') ?? '-' }}</p>
+                        </div>
+                        <div>
+                            <p class="text-xs uppercase tracking-wider text-gray-500">Last Update</p>
+                            <p class="mt-1 text-sm font-medium text-gray-900">{{ optional($user->updated_at)->format('M d, Y H:i') ?? '-' }}</p>
+                        </div>
+                        <div class="md:col-span-2">
+                            <p class="text-xs uppercase tracking-wider text-gray-500">Assigned Roles</p>
+                            @if($user->roles->isNotEmpty())
+                                <div class="mt-2 flex flex-wrap gap-2">
+                                    @foreach($user->roles as $role)
+                                        <span class="inline-flex items-center px-2.5 py-1 text-xs font-medium rounded-lg bg-blue-50 text-blue-700 border border-blue-100">{{ $role->name }}</span>
+                                    @endforeach
+                                </div>
+                            @else
+                                <p class="mt-2 text-sm text-gray-500">No roles assigned.</p>
+                            @endif
+                        </div>
+                    </div>
+                </div>
+
+                <div class="bg-white border border-gray-200 rounded-xl overflow-hidden">
+                    <div class="px-6 py-4 border-b border-gray-200 bg-gray-50 flex flex-col md:flex-row md:items-center md:justify-between gap-2">
+                        <div>
+                            <h2 class="text-sm font-semibold tracking-wide text-gray-900 uppercase">User Transactions</h2>
+                            <p class="text-xs text-gray-500 mt-1">Donation history and placeholder store activity</p>
+                        </div>
+                        <span class="inline-flex items-center px-2.5 py-1 rounded-full bg-gray-100 text-gray-600 text-xs font-medium w-fit">
+                            Latest activity
+                        </span>
+                    </div>
+                    <div class="p-6">
+                        <div class="grid grid-cols-1 xl:grid-cols-2 gap-5">
+                            <div class="space-y-3">
+                                <h3 class="text-sm font-semibold text-gray-900">Donations</h3>
+                                @forelse($donationTransactions as $transaction)
+                                    <div class="rounded-xl border border-gray-200 p-4 hover:border-blue-200 hover:bg-blue-50/30 transition-colors">
+                                        <div class="flex items-start justify-between gap-3">
+                                            <div>
+                                                <p class="text-sm font-semibold text-gray-900">{{ strtoupper($transaction->gateway) }}</p>
+                                                <p class="text-xs text-gray-500 mt-1">{{ optional($transaction->created_at)->format('M d, Y H:i') ?? '-' }}</p>
+                                            </div>
+                                            @if($transaction->status === 'completed')
+                                                <span class="inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-emerald-100 text-emerald-700">Completed</span>
+                                            @elseif($transaction->status === 'pending')
+                                                <span class="inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-amber-100 text-amber-700">Pending</span>
+                                            @else
+                                                <span class="inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-gray-100 text-gray-700">{{ ucfirst($transaction->status) }}</span>
+                                            @endif
+                                        </div>
+                                        <div class="mt-3 grid grid-cols-2 gap-3">
+                                            <div class="rounded-lg bg-white border border-gray-200 px-3 py-2">
+                                                <p class="text-[11px] uppercase tracking-wider text-gray-500">Amount</p>
+                                                <p class="mt-1 text-sm font-semibold text-gray-900">{{ number_format((float) $transaction->amount, 2) }} {{ $transaction->currency }}</p>
+                                            </div>
+                                            <div class="rounded-lg bg-white border border-gray-200 px-3 py-2">
+                                                <p class="text-[11px] uppercase tracking-wider text-gray-500">DP Awarded</p>
+                                                <p class="mt-1 text-sm font-semibold text-gray-900">{{ number_format($transaction->dp_awarded) }}</p>
+                                            </div>
+                                        </div>
+                                        <p class="mt-3 text-[11px] text-gray-500 break-all">Tx: {{ $transaction->transaction_id ?? 'N/A' }}</p>
+                                    </div>
+                                @empty
+                                    <div class="rounded-xl border border-dashed border-gray-300 bg-gray-50 p-6 text-center">
+                                        <p class="text-sm font-medium text-gray-700">No donation transactions</p>
+                                        <p class="text-xs text-gray-500 mt-1">There is no payment history for this user yet.</p>
+                                    </div>
+                                @endforelse
+                            </div>
+
+                            <div class="space-y-3">
+                                <h3 class="text-sm font-semibold text-gray-900">Store</h3>
+                                <div class="rounded-xl border border-dashed border-gray-300 bg-gradient-to-b from-gray-50 to-white p-4">
+                                    <div class="flex items-start justify-between gap-2">
+                                        <div>
+                                            <p class="text-sm font-semibold text-gray-900">Placeholder: Mount Purchase</p>
+                                            <p class="text-xs text-gray-500 mt-1">Apr 21, 2026 19:40</p>
+                                        </div>
+                                        <span class="inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-blue-100 text-blue-700">Placeholder</span>
+                                    </div>
+                                    <p class="text-sm text-gray-700 mt-3">Item: Spectral Tiger</p>
+                                    <p class="text-sm text-gray-700">Cost: 50 DP</p>
+                                </div>
+                                <div class="rounded-xl border border-dashed border-gray-300 bg-gradient-to-b from-gray-50 to-white p-4">
+                                    <div class="flex items-start justify-between gap-2">
+                                        <div>
+                                            <p class="text-sm font-semibold text-gray-900">Placeholder: Character Service</p>
+                                            <p class="text-xs text-gray-500 mt-1">Apr 20, 2026 15:10</p>
+                                        </div>
+                                        <span class="inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-blue-100 text-blue-700">Placeholder</span>
+                                    </div>
+                                    <p class="text-sm text-gray-700 mt-3">Service: Faction Change</p>
+                                    <p class="text-sm text-gray-700">Cost: 30 DP</p>
+                                </div>
+                                <div class="rounded-xl border border-dashed border-gray-300 bg-gradient-to-b from-gray-50 to-white p-4">
+                                    <div class="flex items-start justify-between gap-2">
+                                        <div>
+                                            <p class="text-sm font-semibold text-gray-900">Placeholder: Bundle</p>
+                                            <p class="text-xs text-gray-500 mt-1">Apr 19, 2026 10:05</p>
+                                        </div>
+                                        <span class="inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-blue-100 text-blue-700">Placeholder</span>
+                                    </div>
+                                    <p class="text-sm text-gray-700 mt-3">Bundle: PvP Starter Kit</p>
+                                    <p class="text-sm text-gray-700">Cost: 20 DP</p>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <div class="lg:col-span-1">
+                <div class="sticky top-6 rounded-xl border border-gray-200 bg-white overflow-hidden">
+                    <div class="p-6 border-b border-gray-200">
+                        <h3 class="text-sm font-semibold text-gray-900 uppercase tracking-wide">Quick Actions</h3>
+                        <p class="text-xs text-gray-500 mt-1">Manage this account quickly</p>
+                    </div>
+                    <div class="p-4 space-y-2">
+                        <a href="{{ route('admin.users.edit', $user) }}" class="block w-full px-4 py-3 rounded-lg text-sm font-semibold text-center bg-blue-600 text-white hover:bg-blue-700">Edit User</a>
+                        <a href="{{ route('admin.users.index') }}" class="block w-full px-4 py-3 rounded-lg text-sm font-medium text-center border border-gray-300 text-gray-700 bg-white hover:bg-gray-50">Back to Users</a>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
+@endsection
diff --git a/docs/roadmap/admin-roadmap.md b/docs/roadmap/admin-roadmap.md
new file mode 100644
index 0000000..4ef063b
--- /dev/null
+++ b/docs/roadmap/admin-roadmap.md
@@ -0,0 +1,89 @@
+# Admin Panel – Roadmap de desarrollo
+
+> Trabajo en solitario. Las versiones están ordenadas por prioridad y carga de trabajo realista.
+
+---
+
+## v0.1.6 – Completar la base funcional del Admin
+
+Objetivo: que todo lo que ya existe en el ACP funcione de verdad con datos reales y sin stubs.
+
+### Dashboard (`/acp`)
+- [ ] Conectar las stat cards con datos reales:
+  - Total de cuentas → `User::count()`
+  - Jugadores online → query al realm via `RealmHelper`
+  - Revenue del mes → agregado de donaciones (si existe tabla)
+  - Server uptime → dato del realm o valor configurable
+- [ ] Sección "Recent Activity" con datos reales (últimos logins, cambios de ajustes, etc.)
+- [ ] Sección "Realms Status" conectada a los reinos configurados
+- [ ] Sección "Recent Donations" conectada a la tabla de donaciones (o ocultar si el módulo Donate no está activo)
+- [ ] Eliminar todos los valores hardcodeados del blade (`15,430`, `1,250`, `$8,420`, `99.8%`)
+
+### Settings – Tabs incompletos
+- [ ] **Appearance** – Subir logo/favicon (upload de imagen a `storage/`), previsualización en tiempo real
+- [ ] **Maintenance** – Toggle real de modo mantenimiento vía `php artisan down/up` o `App::isDownForMaintenance()`; el formulario solo guarda el mensaje pero no activa el modo
+- [ ] **Security** – Las reglas de contraseña guardadas en settings deben conectarse al flujo de validación de registro/cambio de contraseña
+- [ ] **Localization** – Conectar `locale` guardado en settings con `App::setLocale()` en el middleware
+
+### Analytics (`/acp/analytics`)
+- [ ] Añadir gráfica de visitas (Chart.js o similar) con datos de `analytics_page_views` agrupados por día
+- [ ] Filtro por período funcional (actualmente los botones existen en la vista pero la lógica backend sí está, falta la gráfica visual)
+
+### Backups (`/acp/backups`)
+- [ ] Incluir en el ZIP los archivos de `storage/app/` (imágenes subidas, etc.), actualmente solo se incluyen DB dump, `.env` y config
+- [ ] Añadir opción de excluir archivos grandes del backup
+- [ ] Indicador de progreso o feedback al generar (la generación puede tardar)
+
+### Usuarios (`/acp/users`)
+- [ ] Vista de detalle de usuario (actualmente solo hay index/create/edit)
+- [ ] Filtro/búsqueda en el listado de usuarios
+- [ ] Mostrar fecha del último login del usuario en el listado/edición
+
+### Módulos (`/acp/modules`)
+- [ ] Al hacer toggle enable/disable mostrar advertencia si el módulo tiene dependencias
+- [ ] Validar que el módulo tiene `module.json` válido antes de intentar migrate
+
+---
+
+## v0.1.7 – Funcionalidades avanzadas del Admin
+
+Objetivo: herramientas de administración más potentes, gestión avanzada de contenido y permisos.
+
+### Gestión de News/Contenido
+- [ ] CRUD de noticias desde el ACP (`/acp/news`) con editor de texto enriquecido (TipTap o similar)
+- [ ] CRUD de categorías de noticias
+- [ ] Moderar comentarios (listar, aprobar, eliminar) desde el ACP
+
+### Gestión de usuarios – mejoras
+- [ ] Acción de ban/unban de usuarios con motivo y duración
+- [ ] Impersonate (actuar como usuario) para depuración
+- [ ] Historial de acciones del usuario (log de actividad)
+
+### Roles y permisos – mejoras
+- [ ] Asignación de permisos individuales a usuarios (actualmente solo por rol)
+- [ ] Vista de qué usuarios tienen un rol concreto directamente desde la página del rol
+
+### Media Manager
+- [ ] Gestor básico de archivos/imágenes subidos (`/acp/media`)
+- [ ] Listar, eliminar y previsualizar archivos en `storage/images/`
+
+### Audit Log
+- [ ] Registro de acciones administrativas (quién cambió qué ajuste, quién baneó a quién, etc.)
+- [ ] Vista en el ACP para consultar el log de auditoría con filtros
+
+### Analytics – mejoras
+- [ ] Gráfica de páginas más visitadas con histórico
+- [ ] Estadística de nuevos registros por día
+- [ ] Exportar datos de analytics a CSV
+
+### Settings – completar API tab
+- [ ] Generación y revocación de API tokens para acceso externo
+- [ ] Documentación inline de los endpoints disponibles
+
+---
+
+## Notas
+
+- **Store** queda fuera de este roadmap (estimado para v0.1.7 o v0.1.8 dependiendo del volumen de trabajo).
+- Las tareas de v0.1.7 asumen que v0.1.6 está completamente terminado y estable.
+- El orden dentro de cada versión no es estricto; prioriza lo que más uses/necesites en ese momento.

From f4d816130a8ad13ae06ca52484b231c5a9d5b0ae Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 30 Apr 2026 02:55:30 +0200
Subject: [PATCH 101/132] feat: Update installation success page and routing
 logic

- Changed the language of the installation success page from English to Spanish.
- Enhanced the styling of the success page with custom CSS instead of Tailwind CSS.
- Updated the success message to be more informative and user-friendly.
- Refactored the routing logic to use a new middleware, EnsureInstallerIsAvailable, to check installation status.
- Redirect users to the homepage if they attempt to access installation routes after installation is complete.

Co-authored-by: Copilot <copilot@github.com>
---
 .../Frontend/InstallController.php            |  198 ++-
 .../Middleware/EnsureInstallerIsAvailable.php |   23 +
 app/Providers/ModuleServiceProvider.php       |    6 +
 app/Services/InstallService.php               |   47 +-
 bootstrap/app.php                             |    1 +
 database/seeders/ForumsSeeder.php             |   12 +-
 docs/roadmap/README.md                        |  258 ----
 docs/roadmap/admin-roadmap.md                 |   89 --
 resources/views/install/index.blade.php       | 1331 ++++++++++++++---
 resources/views/install/success.blade.php     |  118 +-
 routes/web.php                                |   12 +-
 11 files changed, 1447 insertions(+), 648 deletions(-)
 create mode 100644 app/Http/Middleware/EnsureInstallerIsAvailable.php
 delete mode 100755 docs/roadmap/README.md
 delete mode 100644 docs/roadmap/admin-roadmap.md

diff --git a/app/Http/Controllers/Frontend/InstallController.php b/app/Http/Controllers/Frontend/InstallController.php
index e28a5f6..4b2b387 100644
--- a/app/Http/Controllers/Frontend/InstallController.php
+++ b/app/Http/Controllers/Frontend/InstallController.php
@@ -2,18 +2,30 @@
 
 namespace App\Http\Controllers\Frontend;
 
+use App\Enums\Emulator;
+use App\Enums\WoWConstants;
 use Illuminate\Http\Request;
-use Illuminate\Support\Facades\Artisan;
 use App\Http\Controllers\Controller;
 use App\Services\InstallService;
-use Illuminate\Support\Facades\DB;
 use Exception;
+use Illuminate\Validation\Rule;
+use PDO;
 
 class InstallController extends Controller
 {
     public function index()
     {
-        return view('install.index');
+        $requirements = $this->systemRequirements();
+
+        return view('install.index', [
+            'expansions' => WoWConstants::EXPANSION_NAMES,
+            'emulators' => Emulator::LABELS,
+            'emulatorUrns' => Emulator::URN,
+            'defaultExpansion' => WoWConstants::EXPANSION_CATA,
+            'defaultEmulator' => Emulator::TRINITYCORE->value,
+            'requirements' => $requirements,
+            'allRequirementsPassed' => collect($requirements)->every(fn (array $requirement): bool => (bool) ($requirement['ok'] ?? false)),
+        ]);
     }
 
     public function success()
@@ -23,12 +35,21 @@ public function success()
 
     public function testDb(Request $request)
     {
+        $payload = $request->validate([
+            'db_host' => ['required', 'string', 'max:255'],
+            'db_port' => ['required', 'integer', 'between:1,65535'],
+            'db_name' => ['required', 'string', 'max:255'],
+            'db_username' => ['required', 'string', 'max:255'],
+            'db_password' => ['nullable', 'string'],
+        ]);
+
         try {
-            $connection = new \PDO(
-                "mysql:host={$request->db_host};port={$request->db_port};dbname={$request->db_name}",
-                $request->db_username,
-                $request->db_password
+            new PDO(
+                "mysql:host={$payload['db_host']};port={$payload['db_port']};dbname={$payload['db_name']}",
+                $payload['db_username'],
+                $payload['db_password'] ?? ''
             );
+
             return response()->json(['success' => true, 'message' => '✅ Conexión exitosa']);
         } catch (Exception $e) {
             return response()->json(['success' => false, 'message' => '❌ Error: ' . $e->getMessage()]);
@@ -37,27 +58,156 @@ public function testDb(Request $request)
 
     public function install(Request $request)
     {
+        $requirements = $this->systemRequirements();
+        $hasFailedRequirement = collect($requirements)->contains(fn (array $requirement): bool => !(bool) ($requirement['ok'] ?? false));
+
+        if ($hasFailedRequirement) {
+            return back()
+                ->withInput()
+                ->withErrors(['requirements' => 'No se puede instalar hasta cumplir todos los requisitos del sistema.']);
+        }
+
+        $validated = $request->validate($this->validationRules());
         $service = app(InstallService::class);
 
-        $service->run([
-            'db_connection' => 'mysql',
-            'db_host' => $request->db_host,
-            'db_port' => $request->db_port,
-            'db_name' => $request->db_name,
-            'db_username' => $request->db_username,
-            'db_password' => $request->db_password,
-            'app_name' => $request->app_name,
-            'app_url' => $request->app_url,
-            'locale' => $request->locale,
-            'use_redis' => $request->use_redis ?? false,
-            'admin_name' => $request->admin_name,
-            'admin_email' => $request->admin_email,
-            'admin_password' => $request->admin_password,
-        ]);
+        try {
+            $service->run($validated);
+        } catch (\Throwable $exception) {
+            return back()
+                ->withInput()
+                ->withErrors(['install' => 'No se pudo completar la instalación: ' . $exception->getMessage()]);
+        }
 
-        // lock de instalación
         file_put_contents(storage_path('installed.lock'), now());
 
-        return view('install.success');
+        return redirect()
+            ->route('install.success')
+            ->with('install_completed', true)
+            ->with('install_success_message', 'Instalacion completada correctamente.');
+    }
+
+    private function systemRequirements(): array
+    {
+        $phpMin = '8.2.0';
+
+        return [
+            [
+                'label' => "PHP >= {$phpMin}",
+                'ok' => version_compare(PHP_VERSION, $phpMin, '>='),
+                'current' => PHP_VERSION,
+            ],
+            [
+                'label' => 'Extension PDO',
+                'ok' => extension_loaded('pdo'),
+                'current' => extension_loaded('pdo') ? 'OK' : 'Missing',
+            ],
+            [
+                'label' => 'Extension pdo_mysql',
+                'ok' => extension_loaded('pdo_mysql'),
+                'current' => extension_loaded('pdo_mysql') ? 'OK' : 'Missing',
+            ],
+            [
+                'label' => 'Extension mbstring',
+                'ok' => extension_loaded('mbstring'),
+                'current' => extension_loaded('mbstring') ? 'OK' : 'Missing',
+            ],
+            [
+                'label' => 'Extension openssl',
+                'ok' => extension_loaded('openssl'),
+                'current' => extension_loaded('openssl') ? 'OK' : 'Missing',
+            ],
+            [
+                'label' => 'Extension tokenizer',
+                'ok' => extension_loaded('tokenizer'),
+                'current' => extension_loaded('tokenizer') ? 'OK' : 'Missing',
+            ],
+            [
+                'label' => 'Extension xml',
+                'ok' => extension_loaded('xml'),
+                'current' => extension_loaded('xml') ? 'OK' : 'Missing',
+            ],
+            [
+                'label' => 'Extension ctype',
+                'ok' => extension_loaded('ctype'),
+                'current' => extension_loaded('ctype') ? 'OK' : 'Missing',
+            ],
+            [
+                'label' => 'Extension json',
+                'ok' => extension_loaded('json'),
+                'current' => extension_loaded('json') ? 'OK' : 'Missing',
+            ],
+            [
+                'label' => 'Extension fileinfo',
+                'ok' => extension_loaded('fileinfo'),
+                'current' => extension_loaded('fileinfo') ? 'OK' : 'Missing',
+            ],
+            [
+                'label' => 'Storage writable',
+                'ok' => is_writable(storage_path()),
+                'current' => is_writable(storage_path()) ? 'Writable' : 'Not writable',
+            ],
+            [
+                'label' => 'Bootstrap/cache writable',
+                'ok' => is_writable(base_path('bootstrap/cache')),
+                'current' => is_writable(base_path('bootstrap/cache')) ? 'Writable' : 'Not writable',
+            ],
+        ];
+    }
+
+    private function validationRules(): array
+    {
+        return [
+            'agree_eula' => ['accepted'],
+            'app_name' => ['required', 'string', 'max:100'],
+            'app_url' => ['required', 'url', 'max:255'],
+            'locale' => ['required', 'string', 'max:10'],
+
+            'db_host' => ['required', 'string', 'max:255'],
+            'db_port' => ['required', 'integer', 'between:1,65535'],
+            'db_name' => ['required', 'string', 'max:255'],
+            'db_username' => ['required', 'string', 'max:255'],
+            'db_password' => ['nullable', 'string', 'max:255'],
+
+            'admin_name' => ['required', 'string', 'max:120'],
+            'admin_email' => ['required', 'email', 'max:255'],
+            'admin_password' => ['required', 'string', 'min:8', 'confirmed'],
+
+            'realm_name' => ['required', 'string', 'max:120'],
+            'realm_hostname' => ['required', 'string', 'max:255'],
+            'realm_port' => ['required', 'integer', 'between:1,65535'],
+            'realm_expansion' => ['required', 'integer', Rule::in(array_keys(WoWConstants::EXPANSION_NAMES))],
+            'realm_emulator' => ['required', 'string', Rule::in(array_keys(Emulator::LABELS))],
+            'realm_bnet' => ['nullable', 'boolean'],
+
+            'realm_console_hostname' => ['required', 'string', 'max:255'],
+            'realm_console_port' => ['nullable', 'integer', 'between:1,65535'],
+            'realm_console_username' => ['required', 'string', 'max:255'],
+            'realm_console_password' => ['required', 'string', 'max:255'],
+            'realm_console_urn' => ['required', 'string', Rule::in(array_values(Emulator::URN))],
+
+            'realm_auth.host' => ['required', 'string', 'max:255'],
+            'realm_auth.port' => ['nullable', 'integer', 'between:1,65535'],
+            'realm_auth.database' => ['required', 'string', 'max:255'],
+            'realm_auth.username' => ['required', 'string', 'max:255'],
+            'realm_auth.password' => ['required', 'string', 'max:255'],
+            'realm_auth.charset' => ['nullable', 'string', 'max:64'],
+            'realm_auth.collation' => ['nullable', 'string', 'max:64'],
+
+            'realm_characters.host' => ['required', 'string', 'max:255'],
+            'realm_characters.port' => ['nullable', 'integer', 'between:1,65535'],
+            'realm_characters.database' => ['required', 'string', 'max:255'],
+            'realm_characters.username' => ['required', 'string', 'max:255'],
+            'realm_characters.password' => ['required', 'string', 'max:255'],
+            'realm_characters.charset' => ['nullable', 'string', 'max:64'],
+            'realm_characters.collation' => ['nullable', 'string', 'max:64'],
+
+            'realm_world.host' => ['required', 'string', 'max:255'],
+            'realm_world.port' => ['nullable', 'integer', 'between:1,65535'],
+            'realm_world.database' => ['required', 'string', 'max:255'],
+            'realm_world.username' => ['required', 'string', 'max:255'],
+            'realm_world.password' => ['required', 'string', 'max:255'],
+            'realm_world.charset' => ['nullable', 'string', 'max:64'],
+            'realm_world.collation' => ['nullable', 'string', 'max:64'],
+        ];
     }
 }
diff --git a/app/Http/Middleware/EnsureInstallerIsAvailable.php b/app/Http/Middleware/EnsureInstallerIsAvailable.php
new file mode 100644
index 0000000..116cbd6
--- /dev/null
+++ b/app/Http/Middleware/EnsureInstallerIsAvailable.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class EnsureInstallerIsAvailable
+{
+    public function handle(Request $request, Closure $next): Response
+    {
+        if (file_exists(storage_path('installed.lock'))) {
+            if ($request->routeIs('install.success') && $request->session()->has('install_completed')) {
+                return $next($request);
+            }
+
+            return redirect()->route('home');
+        }
+
+        return $next($request);
+    }
+}
diff --git a/app/Providers/ModuleServiceProvider.php b/app/Providers/ModuleServiceProvider.php
index d8026a4..3a3d72a 100644
--- a/app/Providers/ModuleServiceProvider.php
+++ b/app/Providers/ModuleServiceProvider.php
@@ -16,6 +16,12 @@ public function register(): void
 
     public function boot(): void
     {
+        if (!file_exists(storage_path('installed.lock'))) {
+            $this->app->setLocale(config('app.locale', 'en'));
+
+            return;
+        }
+
         $locale = settings('default_locale') ?? 'es';
         $this->app->setLocale($locale);
     }
diff --git a/app/Services/InstallService.php b/app/Services/InstallService.php
index cd1eb35..e32626c 100644
--- a/app/Services/InstallService.php
+++ b/app/Services/InstallService.php
@@ -2,10 +2,10 @@
 
 namespace App\Services;
 
+use App\Models\Realm;
 use Illuminate\Filesystem\Filesystem;
 use Illuminate\Support\Facades\Artisan;
 use App\Models\User;
-use Spatie\Permission\Contracts\Role;
 
 class InstallService
 {
@@ -22,6 +22,7 @@ public function run(array $options = [])
 
         Artisan::call('migrate:fresh', ['--seed' => true]);
         $this->createAdminAccount($options);
+        $this->createInitialRealm($options);
         Artisan::call('storage:link');
         Artisan::call('key:generate');
         Artisan::call('config:cache');
@@ -38,15 +39,38 @@ protected function createAdminAccount(array $options)
         $adminEmail = $options['admin_email'];
         $adminPassword = $options['admin_password'];
 
-        $user = User::create([
-            'name'  => $adminName,
+        $user = User::query()->firstOrCreate([
             'email' => $adminEmail,
+        ], [
+            'name'  => $adminName,
             'password' => bcrypt($adminPassword),
         ]);
 
         $user->assignRole('Admin');
     }
 
+    protected function createInitialRealm(array $options): void
+    {
+        Realm::query()->firstOrCreate(
+            ['name' => $options['realm_name']],
+            [
+                'hostname' => $options['realm_hostname'],
+                'port' => $options['realm_port'],
+                'expansion' => $options['realm_expansion'],
+                'emulator' => $options['realm_emulator'],
+                'bnet' => (bool) ($options['realm_bnet'] ?? false),
+                'auth_database' => json_encode($this->buildDatabaseConfig($options['realm_auth'])),
+                'character_database' => json_encode($this->buildDatabaseConfig($options['realm_characters'])),
+                'world_database' => json_encode($this->buildDatabaseConfig($options['realm_world'])),
+                'console_hostname' => $options['realm_console_hostname'],
+                'console_port' => $options['realm_console_port'] ?? null,
+                'console_username' => $options['realm_console_username'],
+                'console_password' => $options['realm_console_password'],
+                'console_urn' => $options['realm_console_urn'],
+            ]
+        );
+    }
+
     protected function configureEnvironment(array $options)
     {
         $envFile = base_path('.env');
@@ -86,6 +110,23 @@ protected function configureEnvironment(array $options)
         $this->updateEnv($envConfig);
     }
 
+    protected function buildDatabaseConfig(array $config): array
+    {
+        return [
+            'driver' => 'mysql',
+            'host' => $config['host'],
+            'port' => $config['port'] ?? 3306,
+            'database' => $config['database'],
+            'username' => $config['username'],
+            'password' => $config['password'],
+            'charset' => $config['charset'] ?? 'utf8mb4',
+            'collation' => $config['collation'] ?? 'utf8mb4_unicode_ci',
+            'prefix' => '',
+            'strict' => true,
+            'engine' => null,
+        ];
+    }
+
     protected function updateEnv(array $data)
     {
         $envPath = base_path('.env');
diff --git a/bootstrap/app.php b/bootstrap/app.php
index 2d1f849..9dbbb37 100755
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -19,6 +19,7 @@
             'role' => \App\Http\Middleware\CheckRole::class,
             'permission' => \App\Http\Middleware\Permission::class,
             'track.analytics' => \App\Http\Middleware\TrackAnalytics::class,
+            'install.available' => \App\Http\Middleware\EnsureInstallerIsAvailable::class,
         ]);
     })
     ->withExceptions(function (Exceptions $exceptions) {
diff --git a/database/seeders/ForumsSeeder.php b/database/seeders/ForumsSeeder.php
index 01576bd..acf769b 100755
--- a/database/seeders/ForumsSeeder.php
+++ b/database/seeders/ForumsSeeder.php
@@ -7,6 +7,7 @@
 use Modules\Forum\Domain\Models\Post;
 use Modules\Forum\Domain\Models\Thread;
 use App\Models\User;
+use Illuminate\Support\Facades\Hash;
 use Illuminate\Support\Str;
 
 class ForumsSeeder extends Seeder
@@ -98,10 +99,15 @@ public function run(): void
             'order' => 2,
         ]);
 
-        // Get admin user or create one if not exists
-        $admin = User::role('Admin')->first();
+        // Resolve an author user for sample content.
+        $admin = User::role('Admin')->first() ?? User::query()->first();
+
         if (!$admin) {
-            $admin = User::first();
+            $admin = User::query()->create([
+                'name' => 'System Seeder',
+                'email' => 'system-seeder@nexuscms.local',
+                'password' => Hash::make(Str::random(32)),
+            ]);
         }
 
         // Create sample threads and posts
diff --git a/docs/roadmap/README.md b/docs/roadmap/README.md
deleted file mode 100755
index d751f04..0000000
--- a/docs/roadmap/README.md
+++ /dev/null
@@ -1,258 +0,0 @@
-# 🌐 Select Your Language | Seleccione su Idioma
-
-- [English](#english)
-- [Español](#español)
-
-# English
-
-# 🏛️ NexusCMS Project Governance
-
-*A comprehensive guide to project structure, roles and roadmap*
-
-## 📋 Table of Contents
-
-- [Roles & Responsibilities](#roles--responsibilities)
-- [Decision Making Process](#decision-making-process)
-- [Becoming a Maintainer](#becoming-a-maintainer)
-- [Project Roadmap](#project-roadmap)
-- [Communication](#communication)
-- [Code of Conduct](#code-of-conduct)
-
-## 👥 Roles & Responsibilities
-
-### Core Maintainers
-Core maintainers guide the project's direction, approve significant changes and manage the community.
-
-- 🎯 Make strategic roadmap decisions
-- ⚙️ Approve/reject major architectural changes
-- 📦 Manage version releases
-- 👥 Oversee community and resolve conflicts
-
-### Collaborators
-Active community members who regularly contribute to the project.
-
-- ✍️ Have repository write access
-- 👀 Review and approve pull requests
-- 💡 Participate in technical discussions
-- 🛡️ Help maintain code quality
-
-### Contributors
-Anyone who contributes through pull requests, bug reports or documentation.
-
-- 🔧 Submit pull requests for fixes/features
-- 🐛 Report bugs and issues
-- 📝 Improve documentation
-- 💭 Participate in discussions
-
-## 🤝 Decision Making Process
-
-NexusCMS follows a consensus-based model with hierarchical considerations:
-
-### 1. Minor Decisions
-Collaborators can approve small changes without core maintainer approval.
-
-### 2. Technical Decisions
-For architectural changes or new features:
-- 📋 Open GitHub issue proposal
-- ⏳ 7-day discussion period
-- 🤝 Seek collaborator/maintainer consensus
-- ⚖️ Core maintainers have final say
-
-### 3. Strategic Decisions
-For roadmap/vision changes:
-- 📢 Core maintainers propose changes
-- 👂 Community feedback gathered
-- ✅ Final decision considers all input
-
-## 🌟 Becoming a Maintainer
-
-### Path to Maintainership:
-
-1. **Active Contributor** (3+ months of quality contributions)
-2. **Collaborator** (Consistent contributions → Write access)
-3. **Maintainer** - Must demonstrate:
-   - 💻 Technical excellence
-   - 🔍 Good code review judgment
-   - 🗣️ Effective community communication
-   - 🎯 Project vision alignment
-
-## 📅 Project Roadmap
-
-### Q2 2025 – Foundation Phase (May-June)
-- **Audit & Planning**
-  - CodeIgniter CMS analysis
-  - Module/flow identification
-  - Laravel architecture design
-  - Multi-core emulator support planning
-- **Environment Setup**
-  - Trinity/Azeroth DB migration schemas
-  - WoW encryption/connection library
-
-### Q3 2025 – Core Development (July-Sept)
-- **CMS Core**
-  - Auth & session management
-  - User roles/permissions
-  - Basic content system
-  - Multi-core DB connectivity
-  - Emulator handshake integration
-  - Core flow testing
-
-### Q4 2025 – Feature Expansion (Oct-Dec)
-- **CMS Features**
-  - Media management
-  - Comment system
-  - Notification system
-  - Multilingual config
-- **Multi-Emulator Support**
-  - Dynamic realm connections
-  - Account/player sync
-  - Encryption library
-  - Responsive admin panel
-
-### Q1 2026 – Launch Phase (Jan-April)
-- **Final QA**
-  - Load testing
-  - Security review
-  - Optimization
-  - Production deployment
-  - Documentation
-
-## 💬 Communication
-
-- 📌 GitHub Issues/PRs
-- 🎮 Discord
-- 🤝 Bi-monthly maintainer meetings
-- 📢 Project website announcements
-
-## 📜 Code of Conduct
-
-All project participants must adhere to our Code of Conduct found in the documentation folder.
-
----
-
-# Español
-
-# 🏛️ Gobernanza del Proyecto NexusCMS
-
-*Una guía completa de la estructura del proyecto, roles y hoja de ruta*
-
-## 📋 Tabla de Contenidos
-
-- [Roles y Responsabilidades](#roles-y-responsabilidades)
-- [Proceso de Toma de Decisiones](#proceso-de-toma-de-decisiones)
-- [Convertirse en Mantenedor](#convertirse-en-mantenedor)
-- [Hoja de Ruta del Proyecto](#hoja-de-ruta-del-proyecto)
-- [Comunicación](#comunicación)
-- [Código de Conducta](#código-de-conducta)
-
-## 👥 Roles y Responsabilidades
-
-### Mantenedores Principales
-Los mantenedores principales guían la dirección del proyecto, aprueban cambios significativos y gestionan la comunidad.
-
-- 🎯 Tomar decisiones estratégicas sobre la hoja de ruta
-- ⚙️ Aprobar/rechazar cambios arquitectónicos importantes
-- 📦 Gestionar lanzamientos de versiones
-- 👥 Supervisar la comunidad y resolver conflictos
-
-### Colaboradores
-Miembros activos de la comunidad que contribuyen regularmente al proyecto.
-
-- ✍️ Tienen acceso de escritura al repositorio
-- 👀 Revisan y aprueban pull requests
-- 💡 Participan en discusiones técnicas
-- 🛡️ Ayudan a mantener la calidad del código
-
-### Contribuyentes
-Cualquiera que contribuya a través de pull requests, reportes de errores o documentación.
-
-- 🔧 Enviar pull requests para correcciones/características
-- 🐛 Reportar errores y problemas
-- 📝 Mejorar la documentación
-- 💭 Participar en discusiones
-
-## 🤝 Proceso de Toma de Decisiones
-
-NexusCMS sigue un modelo basado en consenso con consideraciones jerárquicas:
-
-### 1. Decisiones Menores
-Los colaboradores pueden aprobar cambios pequeños sin aprobación de los mantenedores principales.
-
-### 2. Decisiones Técnicas
-Para cambios arquitectónicos o nuevas características:
-- 📋 Abrir propuesta de issue en GitHub
-- ⏳ Período de discusión de 7 días
-- 🤝 Buscar consenso entre colaboradores/mantenedores
-- ⚖️ Los mantenedores principales tienen la última palabra
-
-### 3. Decisiones Estratégicas
-Para cambios en la hoja de ruta/visión:
-- 📢 Los mantenedores principales proponen cambios
-- 👂 Se recopila retroalimentación de la comunidad
-- ✅ La decisión final considera todas las aportaciones
-
-## 🌟 Convertirse en Mantenedor
-
-### Camino hacia el Mantenimiento:
-
-1. **Contribuyente Activo** (3+ meses de contribuciones de calidad)
-2. **Colaborador** (Contribuciones consistentes → Acceso de escritura)
-3. **Mantenedor** - Debe demostrar:
-   - 💻 Excelencia técnica
-   - 🔍 Buen criterio en revisión de código
-   - 🗣️ Comunicación efectiva con la comunidad
-   - 🎯 Alineación con la visión del proyecto
-
-## 📅 Hoja de Ruta del Proyecto
-
-### Q2 2025 – Fase de Fundación (Mayo-Junio)
-- **Auditoría y Planificación**
-  - Análisis del CMS CodeIgniter
-  - Identificación de módulos/flujos
-  - Diseño de arquitectura Laravel
-  - Planificación de soporte multi-emulador
-- **Configuración del Entorno**
-  - Esquemas de migración DB Trinity/Azeroth
-  - Biblioteca de encriptación/conexión WoW
-
-### Q3 2025 – Desarrollo del Núcleo (Julio-Sept)
-- **Núcleo del CMS**
-  - Gestión de autenticación y sesiones
-  - Roles/permisos de usuario
-  - Sistema básico de contenido
-  - Conectividad multi-núcleo DB
-  - Integración de handshake del emulador
-  - Pruebas de flujo del núcleo
-
-### Q4 2025 – Expansión de Características (Oct-Dic)
-- **Características del CMS**
-  - Gestión de medios
-  - Sistema de comentarios
-  - Sistema de notificaciones
-  - Configuración multilingüe
-- **Soporte Multi-Emulador**
-  - Conexiones dinámicas de reinos
-  - Sincronización de cuenta/jugador
-  - Biblioteca de encriptación
-  - Panel de administración responsivo
-
-### Q1 2026 – Fase de Lanzamiento (Enero-Abril)
-- **Control de Calidad Final**
-  - Pruebas de carga
-  - Revisión de seguridad
-  - Optimización
-  - Despliegue en producción
-  - Documentación
-
-## 💬 Comunicación
-
-- 📌 Issues/PRs de GitHub
-- 🎮 Discord
-- 🤝 Reuniones bimensuales de mantenedores
-- 📢 Anuncios en el sitio web del proyecto
-
-## 📜 Código de Conducta
-
-Todos los participantes del proyecto deben adherirse a nuestro Código de Conducta que se encuentra en la carpeta de documentación.
-
----
diff --git a/docs/roadmap/admin-roadmap.md b/docs/roadmap/admin-roadmap.md
deleted file mode 100644
index 4ef063b..0000000
--- a/docs/roadmap/admin-roadmap.md
+++ /dev/null
@@ -1,89 +0,0 @@
-# Admin Panel – Roadmap de desarrollo
-
-> Trabajo en solitario. Las versiones están ordenadas por prioridad y carga de trabajo realista.
-
----
-
-## v0.1.6 – Completar la base funcional del Admin
-
-Objetivo: que todo lo que ya existe en el ACP funcione de verdad con datos reales y sin stubs.
-
-### Dashboard (`/acp`)
-- [ ] Conectar las stat cards con datos reales:
-  - Total de cuentas → `User::count()`
-  - Jugadores online → query al realm via `RealmHelper`
-  - Revenue del mes → agregado de donaciones (si existe tabla)
-  - Server uptime → dato del realm o valor configurable
-- [ ] Sección "Recent Activity" con datos reales (últimos logins, cambios de ajustes, etc.)
-- [ ] Sección "Realms Status" conectada a los reinos configurados
-- [ ] Sección "Recent Donations" conectada a la tabla de donaciones (o ocultar si el módulo Donate no está activo)
-- [ ] Eliminar todos los valores hardcodeados del blade (`15,430`, `1,250`, `$8,420`, `99.8%`)
-
-### Settings – Tabs incompletos
-- [ ] **Appearance** – Subir logo/favicon (upload de imagen a `storage/`), previsualización en tiempo real
-- [ ] **Maintenance** – Toggle real de modo mantenimiento vía `php artisan down/up` o `App::isDownForMaintenance()`; el formulario solo guarda el mensaje pero no activa el modo
-- [ ] **Security** – Las reglas de contraseña guardadas en settings deben conectarse al flujo de validación de registro/cambio de contraseña
-- [ ] **Localization** – Conectar `locale` guardado en settings con `App::setLocale()` en el middleware
-
-### Analytics (`/acp/analytics`)
-- [ ] Añadir gráfica de visitas (Chart.js o similar) con datos de `analytics_page_views` agrupados por día
-- [ ] Filtro por período funcional (actualmente los botones existen en la vista pero la lógica backend sí está, falta la gráfica visual)
-
-### Backups (`/acp/backups`)
-- [ ] Incluir en el ZIP los archivos de `storage/app/` (imágenes subidas, etc.), actualmente solo se incluyen DB dump, `.env` y config
-- [ ] Añadir opción de excluir archivos grandes del backup
-- [ ] Indicador de progreso o feedback al generar (la generación puede tardar)
-
-### Usuarios (`/acp/users`)
-- [ ] Vista de detalle de usuario (actualmente solo hay index/create/edit)
-- [ ] Filtro/búsqueda en el listado de usuarios
-- [ ] Mostrar fecha del último login del usuario en el listado/edición
-
-### Módulos (`/acp/modules`)
-- [ ] Al hacer toggle enable/disable mostrar advertencia si el módulo tiene dependencias
-- [ ] Validar que el módulo tiene `module.json` válido antes de intentar migrate
-
----
-
-## v0.1.7 – Funcionalidades avanzadas del Admin
-
-Objetivo: herramientas de administración más potentes, gestión avanzada de contenido y permisos.
-
-### Gestión de News/Contenido
-- [ ] CRUD de noticias desde el ACP (`/acp/news`) con editor de texto enriquecido (TipTap o similar)
-- [ ] CRUD de categorías de noticias
-- [ ] Moderar comentarios (listar, aprobar, eliminar) desde el ACP
-
-### Gestión de usuarios – mejoras
-- [ ] Acción de ban/unban de usuarios con motivo y duración
-- [ ] Impersonate (actuar como usuario) para depuración
-- [ ] Historial de acciones del usuario (log de actividad)
-
-### Roles y permisos – mejoras
-- [ ] Asignación de permisos individuales a usuarios (actualmente solo por rol)
-- [ ] Vista de qué usuarios tienen un rol concreto directamente desde la página del rol
-
-### Media Manager
-- [ ] Gestor básico de archivos/imágenes subidos (`/acp/media`)
-- [ ] Listar, eliminar y previsualizar archivos en `storage/images/`
-
-### Audit Log
-- [ ] Registro de acciones administrativas (quién cambió qué ajuste, quién baneó a quién, etc.)
-- [ ] Vista en el ACP para consultar el log de auditoría con filtros
-
-### Analytics – mejoras
-- [ ] Gráfica de páginas más visitadas con histórico
-- [ ] Estadística de nuevos registros por día
-- [ ] Exportar datos de analytics a CSV
-
-### Settings – completar API tab
-- [ ] Generación y revocación de API tokens para acceso externo
-- [ ] Documentación inline de los endpoints disponibles
-
----
-
-## Notas
-
-- **Store** queda fuera de este roadmap (estimado para v0.1.7 o v0.1.8 dependiendo del volumen de trabajo).
-- Las tareas de v0.1.7 asumen que v0.1.6 está completamente terminado y estable.
-- El orden dentro de cada versión no es estricto; prioriza lo que más uses/necesites en ese momento.
diff --git a/resources/views/install/index.blade.php b/resources/views/install/index.blade.php
index bb28208..3f9ce5a 100644
--- a/resources/views/install/index.blade.php
+++ b/resources/views/install/index.blade.php
@@ -1,309 +1,1148 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="es">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>NexusCMS Installer</title>
-    <script src="https://cdn.tailwindcss.com"></script>
+    <title>NexusCMS &mdash; Installation Wizard</title>
+    <style>
+        *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+            font-size: 14px;
+            line-height: 1.5;
+            background: #edf0f5;
+            color: #1a2130;
+            min-height: 100vh;
+        }
+
+        /* ---- Layout ---- */
+        .installer {
+            display: flex;
+            min-height: 100vh;
+        }
+
+        /* ---- Sidebar ---- */
+        .sidebar {
+            width: 264px;
+            flex-shrink: 0;
+            background: #1b2232;
+            display: flex;
+            flex-direction: column;
+        }
+
+        .sidebar-brand {
+            padding: 28px 24px 24px;
+            border-bottom: 1px solid rgba(255,255,255,0.07);
+        }
+
+        .sidebar-brand-name {
+            font-size: 18px;
+            font-weight: 700;
+            color: #ffffff;
+            letter-spacing: 0.02em;
+        }
+
+        .sidebar-brand-sub {
+            font-size: 11px;
+            color: #7a8caa;
+            margin-top: 3px;
+            text-transform: uppercase;
+            letter-spacing: 0.08em;
+        }
+
+        .sidebar-steps {
+            padding: 20px 16px;
+            flex: 1;
+        }
+
+        .sidebar-step {
+            display: flex;
+            align-items: flex-start;
+            gap: 12px;
+            padding: 10px 8px;
+            border-radius: 6px;
+            cursor: default;
+            user-select: none;
+            margin-bottom: 2px;
+        }
+
+        .sidebar-step.is-current {
+            background: rgba(55, 118, 255, 0.14);
+        }
+
+        .step-num {
+            width: 26px;
+            height: 26px;
+            border-radius: 50%;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            font-size: 12px;
+            font-weight: 700;
+            flex-shrink: 0;
+            border: 1.5px solid #3a4a63;
+            color: #7a8caa;
+            background: transparent;
+            margin-top: 1px;
+        }
+
+        .sidebar-step.is-done .step-num {
+            background: #1f6b46;
+            border-color: #27915e;
+            color: #a7f3cf;
+        }
+
+        .sidebar-step.is-current .step-num {
+            background: #1a4dcc;
+            border-color: #3776ff;
+            color: #d0e4ff;
+        }
+
+        .step-check { display: none; }
+        .sidebar-step.is-done .step-check { display: block; }
+        .sidebar-step.is-done .step-num-digit { display: none; }
+
+        .step-info { line-height: 1.3; }
+
+        .step-label {
+            font-size: 13px;
+            font-weight: 600;
+            color: #d0d8e8;
+        }
+
+        .sidebar-step.is-current .step-label { color: #ffffff; }
+        .sidebar-step.is-done .step-label { color: #6d8ba8; }
+
+        .step-sub {
+            font-size: 11px;
+            color: #4f617c;
+            margin-top: 2px;
+        }
+
+        .sidebar-step.is-current .step-sub { color: #7b9cc4; }
+
+        .sidebar-footer {
+            padding: 16px 24px;
+            border-top: 1px solid rgba(255,255,255,0.06);
+            font-size: 11px;
+            color: #3f5168;
+        }
+
+        /* ---- Content area ---- */
+        .content {
+            flex: 1;
+            display: flex;
+            flex-direction: column;
+            min-width: 0;
+        }
+
+        .content-topbar {
+            background: #ffffff;
+            border-bottom: 1px solid #dce2ec;
+            padding: 0 32px;
+            height: 56px;
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
+            flex-shrink: 0;
+        }
+
+        .topbar-breadcrumb {
+            font-size: 12px;
+            color: #7a8caa;
+        }
+
+        .topbar-breadcrumb strong { color: #1a2130; }
+
+        .topbar-progress {
+            display: flex;
+            gap: 4px;
+            align-items: center;
+        }
+
+        .progress-pip {
+            width: 28px;
+            height: 4px;
+            border-radius: 2px;
+            background: #dde3ed;
+        }
+
+        .progress-pip.done   { background: #27915e; }
+        .progress-pip.active { background: #3776ff; }
+
+        .content-main {
+            flex: 1;
+            padding: 32px;
+            overflow-y: auto;
+        }
+
+        .pane-header {
+            margin-bottom: 24px;
+            padding-bottom: 18px;
+            border-bottom: 1px solid #dce2ec;
+        }
+
+        .pane-header h1 {
+            font-size: 20px;
+            font-weight: 700;
+            color: #1a2130;
+        }
+
+        .pane-header p {
+            font-size: 13px;
+            color: #6b7a93;
+            margin-top: 5px;
+        }
+
+        /* ---- Error box ---- */
+        .alert-error {
+            background: #fff2f2;
+            border: 1px solid #fca5a5;
+            border-left: 4px solid #dc2626;
+            border-radius: 6px;
+            padding: 12px 16px;
+            margin-bottom: 20px;
+            font-size: 13px;
+            color: #7f1d1d;
+        }
+
+        .alert-error ul { margin: 6px 0 0 16px; }
+        .alert-error li { margin-top: 3px; }
+
+        /* ---- Step panes ---- */
+        .step-pane { display: none; }
+        .step-pane.current { display: block; }
+
+        /* ---- Form sections ---- */
+        .form-section {
+            background: #ffffff;
+            border: 1px solid #dce2ec;
+            border-radius: 8px;
+            margin-bottom: 16px;
+        }
+
+        .form-section-head {
+            padding: 14px 20px;
+            border-bottom: 1px solid #edf0f5;
+            display: flex;
+            align-items: center;
+            gap: 10px;
+        }
+
+        .form-section-head h2 {
+            font-size: 11px;
+            font-weight: 700;
+            color: #6b7a93;
+            text-transform: uppercase;
+            letter-spacing: 0.08em;
+            margin: 0;
+        }
+
+        .section-badge {
+            font-size: 11px;
+            font-weight: 600;
+            padding: 2px 7px;
+            border-radius: 99px;
+            background: #edf2ff;
+            color: #3358cc;
+            border: 1px solid #c7d7ff;
+        }
+
+        .section-badge.optional {
+            background: #f5f5f5;
+            color: #6b7a93;
+            border-color: #dce2ec;
+        }
+
+        .form-section-body { padding: 20px; }
+
+        /* ---- Field grid ---- */
+        .field-row {
+            display: grid;
+            grid-template-columns: repeat(12, minmax(0, 1fr));
+            gap: 16px 14px;
+            margin-bottom: 16px;
+        }
+
+        .field-row:last-child { margin-bottom: 0; }
+
+        .f-full  { grid-column: span 12; }
+        .f-half  { grid-column: span 6; }
+        .f-third { grid-column: span 4; }
+        .f-two   { grid-column: span 8; }
+        .f-one   { grid-column: span 3; }
+
+        .field label {
+            display: block;
+            font-size: 12px;
+            font-weight: 600;
+            color: #3d4f68;
+            margin-bottom: 6px;
+            letter-spacing: 0.01em;
+        }
+
+        .field .field-hint {
+            font-size: 11px;
+            color: #8a9bb4;
+            margin-top: 4px;
+        }
+
+        input[type="text"],
+        input[type="url"],
+        input[type="email"],
+        input[type="number"],
+        input[type="password"],
+        select {
+            width: 100%;
+            height: 36px;
+            padding: 0 10px;
+            border: 1px solid #c8d0de;
+            border-radius: 5px;
+            background: #ffffff;
+            color: #1a2130;
+            font-size: 13px;
+            font-family: inherit;
+            appearance: none;
+            -webkit-appearance: none;
+            transition: border-color 0.15s, box-shadow 0.15s;
+            box-sizing: border-box;
+        }
+
+        select {
+            background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='8' viewBox='0 0 12 8'%3E%3Cpath d='M1 1l5 5 5-5' stroke='%236b7a93' stroke-width='1.5' fill='none' stroke-linecap='round'/%3E%3C/svg%3E");
+            background-repeat: no-repeat;
+            background-position: right 10px center;
+            padding-right: 28px;
+        }
+
+        input:focus, select:focus {
+            outline: none;
+            border-color: #3776ff;
+            box-shadow: 0 0 0 3px rgba(55, 118, 255, 0.12);
+        }
+
+        /* ---- Checkbox ---- */
+        .checkbox-field {
+            display: flex;
+            align-items: flex-start;
+            gap: 10px;
+        }
+
+        .checkbox-field input[type="checkbox"] {
+            width: 16px;
+            height: 16px;
+            flex-shrink: 0;
+            margin-top: 2px;
+            cursor: pointer;
+            accent-color: #3776ff;
+        }
+
+        .checkbox-field label {
+            font-size: 13px;
+            font-weight: 500;
+            color: #2c3e58;
+            cursor: pointer;
+            line-height: 1.4;
+            margin: 0;
+        }
+
+        /* ---- License box ---- */
+        .license-text {
+            background: #f8fafc;
+            border: 1px solid #dce2ec;
+            border-radius: 6px;
+            padding: 16px 18px;
+            max-height: 240px;
+            overflow-y: auto;
+            font-size: 13px;
+            line-height: 1.65;
+            color: #3d4f68;
+        }
+
+        .license-text p { margin-bottom: 10px; }
+        .license-text p:last-child { margin-bottom: 0; }
+
+        /* ---- Requirements table ---- */
+        .req-table {
+            width: 100%;
+            border-collapse: collapse;
+            font-size: 13px;
+        }
+
+        .req-table th {
+            text-align: left;
+            font-size: 11px;
+            font-weight: 700;
+            color: #6b7a93;
+            text-transform: uppercase;
+            letter-spacing: 0.06em;
+            padding: 0 12px 10px;
+            border-bottom: 1px solid #dce2ec;
+        }
+
+        .req-table td {
+            padding: 9px 12px;
+            border-bottom: 1px solid #edf0f5;
+            color: #2c3e58;
+        }
+
+        .req-table tr:last-child td { border-bottom: 0; }
+
+        .req-status { font-weight: 700; font-size: 12px; }
+        .req-status.ok  { color: #16a34a; }
+        .req-status.err { color: #dc2626; }
+
+        .req-value {
+            color: #6b7a93;
+            font-family: "Cascadia Code", "Fira Mono", "Consolas", monospace;
+            font-size: 12px;
+        }
+
+        /* ---- DB test ---- */
+        .db-test-row {
+            display: flex;
+            align-items: center;
+            gap: 10px;
+            margin-top: 16px;
+            padding-top: 16px;
+            border-top: 1px solid #edf0f5;
+        }
+
+        .db-feedback { font-size: 13px; font-weight: 600; }
+        .db-feedback.pending { color: #6b7a93; }
+        .db-feedback.ok  { color: #16a34a; }
+        .db-feedback.err { color: #dc2626; }
+
+        /* ---- Footer bar ---- */
+        .content-footer {
+            background: #ffffff;
+            border-top: 1px solid #dce2ec;
+            padding: 14px 32px;
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            flex-shrink: 0;
+        }
+
+        .footer-left, .footer-right {
+            display: flex;
+            align-items: center;
+            gap: 8px;
+        }
+
+        /* ---- Buttons ---- */
+        .btn {
+            height: 36px;
+            padding: 0 16px;
+            font-size: 13px;
+            font-weight: 600;
+            border-radius: 5px;
+            border: 1px solid transparent;
+            cursor: pointer;
+            font-family: inherit;
+            display: inline-flex;
+            align-items: center;
+            gap: 6px;
+            text-decoration: none;
+            transition: background 0.1s;
+        }
+
+        .btn-ghost {
+            background: transparent;
+            border-color: #c8d0de;
+            color: #3d4f68;
+        }
+
+        .btn-ghost:hover { background: #f0f3f8; }
+
+        .btn-primary {
+            background: #2563eb;
+            border-color: #1d4ed8;
+            color: #ffffff;
+        }
+
+        .btn-primary:hover { background: #1d4ed8; }
+
+        .btn-success {
+            background: #15803d;
+            border-color: #166534;
+            color: #ffffff;
+        }
+
+        .btn-success:hover { background: #166534; }
+        .btn:disabled { opacity: 0.55; cursor: not-allowed; }
+
+        /* ---- Confirmation checklist ---- */
+        .checklist {
+            list-style: none;
+            font-size: 13px;
+            color: #3d4f68;
+        }
+
+        .checklist li {
+            display: flex;
+            align-items: flex-start;
+            gap: 8px;
+            padding: 7px 0;
+            border-bottom: 1px solid #edf0f5;
+        }
+
+        .checklist li:last-child { border-bottom: 0; }
+
+        .checklist li::before {
+            content: "→";
+            color: #6b7a93;
+            flex-shrink: 0;
+            margin-top: 1px;
+        }
+
+        code {
+            background: #edf0f5;
+            border-radius: 3px;
+            padding: 1px 5px;
+            font-size: 12px;
+            font-family: "Cascadia Code", "Fira Mono", "Consolas", monospace;
+        }
+
+        /* ---- Responsive ---- */
+        @media (max-width: 860px) {
+            .sidebar { width: 220px; }
+            .content-main, .content-topbar, .content-footer { padding-left: 20px; padding-right: 20px; }
+        }
+
+        @media (max-width: 640px) {
+            .installer { flex-direction: column; }
+            .sidebar { width: 100%; }
+            .sidebar-steps { display: flex; flex-wrap: nowrap; overflow-x: auto; padding: 10px 16px; gap: 4px; }
+            .sidebar-step { flex-direction: column; gap: 4px; min-width: 80px; text-align: center; padding: 8px; }
+            .f-half, .f-third, .f-one, .f-two { grid-column: span 12; }
+        }
+
+    </style>
 </head>
-<body class="bg-gradient-to-br from-blue-50 to-indigo-100 min-h-screen py-8">
-    <div class="max-w-2xl mx-auto px-4" 
-         id="installerApp" 
-         data-step="{{ $currentStep ?? 0 }}">
-        <!-- Header -->
-        <div class="text-center mb-8">
-            <div class="bg-white rounded-full w-16 h-16 flex items-center justify-center mx-auto mb-4 shadow-lg">
-                <svg class="w-8 h-8 text-indigo-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19.428 15.428a2 2 0 00-1.022-.547l-2.387-.477a6 6 0 00-3.86.517l-.318.158a6 6 0 01-3.86.517L6.05 15.21a2 2 0 00-1.806.547M8 4h8l-1 1v5.172a2 2 0 00.586 1.414l5 5c1.26 1.26.367 3.414-1.415 3.414H4.828c-1.782 0-2.674-2.154-1.414-3.414l5-5A2 2 0 009 7.172V5L8 4z"></path>
-                </svg>
-            </div>
-            <h1 class="text-3xl font-bold text-gray-900 mb-2">NexusCMS Installer</h1>
-            <p class="text-gray-600">Configure the application settings and database connection.</p>
+<body>
+<div class="installer">
+
+    {{-- Sidebar --}}
+    <aside class="sidebar">
+        <div class="sidebar-brand">
+            <div class="sidebar-brand-name">NexusCMS</div>
+            <div class="sidebar-brand-sub">Installation Wizard</div>
         </div>
 
-        <!-- Progress Steps -->
-        <div class="mb-8">
-            <div class="flex items-center justify-center space-x-2 md:space-x-4">
-                @foreach(range(0,4) as $step)
-                <div class="flex items-center">
-                    <div 
-                        id="step{{ $step }}-indicator" 
-                        class="w-10 h-10 rounded-full flex items-center justify-center font-semibold text-sm leading-none flex-shrink-0
-                            {{ ($currentStep ?? 0) == $step ? 'bg-blue-500 text-white' : 'bg-gray-300 text-gray-600' }}">
-                        {{ $step == 0 ? 'EULA' : $step }}
-                    </div>
-                    <span 
-                        id="step{{ $step }}-text" 
-                        class="ml-2 text-sm font-medium hidden md:block
-                            {{ ($currentStep ?? 0) == $step ? 'text-blue-600' : 'text-gray-400' }}">
-                        @switch($step)
-                            @case(0) EULA @break
-                            @case(1) Application Config @break
-                            @case(2) Database Config @break
-                            @case(3) Admin account @break
-                            @case(4) Installation @break
-                        @endswitch
-                    </span>
+        <nav class="sidebar-steps" id="stepList">
+            <div class="sidebar-step" data-step="0">
+                <div class="step-num">
+                    <span class="step-num-digit">1</span>
+                    <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
+                </div>
+                <div class="step-info">
+                    <div class="step-label">Licencia</div>
+                    <div class="step-sub">EULA y requisitos</div>
+                </div>
+            </div>
+            <div class="sidebar-step" data-step="1">
+                <div class="step-num">
+                    <span class="step-num-digit">2</span>
+                    <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
+                </div>
+                <div class="step-info">
+                    <div class="step-label">Requisitos</div>
+                    <div class="step-sub">Verificación del entorno</div>
+                </div>
+            </div>
+            <div class="sidebar-step" data-step="2">
+                <div class="step-num">
+                    <span class="step-num-digit">3</span>
+                    <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
+                </div>
+                <div class="step-info">
+                    <div class="step-label">Aplicación</div>
+                    <div class="step-sub">Nombre, URL e idioma</div>
+                </div>
+            </div>
+            <div class="sidebar-step" data-step="3">
+                <div class="step-num">
+                    <span class="step-num-digit">4</span>
+                    <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
+                </div>
+                <div class="step-info">
+                    <div class="step-label">Base de datos</div>
+                    <div class="step-sub">Conexión principal</div>
+                </div>
+            </div>
+            <div class="sidebar-step" data-step="4">
+                <div class="step-num">
+                    <span class="step-num-digit">5</span>
+                    <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
                 </div>
-                @if($step < 5)
-                <div 
-                    class="w-8 md:w-16 h-0.5 
-                        {{ ($currentStep ?? 0) > $step ? 'bg-blue-500' : 'bg-gray-300' }}" 
-                    id="progress-bar-{{ $step }}">
+                <div class="step-info">
+                    <div class="step-label">Administrador</div>
+                    <div class="step-sub">Cuenta inicial</div>
                 </div>
-                @endif
-                @endforeach
+            </div>
+            <div class="sidebar-step" data-step="5">
+                <div class="step-num">
+                    <span class="step-num-digit">6</span>
+                    <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
+                </div>
+                <div class="step-info">
+                    <div class="step-label">Primer reino</div>
+                    <div class="step-sub">Realm y consola</div>
+                </div>
+            </div>
+            <div class="sidebar-step" data-step="6">
+                <div class="step-num">
+                    <span class="step-num-digit">7</span>
+                    <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
+                </div>
+                <div class="step-info">
+                    <div class="step-label">Confirmación</div>
+                    <div class="step-sub">Resumen final</div>
+                </div>
+            </div>
+        </nav>
+
+        <div class="sidebar-footer">NexusCMS &mdash; Setup</div>
+    </aside>
+
+    {{-- Content --}}
+    <div class="content">
+        <div class="content-topbar">
+            <span class="topbar-breadcrumb" id="topbarBreadcrumb">Paso <strong>1</strong> de 6</span>
+            <div class="topbar-progress">
+                <div class="progress-pip" data-pip="0"></div>
+                <div class="progress-pip" data-pip="1"></div>
+                <div class="progress-pip" data-pip="2"></div>
+                <div class="progress-pip" data-pip="3"></div>
+                <div class="progress-pip" data-pip="4"></div>
+                <div class="progress-pip" data-pip="5"></div>
+                <div class="progress-pip" data-pip="6"></div>
             </div>
         </div>
 
-        <!-- Form Container -->
-        <div class="bg-white rounded-2xl shadow-xl p-8">
-            <form action="{{ route('install.run') }}" method="POST" id="installerForm">
-                @csrf
+        <div class="content-main">
+            <div class="pane-header">
+                <h1 id="paneTitle">Licencia</h1>
+                <p id="paneDesc">Lee y acepta los términos de la GNU General Public License v3.0.</p>
+            </div>
 
-                <!-- Step 0: EULA -->
-                <div id="step0" class="step-content hidden">
-                    <div class="mb-6">
-                        <h2 class="text-2xl font-bold text-gray-900 mb-2">End User License Agreement (EULA)</h2>
-                        <p class="text-gray-600 text-sm mb-4">Please read and accept the EULA to continue the installation.</p>
-                        <div class="p-4 h-64 overflow-y-auto border border-gray-200 rounded-lg bg-gray-50 mb-4 text-sm text-gray-700">
-                            <p><strong>Last Updated: September 24, 2025</strong></p>
-                            <p><strong>1. Acceptance of Terms:</strong> By installing, copying, accessing, or using NexusCMS (“the Software”), you agree to be bound by this End User License Agreement (“EULA”). If you do not agree to these terms, do not install or use the Software.</p>
-                            <p><strong>2. License Grant:</strong> Subject to the terms of this EULA, NexusCMS grants you a non-exclusive, non-transferable, revocable license to use the Software for creating, managing, and maintaining websites or web applications. You may not redistribute, sublicense, sell, or modify the Software beyond what is permitted by the documentation.</p>
-                            <p><strong>3. Intellectual Property:</strong> The Software and all its components are the property of NexusCMS and protected by copyright, trademark, and other intellectual property laws. This EULA does not transfer ownership to you.</p>
-                            <p><strong>4. Restrictions:</strong> You may not reverse engineer, decompile, disassemble, remove proprietary notices, or use the Software for illegal activities.</p>
-                            <p><strong>5. User Data and Privacy:</strong> The Software may collect technical information required for functionality and updates. Collected data is not shared with third parties without consent. You are responsible for complying with privacy laws.</p>
-                            <p><strong>6. Updates and Upgrades:</strong> Updates or patches are subject to this EULA. NexusCMS is not obligated to provide updates or support.</p>
-                            <p><strong>7. Warranty Disclaimer:</strong> The Software is provided “AS IS” without warranties of any kind, express or implied.</p>
-                            <p><strong>8. Limitation of Liability:</strong> NexusCMS is not liable for any direct or indirect damages, loss of data, or business opportunities arising from use of the Software.</p>
-                            <p><strong>9. Indemnification:</strong> You agree to indemnify and hold harmless NexusCMS from any claims arising from your use of the Software or violation of this EULA.</p>
-                            <p><strong>10. Termination:</strong> This EULA terminates automatically upon violation of its terms. Upon termination, cease using the Software and destroy all copies.</p>
-                            <p><strong>11. Governing Law:</strong> This EULA is governed by the laws of Spain, and disputes shall be resolved in competent courts in Spain.</p>
-                            <p><strong>12. Miscellaneous:</strong> If any provision is unenforceable, the rest remain in effect. This EULA constitutes the entire agreement, and no waiver of any provision constitutes waiver of others.</p>
-                        </div>
-                        <div class="flex items-center">
-                            <input id="agree_eula" name="agree_eula" type="checkbox" required class="w-4 h-4 text-indigo-600 border-gray-300 rounded focus:ring-indigo-500">
-                            <label for="agree_eula" class="ml-2 text-sm font-medium text-gray-900"> I accept the EULA *</label>
-                        </div>
-                    </div>
+            @if($errors->any())
+                <div class="alert-error">
+                    <strong>No se pudo completar la instalación:</strong>
+                    <ul>
+                        @foreach($errors->all() as $error)
+                            <li>{{ $error }}</li>
+                        @endforeach
+                    </ul>
                 </div>
+            @endif
 
-                <!-- Step 1: Application Configuration -->
-                <div id="step1" class="step-content hidden">
-                    <div class="mb-6">
-                        <h2 class="text-2xl font-bold text-gray-900 mb-2">Application Configuration</h2>
-                        <p class="text-gray-600 text-sm">Configure the basic settings of your application</p>
-                    </div>
+            <form action="{{ route('install.run') }}" method="POST" id="installerForm" novalidate>
+                @csrf
 
-                    <div class="space-y-6">
-                        <div class="group">
-                            <label class="block text-sm font-medium text-gray-700 mb-2">Application Name</label>
-                            <input type="text" name="app_name" required class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-colors duration-200" placeholder="My Incredible Application">
+                {{-- Step 0: License & Requirements --}}
+                <div class="step-pane" data-pane="0">
+                    <div class="form-section">
+                        <div class="form-section-head">
+                            <h2>Acuerdo de licencia (EULA)</h2>
                         </div>
+                        <div class="form-section-body">
+                            <div class="license-text">
+                                <p><strong>NexusCMS</strong> es un proyecto de código abierto publicado bajo la <strong>GNU General Public License v3.0</strong> (GPL-3.0). Al continuar con la instalación confirmas que has leído y aceptas los términos de esta licencia.</p>
 
-                        <div class="group">
-                            <label class="block text-sm font-medium text-gray-700 mb-2">Application URL</label>
-                            <input type="url" name="app_url" required class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-colors duration-200" placeholder="https://myapp.com">
-                        </div>
+                                <p>El software se distribuye de forma gratuita y con plena libertad de uso. Puedes ejecutarlo para cualquier propósito, estudiar cómo funciona, adaptarlo a tus necesidades y redistribuir tanto la versión original como tus modificaciones. La única condición es que cualquier versión derivada que distribuyas públicamente debe conservar este mismo aviso de licencia y publicarse también bajo GPL-3.0, garantizando que los demás usuarios reciban las mismas libertades que tú tienes.</p>
+
+                                <p>El uso comercial está permitido sin coste adicional. Sin embargo, si decides distribuir una versión modificada de NexusCMS —ya sea de forma gratuita o de pago— estás obligado a hacer disponible el código fuente de tus cambios bajo la misma licencia. Esta condición es la base del modelo copyleft que protege el ecosistema de software libre.</p>
 
-                        <div class="group">
-                            <label class="block text-sm font-medium text-gray-700 mb-2">Application Language</label>
-                            <select name="locale" class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-colors duration-200">
-                                <option value="en">English</option>
-                                <option value="es">Spanish</option>
-                                <option value="fr">French</option>
-                                <option value="de">German</option>
-                            </select>
+                                <p>NexusCMS se entrega <em>tal cual</em>, sin ninguna garantía expresa ni implícita. Los autores y contribuidores no asumen responsabilidad por daños derivados del uso del software, interrupciones de servicio, pérdida de datos ni ninguna otra consecuencia directa o indirecta. La instalación y operación del sistema son responsabilidad exclusiva del administrador que realiza el despliegue, quien debe garantizar la seguridad del servidor, la protección de los datos de los usuarios y el cumplimiento de la normativa aplicable, incluyendo el Reglamento General de Protección de Datos (GDPR) u otras leyes de privacidad vigentes en su jurisdicción.</p>
+
+                                <p>Las contribuciones enviadas al repositorio oficial del proyecto —a través de pull requests, issues u otros medios— se considerarán licenciadas bajo GPL-3.0 salvo acuerdo escrito distinto. La comunidad de NexusCMS valora y agradece cada aportación, sea código, documentación, traducciones o informes de error.</p>
+
+                                <p>El texto íntegro de la GNU General Public License v3.0 está disponible en <em>https://www.gnu.org/licenses/gpl-3.0.html</em> y en el archivo <code>LICENSE</code> incluido en el repositorio del proyecto.</p>
+                            </div>
+                            <div class="checkbox-field" style="margin-top:14px;">
+                                <input type="checkbox" id="agree_eula" name="agree_eula" value="1" {{ old('agree_eula') ? 'checked' : '' }} required>
+                                <label for="agree_eula">He leído y acepto el acuerdo de licencia (EULA) para continuar con la instalación.</label>
+                            </div>
                         </div>
                     </div>
+
                 </div>
 
-                <!-- Step 2: Database Configuration -->
-                <div id="step2" class="step-content hidden">
-                    <div class="mb-6">
-                        <h2 class="text-2xl font-bold text-gray-900 mb-2">Database Configuration</h2>
-                        <p class="text-gray-600 text-sm">Configure the connection to your MySQL database</p>
+                {{-- Step 1: Requirements --}}
+                <div class="step-pane" data-pane="1">
+                    <div class="form-section">
+                        <div class="form-section-head">
+                            <h2>Requisitos del sistema</h2>
+                            @if($allRequirementsPassed)
+                                <span class="section-badge">Todo en orden</span>
+                            @else
+                                <span class="section-badge" style="background:#fff2f2;color:#991b1b;border-color:#fca5a5;">Hay fallos</span>
+                            @endif
+                        </div>
+                        <div class="form-section-body" style="padding:0;">
+                            <table class="req-table">
+                                <thead>
+                                    <tr>
+                                        <th>Requisito</th>
+                                        <th>Estado</th>
+                                        <th>Valor actual</th>
+                                    </tr>
+                                </thead>
+                                <tbody>
+                                    @foreach($requirements as $req)
+                                        <tr>
+                                            <td>{{ $req['label'] }}</td>
+                                            <td><span class="req-status {{ $req['ok'] ? 'ok' : 'err' }}">{!! $req['ok'] ? '&#10003; OK' : '&#10007; Fallo' !!}</span></td>
+                                            <td class="req-value">{{ $req['current'] }}</td>
+                                        </tr>
+                                    @endforeach
+                                </tbody>
+                            </table>
+                        </div>
                     </div>
+                </div>
 
-                    <div class="space-y-6">
-                        <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
-                            <div class="group">
-                                <label class="block text-sm font-medium text-gray-700 mb-2">Database Host</label>
-                                <input type="text" name="db_host" value="127.0.0.1" required class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-colors duration-200">
+                {{-- Step 2: App config --}}
+                <div class="step-pane" data-pane="1">
+                    <div class="form-section">
+                        <div class="form-section-head">
+                            <h2>Configuración general</h2>
+                        </div>
+                        <div class="form-section-body">
+                            <div class="field-row">
+                                <div class="field f-half">
+                                    <label for="app_name">Nombre de la aplicación</label>
+                                    <input type="text" id="app_name" name="app_name" value="{{ old('app_name', 'NexusCMS') }}" required>
+                                </div>
+                                <div class="field f-half">
+                                    <label for="app_url">URL base</label>
+                                    <input type="url" id="app_url" name="app_url" value="{{ old('app_url', url('/')) }}" required>
+                                    <span class="field-hint">Ej: https://misite.com &mdash; sin barra al final.</span>
+                                </div>
                             </div>
-
-                            <div class="group">
-                                <label class="block text-sm font-medium text-gray-700 mb-2">Database Port</label>
-                                <input type="number" name="db_port" value="3306" required class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-colors duration-200">
+                            <div class="field-row">
+                                <div class="field f-third">
+                                    <label for="locale">Idioma predeterminado</label>
+                                    <select id="locale" name="locale">
+                                        <option value="es" {{ old('locale', 'es') === 'es' ? 'selected' : '' }}>Español</option>
+                                        <option value="en" {{ old('locale') === 'en' ? 'selected' : '' }}>English</option>
+                                        <option value="fr" {{ old('locale') === 'fr' ? 'selected' : '' }}>Français</option>
+                                        <option value="de" {{ old('locale') === 'de' ? 'selected' : '' }}>Deutsch</option>
+                                    </select>
+                                </div>
                             </div>
                         </div>
+                    </div>
+                </div>
 
-                        <div class="group">
-                            <label class="block text-sm font-medium text-gray-700 mb-2">Database Name</label>
-                            <input type="text" name="db_name" required class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-colors duration-200" placeholder="my_application">
+                {{-- Step 2: Database --}}
+                <div class="step-pane" data-pane="2">
+                    <div class="form-section">
+                        <div class="form-section-head">
+                            <h2>Base de datos de NexusCMS</h2>
                         </div>
-
-                        <div class="group">
-                            <label class="block text-sm font-medium text-gray-700 mb-2">Database Username</label>
-                            <input type="text" name="db_username" required class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-colors duration-200" placeholder="root">
+                        <div class="form-section-body">
+                            <div class="field-row">
+                                <div class="field f-two">
+                                    <label for="db_host">Host</label>
+                                    <input type="text" id="db_host" name="db_host" value="{{ old('db_host', '127.0.0.1') }}" required>
+                                </div>
+                                <div class="field f-one">
+                                    <label for="db_port">Puerto</label>
+                                    <input type="number" id="db_port" name="db_port" min="1" max="65535" value="{{ old('db_port', 3306) }}" required>
+                                </div>
+                            </div>
+                            <div class="field-row">
+                                <div class="field f-third">
+                                    <label for="db_name">Nombre de la base de datos</label>
+                                    <input type="text" id="db_name" name="db_name" value="{{ old('db_name') }}" required>
+                                </div>
+                                <div class="field f-third">
+                                    <label for="db_username">Usuario</label>
+                                    <input type="text" id="db_username" name="db_username" value="{{ old('db_username') }}" required>
+                                </div>
+                                <div class="field f-third">
+                                    <label for="db_password">Contraseña</label>
+                                    <input type="password" id="db_password" name="db_password" value="{{ old('db_password') }}">
+                                </div>
+                            </div>
+                            <div class="db-test-row">
+                                <button type="button" class="btn btn-ghost" id="testConnection">Probar conexión</button>
+                                <span id="dbFeedback" class="db-feedback pending">Sin verificar</span>
+                            </div>
                         </div>
+                    </div>
+                </div>
 
-                        <div class="group">
-                            <label class="block text-sm font-medium text-gray-700 mb-2">Database Password</label>
-                            <input type="password" name="db_password" class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-colors duration-200" placeholder="••••••••">
+                {{-- Step 3: Admin account --}}
+                <div class="step-pane" data-pane="3">
+                    <div class="form-section">
+                        <div class="form-section-head">
+                            <h2>Cuenta administradora</h2>
                         </div>
-
-                        <!-- Test Connection Button -->
-                        <div class="bg-blue-50 border border-blue-200 rounded-lg p-4">
-                            <div class="flex items-center justify-between">
-                                <span class="text-sm text-blue-800">You can test the connection before continuing</span>
-                                <button type="button" id="testConnection" class="px-3 py-2 border border-blue-300 text-sm font-medium rounded-md text-blue-700 bg-white hover:bg-blue-50 transition-colors duration-200">Test Connection</button>
+                        <div class="form-section-body">
+                            <div class="field-row">
+                                <div class="field f-half">
+                                    <label for="admin_name">Nombre</label>
+                                    <input type="text" id="admin_name" name="admin_name" value="{{ old('admin_name') }}" required>
+                                </div>
+                                <div class="field f-half">
+                                    <label for="admin_email">Email</label>
+                                    <input type="email" id="admin_email" name="admin_email" value="{{ old('admin_email') }}" required>
+                                </div>
+                            </div>
+                            <div class="field-row">
+                                <div class="field f-half">
+                                    <label for="admin_password">Contraseña</label>
+                                    <input type="password" id="admin_password" name="admin_password" required>
+                                    <span class="field-hint">Mínimo 8 caracteres.</span>
+                                </div>
+                                <div class="field f-half">
+                                    <label for="admin_password_confirmation">Confirmar contraseña</label>
+                                    <input type="password" id="admin_password_confirmation" name="admin_password_confirmation" required>
+                                </div>
                             </div>
                         </div>
                     </div>
                 </div>
 
-                <!-- Step 3: Admin Account -->
-                <div id="step3" class="step-content hidden">
-                    <div class="mb-6">
-                        <h2 class="text-2xl font-bold text-gray-900 mb-2">Admin Account</h2>
-                        <p class="text-gray-600 text-sm">Create the main administrator account for your CMS.</p>
+                {{-- Step 4: First realm --}}
+                <div class="step-pane" data-pane="4">
+                    <div class="form-section">
+                        <div class="form-section-head">
+                            <h2>Configuración del realm</h2>
+                        </div>
+                        <div class="form-section-body">
+                            <div class="field-row">
+                                <div class="field f-third">
+                                    <label for="realm_name">Nombre del reino</label>
+                                    <input type="text" id="realm_name" name="realm_name" value="{{ old('realm_name', 'Realm #1') }}" required>
+                                </div>
+                                <div class="field f-third">
+                                    <label for="realm_hostname">Hostname</label>
+                                    <input type="text" id="realm_hostname" name="realm_hostname" value="{{ old('realm_hostname', '127.0.0.1') }}" required>
+                                </div>
+                                <div class="field f-one">
+                                    <label for="realm_port">Puerto</label>
+                                    <input type="number" id="realm_port" name="realm_port" min="1" max="65535" value="{{ old('realm_port', 8085) }}" required>
+                                </div>
+                            </div>
+                            <div class="field-row">
+                                <div class="field f-third">
+                                    <label for="realm_expansion">Expansión</label>
+                                    <select id="realm_expansion" name="realm_expansion" required>
+                                        @foreach($expansions as $expansionId => $expansionName)
+                                            <option value="{{ $expansionId }}" {{ (int) old('realm_expansion', $defaultExpansion) === (int) $expansionId ? 'selected' : '' }}>{{ $expansionName }}</option>
+                                        @endforeach
+                                    </select>
+                                </div>
+                                <div class="field f-third">
+                                    <label for="realm_emulator">Emulador</label>
+                                    <select id="realm_emulator" name="realm_emulator" required>
+                                        @foreach($emulators as $emulatorValue => $emulatorLabel)
+                                            <option value="{{ $emulatorValue }}" {{ old('realm_emulator', $defaultEmulator) === $emulatorValue ? 'selected' : '' }}>{{ $emulatorLabel }}</option>
+                                        @endforeach
+                                    </select>
+                                </div>
+                                <div class="field f-third">
+                                    <label for="realm_console_urn">URN de consola</label>
+                                    <select id="realm_console_urn" name="realm_console_urn" required>
+                                        @foreach($emulatorUrns as $emulatorValue => $urnValue)
+                                            <option value="{{ $urnValue }}" {{ old('realm_console_urn') === $urnValue ? 'selected' : '' }}>{{ $emulators[$emulatorValue] ?? $emulatorValue }} ({{ $urnValue }})</option>
+                                        @endforeach
+                                    </select>
+                                </div>
+                            </div>
+                            <div class="checkbox-field" style="margin-top:8px;">
+                                <input type="checkbox" id="realm_bnet" name="realm_bnet" value="1" {{ old('realm_bnet') ? 'checked' : '' }}>
+                                <label for="realm_bnet">Habilitar autenticación Battle.net para este reino</label>
+                            </div>
+                        </div>
                     </div>
 
-                    <div class="space-y-6">
-                        <div class="group">
-                            <label class="block text-sm font-medium text-gray-700 mb-2">Admin Name</label>
-                            <input type="text" name="admin_name" required
-                                class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-colors duration-200"
-                                placeholder="John Doe">
+                    <div class="form-section">
+                        <div class="form-section-head">
+                            <h2>Consola remota</h2>
+                            <span class="section-badge optional">SOAP / RA</span>
                         </div>
-
-                        <div class="group">
-                            <label class="block text-sm font-medium text-gray-700 mb-2">Admin Email</label>
-                            <input type="email" name="admin_email" required
-                                class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-colors duration-200"
-                                placeholder="admin@example.com">
+                        <div class="form-section-body">
+                            <div class="field-row">
+                                <div class="field f-two">
+                                    <label for="realm_console_hostname">Host</label>
+                                    <input type="text" id="realm_console_hostname" name="realm_console_hostname" value="{{ old('realm_console_hostname', '127.0.0.1') }}" required>
+                                </div>
+                                <div class="field f-one">
+                                    <label for="realm_console_port">Puerto</label>
+                                    <input type="number" id="realm_console_port" name="realm_console_port" min="1" max="65535" value="{{ old('realm_console_port', 3443) }}">
+                                </div>
+                            </div>
+                            <div class="field-row">
+                                <div class="field f-half">
+                                    <label for="realm_console_username">Usuario</label>
+                                    <input type="text" id="realm_console_username" name="realm_console_username" value="{{ old('realm_console_username') }}" required>
+                                </div>
+                                <div class="field f-half">
+                                    <label for="realm_console_password">Contraseña</label>
+                                    <input type="password" id="realm_console_password" name="realm_console_password" value="{{ old('realm_console_password') }}" required>
+                                </div>
+                            </div>
                         </div>
+                    </div>
 
-                        <div class="group">
-                            <label class="block text-sm font-medium text-gray-700 mb-2">Password</label>
-                            <input type="password" name="admin_password" required
-                                class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-colors duration-200"
-                                placeholder="••••••••">
-                        </div>
+                    @php
+                        $dbSections = [
+                            'realm_auth'       => 'Auth DB',
+                            'realm_characters' => 'Characters DB',
+                            'realm_world'      => 'World DB',
+                        ];
+                    @endphp
 
-                        <div class="group">
-                            <label class="block text-sm font-medium text-gray-700 mb-2">Confirm Password</label>
-                            <input type="password" name="admin_password_confirmation" required
-                                class="w-full px-4 py-3 border-2 border-gray-300 rounded-lg focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-colors duration-200"
-                                placeholder="••••••••">
+                    @foreach($dbSections as $key => $sectionLabel)
+                        <div class="form-section">
+                            <div class="form-section-head">
+                                <h2>{{ $sectionLabel }}</h2>
+                            </div>
+                            <div class="form-section-body">
+                                <div class="field-row">
+                                    <div class="field f-two">
+                                        <label for="{{ $key }}_host">Host</label>
+                                        <input type="text" id="{{ $key }}_host" name="{{ $key }}[host]" value="{{ old($key . '.host', '127.0.0.1') }}" required>
+                                    </div>
+                                    <div class="field f-one">
+                                        <label for="{{ $key }}_port">Puerto</label>
+                                        <input type="number" id="{{ $key }}_port" name="{{ $key }}[port]" min="1" max="65535" value="{{ old($key . '.port', 3306) }}">
+                                    </div>
+                                </div>
+                                <div class="field-row">
+                                    <div class="field f-third">
+                                        <label for="{{ $key }}_database">Base de datos</label>
+                                        <input type="text" id="{{ $key }}_database" name="{{ $key }}[database]" value="{{ old($key . '.database') }}" required>
+                                    </div>
+                                    <div class="field f-third">
+                                        <label for="{{ $key }}_username">Usuario</label>
+                                        <input type="text" id="{{ $key }}_username" name="{{ $key }}[username]" value="{{ old($key . '.username') }}" required>
+                                    </div>
+                                    <div class="field f-third">
+                                        <label for="{{ $key }}_password">Contraseña</label>
+                                        <input type="password" id="{{ $key }}_password" name="{{ $key }}[password]" value="{{ old($key . '.password') }}" required>
+                                    </div>
+                                    <div class="field f-half">
+                                        <label for="{{ $key }}_charset">Charset</label>
+                                        <input type="text" id="{{ $key }}_charset" name="{{ $key }}[charset]" value="{{ old($key . '.charset', 'utf8mb4') }}">
+                                    </div>
+                                    <div class="field f-half">
+                                        <label for="{{ $key }}_collation">Collation</label>
+                                        <input type="text" id="{{ $key }}_collation" name="{{ $key }}[collation]" value="{{ old($key . '.collation', 'utf8mb4_unicode_ci') }}">
+                                    </div>
+                                </div>
+                            </div>
                         </div>
-                    </div>
+                    @endforeach
                 </div>
 
-                <!-- Step 4: Installation -->
-                <div id="step4" class="step-content hidden text-center">
-                    <h2 class="text-2xl font-bold text-gray-900 mb-2">Installation</h2>
-                    <p class="text-gray-600 mb-6">Ready to run the installer. Click <strong>Install</strong> to finish setup.</p>
-                    <div class="bg-gray-50 p-4 rounded-lg border border-gray-200">
-                        <p class="text-sm text-gray-700">Review your settings and click <strong>Install</strong> to proceed.</p>
+                {{-- Step 5: Confirm --}}
+                <div class="step-pane" data-pane="5">
+                    <div class="form-section">
+                        <div class="form-section-head">
+                            <h2>Resumen de la instalación</h2>
+                        </div>
+                        <div class="form-section-body">
+                            <ul class="checklist">
+                                <li>Se escribirá el archivo <code>.env</code> con la configuración de entorno.</li>
+                                <li>Se ejecutarán las migraciones de base de datos y los seeders iniciales.</li>
+                                <li>Se creará la cuenta administradora con el rol Admin.</li>
+                                <li>Se registrará el primer reino con sus bases de datos.</li>
+                                <li>Se generará la clave de aplicación y se optimizarán las cachés.</li>
+                                <li>Se creará el archivo <code>storage/installed.lock</code> para bloquear el asistente.</li>
+                            </ul>
+                            <div class="checkbox-field" style="margin-top:18px; padding-top:16px; border-top:1px solid #edf0f5;">
+                                <input type="checkbox" id="confirm_apply" required>
+                                <label for="confirm_apply">Confirmo que los datos introducidos son correctos y quiero iniciar la instalación.</label>
+                            </div>
+                        </div>
                     </div>
                 </div>
 
-                <!-- Hidden inputs -->
-                <input type="hidden" name="db_connection" value="mysql">
-
-                <!-- Navigation Buttons -->
-                <div class="flex justify-between pt-6 border-t border-gray-200">
-                    <button type="button" id="prevBtn" class="px-6 py-3 text-gray-600 hover:text-gray-800 font-medium transition-colors duration-200 hidden">Previous ←</button>
-                    <div class="flex-1"></div>
-                    <button type="button" id="nextBtn" class="px-6 py-3 bg-indigo-600 text-white font-medium rounded-lg hover:bg-indigo-700 transition-colors duration-200">Next →</button>
-                    <button type="submit" id="installBtn" class="px-6 py-3 bg-green-600 text-white font-medium rounded-lg hover:bg-green-700 transition-colors duration-200 hidden">Install</button>
-                </div>
             </form>
         </div>
+
+        <div class="content-footer">
+            <div class="footer-left">
+                <button type="button" class="btn btn-ghost" id="prevBtn">&#8592; Anterior</button>
+            </div>
+            <div class="footer-right">
+                <button type="button" class="btn btn-primary" id="nextBtn">Siguiente &#8594;</button>
+                <button type="submit" form="installerForm" class="btn btn-success" id="installBtn">Instalar NexusCMS</button>
+            </div>
+        </div>
     </div>
 
-    <!-- Stepper Script -->
-    <script>
-        const installerApp = document.getElementById('installerApp');
-        const defaultStep = 0;
-        const stepAttr = installerApp.dataset.step;
-        let currentStep = Number(stepAttr) || defaultStep;
-
-        const stepContents = Array.from(document.querySelectorAll('.step-content'));
-        const indicators = Array.from(document.querySelectorAll('[id$="-indicator"]'));
-        const progressBars = Array.from(document.querySelectorAll('[id^="progress-bar-"]'));
-        const totalSteps = stepContents.length;
-
-        const updateIndicators = (step) => {
-            indicators.forEach((ind, i) => {
-                const s = i;
-                ind.classList.toggle('bg-blue-500', s === step);
-                ind.classList.toggle('text-white', s === step);
-                ind.classList.toggle('bg-gray-300', s !== step);
-                ind.classList.toggle('text-gray-600', s !== step);
-
-                const text = document.getElementById('step'+s+'-text');
-                if (text) {
-                    text.classList.toggle('text-blue-600', s === step);
-                    text.classList.toggle('text-gray-400', s !== step);
-                }
-            });
+</div>
 
-            progressBars.forEach((bar, i) => {
-                const s = i;
-                bar.classList.toggle('bg-blue-500', step > s);
-                bar.classList.toggle('bg-gray-300', step <= s);
-            });
-        };
-
-        const showStep = (step) => {
-            step = Math.max(0, Math.min(step, totalSteps - 1));
-            stepContents.forEach(el => el.classList.add('hidden'));
-            const content = document.getElementById('step' + step);
-            if (content) content.classList.remove('hidden');
-
-            document.getElementById('prevBtn').style.display = step === 0 ? 'none' : 'inline-flex';
-            document.getElementById('nextBtn').style.display = step === totalSteps - 1 ? 'none' : 'inline-flex';
-            document.getElementById('installBtn').style.display = step === totalSteps - 1 ? 'inline-flex' : 'none';
-
-            updateIndicators(step);
-            currentStep = step;
-        };
-
-        document.getElementById('nextBtn').addEventListener('click', () => {
-            if(currentStep === 0) {
-                const eulaChecked = document.getElementById('agree_eula').checked;
-                if(!eulaChecked) {
-                    alert('You must accept the EULA to continue.');
-                    return;
-                }
-            }
-            if (currentStep < totalSteps - 1) showStep(currentStep + 1);
+<script>
+    const requirementsPassed = @json($allRequirementsPassed);
+
+    const stepMeta = [
+        { title: 'Licencia',                        desc: 'Lee y acepta los términos de la GNU General Public License v3.0.' },
+        { title: 'Requisitos del sistema',          desc: 'Verifica que el entorno cumpla los requisitos mínimos para instalar NexusCMS.' },
+        { title: 'Configuración de la aplicación', desc: 'Nombre público, URL base e idioma predeterminado del CMS.' },
+        { title: 'Base de datos principal',         desc: 'Conexión que usará Laravel para las migraciones y datos del CMS.' },
+        { title: 'Cuenta administradora',           desc: 'Credenciales del primer usuario con permisos de administración.' },
+        { title: 'Primer reino',                    desc: 'Datos del realm, consola remota y conexiones Auth / Characters / World.' },
+        { title: 'Confirmación final',              desc: 'Revisa el resumen y ejecuta la instalación.' },
+    ];
+
+    const sidebarSteps = Array.from(document.querySelectorAll('.sidebar-step'));
+    const panes        = Array.from(document.querySelectorAll('.step-pane'));
+    const pips         = Array.from(document.querySelectorAll('.progress-pip'));
+    const paneTitle    = document.getElementById('paneTitle');
+    const paneDesc     = document.getElementById('paneDesc');
+    const breadcrumb   = document.getElementById('topbarBreadcrumb');
+    const nextBtn      = document.getElementById('nextBtn');
+    const prevBtn      = document.getElementById('prevBtn');
+    const installBtn   = document.getElementById('installBtn');
+    const form         = document.getElementById('installerForm');
+    const dbFeedback   = document.getElementById('dbFeedback');
+    const testConnBtn  = document.getElementById('testConnection');
+    const emulatorSel  = document.getElementById('realm_emulator');
+    const urnSel       = document.getElementById('realm_console_urn');
+
+    let currentStep = 0;
+
+    function updateWizard() {
+        sidebarSteps.forEach((item, i) => {
+            item.classList.toggle('is-current', i === currentStep);
+            item.classList.toggle('is-done', i < currentStep);
         });
 
-        document.getElementById('prevBtn').addEventListener('click', () => {
-            if (currentStep > 0) showStep(currentStep - 1);
+        panes.forEach((pane, i) => {
+            pane.classList.toggle('current', i === currentStep);
         });
 
-        document.getElementById('testConnection').addEventListener('click', function () {
-            let form = document.getElementById('installerForm');
-            let formData = new FormData(form);
+        pips.forEach((pip, i) => {
+            pip.classList.remove('done', 'active');
+            if (i < currentStep)   pip.classList.add('done');
+            if (i === currentStep) pip.classList.add('active');
+        });
+
+        const meta = stepMeta[currentStep];
+        paneTitle.textContent = meta.title;
+        paneDesc.textContent  = meta.desc;
+        breadcrumb.innerHTML  = 'Paso <strong>' + (currentStep + 1) + '</strong> de ' + panes.length;
+
+        prevBtn.style.visibility = currentStep === 0 ? 'hidden' : 'visible';
+        const isLast = currentStep === panes.length - 1;
+        nextBtn.style.display    = isLast ? 'none'        : 'inline-flex';
+        installBtn.style.display = isLast ? 'inline-flex' : 'none';
+    }
+
+    function validateCurrentStep() {
+        const pane = panes[currentStep];
+        if (!pane) return true;
+
+        if (currentStep === 1 && !requirementsPassed) {
+            alert('No puedes continuar hasta resolver los requisitos del sistema marcados como Fallo.');
+            return false;
+        }
+
+        const required = pane.querySelectorAll('input[required], select[required]');
+        for (const field of required) {
+            if (field.type === 'checkbox') {
+                if (!field.checked) {
+                    field.focus();
+                    alert('Debes marcar el checkbox obligatorio de este paso para continuar.');
+                    return false;
+                }
+                continue;
+            }
+            if (!field.value.trim()) {
+                field.focus();
+                alert('Completa todos los campos obligatorios antes de continuar.');
+                return false;
+            }
+        }
+
+        if (currentStep === 4) {
+            const pass = document.getElementById('admin_password').value;
+            const conf = document.getElementById('admin_password_confirmation').value;
+            if (pass.length < 8) {
+                alert('La contraseña debe tener al menos 8 caracteres.');
+                return false;
+            }
+            if (pass !== conf) {
+                alert('Las contraseñas no coinciden.');
+                return false;
+            }
+        }
+
+        if (currentStep === panes.length - 1) {
+            const chk = document.getElementById('confirm_apply');
+            if (chk && !chk.checked) {
+                alert('Debes marcar la casilla de confirmación para ejecutar la instalación.');
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    nextBtn.addEventListener('click', () => {
+        if (!validateCurrentStep()) return;
+        if (currentStep < panes.length - 1) {
+            currentStep++;
+            updateWizard();
+            window.scrollTo(0, 0);
+        }
+    });
+
+    prevBtn.addEventListener('click', () => {
+        if (currentStep > 0) {
+            currentStep--;
+            updateWizard();
+            window.scrollTo(0, 0);
+        }
+    });
 
-            fetch('{{ route("install.testDb") }}', {
+    testConnBtn.addEventListener('click', async () => {
+        dbFeedback.textContent = 'Probando conexión\u2026';
+        dbFeedback.className   = 'db-feedback pending';
+        try {
+            const body = new FormData(form);
+            const res  = await fetch('{{ route("install.testDb") }}', {
                 method: 'POST',
-                headers: {'X-CSRF-TOKEN': '{{ csrf_token() }}'},
-                body: formData
-            })
-            .then(res => res.json())
-            .then(data => alert(data.message))
-            .catch(err => alert('Error testing the connection'));
-        });
+                headers: { 'X-CSRF-TOKEN': '{{ csrf_token() }}', 'Accept': 'application/json' },
+                body,
+            });
+            const data = await res.json();
+            dbFeedback.textContent = data.message || (data.success ? 'Conexión exitosa' : 'Error de conexión');
+            dbFeedback.className   = 'db-feedback ' + (data.success ? 'ok' : 'err');
+        } catch {
+            dbFeedback.textContent = 'No se pudo contactar con el servidor.';
+            dbFeedback.className   = 'db-feedback err';
+        }
+    });
 
-        document.addEventListener('DOMContentLoaded', () => {
-            showStep(currentStep);
-        });
-    </script>
+    emulatorSel.addEventListener('change', () => {
+        const val   = emulatorSel.value;
+        const match = Array.from(urnSel.options).find(o => o.value === val);
+        if (match) urnSel.value = val;
+    });
+
+    form.addEventListener('submit', (e) => {
+        currentStep = panes.length - 1;
+        if (!validateCurrentStep()) {
+            e.preventDefault();
+            updateWizard();
+            return;
+        }
+        installBtn.disabled    = true;
+        installBtn.textContent = 'Instalando\u2026';
+    });
+
+    updateWizard();
+</script>
 </body>
-</html>
+</html>
\ No newline at end of file
diff --git a/resources/views/install/success.blade.php b/resources/views/install/success.blade.php
index 28c7635..8f423fa 100644
--- a/resources/views/install/success.blade.php
+++ b/resources/views/install/success.blade.php
@@ -1,29 +1,111 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="es">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>Installation Successful - NexusCMS</title>
-    <script src="https://cdn.tailwindcss.com"></script>
+    <style>
+        :root {
+            --bg-1: #071427;
+            --bg-2: #0e2b45;
+            --ok-1: #047857;
+            --ok-2: #22c55e;
+            --card: #f8fbff;
+            --ink: #0f1f3b;
+            --muted: #4f6280;
+        }
+
+        * {
+            box-sizing: border-box;
+        }
+
+        body {
+            margin: 0;
+            min-height: 100vh;
+            display: grid;
+            place-items: center;
+            font-family: "Segoe UI", "Trebuchet MS", sans-serif;
+            background:
+                radial-gradient(circle at 18% 22%, rgba(14, 165, 233, 0.28), transparent 35%),
+                radial-gradient(circle at 78% 20%, rgba(34, 197, 94, 0.22), transparent 35%),
+                linear-gradient(145deg, var(--bg-1), var(--bg-2));
+            padding: 18px;
+        }
+
+        .card {
+            width: min(720px, 100%);
+            background: var(--card);
+            color: var(--ink);
+            border-radius: 22px;
+            padding: 28px;
+            box-shadow: 0 26px 60px rgba(1, 10, 24, 0.45);
+            border: 1px solid rgba(208, 229, 249, 0.9);
+        }
+
+        .icon {
+            width: 78px;
+            height: 78px;
+            border-radius: 50%;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            margin-bottom: 14px;
+            background: linear-gradient(145deg, var(--ok-1), var(--ok-2));
+            color: #fff;
+        }
+
+        h1 {
+            margin: 0;
+            font-size: clamp(1.5rem, 3vw, 2rem);
+        }
+
+        p {
+            color: var(--muted);
+            margin-top: 10px;
+            line-height: 1.5;
+        }
+
+        .actions {
+            margin-top: 20px;
+            display: flex;
+            gap: 10px;
+            flex-wrap: wrap;
+        }
+
+        .btn {
+            border-radius: 10px;
+            text-decoration: none;
+            font-weight: 700;
+            padding: 11px 16px;
+            font-size: 0.88rem;
+            border: 1px solid transparent;
+        }
+
+        .btn-primary {
+            color: #fff;
+            background: linear-gradient(135deg, #0f766e, #0ea5e9);
+        }
+
+        .btn-secondary {
+            color: #175188;
+            background: #dceeff;
+            border-color: #b5d9fb;
+        }
+    </style>
 </head>
-<body class="bg-gradient-to-br from-blue-50 to-indigo-100 min-h-screen flex items-center justify-center">
-    <div class="bg-white rounded-2xl shadow-xl p-8 max-w-lg text-center">
-        <div class="mb-6">
-            <svg class="w-16 h-16 text-green-500 mx-auto mb-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
-                      d="M5 13l4 4L19 7"/>
+<body>
+    <div class="card">
+        <div class="icon">
+            <svg width="40" height="40" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"/>
             </svg>
-            <h1 class="text-3xl font-bold text-gray-900 mb-2">Installation Successful!</h1>
-            <p class="text-gray-600">Your NexusCMS installation is complete. You can now log in with your administrator account.</p>
         </div>
-        <a href="{{ url('/') }}" 
-           class="mt-4 inline-block px-6 py-3 bg-indigo-600 text-white font-medium rounded-lg hover:bg-indigo-700 transition-colors duration-200">
-           Go to Homepage
-        </a>
-        <a href="{{ route('login') }}" 
-           class="mt-4 inline-block px-6 py-3 text-indigo-600 border border-indigo-600 font-medium rounded-lg hover:bg-indigo-50 transition-colors duration-200 ml-2">
-           Log In
-        </a>
+        <h1>Instalación completada</h1>
+        <p>{{ session('install_success_message', 'NexusCMS está listo para usarse. Ya puedes iniciar sesión con la cuenta administradora y continuar con la configuración desde el panel.') }}</p>
+        <div class="actions">
+            <a href="{{ url('/') }}" class="btn btn-primary">Ir al inicio</a>
+            <a href="{{ route('login') }}" class="btn btn-secondary">Iniciar sesión</a>
+        </div>
     </div>
 </body>
 </html>
diff --git a/routes/web.php b/routes/web.php
index 0e541c8..ebb3280 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -12,13 +12,11 @@
 Route::get('/', [HomeController::class, 'index'])->middleware(['track.analytics'])->name('home');
 Route::get('/howtoplay', [HomeController::class, 'howToPlay'])->middleware(['track.analytics'])->name('howtoplay');
 
-Route::middleware([])->group(function () {
-    if (!file_exists(storage_path('installed.lock'))) {
-        Route::get('/install', [InstallController::class, 'index'])->name('install.index');
-        Route::get('/install/success', [InstallController::class, 'success'])->name('install.success');
-        Route::post('/install', [InstallController::class, 'install'])->name('install.run');
-        Route::post('/install/test-db', [InstallController::class, 'testDb'])->name('install.testDb');
-    }
+Route::middleware(['install.available'])->group(function () {
+    Route::get('/install', [InstallController::class, 'index'])->name('install.index');
+    Route::get('/install/success', [InstallController::class, 'success'])->name('install.success');
+    Route::post('/install', [InstallController::class, 'install'])->name('install.run');
+    Route::post('/install/test-db', [InstallController::class, 'testDb'])->name('install.testDb');
 });
 
 Route::prefix('news')->middleware(['track.analytics'])->group(function () {

From 00ddf2d58e4334f218dee9444715591ab14d3215 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 30 Apr 2026 17:26:57 +0200
Subject: [PATCH 102/132] fix(install): enhance installation process with
 improved lock file handling.

Co-authored-by: Copilot <copilot@github.com>
---
 .../Frontend/InstallController.php            |   9 +-
 .../Middleware/EnsureInstallerIsAvailable.php |   4 +-
 app/Providers/AppServiceProvider.php          |   4 +-
 app/Providers/ModuleServiceProvider.php       |   4 +-
 resources/views/install/index.blade.php       | 194 +++++++++---------
 5 files changed, 114 insertions(+), 101 deletions(-)

diff --git a/app/Http/Controllers/Frontend/InstallController.php b/app/Http/Controllers/Frontend/InstallController.php
index 4b2b387..2b99981 100644
--- a/app/Http/Controllers/Frontend/InstallController.php
+++ b/app/Http/Controllers/Frontend/InstallController.php
@@ -78,7 +78,14 @@ public function install(Request $request)
                 ->withErrors(['install' => 'No se pudo completar la instalación: ' . $exception->getMessage()]);
         }
 
-        file_put_contents(storage_path('installed.lock'), now());
+        $lockContent = now()->toDateTimeString();
+
+        $installerLockWritten = file_put_contents(storage_path('installer.lock'), $lockContent, LOCK_EX);
+        $legacyLockWritten = file_put_contents(storage_path('installed.lock'), $lockContent, LOCK_EX);
+
+        if ($installerLockWritten === false && $legacyLockWritten === false) {
+            throw new \RuntimeException('Unable to create installation lock file.');
+        }
 
         return redirect()
             ->route('install.success')
diff --git a/app/Http/Middleware/EnsureInstallerIsAvailable.php b/app/Http/Middleware/EnsureInstallerIsAvailable.php
index 116cbd6..7dc1b29 100644
--- a/app/Http/Middleware/EnsureInstallerIsAvailable.php
+++ b/app/Http/Middleware/EnsureInstallerIsAvailable.php
@@ -10,7 +10,9 @@ class EnsureInstallerIsAvailable
 {
     public function handle(Request $request, Closure $next): Response
     {
-        if (file_exists(storage_path('installed.lock'))) {
+        $isInstalled = file_exists(storage_path('installer.lock')) || file_exists(storage_path('installed.lock'));
+
+        if ($isInstalled) {
             if ($request->routeIs('install.success') && $request->session()->has('install_completed')) {
                 return $next($request);
             }
diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php
index 1b43a8d..11b9f2e 100755
--- a/app/Providers/AppServiceProvider.php
+++ b/app/Providers/AppServiceProvider.php
@@ -44,7 +44,9 @@ public function register(): void
 
     public function boot(): void
     {
-        if (!file_exists(storage_path('installed.lock'))) {
+        $isInstalled = file_exists(storage_path('installer.lock')) || file_exists(storage_path('installed.lock'));
+
+        if (!$isInstalled) {
             Config::set('session.driver', 'file');
             Config::set('cache.default', 'file');
             Config::set('queue.default', 'sync');
diff --git a/app/Providers/ModuleServiceProvider.php b/app/Providers/ModuleServiceProvider.php
index 3a3d72a..65b91d5 100644
--- a/app/Providers/ModuleServiceProvider.php
+++ b/app/Providers/ModuleServiceProvider.php
@@ -16,7 +16,9 @@ public function register(): void
 
     public function boot(): void
     {
-        if (!file_exists(storage_path('installed.lock'))) {
+        $isInstalled = file_exists(storage_path('installer.lock')) || file_exists(storage_path('installed.lock'));
+
+        if (!$isInstalled) {
             $this->app->setLocale(config('app.locale', 'en'));
 
             return;
diff --git a/resources/views/install/index.blade.php b/resources/views/install/index.blade.php
index 3f9ce5a..59b5378 100644
--- a/resources/views/install/index.blade.php
+++ b/resources/views/install/index.blade.php
@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="es">
+<html lang="en">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
@@ -538,8 +538,8 @@
                     <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
                 </div>
                 <div class="step-info">
-                    <div class="step-label">Licencia</div>
-                    <div class="step-sub">EULA y requisitos</div>
+                    <div class="step-label">License</div>
+                    <div class="step-sub">EULA &amp; requirements</div>
                 </div>
             </div>
             <div class="sidebar-step" data-step="1">
@@ -548,8 +548,8 @@
                     <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
                 </div>
                 <div class="step-info">
-                    <div class="step-label">Requisitos</div>
-                    <div class="step-sub">Verificación del entorno</div>
+                    <div class="step-label">Requirements</div>
+                    <div class="step-sub">Environment check</div>
                 </div>
             </div>
             <div class="sidebar-step" data-step="2">
@@ -558,8 +558,8 @@
                     <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
                 </div>
                 <div class="step-info">
-                    <div class="step-label">Aplicación</div>
-                    <div class="step-sub">Nombre, URL e idioma</div>
+                    <div class="step-label">Application</div>
+                    <div class="step-sub">Name, URL &amp; language</div>
                 </div>
             </div>
             <div class="sidebar-step" data-step="3">
@@ -568,8 +568,8 @@
                     <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
                 </div>
                 <div class="step-info">
-                    <div class="step-label">Base de datos</div>
-                    <div class="step-sub">Conexión principal</div>
+                    <div class="step-label">Database</div>
+                    <div class="step-sub">Main connection</div>
                 </div>
             </div>
             <div class="sidebar-step" data-step="4">
@@ -578,8 +578,8 @@
                     <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
                 </div>
                 <div class="step-info">
-                    <div class="step-label">Administrador</div>
-                    <div class="step-sub">Cuenta inicial</div>
+                    <div class="step-label">Administrator</div>
+                    <div class="step-sub">Initial account</div>
                 </div>
             </div>
             <div class="sidebar-step" data-step="5">
@@ -588,8 +588,8 @@
                     <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
                 </div>
                 <div class="step-info">
-                    <div class="step-label">Primer reino</div>
-                    <div class="step-sub">Realm y consola</div>
+                    <div class="step-label">First Realm</div>
+                    <div class="step-sub">Realm &amp; console</div>
                 </div>
             </div>
             <div class="sidebar-step" data-step="6">
@@ -598,8 +598,8 @@
                     <svg class="step-check" width="13" height="13" viewBox="0 0 13 13" fill="none"><path d="M2.5 6.5l3 3 5-5" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/></svg>
                 </div>
                 <div class="step-info">
-                    <div class="step-label">Confirmación</div>
-                    <div class="step-sub">Resumen final</div>
+                    <div class="step-label">Confirmation</div>
+                    <div class="step-sub">Final summary</div>
                 </div>
             </div>
         </nav>
@@ -610,7 +610,7 @@
     {{-- Content --}}
     <div class="content">
         <div class="content-topbar">
-            <span class="topbar-breadcrumb" id="topbarBreadcrumb">Paso <strong>1</strong> de 6</span>
+            <span class="topbar-breadcrumb" id="topbarBreadcrumb">Step <strong>1</strong> of 6</span>
             <div class="topbar-progress">
                 <div class="progress-pip" data-pip="0"></div>
                 <div class="progress-pip" data-pip="1"></div>
@@ -624,13 +624,13 @@
 
         <div class="content-main">
             <div class="pane-header">
-                <h1 id="paneTitle">Licencia</h1>
-                <p id="paneDesc">Lee y acepta los términos de la GNU General Public License v3.0.</p>
+                <h1 id="paneTitle">License</h1>
+                <p id="paneDesc">Read and accept the terms of the GNU General Public License v3.0.</p>
             </div>
 
             @if($errors->any())
                 <div class="alert-error">
-                    <strong>No se pudo completar la instalación:</strong>
+                    <strong>Installation could not be completed:</strong>
                     <ul>
                         @foreach($errors->all() as $error)
                             <li>{{ $error }}</li>
@@ -646,25 +646,25 @@
                 <div class="step-pane" data-pane="0">
                     <div class="form-section">
                         <div class="form-section-head">
-                            <h2>Acuerdo de licencia (EULA)</h2>
+                            <h2>License Agreement (EULA)</h2>
                         </div>
                         <div class="form-section-body">
                             <div class="license-text">
-                                <p><strong>NexusCMS</strong> es un proyecto de código abierto publicado bajo la <strong>GNU General Public License v3.0</strong> (GPL-3.0). Al continuar con la instalación confirmas que has leído y aceptas los términos de esta licencia.</p>
+                                <p><strong>NexusCMS</strong> is an open-source project released under the <strong>GNU General Public License v3.0</strong> (GPL-3.0). By continuing with the installation you confirm that you have read and accept the terms of this license.</p>
 
-                                <p>El software se distribuye de forma gratuita y con plena libertad de uso. Puedes ejecutarlo para cualquier propósito, estudiar cómo funciona, adaptarlo a tus necesidades y redistribuir tanto la versión original como tus modificaciones. La única condición es que cualquier versión derivada que distribuyas públicamente debe conservar este mismo aviso de licencia y publicarse también bajo GPL-3.0, garantizando que los demás usuarios reciban las mismas libertades que tú tienes.</p>
+                                <p>The software is distributed free of charge and with full freedom of use. You may run it for any purpose, study how it works, adapt it to your needs, and redistribute both the original version and your modifications. The only condition is that any derivative version you publicly distribute must retain this same license notice and be published under GPL-3.0 as well, ensuring that other users receive the same freedoms that you have.</p>
 
-                                <p>El uso comercial está permitido sin coste adicional. Sin embargo, si decides distribuir una versión modificada de NexusCMS —ya sea de forma gratuita o de pago— estás obligado a hacer disponible el código fuente de tus cambios bajo la misma licencia. Esta condición es la base del modelo copyleft que protege el ecosistema de software libre.</p>
+                                <p>Commercial use is permitted at no additional cost. However, if you choose to distribute a modified version of NexusCMS — whether free of charge or for a fee — you are required to make the source code of your changes available under the same license. This condition is the foundation of the copyleft model that protects the free software ecosystem.</p>
 
-                                <p>NexusCMS se entrega <em>tal cual</em>, sin ninguna garantía expresa ni implícita. Los autores y contribuidores no asumen responsabilidad por daños derivados del uso del software, interrupciones de servicio, pérdida de datos ni ninguna otra consecuencia directa o indirecta. La instalación y operación del sistema son responsabilidad exclusiva del administrador que realiza el despliegue, quien debe garantizar la seguridad del servidor, la protección de los datos de los usuarios y el cumplimiento de la normativa aplicable, incluyendo el Reglamento General de Protección de Datos (GDPR) u otras leyes de privacidad vigentes en su jurisdicción.</p>
+                                <p>NexusCMS is delivered <em>as is</em>, without any express or implied warranty. The authors and contributors assume no responsibility for damages arising from the use of the software, service interruptions, data loss, or any other direct or indirect consequence. Installation and operation of the system are the sole responsibility of the administrator performing the deployment, who must ensure server security, user data protection, and compliance with applicable regulations, including the General Data Protection Regulation (GDPR) or other privacy laws in force in their jurisdiction.</p>
 
-                                <p>Las contribuciones enviadas al repositorio oficial del proyecto —a través de pull requests, issues u otros medios— se considerarán licenciadas bajo GPL-3.0 salvo acuerdo escrito distinto. La comunidad de NexusCMS valora y agradece cada aportación, sea código, documentación, traducciones o informes de error.</p>
+                                <p>Contributions submitted to the official project repository — via pull requests, issues, or other means — will be considered licensed under GPL-3.0 unless a different written agreement exists. The NexusCMS community values and appreciates every contribution, whether code, documentation, translations, or bug reports.</p>
 
-                                <p>El texto íntegro de la GNU General Public License v3.0 está disponible en <em>https://www.gnu.org/licenses/gpl-3.0.html</em> y en el archivo <code>LICENSE</code> incluido en el repositorio del proyecto.</p>
+                                <p>The full text of the GNU General Public License v3.0 is available at <em>https://www.gnu.org/licenses/gpl-3.0.html</em> and in the <code>LICENSE</code> file included in the project repository.</p>
                             </div>
                             <div class="checkbox-field" style="margin-top:14px;">
                                 <input type="checkbox" id="agree_eula" name="agree_eula" value="1" {{ old('agree_eula') ? 'checked' : '' }} required>
-                                <label for="agree_eula">He leído y acepto el acuerdo de licencia (EULA) para continuar con la instalación.</label>
+                                <label for="agree_eula">I have read and accept the license agreement (EULA) to proceed with the installation.</label>
                             </div>
                         </div>
                     </div>
@@ -675,27 +675,27 @@
                 <div class="step-pane" data-pane="1">
                     <div class="form-section">
                         <div class="form-section-head">
-                            <h2>Requisitos del sistema</h2>
+                            <h2>System Requirements</h2>
                             @if($allRequirementsPassed)
-                                <span class="section-badge">Todo en orden</span>
+                                <span class="section-badge">All good</span>
                             @else
-                                <span class="section-badge" style="background:#fff2f2;color:#991b1b;border-color:#fca5a5;">Hay fallos</span>
+                                <span class="section-badge" style="background:#fff2f2;color:#991b1b;border-color:#fca5a5;">Issues found</span>
                             @endif
                         </div>
                         <div class="form-section-body" style="padding:0;">
                             <table class="req-table">
                                 <thead>
                                     <tr>
-                                        <th>Requisito</th>
-                                        <th>Estado</th>
-                                        <th>Valor actual</th>
+                                        <th>Requirement</th>
+                                        <th>Status</th>
+                                        <th>Current value</th>
                                     </tr>
                                 </thead>
                                 <tbody>
                                     @foreach($requirements as $req)
                                         <tr>
                                             <td>{{ $req['label'] }}</td>
-                                            <td><span class="req-status {{ $req['ok'] ? 'ok' : 'err' }}">{!! $req['ok'] ? '&#10003; OK' : '&#10007; Fallo' !!}</span></td>
+                                            <td><span class="req-status {{ $req['ok'] ? 'ok' : 'err' }}">{!! $req['ok'] ? '&#10003; OK' : '&#10007; Fail' !!}</span></td>
                                             <td class="req-value">{{ $req['current'] }}</td>
                                         </tr>
                                     @endforeach
@@ -709,28 +709,28 @@
                 <div class="step-pane" data-pane="1">
                     <div class="form-section">
                         <div class="form-section-head">
-                            <h2>Configuración general</h2>
+                            <h2>General configuration</h2>
                         </div>
                         <div class="form-section-body">
                             <div class="field-row">
                                 <div class="field f-half">
-                                    <label for="app_name">Nombre de la aplicación</label>
+                                    <label for="app_name">Application name</label>
                                     <input type="text" id="app_name" name="app_name" value="{{ old('app_name', 'NexusCMS') }}" required>
                                 </div>
                                 <div class="field f-half">
-                                    <label for="app_url">URL base</label>
+                                    <label for="app_url">Base URL</label>
                                     <input type="url" id="app_url" name="app_url" value="{{ old('app_url', url('/')) }}" required>
-                                    <span class="field-hint">Ej: https://misite.com &mdash; sin barra al final.</span>
+                                    <span class="field-hint">E.g.: https://mysite.com &mdash; no trailing slash.</span>
                                 </div>
                             </div>
                             <div class="field-row">
                                 <div class="field f-third">
-                                    <label for="locale">Idioma predeterminado</label>
+                                    <label for="locale">Default language</label>
                                     <select id="locale" name="locale">
-                                        <option value="es" {{ old('locale', 'es') === 'es' ? 'selected' : '' }}>Español</option>
+                                        <option value="es" {{ old('locale', 'es') === 'es' ? 'selected' : '' }}>Spanish</option>
                                         <option value="en" {{ old('locale') === 'en' ? 'selected' : '' }}>English</option>
-                                        <option value="fr" {{ old('locale') === 'fr' ? 'selected' : '' }}>Français</option>
-                                        <option value="de" {{ old('locale') === 'de' ? 'selected' : '' }}>Deutsch</option>
+                                        <option value="fr" {{ old('locale') === 'fr' ? 'selected' : '' }}>French</option>
+                                        <option value="de" {{ old('locale') === 'de' ? 'selected' : '' }}>German</option>
                                     </select>
                                 </div>
                             </div>
@@ -742,7 +742,7 @@
                 <div class="step-pane" data-pane="2">
                     <div class="form-section">
                         <div class="form-section-head">
-                            <h2>Base de datos de NexusCMS</h2>
+                            <h2>NexusCMS Database</h2>
                         </div>
                         <div class="form-section-body">
                             <div class="field-row">
@@ -751,27 +751,27 @@
                                     <input type="text" id="db_host" name="db_host" value="{{ old('db_host', '127.0.0.1') }}" required>
                                 </div>
                                 <div class="field f-one">
-                                    <label for="db_port">Puerto</label>
+                                    <label for="db_port">Port</label>
                                     <input type="number" id="db_port" name="db_port" min="1" max="65535" value="{{ old('db_port', 3306) }}" required>
                                 </div>
                             </div>
                             <div class="field-row">
                                 <div class="field f-third">
-                                    <label for="db_name">Nombre de la base de datos</label>
+                                    <label for="db_name">Database name</label>
                                     <input type="text" id="db_name" name="db_name" value="{{ old('db_name') }}" required>
                                 </div>
                                 <div class="field f-third">
-                                    <label for="db_username">Usuario</label>
+                                    <label for="db_username">Username</label>
                                     <input type="text" id="db_username" name="db_username" value="{{ old('db_username') }}" required>
                                 </div>
                                 <div class="field f-third">
-                                    <label for="db_password">Contraseña</label>
+                                    <label for="db_password">Password</label>
                                     <input type="password" id="db_password" name="db_password" value="{{ old('db_password') }}">
                                 </div>
                             </div>
                             <div class="db-test-row">
-                                <button type="button" class="btn btn-ghost" id="testConnection">Probar conexión</button>
-                                <span id="dbFeedback" class="db-feedback pending">Sin verificar</span>
+                                <button type="button" class="btn btn-ghost" id="testConnection">Test connection</button>
+                                <span id="dbFeedback" class="db-feedback pending">Not verified</span>
                             </div>
                         </div>
                     </div>
@@ -781,12 +781,12 @@
                 <div class="step-pane" data-pane="3">
                     <div class="form-section">
                         <div class="form-section-head">
-                            <h2>Cuenta administradora</h2>
+                            <h2>Administrator account</h2>
                         </div>
                         <div class="form-section-body">
                             <div class="field-row">
                                 <div class="field f-half">
-                                    <label for="admin_name">Nombre</label>
+                                    <label for="admin_name">Name</label>
                                     <input type="text" id="admin_name" name="admin_name" value="{{ old('admin_name') }}" required>
                                 </div>
                                 <div class="field f-half">
@@ -796,12 +796,12 @@
                             </div>
                             <div class="field-row">
                                 <div class="field f-half">
-                                    <label for="admin_password">Contraseña</label>
+                                    <label for="admin_password">Password</label>
                                     <input type="password" id="admin_password" name="admin_password" required>
-                                    <span class="field-hint">Mínimo 8 caracteres.</span>
+                                    <span class="field-hint">Minimum 8 characters.</span>
                                 </div>
                                 <div class="field f-half">
-                                    <label for="admin_password_confirmation">Confirmar contraseña</label>
+                                    <label for="admin_password_confirmation">Confirm password</label>
                                     <input type="password" id="admin_password_confirmation" name="admin_password_confirmation" required>
                                 </div>
                             </div>
@@ -813,12 +813,12 @@
                 <div class="step-pane" data-pane="4">
                     <div class="form-section">
                         <div class="form-section-head">
-                            <h2>Configuración del realm</h2>
+                            <h2>Realm configuration</h2>
                         </div>
                         <div class="form-section-body">
                             <div class="field-row">
                                 <div class="field f-third">
-                                    <label for="realm_name">Nombre del reino</label>
+                                    <label for="realm_name">Realm name</label>
                                     <input type="text" id="realm_name" name="realm_name" value="{{ old('realm_name', 'Realm #1') }}" required>
                                 </div>
                                 <div class="field f-third">
@@ -826,13 +826,13 @@
                                     <input type="text" id="realm_hostname" name="realm_hostname" value="{{ old('realm_hostname', '127.0.0.1') }}" required>
                                 </div>
                                 <div class="field f-one">
-                                    <label for="realm_port">Puerto</label>
+                                    <label for="realm_port">Port</label>
                                     <input type="number" id="realm_port" name="realm_port" min="1" max="65535" value="{{ old('realm_port', 8085) }}" required>
                                 </div>
                             </div>
                             <div class="field-row">
                                 <div class="field f-third">
-                                    <label for="realm_expansion">Expansión</label>
+                                    <label for="realm_expansion">Expansion</label>
                                     <select id="realm_expansion" name="realm_expansion" required>
                                         @foreach($expansions as $expansionId => $expansionName)
                                             <option value="{{ $expansionId }}" {{ (int) old('realm_expansion', $defaultExpansion) === (int) $expansionId ? 'selected' : '' }}>{{ $expansionName }}</option>
@@ -840,7 +840,7 @@
                                     </select>
                                 </div>
                                 <div class="field f-third">
-                                    <label for="realm_emulator">Emulador</label>
+                                    <label for="realm_emulator">Emulator</label>
                                     <select id="realm_emulator" name="realm_emulator" required>
                                         @foreach($emulators as $emulatorValue => $emulatorLabel)
                                             <option value="{{ $emulatorValue }}" {{ old('realm_emulator', $defaultEmulator) === $emulatorValue ? 'selected' : '' }}>{{ $emulatorLabel }}</option>
@@ -848,7 +848,7 @@
                                     </select>
                                 </div>
                                 <div class="field f-third">
-                                    <label for="realm_console_urn">URN de consola</label>
+                                    <label for="realm_console_urn">Console URN</label>
                                     <select id="realm_console_urn" name="realm_console_urn" required>
                                         @foreach($emulatorUrns as $emulatorValue => $urnValue)
                                             <option value="{{ $urnValue }}" {{ old('realm_console_urn') === $urnValue ? 'selected' : '' }}>{{ $emulators[$emulatorValue] ?? $emulatorValue }} ({{ $urnValue }})</option>
@@ -858,14 +858,14 @@
                             </div>
                             <div class="checkbox-field" style="margin-top:8px;">
                                 <input type="checkbox" id="realm_bnet" name="realm_bnet" value="1" {{ old('realm_bnet') ? 'checked' : '' }}>
-                                <label for="realm_bnet">Habilitar autenticación Battle.net para este reino</label>
+                                <label for="realm_bnet">Enable Battle.net authentication for this realm</label>
                             </div>
                         </div>
                     </div>
 
                     <div class="form-section">
                         <div class="form-section-head">
-                            <h2>Consola remota</h2>
+                            <h2>Remote console</h2>
                             <span class="section-badge optional">SOAP / RA</span>
                         </div>
                         <div class="form-section-body">
@@ -875,17 +875,17 @@
                                     <input type="text" id="realm_console_hostname" name="realm_console_hostname" value="{{ old('realm_console_hostname', '127.0.0.1') }}" required>
                                 </div>
                                 <div class="field f-one">
-                                    <label for="realm_console_port">Puerto</label>
+                                    <label for="realm_console_port">Port</label>
                                     <input type="number" id="realm_console_port" name="realm_console_port" min="1" max="65535" value="{{ old('realm_console_port', 3443) }}">
                                 </div>
                             </div>
                             <div class="field-row">
                                 <div class="field f-half">
-                                    <label for="realm_console_username">Usuario</label>
+                                    <label for="realm_console_username">Username</label>
                                     <input type="text" id="realm_console_username" name="realm_console_username" value="{{ old('realm_console_username') }}" required>
                                 </div>
                                 <div class="field f-half">
-                                    <label for="realm_console_password">Contraseña</label>
+                                    <label for="realm_console_password">Password</label>
                                     <input type="password" id="realm_console_password" name="realm_console_password" value="{{ old('realm_console_password') }}" required>
                                 </div>
                             </div>
@@ -912,21 +912,21 @@
                                         <input type="text" id="{{ $key }}_host" name="{{ $key }}[host]" value="{{ old($key . '.host', '127.0.0.1') }}" required>
                                     </div>
                                     <div class="field f-one">
-                                        <label for="{{ $key }}_port">Puerto</label>
+                                        <label for="{{ $key }}_port">Port</label>
                                         <input type="number" id="{{ $key }}_port" name="{{ $key }}[port]" min="1" max="65535" value="{{ old($key . '.port', 3306) }}">
                                     </div>
                                 </div>
                                 <div class="field-row">
                                     <div class="field f-third">
-                                        <label for="{{ $key }}_database">Base de datos</label>
+                                        <label for="{{ $key }}_database">Database</label>
                                         <input type="text" id="{{ $key }}_database" name="{{ $key }}[database]" value="{{ old($key . '.database') }}" required>
                                     </div>
                                     <div class="field f-third">
-                                        <label for="{{ $key }}_username">Usuario</label>
+                                        <label for="{{ $key }}_username">Username</label>
                                         <input type="text" id="{{ $key }}_username" name="{{ $key }}[username]" value="{{ old($key . '.username') }}" required>
                                     </div>
                                     <div class="field f-third">
-                                        <label for="{{ $key }}_password">Contraseña</label>
+                                        <label for="{{ $key }}_password">Password</label>
                                         <input type="password" id="{{ $key }}_password" name="{{ $key }}[password]" value="{{ old($key . '.password') }}" required>
                                     </div>
                                     <div class="field f-half">
@@ -947,20 +947,20 @@
                 <div class="step-pane" data-pane="5">
                     <div class="form-section">
                         <div class="form-section-head">
-                            <h2>Resumen de la instalación</h2>
+                            <h2>Installation summary</h2>
                         </div>
                         <div class="form-section-body">
                             <ul class="checklist">
-                                <li>Se escribirá el archivo <code>.env</code> con la configuración de entorno.</li>
-                                <li>Se ejecutarán las migraciones de base de datos y los seeders iniciales.</li>
-                                <li>Se creará la cuenta administradora con el rol Admin.</li>
-                                <li>Se registrará el primer reino con sus bases de datos.</li>
-                                <li>Se generará la clave de aplicación y se optimizarán las cachés.</li>
-                                <li>Se creará el archivo <code>storage/installed.lock</code> para bloquear el asistente.</li>
+                                <li>The <code>.env</code> file will be written with the environment configuration.</li>
+                                <li>Database migrations and initial seeders will be executed.</li>
+                                <li>The administrator account will be created with the Admin role.</li>
+                                <li>The first realm will be registered with its databases.</li>
+                                <li>The application key will be generated and caches will be optimized.</li>
+                                <li>The <code>storage/installed.lock</code> file will be created to lock the wizard.</li>
                             </ul>
                             <div class="checkbox-field" style="margin-top:18px; padding-top:16px; border-top:1px solid #edf0f5;">
                                 <input type="checkbox" id="confirm_apply" required>
-                                <label for="confirm_apply">Confirmo que los datos introducidos son correctos y quiero iniciar la instalación.</label>
+                                <label for="confirm_apply">I confirm that the entered data is correct and I want to start the installation.</label>
                             </div>
                         </div>
                     </div>
@@ -971,11 +971,11 @@
 
         <div class="content-footer">
             <div class="footer-left">
-                <button type="button" class="btn btn-ghost" id="prevBtn">&#8592; Anterior</button>
+                <button type="button" class="btn btn-ghost" id="prevBtn">&#8592; Previous</button>
             </div>
             <div class="footer-right">
-                <button type="button" class="btn btn-primary" id="nextBtn">Siguiente &#8594;</button>
-                <button type="submit" form="installerForm" class="btn btn-success" id="installBtn">Instalar NexusCMS</button>
+                <button type="button" class="btn btn-primary" id="nextBtn">Next &#8594;</button>
+                <button type="submit" form="installerForm" class="btn btn-success" id="installBtn">Install NexusCMS</button>
             </div>
         </div>
     </div>
@@ -986,13 +986,13 @@
     const requirementsPassed = @json($allRequirementsPassed);
 
     const stepMeta = [
-        { title: 'Licencia',                        desc: 'Lee y acepta los términos de la GNU General Public License v3.0.' },
-        { title: 'Requisitos del sistema',          desc: 'Verifica que el entorno cumpla los requisitos mínimos para instalar NexusCMS.' },
-        { title: 'Configuración de la aplicación', desc: 'Nombre público, URL base e idioma predeterminado del CMS.' },
-        { title: 'Base de datos principal',         desc: 'Conexión que usará Laravel para las migraciones y datos del CMS.' },
-        { title: 'Cuenta administradora',           desc: 'Credenciales del primer usuario con permisos de administración.' },
-        { title: 'Primer reino',                    desc: 'Datos del realm, consola remota y conexiones Auth / Characters / World.' },
-        { title: 'Confirmación final',              desc: 'Revisa el resumen y ejecuta la instalación.' },
+        { title: 'License',              desc: 'Read and accept the terms of the GNU General Public License v3.0.' },
+        { title: 'System requirements',  desc: 'Verify that the environment meets the minimum requirements to install NexusCMS.' },
+        { title: 'App configuration',    desc: 'Public name, base URL and default language of the CMS.' },
+        { title: 'Main database',        desc: 'Connection that Laravel will use for migrations and CMS data.' },
+        { title: 'Administrator account',desc: 'Credentials for the first user with administration permissions.' },
+        { title: 'First realm',          desc: 'Realm data, remote console and Auth / Characters / World connections.' },
+        { title: 'Final confirmation',   desc: 'Review the summary and run the installation.' },
     ];
 
     const sidebarSteps = Array.from(document.querySelectorAll('.sidebar-step'));
@@ -1031,7 +1031,7 @@ function updateWizard() {
         const meta = stepMeta[currentStep];
         paneTitle.textContent = meta.title;
         paneDesc.textContent  = meta.desc;
-        breadcrumb.innerHTML  = 'Paso <strong>' + (currentStep + 1) + '</strong> de ' + panes.length;
+        breadcrumb.innerHTML  = 'Step <strong>' + (currentStep + 1) + '</strong> of ' + panes.length;
 
         prevBtn.style.visibility = currentStep === 0 ? 'hidden' : 'visible';
         const isLast = currentStep === panes.length - 1;
@@ -1044,7 +1044,7 @@ function validateCurrentStep() {
         if (!pane) return true;
 
         if (currentStep === 1 && !requirementsPassed) {
-            alert('No puedes continuar hasta resolver los requisitos del sistema marcados como Fallo.');
+            alert('You cannot proceed until the system requirements marked as Fail are resolved.');
             return false;
         }
 
@@ -1053,14 +1053,14 @@ function validateCurrentStep() {
             if (field.type === 'checkbox') {
                 if (!field.checked) {
                     field.focus();
-                    alert('Debes marcar el checkbox obligatorio de este paso para continuar.');
+                    alert('You must check the required checkbox on this step to continue.');
                     return false;
                 }
                 continue;
             }
             if (!field.value.trim()) {
                 field.focus();
-                alert('Completa todos los campos obligatorios antes de continuar.');
+                alert('Please fill in all required fields before continuing.');
                 return false;
             }
         }
@@ -1069,11 +1069,11 @@ function validateCurrentStep() {
             const pass = document.getElementById('admin_password').value;
             const conf = document.getElementById('admin_password_confirmation').value;
             if (pass.length < 8) {
-                alert('La contraseña debe tener al menos 8 caracteres.');
+                alert('Password must be at least 8 characters long.');
                 return false;
             }
             if (pass !== conf) {
-                alert('Las contraseñas no coinciden.');
+                alert('Passwords do not match.');
                 return false;
             }
         }
@@ -1081,7 +1081,7 @@ function validateCurrentStep() {
         if (currentStep === panes.length - 1) {
             const chk = document.getElementById('confirm_apply');
             if (chk && !chk.checked) {
-                alert('Debes marcar la casilla de confirmación para ejecutar la instalación.');
+                alert('You must check the confirmation checkbox to run the installation.');
                 return false;
             }
         }
@@ -1117,10 +1117,10 @@ function validateCurrentStep() {
                 body,
             });
             const data = await res.json();
-            dbFeedback.textContent = data.message || (data.success ? 'Conexión exitosa' : 'Error de conexión');
+            dbFeedback.textContent = data.message || (data.success ? 'Connection successful' : 'Connection error');
             dbFeedback.className   = 'db-feedback ' + (data.success ? 'ok' : 'err');
         } catch {
-            dbFeedback.textContent = 'No se pudo contactar con el servidor.';
+            dbFeedback.textContent = 'Could not reach the server.';
             dbFeedback.className   = 'db-feedback err';
         }
     });
@@ -1139,7 +1139,7 @@ function validateCurrentStep() {
             return;
         }
         installBtn.disabled    = true;
-        installBtn.textContent = 'Instalando\u2026';
+        installBtn.textContent = 'Installing\u2026';
     });
 
     updateWizard();

From 8f25594ad3c2a14c9ff020711afa9060e1c6b9b4 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 2 May 2026 05:14:26 +0200
Subject: [PATCH 103/132] feat: add multilingual support for news articles

- Implemented news article editing view with multilingual fields.
- Created news management index view with article listing and actions.
- Added LocalizationService for managing multilingual settings.
- Created migration to add multilingual fields to the news table.
---
 .../Frontend/InstallController.php            |   5 +
 .../Controllers/Frontend/NewsController.php   | 114 +++--
 app/Models/Comment.php                        |   4 +-
 app/Models/News.php                           | 118 ++++-
 .../AdminNewsCategoryController.php           | 109 +++++
 .../Http/Controllers/AdminNewsController.php  | 216 ++++++++++
 .../Controllers/AdminSettingsController.php   |   3 +-
 app/Modules/Admin/Http/routes.php             |  17 +
 .../Admin/Resources/lang/en/settings.php      |  10 +
 .../Admin/Resources/lang/es/settings.php      |  10 +
 .../Resources/views/layouts/app.blade.php     |   7 +-
 .../views/news/categories/create.blade.php    |  91 ++++
 .../views/news/categories/edit.blade.php      |  83 ++++
 .../views/news/categories/index.blade.php     | 106 +++++
 .../Resources/views/news/create.blade.php     | 381 ++++++++++++++++
 .../Admin/Resources/views/news/edit.blade.php | 407 ++++++++++++++++++
 .../Resources/views/news/index.blade.php      | 140 ++++++
 .../Resources/views/settings/index.blade.php  |  31 --
 .../views/settings/localization.blade.php     | 171 +++++++-
 app/Services/LocalizationService.php          |  93 ++++
 app/Traits/Cacheable.php                      |  14 +-
 ..._04_30_000001_add_multilingual_to_news.php |  42 ++
 resources/js/editor/ckeditor.js               |  68 ++-
 resources/views/home/index.blade.php          |  86 ++--
 resources/views/news/index.blade.php          |  90 ++--
 resources/views/news/show.blade.php           | 335 ++++++++------
 26 files changed, 2425 insertions(+), 326 deletions(-)
 create mode 100644 app/Modules/Admin/Http/Controllers/AdminNewsCategoryController.php
 create mode 100644 app/Modules/Admin/Http/Controllers/AdminNewsController.php
 create mode 100644 app/Modules/Admin/Resources/views/news/categories/create.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/news/categories/edit.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/news/categories/index.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/news/create.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/news/edit.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/news/index.blade.php
 create mode 100644 app/Services/LocalizationService.php
 create mode 100644 database/migrations/2026_04_30_000001_add_multilingual_to_news.php

diff --git a/app/Http/Controllers/Frontend/InstallController.php b/app/Http/Controllers/Frontend/InstallController.php
index 2b99981..92dfde2 100644
--- a/app/Http/Controllers/Frontend/InstallController.php
+++ b/app/Http/Controllers/Frontend/InstallController.php
@@ -93,6 +93,11 @@ public function install(Request $request)
             ->with('install_success_message', 'Instalacion completada correctamente.');
     }
 
+    /**
+     * Get the system requirements for the installation.
+     *
+     * @return array
+     */
     private function systemRequirements(): array
     {
         $phpMin = '8.2.0';
diff --git a/app/Http/Controllers/Frontend/NewsController.php b/app/Http/Controllers/Frontend/NewsController.php
index 4b0f755..ff26537 100755
--- a/app/Http/Controllers/Frontend/NewsController.php
+++ b/app/Http/Controllers/Frontend/NewsController.php
@@ -6,89 +6,115 @@
 use App\Models\News;
 use App\Helpers\GeneralHelper;
 use App\Models\NewsCategory;
+use App\Services\LocalizationService;
 use Illuminate\Http\Request;
 use Illuminate\Contracts\View\View;
 
 /**
- * Frontend Home Controller for handling main website pages
+ * Frontend News Controller – supports optional multilingual content.
  */
 class NewsController extends Controller
 {
-    /**
-     * Model name
-     *
-     * @var string
-     */
-    protected $model = 'news';
-
-    /**
-     * Is paginated
-     *
-     * @var boolean
-     */
-    protected $isPaginated = true;
-
-    /**
-     * Per page
-     *
-     * @var int
-     */
     protected $perPage = 5;
 
-    /**
-     * Default view for the controller
-     *
-     * @var array<string,string>
-     */
     protected $views = [
         'index' => 'news.index',
-        'show' => 'news.show',
+        'show'  => 'news.show',
     ];
 
     /**
      * Display a listing of published news articles with optional category filtering.
-     *
-     * @param Request $request
-     * @return View
      */
     public function index(Request $request): View
     {
+        $locale   = $this->resolveLocale($request);
         $category = $request->get('category', 'all');
+
         $query = News::where('is_published', true)->orderBy('created_at', 'desc');
-        if ($category != 'all') {
+        if ($category !== 'all') {
             $query->where('category_id', $category);
         }
-        $items = (new News)->getCachedList($query, $this->perPage);
+
+        $items      = (new News)->getCachedList($query, $this->perPage);
         $recentNews = (new News)->recentNews();
-        $category = (new NewsCategory)->getAllCategoriesWithCount();
+        $category   = (new NewsCategory)->getAllCategoriesWithCount();
+
+        $items->each(function ($item) use ($locale) {
+            $item->display_title   = $item->translatedTitle($locale);
+            $item->display_content = $item->translatedContent($locale);
+            $item->display_excerpt = $item->excerpt ?: \Illuminate\Support\Str::limit(strip_tags($item->display_content), 220);
+            $item->reading_time    = GeneralHelper::readingTime($item->display_content);
+        });
 
-        $items->each(function ($item) {
-            $item->reading_time = GeneralHelper::readingTime($item->content);
+        $recentNews->each(function ($item) use ($locale) {
+            $item->display_title = $item->translatedTitle($locale);
         });
 
-        return view($this->views['index'], ['data' => $items, 'recentNews' => $recentNews, 'category' => $category]);
+        return view($this->views['index'], [
+            'data'          => $items,
+            'recentNews'    => $recentNews,
+            'category'      => $category,
+            'activeLocale'  => $locale,
+            'activeLocales' => LocalizationService::getActiveLocales(),
+            'isMultilingual'=> LocalizationService::isMultilingualEnabled(),
+        ]);
     }
 
     /**
      * Display a single news article by slug.
-     *
-     * @param string $slug
-     * @param string|null $view
-     * @return View
      */
-    public function show(string $slug, ?string $view = null): View
+    public function show(Request $request, string $slug): View
     {
-        $item = (new News)->getCachedByField('slug', $slug);
+        $locale = $this->resolveLocale($request);
+        $item   = (new News)->getCachedByField('slug', $slug);
+
         if (!$item) abort(404);
 
-        $item->load(['comments' => function ($query) {
+        $item->load(['author', 'comments' => function ($query) {
             $query->where('is_active', true)
                 ->with('user')
                 ->orderBy('created_at', 'desc');
         }]);
 
-        $item->reading_time = GeneralHelper::readingTime($item->content);
+        $item->display_title   = $item->translatedTitle($locale);
+        $item->display_content = $item->translatedContent($locale);
+        $item->display_excerpt = $item->excerpt ?: \Illuminate\Support\Str::limit(strip_tags($item->display_content), 300);
+        $item->reading_time    = GeneralHelper::readingTime($item->display_content);
+
+        return view($this->views['show'], [
+            'item'          => $item,
+            'activeLocale'  => $locale,
+            'activeLocales' => LocalizationService::getActiveLocales(),
+            'isMultilingual'=> LocalizationService::isMultilingualEnabled(),
+        ]);
+    }
+
+    /**
+     * Resolve locale from: query param → session → default locale.
+     * Persists chosen locale in session.
+     */
+    private function resolveLocale(Request $request): string
+    {
+        $available     = LocalizationService::getActiveLocales();
+        $defaultLocale = LocalizationService::getDefaultLocale();
+
+        if (!LocalizationService::isMultilingualEnabled()) {
+            return $defaultLocale;
+        }
+
+        // Accept locale switch via ?lang=xx
+        if ($request->has('lang') && in_array($request->input('lang'), $available)) {
+            $locale = $request->input('lang');
+            session(['news_locale' => $locale]);
+            return $locale;
+        }
 
-        return view($this->views['show'], ['item' => $item]);
+        $sessionLocale = session('news_locale');
+        if ($sessionLocale && in_array($sessionLocale, $available)) {
+            return $sessionLocale;
+        }
+
+        return $defaultLocale;
     }
 }
+
diff --git a/app/Models/Comment.php b/app/Models/Comment.php
index 64968d8..0e3a796 100644
--- a/app/Models/Comment.php
+++ b/app/Models/Comment.php
@@ -18,8 +18,8 @@ class Comment extends Model
 
     protected $casts = [
         'is_active' => 'boolean',
-        'created_at' => 'timestamp',
-        'updated_at' => 'timestamp'
+        'created_at' => 'datetime',
+        'updated_at' => 'datetime',
     ];
 
     /**
diff --git a/app/Models/News.php b/app/Models/News.php
index 3b0191d..df9f4e6 100755
--- a/app/Models/News.php
+++ b/app/Models/News.php
@@ -5,11 +5,13 @@
 use App\Traits\Cacheable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\SoftDeletes;
 
 class News extends Model
 {
     use HasFactory;
     use Cacheable;
+    use SoftDeletes;
 
     protected $fillable = [
         'title',
@@ -19,13 +21,97 @@ class News extends Model
         'author_id',
         'category_id',
         'is_published',
-        'published_at'
+        'published_at',
+        'title_translations',
+        'content_translations',
+        'excerpt',
     ];
 
     protected $casts = [
-        'published_at' => 'datetime'
+        'published_at'          => 'datetime',
+        'is_published'          => 'boolean',
+        'title_translations'    => 'array',
+        'content_translations'  => 'array',
     ];
 
+    /**
+     * Always return published_at as Carbon (handles int timestamps from cache deserialization).
+     */
+    public function getPublishedAtAttribute($value): ?\Carbon\Carbon
+    {
+        if ($value === null) return null;
+        if ($value instanceof \Carbon\Carbon) return $value;
+        return \Carbon\Carbon::parse($value);
+    }
+
+    /**
+     * Always return created_at as Carbon.
+     */
+    public function getCreatedAtAttribute($value): ?\Carbon\Carbon
+    {
+        if ($value === null) return null;
+        if ($value instanceof \Carbon\Carbon) return $value;
+        return \Carbon\Carbon::parse($value);
+    }
+
+    /**
+     * Always return updated_at as Carbon.
+     */
+    public function getUpdatedAtAttribute($value): ?\Carbon\Carbon
+    {
+        if ($value === null) return null;
+        if ($value instanceof \Carbon\Carbon) return $value;
+        return \Carbon\Carbon::parse($value);
+    }
+
+    /**
+     * Get a translated field value with locale fallback.
+     *
+     * Resolution order:
+     *  1. Requested locale in *_translations JSON
+     *  2. Default/fallback locale in *_translations JSON
+     *  3. Legacy plain-text field (title / content)
+     *  4. Empty string
+     */
+    public function getTranslated(string $field, ?string $locale = null, ?string $fallback = null): string
+    {
+        $locale   = $locale   ?? app()->getLocale();
+        $fallback = $fallback ?? config('app.fallback_locale', 'en');
+
+        $translationsField = $field . '_translations';
+
+        // Only try translations if the column exists and is populated
+        if (isset($this->$translationsField) && is_array($this->$translationsField)) {
+            $translations = $this->$translationsField;
+
+            // Use !empty() so that empty-string translations also fall through
+            if (!empty($translations[$locale])) {
+                return $translations[$locale];
+            }
+            if (!empty($translations[$fallback])) {
+                return $translations[$fallback];
+            }
+        }
+
+        return (string) ($this->$field ?? '');
+    }
+
+    /**
+     * Convenience: translated title.
+     */
+    public function translatedTitle(?string $locale = null): string
+    {
+        return $this->getTranslated('title', $locale);
+    }
+
+    /**
+     * Convenience: translated content.
+     */
+    public function translatedContent(?string $locale = null): string
+    {
+        return $this->getTranslated('content', $locale);
+    }
+
     public function author()
     {
         return $this->belongsTo(User::class, 'author_id');
@@ -41,6 +127,34 @@ public function comments()
         return $this->morphMany(Comment::class, 'commentable');
     }
 
+    /**
+     * Override clearCache to also invalidate the slug-based cache key
+     * used by getCachedByField('slug', ...) and bust all list caches
+     * by incrementing the list version counter.
+     */
+    public function clearCache()
+    {
+        // Replicate Cacheable trait logic (trait methods cannot use parent::)
+        if ($this->id) {
+            \Illuminate\Support\Facades\Cache::forget($this->getCacheKey($this->id));
+        }
+
+        $store = \Illuminate\Support\Facades\Cache::getStore();
+        if (method_exists($store, 'tags')) {
+            \Illuminate\Support\Facades\Cache::tags($this->getCacheTag())->flush();
+        }
+
+        // Clear slug-based cache key used by getCachedByField('slug', ...)
+        if ($this->slug) {
+            \Illuminate\Support\Facades\Cache::forget(
+                $this->getCacheKey("slug.{$this->slug}")
+            );
+        }
+
+        // Bust all list caches by incrementing the version counter
+        \Illuminate\Support\Facades\Cache::increment($this->getCacheTag() . '.list.version');
+    }
+
     public function relatedContents($limit = 2)
     {
         return static::query()
diff --git a/app/Modules/Admin/Http/Controllers/AdminNewsCategoryController.php b/app/Modules/Admin/Http/Controllers/AdminNewsCategoryController.php
new file mode 100644
index 0000000..c1bda89
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/AdminNewsCategoryController.php
@@ -0,0 +1,109 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Models\NewsCategory;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+
+class AdminNewsCategoryController extends Controller
+{
+    public function index()
+    {
+        $categories = NewsCategory::withCount('news')
+            ->withTrashed()
+            ->orderBy('order')
+            ->orderBy('name')
+            ->paginate(20);
+
+        return view('admin::news.categories.index', compact('categories'));
+    }
+
+    public function create()
+    {
+        return view('admin::news.categories.create');
+    }
+
+    public function store(Request $request)
+    {
+        $validated = $request->validate([
+            'name'        => ['required', 'string', 'max:100'],
+            'slug'        => ['nullable', 'string', 'max:150', 'unique:news_category,slug'],
+            'description' => ['nullable', 'string', 'max:500'],
+            'is_active'   => ['boolean'],
+            'order'       => ['nullable', 'integer', 'min:0'],
+        ]);
+
+        $slug = $validated['slug']
+            ? Str::slug($validated['slug'])
+            : Str::slug($validated['name']);
+
+        // Ensure unique slug
+        $originalSlug = $slug;
+        $count = 1;
+        while (NewsCategory::withTrashed()->where('slug', $slug)->exists()) {
+            $slug = "{$originalSlug}-{$count}";
+            $count++;
+        }
+
+        NewsCategory::create([
+            'name'        => $validated['name'],
+            'slug'        => $slug,
+            'description' => $validated['description'] ?? null,
+            'is_active'   => $request->boolean('is_active', true),
+            'order'       => $validated['order'] ?? 0,
+        ]);
+
+        return redirect()
+            ->route('admin.news.categories.index')
+            ->with('success', 'Category created successfully.');
+    }
+
+    public function edit(NewsCategory $newsCategory)
+    {
+        return view('admin::news.categories.edit', compact('newsCategory'));
+    }
+
+    public function update(Request $request, NewsCategory $newsCategory)
+    {
+        $validated = $request->validate([
+            'name'        => ['required', 'string', 'max:100'],
+            'slug'        => ['nullable', 'string', 'max:150', "unique:news_category,slug,{$newsCategory->id}"],
+            'description' => ['nullable', 'string', 'max:500'],
+            'is_active'   => ['boolean'],
+            'order'       => ['nullable', 'integer', 'min:0'],
+        ]);
+
+        $slug = $validated['slug']
+            ? Str::slug($validated['slug'])
+            : $newsCategory->slug;
+
+        $newsCategory->update([
+            'name'        => $validated['name'],
+            'slug'        => $slug,
+            'description' => $validated['description'] ?? null,
+            'is_active'   => $request->boolean('is_active'),
+            'order'       => $validated['order'] ?? 0,
+        ]);
+
+        return redirect()
+            ->route('admin.news.categories.index')
+            ->with('success', 'Category updated successfully.');
+    }
+
+    public function destroy(NewsCategory $newsCategory)
+    {
+        if ($newsCategory->news()->count() > 0) {
+            return redirect()
+                ->route('admin.news.categories.index')
+                ->with('error', 'Cannot delete a category that has news articles.');
+        }
+
+        $newsCategory->delete();
+
+        return redirect()
+            ->route('admin.news.categories.index')
+            ->with('success', 'Category deleted successfully.');
+    }
+}
diff --git a/app/Modules/Admin/Http/Controllers/AdminNewsController.php b/app/Modules/Admin/Http/Controllers/AdminNewsController.php
new file mode 100644
index 0000000..8b16994
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/AdminNewsController.php
@@ -0,0 +1,216 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Models\News;
+use App\Models\NewsCategory;
+use App\Services\LocalizationService;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\Storage;
+
+class AdminNewsController extends Controller
+{
+    public function index()
+    {
+        $news = News::withTrashed()
+            ->with(['author', 'category'])
+            ->orderBy('created_at', 'desc')
+            ->paginate(15);
+
+        return view('admin::news.index', compact('news'));
+    }
+
+    public function create()
+    {
+        $categories      = NewsCategory::where('is_active', true)->orderBy('name')->get();
+        $activeLocales   = LocalizationService::getActiveLocales();
+        $defaultLocale   = LocalizationService::getDefaultLocale();
+        $localeNames     = LocalizationService::getLocaleNames();
+        $isMultilingual  = LocalizationService::isMultilingualEnabled();
+
+        return view('admin::news.create', compact(
+            'categories', 'activeLocales', 'defaultLocale', 'localeNames', 'isMultilingual'
+        ));
+    }
+
+    public function store(Request $request)
+    {
+        $activeLocales  = LocalizationService::getActiveLocales();
+        $defaultLocale  = LocalizationService::getDefaultLocale();
+        $isMultilingual = LocalizationService::isMultilingualEnabled();
+
+        $rules = [
+            'category_id'  => ['nullable', 'exists:news_category,id'],
+            'image'        => ['nullable', 'image', 'max:4096'],
+            'is_published' => ['boolean'],
+            'published_at' => ['nullable', 'date'],
+            'slug'         => ['nullable', 'string', 'max:255', 'unique:news,slug'],
+        ];
+
+        if ($isMultilingual) {
+            foreach ($activeLocales as $locale) {
+                $required = $locale === $defaultLocale ? 'required' : 'nullable';
+                $rules["title_translations.{$locale}"]   = [$required, 'string', 'max:255'];
+                $rules["content_translations.{$locale}"] = [$required, 'string'];
+            }
+        } else {
+            $rules['title']   = ['required', 'string', 'max:255'];
+            $rules['content'] = ['required', 'string'];
+        }
+
+        $validated = $request->validate($rules);
+
+        // Build title/content from translations or plain fields
+        if ($isMultilingual) {
+            $titleTranslations   = $request->input('title_translations', []);
+            $contentTranslations = $request->input('content_translations', []);
+            // Fallback plain fields from default locale
+            $title   = $titleTranslations[$defaultLocale] ?? reset($titleTranslations) ?? '';
+            $content = $contentTranslations[$defaultLocale] ?? reset($contentTranslations) ?? '';
+        } else {
+            $title               = $request->input('title');
+            $content             = $request->input('content');
+            $titleTranslations   = null;
+            $contentTranslations = null;
+        }
+
+        $slug = $request->filled('slug')
+            ? Str::slug($request->input('slug'))
+            : Str::slug($title);
+
+        // Ensure unique slug
+        $originalSlug = $slug;
+        $count = 1;
+        while (News::where('slug', $slug)->exists()) {
+            $slug = "{$originalSlug}-{$count}";
+            $count++;
+        }
+
+        $imagePath = null;
+        if ($request->hasFile('image')) {
+            $imagePath = $request->file('image')->store('images', 'public');
+            $imagePath = basename($imagePath);
+        }
+
+        News::create([
+            'title'                => $title,
+            'slug'                 => $slug,
+            'content'              => $content,
+            'excerpt'              => $request->input('excerpt'),
+            'image'                => $imagePath,
+            'author_id'            => Auth::id(),
+            'category_id'          => $request->input('category_id'),
+            'is_published'         => $request->boolean('is_published'),
+            'published_at'         => $request->input('is_published') ? ($request->input('published_at') ?? now()) : null,
+            'title_translations'   => $titleTranslations,
+            'content_translations' => $contentTranslations,
+        ]);
+
+        return redirect()
+            ->route('admin.news.index')
+            ->with('success', 'News article created successfully.');
+    }
+
+    public function edit(News $news)
+    {
+        $categories     = NewsCategory::where('is_active', true)->orderBy('name')->get();
+        $activeLocales  = LocalizationService::getActiveLocales();
+        $defaultLocale  = LocalizationService::getDefaultLocale();
+        $localeNames    = LocalizationService::getLocaleNames();
+        $isMultilingual = LocalizationService::isMultilingualEnabled();
+
+        return view('admin::news.edit', compact(
+            'news', 'categories', 'activeLocales', 'defaultLocale', 'localeNames', 'isMultilingual'
+        ));
+    }
+
+    public function update(Request $request, News $news)
+    {
+        $activeLocales  = LocalizationService::getActiveLocales();
+        $defaultLocale  = LocalizationService::getDefaultLocale();
+        $isMultilingual = LocalizationService::isMultilingualEnabled();
+
+        $rules = [
+            'category_id'  => ['nullable', 'exists:news_category,id'],
+            'image'        => ['nullable', 'image', 'max:4096'],
+            'is_published' => ['boolean'],
+            'published_at' => ['nullable', 'date'],
+            'slug'         => ['nullable', 'string', 'max:255', "unique:news,slug,{$news->id}"],
+        ];
+
+        if ($isMultilingual) {
+            foreach ($activeLocales as $locale) {
+                $required = $locale === $defaultLocale ? 'required' : 'nullable';
+                $rules["title_translations.{$locale}"]   = [$required, 'string', 'max:255'];
+                $rules["content_translations.{$locale}"] = [$required, 'string'];
+            }
+        } else {
+            $rules['title']   = ['required', 'string', 'max:255'];
+            $rules['content'] = ['required', 'string'];
+        }
+
+        $request->validate($rules);
+
+        if ($isMultilingual) {
+            $titleTranslations   = $request->input('title_translations', []);
+            $contentTranslations = $request->input('content_translations', []);
+            $title   = $titleTranslations[$defaultLocale] ?? reset($titleTranslations) ?? $news->title;
+            $content = $contentTranslations[$defaultLocale] ?? reset($contentTranslations) ?? $news->content;
+        } else {
+            $title               = $request->input('title');
+            $content             = $request->input('content');
+            $titleTranslations   = null;
+            $contentTranslations = null;
+        }
+
+        $slug = $request->filled('slug')
+            ? Str::slug($request->input('slug'))
+            : $news->slug;
+
+        $imagePath = $news->image;
+        if ($request->hasFile('image')) {
+            $imagePath = basename($request->file('image')->store('images', 'public'));
+        }
+
+        $news->update([
+            'title'                => $title,
+            'slug'                 => $slug,
+            'content'              => $content,
+            'excerpt'              => $request->input('excerpt'),
+            'image'                => $imagePath,
+            'category_id'          => $request->input('category_id'),
+            'is_published'         => $request->boolean('is_published'),
+            'published_at'         => $request->boolean('is_published')
+                ? ($request->input('published_at') ?? $news->published_at ?? now())
+                : null,
+            'title_translations'   => $titleTranslations,
+            'content_translations' => $contentTranslations,
+        ]);
+
+        return redirect()
+            ->route('admin.news.index')
+            ->with('success', 'News article updated successfully.');
+    }
+
+    public function destroy(News $news)
+    {
+        $news->delete();
+
+        return redirect()
+            ->route('admin.news.index')
+            ->with('success', 'News article deleted successfully.');
+    }
+
+    public function restore(int $id)
+    {
+        $news = News::withTrashed()->findOrFail($id);
+        $news->restore();
+
+        return redirect()
+            ->route('admin.news.index')
+            ->with('success', 'News article restored successfully.');
+    }
+}
diff --git a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
index d8e171e..eab930f 100644
--- a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
@@ -3,9 +3,9 @@
 namespace Modules\Admin\Http\Controllers;
 
 use App\Http\Controllers\Controller;
+use App\Services\LocalizationService;
 use Modules\Admin\Domain\Models\Setting;
 use Illuminate\Http\Request;
-
 use Illuminate\Support\Facades\Cache;
 
 class AdminSettingsController extends Controller
@@ -71,6 +71,7 @@ public function store(Request $request)
 
         // Clear settings cache
         Cache::forget('site_settings');
+        LocalizationService::clearCache();
 
         return redirect()->route('admin.settings.index', ['view' => $view])
             ->with('success', 'Settings updated successfully.');
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index ac82b68..68e0ae0 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -54,6 +54,23 @@
         Route::get('/menus', [\Modules\Admin\Http\Controllers\MenuManagerController::class, 'index'])->middleware('permission:manage.settings')->name('admin.menus.index');
         Route::put('/menus', [\Modules\Admin\Http\Controllers\MenuManagerController::class, 'update'])->middleware('permission:manage.settings')->name('admin.menus.update');
 
+        // News
+        Route::get('/news', [\Modules\Admin\Http\Controllers\AdminNewsController::class, 'index'])->middleware('permission:manage.news')->name('admin.news.index');
+        Route::get('/news/create', [\Modules\Admin\Http\Controllers\AdminNewsController::class, 'create'])->middleware('permission:manage.news')->name('admin.news.create');
+        Route::post('/news', [\Modules\Admin\Http\Controllers\AdminNewsController::class, 'store'])->middleware('permission:manage.news')->name('admin.news.store');
+        Route::get('/news/{news}/edit', [\Modules\Admin\Http\Controllers\AdminNewsController::class, 'edit'])->middleware('permission:manage.news')->name('admin.news.edit');
+        Route::put('/news/{news}', [\Modules\Admin\Http\Controllers\AdminNewsController::class, 'update'])->middleware('permission:manage.news')->name('admin.news.update');
+        Route::delete('/news/{news}', [\Modules\Admin\Http\Controllers\AdminNewsController::class, 'destroy'])->middleware('permission:manage.news')->name('admin.news.destroy');
+        Route::patch('/news/{id}/restore', [\Modules\Admin\Http\Controllers\AdminNewsController::class, 'restore'])->middleware('permission:manage.news')->name('admin.news.restore');
+
+        // News Categories
+        Route::get('/news/categories', [\Modules\Admin\Http\Controllers\AdminNewsCategoryController::class, 'index'])->middleware('permission:manage.news')->name('admin.news.categories.index');
+        Route::get('/news/categories/create', [\Modules\Admin\Http\Controllers\AdminNewsCategoryController::class, 'create'])->middleware('permission:manage.news')->name('admin.news.categories.create');
+        Route::post('/news/categories', [\Modules\Admin\Http\Controllers\AdminNewsCategoryController::class, 'store'])->middleware('permission:manage.news')->name('admin.news.categories.store');
+        Route::get('/news/categories/{newsCategory}/edit', [\Modules\Admin\Http\Controllers\AdminNewsCategoryController::class, 'edit'])->middleware('permission:manage.news')->name('admin.news.categories.edit');
+        Route::put('/news/categories/{newsCategory}', [\Modules\Admin\Http\Controllers\AdminNewsCategoryController::class, 'update'])->middleware('permission:manage.news')->name('admin.news.categories.update');
+        Route::delete('/news/categories/{newsCategory}', [\Modules\Admin\Http\Controllers\AdminNewsCategoryController::class, 'destroy'])->middleware('permission:manage.news')->name('admin.news.categories.destroy');
+
         // Modules
         Route::get('/modules', [\Modules\Admin\Http\Controllers\ModuleManagerController::class, 'index'])->middleware('permission:manage.modules')->name('admin.modules.index');
         Route::get('/modules/{module}/edit', [\Modules\Admin\Http\Controllers\ModuleManagerController::class, 'edit'])->middleware('permission:manage.modules')->name('admin.modules.edit');
diff --git a/app/Modules/Admin/Resources/lang/en/settings.php b/app/Modules/Admin/Resources/lang/en/settings.php
index 8e0d541..c438f11 100644
--- a/app/Modules/Admin/Resources/lang/en/settings.php
+++ b/app/Modules/Admin/Resources/lang/en/settings.php
@@ -37,6 +37,16 @@
             'label' => 'Time Format',
             'help'  => 'Display format for times.',
         ],
+        'multilingual' => [
+            'section_title'       => 'Multilingual Content',
+            'section_description' => 'Enable and configure multilingual support for news and content.',
+            'enabled_label'       => 'Enable Multilingual Support',
+            'enabled_help'        => 'When enabled, content editors can enter translations for each configured language.',
+            'locales_label'       => 'Available Languages',
+            'locales_help'        => 'Languages available in the content editor. The default locale is always included.',
+            'add_locale'          => 'Add language code (e.g. fr)',
+            'locale_placeholder'  => 'e.g. fr, de, pt',
+        ],
     ],
 
     'advanced' => [
diff --git a/app/Modules/Admin/Resources/lang/es/settings.php b/app/Modules/Admin/Resources/lang/es/settings.php
index bb1574b..db42612 100644
--- a/app/Modules/Admin/Resources/lang/es/settings.php
+++ b/app/Modules/Admin/Resources/lang/es/settings.php
@@ -37,6 +37,16 @@
             'label' => 'Formato de hora',
             'help'  => 'Formato de visualización para las horas.',
         ],
+        'multilingual' => [
+            'section_title'       => 'Contenido multiidioma',
+            'section_description' => 'Activa y configura el soporte multiidioma para noticias y contenido.',
+            'enabled_label'       => 'Activar soporte multiidioma',
+            'enabled_help'        => 'Cuando está activado, los editores pueden introducir traducciones para cada idioma configurado.',
+            'locales_label'       => 'Idiomas disponibles',
+            'locales_help'        => 'Idiomas disponibles en el editor de contenido. El idioma predeterminado siempre se incluye.',
+            'add_locale'          => 'Añadir código de idioma (ej. fr)',
+            'locale_placeholder'  => 'ej. fr, de, pt',
+        ],
     ],
 
     'advanced' => [
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index 5473cc8..889343e 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -135,10 +135,11 @@ class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium
             <div>
                 <p class="px-3 mb-1.5 text-[10px] font-semibold uppercase tracking-widest text-gray-500 select-none">Content</p>
                 @can('manage.news')
-                <a href="#"
+                @php $active = request()->routeIs('admin.news.*'); @endphp
+                <a href="{{ route('admin.news.index') }}"
                    class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
-                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
-                    <i class="fas fa-newspaper w-4 text-center"></i>
+                          {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                    <i class="fas fa-newspaper w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
                     News
                 </a>
                 @endcan
diff --git a/app/Modules/Admin/Resources/views/news/categories/create.blade.php b/app/Modules/Admin/Resources/views/news/categories/create.blade.php
new file mode 100644
index 0000000..62f9d03
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/news/categories/create.blade.php
@@ -0,0 +1,91 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Create Category')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <a href="{{ route('admin.news.categories.index') }}" class="text-gray-500 hover:text-gray-700">
+            <i class="fas fa-arrow-left"></i>
+        </a>
+        <h1 class="text-2xl font-bold text-gray-800">Create Category</h1>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if($errors->any())
+        <div class="mb-4 p-4 bg-red-50 border border-red-200 rounded-lg text-sm text-red-600">
+            @foreach($errors->all() as $error)
+                <p>{{ $error }}</p>
+            @endforeach
+        </div>
+    @endif
+
+    <form method="POST" action="{{ route('admin.news.categories.store') }}" class="max-w-2xl space-y-6">
+        @csrf
+        <div class="bg-white rounded-lg shadow">
+            <div class="p-6 border-b border-gray-200">
+                <h2 class="text-lg font-bold text-gray-800">Category Details</h2>
+            </div>
+            <div class="p-6 space-y-4">
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Name <span class="text-red-500">*</span></label>
+                    <input type="text" name="name" value="{{ old('name') }}" required
+                           id="name-input"
+                           class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500"
+                           placeholder="Category name">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Slug</label>
+                    <input type="text" name="slug" value="{{ old('slug') }}" id="slug-input"
+                           class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 font-mono"
+                           placeholder="auto-generated-from-name">
+                    <p class="text-xs text-gray-400 mt-1">Leave empty to auto-generate from name.</p>
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Description</label>
+                    <textarea name="description" rows="3"
+                              class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500"
+                              placeholder="Optional category description">{{ old('description') }}</textarea>
+                </div>
+                <div class="grid grid-cols-2 gap-4">
+                    <div>
+                        <label class="block text-sm font-semibold text-gray-700 mb-2">Display Order</label>
+                        <input type="number" name="order" value="{{ old('order', 0) }}" min="0"
+                               class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    </div>
+                    <div class="flex items-end pb-2">
+                        <div class="flex items-center gap-2">
+                            <input type="hidden" name="is_active" value="0">
+                            <input type="checkbox" id="is_active" name="is_active" value="1"
+                                   {{ old('is_active', true) ? 'checked' : '' }}
+                                   class="rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                            <label for="is_active" class="text-sm font-medium text-gray-700">Active</label>
+                        </div>
+                    </div>
+                </div>
+            </div>
+            <div class="p-6 border-t border-gray-100 flex justify-end gap-3">
+                <a href="{{ route('admin.news.categories.index') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">Cancel</a>
+                <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                    <i class="fas fa-save mr-1"></i> Create Category
+                </button>
+            </div>
+        </div>
+    </form>
+</main>
+
+@push('scripts')
+<script>
+    const nameInput = document.getElementById('name-input');
+    const slugInput = document.getElementById('slug-input');
+    function slugify(t) {
+        return t.toLowerCase().normalize('NFD').replace(/[\u0300-\u036f]/g,'')
+            .replace(/\s+/g,'-').replace(/[^\w\-]+/g,'').replace(/--+/g,'-').replace(/^-+|-+$/g,'');
+    }
+    nameInput.addEventListener('input', function() {
+        if (!slugInput.value) slugInput.placeholder = slugify(this.value) || 'auto-generated-from-name';
+    });
+</script>
+@endpush
+@endsection
diff --git a/app/Modules/Admin/Resources/views/news/categories/edit.blade.php b/app/Modules/Admin/Resources/views/news/categories/edit.blade.php
new file mode 100644
index 0000000..2aa7243
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/news/categories/edit.blade.php
@@ -0,0 +1,83 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Edit Category')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <a href="{{ route('admin.news.categories.index') }}" class="text-gray-500 hover:text-gray-700">
+            <i class="fas fa-arrow-left"></i>
+        </a>
+        <h1 class="text-2xl font-bold text-gray-800">Edit Category</h1>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if(session('success'))
+        <div class="mb-4 p-3 bg-green-50 text-green-700 border border-green-200 rounded-lg">{{ session('success') }}</div>
+    @endif
+    @if($errors->any())
+        <div class="mb-4 p-4 bg-red-50 border border-red-200 rounded-lg text-sm text-red-600">
+            @foreach($errors->all() as $error)<p>{{ $error }}</p>@endforeach
+        </div>
+    @endif
+
+    <form method="POST" action="{{ route('admin.news.categories.update', $newsCategory) }}" class="max-w-2xl space-y-6">
+        @csrf @method('PUT')
+        <div class="bg-white rounded-lg shadow">
+            <div class="p-6 border-b border-gray-200">
+                <h2 class="text-lg font-bold text-gray-800">Category Details</h2>
+            </div>
+            <div class="p-6 space-y-4">
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Name <span class="text-red-500">*</span></label>
+                    <input type="text" name="name" value="{{ old('name', $newsCategory->name) }}" required
+                           class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Slug</label>
+                    <input type="text" name="slug" value="{{ old('slug', $newsCategory->slug) }}"
+                           class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 font-mono">
+                </div>
+                <div>
+                    <label class="block text-sm font-semibold text-gray-700 mb-2">Description</label>
+                    <textarea name="description" rows="3"
+                              class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">{{ old('description', $newsCategory->description) }}</textarea>
+                </div>
+                <div class="grid grid-cols-2 gap-4">
+                    <div>
+                        <label class="block text-sm font-semibold text-gray-700 mb-2">Display Order</label>
+                        <input type="number" name="order" value="{{ old('order', $newsCategory->order) }}" min="0"
+                               class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    </div>
+                    <div class="flex items-end pb-2">
+                        <div class="flex items-center gap-2">
+                            <input type="hidden" name="is_active" value="0">
+                            <input type="checkbox" id="is_active" name="is_active" value="1"
+                                   {{ old('is_active', $newsCategory->is_active) ? 'checked' : '' }}
+                                   class="rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                            <label for="is_active" class="text-sm font-medium text-gray-700">Active</label>
+                        </div>
+                    </div>
+                </div>
+            </div>
+            <div class="p-6 border-t border-gray-100 flex items-center justify-between">
+                <form method="POST" action="{{ route('admin.news.categories.destroy', $newsCategory) }}"
+                      onsubmit="return confirm('Delete this category? Articles in this category will not be deleted.')"
+                      class="inline">
+                    @csrf @method('DELETE')
+                    <button type="submit" class="px-4 py-2 bg-red-50 text-red-700 border border-red-200 rounded-lg hover:bg-red-100 text-sm font-medium">
+                        <i class="fas fa-trash mr-1"></i> Delete
+                    </button>
+                </form>
+                <div class="flex gap-3">
+                    <a href="{{ route('admin.news.categories.index') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">Cancel</a>
+                    <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                        <i class="fas fa-save mr-1"></i> Save Changes
+                    </button>
+                </div>
+            </div>
+        </div>
+    </form>
+</main>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/news/categories/index.blade.php b/app/Modules/Admin/Resources/views/news/categories/index.blade.php
new file mode 100644
index 0000000..75296fe
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/news/categories/index.blade.php
@@ -0,0 +1,106 @@
+@extends('admin::layouts.app')
+
+@section('title', 'News Categories')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <a href="{{ route('admin.news.index') }}" class="text-gray-500 hover:text-gray-700">
+            <i class="fas fa-arrow-left"></i>
+        </a>
+        <h1 class="text-2xl font-bold text-gray-800">News Categories</h1>
+    </div>
+    <div class="flex items-center gap-3">
+        <a href="{{ route('admin.news.categories.create') }}" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+            <i class="fas fa-plus mr-1"></i> New Category
+        </a>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if(session('success'))
+        <div class="mb-4 p-3 bg-green-50 text-green-700 border border-green-200 rounded-lg flex items-center gap-2">
+            <i class="fas fa-check-circle"></i> {{ session('success') }}
+        </div>
+    @endif
+    @if(session('error'))
+        <div class="mb-4 p-3 bg-red-50 text-red-700 border border-red-200 rounded-lg flex items-center gap-2">
+            <i class="fas fa-exclamation-circle"></i> {{ session('error') }}
+        </div>
+    @endif
+
+    <div class="bg-white rounded-lg shadow">
+        <div class="p-6 border-b border-gray-200 flex items-center justify-between">
+            <h2 class="text-lg font-bold text-gray-800">All Categories</h2>
+            <span class="text-sm text-gray-500">{{ $categories->total() }} categories</span>
+        </div>
+
+        <div class="overflow-x-auto">
+            <table class="w-full text-sm">
+                <thead>
+                    <tr class="border-b border-gray-100 bg-gray-50">
+                        <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">Name</th>
+                        <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">Slug</th>
+                        <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">Articles</th>
+                        <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">Status</th>
+                        <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">Order</th>
+                        <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">Actions</th>
+                    </tr>
+                </thead>
+                <tbody class="divide-y divide-gray-100">
+                    @forelse($categories as $category)
+                    <tr class="{{ $category->trashed() ? 'bg-red-50/30 opacity-60' : 'hover:bg-gray-50' }} transition-colors">
+                        <td class="px-6 py-4">
+                            <p class="font-medium text-gray-800">{{ $category->name }}</p>
+                            @if($category->description)
+                                <p class="text-xs text-gray-400 mt-0.5 line-clamp-1">{{ $category->description }}</p>
+                            @endif
+                        </td>
+                        <td class="px-6 py-4 font-mono text-xs text-gray-500">{{ $category->slug }}</td>
+                        <td class="px-6 py-4 text-gray-600">{{ $category->news_count }}</td>
+                        <td class="px-6 py-4">
+                            @if($category->trashed())
+                                <span class="px-2 py-1 text-xs rounded-full bg-red-100 text-red-700">Deleted</span>
+                            @elseif($category->is_active)
+                                <span class="px-2 py-1 text-xs rounded-full bg-green-100 text-green-700">Active</span>
+                            @else
+                                <span class="px-2 py-1 text-xs rounded-full bg-gray-100 text-gray-500">Inactive</span>
+                            @endif
+                        </td>
+                        <td class="px-6 py-4 text-gray-500">{{ $category->order }}</td>
+                        <td class="px-6 py-4">
+                            <div class="flex items-center gap-2">
+                                @if(!$category->trashed())
+                                    <a href="{{ route('admin.news.categories.edit', $category) }}" class="px-3 py-1 bg-gray-100 text-gray-700 rounded hover:bg-gray-200 text-xs font-medium">
+                                        Edit
+                                    </a>
+                                    <form method="POST" action="{{ route('admin.news.categories.destroy', $category) }}" onsubmit="return confirm('Delete this category?')">
+                                        @csrf @method('DELETE')
+                                        <button type="submit" class="px-3 py-1 bg-red-50 text-red-700 rounded hover:bg-red-100 text-xs font-medium">
+                                            Delete
+                                        </button>
+                                    </form>
+                                @endif
+                            </div>
+                        </td>
+                    </tr>
+                    @empty
+                    <tr>
+                        <td colspan="6" class="px-6 py-12 text-center text-gray-400">
+                            <i class="fas fa-tags text-3xl mb-2 block"></i>
+                            No categories found. <a href="{{ route('admin.news.categories.create') }}" class="text-blue-600 hover:underline">Create the first one</a>.
+                        </td>
+                    </tr>
+                    @endforelse
+                </tbody>
+            </table>
+        </div>
+
+        @if($categories->hasPages())
+        <div class="px-6 py-4 border-t border-gray-100">
+            {{ $categories->links() }}
+        </div>
+        @endif
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/news/create.blade.php b/app/Modules/Admin/Resources/views/news/create.blade.php
new file mode 100644
index 0000000..7e754d9
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/news/create.blade.php
@@ -0,0 +1,381 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Create News Article')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <a href="{{ route('admin.news.index') }}" class="text-gray-500 hover:text-gray-700">
+            <i class="fas fa-arrow-left"></i>
+        </a>
+        <h1 class="text-2xl font-bold text-gray-800">Create News Article</h1>
+    </div>
+    <div class="flex items-center gap-3">
+        <button type="submit" form="news-form" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+            <i class="fas fa-save mr-1"></i> Publish
+        </button>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if($errors->any())
+        <div class="mb-4 p-4 bg-red-50 border border-red-200 rounded-lg">
+            <p class="text-sm font-semibold text-red-700 mb-1">Please fix the following errors:</p>
+            <ul class="list-disc list-inside text-sm text-red-600 space-y-1">
+                @foreach($errors->all() as $error)
+                    <li>{{ $error }}</li>
+                @endforeach
+            </ul>
+        </div>
+    @endif
+
+    <form id="news-form" method="POST" action="{{ route('admin.news.store') }}" enctype="multipart/form-data">
+        @csrf
+        <div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
+
+            {{-- Main content --}}
+            <div class="lg:col-span-2 space-y-6">
+
+                @if($isMultilingual && count($activeLocales) > 1)
+                {{-- Multilingual tabs --}}
+                <div class="bg-white rounded-lg shadow">
+                    <div class="border-b border-gray-200 px-4">
+                        <nav class="-mb-px flex gap-1" id="lang-tabs" role="tablist">
+                            @foreach($activeLocales as $i => $locale)
+                            <button type="button"
+                                    role="tab"
+                                    data-locale="{{ $locale }}"
+                                    onclick="switchTab('{{ $locale }}')"
+                                    class="lang-tab px-4 py-3 text-sm font-medium border-b-2 transition-colors whitespace-nowrap
+                                           {{ $i === 0 ? 'border-blue-500 text-blue-600' : 'border-transparent text-gray-500 hover:text-gray-700 hover:border-gray-300' }}">
+                                <span class="inline-flex items-center gap-1.5">
+                                    <span class="text-xs font-mono px-1.5 py-0.5 rounded bg-gray-100">{{ strtoupper($locale) }}</span>
+                                    {{ $localeNames[$locale] ?? $locale }}
+                                    @if($locale === $defaultLocale)
+                                        <span class="text-[10px] text-blue-400 font-normal">(default)</span>
+                                    @endif
+                                </span>
+                            </button>
+                            @endforeach
+                        </nav>
+                    </div>
+
+                    @foreach($activeLocales as $i => $locale)
+                    <div id="tab-{{ $locale }}" class="lang-panel p-6 space-y-4 {{ $i !== 0 ? 'hidden' : '' }}">
+                        <div>
+                            <label class="block text-sm font-semibold text-gray-700 mb-2">
+                                Title <span class="font-mono text-xs text-gray-400">[{{ $locale }}]</span>
+                                @if($locale === $defaultLocale) <span class="text-red-500">*</span> @endif
+                            </label>
+                            <input type="text"
+                                   name="title_translations[{{ $locale }}]"
+                                   value="{{ old("title_translations.{$locale}") }}"
+                                   class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500"
+                                   {{ $locale === $defaultLocale ? 'required' : '' }}
+                                   id="title-{{ $locale }}"
+                                   placeholder="Article title in {{ $localeNames[$locale] ?? $locale }}">
+                            @if($locale === $defaultLocale)
+                                <p class="text-xs text-gray-400 mt-1">Slug will be auto-generated from this title if left blank.</p>
+                            @endif
+                        </div>
+                        <div>
+                            <label class="block text-sm font-semibold text-gray-700 mb-2">
+                                Excerpt <span class="font-mono text-xs text-gray-400">[{{ $locale }}]</span>
+                            </label>
+                            <p class="text-xs text-gray-500 mb-2">Short summary shown in news listings. Optional.</p>
+                            <textarea name="excerpt_translations[{{ $locale }}]"
+                                id="ck-excerpt-{{ $locale }}"
+                                rows="4"
+                                class="news-ck-excerpt w-full">{{ old("excerpt_translations.{$locale}") }}
+                            </textarea>
+                        </div>
+                        <div>
+                            <label class="block text-sm font-semibold text-gray-700 mb-2">
+                                Content <span class="font-mono text-xs text-gray-400">[{{ $locale }}]</span>
+                                @if($locale === $defaultLocale) <span class="text-red-500">*</span> @endif
+                            </label>
+                            <textarea name="content_translations[{{ $locale }}]"
+                                      id="ck-content-{{ $locale }}"
+                                      rows="25"
+                                      data-required="{{ $locale === $defaultLocale ? 'true' : 'false' }}"
+                                      class="news-ck-editor w-full">{{ old("content_translations.{$locale}") }}</textarea>
+                        </div>
+                    </div>
+                    @endforeach
+                </div>
+
+                @else
+                {{-- Single language mode --}}
+
+                <div class="bg-white rounded-lg shadow">
+                    <div class="p-6 border-b border-gray-200">
+                        <h2 class="text-base font-bold text-gray-800">Excerpt</h2>
+                        <p class="text-xs text-gray-500 mt-0.5">Short summary shown in news listings. Optional.</p>
+                    </div>
+                    <div class="p-6">
+                        <textarea name="excerpt"
+                                  id="ck-excerpt-main"
+                                  rows="4"
+                                  class="news-ck-excerpt w-full">{{ old('excerpt') }}</textarea>
+                    </div>
+                </div>
+                <div class="bg-white rounded-lg shadow">
+                    <div class="p-6 border-b border-gray-200">
+                        <h2 class="text-lg font-bold text-gray-800">Content</h2>
+                    </div>
+                    <div class="p-6 space-y-4">
+                        <div>
+                            <label class="block text-sm font-semibold text-gray-700 mb-2">Title <span class="text-red-500">*</span></label>
+                            <input type="text"
+                                   name="title"
+                                   value="{{ old('title') }}"
+                                   required
+                                   class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500"
+                                   id="title-main"
+                                   placeholder="Article title">
+                            <p class="text-xs text-gray-400 mt-1">Slug will be auto-generated if left blank.</p>
+                        </div>
+                        <div>
+                            <label class="block text-sm font-semibold text-gray-700 mb-2">Excerpt</label>
+                            <p class="text-xs text-gray-500 mb-2">Short summary shown in news listings. Optional.</p>
+                            <textarea name="excerpt"
+                                      id="ck-excerpt-main"
+                                      rows="4"
+                                      class="news-ck-excerpt w-full">{{ old('excerpt') }}</textarea>
+                        </div>
+                        <div>
+                            <label class="block text-sm font-semibold text-gray-700 mb-2">Content <span class="text-red-500">*</span></label>
+                            <textarea name="content"
+                                      id="ck-content-main"
+                                      rows="25"
+                                      data-required="true"
+                                      class="news-ck-editor w-full">{{ old('content') }}</textarea>
+                        </div>
+                    </div>
+                </div>
+                @endif
+
+            </div>
+
+            {{-- Sidebar --}}
+            <div class="space-y-6">
+
+                {{-- Publish --}}
+                <div class="bg-white rounded-lg shadow">
+                    <div class="p-4 border-b border-gray-200">
+                        <h3 class="text-base font-bold text-gray-800">Publish</h3>
+                    </div>
+                    <div class="p-4 space-y-4">
+                        <div class="flex items-center gap-2">
+                            <input type="hidden" name="is_published" value="0">
+                            <input type="checkbox" id="is_published" name="is_published" value="1"
+                                   {{ old('is_published') ? 'checked' : '' }}
+                                   class="rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                            <label for="is_published" class="text-sm font-medium text-gray-700">Publish immediately</label>
+                        </div>
+                        <div>
+                            <label class="block text-xs font-semibold text-gray-600 mb-1">Publish date</label>
+                            <input type="datetime-local" name="published_at"
+                                   value="{{ old('published_at') }}"
+                                   class="w-full px-3 py-2 text-sm border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                        </div>
+                    </div>
+                    <div class="p-4 border-t border-gray-100">
+                        <button type="submit" form="news-form" class="w-full px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                            <i class="fas fa-save mr-1"></i> Save Article
+                        </button>
+                    </div>
+                </div>
+
+                {{-- Slug --}}
+                <div class="bg-white rounded-lg shadow">
+                    <div class="p-4 border-b border-gray-200">
+                        <h3 class="text-base font-bold text-gray-800">Permalink</h3>
+                    </div>
+                    <div class="p-4">
+                        <label class="block text-xs font-semibold text-gray-600 mb-1">Slug</label>
+                        <input type="text" name="slug" id="slug-input"
+                               value="{{ old('slug') }}"
+                               placeholder="auto-generated-from-title"
+                               class="w-full px-3 py-2 text-sm border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 font-mono">
+                        <p class="text-xs text-gray-400 mt-1">/news/<span id="slug-preview" class="font-medium">your-slug</span></p>
+                    </div>
+                </div>
+
+                {{-- Category --}}
+                <div class="bg-white rounded-lg shadow">
+                    <div class="p-4 border-b border-gray-200">
+                        <h3 class="text-base font-bold text-gray-800">Category</h3>
+                    </div>
+                    <div class="p-4">
+                        <select name="category_id" class="w-full px-3 py-2 text-sm border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                            <option value="">— No category —</option>
+                            @foreach($categories as $cat)
+                                <option value="{{ $cat->id }}" {{ old('category_id') == $cat->id ? 'selected' : '' }}>{{ $cat->name }}</option>
+                            @endforeach
+                        </select>
+                    </div>
+                </div>
+
+                {{-- Featured Image --}}
+                <div class="bg-white rounded-lg shadow">
+                    <div class="p-4 border-b border-gray-200">
+                        <h3 class="text-base font-bold text-gray-800">Featured Image</h3>
+                    </div>
+                    <div class="p-4">
+                        <div id="image-preview" class="hidden mb-3">
+                            <img id="image-preview-img" src="" alt="" class="w-full rounded-lg object-cover max-h-40">
+                        </div>
+                        <label class="block w-full cursor-pointer border-2 border-dashed border-gray-300 rounded-lg p-4 text-center hover:border-blue-400 transition">
+                            <i class="fas fa-cloud-upload-alt text-2xl text-gray-400 mb-1 block"></i>
+                            <span class="text-sm text-gray-500">Click to upload image</span>
+                            <input type="file" name="image" accept="image/*" class="hidden" onchange="previewImage(this)">
+                        </label>
+                        <p class="text-xs text-gray-400 mt-1">Recommended: 1200×630px, max 4MB</p>
+                    </div>
+                </div>
+
+            </div>
+        </div>
+    </form>
+</main>
+
+@push('scripts')
+<style>
+    .ck-editor__editable { min-height: 500px !important; }
+    .ck-excerpt .ck-editor__editable { min-height: 130px !important; }
+</style>
+<script src="https://cdn.ckeditor.com/ckeditor5/41.4.2/classic/ckeditor.js"></script>
+
+<script>
+    // ── CKEditor 5 instances ──────────────────────────────────────────────
+    const editors = {};
+
+    const ck5Config = {
+        licenseKey: 'GPL',
+        toolbar: [
+            'undo', 'redo',
+            '|',
+            'bold', 'italic', 'underline', 'strikethrough',
+            '|',
+            'numberedList', 'bulletedList',
+            '|',
+            'outdent', 'indent',
+            '|',
+            'blockQuote',
+            '|',
+            'link', 'insertTable', 'imageUpload',
+            '|',
+            'heading'
+        ],
+        image: {
+            toolbar: ['imageTextAlternative', 'imageStyle:inline', 'imageStyle:block', 'imageStyle:side']
+        },
+        table: {
+            contentToolbar: ['tableColumn', 'tableRow', 'mergeTableCells']
+        }
+    };
+
+    const ck5ExcerptConfig = {
+        licenseKey: 'GPL',
+        toolbar: ['bold', 'italic', '|', 'link', 'bulletedList', 'numberedList'],
+    };
+
+    document.querySelectorAll('.news-ck-editor').forEach(function (textarea) {
+        ClassicEditor
+            .create(textarea, ck5Config)
+            .then(editor => {
+                editors[textarea.name] = editor;
+            })
+            .catch(error => {
+                console.error(error);
+            });
+    });
+
+    document.querySelectorAll('.news-ck-excerpt').forEach(function (textarea) {
+        ClassicEditor
+            .create(textarea, ck5ExcerptConfig)
+            .then(editor => {
+                editors[textarea.name] = editor;
+                editor.ui.view.editable.element.closest('.ck-editor').classList.add('ck-excerpt');
+            })
+            .catch(error => {
+                console.error(error);
+            });
+    });
+
+    // ── Sync data + validate required fields before submit ───────────────
+    document.getElementById('news-form').addEventListener('submit', function (e) {
+        let valid = true;
+        for (const name in editors) {
+            const editor = editors[name];
+            const textarea = document.querySelector(`[name="${CSS.escape(name)}"]`);
+            if (textarea) {
+                const data = editor.getData();
+                textarea.value = data;
+                if (textarea.dataset.required === 'true' && !data.trim()) {
+                    valid = false;
+                    editor.ui.view.editable.element.style.border = '2px solid #ef4444';
+                    editor.ui.view.editable.element.scrollIntoView({ behavior: 'smooth', block: 'center' });
+                } else {
+                    if (editor.ui.view.editable.element) {
+                        editor.ui.view.editable.element.style.border = '';
+                    }
+                }
+            }
+        }
+        if (!valid) e.preventDefault();
+    });
+
+    // ── Tab switching ─────────────────────────────────────────────────────
+    function switchTab(locale) {
+        document.querySelectorAll('.lang-panel').forEach(p => p.classList.add('hidden'));
+        document.querySelectorAll('.lang-tab').forEach(t => {
+            t.classList.remove('border-blue-500', 'text-blue-600');
+            t.classList.add('border-transparent', 'text-gray-500');
+        });
+        document.getElementById('tab-' + locale)?.classList.remove('hidden');
+        document.querySelector('[data-locale="' + locale + '"]')?.classList.add('border-blue-500', 'text-blue-600');
+        document.querySelector('[data-locale="' + locale + '"]')?.classList.remove('border-transparent', 'text-gray-500');
+    }
+
+    // ── Slug generation ───────────────────────────────────────────────────
+    const defaultTitleInput = document.getElementById('title-{{ $defaultLocale }}') || document.getElementById('title-main');
+    const slugInput = document.getElementById('slug-input');
+    const slugPreview = document.getElementById('slug-preview');
+
+    function slugify(text) {
+        return text.toString().toLowerCase()
+            .normalize('NFD').replace(/[\u0300-\u036f]/g, '')
+            .replace(/\s+/g, '-').replace(/[^\w\-]+/g, '')
+            .replace(/\-\-+/g, '-').replace(/^-+/, '').replace(/-+$/, '');
+    }
+
+    if (defaultTitleInput) {
+        defaultTitleInput.addEventListener('input', function () {
+            if (!slugInput.value) {
+                slugPreview.textContent = slugify(this.value) || 'your-slug';
+            }
+        });
+    }
+
+    slugInput.addEventListener('input', function () {
+        slugPreview.textContent = slugify(this.value) || 'your-slug';
+    });
+
+    // ── Image preview ─────────────────────────────────────────────────────
+    function previewImage(input) {
+        const preview = document.getElementById('image-preview');
+        const img = document.getElementById('image-preview-img');
+        if (input.files && input.files[0]) {
+            const reader = new FileReader();
+            reader.onload = e => {
+                img.src = e.target.result;
+                preview.classList.remove('hidden');
+            };
+            reader.readAsDataURL(input.files[0]);
+        }
+    }
+</script>
+@endpush
+@endsection
\ No newline at end of file
diff --git a/app/Modules/Admin/Resources/views/news/edit.blade.php b/app/Modules/Admin/Resources/views/news/edit.blade.php
new file mode 100644
index 0000000..03c413a
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/news/edit.blade.php
@@ -0,0 +1,407 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Edit News Article')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <a href="{{ route('admin.news.index') }}" class="text-gray-500 hover:text-gray-700">
+            <i class="fas fa-arrow-left"></i>
+        </a>
+        <h1 class="text-2xl font-bold text-gray-800">Edit Article</h1>
+        <span class="text-sm text-gray-400 font-mono">/news/{{ $news->slug }}</span>
+    </div>
+    <div class="flex items-center gap-3">
+        <a href="{{ route('news.show', $news->slug) }}" target="_blank" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
+            <i class="fas fa-eye mr-1"></i> View
+        </a>
+        <button type="submit" form="news-form" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+            <i class="fas fa-save mr-1"></i> Save Changes
+        </button>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if(session('success'))
+        <div class="mb-4 p-3 bg-green-50 text-green-700 border border-green-200 rounded-lg flex items-center gap-2">
+            <i class="fas fa-check-circle"></i> {{ session('success') }}
+        </div>
+    @endif
+    @if($errors->any())
+        <div class="mb-4 p-4 bg-red-50 border border-red-200 rounded-lg">
+            <p class="text-sm font-semibold text-red-700 mb-1">Please fix the following errors:</p>
+            <ul class="list-disc list-inside text-sm text-red-600 space-y-1">
+                @foreach($errors->all() as $error)
+                    <li>{{ $error }}</li>
+                @endforeach
+            </ul>
+        </div>
+    @endif
+
+    <form id="news-form" method="POST" action="{{ route('admin.news.update', $news) }}" enctype="multipart/form-data">
+        @csrf
+        @method('PUT')
+        <div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
+
+            {{-- Main content --}}
+            <div class="lg:col-span-2 space-y-6">
+
+                @if($isMultilingual && count($activeLocales) > 1)
+                {{-- Excerpt (non-translated) --}}
+                <div class="bg-white rounded-lg shadow">
+                    <div class="p-6 border-b border-gray-200">
+                        <h2 class="text-base font-bold text-gray-800">Excerpt</h2>
+                        <p class="text-xs text-gray-500 mt-0.5">Short summary shown in news listings. Optional.</p>
+                    </div>
+                    <div class="p-6">
+                        <textarea name="excerpt"
+                                  id="ck-excerpt-main"
+                                  rows="4"
+                                  class="news-ck-excerpt w-full">{{ old('excerpt', $news->excerpt) }}</textarea>
+                    </div>
+                </div>
+
+                {{-- Multilingual tabs --}}
+                <div class="bg-white rounded-lg shadow">
+                    <div class="border-b border-gray-200 px-4">
+                        <nav class="-mb-px flex gap-1" id="lang-tabs">
+                            @foreach($activeLocales as $i => $locale)
+                            <button type="button"
+                                    data-locale="{{ $locale }}"
+                                    onclick="switchTab('{{ $locale }}')"
+                                    class="lang-tab px-4 py-3 text-sm font-medium border-b-2 transition-colors whitespace-nowrap
+                                           {{ $i === 0 ? 'border-blue-500 text-blue-600' : 'border-transparent text-gray-500 hover:text-gray-700' }}">
+                                <span class="inline-flex items-center gap-1.5">
+                                    <span class="text-xs font-mono px-1.5 py-0.5 rounded bg-gray-100">{{ strtoupper($locale) }}</span>
+                                    {{ $localeNames[$locale] ?? $locale }}
+                                    @if($locale === $defaultLocale)
+                                        <span class="text-[10px] text-blue-400">(default)</span>
+                                    @endif
+                                    @php
+                                        $hasTranslation = !empty($news->title_translations[$locale]);
+                                    @endphp
+                                    @if($hasTranslation)
+                                        <span class="w-1.5 h-1.5 rounded-full bg-green-400 inline-block" title="Has translation"></span>
+                                    @endif
+                                </span>
+                            </button>
+                            @endforeach
+                        </nav>
+                    </div>
+
+                    @foreach($activeLocales as $i => $locale)
+                    <div id="tab-{{ $locale }}" class="lang-panel p-6 space-y-4 {{ $i !== 0 ? 'hidden' : '' }}">
+                        <div>
+                            <label class="block text-sm font-semibold text-gray-700 mb-2">
+                                Title <span class="font-mono text-xs text-gray-400">[{{ $locale }}]</span>
+                                @if($locale === $defaultLocale) <span class="text-red-500">*</span> @endif
+                            </label>
+                            <input type="text"
+                                   name="title_translations[{{ $locale }}]"
+                                   value="{{ old("title_translations.{$locale}", $news->title_translations[$locale] ?? '') }}"
+                                   class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500"
+                                   {{ $locale === $defaultLocale ? 'required' : '' }}
+                                   placeholder="Article title in {{ $localeNames[$locale] ?? $locale }}">
+                        </div>
+                        <div>
+                            <label class="block text-sm font-semibold text-gray-700 mb-2">
+                                Content <span class="font-mono text-xs text-gray-400">[{{ $locale }}]</span>
+                                @if($locale === $defaultLocale) <span class="text-red-500">*</span> @endif
+                            </label>
+                            <textarea name="content_translations[{{ $locale }}]"
+                                      id="ck-content-{{ $locale }}"
+                                      rows="25"
+                                      data-required="{{ $locale === $defaultLocale ? 'true' : 'false' }}"
+                                      class="news-ck-editor w-full">{{ old("content_translations.{$locale}", $news->content_translations[$locale] ?? '') }}</textarea>
+                        </div>
+                    </div>
+                    @endforeach
+                </div>
+
+                @else
+                {{-- Single language mode --}}
+                <div class="bg-white rounded-lg shadow">
+                    <div class="p-6 border-b border-gray-200">
+                        <h2 class="text-lg font-bold text-gray-800">Content</h2>
+                    </div>
+                    <div class="p-6 space-y-4">
+                        <div>
+                            <label class="block text-sm font-semibold text-gray-700 mb-2">Title <span class="text-red-500">*</span></label>
+                            <input type="text"
+                                   name="title"
+                                   value="{{ old('title', $news->title) }}"
+                                   required
+                                   class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                        </div>
+                        <div>
+                            <label class="block text-sm font-semibold text-gray-700 mb-2">Excerpt</label>
+                            <p class="text-xs text-gray-500 mb-2">Short summary shown in news listings. Optional.</p>
+                            <textarea name="excerpt"
+                                      id="ck-excerpt-main"
+                                      rows="4"
+                                      class="news-ck-excerpt w-full">{{ old('excerpt', $news->excerpt) }}</textarea>
+                        </div>
+                        <div>
+                            <label class="block text-sm font-semibold text-gray-700 mb-2">Content <span class="text-red-500">*</span></label>
+                            <textarea name="content"
+                                      id="ck-content-main"
+                                      rows="25"
+                                      data-required="true"
+                                      class="news-ck-editor w-full">{{ old('content', $news->content) }}</textarea>
+                        </div>
+                    </div>
+                </div>
+                @endif
+
+            </div>
+
+            {{-- Sidebar --}}
+            <div class="space-y-6">
+
+                {{-- Publish --}}
+                <div class="bg-white rounded-lg shadow">
+                    <div class="p-4 border-b border-gray-200">
+                        <h3 class="text-base font-bold text-gray-800">Publish</h3>
+                    </div>
+                    <div class="p-4 space-y-4">
+                        <div class="flex items-center gap-2">
+                            <input type="hidden" name="is_published" value="0">
+                            <input type="checkbox" id="is_published" name="is_published" value="1"
+                                   {{ old('is_published', $news->is_published) ? 'checked' : '' }}
+                                   class="rounded border-gray-300 text-blue-600 focus:ring-blue-500">
+                            <label for="is_published" class="text-sm font-medium text-gray-700">Published</label>
+                        </div>
+                        <div>
+                            <label class="block text-xs font-semibold text-gray-600 mb-1">Publish date</label>
+                            <input type="datetime-local" name="published_at"
+                                   value="{{ old('published_at', $news->published_at?->format('Y-m-d\TH:i')) }}"
+                                   class="w-full px-3 py-2 text-sm border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                        </div>
+                        <div class="text-xs text-gray-400">
+                            Created: {{ $news->created_at->format('M d, Y H:i') }}<br>
+                            Updated: {{ $news->updated_at->format('M d, Y H:i') }}
+                        </div>
+                    </div>
+                    <div class="p-4 border-t border-gray-100">
+                        <button type="submit" form="news-form" class="w-full px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                            <i class="fas fa-save mr-1"></i> Save Changes
+                        </button>
+                    </div>
+                </div>
+
+                {{-- Slug --}}
+                <div class="bg-white rounded-lg shadow">
+                    <div class="p-4 border-b border-gray-200">
+                        <h3 class="text-base font-bold text-gray-800">Permalink</h3>
+                    </div>
+                    <div class="p-4">
+                        <label class="block text-xs font-semibold text-gray-600 mb-1">Slug</label>
+                        <input type="text" name="slug" id="slug-input"
+                               value="{{ old('slug', $news->slug) }}"
+                               class="w-full px-3 py-2 text-sm border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 font-mono">
+                        <p class="text-xs text-gray-400 mt-1">/news/<span id="slug-preview">{{ $news->slug }}</span></p>
+                    </div>
+                </div>
+
+                {{-- Category --}}
+                <div class="bg-white rounded-lg shadow">
+                    <div class="p-4 border-b border-gray-200">
+                        <h3 class="text-base font-bold text-gray-800">Category</h3>
+                    </div>
+                    <div class="p-4">
+                        <select name="category_id" class="w-full px-3 py-2 text-sm border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
+                            <option value="">— No category —</option>
+                            @foreach($categories as $cat)
+                                <option value="{{ $cat->id }}" {{ old('category_id', $news->category_id) == $cat->id ? 'selected' : '' }}>{{ $cat->name }}</option>
+                            @endforeach
+                        </select>
+                    </div>
+                </div>
+
+                {{-- Featured Image --}}
+                <div class="bg-white rounded-lg shadow">
+                    <div class="p-4 border-b border-gray-200">
+                        <h3 class="text-base font-bold text-gray-800">Featured Image</h3>
+                    </div>
+                    <div class="p-4">
+                        @if($news->image)
+                        <div class="mb-3">
+                            <img src="{{ asset('storage/images/' . $news->image) }}" alt="" class="w-full rounded-lg object-cover max-h-40">
+                            <p class="text-xs text-gray-400 mt-1">Current image. Upload a new one to replace.</p>
+                        </div>
+                        @endif
+                        <div id="image-preview" class="hidden mb-3">
+                            <img id="image-preview-img" src="" alt="" class="w-full rounded-lg object-cover max-h-40">
+                        </div>
+                        <label class="block w-full cursor-pointer border-2 border-dashed border-gray-300 rounded-lg p-4 text-center hover:border-blue-400 transition">
+                            <i class="fas fa-cloud-upload-alt text-2xl text-gray-400 mb-1 block"></i>
+                            <span class="text-sm text-gray-500">{{ $news->image ? 'Replace image' : 'Upload image' }}</span>
+                            <input type="file" name="image" accept="image/*" class="hidden" onchange="previewImage(this)">
+                        </label>
+                    </div>
+                </div>
+
+                {{-- Danger zone --}}
+                <div class="bg-white rounded-lg shadow border border-red-100">
+                    <div class="p-4 border-b border-red-100">
+                        <h3 class="text-base font-bold text-red-700">Danger Zone</h3>
+                    </div>
+                    <div class="p-4">
+                        <button type="submit" form="delete-news-form"
+                                onclick="return confirm('Are you sure you want to delete this article?')"
+                                class="w-full px-4 py-2 bg-red-50 text-red-700 border border-red-200 rounded-lg hover:bg-red-100 text-sm font-medium transition">
+                            <i class="fas fa-trash mr-1"></i> Delete Article
+                        </button>
+                    </div>
+                </div>
+
+            </div>
+        </div>
+    </form>
+
+    {{-- Delete form is intentionally OUTSIDE the main form to prevent _method conflicts --}}
+    <form id="delete-news-form" method="POST" action="{{ route('admin.news.destroy', $news) }}">
+        @csrf
+        @method('DELETE')
+    </form>
+</main>
+
+@push('scripts')
+<style>
+    .ck-editor__editable { min-height: 500px !important; }
+    .ck-excerpt .ck-editor__editable { min-height: 130px !important; }
+</style>
+<script src="https://cdn.ckeditor.com/ckeditor5/41.4.2/classic/ckeditor.js"></script>
+
+<script>
+    // ── CKEditor 5 instances ──────────────────────────────────────────────
+    const editors = {};
+
+    const ck5Config = {
+        licenseKey: 'GPL',
+        toolbar: [
+            'undo', 'redo',
+            '|',
+            'bold', 'italic', 'underline', 'strikethrough',
+            '|',
+            'numberedList', 'bulletedList',
+            '|',
+            'outdent', 'indent',
+            '|',
+            'blockQuote',
+            '|',
+            'link', 'insertTable', 'imageUpload',
+            '|',
+            'heading'
+        ],
+        image: {
+            toolbar: ['imageTextAlternative', 'imageStyle:inline', 'imageStyle:block', 'imageStyle:side']
+        },
+        table: {
+            contentToolbar: ['tableColumn', 'tableRow', 'mergeTableCells']
+        }
+    };
+
+    const ck5ExcerptConfig = {
+        licenseKey: 'GPL',
+        toolbar: ['bold', 'italic', '|', 'link', 'bulletedList', 'numberedList'],
+    };
+
+    document.querySelectorAll('.news-ck-editor').forEach(function (textarea) {
+        ClassicEditor
+            .create(textarea, ck5Config)
+            .then(editor => {
+                editors[textarea.name] = editor;
+            })
+            .catch(error => {
+                console.error(error);
+            });
+    });
+
+    document.querySelectorAll('.news-ck-excerpt').forEach(function (textarea) {
+        ClassicEditor
+            .create(textarea, ck5ExcerptConfig)
+            .then(editor => {
+                editors[textarea.name] = editor;
+                editor.ui.view.editable.element.closest('.ck-editor').classList.add('ck-excerpt');
+            })
+            .catch(error => {
+                console.error(error);
+            });
+    });
+
+    // ── Sync data + validate required fields before submit ───────────────
+    document.getElementById('news-form').addEventListener('submit', function (e) {
+        let valid = true;
+        for (const name in editors) {
+            const editor = editors[name];
+            const textarea = document.querySelector(`[name="${CSS.escape(name)}"]`);
+            if (textarea) {
+                const data = editor.getData();
+                textarea.value = data;
+                if (textarea.dataset.required === 'true' && !data.trim()) {
+                    valid = false;
+                    editor.ui.view.editable.element.style.border = '2px solid #ef4444';
+                    editor.ui.view.editable.element.scrollIntoView({ behavior: 'smooth', block: 'center' });
+                } else {
+                    if (editor.ui.view.editable.element) {
+                        editor.ui.view.editable.element.style.border = '';
+                    }
+                }
+            }
+        }
+        if (!valid) e.preventDefault();
+    });
+
+    // ── Tab switching ─────────────────────────────────────────────────────
+    function switchTab(locale) {
+        document.querySelectorAll('.lang-panel').forEach(p => p.classList.add('hidden'));
+        document.querySelectorAll('.lang-tab').forEach(t => {
+            t.classList.remove('border-blue-500', 'text-blue-600');
+            t.classList.add('border-transparent', 'text-gray-500');
+        });
+        document.getElementById('tab-' + locale)?.classList.remove('hidden');
+        document.querySelector('[data-locale="' + locale + '"]')?.classList.add('border-blue-500', 'text-blue-600');
+        document.querySelector('[data-locale="' + locale + '"]')?.classList.remove('border-transparent', 'text-gray-500');
+    }
+
+    // ── Slug generation ───────────────────────────────────────────────────
+    const defaultTitleInput = document.getElementById('title-{{ $defaultLocale }}') || document.getElementById('title-main');
+    const slugInput = document.getElementById('slug-input');
+    const slugPreview = document.getElementById('slug-preview');
+
+    function slugify(text) {
+        return text.toString().toLowerCase()
+            .normalize('NFD').replace(/[\u0300-\u036f]/g, '')
+            .replace(/\s+/g, '-').replace(/[^\w\-]+/g, '')
+            .replace(/\-\-+/g, '-').replace(/^-+/, '').replace(/-+$/, '');
+    }
+
+    if (defaultTitleInput) {
+        defaultTitleInput.addEventListener('input', function () {
+            if (!slugInput.value) {
+                slugPreview.textContent = slugify(this.value) || 'your-slug';
+            }
+        });
+    }
+
+    slugInput.addEventListener('input', function () {
+        slugPreview.textContent = slugify(this.value) || 'your-slug';
+    });
+
+    // ── Image preview ─────────────────────────────────────────────────────
+    function previewImage(input) {
+        const preview = document.getElementById('image-preview');
+        const img = document.getElementById('image-preview-img');
+        if (input.files && input.files[0]) {
+            const reader = new FileReader();
+            reader.onload = e => {
+                img.src = e.target.result;
+                preview.classList.remove('hidden');
+            };
+            reader.readAsDataURL(input.files[0]);
+        }
+    }
+</script>
+@endpush
+@endsection
\ No newline at end of file
diff --git a/app/Modules/Admin/Resources/views/news/index.blade.php b/app/Modules/Admin/Resources/views/news/index.blade.php
new file mode 100644
index 0000000..261471c
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/news/index.blade.php
@@ -0,0 +1,140 @@
+@extends('admin::layouts.app')
+
+@section('title', 'News')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">News Management</h1>
+    </div>
+    <div class="flex items-center gap-3">
+        <a href="{{ route('admin.news.categories.index') }}" class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
+            <i class="fas fa-tags mr-1"></i> Categories
+        </a>
+        <a href="{{ route('admin.news.create') }}" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+            <i class="fas fa-plus mr-1"></i> New Article
+        </a>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if(session('success'))
+        <div class="mb-4 p-3 bg-green-50 text-green-700 border border-green-200 rounded-lg flex items-center gap-2">
+            <i class="fas fa-check-circle"></i> {{ session('success') }}
+        </div>
+    @endif
+    @if(session('error'))
+        <div class="mb-4 p-3 bg-red-50 text-red-700 border border-red-200 rounded-lg flex items-center gap-2">
+            <i class="fas fa-exclamation-circle"></i> {{ session('error') }}
+        </div>
+    @endif
+
+    <div class="bg-white rounded-lg shadow">
+        <div class="p-6 border-b border-gray-200 flex items-center justify-between">
+            <h2 class="text-lg font-bold text-gray-800">All Articles</h2>
+            <span class="text-sm text-gray-500">{{ $news->total() }} articles</span>
+        </div>
+
+        <div class="overflow-x-auto">
+            <table class="w-full text-sm">
+                <thead>
+                    <tr class="border-b border-gray-100 bg-gray-50">
+                        <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">Title</th>
+                        <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">Category</th>
+                        <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">Author</th>
+                        <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">Status</th>
+                        <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">Date</th>
+                        <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">Actions</th>
+                    </tr>
+                </thead>
+                <tbody class="divide-y divide-gray-100">
+                    @forelse($news as $article)
+                    <tr class="{{ $article->trashed() ? 'bg-red-50/30 opacity-60' : 'hover:bg-gray-50' }} transition-colors">
+                        <td class="px-6 py-4">
+                            <div class="flex items-center gap-3">
+                                @if($article->image)
+                                    <img src="{{ asset('storage/images/' . $article->image) }}" alt="" class="w-10 h-10 rounded object-cover flex-shrink-0">
+                                @else
+                                    <div class="w-10 h-10 rounded bg-gray-100 flex items-center justify-center flex-shrink-0">
+                                        <i class="fas fa-newspaper text-gray-400"></i>
+                                    </div>
+                                @endif
+                                <div>
+                                    <p class="font-medium text-gray-800 line-clamp-1">{{ $article->title }}</p>
+                                    <p class="text-xs text-gray-400 font-mono">/news/{{ $article->slug }}</p>
+                                    @if($article->title_translations)
+                                        <div class="flex gap-1 mt-1">
+                                            @foreach(array_keys($article->title_translations) as $locale)
+                                                <span class="text-[10px] px-1.5 py-0.5 bg-blue-50 text-blue-600 rounded font-mono">{{ $locale }}</span>
+                                            @endforeach
+                                        </div>
+                                    @endif
+                                </div>
+                            </div>
+                        </td>
+                        <td class="px-6 py-4 text-gray-600">{{ $article->category->name ?? '—' }}</td>
+                        <td class="px-6 py-4 text-gray-600">{{ $article->author->name ?? '—' }}</td>
+                        <td class="px-6 py-4">
+                            @if($article->trashed())
+                                <span class="inline-flex items-center gap-1 px-2 py-1 rounded-full text-xs font-medium bg-red-100 text-red-700">
+                                    <i class="fas fa-trash text-[10px]"></i> Deleted
+                                </span>
+                            @elseif($article->is_published)
+                                <span class="inline-flex items-center gap-1 px-2 py-1 rounded-full text-xs font-medium bg-green-100 text-green-700">
+                                    <i class="fas fa-circle text-[8px]"></i> Published
+                                </span>
+                            @else
+                                <span class="inline-flex items-center gap-1 px-2 py-1 rounded-full text-xs font-medium bg-yellow-100 text-yellow-700">
+                                    <i class="fas fa-circle text-[8px]"></i> Draft
+                                </span>
+                            @endif
+                        </td>
+                        <td class="px-6 py-4 text-gray-500 text-xs whitespace-nowrap">
+                            {{ $article->published_at ? $article->published_at->format('M d, Y') : $article->created_at->format('M d, Y') }}
+                        </td>
+                        <td class="px-6 py-4">
+                            <div class="flex items-center gap-2">
+                                @if($article->trashed())
+                                    <form method="POST" action="{{ route('admin.news.restore', $article->id) }}">
+                                        @csrf @method('PATCH')
+                                        <button type="submit" class="px-3 py-1 bg-green-100 text-green-700 rounded hover:bg-green-200 text-xs font-medium">
+                                            Restore
+                                        </button>
+                                    </form>
+                                @else
+                                    <a href="{{ route('admin.news.edit', $article) }}" class="px-3 py-1 bg-gray-100 text-gray-700 rounded hover:bg-gray-200 text-xs font-medium">
+                                        Edit
+                                    </a>
+                                    <a href="{{ route('news.show', $article->slug) }}" target="_blank" class="px-3 py-1 bg-blue-50 text-blue-700 rounded hover:bg-blue-100 text-xs font-medium">
+                                        View
+                                    </a>
+                                    <form method="POST" action="{{ route('admin.news.destroy', $article) }}" onsubmit="return confirm('Delete this article?')">
+                                        @csrf @method('DELETE')
+                                        <button type="submit" class="px-3 py-1 bg-red-50 text-red-700 rounded hover:bg-red-100 text-xs font-medium">
+                                            Delete
+                                        </button>
+                                    </form>
+                                @endif
+                            </div>
+                        </td>
+                    </tr>
+                    @empty
+                    <tr>
+                        <td colspan="6" class="px-6 py-12 text-center text-gray-400">
+                            <i class="fas fa-newspaper text-3xl mb-2 block"></i>
+                            No news articles found. <a href="{{ route('admin.news.create') }}" class="text-blue-600 hover:underline">Create the first one</a>.
+                        </td>
+                    </tr>
+                    @endforelse
+                </tbody>
+            </table>
+        </div>
+
+        @if($news->hasPages())
+        <div class="px-6 py-4 border-t border-gray-100">
+            {{ $news->links() }}
+        </div>
+        @endif
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/settings/index.blade.php b/app/Modules/Admin/Resources/views/settings/index.blade.php
index 9a47424..51eb074 100644
--- a/app/Modules/Admin/Resources/views/settings/index.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/index.blade.php
@@ -34,35 +34,4 @@
 
     </main>
 </div>
-
-@push('scripts')
-<script>
-    document.addEventListener('DOMContentLoaded', function() {
-        const form = document.getElementById('settings-form');
-        const saveBtn = document.getElementById('save-settings-btn');
-        
-        if (!form || !saveBtn) return;
-
-        function checkFormValidity() {
-            const inputs = form.querySelectorAll('input:not([type="hidden"]):not([type="checkbox"]), select, textarea');
-            let isValid = true;
-
-            inputs.forEach(input => {
-                if (!input.value.trim()) {
-                    isValid = false;
-                }
-            });
-
-            saveBtn.disabled = !isValid;
-        }
-
-        // Check initially
-        checkFormValidity();
-
-        // Listen for changes
-        form.addEventListener('input', checkFormValidity);
-        form.addEventListener('change', checkFormValidity);
-    });
-</script>
-@endpush
 @endsection
diff --git a/app/Modules/Admin/Resources/views/settings/localization.blade.php b/app/Modules/Admin/Resources/views/settings/localization.blade.php
index 3a0f982..cdd98cf 100644
--- a/app/Modules/Admin/Resources/views/settings/localization.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/localization.blade.php
@@ -1,54 +1,205 @@
 @extends('admin::settings.index')
 
 @section('settings_content')
+<div class="space-y-6">
+
+{{-- Existing locale/timezone settings --}}
 <div class="bg-white rounded-lg shadow">
     <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">{{ __('Localization Settings') }}</h2>
-        <p class="text-sm text-gray-600 mt-1">{{ __('Configure language, time, and currency preferences') }}</p>
+        <h2 class="text-xl font-bold text-gray-800">{{ __('admin::settings.localization.title') }}</h2>
+        <p class="text-sm text-gray-600 mt-1">{{ __('admin::settings.localization.description') }}</p>
     </div>
     <div class="p-6 space-y-4">
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label for="default_locale" class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Default Locale') }}</label>
+                <label for="default_locale" class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.localization.default_locale.label') }}</label>
                 <select id="default_locale" name="default_locale" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     @foreach(config('app.available_locales', ['en' => 'English', 'es' => 'Español', 'fr' => 'Français']) as $code => $name)
                         <option value="{{ $code }}" {{ ($settings['default_locale'] ?? config('app.locale')) == $code ? 'selected' : '' }}>{{ $name }}</option>
                     @endforeach
                 </select>
-                <p class="mt-1 text-xs text-gray-500">{{ __('The default language for the application.') }}</p>
+                <p class="mt-1 text-xs text-gray-500">{{ __('admin::settings.localization.default_locale.help') }}</p>
             </div>
 
             <div>
-                <label for="timezone" class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Timezone') }}</label>
+                <label for="timezone" class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.localization.timezone.label') }}</label>
                 <select id="timezone" name="timezone" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     @foreach(timezone_identifiers_list() as $tz)
                         <option value="{{ $tz }}" {{ ($settings['timezone'] ?? config('app.timezone')) == $tz ? 'selected' : '' }}>{{ $tz }}</option>
                     @endforeach
                 </select>
-                <p class="mt-1 text-xs text-gray-500">{{ __('System-wide timezone setting.') }}</p> 
+                <p class="mt-1 text-xs text-gray-500">{{ __('admin::settings.localization.timezone.help') }}</p>
             </div>
         </div>
 
         <div class="grid md:grid-cols-2 gap-4">
             <div>
-                <label for="date_format" class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Date Format') }}</label>
+                <label for="date_format" class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.localization.date_format.label') }}</label>
                 <select id="date_format" name="date_format" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="Y-m-d" {{ ($settings['date_format'] ?? 'Y-m-d') == 'Y-m-d' ? 'selected' : '' }}>Y-m-d ({{ date('Y-m-d') }})</option>
                     <option value="d/m/Y" {{ ($settings['date_format'] ?? '') == 'd/m/Y' ? 'selected' : '' }}>d/m/Y ({{ date('d/m/Y') }})</option>
                     <option value="m/d/Y" {{ ($settings['date_format'] ?? '') == 'm/d/Y' ? 'selected' : '' }}>m/d/Y ({{ date('m/d/Y') }})</option>
                 </select>
-                <p class="mt-1 text-xs text-gray-500">{{ __('Display format for dates.') }}</p>
+                <p class="mt-1 text-xs text-gray-500">{{ __('admin::settings.localization.date_format.help') }}</p>
             </div>
 
             <div>
-                <label for="time_format" class="block text-sm font-semibold text-gray-700 mb-2">{{ __('Time Format') }}</label>
+                <label for="time_format" class="block text-sm font-semibold text-gray-700 mb-2">{{ __('admin::settings.localization.time_format.label') }}</label>
                 <select id="time_format" name="time_format" class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500">
                     <option value="H:i" {{ ($settings['time_format'] ?? 'H:i') == 'H:i' ? 'selected' : '' }}>24-hour ({{ date('H:i') }})</option>
                     <option value="h:i A" {{ ($settings['time_format'] ?? '') == 'h:i A' ? 'selected' : '' }}>12-hour ({{ date('h:i A') }})</option>
                 </select>
-                <p class="mt-1 text-xs text-gray-500">{{ __('Display format for times.') }}</p>
+                <p class="mt-1 text-xs text-gray-500">{{ __('admin::settings.localization.time_format.help') }}</p>
             </div>
         </div>
     </div>
 </div>
+
+{{-- Multilingual content settings --}}
+<div class="bg-white rounded-lg shadow">
+    <div class="p-6 border-b border-gray-200">
+        <h2 class="text-xl font-bold text-gray-800">{{ __('admin::settings.localization.multilingual.section_title') }}</h2>
+        <p class="text-sm text-gray-600 mt-1">{{ __('admin::settings.localization.multilingual.section_description') }}</p>
+    </div>
+    <div class="p-6 space-y-6">
+
+        {{-- Toggle --}}
+        <div class="flex items-start gap-3">
+            <input type="hidden" name="multilingual_enabled" value="0">
+            <input type="checkbox"
+                   id="multilingual_enabled"
+                   name="multilingual_enabled"
+                   value="1"
+                   {{ ($settings['multilingual_enabled'] ?? '0') == '1' ? 'checked' : '' }}
+                   class="mt-0.5 h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500"
+                   onchange="toggleLocalesPanel(this.checked)">
+            <div>
+                <label for="multilingual_enabled" class="text-sm font-semibold text-gray-700 cursor-pointer">
+                    {{ __('admin::settings.localization.multilingual.enabled_label') }}
+                </label>
+                <p class="text-xs text-gray-500 mt-0.5">{{ __('admin::settings.localization.multilingual.enabled_help') }}</p>
+            </div>
+        </div>
+
+        {{-- Available locales manager --}}
+        <div id="locales-panel" class="{{ ($settings['multilingual_enabled'] ?? '0') != '1' ? 'hidden' : '' }} space-y-4">
+            <div>
+                <label class="block text-sm font-semibold text-gray-700 mb-1">
+                    {{ __('admin::settings.localization.multilingual.locales_label') }}
+                </label>
+                <p class="text-xs text-gray-500 mb-3">{{ __('admin::settings.localization.multilingual.locales_help') }}</p>
+
+                {{-- Hidden input stores the JSON array --}}
+                <input type="hidden" id="available_locales_input" name="available_locales" value="{{ $settings['available_locales'] ?? '["en"]' }}">
+
+                {{-- Visual tag list --}}
+                <div id="locales-tags" class="flex flex-wrap gap-2 mb-3 min-h-[36px] p-2 border border-gray-200 rounded-lg bg-gray-50">
+                    {{-- Rendered by JS --}}
+                </div>
+
+                {{-- Add locale input --}}
+                <div class="flex gap-2">
+                    <input type="text"
+                           id="locale-add-input"
+                           placeholder="{{ __('admin::settings.localization.multilingual.locale_placeholder') }}"
+                           maxlength="10"
+                           class="w-40 px-3 py-2 border border-gray-300 rounded-lg text-sm focus:outline-none focus:ring-2 focus:ring-blue-500">
+                    <button type="button"
+                            onclick="addLocale()"
+                            class="px-4 py-2 bg-blue-600 text-white rounded-lg text-sm hover:bg-blue-700 transition">
+                        <i class="fas fa-plus mr-1"></i> {{ __('admin::settings.localization.multilingual.add_locale') }}
+                    </button>
+                </div>
+
+                {{-- Known locale quick-add --}}
+                @php
+                    $knownLocales = ['en' => 'English', 'es' => 'Español', 'fr' => 'Français', 'de' => 'Deutsch', 'it' => 'Italiano', 'pt' => 'Português', 'ru' => 'Русский'];
+                @endphp
+                <div class="mt-3 flex flex-wrap gap-2">
+                    @foreach($knownLocales as $code => $name)
+                        <button type="button"
+                                onclick="addLocaleCode('{{ $code }}')"
+                                class="px-2 py-1 text-xs bg-white border border-gray-300 rounded hover:bg-blue-50 hover:border-blue-400 transition text-gray-700">
+                            + {{ $code }} ({{ $name }})
+                        </button>
+                    @endforeach
+                </div>
+            </div>
+        </div>
+
+    </div>
+</div>
+
+</div>
+
+@push('scripts')
+<script>
+    const defaultLocale = '{{ $settings['default_locale'] ?? config('app.locale', 'en') }}';
+
+    function getLocales() {
+        try {
+            const val = document.getElementById('available_locales_input').value;
+            return JSON.parse(val) || [];
+        } catch(e) { return []; }
+    }
+
+    function saveLocales(arr) {
+        // Always ensure the default locale is present
+        if (!arr.includes(defaultLocale)) arr.unshift(defaultLocale);
+        document.getElementById('available_locales_input').value = JSON.stringify(arr);
+        renderTags(arr);
+    }
+
+    function renderTags(arr) {
+        const container = document.getElementById('locales-tags');
+        container.innerHTML = '';
+        arr.forEach(code => {
+            const tag = document.createElement('span');
+            tag.className = 'inline-flex items-center gap-1 px-2.5 py-1 rounded-full text-xs font-medium ' +
+                (code === defaultLocale ? 'bg-blue-100 text-blue-800' : 'bg-gray-100 text-gray-700');
+            tag.innerHTML = `<span>${code}</span>` +
+                (code === defaultLocale
+                    ? `<span class="text-blue-500 text-[10px] ml-1">(default)</span>`
+                    : `<button type="button" onclick="removeLocale('${code}')" class="ml-1 text-gray-400 hover:text-red-500 leading-none">&times;</button>`);
+            container.appendChild(tag);
+        });
+    }
+
+    function addLocale() {
+        const input = document.getElementById('locale-add-input');
+        addLocaleCode(input.value.trim().toLowerCase());
+        input.value = '';
+    }
+
+    function addLocaleCode(code) {
+        if (!code || !/^[a-z]{2,5}$/.test(code)) return;
+        const arr = getLocales();
+        if (!arr.includes(code)) {
+            arr.push(code);
+            saveLocales(arr);
+        }
+    }
+
+    function removeLocale(code) {
+        if (code === defaultLocale) return; // cannot remove default
+        const arr = getLocales().filter(c => c !== code);
+        saveLocales(arr);
+    }
+
+    function toggleLocalesPanel(enabled) {
+        const panel = document.getElementById('locales-panel');
+        panel.classList.toggle('hidden', !enabled);
+    }
+
+    // Init on page load
+    document.addEventListener('DOMContentLoaded', function() {
+        renderTags(getLocales());
+
+        // Allow Enter key to add locale
+        document.getElementById('locale-add-input').addEventListener('keydown', function(e) {
+            if (e.key === 'Enter') { e.preventDefault(); addLocale(); }
+        });
+    });
+</script>
+@endpush
 @endsection
diff --git a/app/Services/LocalizationService.php b/app/Services/LocalizationService.php
new file mode 100644
index 0000000..530b39b
--- /dev/null
+++ b/app/Services/LocalizationService.php
@@ -0,0 +1,93 @@
+<?php
+
+namespace App\Services;
+
+use Illuminate\Support\Facades\Cache;
+use Modules\Admin\Domain\Models\Setting;
+
+class LocalizationService
+{
+    private const CACHE_KEY = 'localization_settings';
+    private const CACHE_TTL = 3600; // 1 hour
+
+    /**
+     * Whether multilingual support is enabled.
+     */
+    public static function isMultilingualEnabled(): bool
+    {
+        return (bool) static::getSetting('multilingual_enabled', '0');
+    }
+
+    /**
+     * Get the list of active locales.
+     * Returns the default locale only when multilingual is disabled.
+     *
+     * @return string[]
+     */
+    public static function getActiveLocales(): array
+    {
+        if (!static::isMultilingualEnabled()) {
+            return [static::getDefaultLocale()];
+        }
+
+        $raw = static::getSetting('available_locales', '["en"]');
+        $decoded = json_decode($raw, true);
+
+        return (is_array($decoded) && count($decoded) > 0)
+            ? $decoded
+            : [static::getDefaultLocale()];
+    }
+
+    /**
+     * Get the configured default locale.
+     */
+    public static function getDefaultLocale(): string
+    {
+        return static::getSetting('default_locale', config('app.locale', 'en'));
+    }
+
+    /**
+     * Get locale display names map, e.g. ['en' => 'English', 'es' => 'Español'].
+     *
+     * @return array<string, string>
+     */
+    public static function getLocaleNames(): array
+    {
+        return [
+            'en' => 'English',
+            'es' => 'Español',
+            'fr' => 'Français',
+            'de' => 'Deutsch',
+            'it' => 'Italiano',
+            'pt' => 'Português',
+            'ru' => 'Русский',
+            'zh' => '中文',
+            'ja' => '日本語',
+            'ko' => '한국어',
+            'ar' => 'العربية',
+            'nl' => 'Nederlands',
+            'pl' => 'Polski',
+            'tr' => 'Türkçe',
+        ];
+    }
+
+    /**
+     * Read a setting value from cache-backed DB.
+     */
+    private static function getSetting(string $key, mixed $default = null): mixed
+    {
+        $settings = Cache::remember(self::CACHE_KEY, self::CACHE_TTL, function () {
+            return Setting::all()->pluck('value', 'key')->toArray();
+        });
+
+        return $settings[$key] ?? $default;
+    }
+
+    /**
+     * Clear the localization cache (called after settings update).
+     */
+    public static function clearCache(): void
+    {
+        Cache::forget(self::CACHE_KEY);
+    }
+}
diff --git a/app/Traits/Cacheable.php b/app/Traits/Cacheable.php
index 15592fe..dca2717 100755
--- a/app/Traits/Cacheable.php
+++ b/app/Traits/Cacheable.php
@@ -70,7 +70,7 @@ public function getCachedList(Builder $query, ?int $perPage)
     {
         $query = $query ?: static::query();
         $perPage = $perPage ?: request()->get('per_page', 15);
-        $cacheKey = $this->getListCacheKey($perPage, $query->toSql());
+        $cacheKey = $this->getListCacheKey($perPage, $query->toSql(), $query->getBindings());
         $driver = $this->logDriver();
 
         if (Cache::has($cacheKey)) {
@@ -132,15 +132,19 @@ protected function getCacheKey($identifier): string
     }
 
     /**
-     * Get cache key for list
+     * Get cache key for list — includes bindings and a model-level version counter
+     * so that any save/delete on the model busts all cached list pages at once.
      */
-    protected function getListCacheKey($perPage, $query): string
+    protected function getListCacheKey($perPage, $query, array $bindings = []): string
     {
+        $version = \Illuminate\Support\Facades\Cache::get($this->getCacheTag() . '.list.version', 1);
+
         return sprintf(
-            '%s.list.%s.%s.%s',
+            '%s.list.v%s.%s.%s.%s',
             $this->getCacheTag(),
+            $version,
             $perPage,
-            md5($query),
+            md5($query . json_encode($bindings)),
             request()->page ?? 1
         );
     }
diff --git a/database/migrations/2026_04_30_000001_add_multilingual_to_news.php b/database/migrations/2026_04_30_000001_add_multilingual_to_news.php
new file mode 100644
index 0000000..3b4b9c3
--- /dev/null
+++ b/database/migrations/2026_04_30_000001_add_multilingual_to_news.php
@@ -0,0 +1,42 @@
+<?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::table('news', function (Blueprint $table) {
+            // JSON columns for per-locale content
+            $table->json('title_translations')->nullable()->after('title');
+            $table->json('content_translations')->nullable()->after('content');
+            $table->text('excerpt')->nullable()->after('content_translations');
+        });
+
+        // Seed default multilingual settings if not present
+        $defaults = [
+            'multilingual_enabled' => '0',
+            'available_locales'    => '["en"]',
+        ];
+
+        foreach ($defaults as $key => $value) {
+            \DB::table('settings')->insertOrIgnore([
+                'key'        => $key,
+                'value'      => $value,
+                'created_at' => now(),
+                'updated_at' => now(),
+            ]);
+        }
+    }
+
+    public function down(): void
+    {
+        Schema::table('news', function (Blueprint $table) {
+            $table->dropColumn(['title_translations', 'content_translations', 'excerpt']);
+        });
+
+        \DB::table('settings')->whereIn('key', ['multilingual_enabled', 'available_locales'])->delete();
+    }
+};
diff --git a/resources/js/editor/ckeditor.js b/resources/js/editor/ckeditor.js
index bf569bf..7d8960c 100644
--- a/resources/js/editor/ckeditor.js
+++ b/resources/js/editor/ckeditor.js
@@ -1,44 +1,34 @@
 import ClassicEditor from '@ckeditor/ckeditor5-build-classic';
 
-document.addEventListener('DOMContentLoaded', function() {
+document.addEventListener('DOMContentLoaded', function () {
     const editorElement = document.querySelector('#editor');
-    
-    if (editorElement) {
-        ClassicEditor
-            .create(editorElement, {
-                toolbar: ['heading', '|', 'bold', 'italic', 'link', 'bulletedList', 'numberedList', '|', 'undo', 'redo'],
-                placeholder: 'Write your comment here...',
-            })
-            .then(editor => {
-                // Configuración adicional si es necesaria
-                editor.editing.view.change(writer => {
-                    writer.setStyle('min-height', '150px', editor.editing.view.document.getRoot());
-                });
-                
-                // Solución para el problema de validación del formulario
-                const form = editorElement.closest('form');
-                if (form) {
-                    form.addEventListener('submit', function() {
-                        // Asegurarse de que el contenido del editor se transfiera al textarea antes de enviar
-                        editorElement.value = editor.getData();
-                    });
-                }
-                
-                // Eliminar el atributo required del textarea original para evitar problemas de validación
-                editorElement.removeAttribute('required');
-                
-                // Agregar validación personalizada
-                if (form) {
-                    form.addEventListener('submit', function(e) {
-                        if (editor.getData().trim() === '') {
-                            e.preventDefault();
-                            alert('Please write a comment before submitting.');
-                        }
-                    });
-                }
-            })
-            .catch(error => {
-                console.error('Error al inicializar CKEditor:', error);
+
+    if (!editorElement) return;
+
+    ClassicEditor
+        .create(editorElement, {
+            toolbar: ['heading', '|', 'bold', 'italic', 'link', 'bulletedList', 'numberedList', '|', 'undo', 'redo'],
+            placeholder: 'Write your comment here...',
+        })
+        .then(editor => {
+            editor.editing.view.change(writer => {
+                writer.setStyle('min-height', '150px', editor.editing.view.document.getRoot());
             });
-    }
+
+            editorElement.removeAttribute('required');
+
+            const form = editorElement.closest('form');
+            if (form) {
+                form.addEventListener('submit', function (e) {
+                    editorElement.value = editor.getData();
+                    if (editor.getData().trim() === '') {
+                        e.preventDefault();
+                        alert('Please write a comment before submitting.');
+                    }
+                });
+            }
+        })
+        .catch(error => {
+            console.error('CKEditor comment init error:', error);
+        });
 });
\ No newline at end of file
diff --git a/resources/views/home/index.blade.php b/resources/views/home/index.blade.php
index 774fdb9..3e42df2 100755
--- a/resources/views/home/index.blade.php
+++ b/resources/views/home/index.blade.php
@@ -96,53 +96,75 @@ class="absolute top-1/2 left-1/2 w-80 h-80 rounded-full bg-cyan-500/10 opacity-5
                 </div>
 
                 @if(!empty($data['featuredNews']))
-                <div id="features" class="bg-slate-800/50 backdrop-blur-sm rounded-2xl overflow-hidden border border-slate-700/50 hover:border-blue-500/50">
-                    <div class="relative">
+                <a href="{{ route('news.show', $data['featuredNews']->slug) }}"
+                   class="group block bg-slate-800/50 backdrop-blur-sm rounded-2xl overflow-hidden border border-slate-700/50 hover:border-blue-500/50 transition-all duration-300">
+                    <div class="relative overflow-hidden">
                         @if(!empty($data['featuredNews']->image))
-                        <img src="{{ asset('storage/images/' . $data['featuredNews']->image) }}" alt="{{ $data['featuredNews']->title }}" class="w-full h-64 object-cover group-hover:scale-105 transition-transform duration-500">
+                        <img src="{{ asset('storage/images/' . $data['featuredNews']->image) }}"
+                             alt="{{ $data['featuredNews']->title }}"
+                             class="w-full h-64 object-cover group-hover:scale-105 transition-transform duration-500">
+                        @else
+                        <div class="w-full h-40 bg-gradient-to-br from-blue-600/20 to-purple-600/20 flex items-center justify-center">
+                            <svg class="w-16 h-16 text-slate-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M19 20H5a2 2 0 01-2-2V6a2 2 0 012-2h10a2 2 0 012 2v1m2 13a2 2 0 01-2-2V7m2 13a2 2 0 002-2V9a2 2 0 00-2-2h-2m-4-3H9M7 16h6M7 8h6v4H7V8z"></path>
+                            </svg>
+                        </div>
                         @endif
-
-                        @if(!empty($data['featuredNews']->image))
-                        <div class="absolute top-4 left-10">
+                        <div class="absolute top-4 left-4">
                             <span class="bg-blue-600 text-white text-xs font-bold px-3 py-1 rounded-full uppercase tracking-wide">Featured</span>
                         </div>
-                        @else
-                        <div class="mb-2">
-                            <span class="bg-blue-600 text-white text-xs font-bold px-3 py-1 rounded-full">
-                                Featured
-                            </span>
-                        </div>    
-                        @endif                   
                     </div>
                     <div class="p-6 space-y-3">
-                        <div class="text-sm text-slate-400">{{ $data['featuredNews']->published_at ? $data['featuredNews']->published_at->format('F d, Y') : 'Draft' }}</div>
+                        <div class="flex items-center gap-3 text-sm text-slate-400">
+                            <span>{{ $data['featuredNews']->published_at ? $data['featuredNews']->published_at->format('F d, Y') : 'Draft' }}</span>
+                            @if($data['featuredNews']->category)
+                                <span>•</span>
+                                <span class="text-blue-400">{{ $data['featuredNews']->category->name }}</span>
+                            @endif
+                        </div>
                         <h3 class="text-2xl font-bold text-white group-hover:text-blue-400 transition-colors duration-200">{{ $data['featuredNews']->title }}</h3>
-                        <p class="text-slate-300 leading-relaxed">{{ Str::limit($data['featuredNews']->content, 200) }}</p>
-                        <a href="{{ route('news.show', $data['featuredNews']->slug) }}" class="text-blue-400 hover:text-blue-300 font-medium inline-flex items-center gap-2 group/btn mt-2">
-                            Read More 
-                            <svg class="w-4 h-4 group-hover/btn:translate-x-1 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <p class="text-slate-300 leading-relaxed">{{ Str::limit(strip_tags($data['featuredNews']->excerpt ?? $data['featuredNews']->content), 180) }}</p>
+                        <span class="text-blue-400 group-hover:text-blue-300 font-medium inline-flex items-center gap-2 mt-2">
+                            Read More
+                            <svg class="w-4 h-4 group-hover:translate-x-1 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                                 <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7"></path>
                             </svg>
-                        </a>
+                        </span>
                     </div>
-                </div>
+                </a>
                 @endif
 
                 <div class="grid md:grid-cols-2 gap-6">
                     @forelse($data['news'] as $item)
-                    <div class="bg-slate-800/30 backdrop-blur-sm rounded-xl p-5 border border-slate-700/50 hover:border-slate-600 cursor-pointer">
-                        <div class="text-xs text-slate-400 mb-2">{{ $item->published_at->format('F d, Y') }}</div>
-                        <h4 class="text-lg font-bold text-white mb-2 group-hover:text-blue-400 transition-colors">{{ $item->title }}</h4>
-                        <p class="text-slate-400 text-sm">{{ Str::limit($item->content, 100) }}</p>
-                        <a href="{{ route('news.show', $item->slug) }}" class="text-blue-400 hover:text-blue-300 font-medium inline-flex items-center gap-2 group/btn mt-2">
-                            Read More 
-                            <svg class="w-4 h-4 group-hover/btn:translate-x-1 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7"></path>
-                            </svg>
-                        </a>
-                    </div>
+                    <a href="{{ route('news.show', $item->slug) }}"
+                       class="group flex flex-col bg-slate-800/30 backdrop-blur-sm rounded-xl overflow-hidden border border-slate-700/50 hover:border-blue-500/30 transition-all duration-300">
+                        <div class="overflow-hidden">
+                            @if(!empty($item->image))
+                            <img src="{{ asset('storage/images/' . $item->image) }}"
+                                 alt="{{ $item->title }}"
+                                 class="w-full h-40 object-cover group-hover:scale-105 transition-transform duration-500">
+                            @else
+                            <div class="w-full h-40 bg-gradient-to-br from-slate-700/50 to-slate-800/50 flex items-center justify-center">
+                                <svg class="w-10 h-10 text-slate-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M19 20H5a2 2 0 01-2-2V6a2 2 0 012-2h10a2 2 0 012 2v1m2 13a2 2 0 01-2-2V7m2 13a2 2 0 002-2V9a2 2 0 00-2-2h-2m-4-3H9M7 16h6M7 8h6v4H7V8z"></path>
+                                </svg>
+                            </div>
+                            @endif
+                        </div>
+                        <div class="p-4 flex flex-col flex-1 space-y-2">
+                            <div class="text-xs text-slate-400">{{ ($item->published_at ?? $item->created_at)->format('F d, Y') }}</div>
+                            <h4 class="text-base font-bold text-white group-hover:text-blue-400 transition-colors flex-1">{{ $item->title }}</h4>
+                            <p class="text-slate-400 text-sm leading-relaxed line-clamp-2">{{ Str::limit(strip_tags($item->excerpt ?? $item->content), 90) }}</p>
+                            <span class="text-blue-400 group-hover:text-blue-300 font-medium inline-flex items-center gap-1 text-sm pt-1">
+                                Read More
+                                <svg class="w-3.5 h-3.5 group-hover:translate-x-1 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7"></path>
+                                </svg>
+                            </span>
+                        </div>
+                    </a>
                     @empty
-                    <div class="col-span-full bg-slate-800/30 backdrop-blur-sm rounded-xl p-5 border border-slate-700/50 hover:border-slate-600 cursor-pointer">
+                    <div class="col-span-full bg-slate-800/30 rounded-xl p-6 border border-slate-700/50 text-center">
                         <p class="text-slate-400 text-sm">No news available.</p>
                     </div>
                     @endforelse
diff --git a/resources/views/news/index.blade.php b/resources/views/news/index.blade.php
index 3bd1398..9225c9d 100755
--- a/resources/views/news/index.blade.php
+++ b/resources/views/news/index.blade.php
@@ -7,6 +7,21 @@
                 Latest <span class="gradient-text">News</span>
             </h1>
             <p class="text-xl text-slate-400 max-w-2xl">Stay informed with the latest updates, events, and announcements from NexusCMS</p>
+
+            {{-- Locale switcher (only when multilingual is enabled and there are multiple locales) --}}
+            @if($isMultilingual && count($activeLocales) > 1)
+            <div class="flex items-center gap-2 mt-4">
+                @foreach($activeLocales as $locale)
+                    <a href="{{ route('news', array_merge(request()->except('lang'), ['lang' => $locale])) }}"
+                       class="px-3 py-1 rounded-full text-xs font-medium border transition
+                              {{ $activeLocale === $locale
+                                 ? 'bg-blue-600 border-blue-600 text-white'
+                                 : 'border-slate-600 text-slate-400 hover:border-blue-500 hover:text-blue-400' }}">
+                        {{ strtoupper($locale) }}
+                    </a>
+                @endforeach
+            </div>
+            @endif
         </div>
     </section>
     <section class="relative py-12 bg-gradient-to-b from-slate-950 to-slate-900">
@@ -16,57 +31,68 @@
                 <div class="lg:col-span-2 space-y-8">
                     <!-- Featured Article -->
                     @foreach($data as $item)
+                    @php $articleUrl = route('news.show', $item->slug) . ($isMultilingual && count($activeLocales) > 1 ? '?lang=' . $activeLocale : ''); @endphp
                     @if($loop->first)
-                        <article class="bg-slate-800/50 backdrop-blur-sm rounded-2xl overflow-hidden border border-slate-700/50 hover:border-blue-500/50 transition-all duration-300 ">
-                            <div class="relative">
-                                <img src="{{ $item->image ? asset('storage/images/' . $item->image) : 'https://placehold.co/600x400' }}" alt="{{ $item->title }}" class="w-full h-80 object-cover hover:scale-105 transition-transform duration-500">
+                        <a href="{{ $articleUrl }}" class="block bg-slate-800/50 backdrop-blur-sm rounded-2xl overflow-hidden border border-slate-700/50 hover:border-blue-500/50">
+                            <div class="relative overflow-hidden">
+                                <img src="{{ $item->image ? asset('storage/images/' . $item->image) : '' }}"
+                                     onerror="this.style.display='none';this.nextElementSibling.style.display='flex'"
+                                     alt="{{ $item->display_title }}" class="w-full h-80 object-cover group-hover:scale-105 transition-transform duration-500">
+                                <div class="w-full h-80 bg-slate-700/50 items-center justify-center hidden">
+                                    <svg class="w-16 h-16 text-slate-500" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M19 20H5a2 2 0 01-2-2V6a2 2 0 012-2h10a2 2 0 012 2v1m2 13a2 2 0 01-2-2V7m2 13a2 2 0 002-2V9a2 2 0 00-2-2h-2m-4-3H9M7 16h6M7 8h6v4H7V8z"/></svg>
+                                </div>
                                 <div class="absolute top-4 left-4">
                                     <span class="bg-blue-600 text-white text-xs font-bold px-3 py-1 rounded-full uppercase tracking-wide">Featured</span>
                                 </div>
                             </div>
                             <div class="p-8 space-y-4">
                                 <div class="flex items-center gap-4 text-sm text-slate-400">
-                                    <span>{{ $item->published_at->format('F j, Y') }}</span>
+                                    <span>{{ ($item->published_at ?? $item->created_at)->format('F j, Y') }}</span>
                                     <span>•</span>
-                                    <span>By {{ $item->author->name ?? 'Admin' }}</span>
+                                    <span>By {{ $item->author?->name ?? 'Admin' }}</span>
                                     <span>•</span>
                                     <span class="text-blue-400">{{ $item->category->name ?? 'Announcements' }}</span>
                                 </div>
-                                <h2 class="text-3xl font-bold text-white hover:text-blue-400 transition-colors duration-200">{{ $item->title }}</h2>
-                                <p class="text-slate-300 leading-relaxed text-lg">{{ Str::limit($item->excerpt ?? $item->content, 200) }}</p>
-                                <a href="{{ route('news.show', $item->slug) }}" class="mt-4 text-blue-400 hover:text-blue-300 font-medium inline-flex items-center gap-2">
+                                <h2 class="text-3xl font-bold text-white group-hover:text-blue-400 transition-colors duration-200">{{ $item->display_title }}</h2>
+                                <p class="text-slate-300 leading-relaxed text-lg">{{ Str::limit(strip_tags($item->display_excerpt ?? $item->display_content), 200) }}</p>
+                                <div class="mt-4 text-blue-400 group-hover:text-blue-300 font-medium inline-flex items-center gap-2">
                                     Read Full Article
-                                    <svg class="w-4 h-4 hover:translate-x-1 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                    <svg class="w-4 h-4 group-hover:translate-x-1 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                                         <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7"></path>
                                     </svg>
-                                </a>
+                                </div>
                             </div>
-                        </article>
+                        </a>
                     @else
-                    <article class="bg-slate-800/30 backdrop-blur-sm rounded-xl overflow-hidden border border-slate-700/50 hover:border-slate-600 transition-all duration-300 ">
+                    <a href="{{ $articleUrl }}" class="block bg-slate-800/30 backdrop-blur-sm rounded-xl overflow-hidden border border-slate-700/50 hover:border-slate-600">
                         <div class="md:flex">
-                            <div class="md:w-64 h-48 md:h-auto">
-                                <img src="{{ $item->image ? asset('storage/images/' . $item->image) : 'https://placehold.co/600x400' }}" alt="{{ $item->title }}" class="w-full h-full object-cover hover:scale-105 transition-transform duration-500">
+                            <div class="md:w-64 h-48 md:h-auto overflow-hidden flex-shrink-0">
+                                <img src="{{ $item->image ? asset('storage/images/' . $item->image) : '' }}"
+                                     onerror="this.style.display='none';this.nextElementSibling.style.display='flex'"
+                                     alt="{{ $item->display_title }}" class="w-full h-full object-cover group-hover:scale-105 transition-transform duration-500">
+                                <div class="w-full h-full min-h-[12rem] bg-slate-700/50 items-center justify-center hidden">
+                                    <svg class="w-10 h-10 text-slate-500" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M19 20H5a2 2 0 01-2-2V6a2 2 0 012-2h10a2 2 0 012 2v1m2 13a2 2 0 01-2-2V7m2 13a2 2 0 002-2V9a2 2 0 00-2-2h-2m-4-3H9M7 16h6M7 8h6v4H7V8z"/></svg>
+                                </div>
                             </div>
                             <div class="p-6 flex-1 space-y-3">
                                 <div class="flex items-center gap-3 text-sm text-slate-400">
-                                    <span>{{ $item->published_at->format('F j, Y') }}</span>
+                                    <span>{{ ($item->published_at ?? $item->created_at)->format('F j, Y') }}</span>
                                     <span>•</span>
-                                    <span class="text-red-400">{{ $item->category->name ?? 'Announcements' }}</span>
+                                    <span class="text-blue-400">{{ $item->category->name ?? 'Announcements' }}</span>
                                 </div>
-                                <h3 class="text-2xl font-bold text-white -hover:text-blue-400 transition-colors">{{ $item->title }}</h3>
+                                <h3 class="text-2xl font-bold text-white group-hover:text-blue-400 transition-colors">{{ $item->display_title }}</h3>
                                 <p class="text-slate-300">
-                                    {{ Str::limit($item->excerpt ?? $item->content, 200) }}
+                                    {{ Str::limit(strip_tags($item->display_excerpt ?? $item->display_content), 200) }}
                                 </p>
-                                <a href="{{ route('news.show', $item->slug) }}" class="text-blue-400 hover:text-blue-300 font-medium inline-flex items-center gap-2 /btn">
+                                <div class="text-blue-400 group-hover:text-blue-300 font-medium inline-flex items-center gap-2">
                                     Read More
-                                    <svg class="w-4 h-4 -hover/btn:translate-x-1 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                    <svg class="w-4 h-4 group-hover:translate-x-1 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                                         <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7"></path>
                                     </svg>
-                                </a>
+                                </div>
                             </div>
                         </div>
-                    </article>
+                    </a>
                     @endif
                     @endforeach
                     <div class="flex justify-center items-center gap-2 pt-8">
@@ -84,7 +110,7 @@
                         <div class="space-y-2">
                             <a href="{{ route('news', ['category' => 'all']) }}" class="flex items-center justify-between p-3 rounded-lg {{ request('category') == 'all' || request('category') == null ? 'bg-blue-500/10 border border-blue-500/30 text-blue-400' : 'hover:bg-slate-700/30 text-slate-300 hover:text-white transition-all' }}">
                                 <span class="font-medium">All News</span>
-                                <span class="text-sm text-slate-400">{{ App\Models\News::count() }}</span>
+                                <span class="text-sm text-slate-400">{{ App\Models\News::where('is_published', true)->count() }}</span>
                             </a>
                             @foreach($category as $item)
                             <a href="{{ route('news', ['category' => $item->id]) }}" class="flex items-center justify-between p-3 rounded-lg {{ request('category') == $item->id ? 'bg-blue-500/10 border border-blue-500/30 text-blue-400' : 'hover:bg-slate-700/30 text-slate-300 hover:text-white transition-all' }}">
@@ -100,9 +126,21 @@
                         <h3 class="text-xl font-bold text-white mb-4">Recent Posts</h3>
                         <div class="space-y-4">
                             @foreach($recentNews as $item)
-                            <a href="#" class="block ">
-                                <div class="text-sm text-slate-400 mb-1">{{ $item->published_at->format('M d, Y') }}</div>
-                                <h4 class="text-white -hover:text-blue-400 transition-colors font-medium">{{ $item->title }}</h4>
+                            <a href="{{ route('news.show', $item->slug) }}" class="flex items-start gap-3">
+                                @if($item->image)
+                                <img src="{{ asset('storage/images/' . $item->image) }}" alt="{{ $item->display_title }}"
+                                     class="w-16 h-16 rounded-lg object-cover flex-shrink-0">
+                                @else
+                                <div class="w-16 h-16 rounded-lg flex-shrink-0 bg-slate-700/60 flex items-center justify-center">
+                                    <svg class="w-6 h-6 text-slate-500" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M19 20H5a2 2 0 01-2-2V6a2 2 0 012-2h10a2 2 0 012 2v1m2 13a2 2 0 01-2-2V7m2 13a2 2 0 002-2V9a2 2 0 00-2-2h-2m-4-3H9M7 16h6M7 8h6v4H7V8z"></path>
+                                    </svg>
+                                </div>
+                                @endif
+                                <div>
+                                    <div class="text-xs text-slate-400 mb-1">{{ ($item->published_at ?? $item->created_at)->format('M d, Y') }}</div>
+                                    <h4 class="text-white group-hover:text-blue-400 transition-colors font-medium text-sm leading-snug">{{ $item->display_title }}</h4>
+                                </div>
                             </a>
                             @if(!$loop->last)
                             <div class="border-t border-slate-700"></div>
diff --git a/resources/views/news/show.blade.php b/resources/views/news/show.blade.php
index 17bc7d9..2247789 100644
--- a/resources/views/news/show.blade.php
+++ b/resources/views/news/show.blade.php
@@ -1,174 +1,247 @@
 @extends('layouts.main')
 
 @section('content')
-<section class="pt-24 pb-6 bg-slate-950">
-    <div class="max-w-4xl mx-auto px-4 sm:px-6 lg:px-8">
-        <div class="flex items-center gap-2 text-sm text-slate-400">
-            <a href="{{ route('home') }}" class="hover:text-white transition-colors">Home</a>
-            <span>›</span>
-            <a href="{{ route('news') }}" class="hover:text-white transition-colors">News</a>
-            <span>›</span>
-            @if($item->category)
-            <a href="{{ route('news', ['category' => $item->category->id]) }}" class="hover:text-white transition-colors">{{ $item->category->name }}</a>
-            <span>›</span>
-            @endif
-            <span class="text-white">{{ $item->title }}</span>
+
+{{-- ── Hero: imagen de fondo + cabecera del artículo ─────────────────────── --}}
+<section class="relative min-h-[60vh] flex flex-col justify-end overflow-hidden">
+
+    {{-- Imagen de fondo (o gradiente si no hay imagen) --}}
+    @if($item->image)
+    <div class="absolute inset-0">
+        <img src="{{ asset('storage/images/' . $item->image) }}"
+             alt="{{ $item->display_title }}"
+             class="w-full h-full object-cover">
+        <div class="absolute inset-0 bg-gradient-to-t from-slate-950 via-slate-950/70 to-slate-950/20"></div>
+    </div>
+    @else
+    <div class="absolute inset-0 bg-gradient-to-br from-slate-950 via-slate-900 to-blue-950/40"></div>
+    @endif
+
+    {{-- Breadcrumb --}}
+    <div class="relative z-10 pt-28 px-4 sm:px-6 lg:px-8">
+        <div class="max-w-4xl mx-auto">
+            <div class="flex items-center gap-2 text-xs text-slate-400 mb-6">
+                <a href="{{ route('home') }}" class="hover:text-white transition-colors">Home</a>
+                <span>›</span>
+                <a href="{{ route('news') }}" class="hover:text-white transition-colors">News</a>
+                @if($item->category)
+                <span>›</span>
+                <a href="{{ route('news', ['category' => $item->category->id]) }}" class="hover:text-white transition-colors">{{ $item->category->name }}</a>
+                @endif
+            </div>
         </div>
     </div>
-</section>
 
-<!-- Article Header -->
-<section class="relative pb-8 overflow-hidden bg-slate-950">
-    <div class="relative z-10 max-w-4xl mx-auto px-4 sm:px-6 lg:px-8">
-        @if($item->category)
-        <div class="mb-6">
-            <span class="inline-block bg-blue-600 text-white text-xs font-bold px-3 py-1 rounded-full uppercase tracking-wide">{{ $item->category->name }}</span>
-        </div>            
-        @endif
-        <h1 class="text-4xl md:text-5xl lg:text-6xl font-bold mb-6 leading-tight">
-            {{ $item->title }}
-        </h1>
-        <div class="flex flex-wrap items-center gap-6 text-slate-400">
-            <div class="flex items-center gap-3">
-                <div class="w-12 h-12 bg-gradient-to-br from-blue-500 to-blue-700 rounded-full flex items-center justify-center font-bold text-white">
-                    @if($item->author->avatar)
-                    <img class="h-14 w-14 rounded-full ring-2 ring-indigo-500"
-                        src="{{ $item->author->avatar }}" alt="{{ $item->author->name }}">
-                    @else
-                    <span>{{ $item->author->name[0] }}</span>
-                    @endif
+    {{-- Cabecera --}}
+    <div class="relative z-10 pb-12 px-4 sm:px-6 lg:px-8">
+        <div class="max-w-4xl mx-auto space-y-5">
+
+            {{-- Badges --}}
+            <div class="flex items-center flex-wrap gap-2">
+                @if($item->category)
+                <span class="bg-blue-600 text-white text-xs font-bold px-3 py-1 rounded-full uppercase tracking-wide">
+                    {{ $item->category->name }}
+                </span>
+                @endif
+                @if($isMultilingual && count($activeLocales) > 1)
+                    @foreach($activeLocales as $locale)
+                    <a href="{{ route('news.show', $item->slug) }}?lang={{ $locale }}"
+                       class="px-3 py-1 rounded-full text-xs font-medium border transition
+                              {{ $activeLocale === $locale
+                                 ? 'bg-white/10 border-white/40 text-white'
+                                 : 'border-slate-600 text-slate-400 hover:border-blue-400 hover:text-blue-300' }}">
+                        {{ strtoupper($locale) }}
+                    </a>
+                    @endforeach
+                @endif
+            </div>
+
+            {{-- Título --}}
+            <h1 class="text-4xl md:text-5xl lg:text-6xl font-extrabold text-white leading-tight tracking-tight drop-shadow-lg">
+                {{ $item->display_title }}
+            </h1>
+
+            @if($item->display_excerpt)
+            <p class="text-lg text-slate-300 leading-relaxed max-w-3xl">
+                {{ strip_tags($item->display_excerpt) }}
+            </p>
+            @endif
+
+            {{-- Meta --}}
+            <div class="flex flex-wrap items-center gap-4 pt-1">
+                {{-- Autor --}}
+                <div class="flex items-center gap-3">
+                    <div class="w-10 h-10 bg-gradient-to-br from-blue-500 to-blue-700 rounded-full overflow-hidden flex items-center justify-center font-bold text-white text-sm flex-shrink-0">
+                        @if($item->author?->avatar)
+                        <img src="{{ $item->author->avatar }}" alt="{{ $item->author->name }}" class="w-full h-full object-cover">
+                        @else
+                        {{ strtoupper($item->author?->name[0] ?? '?') }}
+                        @endif
+                    </div>
+                    <div>
+                        <div class="text-white font-semibold text-sm">{{ $item->author?->name ?? 'Admin' }}</div>
+                        <div class="text-xs text-slate-400">{{ $item->author?->role ?? 'Editor' }}</div>
+                    </div>
                 </div>
-                <div>
-                    <div class="text-white font-medium">{{ $item->author->name }}</div>
-                    <div class="text-sm">{{ $item->author->role ?? 'Editor' }}</div>
+
+                <span class="text-slate-600">|</span>
+
+                {{-- Fecha --}}
+                <div class="flex items-center gap-1.5 text-slate-400 text-sm">
+                    <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7V3m8 4V3m-9 8h10M5 21h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"/>
+                    </svg>
+                    <span>{{ $item->published_at ? $item->published_at->format('F j, Y') : 'Unpublished' }}</span>
+                </div>
+
+                {{-- Tiempo de lectura --}}
+                <div class="flex items-center gap-1.5 text-slate-400 text-sm">
+                    <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z"/>
+                    </svg>
+                    <span>{{ $item->reading_time }} min read</span>
                 </div>
-            </div>
-            <div class="flex items-center gap-2">
-                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7V3m8 4V3m-9 8h10M5 21h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"></path>
-                </svg>
-                <span>{{ $item->published_at ? $item->published_at->format('M d, Y') : 'Unpublished' }}</span>
-            </div>
-            <div class="flex items-center gap-2">
-                <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z"></path>
-                </svg>
-                <span>{{ $item->reading_time }} min read</span>
             </div>
         </div>
     </div>
 </section>
 
-<!-- Featured Image -->
-@if($item->image)
-<section class="bg-slate-900">
-    <div class="max-w-5xl mx-auto px-4 sm:px-6 lg:px-8">
-        <img src="{{ asset('storage/images/' . $item->image) }}" alt="{{ $item->title }}" class="w-full h-96 object-cover rounded-2xl shadow-2xl">
-    </div>
-</section>
-@endif
-
-<!-- Article Content -->
-<section class="py-12 bg-gradient-to-b from-slate-900 to-slate-950">
+{{-- ── Contenido del artículo ──────────────────────────────────────────────── --}}
+<section class="py-14 bg-gradient-to-b from-slate-950 to-slate-900">
     <div class="max-w-4xl mx-auto px-4 sm:px-6 lg:px-8">
-        <div class="grid lg:grid-cols-4 gap-8">
-            <!-- Share Sidebar -->
-            <div class="hidden lg:block">
-                <div class="sticky top-24 space-y-4">
-                    <div class="text-sm font-semibold text-slate-400 uppercase tracking-wide mb-4">Share</div>
-                    @foreach(['twitter', 'facebook', 'pinterest', 'reddit'] as $social)
-                    <a href="{{ app(App\Helpers\GeneralHelper::class)->shareSocial($social, url()->current(), $item->title)['url'] }}"
-                       target="_blank"
-                       class="w-full flex items-center gap-3 px-4 py-3 bg-slate-800/50 hover:bg-blue-600 text-slate-300 hover:text-white rounded-lg transition-all">
-                        <i class="{{ app(App\Helpers\GeneralHelper::class)->shareSocial($social, url()->current(), $item->title)['icon'] }} fa-lg"></i>
-                        <span class="text-sm font-medium capitalize">{{ $social }}</span>
-                    </a>
-                    @endforeach
-                </div>
+        <div class="grid lg:grid-cols-[56px_1fr] gap-8 items-start">
+
+            {{-- Share sidebar (desktop) --}}
+            <div class="hidden lg:flex flex-col items-center gap-3 sticky top-24">
+                <span class="text-[10px] font-semibold text-slate-500 uppercase tracking-widest mb-1">Share</span>
+                @foreach(['twitter', 'facebook', 'reddit'] as $social)
+                @php $s = app(App\Helpers\GeneralHelper::class)->shareSocial($social, url()->current(), $item->display_title); @endphp
+                <a href="{{ $s['url'] }}" target="_blank"
+                   title="{{ ucfirst($social) }}"
+                   class="w-10 h-10 flex items-center justify-center rounded-full bg-slate-800/60 hover:bg-blue-600 text-slate-400 hover:text-white transition-all duration-200">
+                    <i class="{{ $s['icon'] }}"></i>
+                </a>
+                @endforeach
             </div>
 
-            <!-- Main Content -->
-            <div class="lg:col-span-3">
-                <article class="prose prose-lg prose-invert max-w-none">
-                    {!! $item->content !!}
+            {{-- Contenido principal --}}
+            <div>
+                {{-- Prose --}}
+                <article class="prose prose-lg prose-invert max-w-none
+                    prose-headings:font-bold prose-headings:text-white
+                    prose-p:text-slate-300 prose-p:leading-relaxed
+                    prose-a:text-blue-400 prose-a:no-underline hover:prose-a:text-blue-300
+                    prose-strong:text-white
+                    prose-blockquote:border-blue-500 prose-blockquote:bg-slate-800/40 prose-blockquote:rounded-r-lg prose-blockquote:py-1
+                    prose-code:text-blue-300 prose-code:bg-slate-800/60 prose-code:rounded prose-code:px-1
+                    prose-pre:bg-slate-800/80 prose-pre:border prose-pre:border-slate-700
+                    prose-img:rounded-xl prose-img:shadow-2xl">
+                    {!! $item->display_content !!}
                 </article>
 
-                <div class="mt-8 pt-8 border-t border-slate-800">
-                    <div class="flex flex-wrap gap-2">
-                        <span class="text-sm text-slate-400 font-medium">Tags:</span>
+                {{-- Share mobile --}}
+                <div class="lg:hidden mt-10 pt-8 border-t border-slate-800">
+                    <div class="text-sm font-semibold text-slate-400 uppercase tracking-wide mb-3">Share this article</div>
+                    <div class="flex gap-3">
+                        @foreach(['twitter', 'facebook', 'pinterest', 'reddit'] as $social)
+                        @php $s = app(App\Helpers\GeneralHelper::class)->shareSocial($social, url()->current(), $item->display_title); @endphp
+                        <a href="{{ $s['url'] }}" target="_blank"
+                           class="flex-1 flex items-center justify-center gap-2 px-3 py-2.5 bg-slate-800/50 hover:bg-blue-600 text-slate-300 hover:text-white rounded-lg transition-all text-sm">
+                            <i class="{{ $s['icon'] }}"></i>
+                            <span class="capitalize hidden sm:inline">{{ $social }}</span>
+                        </a>
+                        @endforeach
                     </div>
                 </div>
 
-                <!-- Share Mobile -->
-                <div class="lg:hidden mt-8 pt-8 border-t border-slate-800">
-                    <div class="text-sm font-semibold text-slate-400 uppercase tracking-wide mb-4">Share this article</div>
-                    <div class="flex flex-wrap gap-3">
-                        @foreach(['twitter', 'facebook', 'pinterest', 'reddit'] as $social)
-                            <a href="{{ app(App\Helpers\GeneralHelper::class)->shareSocial($social, url()->current(), $item->title)['url'] }}"
-                               target="_blank"
-                               class="flex-1 flex items-center justify-center gap-2 px-4 py-3 bg-slate-800/50 hover:bg-blue-600 text-slate-300 hover:text-white rounded-lg transition-all">
-                                <i class="{{ app(App\Helpers\GeneralHelper::class)->shareSocial($social, url()->current(), $item->title)['icon'] }} fa-lg"></i>
-                                <span class="text-sm font-medium capitalize">{{ $social }}</span>
-                            </a>
-                        @endforeach
+                {{-- Autor card --}}
+                <div class="mt-12 pt-10 border-t border-slate-800">
+                    <div class="flex items-center gap-4 bg-slate-800/30 rounded-2xl p-6 border border-slate-700/50">
+                        <div class="w-16 h-16 bg-gradient-to-br from-blue-500 to-blue-700 rounded-full overflow-hidden flex items-center justify-center font-bold text-white text-xl flex-shrink-0">
+                            @if($item->author?->avatar)
+                            <img src="{{ $item->author->avatar }}" alt="{{ $item->author->name }}" class="w-full h-full object-cover">
+                            @else
+                            {{ strtoupper($item->author?->name[0] ?? '?') }}
+                            @endif
+                        </div>
+                        <div>
+                            <div class="text-xs text-slate-500 uppercase tracking-wide mb-0.5">Written by</div>
+                            <div class="text-white font-bold text-lg">{{ $item->author?->name ?? 'Admin' }}</div>
+                            <div class="text-slate-400 text-sm">{{ $item->author?->role ?? 'Editor' }}</div>
+                        </div>
                     </div>
                 </div>
-                
-                <!-- Comments Section -->
-                <div class="mt-12 pt-12 border-t border-slate-800">
-                    <h3 class="text-2xl font-bold text-white mb-6">Comments</h3>
-                    
+
+                {{-- Comments --}}
+                <div class="mt-12 pt-10 border-t border-slate-800">
+                    <h3 class="text-2xl font-bold text-white mb-8">
+                        Comments
+                        @if($item->comments->count())
+                        <span class="text-base font-normal text-slate-500 ml-2">({{ $item->comments->count() }})</span>
+                        @endif
+                    </h3>
+
                     @auth
-                    <!-- Comment Form -->
                     <form action="{{ route('news.comment.store', $item->slug) }}" method="POST" class="mb-10">
                         @csrf
-                        <div class="bg-slate-800/30 rounded-xl p-6 mb-8">
-                            <textarea placeholder="Write a comment..." id="editor" name="body" class="w-full h-32 px-4 py-3 bg-slate-900/50 border border-slate-700 rounded-lg text-white placeholder-slate-500 focus:outline-none focus:border-blue-500 transition-colors resize-none"></textarea>
-                            <div class="flex justify-end mt-4">
-                                <button type="submit" class="px-6 py-2 bg-blue-600 hover:bg-blue-700 text-white rounded-lg font-medium transition-colors">Post Comment</button>
+                        <div class="flex gap-3">
+                            <div class="w-10 h-10 bg-gradient-to-br from-blue-500 to-blue-700 rounded-full overflow-hidden flex items-center justify-center font-bold text-white text-sm flex-shrink-0 mt-1">
+                                {{ strtoupper(auth()->user()->name[0]) }}
+                            </div>
+                            <div class="flex-1">
+                                <textarea name="body" rows="3"
+                                    placeholder="Write a comment..."
+                                    class="w-full px-4 py-3 bg-slate-800/50 border border-slate-700 rounded-xl text-white placeholder-slate-500 focus:outline-none focus:border-blue-500 transition-colors resize-none text-sm"></textarea>
+                                <div class="flex justify-end mt-2">
+                                    <button type="submit" class="px-5 py-2 bg-blue-600 hover:bg-blue-700 text-white rounded-lg font-medium transition-colors text-sm">
+                                        Post Comment
+                                    </button>
+                                </div>
                             </div>
                         </div>
                     </form>
+                    @else
+                    <div class="mb-8 p-4 bg-slate-800/30 rounded-xl border border-slate-700/50 text-center text-sm text-slate-400">
+                        <a href="{{ route('login') }}" class="text-blue-400 hover:text-blue-300 font-medium">Sign in</a> to leave a comment.
+                    </div>
                     @endauth
 
-                    <!-- Comments List -->
-                    <div class="space-y-6">
+                    <div class="space-y-5">
                         @forelse($item->comments as $comment)
-                        <!-- Comment 1 -->
-                        <div class="bg-slate-800/30 rounded-xl p-6 border border-slate-700/50 hover:border-slate-600/50 transition-colors">
-                            <div class="flex items-start gap-4">
-                                <div class="flex-shrink-0">
-                                    <div class="w-12 h-12 bg-gradient-to-br from-blue-500 to-blue-700 rounded-full flex items-center justify-center font-bold text-white">
-                                        @if($item->author->avatar)
-                                        <img class="h-12 w-12 rounded-full ring-2 ring-indigo-500 mt-1"
-                                        src="{{ $comment->user->avatar_url ?? asset('images/default-avatar.png') }}"
-                                        alt="Avatar">
-                                        @else
-                                        {{ $comment->user->name[0] ?? 'Anonymous' }}
-                                        @endif
-                                    </div>
+                        <div class="flex gap-3">
+                            <div class="w-10 h-10 bg-gradient-to-br from-blue-500 to-blue-700 rounded-full overflow-hidden flex items-center justify-center font-bold text-white text-sm flex-shrink-0 mt-1">
+                                @if($comment->user?->avatar)
+                                <img src="{{ $comment->user->avatar_url ?? asset('images/default-avatar.png') }}" alt="{{ $comment->user->name }}" class="w-full h-full object-cover">
+                                @else
+                                {{ strtoupper($comment->user?->name[0] ?? '?') }}
+                                @endif
+                            </div>
+                            <div class="flex-1 bg-slate-800/30 rounded-xl p-4 border border-slate-700/40">
+                                <div class="flex items-center gap-2 mb-2 flex-wrap">
+                                    <span class="font-semibold text-white text-sm">{{ $comment->user?->name ?? 'Anonymous' }}</span>
+                                    @if($comment->user?->role ?? null)
+                                    <span class="px-2 py-0.5 bg-blue-500/20 border border-blue-500/30 rounded text-xs text-blue-400">{{ $comment->user->role }}</span>
+                                    @endif
+                                    <span class="text-xs text-slate-500 ml-auto">{{ $comment->created_at->format('d/m/Y H:i') }}</span>
                                 </div>
-                                <div class="flex-1 min-w-0">
-                                    <div class="flex items-center gap-3 mb-2">
-                                        <h4 class="font-bold text-white"> {{ $comment->user->name ?? 'Anonymous' }}</h4>
-                                        @if($comment->user->role)
-                                        <span class="px-2 py-0.5 bg-blue-500/20 border border-blue-500/30 rounded text-xs text-blue-400 font-medium">{{ $comment->user->role }}</span>
-                                        @endif
-                                        <span class="text-sm text-slate-500">{{ date('d/m/Y H:i', $comment->created_at) }}</span>
-                                    </div>
-                                    <p class="text-slate-300 leading-relaxed mb-3">
-                                        {!! $comment->comment !!}
-                                    </p>
+                                <div class="text-slate-300 text-sm leading-relaxed">
+                                    {!! $comment->comment !!}
                                 </div>
                             </div>
                         </div>
                         @empty
-                            <p class="text-slate-400 text-center">No comments yet. Be the first to comment!</p>
+                        <div class="text-center py-10">
+                            <svg class="w-12 h-12 text-slate-700 mx-auto mb-3" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z"/>
+                            </svg>
+                            <p class="text-slate-500 text-sm">No comments yet. Be the first!</p>
+                        </div>
                         @endforelse
                     </div>
                 </div>
-            </div>
+            </div>{{-- /main content --}}
         </div>
     </div>
 </section>
-@endsection
\ No newline at end of file
+
+@endsection

From 148032fc24e13425ff345b37c91c03a1f90a7432 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 2 May 2026 05:18:15 +0200
Subject: [PATCH 104/132] feat(news): update excerpt handling for multilingual
 support

---
 .../Admin/Resources/views/news/edit.blade.php | 24 ++++++++-----------
 1 file changed, 10 insertions(+), 14 deletions(-)

diff --git a/app/Modules/Admin/Resources/views/news/edit.blade.php b/app/Modules/Admin/Resources/views/news/edit.blade.php
index 03c413a..daa7991 100644
--- a/app/Modules/Admin/Resources/views/news/edit.blade.php
+++ b/app/Modules/Admin/Resources/views/news/edit.blade.php
@@ -47,20 +47,6 @@
             <div class="lg:col-span-2 space-y-6">
 
                 @if($isMultilingual && count($activeLocales) > 1)
-                {{-- Excerpt (non-translated) --}}
-                <div class="bg-white rounded-lg shadow">
-                    <div class="p-6 border-b border-gray-200">
-                        <h2 class="text-base font-bold text-gray-800">Excerpt</h2>
-                        <p class="text-xs text-gray-500 mt-0.5">Short summary shown in news listings. Optional.</p>
-                    </div>
-                    <div class="p-6">
-                        <textarea name="excerpt"
-                                  id="ck-excerpt-main"
-                                  rows="4"
-                                  class="news-ck-excerpt w-full">{{ old('excerpt', $news->excerpt) }}</textarea>
-                    </div>
-                </div>
-
                 {{-- Multilingual tabs --}}
                 <div class="bg-white rounded-lg shadow">
                     <div class="border-b border-gray-200 px-4">
@@ -103,6 +89,16 @@ class="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none foc
                                    {{ $locale === $defaultLocale ? 'required' : '' }}
                                    placeholder="Article title in {{ $localeNames[$locale] ?? $locale }}">
                         </div>
+                        <div>
+                            <label class="block text-sm font-semibold text-gray-700 mb-2">
+                                Excerpt <span class="font-mono text-xs text-gray-400">[{{ $locale }}]</span>
+                            </label>
+                            <p class="text-xs text-gray-500 mb-2">Short summary shown in news listings. Optional.</p>
+                            <textarea name="excerpt_translations[{{ $locale }}]"
+                                      id="ck-excerpt-{{ $locale }}"
+                                      rows="4"
+                                      class="news-ck-excerpt w-full">{{ old("excerpt_translations.{$locale}", $news->excerpt_translations[$locale] ?? '') }}</textarea>
+                        </div>
                         <div>
                             <label class="block text-sm font-semibold text-gray-700 mb-2">
                                 Content <span class="font-mono text-xs text-gray-400">[{{ $locale }}]</span>

From 7890029b11729b90f507dc53059cd2fe8185a1fc Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 2 May 2026 19:50:00 +0200
Subject: [PATCH 105/132] feat(news): remove excerpt section for single
 language mode

---
 .../Admin/Resources/views/news/create.blade.php    | 14 --------------
 1 file changed, 14 deletions(-)

diff --git a/app/Modules/Admin/Resources/views/news/create.blade.php b/app/Modules/Admin/Resources/views/news/create.blade.php
index 7e754d9..7b9a240 100644
--- a/app/Modules/Admin/Resources/views/news/create.blade.php
+++ b/app/Modules/Admin/Resources/views/news/create.blade.php
@@ -103,22 +103,8 @@ class="news-ck-editor w-full">{{ old("content_translations.{$locale}") }}</texta
                     </div>
                     @endforeach
                 </div>
-
                 @else
                 {{-- Single language mode --}}
-
-                <div class="bg-white rounded-lg shadow">
-                    <div class="p-6 border-b border-gray-200">
-                        <h2 class="text-base font-bold text-gray-800">Excerpt</h2>
-                        <p class="text-xs text-gray-500 mt-0.5">Short summary shown in news listings. Optional.</p>
-                    </div>
-                    <div class="p-6">
-                        <textarea name="excerpt"
-                                  id="ck-excerpt-main"
-                                  rows="4"
-                                  class="news-ck-excerpt w-full">{{ old('excerpt') }}</textarea>
-                    </div>
-                </div>
                 <div class="bg-white rounded-lg shadow">
                     <div class="p-6 border-b border-gray-200">
                         <h2 class="text-lg font-bold text-gray-800">Content</h2>

From 6d86df691865a58f7de3f105c8f2227a3d035f7f Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Wed, 6 May 2026 00:40:11 +0200
Subject: [PATCH 106/132] feat: upgrade wowcrypto/wowcrypto to 1.3.0 and update
 AccountLibrary to module-based API

---
 app/Libraries/Auth/AccountLibrary.php |  6 ++++--
 composer.json                         |  2 +-
 composer.lock                         | 20 ++++++++------------
 3 files changed, 13 insertions(+), 15 deletions(-)

diff --git a/app/Libraries/Auth/AccountLibrary.php b/app/Libraries/Auth/AccountLibrary.php
index 1eda22e..927445f 100755
--- a/app/Libraries/Auth/AccountLibrary.php
+++ b/app/Libraries/Auth/AccountLibrary.php
@@ -61,11 +61,13 @@ public function createNewAccount(string $username, string $password, string $ema
 
             if ($isBnet) {
                 // Create Battle.net account
-                return $this->soapCreator->createAccountBnet($email, $password);
+                $this->soapCreator->account()->createBnet($email, $password);
+                return true;
             }
 
             // Create non-Battle.net account
-            return $this->soapCreator->createAccount($username, $password, $email);
+            $this->soapCreator->account()->create($username, $password, $email);
+            return true;
         } catch (\Exception $e) {
             throw new \Exception('Account creation failed: ' . $e->getMessage());
         }
diff --git a/composer.json b/composer.json
index 893ea11..985f7ed 100755
--- a/composer.json
+++ b/composer.json
@@ -18,7 +18,7 @@
         "laravel/tinker": "2.10.1",
         "predis/predis": "3.2.0",
         "spatie/laravel-permission": "^6.18",
-        "wowcrypto/wowcrypto": "1.2.0",
+        "wowcrypto/wowcrypto": "1.3.0",
         "braintree/braintree_php": "^6.13"
     },
     "require-dev": {
diff --git a/composer.lock b/composer.lock
index 8635ce0..d31bb2a 100755
--- a/composer.lock
+++ b/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": "b336f73b62082a66e2b07c931571e0f2",
+    "content-hash": "9fbb1cd1ea041d3f404fc90d747bfcec",
     "packages": [
         {
             "name": "braintree/braintree_php",
@@ -6415,16 +6415,16 @@
         },
         {
             "name": "wowcrypto/wowcrypto",
-            "version": "1.2.0",
+            "version": "1.3.0",
             "source": {
                 "type": "git",
-                "url": "https://github.com/WoW-CMS/WowCrypto.git",
-                "reference": "4e6a03c396357b7f411508f3fcd53f6f30416bb5"
+                "url": "git@github.com:WoW-CMS/WowCrypto.git",
+                "reference": "05489e3d9dc70e9979b86b6cdf70d3d5b7ffc1a0"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/WoW-CMS/WowCrypto/zipball/4e6a03c396357b7f411508f3fcd53f6f30416bb5",
-                "reference": "4e6a03c396357b7f411508f3fcd53f6f30416bb5",
+                "url": "https://api.github.com/repos/WoW-CMS/WowCrypto/zipball/05489e3d9dc70e9979b86b6cdf70d3d5b7ffc1a0",
+                "reference": "05489e3d9dc70e9979b86b6cdf70d3d5b7ffc1a0",
                 "shasum": ""
             },
             "require": {
@@ -6450,11 +6450,7 @@
                 "MIT"
             ],
             "description": "Biblioteca de encriptación para World of Warcraft con soporte para múltiples métodos de hash",
-            "support": {
-                "source": "https://github.com/WoW-CMS/WowCrypto/tree/1.2.0",
-                "issues": "https://github.com/WoW-CMS/WowCrypto/issues"
-            },
-            "time": "2025-06-02T19:04:14+00:00"
+            "time": "2026-05-05T21:45:37+00:00"
         }
     ],
     "packages-dev": [
@@ -8905,7 +8901,7 @@
     "prefer-stable": true,
     "prefer-lowest": false,
     "platform": {
-        "php": "^8.2"
+        "php": "^8.4"
     },
     "platform-dev": {},
     "plugin-api-version": "2.6.0"

From ee9f15c72135420929ff65bc0be964e57e1822d1 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 10 May 2026 02:34:46 +0200
Subject: [PATCH 107/132] feat: add SOAP server info test functionality for
 realm management

---
 .../Controllers/RealmManagementController.php |  44 +-
 app/Modules/Admin/Http/routes.php             |   1 +
 .../Resources/views/realms/index.blade.php    |  30 ++
 .../Http/Controllers/StoreController.php      | 165 ++++++-
 app/Modules/Store/Http/routes.php             |   8 +-
 .../Store/Resources/views/store.blade.php     | 459 ++++--------------
 6 files changed, 333 insertions(+), 374 deletions(-)

diff --git a/app/Modules/Admin/Http/Controllers/RealmManagementController.php b/app/Modules/Admin/Http/Controllers/RealmManagementController.php
index 2c38bc4..b02ea00 100644
--- a/app/Modules/Admin/Http/Controllers/RealmManagementController.php
+++ b/app/Modules/Admin/Http/Controllers/RealmManagementController.php
@@ -6,6 +6,7 @@
 use App\Enums\WoWConstants;
 use App\Http\Controllers\Controller;
 use App\Models\Realm;
+use GameCrypto\SoapAccountCreator;
 use Illuminate\Http\Request;
 use Illuminate\Validation\Rule;
 
@@ -67,7 +68,7 @@ public function update(Request $request, Realm $realm)
 
         return redirect()
             ->route('admin.realms.index')
-            ->with('success', 'Realm actualizado correctamente.');
+            ->with('success', 'Realm updated successfully.');
     }
 
     /**
@@ -79,7 +80,46 @@ public function destroy(Realm $realm)
 
         return redirect()
             ->route('admin.realms.index')
-            ->with('success', 'Realm eliminado correctamente.');
+            ->with('success', 'Realm deleted successfully.');
+    }
+
+    /**
+     * Run a SOAP server info test for the selected realm.
+     */
+    public function soapTest(Realm $realm)
+    {
+        try {
+            $soap = new SoapAccountCreator(
+                (string) $realm->console_hostname,
+                (int) ($realm->console_port ?? 0),
+                (string) $realm->console_username,
+                (string) $realm->console_password,
+                (string) $realm->console_urn,
+                false
+            );
+
+            $response = $soap->server()->info();
+
+            return redirect()
+                ->route('admin.realms.index')
+                ->with('success', 'SOAP test executed successfully for ' . $realm->name . '.')
+                ->with('soap_test_log', [
+                    'realm' => $realm->name,
+                    'timestamp' => now()->format('Y-m-d H:i:s'),
+                    'command' => 'server info',
+                    'response' => trim((string) $response),
+                ]);
+        } catch (\Throwable $exception) {
+            return redirect()
+                ->route('admin.realms.index')
+                ->with('error', 'SOAP test failed for ' . $realm->name . ': ' . $exception->getMessage())
+                ->with('soap_test_log', [
+                    'realm' => $realm->name,
+                    'timestamp' => now()->format('Y-m-d H:i:s'),
+                    'command' => 'server info',
+                    'response' => 'ERROR: ' . $exception->getMessage(),
+                ]);
+        }
     }
 
     /**
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index 68e0ae0..8e1201e 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -48,6 +48,7 @@
         Route::post('/realms', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'store'])->middleware('permission:manage.realms')->name('admin.realms.store');
         Route::get('/realms/{realm}/edit', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'edit'])->middleware('permission:manage.realms')->name('admin.realms.edit');
         Route::put('/realms/{realm}', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'update'])->middleware('permission:manage.realms')->name('admin.realms.update');
+        Route::post('/realms/{realm}/soap-test', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'soapTest'])->middleware('permission:manage.realms')->name('admin.realms.soap-test');
         Route::delete('/realms/{realm}', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'destroy'])->middleware('permission:manage.realms')->name('admin.realms.destroy');
 
         // Menus
diff --git a/app/Modules/Admin/Resources/views/realms/index.blade.php b/app/Modules/Admin/Resources/views/realms/index.blade.php
index 629bc3e..db6d540 100644
--- a/app/Modules/Admin/Resources/views/realms/index.blade.php
+++ b/app/Modules/Admin/Resources/views/realms/index.blade.php
@@ -24,6 +24,29 @@
             </div>
         @endif
 
+        @if(session('error'))
+            <div class="p-4 bg-red-50 border-l-4 border-red-500 rounded-lg text-red-800 text-sm">
+                {{ session('error') }}
+            </div>
+        @endif
+
+        @if(session('soap_test_log'))
+            @php
+                $soapLog = session('soap_test_log');
+            @endphp
+            <div class="bg-slate-900 border border-slate-700 rounded-xl overflow-hidden">
+                <div class="px-6 py-3 border-b border-slate-700 flex items-center justify-between">
+                    <h3 class="text-sm font-semibold text-slate-100">SOAP Server Info Log</h3>
+                    <span class="text-xs text-slate-400">{{ $soapLog['timestamp'] ?? '' }}</span>
+                </div>
+                <div class="px-6 py-4 space-y-2 text-xs">
+                    <div class="text-slate-300"><span class="font-semibold text-slate-100">Realm:</span> {{ $soapLog['realm'] ?? '-' }}</div>
+                    <div class="text-slate-300"><span class="font-semibold text-slate-100">Command:</span> {{ $soapLog['command'] ?? '-' }}</div>
+                    <pre class="mt-2 p-3 rounded bg-black/60 border border-slate-800 text-emerald-300 whitespace-pre-wrap">{{ $soapLog['response'] ?? '-' }}</pre>
+                </div>
+            </div>
+        @endif
+
         <div class="bg-white border border-gray-200 rounded-xl overflow-hidden">
             <div class="px-6 py-4 border-b border-gray-200 flex items-center justify-between">
                 <h2 class="text-base font-semibold text-gray-900">Realms registrados</h2>
@@ -62,6 +85,13 @@
                                 </td>
                                 <td class="px-6 py-4">
                                     <div class="flex items-center gap-2">
+                                        <form action="{{ route('admin.realms.soap-test', $realm->id) }}" method="POST">
+                                            @csrf
+                                            <button type="submit" class="inline-flex items-center gap-1 px-3 py-1.5 bg-indigo-50 text-indigo-700 rounded-lg hover:bg-indigo-100 text-xs font-medium">
+                                                <i class="fas fa-terminal"></i>
+                                                SOAP Test
+                                            </button>
+                                        </form>
                                         <a href="{{ route('admin.realms.edit', $realm->id) }}" class="inline-flex items-center gap-1 px-3 py-1.5 bg-blue-50 text-blue-700 rounded-lg hover:bg-blue-100 text-xs font-medium">
                                             <i class="fas fa-pen"></i>
                                             Editar
diff --git a/app/Modules/Store/Http/Controllers/StoreController.php b/app/Modules/Store/Http/Controllers/StoreController.php
index d849412..2a3884d 100644
--- a/app/Modules/Store/Http/Controllers/StoreController.php
+++ b/app/Modules/Store/Http/Controllers/StoreController.php
@@ -3,11 +3,172 @@
 namespace Modules\Store\Http\Controllers;
 
 use App\Http\Controllers\Controller;
+use App\Models\AccountLinked;
+use App\Models\Realm;
+use App\Models\User;
+use GameCrypto\SoapAccountCreator;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
 
 class StoreController extends Controller
 {
-    public function index()
+    public function index(Request $request)
     {
-        return view('store::store'); 
+        $user = $request->user();
+
+        $linkedAccounts = AccountLinked::query()
+            ->with('realm')
+            ->where('user_id', $user->id)
+            ->get()
+            ->filter(static fn (AccountLinked $link) => $link->realm !== null)
+            ->values();
+
+        return view('store::store', [
+            'products' => $this->getProducts(),
+            'linkedAccounts' => $linkedAccounts,
+            'balance' => (int) $user->dp,
+        ]);
+    }
+
+    public function purchase(Request $request): RedirectResponse
+    {
+        $validated = $request->validate([
+            'product' => ['required', 'string'],
+            'realm_id' => ['required', 'integer', 'exists:realms,id'],
+            'character_name' => ['nullable', 'string', 'min:2', 'max:12'],
+        ]);
+
+        $products = $this->getProducts();
+        $productKey = $validated['product'];
+
+        if (!isset($products[$productKey])) {
+            return back()->with('error', 'Selected product is invalid.');
+        }
+
+        $product = $products[$productKey];
+        $realmId = (int) $validated['realm_id'];
+        $characterName = trim((string) ($validated['character_name'] ?? ''));
+        $user = $request->user();
+
+        $link = AccountLinked::query()
+            ->where('user_id', $user->id)
+            ->where('realm_id', $realmId)
+            ->first();
+
+        if (!$link) {
+            return back()->with('error', 'You do not have a linked game account for the selected realm.');
+        }
+
+        if (($product['requires_character'] ?? false) && $characterName === '') {
+            return back()->with('error', 'This product requires a character name.');
+        }
+
+        $realm = Realm::query()->find($realmId);
+        if (!$realm) {
+            return back()->with('error', 'Selected realm was not found.');
+        }
+
+        try {
+            $soap = new SoapAccountCreator(
+                (string) $realm->console_hostname,
+                (int) $realm->console_port,
+                (string) $realm->console_username,
+                (string) $realm->console_password,
+                (string) $realm->console_urn,
+                false
+            );
+
+            $response = $this->executeProduct($soap, $product, $characterName);
+
+            if ($this->responseHasError($response)) {
+                throw new \RuntimeException($response);
+            }
+
+            DB::transaction(static function () use ($user, $product): void {
+                $freshUser = User::query()->lockForUpdate()->findOrFail($user->id);
+                $cost = (int) $product['cost'];
+
+                if ((int) $freshUser->dp < $cost) {
+                    throw new \RuntimeException('Not enough donation points for this purchase.');
+                }
+
+                $freshUser->dp = (int) $freshUser->dp - $cost;
+                $freshUser->save();
+            });
+
+            return back()->with('success', 'Purchase completed successfully. Server response: ' . $response);
+        } catch (\Throwable $exception) {
+            return back()->with('error', 'Purchase failed: ' . $exception->getMessage());
+        }
+    }
+
+    /**
+     * @return array<string, array<string, mixed>>
+     */
+    private function getProducts(): array
+    {
+        return [
+            'rename' => [
+                'name' => 'Character Rename',
+                'description' => 'Forces a character rename on next login.',
+                'cost' => 600,
+                'requires_character' => true,
+                'type' => 'character_rename',
+            ],
+            'customize' => [
+                'name' => 'Character Customize',
+                'description' => 'Unlocks appearance customization on next login.',
+                'cost' => 800,
+                'requires_character' => true,
+                'type' => 'character_customize',
+            ],
+            'race_change' => [
+                'name' => 'Race Change',
+                'description' => 'Unlocks race change on next login.',
+                'cost' => 1200,
+                'requires_character' => true,
+                'type' => 'character_race_change',
+            ],
+            'faction_change' => [
+                'name' => 'Faction Change',
+                'description' => 'Unlocks faction change on next login.',
+                'cost' => 1500,
+                'requires_character' => true,
+                'type' => 'character_faction_change',
+            ],
+            'starter_mail' => [
+                'name' => 'Starter Mail Pack',
+                'description' => 'Sends a starter pack by in-game mail.',
+                'cost' => 500,
+                'requires_character' => true,
+                'type' => 'mail_starter_pack',
+            ],
+        ];
+    }
+
+    /**
+     * @param array<string, mixed> $product
+     */
+    private function executeProduct(SoapAccountCreator $soap, array $product, string $characterName): string
+    {
+        return match ((string) $product['type']) {
+            'character_rename' => $soap->character()->rename($characterName),
+            'character_customize' => $soap->character()->customize($characterName),
+            'character_race_change' => $soap->character()->changeRace($characterName),
+            'character_faction_change' => $soap->character()->changeFaction($characterName),
+            'mail_starter_pack' => $soap->mail()->sendItems(
+                $characterName,
+                'Nexus Store - Starter Pack',
+                'Thanks for your purchase. Enjoy your items and gold.',
+                [6948 => 1, 17031 => 20, 33447 => 10]
+            ),
+            default => throw new \InvalidArgumentException('Unsupported product type.'),
+        };
+    }
+
+    private function responseHasError(string $response): bool
+    {
+        return preg_match('/error|fail|invalid|denied/i', $response) === 1;
     }
 }
\ No newline at end of file
diff --git a/app/Modules/Store/Http/routes.php b/app/Modules/Store/Http/routes.php
index 494a2d5..30a37f2 100644
--- a/app/Modules/Store/Http/routes.php
+++ b/app/Modules/Store/Http/routes.php
@@ -2,8 +2,10 @@
 
 use Illuminate\Support\Facades\Route;
 
-Route::middleware('web')
-    ->prefix(strtolower('Store'))
+Route::middleware(['web', 'auth'])
+    ->prefix('store')
+    ->name('store.')
     ->group(function () {
-        Route::get('/', [\Modules\Store\Http\Controllers\StoreController::class, 'index']);
+        Route::get('/', [\Modules\Store\Http\Controllers\StoreController::class, 'index'])->name('index');
+        Route::post('/purchase', [\Modules\Store\Http\Controllers\StoreController::class, 'purchase'])->name('purchase');
     });
\ No newline at end of file
diff --git a/app/Modules/Store/Resources/views/store.blade.php b/app/Modules/Store/Resources/views/store.blade.php
index e04cde2..5d030a5 100644
--- a/app/Modules/Store/Resources/views/store.blade.php
+++ b/app/Modules/Store/Resources/views/store.blade.php
@@ -25,374 +25,99 @@
     </div>
 
     <!-- Realm Selector -->
-    <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 pb-12">
-        <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-6 mb-8">
-            <div class="flex flex-col md:flex-row md:items-center md:justify-between gap-4">
-                <div class="flex items-center gap-3">
-                    <i class="fas fa-globe text-blue-500 text-xl"></i>
-                    <div>
-                        <h3 class="font-bold">Select Realm</h3>
-                        <p class="text-sm text-slate-400">Choose which realm to purchase items for</p>
-                    </div>
-                </div>
-                <div class="flex flex-wrap gap-3">
-                    <button class="px-6 py-2 bg-blue-600 hover:bg-blue-700 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-blue-900/30">
-                        <i class="fas fa-server mr-2"></i>All Realms
-                    </button>
-                    <button class="px-6 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
-                        <i class="fas fa-fire mr-2 text-red-500"></i>Realm 1
-                    </button>
-                    <button class="px-6 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
-                        <i class="fas fa-bolt mr-2 text-yellow-500"></i>Realm 2
-                    </button>
-                    <button class="px-6 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
-                        <i class="fas fa-snowflake mr-2 text-cyan-500"></i>Realm 3
-                    </button>
-                </div>
-            </div>
-        </div>
+    @extends('layouts.main')
 
-        <!-- Filters and Search -->
-        <div class="flex flex-col md:flex-row gap-4 mb-8">
-            <div class="flex-1">
-                <div class="relative">
-                    <i class="fas fa-search absolute left-4 top-1/2 transform -translate-y-1/2 text-slate-400"></i>
-                    <input type="text" placeholder="Search items..." class="w-full pl-12 pr-4 py-3 bg-slate-900/50 border border-slate-800 rounded-lg focus:outline-none focus:border-blue-500 text-white">
-                </div>
-            </div>
-            <select class="px-4 py-3 bg-slate-900/50 border border-slate-800 rounded-lg focus:outline-none focus:border-blue-500 text-white">
-                <option>All Categories</option>
-                <option>Mounts</option>
-                <option>Pets</option>
-                <option>Transmog</option>
-                <option>Services</option>
-                <option>Consumables</option>
-                <option>Miscellaneous</option>
-            </select>
-            <select class="px-4 py-3 bg-slate-900/50 border border-slate-800 rounded-lg focus:outline-none focus:border-blue-500 text-white">
-                <option>Sort by: Featured</option>
-                <option>Price: Low to High</option>
-                <option>Price: High to Low</option>
-                <option>Newest</option>
-                <option>Most Popular</option>
-            </select>
-        </div>
+    @section('title', 'Store')
 
-        <!-- Category Tabs -->
-        <div class="flex flex-wrap gap-3 mb-8">
-            <button class="px-5 py-2 bg-blue-600 hover:bg-blue-700 rounded-lg font-semibold transition-all duration-200">
-                <i class="fas fa-star mr-2"></i>Featured
-            </button>
-            <button class="px-5 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
-                <i class="fas fa-horse mr-2"></i>Mounts
-            </button>
-            <button class="px-5 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
-                <i class="fas fa-paw mr-2"></i>Pets
-            </button>
-            <button class="px-5 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
-                <i class="fas fa-tshirt mr-2"></i>Transmog
-            </button>
-            <button class="px-5 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
-                <i class="fas fa-cogs mr-2"></i>Services
-            </button>
-            <button class="px-5 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
-                <i class="fas fa-flask mr-2"></i>Consumables
-            </button>
-        </div>
-
-        <!-- Featured Banner -->
-        <div class="bg-gradient-to-r from-purple-900/50 to-blue-900/50 border border-purple-700/50 rounded-xl p-8 mb-12">
-            <div class="flex flex-col md:flex-row items-center gap-6">
-                <div class="w-32 h-32 bg-slate-800 rounded-xl flex items-center justify-center">
-                    <i class="fas fa-dragon text-6xl text-purple-500"></i>
-                </div>
-                <div class="flex-1 text-center md:text-left">
-                    <span class="inline-block px-3 py-1 bg-purple-600 rounded-full text-xs font-semibold mb-2">LIMITED TIME</span>
-                    <h3 class="text-2xl md:text-3xl font-bold mb-2">Celestial Dragon Mount</h3>
-                    <p class="text-slate-300 mb-4">Exclusive flying mount with special effects - Only available this month!</p>
-                    <div class="flex items-center gap-4 justify-center md:justify-start">
-                        <span class="text-3xl font-bold text-purple-400">2,500 DP</span>
-                        <button class="px-6 py-2 bg-purple-600 hover:bg-purple-700 rounded-lg font-semibold transition-all duration-200 shadow-lg shadow-purple-900/30">
-                            Purchase Now
-                        </button>
-                    </div>
-                </div>
-            </div>
+    @section('content')
+        <div class="max-w-7xl mx-auto pt-24 pb-14 px-4 sm:px-6 lg:px-8">
+            <div class="mb-8 bg-slate-900/60 border border-slate-800 rounded-2xl p-6 md:p-8">
+                <div class="flex flex-col md:flex-row md:items-center md:justify-between gap-6">
+                    <div>
+                        <h1 class="text-3xl md:text-4xl font-bold mb-2">Donation Store</h1>
+                        <p class="text-slate-300">Purchase account services and rewards using your Donation Points.</p>
+                    </div>
+                    <div class="rounded-xl bg-slate-950/80 border border-slate-700 px-6 py-4 min-w-[180px]">
+                        <p class="text-xs uppercase tracking-widest text-slate-400">Current Balance</p>
+                        <p class="text-3xl font-bold text-yellow-400">{{ number_format($balance) }} DP</p>
+                    </div>
+                </div>
+            </div>
+
+            @if (session('success'))
+                <div class="mb-6 rounded-lg border border-green-700/60 bg-green-900/30 text-green-200 px-4 py-3">
+                    {{ session('success') }}
+                </div>
+            @endif
+
+            @if (session('error'))
+                <div class="mb-6 rounded-lg border border-red-700/60 bg-red-900/30 text-red-200 px-4 py-3">
+                    {{ session('error') }}
+                </div>
+            @endif
+
+            @if ($errors->any())
+                <div class="mb-6 rounded-lg border border-red-700/60 bg-red-900/30 text-red-200 px-4 py-3">
+                    <ul class="list-disc list-inside space-y-1">
+                        @foreach ($errors->all() as $error)
+                            <li>{{ $error }}</li>
+                        @endforeach
+                    </ul>
+                </div>
+            @endif
+
+            @if ($linkedAccounts->isEmpty())
+                <div class="rounded-xl border border-amber-700/60 bg-amber-900/20 text-amber-100 p-6">
+                    You do not have linked game accounts yet. Link at least one realm account before making purchases.
+                </div>
+            @else
+                <div class="grid md:grid-cols-2 xl:grid-cols-3 gap-6">
+                    @foreach ($products as $key => $product)
+                        <div class="bg-slate-900/60 border border-slate-800 rounded-2xl p-6 flex flex-col gap-4">
+                            <div>
+                                <h3 class="text-xl font-semibold">{{ $product['name'] }}</h3>
+                                <p class="text-slate-400 mt-1">{{ $product['description'] }}</p>
+                            </div>
+
+                            <div class="text-2xl font-bold text-blue-400">{{ number_format($product['cost']) }} DP</div>
+
+                            <form action="{{ route('store.purchase') }}" method="POST" class="space-y-3 mt-auto">
+                                @csrf
+                                <input type="hidden" name="product" value="{{ $key }}">
+
+                                <div>
+                                    <label for="realm_{{ $key }}" class="block text-sm text-slate-300 mb-1">Realm</label>
+                                    <select id="realm_{{ $key }}" name="realm_id" class="w-full rounded-lg bg-slate-950 border border-slate-700 px-3 py-2 text-slate-100" required>
+                                        <option value="">Select a realm</option>
+                                        @foreach ($linkedAccounts as $linked)
+                                            <option value="{{ $linked->realm->id }}">{{ $linked->realm->name }}</option>
+                                        @endforeach
+                                    </select>
+                                </div>
+
+                                @if ($product['requires_character'])
+                                    <div>
+                                        <label for="character_{{ $key }}" class="block text-sm text-slate-300 mb-1">Character Name</label>
+                                        <input
+                                            id="character_{{ $key }}"
+                                            name="character_name"
+                                            type="text"
+                                            maxlength="12"
+                                            class="w-full rounded-lg bg-slate-950 border border-slate-700 px-3 py-2 text-slate-100"
+                                            placeholder="Your character"
+                                            required
+                                        >
+                                    </div>
+                                @endif
+
+                                <button type="submit" class="w-full rounded-lg bg-blue-600 hover:bg-blue-700 text-white font-semibold py-2.5 transition-colors">
+                                    Buy Now
+                                </button>
+                            </form>
+                        </div>
+                    @endforeach
+                </div>
+            @endif
         </div>
-
+    @endsection
         <!-- Products Grid -->
-        <div class="grid md:grid-cols-3 lg:grid-cols-4 gap-6 mb-12">
-            <!-- Product Card 1 -->
-            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
-                <div class="relative">
-                    <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
-                        <i class="fas fa-dragon text-6xl text-blue-500 group-hover:scale-110 transition-transform duration-300"></i>
-                    </div>
-                    <div class="absolute top-3 right-3">
-                        <span class="px-2 py-1 bg-blue-600 rounded text-xs font-semibold">NEW</span>
-                    </div>
-                </div>
-                <div class="p-4">
-                    <div class="flex items-start justify-between mb-2">
-                        <h4 class="font-bold text-sm">Swift Spectral Tiger</h4>
-                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
-                            <i class="fas fa-star"></i>
-                        </button>
-                    </div>
-                    <p class="text-slate-400 text-xs mb-3">Epic Flying Mount</p>
-                    <div class="flex items-center justify-between">
-                        <span class="text-blue-500 font-bold">1,800 DP</span>
-                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
-                            Buy
-                        </button>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Product Card 2 -->
-            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
-                <div class="relative">
-                    <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
-                        <i class="fas fa-cat text-6xl text-purple-500 group-hover:scale-110 transition-transform duration-300"></i>
-                    </div>
-                    <div class="absolute top-3 right-3">
-                        <span class="px-2 py-1 bg-red-600 rounded text-xs font-semibold">HOT</span>
-                    </div>
-                </div>
-                <div class="p-4">
-                    <div class="flex items-start justify-between mb-2">
-                        <h4 class="font-bold text-sm">Mini Phoenix Pet</h4>
-                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
-                            <i class="fas fa-star"></i>
-                        </button>
-                    </div>
-                    <p class="text-slate-400 text-xs mb-3">Companion Pet</p>
-                    <div class="flex items-center justify-between">
-                        <span class="text-blue-500 font-bold">500 DP</span>
-                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
-                            Buy
-                        </button>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Product Card 3 -->
-            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
-                <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
-                    <i class="fas fa-vest text-6xl text-yellow-500 group-hover:scale-110 transition-transform duration-300"></i>
-                </div>
-                <div class="p-4">
-                    <div class="flex items-start justify-between mb-2">
-                        <h4 class="font-bold text-sm">Legendary Transmog Set</h4>
-                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
-                            <i class="fas fa-star"></i>
-                        </button>
-                    </div>
-                    <p class="text-slate-400 text-xs mb-3">Full Armor Set</p>
-                    <div class="flex items-center justify-between">
-                        <span class="text-blue-500 font-bold">2,200 DP</span>
-                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
-                            Buy
-                        </button>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Product Card 4 -->
-            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
-                <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
-                    <i class="fas fa-level-up-alt text-6xl text-green-500 group-hover:scale-110 transition-transform duration-300"></i>
-                </div>
-                <div class="p-4">
-                    <div class="flex items-start justify-between mb-2">
-                        <h4 class="font-bold text-sm">Level 80 Boost</h4>
-                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
-                            <i class="fas fa-star"></i>
-                        </button>
-                    </div>
-                    <p class="text-slate-400 text-xs mb-3">Character Service</p>
-                    <div class="flex items-center justify-between">
-                        <span class="text-blue-500 font-bold">3,500 DP</span>
-                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
-                            Buy
-                        </button>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Product Card 5 -->
-            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
-                <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
-                    <i class="fas fa-user-edit text-6xl text-cyan-500 group-hover:scale-110 transition-transform duration-300"></i>
-                </div>
-                <div class="p-4">
-                    <div class="flex items-start justify-between mb-2">
-                        <h4 class="font-bold text-sm">Name Change</h4>
-                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
-                            <i class="fas fa-star"></i>
-                        </button>
-                    </div>
-                    <p class="text-slate-400 text-xs mb-3">Character Service</p>
-                    <div class="flex items-center justify-between">
-                        <span class="text-blue-500 font-bold">600 DP</span>
-                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
-                            Buy
-                        </button>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Product Card 6 -->
-            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
-                <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
-                    <i class="fas fa-exchange-alt text-6xl text-orange-500 group-hover:scale-110 transition-transform duration-300"></i>
-                </div>
-                <div class="p-4">
-                    <div class="flex items-start justify-between mb-2">
-                        <h4 class="font-bold text-sm">Faction Change</h4>
-                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
-                            <i class="fas fa-star"></i>
-                        </button>
-                    </div>
-                    <p class="text-slate-400 text-xs mb-3">Character Service</p>
-                    <div class="flex items-center justify-between">
-                        <span class="text-blue-500 font-bold">1,200 DP</span>
-                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
-                            Buy
-                        </button>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Product Card 7 -->
-            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
-                <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
-                    <i class="fas fa-users text-6xl text-pink-500 group-hover:scale-110 transition-transform duration-300"></i>
-                </div>
-                <div class="p-4">
-                    <div class="flex items-start justify-between mb-2">
-                        <h4 class="font-bold text-sm">Race Change</h4>
-                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
-                            <i class="fas fa-star"></i>
-                        </button>
-                    </div>
-                    <p class="text-slate-400 text-xs mb-3">Character Service</p>
-                    <div class="flex items-center justify-between">
-                        <span class="text-blue-500 font-bold">1,000 DP</span>
-                        <button class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
-                            Buy
-                        </button>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Product Card 8 -->
-            <div class="bg-slate-900/50 border border-slate-800 rounded-xl overflow-hidden hover:border-blue-500/50 transition-all duration-300 group">
-                <div class="w-full aspect-square bg-gradient-to-br from-slate-800 to-slate-900 flex items-center justify-center">
-                    <i class="fas fa-flask text-6xl text-red-500 group-hover:scale-110 transition-transform duration-300"></i>
-                </div>
-                <div class="p-4">
-                    <div class="flex items-start justify-between mb-2">
-                        <h4 class="font-bold text-sm">XP Boost Potion (x10)</h4>
-                        <button class="text-slate-400 hover:text-yellow-500 transition-colors">
-                            <i class="fas fa-star"></i>
-                        </button>
-                    </div>
-                    <p class="text-slate-400 text-xs mb-3">Consumable</p>
-                    <div class="flex items-center justify-between">
-                        <span class="text-blue-500 font-bold">300 DP</span>
-                        <button onclick="document.getElementById('purchaseModal').classList.remove('hidden')" class="px-3 py-1 bg-blue-600 hover:bg-blue-700 rounded text-sm font-semibold transition-all duration-200">
-                            Buy
-                        </button>
-                    </div>
-                </div>
-            </div>
-        </div>
-
-        <!-- Pagination -->
-        <div class="flex justify-center items-center gap-2">
-            <button class="px-4 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
-                <i class="fas fa-chevron-left"></i>
-            </button>
-            <button class="px-4 py-2 bg-blue-600 hover:bg-blue-700 rounded-lg font-semibold transition-all duration-200">1</button>
-            <button class="px-4 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">2</button>
-            <button class="px-4 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">3</button>
-            <span class="px-2 text-slate-400">...</span>
-            <button class="px-4 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">10</button>
-            <button class="px-4 py-2 bg-slate-800 hover:bg-slate-700 border border-slate-700 rounded-lg font-semibold transition-all duration-200">
-                <i class="fas fa-chevron-right"></i>
-            </button>
-        </div>
-    </div>
-
-    <!-- Info Banner -->
-    <div class="bg-gradient-to-r from-blue-900/20 to-purple-900/20 border-y border-slate-800 py-12 mt-16">
-        <div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
-            <div class="grid md:grid-cols-3 gap-8 text-center">
-                <div>
-                    <i class="fas fa-shield-alt text-4xl text-blue-500 mb-4"></i>
-                    <h3 class="font-bold mb-2">Instant Delivery</h3>
-                    <p class="text-slate-400 text-sm">All items are delivered automatically to your account within minutes</p>
-                </div>
-                <div>
-                    <i class="fas fa-sync text-4xl text-green-500 mb-4"></i>
-                    <h3 class="font-bold mb-2">Multi-Realm Support</h3>
-                    <p class="text-slate-400 text-sm">Purchase once and use across all realms or choose specific realms</p>
-                </div>
-                <div>
-                    <i class="fas fa-headset text-4xl text-purple-500 mb-4"></i>
-                    <h3 class="font-bold mb-2">24/7 Support</h3>
-                    <p class="text-slate-400 text-sm">Our support team is always ready to help with any questions</p>
-                </div>
-            </div>
-        </div>
-    </div>
-@endsection
-
-@section('modals')
-<div id="purchaseModal" class="hidden fixed inset-0 bg-black/70 z-50">
-    <div class="flex items-center justify-center min-h-screen p-4">
-        <div role="dialog" aria-modal="true" class="bg-slate-900 border border-slate-800 rounded-xl max-w-md w-full">
-            <div class="flex items-center justify-between p-6 border-b border-slate-800">
-                <h3 class="text-xl font-bold">Confirm Purchase</h3>
-                <button class="px-3 py-2 bg-slate-800 rounded">
-                    <i class="fas fa-times"></i>
-                </button>
-            </div>
-            <div class="p-6">
-                <div class="mb-4">
-                    <div class="font-bold mb-1">Swift Spectral Tiger</div>
-                    <div class="text-slate-400 text-sm">Epic Flying Mount</div>
-                </div>
-                <div class="bg-slate-800 rounded-lg p-4 mb-4">
-                    <div class="flex justify-between mb-2">
-                        <span class="text-slate-400">Price</span>
-                        <span class="font-bold">1,800 DP</span>
-                    </div>
-                    <div class="flex justify-between">
-                        <span class="text-slate-400">Your Balance</span>
-                        <span class="font-bold text-yellow-500">2,450 DP</span>
-                    </div>
-                    <div class="border-t border-slate-700 my-3"></div>
-                    <div class="flex justify-between">
-                        <span class="text-slate-400">After Purchase</span>
-                        <span class="font-bold text-green-500">650 DP</span>
-                    </div>
-                </div>
-                <label class="block mb-4">
-                    <span class="text-sm text-slate-400 mb-2 block">Select Character</span>
-                    <select class="w-full px-4 py-2 bg-slate-800 border border-slate-700 rounded-lg text-white">
-                        <option>Character 1 - Level 80</option>
-                        <option>Character 2 - Level 70</option>
-                        <option>Character 3 - Level 60</option>
-                    </select>
-                </label>
-            </div>
-            <div class="flex gap-3 p-6 border-t border-slate-800">
-                <button class="flex-1 px-4 py-2 bg-slate-800 rounded">Cancel</button>
-                <button class="flex-1 px-4 py-2 bg-blue-600 rounded text-white">Confirm Purchase</button>
-            </div>
-        </div>
-    </div>
-</div>
-@endsection

From 69e019678a8b704fc1dfb8f9a31e8a4532d07242 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 10 May 2026 02:44:29 +0200
Subject: [PATCH 108/132] feat(api): add NexusCMS API configuration and error
 handling in ApiService

Co-authored-by: Copilot <copilot@github.com>
---
 .env.example                              |  5 +++++
 app/Modules/Admin/Services/ApiService.php | 20 +++++++++++++++-----
 config/services.php                       |  1 +
 3 files changed, 21 insertions(+), 5 deletions(-)

diff --git a/.env.example b/.env.example
index 400324a..bafb420 100644
--- a/.env.example
+++ b/.env.example
@@ -66,3 +66,8 @@ BRAINTREE_PUBLIC_KEY=
 BRAINTREE_PRIVATE_KEY=
 
 VITE_APP_NAME="${APP_NAME}"
+
+## NexusCMS API
+NEXUS_API_URL=https://api.wow-cms.com/api/github
+NEXUS_API_KEY=
+NEXUS_API_KEY_HEADER=X-API-Key
diff --git a/app/Modules/Admin/Services/ApiService.php b/app/Modules/Admin/Services/ApiService.php
index 0eda964..9df49f6 100644
--- a/app/Modules/Admin/Services/ApiService.php
+++ b/app/Modules/Admin/Services/ApiService.php
@@ -2,16 +2,18 @@
 
 namespace Modules\Admin\Services;
 
+use Illuminate\Http\Client\ConnectionException;
 use Illuminate\Support\Facades\Http;
 
 class ApiService
 {
-    protected string $baseUrl = 'http://wowcms-apiwowcms-rtpsnl-03dd1f-188-245-113-32.traefik.me/api/github';
+    protected string $baseUrl;
     protected ?string $apiKey;
     protected string $apiKeyHeader;
 
     public function __construct()
     {
+        $this->baseUrl = rtrim(config('services.nexus_api.url', 'https://api.wow-cms.com/api/github'), '/');
         $this->apiKey = config('services.nexus_api.key');
         $this->apiKeyHeader = config('services.nexus_api.header', 'X-API-Key');
     }
@@ -27,7 +29,11 @@ protected function http()
 
     public function latestRelease(): array
     {
-        $response = $this->http()->get($this->baseUrl . '/wow-cms/nexuscms/latest');
+        try {
+            $response = $this->http()->get($this->baseUrl . '/wow-cms/nexuscms/latest');
+        } catch (ConnectionException) {
+            return [];
+        }
 
         if (!$response->ok()) {
             return [];
@@ -40,9 +46,13 @@ public function latestRelease(): array
 
     public function checkVersion(string $owner, string $repo, string $current): array
     {
-        $response = $this->http()->get("{$this->baseUrl}/{$owner}/{$repo}/check-version", [
-            'current' => $current,
-        ]);
+        try {
+            $response = $this->http()->get("{$this->baseUrl}/{$owner}/{$repo}/check-version", [
+                'current' => $current,
+            ]);
+        } catch (ConnectionException) {
+            return [];
+        }
 
         if (!$response->ok()) {
             return [];
diff --git a/config/services.php b/config/services.php
index 9ecebf0..87741d0 100755
--- a/config/services.php
+++ b/config/services.php
@@ -36,6 +36,7 @@
     ],
 
     'nexus_api' => [
+        'url' => env('NEXUS_API_URL', 'https://api.wow-cms.com/api/github'),
         'key' => env('NEXUS_API_KEY'),
         'header' => env('NEXUS_API_KEY_HEADER', 'X-API-Key'),
     ],

From 20415e2b88188b594fe71b703d747affd1706823 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 10 May 2026 03:03:29 +0200
Subject: [PATCH 109/132] feat(admin): handle update server connection issues
 in dashboard view

---
 .../Admin/Http/Controllers/AdminController.php       |  2 +-
 app/Modules/Admin/Resources/views/index.blade.php    | 12 +++++++++++-
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/app/Modules/Admin/Http/Controllers/AdminController.php b/app/Modules/Admin/Http/Controllers/AdminController.php
index 5dfdca4..706e9ff 100644
--- a/app/Modules/Admin/Http/Controllers/AdminController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminController.php
@@ -20,7 +20,7 @@ public function index(Request $request)
         $latestRelease = $this->apiService->latestRelease();
         $checkVersion = $this->apiService->checkVersion('wow-cms', 'nexuscms', config('app.version'));
 
-        $outdated = $checkVersion['outdated'];
+        $outdated = $checkVersion['outdated'] ?? false;
 
         return view('admin::index', compact('latestRelease', 'checkVersion', 'outdated'));  
     }
diff --git a/app/Modules/Admin/Resources/views/index.blade.php b/app/Modules/Admin/Resources/views/index.blade.php
index 967fa32..111c10e 100644
--- a/app/Modules/Admin/Resources/views/index.blade.php
+++ b/app/Modules/Admin/Resources/views/index.blade.php
@@ -248,7 +248,17 @@
                     <span class="px-3 py-1 bg-green-100 text-green-700 rounded-full text-xs font-semibold shadow-sm">v{{ config('app.version') }}</span>
                 </div>
                 <div class="p-6">
-                    @if($outdated)
+                    @if(empty($checkVersion))
+                    <div class="flex items-start gap-4">
+                        <div class="w-12 h-12 bg-gradient-to-br from-gray-400 to-gray-500 rounded-xl flex items-center justify-center shadow-md">
+                            <i class="fas fa-plug text-white text-xl"></i>
+                        </div>
+                        <div class="flex-1">
+                            <p class="text-base text-gray-800 font-semibold mb-1">Could not connect to the update server</p>
+                            <p class="text-sm text-gray-500">Version information is unavailable. Please check your internet connection and try again later.</p>
+                        </div>
+                    </div>
+                    @elseif($outdated)
                     <div class="flex items-start gap-4">
                         <div class="w-12 h-12 bg-gradient-to-br from-blue-500 to-indigo-600 rounded-xl flex items-center justify-center shadow-md">
                             <i class="fas fa-rocket text-white text-xl"></i>

From 66790da475fc4210c5dd6319f77b31beb9e568c8 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 10 May 2026 03:16:30 +0200
Subject: [PATCH 110/132] refactor(store): remove redundant realm selector
 section from store view

---
 app/Modules/Store/Resources/views/store.blade.php | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/app/Modules/Store/Resources/views/store.blade.php b/app/Modules/Store/Resources/views/store.blade.php
index 5d030a5..6977179 100644
--- a/app/Modules/Store/Resources/views/store.blade.php
+++ b/app/Modules/Store/Resources/views/store.blade.php
@@ -24,11 +24,6 @@
         </div>
     </div>
 
-    <!-- Realm Selector -->
-    @extends('layouts.main')
-
-    @section('title', 'Store')
-
     @section('content')
         <div class="max-w-7xl mx-auto pt-24 pb-14 px-4 sm:px-6 lg:px-8">
             <div class="mb-8 bg-slate-900/60 border border-slate-800 rounded-2xl p-6 md:p-8">

From 66052aec5ad52b172aba9846a261a062f4e94f25 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 17 May 2026 00:47:56 +0200
Subject: [PATCH 111/132] feat(store): implement store products management with
 JSON CRUD system

- Add migration for creating store_products table with initial hardcoded products.
- Create admin-crud.json for store products management configuration.
- Update module.json to include admin CRUD configuration and menu settings.
- Enhance BaseModuleServiceProvider to load admin routes and views for custom CRUD.
- Introduce ModuleCrudService for handling CRUD operations and validation.
- Implement GenericCrudController for managing store products.
- Add performance indexes to analytics tables for improved query efficiency.
---
 .../Controllers/Frontend/HomeController.php   |  23 +-
 .../Frontend/Users/UserController.php         |  26 +-
 app/Http/Middleware/TrackAnalytics.php        |  69 +--
 app/Jobs/TrackAnalyticsPageView.php           |  57 +++
 app/Libraries/Redis/RedisLibrary.php          |  47 +-
 app/Models/NewsCategory.php                   |   6 +-
 .../Controllers/GenericCrudController.php     |  94 ++++
 .../Controllers/ModuleManagerController.php   |  62 +--
 app/Modules/Admin/Http/routes.php             |   1 +
 .../Admin/Providers/AdminServiceProvider.php  |  13 +-
 .../views/generic-crud/_form.blade.php        |  36 ++
 .../views/generic-crud/_section.blade.php     |  13 +
 .../views/generic-crud/create.blade.php       |  44 ++
 .../views/generic-crud/edit.blade.php         |  50 ++
 .../views/generic-crud/fields/date.blade.php  |  17 +
 .../generic-crud/fields/datetime.blade.php    |  17 +
 .../views/generic-crud/fields/file.blade.php  |  25 +
 .../generic-crud/fields/hidden.blade.php      |   3 +
 .../views/generic-crud/fields/image.blade.php |  28 ++
 .../generic-crud/fields/number.blade.php      |  23 +
 .../generic-crud/fields/relation.blade.php    |  33 ++
 .../generic-crud/fields/richtext.blade.php    |  22 +
 .../generic-crud/fields/select.blade.php      |  32 ++
 .../views/generic-crud/fields/slug.blade.php  |  49 ++
 .../views/generic-crud/fields/text.blade.php  |  21 +
 .../generic-crud/fields/textarea.blade.php    |  20 +
 .../generic-crud/fields/toggle.blade.php      |  21 +
 .../views/generic-crud/index.blade.php        | 121 +++++
 .../Resources/views/layouts/app.blade.php     |  67 ++-
 .../Resources/views/modules/edit.blade.php    |  43 +-
 .../Resources/views/modules/index.blade.php   |  10 +-
 .../Controllers/ArmoryAdminController.php     |  14 +
 app/Modules/Armory/Admin/routes.php           |  11 +
 .../Armory/Admin/views/index.blade.php        |  24 +
 .../TrinityCoreArmoryRepository.php           |  16 +-
 app/Modules/Armory/module.json                |   9 +-
 .../Controllers/DonateAdminController.php     | 103 +++++
 .../Donate/Admin/Views/plans/_form.blade.php  |  64 +++
 .../Donate/Admin/Views/plans/create.blade.php |  27 ++
 .../Donate/Admin/Views/plans/edit.blade.php   |  27 ++
 .../Donate/Admin/Views/plans/index.blade.php  |  87 ++++
 .../Admin/Views/transactions/index.blade.php  |  62 +++
 app/Modules/Donate/Admin/routes.php           |  20 +
 .../Domain/Models/DonationTransaction.php     |   7 +
 .../Http/Controllers/DonateController.php     |   6 +-
 app/Modules/Donate/module.json                |  10 +-
 .../Controllers/ExampleAdminController.php    |  13 +
 app/Modules/Example/Admin/routes.php          |  11 +
 .../Example/Admin/views/index.blade.php       |  17 +
 app/Modules/Example/module.json               |  13 +-
 .../Controllers/ForumAdminController.php      | 106 +++++
 app/Modules/Forum/Admin/Views/_form.blade.php |  57 +++
 .../Forum/Admin/Views/create.blade.php        |  27 ++
 app/Modules/Forum/Admin/Views/edit.blade.php  |  27 ++
 app/Modules/Forum/Admin/Views/index.blade.php |  71 +++
 app/Modules/Forum/Admin/routes.php            |  16 +
 app/Modules/Forum/module.json                 |   9 +-
 .../Controllers/StoreAdminController.php      |  53 +++
 app/Modules/Store/Admin/Views/index.blade.php |  72 +++
 app/Modules/Store/Admin/routes.php            |  11 +
 .../Store/Domain/Models/StoreProduct.php      |  28 ++
 ..._01_000001_create_store_products_table.php |  39 ++
 app/Modules/Store/admin-crud.json             |  86 ++++
 app/Modules/Store/module.json                 |  10 +-
 app/Providers/BaseModuleServiceProvider.php   |  35 ++
 app/Providers/ModuleServiceProvider.php       |  45 ++
 app/Services/AnalyticsService.php             |  21 +-
 app/Services/ModuleCrudService.php            | 188 ++++++++
 app/Services/ModuleRegistryService.php        |  27 ++
 app/Traits/Cacheable.php                      |  48 +-
 config/donate.php                             |   9 +-
 config/nexus.php                              |  14 +
 ...0010_add_analytics_performance_indexes.php |  36 ++
 docs/module-crud-system.md                    | 430 ++++++++++++++++++
 74 files changed, 2907 insertions(+), 192 deletions(-)
 create mode 100644 app/Jobs/TrackAnalyticsPageView.php
 create mode 100644 app/Modules/Admin/Http/Controllers/GenericCrudController.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/_form.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/_section.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/create.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/edit.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/date.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/datetime.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/file.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/hidden.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/image.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/number.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/relation.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/richtext.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/select.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/slug.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/text.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/textarea.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/toggle.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/index.blade.php
 create mode 100644 app/Modules/Armory/Admin/Controllers/ArmoryAdminController.php
 create mode 100644 app/Modules/Armory/Admin/routes.php
 create mode 100644 app/Modules/Armory/Admin/views/index.blade.php
 create mode 100644 app/Modules/Donate/Admin/Controllers/DonateAdminController.php
 create mode 100644 app/Modules/Donate/Admin/Views/plans/_form.blade.php
 create mode 100644 app/Modules/Donate/Admin/Views/plans/create.blade.php
 create mode 100644 app/Modules/Donate/Admin/Views/plans/edit.blade.php
 create mode 100644 app/Modules/Donate/Admin/Views/plans/index.blade.php
 create mode 100644 app/Modules/Donate/Admin/Views/transactions/index.blade.php
 create mode 100644 app/Modules/Donate/Admin/routes.php
 create mode 100644 app/Modules/Example/Admin/Controllers/ExampleAdminController.php
 create mode 100644 app/Modules/Example/Admin/routes.php
 create mode 100644 app/Modules/Example/Admin/views/index.blade.php
 create mode 100644 app/Modules/Forum/Admin/Controllers/ForumAdminController.php
 create mode 100644 app/Modules/Forum/Admin/Views/_form.blade.php
 create mode 100644 app/Modules/Forum/Admin/Views/create.blade.php
 create mode 100644 app/Modules/Forum/Admin/Views/edit.blade.php
 create mode 100644 app/Modules/Forum/Admin/Views/index.blade.php
 create mode 100644 app/Modules/Forum/Admin/routes.php
 create mode 100644 app/Modules/Store/Admin/Controllers/StoreAdminController.php
 create mode 100644 app/Modules/Store/Admin/Views/index.blade.php
 create mode 100644 app/Modules/Store/Admin/routes.php
 create mode 100644 app/Modules/Store/Domain/Models/StoreProduct.php
 create mode 100644 app/Modules/Store/Infrastructure/Database/migrations/2024_01_01_000001_create_store_products_table.php
 create mode 100644 app/Modules/Store/admin-crud.json
 create mode 100644 app/Services/ModuleCrudService.php
 create mode 100644 config/nexus.php
 create mode 100644 database/migrations/2026_05_17_000010_add_analytics_performance_indexes.php
 create mode 100644 docs/module-crud-system.md

diff --git a/app/Http/Controllers/Frontend/HomeController.php b/app/Http/Controllers/Frontend/HomeController.php
index 7b8ce9b..3fec9d3 100644
--- a/app/Http/Controllers/Frontend/HomeController.php
+++ b/app/Http/Controllers/Frontend/HomeController.php
@@ -55,23 +55,28 @@ public function index(Request $request, \App\Libraries\Redis\RedisLibrary $redis
         $perPage = $request->get('per_page', $this->perPage);
         $page = (int) ($request->get('page', 1));
 
-        $cacheKey = "news:list:perpage:{$perPage}:page:{$page}";
-        $featuredKey = 'home_featured';
+        // Single cache key for consistent home payload
+        $cacheKey = "home:news:page={$page}:perpage={$perPage}";
+        $cached = $redis->get($cacheKey);
 
-        $news = $redis->get($cacheKey);
-        $featuredNews = $redis->get($featuredKey);
-
-        if (!$news || !$featuredNews) {
+        if ($cached && is_array($cached) && isset($cached['news'], $cached['featured'])) {
+            $news = $cached['news'];
+            $featuredNews = $cached['featured'];
+        } else {
             $allNews = \App\Models\News::query()
+                ->where('is_published', true)
                 ->orderBy('created_at', 'desc')
                 ->paginate($perPage);
 
             $featuredNews = $allNews->shift();
             $news = $allNews;
 
-            $redis->set($cacheKey, $news, 60);
-            $redis->set($featuredKey, $featuredNews, 60);
-        }   
+            // Cache the unified payload
+            $redis->set($cacheKey, [
+                'news' => $news,
+                'featured' => $featuredNews,
+            ], 60);
+        }
     
         $data = [
             'realms' => $realms,
diff --git a/app/Http/Controllers/Frontend/Users/UserController.php b/app/Http/Controllers/Frontend/Users/UserController.php
index c7b7cb8..cd6fb33 100755
--- a/app/Http/Controllers/Frontend/Users/UserController.php
+++ b/app/Http/Controllers/Frontend/Users/UserController.php
@@ -83,16 +83,16 @@ public function transaction()
     {
         $user = $this->auth->guard()->user();
 
+        if (!$user) {
+            throw new UserNotFoundException('User not found', 404);
+        }
+
         $transactions = DonationTransaction::where('user_id', $user->id)->get();
 
         if ($transactions->isEmpty()) {
             $transactions = [];
         }
 
-        if (!$user) {
-            throw new UserNotFoundException('User not found', 404);
-        }
-
         return view($this->views['transaction'], compact('user', 'transactions'));
     }
 
@@ -126,12 +126,13 @@ public function createAction()
     public function manage()
     {
         $user = $this->auth->guard()->user();
-        $linkedAccount = AccountLinked::where('user_id', $user->id)->first();
 
         if (!$user) {
             throw new UserNotFoundException('User not found', 404);
         }
 
+        $linkedAccount = AccountLinked::where('user_id', $user->id)->first();
+
         return view($this->views['manage'], [
             'user' => $user,
             'account' => $linkedAccount ?? [],
@@ -157,7 +158,7 @@ public function gameAccount()
         return view($this->views['gameAccount'], [
             'user'          => $user,
             'gameAccounts'  => $gameAccounts,
-            'realm'         => Realm::all(),
+            'realm'         => Realm::query()->select(['id', 'name'])->get(),
         ]);
     }
 
@@ -169,13 +170,22 @@ public function gameAccount()
      */
     private function getUserGameAccounts($user)
     {
-        $gameLinked = AccountLinked::where('user_id', $user->id)->get();
+        $gameLinked = AccountLinked::query()
+            ->with('realm')
+            ->where('user_id', $user->id)
+            ->get();
         $account = [];
         $connectionErrors = false;
 
         foreach ($gameLinked as $game) {
             try {
-                $realm = Realm::findOrFail($game->realm_id);
+                $realm = $game->realm;
+
+                if (!$realm) {
+                    $connectionErrors = true;
+                    continue;
+                }
+
                 $external = $this->connectToExternalDatabase(
                     json_decode($realm->auth_database, true)
                 );
diff --git a/app/Http/Middleware/TrackAnalytics.php b/app/Http/Middleware/TrackAnalytics.php
index 9a14b10..4eab9a6 100644
--- a/app/Http/Middleware/TrackAnalytics.php
+++ b/app/Http/Middleware/TrackAnalytics.php
@@ -4,9 +4,7 @@
 
 use Closure;
 use Illuminate\Http\Request;
-use Illuminate\Support\Facades\Http;
-use App\Models\AnalyticsSession;
-use App\Models\AnalyticsPageView;
+use App\Jobs\TrackAnalyticsPageView;
 use Symfony\Component\HttpFoundation\Response;
 
 class TrackAnalytics
@@ -16,13 +14,18 @@ class TrackAnalytics
      */
     public function handle(Request $request, Closure $next): Response
     {
-        $response = $next($request);
+        $shouldTrack = $this->shouldTrack($request);
+        $isNew = false;
 
-        // Don't track admin panel, API, or debug bar requests
-        if ($this->shouldTrack($request)) {
+        if ($shouldTrack) {
             [$visitorId, $isNew] = $this->getOrCreateVisitorId($request);
-            $this->trackPageView($request, $visitorId);
+            $request->attributes->set('analytics.track', true);
+            $request->attributes->set('analytics.visitor_id', $visitorId);
+        }
+
+        $response = $next($request);
 
+        if ($shouldTrack && $isNew) {
             if ($isNew) {
                 $response->headers->setCookie(
                     cookie('analytics_visitor_id', $visitorId, 60 * 24 * 365, '/', null, false, true)
@@ -33,6 +36,22 @@ public function handle(Request $request, Closure $next): Response
         return $response;
     }
 
+    /**
+     * Persist analytics after the response has been sent.
+     */
+    public function terminate(Request $request, Response $response): void
+    {
+        if (!$request->attributes->get('analytics.track', false)) {
+            return;
+        }
+
+        $visitorId = $request->attributes->get('analytics.visitor_id');
+
+        if (is_string($visitorId) && $visitorId !== '') {
+            $this->trackPageView($request, $visitorId);
+        }
+    }
+
     /**
      * Determine if the request should be tracked
      */
@@ -62,39 +81,21 @@ protected function shouldTrack(Request $request): bool
     }
 
     /**
-     * Track a page view
+     * Track a page view via queued job.
      */
     protected function trackPageView(Request $request, string $visitorId): void
     {
         try {
-            // visitorId is passed in from handle()
-
-            // Get or create session
-            $session = AnalyticsSession::firstOrCreate(
-                ['visitor_id' => $visitorId],
-                [
-                    'ip_address' => $request->ip(),
-                    'user_agent' => $request->userAgent(),
-                    'is_bot' => $this->isBot($request->userAgent()),
-                ]
+            TrackAnalyticsPageView::dispatch(
+                visitorId: $visitorId,
+                ipAddress: (string) $request->ip(),
+                userAgent: (string) $request->userAgent(),
+                pagePath: $request->path(),
+                pageTitle: $this->getPageTitle($request),
+                referrer: $request->headers->get('referer'),
             );
-
-            // Increment page views count
-            $session->increment('page_views');
-            $session->touch('updated_at');
-
-            // Create page view record
-            AnalyticsPageView::create([
-                'session_id' => $session->id,
-                'page_url' => $request->path(),
-                'page_title' => $this->getPageTitle($request),
-                'referrer' => $request->headers->get('referer'),
-                'time_on_page' => 0, // Will be updated on next page view
-                'bounced' => false,
-            ]);
         } catch (\Exception $e) {
-            // Silently fail - analytics tracking shouldn't break the app
-            \Log::debug('Analytics tracking failed: ' . $e->getMessage());
+            \Log::debug('Analytics dispatch failed: ' . $e->getMessage());
         }
     }
 
diff --git a/app/Jobs/TrackAnalyticsPageView.php b/app/Jobs/TrackAnalyticsPageView.php
new file mode 100644
index 0000000..b865de5
--- /dev/null
+++ b/app/Jobs/TrackAnalyticsPageView.php
@@ -0,0 +1,57 @@
+<?php
+
+namespace App\Jobs;
+
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Queue\Queueable;
+use App\Models\AnalyticsSession;
+use App\Models\AnalyticsPageView;
+
+class TrackAnalyticsPageView implements ShouldQueue
+{
+    use Queueable;
+
+    /**
+     * Create a new job instance.
+     */
+    public function __construct(
+        private string $visitorId,
+        private string $ipAddress,
+        private string $userAgent,
+        private string $pagePath,
+        private ?string $pageTitle,
+        private ?string $referrer,
+    ) {
+    }
+
+    /**
+     * Execute the job.
+     */
+    public function handle(): void
+    {
+        try {
+            $session = AnalyticsSession::firstOrCreate(
+                ['visitor_id' => $this->visitorId],
+                [
+                    'ip_address' => $this->ipAddress,
+                    'user_agent' => $this->userAgent,
+                    'is_bot' => false,
+                ]
+            );
+
+            $session->increment('page_views');
+            $session->touch('updated_at');
+
+            AnalyticsPageView::create([
+                'session_id' => $session->id,
+                'page_url' => $this->pagePath,
+                'page_title' => $this->pageTitle,
+                'referrer' => $this->referrer,
+                'time_on_page' => 0,
+                'bounced' => false,
+            ]);
+        } catch (\Throwable $e) {
+            \Log::debug('Analytics job failed: ' . $e->getMessage());
+        }
+    }
+}
diff --git a/app/Libraries/Redis/RedisLibrary.php b/app/Libraries/Redis/RedisLibrary.php
index 6366cf7..82c378b 100644
--- a/app/Libraries/Redis/RedisLibrary.php
+++ b/app/Libraries/Redis/RedisLibrary.php
@@ -27,8 +27,43 @@ class RedisLibrary
     public function __construct(string $prefix = '')
     {
         $this->prefix = $prefix;
-        // Leer flag desde .env (por petición explícita). Si no existe, por defecto deshabilitado.
-        $this->enabled = filter_var(env('REDIS_ENABLED', false), FILTER_VALIDATE_BOOL);
+        // Read flag from config (safe with config:cache in production).
+        $this->enabled = (bool) config('nexus.redis_enabled', false);
+    }
+
+    /**
+     * Encode mixed payloads so objects/collections survive round trips.
+     */
+    private function encodeValue(mixed $value): string
+    {
+        return base64_encode(serialize($value));
+    }
+
+    /**
+     * Decode payloads with backward compatibility for older JSON/string values.
+     */
+    private function decodeValue(?string $value): mixed
+    {
+        if ($value === null) {
+            return null;
+        }
+
+        $decoded = base64_decode($value, true);
+        if ($decoded !== false) {
+            $unserialized = @unserialize($decoded, ['allowed_classes' => true]);
+
+            if ($unserialized !== false || $decoded === serialize(false)) {
+                return $unserialized;
+            }
+        }
+
+        $json = json_decode($value, true);
+
+        if (json_last_error() === JSON_ERROR_NONE) {
+            return $json;
+        }
+
+        return $value;
     }
 
     /**
@@ -54,6 +89,7 @@ private function key(string $key): string
     public function set(string $key, mixed $value, int $ttl = 0): bool
     {
         $key = $this->key($key);
+        $payload = $this->encodeValue($value);
 
         if (!$this->enabled) {
             if ($ttl > 0) {
@@ -66,9 +102,10 @@ public function set(string $key, mixed $value, int $ttl = 0): bool
 
         try {
             if ($ttl > 0) {
-                return Redis::set($key, $ttl, json_encode($value));
+                return (bool) Redis::setex($key, $ttl, $payload);
             }
-            return Redis::set($key, json_encode($value));
+
+            return (bool) Redis::set($key, $payload);
         } catch (\Throwable $e) {
             if ($ttl > 0) {
                 Cache::put($key, $value, now()->addSeconds($ttl));
@@ -95,7 +132,7 @@ public function get(string $key): mixed
 
         try {
             $value = Redis::get($key);
-            return $value ? json_decode($value, true) : null;
+            return $this->decodeValue($value);
         } catch (\Throwable $e) {
             return Cache::get($key, null);
         }
diff --git a/app/Models/NewsCategory.php b/app/Models/NewsCategory.php
index 56c1eea..6931b46 100755
--- a/app/Models/NewsCategory.php
+++ b/app/Models/NewsCategory.php
@@ -35,6 +35,10 @@ public function news()
 
     public function getAllCategoriesWithCount()
     {
-        return self::withCount('news')->get();
+        return self::query()
+            ->where('is_active', true)
+            ->withCount('news')
+            ->orderBy('order')
+            ->get();
     }
 }
diff --git a/app/Modules/Admin/Http/Controllers/GenericCrudController.php b/app/Modules/Admin/Http/Controllers/GenericCrudController.php
new file mode 100644
index 0000000..950599f
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/GenericCrudController.php
@@ -0,0 +1,94 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Services\ModuleCrudService;
+use App\Services\ModuleRegistryService;
+use Illuminate\Http\Request;
+
+class GenericCrudController extends Controller
+{
+    protected function getCrudConfigOrFail(string $module): array
+    {
+        $manifest = ModuleRegistryService::getModule($module);
+
+        if (!is_array($manifest) || ($manifest['admin_crud'] ?? '') !== 'json') {
+            abort(404);
+        }
+
+        $config = ModuleCrudService::getConfig($module);
+
+        if (!is_array($config)) {
+            abort(404, "admin-crud.json not found or invalid for module '{$module}'.");
+        }
+
+        return $config;
+    }
+
+    protected function crudRouteBase(string $module): string
+    {
+        return 'admin.' . strtolower($module) . '.crud.';
+    }
+
+    public function index(Request $request, string $module)
+    {
+        $config  = $this->getCrudConfigOrFail($module);
+        $records = ModuleCrudService::paginate($config, $request->query('search'));
+        $base    = $this->crudRouteBase($module);
+
+        return view('admin::generic-crud.index', compact('config', 'records', 'module', 'base'));
+    }
+
+    public function create(string $module)
+    {
+        $config = $this->getCrudConfigOrFail($module);
+        $base   = $this->crudRouteBase($module);
+
+        return view('admin::generic-crud.create', compact('config', 'module', 'base'));
+    }
+
+    public function store(Request $request, string $module)
+    {
+        $config = $this->getCrudConfigOrFail($module);
+        $data   = $request->validate(ModuleCrudService::buildValidationRules($config));
+
+        ModuleCrudService::store($config, $data);
+
+        return redirect()
+            ->route($this->crudRouteBase($module) . 'index')
+            ->with('success', 'Record created successfully.');
+    }
+
+    public function edit(string $module, int|string $id)
+    {
+        $config = $this->getCrudConfigOrFail($module);
+        $record = ModuleCrudService::find($config, $id);
+        $base   = $this->crudRouteBase($module);
+
+        return view('admin::generic-crud.edit', compact('config', 'record', 'module', 'base'));
+    }
+
+    public function update(Request $request, string $module, int|string $id)
+    {
+        $config = $this->getCrudConfigOrFail($module);
+        $data   = $request->validate(ModuleCrudService::buildValidationRules($config, isUpdate: true));
+
+        ModuleCrudService::update($config, $id, $data);
+
+        return redirect()
+            ->route($this->crudRouteBase($module) . 'index')
+            ->with('success', 'Record updated successfully.');
+    }
+
+    public function destroy(string $module, int|string $id)
+    {
+        $config = $this->getCrudConfigOrFail($module);
+
+        ModuleCrudService::destroy($config, $id);
+
+        return redirect()
+            ->route($this->crudRouteBase($module) . 'index')
+            ->with('success', 'Record deleted successfully.');
+    }
+}
diff --git a/app/Modules/Admin/Http/Controllers/ModuleManagerController.php b/app/Modules/Admin/Http/Controllers/ModuleManagerController.php
index 85b85cf..ced554a 100644
--- a/app/Modules/Admin/Http/Controllers/ModuleManagerController.php
+++ b/app/Modules/Admin/Http/Controllers/ModuleManagerController.php
@@ -34,37 +34,50 @@ public function update(Request $request, string $module)
         $moduleData = $this->getModuleDataOrFail($module);
 
         $validated = $request->validate([
-            'name' => ['required', 'string', 'max:100'],
-            'namespace' => ['required', 'string', 'max:255'],
+            'name'        => ['required', 'string', 'max:100'],
             'module_type' => ['required', 'string', 'in:core,third_party'],
-            'enabled' => ['nullable', 'boolean'],
-            'routes' => ['nullable', 'boolean'],
-            'migrations' => ['nullable', 'boolean'],
-            'views' => ['nullable', 'boolean'],
-            'translations' => ['nullable', 'boolean'],
         ]);
 
-        $config = $moduleData['config'];
-        $config['name'] = $validated['name'];
-        $config['namespace'] = $validated['namespace'];
-        $config['enabled'] = $request->boolean('enabled');
-        $config['module_type'] = $validated['module_type'];
-        $config['routes'] = $request->boolean('routes');
-        $config['migrations'] = $request->boolean('migrations');
-        $config['views'] = $request->boolean('views');
-        $config['translations'] = $request->boolean('translations');
-
         ModuleRegistryService::upsertState(
             $moduleData['folder'],
-            $request->boolean('enabled'),
+            (bool) $moduleData['enabled'],
             $validated['module_type']
         );
 
+        $config = $moduleData['config'];
+        $config['name'] = $validated['name'];
+        $config['module_type'] = $validated['module_type'];
+
         $this->saveConfig($moduleData, $config);
 
         return redirect()
             ->route('admin.modules.edit', $moduleData['folder'])
-            ->with('success', "Module '{$moduleData['folder']}' configuration updated successfully.");
+            ->with('success', "Module '{$moduleData['folder']}' updated successfully.");
+    }
+
+    public function uninstall(string $module)
+    {
+        $moduleData = $this->getModuleDataOrFail($module);
+
+        if ($moduleData['folder'] === 'Admin') {
+            return redirect()
+                ->route('admin.modules.index')
+                ->with('error', 'The Admin module cannot be uninstalled.');
+        }
+
+        // Delete the DB record so the module loses its overridden state.
+        // syncDiscoveredModules() will recreate it with defaults from module.json,
+        // so we immediately re-register it as disabled to give visible feedback.
+        ModuleRegistryService::deleteState($moduleData['folder']);
+        ModuleRegistryService::upsertState(
+            $moduleData['folder'],
+            false,
+            (string) $moduleData['module_type']
+        );
+
+        return redirect()
+            ->route('admin.modules.index')
+            ->with('success', "Module '{$moduleData['folder']}' uninstalled — state reset and disabled. The code files were not removed.");
     }
 
     public function toggle(string $module)
@@ -169,17 +182,6 @@ protected function getModuleDataOrFail(string $module): array
         return $this->hydrateModuleData($moduleData);
     }
 
-    protected function buildModuleData(string $module): array
-    {
-        $moduleData = ModuleRegistryService::getModule($module);
-
-        if (!is_array($moduleData)) {
-            abort(404);
-        }
-
-        return $this->hydrateModuleData($moduleData);
-    }
-
     protected function hydrateModuleData(array $module): array
     {
         $folder = (string) ($module['folder'] ?? '');
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index 8e1201e..0d525b9 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -79,4 +79,5 @@
         Route::patch('/modules/{module}/toggle', [\Modules\Admin\Http\Controllers\ModuleManagerController::class, 'toggle'])->middleware('permission:manage.modules')->name('admin.modules.toggle');
         Route::post('/modules/{module}/migrate', [\Modules\Admin\Http\Controllers\ModuleManagerController::class, 'migrate'])->middleware('permission:manage.modules')->name('admin.modules.migrate');
         Route::delete('/modules/{module}', [\Modules\Admin\Http\Controllers\ModuleManagerController::class, 'destroy'])->middleware('permission:manage.modules')->name('admin.modules.destroy');
+        Route::delete('/modules/{module}/uninstall', [\Modules\Admin\Http\Controllers\ModuleManagerController::class, 'uninstall'])->middleware('permission:manage.modules')->name('admin.modules.uninstall');
     });
diff --git a/app/Modules/Admin/Providers/AdminServiceProvider.php b/app/Modules/Admin/Providers/AdminServiceProvider.php
index 9f82477..e3c6cb7 100644
--- a/app/Modules/Admin/Providers/AdminServiceProvider.php
+++ b/app/Modules/Admin/Providers/AdminServiceProvider.php
@@ -3,8 +3,19 @@
 namespace Modules\Admin\Providers;
 
 use App\Providers\BaseModuleServiceProvider;
+use App\Services\ModuleRegistryService;
+use Illuminate\Support\Facades\View;
 
 class AdminServiceProvider extends BaseModuleServiceProvider
 {
     protected string $moduleName = 'Admin';
-}
\ No newline at end of file
+
+    public function boot(): void
+    {
+        parent::boot();
+
+        View::composer('admin::layouts.app', function (\Illuminate\View\View $view) {
+            $view->with('adminMenuItems', ModuleRegistryService::getAdminMenuItems());
+        });
+    }
+}
diff --git a/app/Modules/Admin/Resources/views/generic-crud/_form.blade.php b/app/Modules/Admin/Resources/views/generic-crud/_form.blade.php
new file mode 100644
index 0000000..bd3b42d
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/_form.blade.php
@@ -0,0 +1,36 @@
+{{--
+    Generic form partial. Iterates over $config['form']['sections'] and renders each field.
+    Supports layouts: "single" and "sidebar".
+--}}
+@php
+    $layout = $config['form']['layout'] ?? 'single';
+    $sections = $config['form']['sections'] ?? [];
+
+    if ($layout === 'sidebar') {
+        $mainSections    = array_filter($sections, fn($s) => ($s['position'] ?? 'main') === 'main');
+        $sidebarSections = array_filter($sections, fn($s) => ($s['position'] ?? 'main') === 'sidebar');
+    }
+@endphp
+
+@if($layout === 'sidebar')
+<div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
+    {{-- Main column --}}
+    <div class="lg:col-span-2 space-y-6">
+        @foreach($mainSections as $section)
+            @include('admin::generic-crud._section', compact('section', 'record'))
+        @endforeach
+    </div>
+    {{-- Sidebar column --}}
+    <div class="space-y-6">
+        @foreach($sidebarSections as $section)
+            @include('admin::generic-crud._section', compact('section', 'record'))
+        @endforeach
+    </div>
+</div>
+@else
+<div class="space-y-6">
+    @foreach($sections as $section)
+        @include('admin::generic-crud._section', compact('section', 'record'))
+    @endforeach
+</div>
+@endif
diff --git a/app/Modules/Admin/Resources/views/generic-crud/_section.blade.php b/app/Modules/Admin/Resources/views/generic-crud/_section.blade.php
new file mode 100644
index 0000000..9fbf79a
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/_section.blade.php
@@ -0,0 +1,13 @@
+{{-- Section card --}}
+<div class="bg-white rounded-lg shadow p-6">
+    @if(!empty($section['title']))
+        <h3 class="text-base font-semibold text-gray-800 mb-4">{{ $section['title'] }}</h3>
+    @endif
+
+    <div class="space-y-5">
+        @foreach($section['fields'] ?? [] as $field)
+            @php $type = $field['type'] ?? 'text'; @endphp
+            @include("admin::generic-crud.fields.{$type}", compact('field', 'record'))
+        @endforeach
+    </div>
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/create.blade.php b/app/Modules/Admin/Resources/views/generic-crud/create.blade.php
new file mode 100644
index 0000000..4e5d356
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/create.blade.php
@@ -0,0 +1,44 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Create — ' . ($config['title'] ?? 'Record'))
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <h1 class="text-2xl font-bold text-gray-800">New {{ $config['title'] ?? 'Record' }}</h1>
+    <a href="{{ route($base . 'index') }}"
+       class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
+        <i class="fas fa-arrow-left mr-2"></i>Back
+    </a>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if($errors->any())
+        <div class="mb-6 p-4 bg-red-50 border-l-4 border-red-500 rounded-lg">
+            <p class="text-red-700 text-sm font-medium mb-2">Please fix the following errors:</p>
+            <ul class="text-sm text-red-700 list-disc list-inside">
+                @foreach($errors->all() as $error)
+                    <li>{{ $error }}</li>
+                @endforeach
+            </ul>
+        </div>
+    @endif
+
+    <form method="POST" action="{{ route($base . 'store') }}"
+          enctype="multipart/form-data">
+        @csrf
+
+        @include('admin::generic-crud._form', ['config' => $config, 'record' => null])
+
+        <div class="mt-6 flex items-center gap-3">
+            <button type="submit"
+                    class="px-5 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                <i class="fas fa-save mr-2"></i>Save
+            </button>
+            <a href="{{ route($base . 'index') }}"
+               class="px-5 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300 text-sm font-medium">
+                Cancel
+            </a>
+        </div>
+    </form>
+</main>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/generic-crud/edit.blade.php b/app/Modules/Admin/Resources/views/generic-crud/edit.blade.php
new file mode 100644
index 0000000..b4d9dce
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/edit.blade.php
@@ -0,0 +1,50 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Edit — ' . ($config['title'] ?? 'Record'))
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <h1 class="text-2xl font-bold text-gray-800">Edit {{ $config['title'] ?? 'Record' }}</h1>
+    <a href="{{ route($base . 'index') }}"
+       class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
+        <i class="fas fa-arrow-left mr-2"></i>Back
+    </a>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if(session('success'))
+        <div class="mb-4 p-3 bg-green-50 text-green-700 border border-green-200 rounded-lg flex items-center gap-2">
+            <i class="fas fa-check-circle"></i> {{ session('success') }}
+        </div>
+    @endif
+    @if($errors->any())
+        <div class="mb-6 p-4 bg-red-50 border-l-4 border-red-500 rounded-lg">
+            <p class="text-red-700 text-sm font-medium mb-2">Please fix the following errors:</p>
+            <ul class="text-sm text-red-700 list-disc list-inside">
+                @foreach($errors->all() as $error)
+                    <li>{{ $error }}</li>
+                @endforeach
+            </ul>
+        </div>
+    @endif
+
+    <form method="POST"
+          action="{{ route($base . 'update', $record->getKey()) }}"
+          enctype="multipart/form-data">
+        @csrf @method('PUT')
+
+        @include('admin::generic-crud._form', ['config' => $config, 'record' => $record])
+
+        <div class="mt-6 flex items-center gap-3">
+            <button type="submit"
+                    class="px-5 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                <i class="fas fa-save mr-2"></i>Save Changes
+            </button>
+            <a href="{{ route($base . 'index') }}"
+               class="px-5 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300 text-sm font-medium">
+                Cancel
+            </a>
+        </div>
+    </form>
+</main>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/date.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/date.blade.php
new file mode 100644
index 0000000..57d7dfd
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/date.blade.php
@@ -0,0 +1,17 @@
+@php $value = old($field['name'], $record?->{$field['name']} ? \Carbon\Carbon::parse($record->{$field['name']})->format('Y-m-d') : ($field['default'] ?? '')); @endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+    </label>
+    <input type="date"
+           id="{{ $field['name'] }}"
+           name="{{ $field['name'] }}"
+           value="{{ $value }}"
+           class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500 text-sm
+                  @error($field['name']) border-red-400 @enderror"
+           {{ ($field['required'] ?? false) ? 'required' : '' }}>
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/datetime.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/datetime.blade.php
new file mode 100644
index 0000000..1697870
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/datetime.blade.php
@@ -0,0 +1,17 @@
+@php $value = old($field['name'], $record?->{$field['name']} ? \Carbon\Carbon::parse($record->{$field['name']})->format('Y-m-d\TH:i') : ($field['default'] ?? '')); @endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+    </label>
+    <input type="datetime-local"
+           id="{{ $field['name'] }}"
+           name="{{ $field['name'] }}"
+           value="{{ $value }}"
+           class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500 text-sm
+                  @error($field['name']) border-red-400 @enderror"
+           {{ ($field['required'] ?? false) ? 'required' : '' }}>
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/file.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/file.blade.php
new file mode 100644
index 0000000..31b8e9b
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/file.blade.php
@@ -0,0 +1,25 @@
+@php $current = $record?->{$field['name']} ?? null; @endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+    </label>
+    @if($current)
+        <p class="mb-2 text-xs text-gray-500">
+            Current: <span class="font-mono text-gray-700">{{ $current }}</span>
+        </p>
+    @endif
+    <input type="file"
+           id="{{ $field['name'] }}"
+           name="{{ $field['name'] }}"
+           class="w-full text-sm text-gray-500 file:mr-4 file:py-2 file:px-4 file:rounded-lg file:border-0
+                  file:text-sm file:font-medium file:bg-gray-100 file:text-gray-700 hover:file:bg-gray-200
+                  @error($field['name']) border border-red-400 rounded-lg p-1 @enderror"
+           {{ ($field['required'] ?? false) && !$current ? 'required' : '' }}>
+    @if(!empty($field['hint']))
+        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/hidden.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/hidden.blade.php
new file mode 100644
index 0000000..e8576f4
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/hidden.blade.php
@@ -0,0 +1,3 @@
+<input type="hidden"
+       name="{{ $field['name'] }}"
+       value="{{ $field['value'] ?? old($field['name'], $record?->{$field['name']} ?? '') }}">
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/image.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/image.blade.php
new file mode 100644
index 0000000..c7d95f9
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/image.blade.php
@@ -0,0 +1,28 @@
+@php $current = $record?->{$field['name']} ?? null; @endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+    </label>
+    @if($current)
+        <div class="mb-2">
+            <img src="{{ asset('storage/' . $current) }}"
+                 alt="Current image"
+                 class="h-24 w-auto rounded-lg border border-gray-200 object-cover">
+        </div>
+    @endif
+    <input type="file"
+           id="{{ $field['name'] }}"
+           name="{{ $field['name'] }}"
+           accept="image/*"
+           class="w-full text-sm text-gray-500 file:mr-4 file:py-2 file:px-4 file:rounded-lg file:border-0
+                  file:text-sm file:font-medium file:bg-blue-50 file:text-blue-700 hover:file:bg-blue-100
+                  @error($field['name']) border border-red-400 rounded-lg p-1 @enderror"
+           {{ ($field['required'] ?? false) && !$current ? 'required' : '' }}>
+    @if(!empty($field['hint']))
+        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/number.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/number.blade.php
new file mode 100644
index 0000000..e1de311
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/number.blade.php
@@ -0,0 +1,23 @@
+@php $value = old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? '')); @endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+    </label>
+    <input type="number"
+           id="{{ $field['name'] }}"
+           name="{{ $field['name'] }}"
+           value="{{ $value }}"
+           step="{{ $field['step'] ?? 1 }}"
+           min="{{ $field['min'] ?? '' }}"
+           max="{{ $field['max'] ?? '' }}"
+           class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500 text-sm
+                  @error($field['name']) border-red-400 @enderror"
+           {{ ($field['required'] ?? false) ? 'required' : '' }}>
+    @if(!empty($field['hint']))
+        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/relation.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/relation.blade.php
new file mode 100644
index 0000000..edd4f08
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/relation.blade.php
@@ -0,0 +1,33 @@
+{{--
+    Relation field: a select populated from an Eloquent relation.
+    Expects $field['model'], $field['value_field'], $field['label_field'].
+--}}
+@php
+    $value   = old($field['name'], $record?->{$field['name']} ?? '');
+    $options = \App\Services\ModuleCrudService::resolveRelationOptions($field);
+@endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+    </label>
+    <select id="{{ $field['name'] }}"
+            name="{{ $field['name'] }}"
+            class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500 text-sm
+                   @error($field['name']) border-red-400 @enderror"
+            {{ ($field['required'] ?? false) ? 'required' : '' }}>
+        <option value="">— Select —</option>
+        @foreach($options as $option)
+            <option value="{{ $option['value'] }}"
+                    {{ (string) $value === (string) $option['value'] ? 'selected' : '' }}>
+                {{ $option['label'] }}
+            </option>
+        @endforeach
+    </select>
+    @if(!empty($field['hint']))
+        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/richtext.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/richtext.blade.php
new file mode 100644
index 0000000..423a144
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/richtext.blade.php
@@ -0,0 +1,22 @@
+{{--
+    Richtext field: textarea enhanced with CKEditor 5.
+    CKEditor must be included via the layout or @stack('scripts').
+--}}
+@php $value = old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? '')); @endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+    </label>
+    <textarea id="{{ $field['name'] }}"
+              name="{{ $field['name'] }}"
+              class="richtext-editor w-full rounded-lg border-gray-300 text-sm
+                     @error($field['name']) border-red-400 @enderror"
+              {{ ($field['required'] ?? false) ? 'required' : '' }}>{{ $value }}</textarea>
+    @if(!empty($field['hint']))
+        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/select.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/select.blade.php
new file mode 100644
index 0000000..bb730bc
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/select.blade.php
@@ -0,0 +1,32 @@
+@php $value = old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? '')); @endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+    </label>
+    <select id="{{ $field['name'] }}"
+            name="{{ $field['name'] }}"
+            class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500 text-sm
+                   @error($field['name']) border-red-400 @enderror"
+            {{ ($field['required'] ?? false) ? 'required' : '' }}>
+        <option value="">— Select —</option>
+        @php
+            $options = $field['options'] ?? [];
+            if (!empty($field['relation'])) {
+                $options = \App\Services\ModuleCrudService::resolveRelationOptions($field['relation']);
+            }
+        @endphp
+        @foreach($options as $option)
+            <option value="{{ $option['value'] }}"
+                    {{ (string) $value === (string) $option['value'] ? 'selected' : '' }}>
+                {{ $option['label'] }}
+            </option>
+        @endforeach
+    </select>
+    @if(!empty($field['hint']))
+        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/slug.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/slug.blade.php
new file mode 100644
index 0000000..53b187b
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/slug.blade.php
@@ -0,0 +1,49 @@
+{{--
+    Slug field: renders as a text input with optional JS auto-generation from a source field.
+--}}
+@php $value = old($field['name'], $record?->{$field['name']} ?? ''); @endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+    </label>
+    <input type="text"
+           id="{{ $field['name'] }}"
+           name="{{ $field['name'] }}"
+           value="{{ $value }}"
+           class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500 text-sm font-mono
+                  @error($field['name']) border-red-400 @enderror"
+           {{ ($field['required'] ?? false) ? 'required' : '' }}>
+    @if(!empty($field['hint']))
+        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+    @enderror
+</div>
+
+@if(!empty($field['source']))
+@push('scripts')
+<script>
+(function () {
+    const src = document.getElementById('{{ $field['source'] }}');
+    const slug = document.getElementById('{{ $field['name'] }}');
+    if (!src || !slug) return;
+
+    src.addEventListener('input', function () {
+        if (slug.dataset.edited) return;
+        slug.value = src.value
+            .toLowerCase()
+            .normalize('NFD').replace(/[\u0300-\u036f]/g, '')
+            .replace(/[^a-z0-9\s-]/g, '')
+            .trim()
+            .replace(/[\s]+/g, '-');
+    });
+
+    slug.addEventListener('input', function () {
+        slug.dataset.edited = '1';
+    });
+})();
+</script>
+@endpush
+@endif
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/text.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/text.blade.php
new file mode 100644
index 0000000..7d99cb8
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/text.blade.php
@@ -0,0 +1,21 @@
+@php $value = old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? '')); @endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+    </label>
+    <input type="text"
+           id="{{ $field['name'] }}"
+           name="{{ $field['name'] }}"
+           value="{{ $value }}"
+           placeholder="{{ $field['placeholder'] ?? '' }}"
+           class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500 text-sm
+                  @error($field['name']) border-red-400 @enderror"
+           {{ ($field['required'] ?? false) ? 'required' : '' }}>
+    @if(!empty($field['hint']))
+        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/textarea.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/textarea.blade.php
new file mode 100644
index 0000000..6e25c19
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/textarea.blade.php
@@ -0,0 +1,20 @@
+@php $value = old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? '')); @endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+    </label>
+    <textarea id="{{ $field['name'] }}"
+              name="{{ $field['name'] }}"
+              rows="{{ $field['rows'] ?? 4 }}"
+              placeholder="{{ $field['placeholder'] ?? '' }}"
+              class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500 text-sm
+                     @error($field['name']) border-red-400 @enderror"
+              {{ ($field['required'] ?? false) ? 'required' : '' }}>{{ $value }}</textarea>
+    @if(!empty($field['hint']))
+        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/toggle.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/toggle.blade.php
new file mode 100644
index 0000000..7493c59
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/toggle.blade.php
@@ -0,0 +1,21 @@
+@php $checked = (bool) old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? false)); @endphp
+<div>
+    <label class="flex items-center gap-3 cursor-pointer">
+        <input type="hidden" name="{{ $field['name'] }}" value="0">
+        <input type="checkbox"
+               id="{{ $field['name'] }}"
+               name="{{ $field['name'] }}"
+               value="1"
+               class="rounded border-gray-300 text-blue-600 focus:ring-blue-500 w-4 h-4"
+               {{ $checked ? 'checked' : '' }}>
+        <span class="text-sm font-medium text-gray-700">
+            {{ $field['label'] ?? $field['name'] }}
+        </span>
+    </label>
+    @if(!empty($field['hint']))
+        <p class="mt-1 ml-7 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/index.blade.php b/app/Modules/Admin/Resources/views/generic-crud/index.blade.php
new file mode 100644
index 0000000..1069485
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/index.blade.php
@@ -0,0 +1,121 @@
+@extends('admin::layouts.app')
+
+@section('title', $config['title'] ?? 'Manage')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <div class="flex items-center gap-4">
+        <h1 class="text-2xl font-bold text-gray-800">{{ $config['title'] ?? 'Manage' }}</h1>
+    </div>
+    <a href="{{ route($base . 'create') }}"
+       class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+        <i class="fas fa-plus mr-1"></i> New Record
+    </a>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if(session('success'))
+        <div class="mb-4 p-3 bg-green-50 text-green-700 border border-green-200 rounded-lg flex items-center gap-2">
+            <i class="fas fa-check-circle"></i> {{ session('success') }}
+        </div>
+    @endif
+    @if(session('error'))
+        <div class="mb-4 p-3 bg-red-50 text-red-700 border border-red-200 rounded-lg flex items-center gap-2">
+            <i class="fas fa-exclamation-circle"></i> {{ session('error') }}
+        </div>
+    @endif
+
+    <div class="bg-white rounded-lg shadow">
+        <div class="p-6 border-b border-gray-200 flex items-center justify-between gap-4">
+            <h2 class="text-lg font-bold text-gray-800">Records</h2>
+            {{-- Search --}}
+            @if(!empty($config['list']['searchable']))
+            <form method="GET" class="flex items-center gap-2">
+                <input type="text" name="search" value="{{ request('search') }}"
+                       placeholder="Search…"
+                       class="rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500 w-56">
+                <button type="submit" class="px-3 py-2 bg-gray-100 text-gray-700 rounded-lg hover:bg-gray-200 text-sm">
+                    <i class="fas fa-search"></i>
+                </button>
+                @if(request('search'))
+                <a href="{{ route($base . 'index') }}" class="px-3 py-2 text-gray-400 hover:text-gray-600 text-sm">
+                    <i class="fas fa-times"></i>
+                </a>
+                @endif
+            </form>
+            @endif
+        </div>
+
+        <div class="overflow-x-auto">
+            <table class="w-full text-sm">
+                <thead>
+                    <tr class="border-b border-gray-100 bg-gray-50">
+                        @foreach($config['list']['columns'] as $col)
+                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">
+                                {{ $col['label'] ?? $col['field'] }}
+                            </th>
+                        @endforeach
+                        <th class="px-6 py-3 text-right text-xs font-semibold text-gray-500 uppercase tracking-wider">Actions</th>
+                    </tr>
+                </thead>
+                <tbody class="divide-y divide-gray-100">
+                    @forelse($records as $record)
+                    <tr class="hover:bg-gray-50 transition-colors">
+                        @foreach($config['list']['columns'] as $col)
+                            <td class="px-6 py-4 text-gray-700">
+                                @php
+                                    $value = $record->{$col['field']} ?? null;
+                                    $format = $col['format'] ?? null;
+                                @endphp
+                                @if($format === 'date' && $value)
+                                    {{ \Carbon\Carbon::parse($value)->format('M d, Y') }}
+                                @elseif($format === 'datetime' && $value)
+                                    {{ \Carbon\Carbon::parse($value)->format('M d, Y H:i') }}
+                                @elseif($format === 'boolean')
+                                    <span class="px-2 py-0.5 rounded-full text-xs font-medium {{ $value ? 'bg-green-100 text-green-700' : 'bg-gray-100 text-gray-500' }}">
+                                        {{ $value ? 'Yes' : 'No' }}
+                                    </span>
+                                @else
+                                    {{ $value }}
+                                @endif
+                            </td>
+                        @endforeach
+                        <td class="px-6 py-4 text-right">
+                            <div class="flex items-center justify-end gap-2">
+                                <a href="{{ route($base . 'edit', $record->getKey()) }}"
+                                   class="px-3 py-1 bg-gray-100 text-gray-700 rounded hover:bg-gray-200 text-xs font-medium">
+                                    Edit
+                                </a>
+                                <form method="POST"
+                                      action="{{ route($base . 'destroy', $record->getKey()) }}"
+                                      onsubmit="return confirm('Delete this record?')">
+                                    @csrf @method('DELETE')
+                                    <button type="submit"
+                                            class="px-3 py-1 bg-red-50 text-red-700 rounded hover:bg-red-100 text-xs font-medium">
+                                        Delete
+                                    </button>
+                                </form>
+                            </div>
+                        </td>
+                    </tr>
+                    @empty
+                    <tr>
+                        <td colspan="{{ count($config['list']['columns']) + 1 }}"
+                            class="px-6 py-12 text-center text-gray-400">
+                            <i class="fas fa-inbox text-3xl mb-2 block"></i>
+                            No records found.
+                        </td>
+                    </tr>
+                    @endforelse
+                </tbody>
+            </table>
+        </div>
+
+        @if($records->hasPages())
+        <div class="px-6 py-4 border-t border-gray-100">
+            {{ $records->links() }}
+        </div>
+        @endif
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index 889343e..8e9cc4e 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -160,35 +160,41 @@ class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium
                 </a>
                 @endcan
             </div>
-
-            {{-- ── Store ── --}}
+            
+            {{-- ── Modules (dynamic) ── --}}
+            @if(!empty($adminMenuItems))
             <div>
-                <p class="px-3 mb-1.5 text-[10px] font-semibold uppercase tracking-widest text-gray-500 select-none">Store</p>
-                @can('manage.store.products')
-                <a href="#"
-                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
-                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
-                    <i class="fas fa-bag-shopping w-4 text-center"></i>
-                    Products
-                </a>
-                @endcan
-                @can('manage.store.categories')
-                <a href="#"
-                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
-                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
-                    <i class="fas fa-tags w-4 text-center"></i>
-                    Categories
-                </a>
-                @endcan
-                @can('view.store.transactions')
-                <a href="#"
-                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
-                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
-                    <i class="fas fa-receipt w-4 text-center"></i>
-                    Transactions
-                </a>
-                @endcan
+                <p class="px-3 mb-1.5 text-[10px] font-semibold uppercase tracking-widest text-gray-500 select-none">Modules</p>
+                @foreach($adminMenuItems as $menuItem)
+                    @php
+                        $routeName  = $menuItem['route'] ?? null;
+                        $permission = $menuItem['permission'] ?? null;
+                        $label      = $menuItem['label'] ?? $menuItem['module'];
+                        $icon       = $menuItem['icon'] ?? 'fas fa-puzzle-piece';
+                        $active     = $routeName ? request()->routeIs(\Illuminate\Support\Str::beforeLast($routeName, '.') . '.*') : false;
+                    @endphp
+                    @if($routeName && Route::has($routeName))
+                        @if($permission)
+                            @can($permission)
+                            <a href="{{ route($routeName) }}"
+                               class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                                      {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                                <i class="{{ $icon }} w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
+                                {{ $label }}
+                            </a>
+                            @endcan
+                        @else
+                            <a href="{{ route($routeName) }}"
+                               class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                                      {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                                <i class="{{ $icon }} w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
+                                {{ $label }}
+                            </a>
+                        @endif
+                    @endif
+                @endforeach
             </div>
+            @endif
 
             {{-- ── Realms ── --}}
             <div>
@@ -201,12 +207,6 @@ class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium
                     <i class="fas fa-server w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
                     Realm Management
                 </a>
-                <a href="#"
-                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
-                          text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
-                    <i class="fas fa-database w-4 text-center"></i>
-                    Database
-                </a>
                 <a href="#"
                    class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
                           text-gray-400 hover:bg-white/[0.05] hover:text-gray-200">
@@ -265,7 +265,6 @@ class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium
                 </a>
                 @endcan
             </div>
-
         </nav>
 
         {{-- User footer --}}
diff --git a/app/Modules/Admin/Resources/views/modules/edit.blade.php b/app/Modules/Admin/Resources/views/modules/edit.blade.php
index a1d570f..2557547 100644
--- a/app/Modules/Admin/Resources/views/modules/edit.blade.php
+++ b/app/Modules/Admin/Resources/views/modules/edit.blade.php
@@ -44,11 +44,6 @@
                     <input type="text" id="name" name="name" value="{{ old('name', $module['name']) }}" class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500" required>
                 </div>
 
-                <div>
-                    <label for="namespace" class="block text-sm font-medium text-gray-700 mb-1">Namespace</label>
-                    <input type="text" id="namespace" name="namespace" value="{{ old('namespace', $module['namespace']) }}" class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500" required>
-                </div>
-
                 <div>
                     <label for="module_type" class="block text-sm font-medium text-gray-700 mb-1">Module Type</label>
                     <select id="module_type" name="module_type" class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500" required>
@@ -57,29 +52,6 @@
                     </select>
                 </div>
 
-                <div class="grid grid-cols-1 md:grid-cols-2 gap-4">
-                    <label class="flex items-center gap-2 text-sm text-gray-700">
-                        <input type="checkbox" name="enabled" value="1" class="rounded border-gray-300 text-blue-600 focus:ring-blue-500" {{ old('enabled', $module['enabled']) ? 'checked' : '' }}>
-                        Enabled
-                    </label>
-                    <label class="flex items-center gap-2 text-sm text-gray-700">
-                        <input type="checkbox" name="routes" value="1" class="rounded border-gray-300 text-blue-600 focus:ring-blue-500" {{ old('routes', $module['routes']) ? 'checked' : '' }}>
-                        Load Routes
-                    </label>
-                    <label class="flex items-center gap-2 text-sm text-gray-700">
-                        <input type="checkbox" name="migrations" value="1" class="rounded border-gray-300 text-blue-600 focus:ring-blue-500" {{ old('migrations', $module['migrations']) ? 'checked' : '' }}>
-                        Load Migrations
-                    </label>
-                    <label class="flex items-center gap-2 text-sm text-gray-700">
-                        <input type="checkbox" name="views" value="1" class="rounded border-gray-300 text-blue-600 focus:ring-blue-500" {{ old('views', $module['views']) ? 'checked' : '' }}>
-                        Load Views
-                    </label>
-                    <label class="flex items-center gap-2 text-sm text-gray-700 md:col-span-2">
-                        <input type="checkbox" name="translations" value="1" class="rounded border-gray-300 text-blue-600 focus:ring-blue-500" {{ old('translations', $module['translations']) ? 'checked' : '' }}>
-                        Load Translations
-                    </label>
-                </div>
-
                 <div class="pt-2">
                     <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
                         <i class="fas fa-save mr-2"></i>Save Configuration
@@ -100,8 +72,19 @@
                     <dd class="text-gray-800 break-all">{{ $module['config_path'] }}</dd>
                 </div>
                 <div>
-                    <dt class="text-gray-500">Migrations path</dt>
-                    <dd class="text-gray-800 break-all">{{ $module['migrations_path'] }}</dd>
+                    <dt class="text-gray-500">Namespace</dt>
+                    <dd class="text-gray-800 font-medium break-all">{{ $module['namespace'] }}</dd>
+                </div>
+                <div>
+                    <dt class="text-gray-500">Capabilities</dt>
+                    <dd class="mt-1">
+                        <div class="flex flex-wrap gap-1">
+                            <span class="px-2 py-0.5 rounded text-xs {{ $module['routes'] ? 'bg-blue-100 text-blue-700' : 'bg-gray-100 text-gray-400' }}">Routes</span>
+                            <span class="px-2 py-0.5 rounded text-xs {{ $module['migrations'] ? 'bg-blue-100 text-blue-700' : 'bg-gray-100 text-gray-400' }}">Migrations</span>
+                            <span class="px-2 py-0.5 rounded text-xs {{ $module['views'] ? 'bg-blue-100 text-blue-700' : 'bg-gray-100 text-gray-400' }}">Views</span>
+                            <span class="px-2 py-0.5 rounded text-xs {{ $module['translations'] ? 'bg-blue-100 text-blue-700' : 'bg-gray-100 text-gray-400' }}">Translations</span>
+                        </div>
+                    </dd>
                 </div>
             </dl>
         </div>
diff --git a/app/Modules/Admin/Resources/views/modules/index.blade.php b/app/Modules/Admin/Resources/views/modules/index.blade.php
index 41007b8..71e64c7 100644
--- a/app/Modules/Admin/Resources/views/modules/index.blade.php
+++ b/app/Modules/Admin/Resources/views/modules/index.blade.php
@@ -144,7 +144,7 @@
 
                                             <form method="POST" action="{{ route('admin.modules.migrate', $module['folder']) }}">
                                                 @csrf
-                                                <button type="submit" class="px-3 py-1.5 rounded-lg text-sm font-medium bg-blue-50 text-blue-700 hover:bg-blue-100 {{ !$module['has_migrations'] ? 'opacity-50 cursor-not-allowed' : '' }}" {{ !$module['has_migrations'] ? 'disabled' : '' }}>
+                                                <button type="submit" class="px-3 py-1.5 rounded-lg text-sm font-medium bg-blue-50 text-blue-700 hover:bg-blue-100 {{ !$module['has_migrations'] ? 'opacity-50 cursor-not-allowed' : '' }}" {{ !$module['has_migrations'] ? 'disabled' : '' }} title="{{ !$module['has_migrations'] ? 'No migration files found for this module' : 'Run pending migrations' }}">
                                                     <i class="fas fa-database mr-1"></i>Migrate
                                                 </button>
                                             </form>
@@ -161,6 +161,14 @@
                                                     <i class="fas fa-trash mr-1"></i>Delete
                                                 </button>
                                             </form>
+
+                                            <form method="POST" action="{{ route('admin.modules.uninstall', $module['folder']) }}" onsubmit="return confirm('This will remove the DB record for \'{{ $module['folder'] }}\' but keep the code. Continue?');">
+                                                @csrf
+                                                @method('DELETE')
+                                                <button type="submit" class="px-3 py-1.5 rounded-lg text-sm font-medium bg-orange-50 text-orange-700 hover:bg-orange-100">
+                                                    <i class="fas fa-unlink mr-1"></i>Uninstall
+                                                </button>
+                                            </form>
                                             @endif
                                         </div>
                                     </td>
diff --git a/app/Modules/Armory/Admin/Controllers/ArmoryAdminController.php b/app/Modules/Armory/Admin/Controllers/ArmoryAdminController.php
new file mode 100644
index 0000000..6f726db
--- /dev/null
+++ b/app/Modules/Armory/Admin/Controllers/ArmoryAdminController.php
@@ -0,0 +1,14 @@
+<?php
+
+namespace Modules\Armory\Admin\Controllers;
+
+use App\Http\Controllers\Controller;
+use Illuminate\View\View;
+
+class ArmoryAdminController extends Controller
+{
+    public function index(): View
+    {
+        return view('armory-admin::index');
+    }
+}
diff --git a/app/Modules/Armory/Admin/routes.php b/app/Modules/Armory/Admin/routes.php
new file mode 100644
index 0000000..7000296
--- /dev/null
+++ b/app/Modules/Armory/Admin/routes.php
@@ -0,0 +1,11 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use Modules\Armory\Admin\Controllers\ArmoryAdminController;
+
+Route::middleware(['auth', 'permission:access.admin.panel'])
+    ->prefix('acp/armory')
+    ->name('admin.armory.')
+    ->group(function () {
+        Route::get('/', [ArmoryAdminController::class, 'index'])->name('index');
+    });
diff --git a/app/Modules/Armory/Admin/views/index.blade.php b/app/Modules/Armory/Admin/views/index.blade.php
new file mode 100644
index 0000000..cbfbac5
--- /dev/null
+++ b/app/Modules/Armory/Admin/views/index.blade.php
@@ -0,0 +1,24 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Armory Settings')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <h1 class="text-2xl font-bold text-gray-800">Armory</h1>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <div class="bg-white rounded-lg shadow p-6 max-w-xl">
+        <p class="text-gray-600 text-sm mb-4">
+            The Armory module reads character data directly from the game database via the
+            <code class="text-xs bg-gray-100 px-1 py-0.5 rounded">ArmoryRepositoryInterface</code>.
+            No CMS-side records are stored.
+        </p>
+        <div class="bg-blue-50 border border-blue-200 text-blue-800 rounded-lg px-4 py-3 text-sm">
+            <i class="fas fa-info-circle mr-1"></i>
+            To configure the game database connection, edit <code>config/database.php</code>
+            and set the <code>characters</code> / <code>world</code> connection credentials.
+        </div>
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Armory/Infrastructure/Repositories/TrinityCoreArmoryRepository.php b/app/Modules/Armory/Infrastructure/Repositories/TrinityCoreArmoryRepository.php
index 28616d8..1bc0682 100644
--- a/app/Modules/Armory/Infrastructure/Repositories/TrinityCoreArmoryRepository.php
+++ b/app/Modules/Armory/Infrastructure/Repositories/TrinityCoreArmoryRepository.php
@@ -72,16 +72,19 @@ protected function getWorld(): ?Connection
     }
 
     /**
-     * Get all characters from characters database
+     * Get all characters from characters database with pagination
      *
-     * @return Collection Collection of all characters or empty collection if connection failed
+     * @return Collection Collection of characters or empty collection if connection failed
      */
     public function getAllCharacters()
     {
         $conn = $this->getCharacters();
         if (!$conn) return collect();
 
-        return $conn->table('characters')->get();
+        return $conn->table('characters')
+            ->select(['guid', 'name', 'race', 'class', 'level', 'gender', 'account'])
+            ->limit(500)
+            ->get();
     }
 
     /**
@@ -95,7 +98,8 @@ public function search(string $q, ?string $faction, ?string $class, ?int $minLev
         $conn = $this->getCharacters();
         if (!$conn) return collect();
 
-        $query = $conn->table('characters');
+        $query = $conn->table('characters')
+            ->select(['guid', 'name', 'race', 'class', 'level', 'gender']);
 
         if ($q) {
             $query->where('name', 'like', "%{$q}%");
@@ -116,7 +120,9 @@ public function search(string $q, ?string $faction, ?string $class, ?int $minLev
             $query->where('level', '>=', $minLevel);
         }
         
-        return $query->orderByDesc('level')->get();
+        return $query->orderByDesc('level')
+            ->limit(100)
+            ->get();
     }
 
     /**
diff --git a/app/Modules/Armory/module.json b/app/Modules/Armory/module.json
index 2d464d3..4a16ec0 100644
--- a/app/Modules/Armory/module.json
+++ b/app/Modules/Armory/module.json
@@ -4,5 +4,12 @@
     "routes": true,
     "migrations": true,
     "views": true,
-    "namespace": "Modules\\Armory"
+    "namespace": "Modules\\Armory",
+    "admin_crud": "custom",
+    "admin_menu": {
+        "label": "Armory",
+        "icon": "fas fa-shield-alt",
+        "route": "admin.armory.index",
+        "order": 35
+    }
 }
diff --git a/app/Modules/Donate/Admin/Controllers/DonateAdminController.php b/app/Modules/Donate/Admin/Controllers/DonateAdminController.php
new file mode 100644
index 0000000..2982103
--- /dev/null
+++ b/app/Modules/Donate/Admin/Controllers/DonateAdminController.php
@@ -0,0 +1,103 @@
+<?php
+
+namespace Modules\Donate\Admin\Controllers;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+use Modules\Donate\Domain\Models\DonationPlan;
+use Modules\Donate\Domain\Models\DonationTransaction;
+
+class DonateAdminController extends Controller
+{
+    // ─── Plans ────────────────────────────────────────────────────────────────
+
+    public function plansIndex(): View
+    {
+        $plans = DonationPlan::query()->orderBy('sort_order')->get();
+
+        return view('donate-admin::plans.index', compact('plans'));
+    }
+
+    public function plansCreate(): View
+    {
+        return view('donate-admin::plans.create');
+    }
+
+    public function plansStore(Request $request): RedirectResponse
+    {
+        $validated = $request->validate([
+            'name'        => ['required', 'string', 'max:255'],
+            'description' => ['nullable', 'string'],
+            'amount'      => ['required', 'numeric', 'min:0.01'],
+            'dp_base'     => ['required', 'integer', 'min:1'],
+            'extra_pct'   => ['nullable', 'integer', 'min:0', 'max:9999'],
+            'is_promo'    => ['boolean'],
+            'active'      => ['boolean'],
+            'sort_order'  => ['nullable', 'integer', 'min:0'],
+        ]);
+
+        $validated['is_promo']   = $request->boolean('is_promo');
+        $validated['active']     = $request->boolean('active');
+        $validated['extra_pct']  = (int) ($validated['extra_pct'] ?? 0);
+        $validated['sort_order'] = (int) ($validated['sort_order'] ?? 0);
+
+        DonationPlan::query()->create($validated);
+
+        return redirect()
+            ->route('admin.donate.plans.index')
+            ->with('success', 'Donation plan created.');
+    }
+
+    public function plansEdit(DonationPlan $plan): View
+    {
+        return view('donate-admin::plans.edit', compact('plan'));
+    }
+
+    public function plansUpdate(Request $request, DonationPlan $plan): RedirectResponse
+    {
+        $validated = $request->validate([
+            'name'        => ['required', 'string', 'max:255'],
+            'description' => ['nullable', 'string'],
+            'amount'      => ['required', 'numeric', 'min:0.01'],
+            'dp_base'     => ['required', 'integer', 'min:1'],
+            'extra_pct'   => ['nullable', 'integer', 'min:0', 'max:9999'],
+            'is_promo'    => ['boolean'],
+            'active'      => ['boolean'],
+            'sort_order'  => ['nullable', 'integer', 'min:0'],
+        ]);
+
+        $validated['is_promo']   = $request->boolean('is_promo');
+        $validated['active']     = $request->boolean('active');
+        $validated['extra_pct']  = (int) ($validated['extra_pct'] ?? 0);
+        $validated['sort_order'] = (int) ($validated['sort_order'] ?? 0);
+
+        $plan->update($validated);
+
+        return redirect()
+            ->route('admin.donate.plans.index')
+            ->with('success', 'Donation plan updated.');
+    }
+
+    public function plansDestroy(DonationPlan $plan): RedirectResponse
+    {
+        $plan->delete();
+
+        return redirect()
+            ->route('admin.donate.plans.index')
+            ->with('success', 'Donation plan deleted.');
+    }
+
+    // ─── Transactions ─────────────────────────────────────────────────────────
+
+    public function transactionsIndex(): View
+    {
+        $transactions = DonationTransaction::query()
+            ->with('user')
+            ->latest()
+            ->paginate(50);
+
+        return view('donate-admin::transactions.index', compact('transactions'));
+    }
+}
diff --git a/app/Modules/Donate/Admin/Views/plans/_form.blade.php b/app/Modules/Donate/Admin/Views/plans/_form.blade.php
new file mode 100644
index 0000000..35025f9
--- /dev/null
+++ b/app/Modules/Donate/Admin/Views/plans/_form.blade.php
@@ -0,0 +1,64 @@
+@if($errors->any())
+    <div class="mb-4 bg-red-50 border border-red-200 text-red-800 rounded-lg px-4 py-3 text-sm">
+        <ul class="list-disc list-inside space-y-1">
+            @foreach($errors->all() as $error)<li>{{ $error }}</li>@endforeach
+        </ul>
+    </div>
+@endif
+
+<div class="space-y-4">
+    <div>
+        <label class="block text-sm font-medium text-gray-700 mb-1">Name <span class="text-red-500">*</span></label>
+        <input type="text" name="name" value="{{ old('name', $plan?->name) }}" required
+               class="w-full border border-gray-300 rounded-lg px-3 py-2 text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+    </div>
+
+    <div>
+        <label class="block text-sm font-medium text-gray-700 mb-1">Description</label>
+        <textarea name="description" rows="2"
+                  class="w-full border border-gray-300 rounded-lg px-3 py-2 text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">{{ old('description', $plan?->description) }}</textarea>
+    </div>
+
+    <div class="grid grid-cols-2 gap-4">
+        <div>
+            <label class="block text-sm font-medium text-gray-700 mb-1">Amount (USD) <span class="text-red-500">*</span></label>
+            <input type="number" name="amount" value="{{ old('amount', $plan?->amount) }}" step="0.01" min="0.01" required
+                   class="w-full border border-gray-300 rounded-lg px-3 py-2 text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+        </div>
+        <div>
+            <label class="block text-sm font-medium text-gray-700 mb-1">DP Base <span class="text-red-500">*</span></label>
+            <input type="number" name="dp_base" value="{{ old('dp_base', $plan?->dp_base) }}" min="1" required
+                   class="w-full border border-gray-300 rounded-lg px-3 py-2 text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+        </div>
+    </div>
+
+    <div class="grid grid-cols-2 gap-4">
+        <div>
+            <label class="block text-sm font-medium text-gray-700 mb-1">Bonus % (extra DP)</label>
+            <input type="number" name="extra_pct" value="{{ old('extra_pct', $plan?->extra_pct ?? 0) }}" min="0"
+                   class="w-full border border-gray-300 rounded-lg px-3 py-2 text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+        </div>
+        <div>
+            <label class="block text-sm font-medium text-gray-700 mb-1">Display Order</label>
+            <input type="number" name="sort_order" value="{{ old('sort_order', $plan?->sort_order ?? 0) }}" min="0"
+                   class="w-full border border-gray-300 rounded-lg px-3 py-2 text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+        </div>
+    </div>
+
+    <div class="flex items-center gap-6 pt-1">
+        <div class="flex items-center gap-2">
+            <input type="hidden" name="active" value="0">
+            <input type="checkbox" name="active" id="active" value="1"
+                   @checked(old('active', $plan?->active ?? true))
+                   class="h-4 w-4 text-blue-600 border-gray-300 rounded">
+            <label for="active" class="text-sm font-medium text-gray-700">Active</label>
+        </div>
+        <div class="flex items-center gap-2">
+            <input type="hidden" name="is_promo" value="0">
+            <input type="checkbox" name="is_promo" id="is_promo" value="1"
+                   @checked(old('is_promo', $plan?->is_promo))
+                   class="h-4 w-4 text-yellow-500 border-gray-300 rounded">
+            <label for="is_promo" class="text-sm font-medium text-gray-700">Promo plan</label>
+        </div>
+    </div>
+</div>
diff --git a/app/Modules/Donate/Admin/Views/plans/create.blade.php b/app/Modules/Donate/Admin/Views/plans/create.blade.php
new file mode 100644
index 0000000..604d198
--- /dev/null
+++ b/app/Modules/Donate/Admin/Views/plans/create.blade.php
@@ -0,0 +1,27 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Create Donation Plan')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <h1 class="text-2xl font-bold text-gray-800">Create Donation Plan</h1>
+    <a href="{{ route('admin.donate.plans.index') }}" class="text-sm text-gray-500 hover:text-gray-700">
+        <i class="fas fa-arrow-left mr-1"></i> Back
+    </a>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <div class="max-w-2xl mx-auto bg-white rounded-lg shadow p-6">
+        <form method="POST" action="{{ route('admin.donate.plans.store') }}">
+            @csrf
+            @include('donate-admin::plans._form', ['plan' => null])
+            <div class="mt-6 flex justify-end">
+                <button type="submit"
+                        class="bg-blue-600 hover:bg-blue-700 text-white text-sm font-medium px-5 py-2 rounded-lg transition">
+                    Create Plan
+                </button>
+            </div>
+        </form>
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Donate/Admin/Views/plans/edit.blade.php b/app/Modules/Donate/Admin/Views/plans/edit.blade.php
new file mode 100644
index 0000000..6efd0db
--- /dev/null
+++ b/app/Modules/Donate/Admin/Views/plans/edit.blade.php
@@ -0,0 +1,27 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Edit Donation Plan')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <h1 class="text-2xl font-bold text-gray-800">Edit Plan — {{ $plan->name }}</h1>
+    <a href="{{ route('admin.donate.plans.index') }}" class="text-sm text-gray-500 hover:text-gray-700">
+        <i class="fas fa-arrow-left mr-1"></i> Back
+    </a>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <div class="max-w-2xl mx-auto bg-white rounded-lg shadow p-6">
+        <form method="POST" action="{{ route('admin.donate.plans.update', $plan) }}">
+            @csrf @method('PUT')
+            @include('donate-admin::plans._form', ['plan' => $plan])
+            <div class="mt-6 flex justify-end">
+                <button type="submit"
+                        class="bg-blue-600 hover:bg-blue-700 text-white text-sm font-medium px-5 py-2 rounded-lg transition">
+                    Save Changes
+                </button>
+            </div>
+        </form>
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Donate/Admin/Views/plans/index.blade.php b/app/Modules/Donate/Admin/Views/plans/index.blade.php
new file mode 100644
index 0000000..4775db2
--- /dev/null
+++ b/app/Modules/Donate/Admin/Views/plans/index.blade.php
@@ -0,0 +1,87 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Donation Plans')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <h1 class="text-2xl font-bold text-gray-800">Donation Plans</h1>
+    <div class="flex items-center gap-3">
+        <a href="{{ route('admin.donate.transactions.index') }}"
+           class="text-sm text-gray-500 hover:text-gray-700 font-medium">
+            <i class="fas fa-list mr-1"></i> Transactions
+        </a>
+        <a href="{{ route('admin.donate.plans.create') }}"
+           class="inline-flex items-center gap-2 bg-blue-600 hover:bg-blue-700 text-white text-sm font-medium px-4 py-2 rounded-lg transition">
+            <i class="fas fa-plus"></i> New Plan
+        </a>
+    </div>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if(session('success'))
+        <div class="mb-4 bg-green-50 border border-green-200 text-green-800 rounded-lg px-4 py-3 text-sm">
+            {{ session('success') }}
+        </div>
+    @endif
+    @if(session('error'))
+        <div class="mb-4 bg-red-50 border border-red-200 text-red-800 rounded-lg px-4 py-3 text-sm">
+            {{ session('error') }}
+        </div>
+    @endif
+
+    <div class="bg-white rounded-lg shadow overflow-hidden">
+        <table class="min-w-full divide-y divide-gray-200 text-sm">
+            <thead class="bg-gray-50">
+                <tr>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Name</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Amount</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">DP Base</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Bonus %</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Promo</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Active</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Order</th>
+                    <th class="px-6 py-3 text-right font-medium text-gray-500 uppercase tracking-wider">Actions</th>
+                </tr>
+            </thead>
+            <tbody class="divide-y divide-gray-100">
+                @forelse($plans as $plan)
+                    <tr class="hover:bg-gray-50">
+                        <td class="px-6 py-3 font-medium text-gray-900">{{ $plan->name }}</td>
+                        <td class="px-6 py-3 text-gray-700">{{ $plan->formatted_amount }}</td>
+                        <td class="px-6 py-3 text-gray-700">{{ number_format($plan->dp_base) }} DP</td>
+                        <td class="px-6 py-3 text-gray-500">+{{ $plan->extra_pct }}%</td>
+                        <td class="px-6 py-3">
+                            @if($plan->is_promo)
+                                <span class="inline-flex px-2 py-0.5 rounded text-xs font-medium bg-yellow-100 text-yellow-800">Promo</span>
+                            @else
+                                <span class="text-gray-400 text-xs">—</span>
+                            @endif
+                        </td>
+                        <td class="px-6 py-3">
+                            @if($plan->active)
+                                <span class="inline-flex px-2 py-0.5 rounded text-xs font-medium bg-green-100 text-green-800">Active</span>
+                            @else
+                                <span class="inline-flex px-2 py-0.5 rounded text-xs font-medium bg-gray-100 text-gray-500">Inactive</span>
+                            @endif
+                        </td>
+                        <td class="px-6 py-3 text-gray-500">{{ $plan->sort_order }}</td>
+                        <td class="px-6 py-3 text-right space-x-2">
+                            <a href="{{ route('admin.donate.plans.edit', $plan) }}"
+                               class="text-blue-600 hover:text-blue-800 text-xs font-medium">Edit</a>
+                            <form method="POST" action="{{ route('admin.donate.plans.destroy', $plan) }}" class="inline"
+                                  onsubmit="return confirm('Delete this plan?')">
+                                @csrf @method('DELETE')
+                                <button type="submit" class="text-red-600 hover:text-red-800 text-xs font-medium">Delete</button>
+                            </form>
+                        </td>
+                    </tr>
+                @empty
+                    <tr>
+                        <td colspan="8" class="px-6 py-8 text-center text-gray-400">No donation plans yet.</td>
+                    </tr>
+                @endforelse
+            </tbody>
+        </table>
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Donate/Admin/Views/transactions/index.blade.php b/app/Modules/Donate/Admin/Views/transactions/index.blade.php
new file mode 100644
index 0000000..a5d2378
--- /dev/null
+++ b/app/Modules/Donate/Admin/Views/transactions/index.blade.php
@@ -0,0 +1,62 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Donation Transactions')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <h1 class="text-2xl font-bold text-gray-800">Donation Transactions</h1>
+    <a href="{{ route('admin.donate.plans.index') }}" class="text-sm text-gray-500 hover:text-gray-700">
+        <i class="fas fa-arrow-left mr-1"></i> Plans
+    </a>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <div class="bg-white rounded-lg shadow overflow-hidden">
+        <table class="min-w-full divide-y divide-gray-200 text-sm">
+            <thead class="bg-gray-50">
+                <tr>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">ID</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">User</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Gateway</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Amount</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">DP Awarded</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Status</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Date</th>
+                </tr>
+            </thead>
+            <tbody class="divide-y divide-gray-100">
+                @forelse($transactions as $tx)
+                    <tr class="hover:bg-gray-50">
+                        <td class="px-6 py-3 text-gray-500 font-mono text-xs">{{ $tx->id }}</td>
+                        <td class="px-6 py-3 font-medium text-gray-900">{{ $tx->user?->name ?? '—' }}</td>
+                        <td class="px-6 py-3 text-gray-600 capitalize">{{ $tx->gateway }}</td>
+                        <td class="px-6 py-3 text-gray-700">${{ number_format($tx->amount, 2) }}</td>
+                        <td class="px-6 py-3 text-gray-700">{{ number_format($tx->dp_awarded) }} DP</td>
+                        <td class="px-6 py-3">
+                            @php
+                                $colors = [
+                                    'completed' => 'bg-green-100 text-green-800',
+                                    'pending'   => 'bg-yellow-100 text-yellow-800',
+                                    'failed'    => 'bg-red-100 text-red-800',
+                                ];
+                            @endphp
+                            <span class="inline-flex px-2 py-0.5 rounded text-xs font-medium {{ $colors[$tx->status] ?? 'bg-gray-100 text-gray-600' }}">
+                                {{ ucfirst($tx->status) }}
+                            </span>
+                        </td>
+                        <td class="px-6 py-3 text-gray-500 text-xs">{{ $tx->created_at->format('Y-m-d H:i') }}</td>
+                    </tr>
+                @empty
+                    <tr>
+                        <td colspan="7" class="px-6 py-8 text-center text-gray-400">No transactions yet.</td>
+                    </tr>
+                @endforelse
+            </tbody>
+        </table>
+    </div>
+
+    <div class="mt-4">
+        {{ $transactions->links() }}
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Donate/Admin/routes.php b/app/Modules/Donate/Admin/routes.php
new file mode 100644
index 0000000..df16eb3
--- /dev/null
+++ b/app/Modules/Donate/Admin/routes.php
@@ -0,0 +1,20 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use Modules\Donate\Admin\Controllers\DonateAdminController;
+
+Route::middleware(['auth', 'permission:access.admin.panel'])
+    ->prefix('acp/donate')
+    ->name('admin.donate.')
+    ->group(function () {
+        // Donation Plans
+        Route::get('/plans', [DonateAdminController::class, 'plansIndex'])->name('plans.index');
+        Route::get('/plans/create', [DonateAdminController::class, 'plansCreate'])->name('plans.create');
+        Route::post('/plans', [DonateAdminController::class, 'plansStore'])->name('plans.store');
+        Route::get('/plans/{plan}/edit', [DonateAdminController::class, 'plansEdit'])->name('plans.edit');
+        Route::put('/plans/{plan}', [DonateAdminController::class, 'plansUpdate'])->name('plans.update');
+        Route::delete('/plans/{plan}', [DonateAdminController::class, 'plansDestroy'])->name('plans.destroy');
+
+        // Transactions (read-only)
+        Route::get('/transactions', [DonateAdminController::class, 'transactionsIndex'])->name('transactions.index');
+    });
diff --git a/app/Modules/Donate/Domain/Models/DonationTransaction.php b/app/Modules/Donate/Domain/Models/DonationTransaction.php
index 1d62760..4eac026 100644
--- a/app/Modules/Donate/Domain/Models/DonationTransaction.php
+++ b/app/Modules/Donate/Domain/Models/DonationTransaction.php
@@ -2,7 +2,9 @@
 
 namespace Modules\Donate\Domain\Models;
 
+use App\Models\User;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class DonationTransaction extends Model
 {
@@ -24,5 +26,10 @@ class DonationTransaction extends Model
         'dp_awarded' => 'integer',
         'meta' => 'array',
     ];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
 }
 
diff --git a/app/Modules/Donate/Http/Controllers/DonateController.php b/app/Modules/Donate/Http/Controllers/DonateController.php
index 873551a..88458b2 100644
--- a/app/Modules/Donate/Http/Controllers/DonateController.php
+++ b/app/Modules/Donate/Http/Controllers/DonateController.php
@@ -14,7 +14,11 @@ class DonateController extends Controller
     public function index(GatewayManager $gateways)
     {
         $available = array_map(fn($g) => ['id' => $g->id(), 'name' => $g->displayName()], $gateways->all());
-        $plans = DonationPlan::where('active', true)->orderBy('sort_order')->get();
+        $plans = DonationPlan::query()
+            ->where('active', true)
+            ->select(['id', 'name', 'amount', 'dp_total', 'sort_order'])
+            ->orderBy('sort_order')
+            ->get();
         
         return view('donate::home', ['gateways' => $available, 'plans' => $plans]); 
     }
diff --git a/app/Modules/Donate/module.json b/app/Modules/Donate/module.json
index 484f6f7..b1d0b0e 100644
--- a/app/Modules/Donate/module.json
+++ b/app/Modules/Donate/module.json
@@ -4,5 +4,13 @@
     "routes": true,
     "migrations": true,
     "views": true,
-    "namespace": "Modules\\Donate"
+    "namespace": "Modules\\Donate",
+    "module_type": "core",
+    "admin_crud": "custom",
+    "admin_menu": {
+        "label": "Donations",
+        "icon": "fas fa-donate",
+        "route": "admin.donate.plans.index",
+        "order": 20
+    }
 }
diff --git a/app/Modules/Example/Admin/Controllers/ExampleAdminController.php b/app/Modules/Example/Admin/Controllers/ExampleAdminController.php
new file mode 100644
index 0000000..722e7e1
--- /dev/null
+++ b/app/Modules/Example/Admin/Controllers/ExampleAdminController.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace Modules\Example\Admin\Controllers;
+
+use App\Http\Controllers\Controller;
+
+class ExampleAdminController extends Controller
+{
+    public function index()
+    {
+        return view('example-admin::index');
+    }
+}
diff --git a/app/Modules/Example/Admin/routes.php b/app/Modules/Example/Admin/routes.php
new file mode 100644
index 0000000..8cf9d2b
--- /dev/null
+++ b/app/Modules/Example/Admin/routes.php
@@ -0,0 +1,11 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use Modules\Example\Admin\Controllers\ExampleAdminController;
+
+Route::middleware(['auth', 'permission:access.admin.panel'])
+    ->prefix('acp/example')
+    ->name('admin.example.')
+    ->group(function () {
+        Route::get('/', [ExampleAdminController::class, 'index'])->name('index');
+    });
diff --git a/app/Modules/Example/Admin/views/index.blade.php b/app/Modules/Example/Admin/views/index.blade.php
new file mode 100644
index 0000000..8bb7856
--- /dev/null
+++ b/app/Modules/Example/Admin/views/index.blade.php
@@ -0,0 +1,17 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Example Module')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <h1 class="text-2xl font-bold text-gray-800">Example Module — Admin</h1>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <div class="bg-white rounded-lg shadow p-6">
+        <p class="text-gray-600 text-sm">
+            This is the custom admin view for the <strong>Example</strong> module (Modo B — Custom Views).
+        </p>
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Example/module.json b/app/Modules/Example/module.json
index 560f689..d7ef602 100644
--- a/app/Modules/Example/module.json
+++ b/app/Modules/Example/module.json
@@ -1,12 +1,19 @@
 {
     "name": "Example",
-    "description": "Módulo de ejemplo",
+    "description": "M\u00f3dulo de ejemplo",
     "version": "1.0.0",
     "author": "WoW-CMS",
     "author_url": "https://wow-cms.com",
-    "enabled": true,
+    "enabled": false,
     "routes": true,
     "migrations": false,
     "views": false,
-    "namespace": "Modules\\Example"
+    "namespace": "Modules\\Example",
+    "admin_crud": "custom",
+    "admin_menu": {
+        "label": "Example",
+        "icon": "fas fa-flask",
+        "route": "admin.example.index",
+        "order": 99
+    }
 }
diff --git a/app/Modules/Forum/Admin/Controllers/ForumAdminController.php b/app/Modules/Forum/Admin/Controllers/ForumAdminController.php
new file mode 100644
index 0000000..7c0c84a
--- /dev/null
+++ b/app/Modules/Forum/Admin/Controllers/ForumAdminController.php
@@ -0,0 +1,106 @@
+<?php
+
+namespace Modules\Forum\Admin\Controllers;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+use Modules\Forum\Domain\Models\Forum;
+
+class ForumAdminController extends Controller
+{
+    public function index(): View
+    {
+        $forums = Forum::query()
+            ->with('parent')
+            ->orderBy('order')
+            ->get();
+
+        return view('forum-admin::index', compact('forums'));
+    }
+
+    public function create(): View
+    {
+        $categories = Forum::query()
+            ->whereNull('parent_id')
+            ->orderBy('order')
+            ->get();
+
+        return view('forum-admin::create', compact('categories'));
+    }
+
+    public function store(Request $request): RedirectResponse
+    {
+        $validated = $request->validate([
+            'name'        => ['required', 'string', 'max:255'],
+            'description' => ['nullable', 'string'],
+            'slug'        => ['required', 'string', 'max:255', 'unique:forums,slug'],
+            'parent_id'   => ['nullable', 'integer', 'exists:forums,id'],
+            'order'       => ['nullable', 'integer', 'min:0'],
+            'is_category' => ['boolean'],
+        ]);
+
+        $validated['is_category'] = $request->boolean('is_category');
+        $validated['order'] = (int) ($validated['order'] ?? 0);
+
+        Forum::query()->create($validated);
+
+        return redirect()
+            ->route('admin.forum.index')
+            ->with('success', 'Forum created successfully.');
+    }
+
+    public function edit(Forum $forum): View
+    {
+        $categories = Forum::query()
+            ->whereNull('parent_id')
+            ->where('id', '!=', $forum->id)
+            ->orderBy('order')
+            ->get();
+
+        return view('forum-admin::edit', compact('forum', 'categories'));
+    }
+
+    public function update(Request $request, Forum $forum): RedirectResponse
+    {
+        $validated = $request->validate([
+            'name'        => ['required', 'string', 'max:255'],
+            'description' => ['nullable', 'string'],
+            'slug'        => ['required', 'string', 'max:255', 'unique:forums,slug,' . $forum->id],
+            'parent_id'   => ['nullable', 'integer', 'exists:forums,id'],
+            'order'       => ['nullable', 'integer', 'min:0'],
+            'is_category' => ['boolean'],
+        ]);
+
+        $validated['is_category'] = $request->boolean('is_category');
+        $validated['order'] = (int) ($validated['order'] ?? 0);
+
+        $forum->update($validated);
+
+        return redirect()
+            ->route('admin.forum.index')
+            ->with('success', 'Forum updated successfully.');
+    }
+
+    public function destroy(Forum $forum): RedirectResponse
+    {
+        if ($forum->threads()->exists()) {
+            return redirect()
+                ->route('admin.forum.index')
+                ->with('error', 'Cannot delete a forum that has threads.');
+        }
+
+        if ($forum->subforums()->exists()) {
+            return redirect()
+                ->route('admin.forum.index')
+                ->with('error', 'Cannot delete a forum that has sub-forums.');
+        }
+
+        $forum->delete();
+
+        return redirect()
+            ->route('admin.forum.index')
+            ->with('success', 'Forum deleted.');
+    }
+}
diff --git a/app/Modules/Forum/Admin/Views/_form.blade.php b/app/Modules/Forum/Admin/Views/_form.blade.php
new file mode 100644
index 0000000..97f4749
--- /dev/null
+++ b/app/Modules/Forum/Admin/Views/_form.blade.php
@@ -0,0 +1,57 @@
+@php $isEdit = isset($forum) && $forum !== null; @endphp
+
+@if($errors->any())
+    <div class="mb-4 bg-red-50 border border-red-200 text-red-800 rounded-lg px-4 py-3 text-sm">
+        <ul class="list-disc list-inside space-y-1">
+            @foreach($errors->all() as $error)
+                <li>{{ $error }}</li>
+            @endforeach
+        </ul>
+    </div>
+@endif
+
+<div class="space-y-4">
+    <div>
+        <label class="block text-sm font-medium text-gray-700 mb-1">Name <span class="text-red-500">*</span></label>
+        <input type="text" name="name" value="{{ old('name', $forum?->name) }}"
+               class="w-full border border-gray-300 rounded-lg px-3 py-2 text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent" required>
+    </div>
+
+    <div>
+        <label class="block text-sm font-medium text-gray-700 mb-1">Slug <span class="text-red-500">*</span></label>
+        <input type="text" name="slug" value="{{ old('slug', $forum?->slug) }}"
+               class="w-full border border-gray-300 rounded-lg px-3 py-2 text-sm font-mono focus:ring-2 focus:ring-blue-500 focus:border-transparent" required>
+    </div>
+
+    <div>
+        <label class="block text-sm font-medium text-gray-700 mb-1">Description</label>
+        <textarea name="description" rows="3"
+                  class="w-full border border-gray-300 rounded-lg px-3 py-2 text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">{{ old('description', $forum?->description) }}</textarea>
+    </div>
+
+    <div>
+        <label class="block text-sm font-medium text-gray-700 mb-1">Parent Category</label>
+        <select name="parent_id" class="w-full border border-gray-300 rounded-lg px-3 py-2 text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+            <option value="">— None (top level) —</option>
+            @foreach($categories as $cat)
+                <option value="{{ $cat->id }}" @selected(old('parent_id', $forum?->parent_id) == $cat->id)>
+                    {{ $cat->name }}
+                </option>
+            @endforeach
+        </select>
+    </div>
+
+    <div>
+        <label class="block text-sm font-medium text-gray-700 mb-1">Display Order</label>
+        <input type="number" name="order" value="{{ old('order', $forum?->order ?? 0) }}" min="0"
+               class="w-32 border border-gray-300 rounded-lg px-3 py-2 text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+    </div>
+
+    <div class="flex items-center gap-2">
+        <input type="hidden" name="is_category" value="0">
+        <input type="checkbox" name="is_category" id="is_category" value="1"
+               @checked(old('is_category', $forum?->is_category))
+               class="h-4 w-4 text-blue-600 border-gray-300 rounded">
+        <label for="is_category" class="text-sm font-medium text-gray-700">This is a category (container, no threads)</label>
+    </div>
+</div>
diff --git a/app/Modules/Forum/Admin/Views/create.blade.php b/app/Modules/Forum/Admin/Views/create.blade.php
new file mode 100644
index 0000000..65dc482
--- /dev/null
+++ b/app/Modules/Forum/Admin/Views/create.blade.php
@@ -0,0 +1,27 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Create Forum')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <h1 class="text-2xl font-bold text-gray-800">Create Forum</h1>
+    <a href="{{ route('admin.forum.index') }}" class="text-sm text-gray-500 hover:text-gray-700">
+        <i class="fas fa-arrow-left mr-1"></i> Back
+    </a>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <div class="max-w-2xl mx-auto bg-white rounded-lg shadow p-6">
+        <form method="POST" action="{{ route('admin.forum.store') }}">
+            @csrf
+            @include('forum-admin::_form', ['forum' => null, 'categories' => $categories])
+            <div class="mt-6 flex justify-end">
+                <button type="submit"
+                        class="bg-blue-600 hover:bg-blue-700 text-white text-sm font-medium px-5 py-2 rounded-lg transition">
+                    Create Forum
+                </button>
+            </div>
+        </form>
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Forum/Admin/Views/edit.blade.php b/app/Modules/Forum/Admin/Views/edit.blade.php
new file mode 100644
index 0000000..34e7746
--- /dev/null
+++ b/app/Modules/Forum/Admin/Views/edit.blade.php
@@ -0,0 +1,27 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Edit Forum')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <h1 class="text-2xl font-bold text-gray-800">Edit Forum — {{ $forum->name }}</h1>
+    <a href="{{ route('admin.forum.index') }}" class="text-sm text-gray-500 hover:text-gray-700">
+        <i class="fas fa-arrow-left mr-1"></i> Back
+    </a>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <div class="max-w-2xl mx-auto bg-white rounded-lg shadow p-6">
+        <form method="POST" action="{{ route('admin.forum.update', $forum) }}">
+            @csrf @method('PUT')
+            @include('forum-admin::_form', ['forum' => $forum, 'categories' => $categories])
+            <div class="mt-6 flex justify-end">
+                <button type="submit"
+                        class="bg-blue-600 hover:bg-blue-700 text-white text-sm font-medium px-5 py-2 rounded-lg transition">
+                    Save Changes
+                </button>
+            </div>
+        </form>
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Forum/Admin/Views/index.blade.php b/app/Modules/Forum/Admin/Views/index.blade.php
new file mode 100644
index 0000000..17aaa7c
--- /dev/null
+++ b/app/Modules/Forum/Admin/Views/index.blade.php
@@ -0,0 +1,71 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Forum Management')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <h1 class="text-2xl font-bold text-gray-800">Forum Management</h1>
+    <a href="{{ route('admin.forum.create') }}"
+       class="inline-flex items-center gap-2 bg-blue-600 hover:bg-blue-700 text-white text-sm font-medium px-4 py-2 rounded-lg transition">
+        <i class="fas fa-plus"></i> New Forum
+    </a>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    @if(session('success'))
+        <div class="mb-4 bg-green-50 border border-green-200 text-green-800 rounded-lg px-4 py-3 text-sm">
+            {{ session('success') }}
+        </div>
+    @endif
+    @if(session('error'))
+        <div class="mb-4 bg-red-50 border border-red-200 text-red-800 rounded-lg px-4 py-3 text-sm">
+            {{ session('error') }}
+        </div>
+    @endif
+
+    <div class="bg-white rounded-lg shadow overflow-hidden">
+        <table class="min-w-full divide-y divide-gray-200 text-sm">
+            <thead class="bg-gray-50">
+                <tr>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Name</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Slug</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Parent</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Type</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Order</th>
+                    <th class="px-6 py-3 text-right font-medium text-gray-500 uppercase tracking-wider">Actions</th>
+                </tr>
+            </thead>
+            <tbody class="divide-y divide-gray-100">
+                @forelse($forums as $forum)
+                    <tr class="hover:bg-gray-50">
+                        <td class="px-6 py-3 font-medium text-gray-900">{{ $forum->name }}</td>
+                        <td class="px-6 py-3 text-gray-500 font-mono text-xs">{{ $forum->slug }}</td>
+                        <td class="px-6 py-3 text-gray-500">{{ $forum->parent?->name ?? '—' }}</td>
+                        <td class="px-6 py-3">
+                            @if($forum->is_category)
+                                <span class="inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-purple-100 text-purple-800">Category</span>
+                            @else
+                                <span class="inline-flex items-center px-2 py-0.5 rounded text-xs font-medium bg-blue-100 text-blue-800">Forum</span>
+                            @endif
+                        </td>
+                        <td class="px-6 py-3 text-gray-500">{{ $forum->order }}</td>
+                        <td class="px-6 py-3 text-right space-x-2">
+                            <a href="{{ route('admin.forum.edit', $forum) }}"
+                               class="text-blue-600 hover:text-blue-800 text-xs font-medium">Edit</a>
+                            <form method="POST" action="{{ route('admin.forum.destroy', $forum) }}" class="inline"
+                                  onsubmit="return confirm('Delete this forum?')">
+                                @csrf @method('DELETE')
+                                <button type="submit" class="text-red-600 hover:text-red-800 text-xs font-medium">Delete</button>
+                            </form>
+                        </td>
+                    </tr>
+                @empty
+                    <tr>
+                        <td colspan="6" class="px-6 py-8 text-center text-gray-400">No forums yet.</td>
+                    </tr>
+                @endforelse
+            </tbody>
+        </table>
+    </div>
+</main>
+@endsection
diff --git a/app/Modules/Forum/Admin/routes.php b/app/Modules/Forum/Admin/routes.php
new file mode 100644
index 0000000..3379cd4
--- /dev/null
+++ b/app/Modules/Forum/Admin/routes.php
@@ -0,0 +1,16 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use Modules\Forum\Admin\Controllers\ForumAdminController;
+
+Route::middleware(['auth', 'permission:access.admin.panel'])
+    ->prefix('acp/forum')
+    ->name('admin.forum.')
+    ->group(function () {
+        Route::get('/', [ForumAdminController::class, 'index'])->name('index');
+        Route::get('/create', [ForumAdminController::class, 'create'])->name('create');
+        Route::post('/', [ForumAdminController::class, 'store'])->name('store');
+        Route::get('/{forum}/edit', [ForumAdminController::class, 'edit'])->name('edit');
+        Route::put('/{forum}', [ForumAdminController::class, 'update'])->name('update');
+        Route::delete('/{forum}', [ForumAdminController::class, 'destroy'])->name('destroy');
+    });
diff --git a/app/Modules/Forum/module.json b/app/Modules/Forum/module.json
index fb312ad..e43abf7 100644
--- a/app/Modules/Forum/module.json
+++ b/app/Modules/Forum/module.json
@@ -4,5 +4,12 @@
     "routes": true,
     "migrations": true,
     "views": true,
-    "namespace": "Modules\\Forum"
+    "namespace": "Modules\\Forum",
+    "admin_crud": "custom",
+    "admin_menu": {
+        "label": "Forum",
+        "icon": "fas fa-comments",
+        "route": "admin.forum.index",
+        "order": 30
+    }
 }
diff --git a/app/Modules/Store/Admin/Controllers/StoreAdminController.php b/app/Modules/Store/Admin/Controllers/StoreAdminController.php
new file mode 100644
index 0000000..bba86d3
--- /dev/null
+++ b/app/Modules/Store/Admin/Controllers/StoreAdminController.php
@@ -0,0 +1,53 @@
+<?php
+
+namespace Modules\Store\Admin\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Models\Realm;
+use Illuminate\View\View;
+
+class StoreAdminController extends Controller
+{
+    private array $products = [
+        'rename' => [
+            'name'               => 'Character Rename',
+            'description'        => 'Forces a character rename on next login.',
+            'cost'               => 600,
+            'requires_character' => true,
+        ],
+        'customize' => [
+            'name'               => 'Character Customize',
+            'description'        => 'Unlocks appearance customization on next login.',
+            'cost'               => 800,
+            'requires_character' => true,
+        ],
+        'race_change' => [
+            'name'               => 'Race Change',
+            'description'        => 'Unlocks race change on next login.',
+            'cost'               => 1200,
+            'requires_character' => true,
+        ],
+        'faction_change' => [
+            'name'               => 'Faction Change',
+            'description'        => 'Unlocks faction change on next login.',
+            'cost'               => 1500,
+            'requires_character' => true,
+        ],
+        'starter_mail' => [
+            'name'               => 'Starter Mail Pack',
+            'description'        => 'Sends a starter pack by in-game mail.',
+            'cost'               => 500,
+            'requires_character' => true,
+        ],
+    ];
+
+    public function index(): View
+    {
+        $realms = Realm::query()->orderBy('name')->get();
+
+        return view('store-admin::index', [
+            'products' => $this->products,
+            'realms'   => $realms,
+        ]);
+    }
+}
diff --git a/app/Modules/Store/Admin/Views/index.blade.php b/app/Modules/Store/Admin/Views/index.blade.php
new file mode 100644
index 0000000..154a88c
--- /dev/null
+++ b/app/Modules/Store/Admin/Views/index.blade.php
@@ -0,0 +1,72 @@
+@extends('admin::layouts.app')
+
+@section('title', 'Store Overview')
+
+@section('content')
+<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
+    <h1 class="text-2xl font-bold text-gray-800">Store — Products</h1>
+</header>
+
+<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    <div class="mb-4 bg-blue-50 border border-blue-200 text-blue-800 rounded-lg px-4 py-3 text-sm">
+        <i class="fas fa-info-circle mr-1"></i>
+        Products are currently defined in code (<code>StoreController::getProducts()</code>).
+        Edit the source file to add, remove or change costs.
+    </div>
+
+    <div class="bg-white rounded-lg shadow overflow-hidden">
+        <table class="min-w-full divide-y divide-gray-200 text-sm">
+            <thead class="bg-gray-50">
+                <tr>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Key</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Name</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Description</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Cost (DP)</th>
+                    <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Needs Character</th>
+                </tr>
+            </thead>
+            <tbody class="divide-y divide-gray-100">
+                @foreach($products as $key => $product)
+                    <tr class="hover:bg-gray-50">
+                        <td class="px-6 py-3 font-mono text-xs text-gray-500">{{ $key }}</td>
+                        <td class="px-6 py-3 font-medium text-gray-900">{{ $product['name'] }}</td>
+                        <td class="px-6 py-3 text-gray-500">{{ $product['description'] }}</td>
+                        <td class="px-6 py-3 text-gray-700 font-semibold">{{ number_format($product['cost']) }}</td>
+                        <td class="px-6 py-3">
+                            @if($product['requires_character'] ?? false)
+                                <span class="inline-flex px-2 py-0.5 rounded text-xs font-medium bg-blue-100 text-blue-800">Yes</span>
+                            @else
+                                <span class="text-gray-400 text-xs">—</span>
+                            @endif
+                        </td>
+                    </tr>
+                @endforeach
+            </tbody>
+        </table>
+    </div>
+
+    @if($realms->isNotEmpty())
+        <h2 class="mt-8 text-lg font-semibold text-gray-800 mb-3">Configured Realms</h2>
+        <div class="bg-white rounded-lg shadow overflow-hidden">
+            <table class="min-w-full divide-y divide-gray-200 text-sm">
+                <thead class="bg-gray-50">
+                    <tr>
+                        <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Realm</th>
+                        <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Host</th>
+                        <th class="px-6 py-3 text-left font-medium text-gray-500 uppercase tracking-wider">Console Port</th>
+                    </tr>
+                </thead>
+                <tbody class="divide-y divide-gray-100">
+                    @foreach($realms as $realm)
+                        <tr>
+                            <td class="px-6 py-3 font-medium text-gray-900">{{ $realm->name }}</td>
+                            <td class="px-6 py-3 font-mono text-xs text-gray-500">{{ $realm->console_hostname }}</td>
+                            <td class="px-6 py-3 text-gray-500">{{ $realm->console_port }}</td>
+                        </tr>
+                    @endforeach
+                </tbody>
+            </table>
+        </div>
+    @endif
+</main>
+@endsection
diff --git a/app/Modules/Store/Admin/routes.php b/app/Modules/Store/Admin/routes.php
new file mode 100644
index 0000000..6e17a4a
--- /dev/null
+++ b/app/Modules/Store/Admin/routes.php
@@ -0,0 +1,11 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+use Modules\Store\Admin\Controllers\StoreAdminController;
+
+Route::middleware(['auth', 'permission:access.admin.panel'])
+    ->prefix('acp/store')
+    ->name('admin.store.')
+    ->group(function () {
+        Route::get('/', [StoreAdminController::class, 'index'])->name('index');
+    });
diff --git a/app/Modules/Store/Domain/Models/StoreProduct.php b/app/Modules/Store/Domain/Models/StoreProduct.php
new file mode 100644
index 0000000..dcf9474
--- /dev/null
+++ b/app/Modules/Store/Domain/Models/StoreProduct.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace Modules\Store\Domain\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class StoreProduct extends Model
+{
+    protected $table = 'store_products';
+
+    protected $fillable = [
+        'key',
+        'name',
+        'description',
+        'cost',
+        'type',
+        'requires_character',
+        'active',
+        'sort_order',
+    ];
+
+    protected $casts = [
+        'requires_character' => 'boolean',
+        'active'             => 'boolean',
+        'cost'               => 'integer',
+        'sort_order'         => 'integer',
+    ];
+}
diff --git a/app/Modules/Store/Infrastructure/Database/migrations/2024_01_01_000001_create_store_products_table.php b/app/Modules/Store/Infrastructure/Database/migrations/2024_01_01_000001_create_store_products_table.php
new file mode 100644
index 0000000..f4011d5
--- /dev/null
+++ b/app/Modules/Store/Infrastructure/Database/migrations/2024_01_01_000001_create_store_products_table.php
@@ -0,0 +1,39 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('store_products', function (Blueprint $table) {
+            $table->id();
+            $table->string('key')->unique();
+            $table->string('name');
+            $table->text('description')->nullable();
+            $table->unsignedInteger('cost')->default(0);
+            $table->string('type')->nullable();
+            $table->boolean('requires_character')->default(false);
+            $table->boolean('active')->default(true);
+            $table->unsignedSmallInteger('sort_order')->default(0);
+            $table->timestamps();
+        });
+
+        // Seed with existing hardcoded products
+        DB::table('store_products')->insert([
+            ['key' => 'rename',           'name' => 'Character Rename',    'description' => 'Change your character name.',                   'cost' => 600,  'type' => 'character_rename',    'requires_character' => true,  'active' => true, 'sort_order' => 1,  'created_at' => now(), 'updated_at' => now()],
+            ['key' => 'customize',        'name' => 'Character Customize', 'description' => 'Customize your character appearance.',           'cost' => 800,  'type' => 'character_customize', 'requires_character' => true,  'active' => true, 'sort_order' => 2,  'created_at' => now(), 'updated_at' => now()],
+            ['key' => 'race_change',      'name' => 'Race Change',         'description' => 'Change your character race.',                    'cost' => 1200, 'type' => 'change_race',         'requires_character' => true,  'active' => true, 'sort_order' => 3,  'created_at' => now(), 'updated_at' => now()],
+            ['key' => 'faction_change',   'name' => 'Faction Change',      'description' => 'Switch your character to the opposite faction.', 'cost' => 1500, 'type' => 'change_faction',      'requires_character' => true,  'active' => true, 'sort_order' => 4,  'created_at' => now(), 'updated_at' => now()],
+            ['key' => 'starter_mail',     'name' => 'Starter Pack',        'description' => 'Receive a starter mail with useful items.',      'cost' => 500,  'type' => 'send_starter_mail',   'requires_character' => false, 'active' => true, 'sort_order' => 5,  'created_at' => now(), 'updated_at' => now()],
+        ]);
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('store_products');
+    }
+};
diff --git a/app/Modules/Store/admin-crud.json b/app/Modules/Store/admin-crud.json
new file mode 100644
index 0000000..820d063
--- /dev/null
+++ b/app/Modules/Store/admin-crud.json
@@ -0,0 +1,86 @@
+{
+    "title": "Store Products",
+    "model": "Modules\\Store\\Domain\\Models\\StoreProduct",
+    "list": {
+        "searchable": true,
+        "search_columns": ["name", "key", "type"],
+        "order_by": "sort_order",
+        "order_dir": "asc",
+        "columns": [
+            { "field": "sort_order", "label": "#" },
+            { "field": "name",       "label": "Product" },
+            { "field": "key",        "label": "Key" },
+            { "field": "cost",       "label": "Cost (DP)" },
+            { "field": "active",     "label": "Active", "format": "boolean" }
+        ]
+    },
+    "form": {
+        "sections": [
+            {
+                "title": "Product Info",
+                "fields": [
+                    {
+                        "name": "name",
+                        "label": "Name",
+                        "type": "text",
+                        "required": true,
+                        "placeholder": "e.g. Character Rename"
+                    },
+                    {
+                        "name": "key",
+                        "label": "Key",
+                        "type": "text",
+                        "required": true,
+                        "placeholder": "e.g. rename",
+                        "help": "Unique slug used for SOAP commands."
+                    },
+                    {
+                        "name": "description",
+                        "label": "Description",
+                        "type": "textarea",
+                        "required": false
+                    }
+                ]
+            },
+            {
+                "title": "Pricing & Settings",
+                "fields": [
+                    {
+                        "name": "cost",
+                        "label": "Cost (DP)",
+                        "type": "number",
+                        "required": true,
+                        "min": 0
+                    },
+                    {
+                        "name": "type",
+                        "label": "SOAP Type",
+                        "type": "text",
+                        "required": false,
+                        "placeholder": "e.g. character_rename",
+                        "help": "SOAP command type to execute on purchase."
+                    },
+                    {
+                        "name": "sort_order",
+                        "label": "Sort Order",
+                        "type": "number",
+                        "required": false,
+                        "min": 0
+                    },
+                    {
+                        "name": "requires_character",
+                        "label": "Requires Character",
+                        "type": "checkbox",
+                        "help": "If checked, the player must select a character during purchase."
+                    },
+                    {
+                        "name": "active",
+                        "label": "Active",
+                        "type": "checkbox",
+                        "help": "Inactive products are hidden in the store."
+                    }
+                ]
+            }
+        ]
+    }
+}
diff --git a/app/Modules/Store/module.json b/app/Modules/Store/module.json
index 3fbca6a..b409002 100644
--- a/app/Modules/Store/module.json
+++ b/app/Modules/Store/module.json
@@ -4,5 +4,13 @@
     "routes": true,
     "migrations": true,
     "views": true,
-    "namespace": "Modules\\Store"
+    "translations": false,
+    "namespace": "Modules\\Store",
+    "admin_crud": "json",
+    "admin_menu": {
+        "label": "Store",
+        "icon": "fas fa-shopping-cart",
+        "route": "admin.store.crud.index",
+        "order": 25
+    }
 }
diff --git a/app/Providers/BaseModuleServiceProvider.php b/app/Providers/BaseModuleServiceProvider.php
index a04c50c..45807d0 100644
--- a/app/Providers/BaseModuleServiceProvider.php
+++ b/app/Providers/BaseModuleServiceProvider.php
@@ -28,6 +28,7 @@ public function boot(): void
             $this->config['migrations'] = (bool) ($manifest['migrations'] ?? ($this->config['migrations'] ?? false));
             $this->config['views'] = (bool) ($manifest['views'] ?? ($this->config['views'] ?? false));
             $this->config['translations'] = (bool) ($manifest['translations'] ?? ($this->config['translations'] ?? false));
+            $this->config['admin_crud'] = (string) ($manifest['admin_crud'] ?? ($this->config['admin_crud'] ?? ''));
         } else {
             $this->modulePath = base_path("app/Modules/{$this->moduleName}");
         }
@@ -47,6 +48,13 @@ public function boot(): void
         if ($this->config['translations'] ?? false) {
             $this->loadTranslations();
         }
+
+        $adminCrud = (string) ($this->config['admin_crud'] ?? '');
+
+        if ($adminCrud === 'custom') {
+            $this->loadAdminRoutes();
+            $this->loadAdminViews();
+        }
     }
 
     /**
@@ -106,4 +114,31 @@ private function loadTranslations(): void
             );
         }
     }
+
+    /**
+     * Load admin routes from the module's Admin/routes.php file (Modo B).
+     * 
+     * @return void
+     */
+    private function loadAdminRoutes(): void
+    {
+        $path = $this->modulePath . '/Admin/routes.php';
+        if (is_file($path)) {
+            Route::middleware(['web', 'auth'])
+                ->group($path);
+        }
+    }
+
+    /**
+     * Register admin views namespace from the module's Admin/views directory (Modo B).
+     * 
+     * @return void
+     */
+    private function loadAdminViews(): void
+    {
+        $path = $this->modulePath . '/Admin/views';
+        if (is_dir($path)) {
+            $this->loadViewsFrom($path, strtolower($this->moduleName) . '-admin');
+        }
+    }
 }
diff --git a/app/Providers/ModuleServiceProvider.php b/app/Providers/ModuleServiceProvider.php
index 65b91d5..355460a 100644
--- a/app/Providers/ModuleServiceProvider.php
+++ b/app/Providers/ModuleServiceProvider.php
@@ -3,6 +3,7 @@
 namespace App\Providers;
 
 use Illuminate\Support\ServiceProvider;
+use Illuminate\Support\Facades\Route;
 use App\Services\ModuleRegistryService;
 
 class ModuleServiceProvider extends ServiceProvider
@@ -16,6 +17,8 @@ public function register(): void
 
     public function boot(): void
     {
+        $this->registerJsonCrudRoutes();
+
         $isInstalled = file_exists(storage_path('installer.lock')) || file_exists(storage_path('installed.lock'));
 
         if (!$isInstalled) {
@@ -27,4 +30,46 @@ public function boot(): void
         $locale = settings('default_locale') ?? 'es';
         $this->app->setLocale($locale);
     }
+
+    private function registerJsonCrudRoutes(): void
+    {
+        foreach (ModuleRegistryService::getEnabledModules() as $module) {
+            if (($module['admin_crud'] ?? '') !== 'json') {
+                continue;
+            }
+
+            $folder = (string) ($module['folder'] ?? '');
+            if ($folder === '') {
+                continue;
+            }
+
+            $slug      = strtolower($folder);
+            $routeBase = 'admin.' . $slug . '.crud.';
+
+            Route::middleware(['web', 'auth', 'permission:access.admin.panel'])
+                ->prefix('acp/' . $slug . '/manage')
+                ->name($routeBase)
+                ->group(function () use ($folder) {
+                    Route::get('/', [\Modules\Admin\Http\Controllers\GenericCrudController::class, 'index'])
+                        ->name('index')
+                        ->defaults('module', $folder);
+                    Route::get('/create', [\Modules\Admin\Http\Controllers\GenericCrudController::class, 'create'])
+                        ->name('create')
+                        ->defaults('module', $folder);
+                    Route::post('/', [\Modules\Admin\Http\Controllers\GenericCrudController::class, 'store'])
+                        ->name('store')
+                        ->defaults('module', $folder);
+                    Route::get('/{id}/edit', [\Modules\Admin\Http\Controllers\GenericCrudController::class, 'edit'])
+                        ->name('edit')
+                        ->defaults('module', $folder);
+                    Route::put('/{id}', [\Modules\Admin\Http\Controllers\GenericCrudController::class, 'update'])
+                        ->name('update')
+                        ->defaults('module', $folder);
+                    Route::delete('/{id}', [\Modules\Admin\Http\Controllers\GenericCrudController::class, 'destroy'])
+                        ->name('destroy')
+                        ->defaults('module', $folder);
+                });
+        }
+    }
 }
+
diff --git a/app/Services/AnalyticsService.php b/app/Services/AnalyticsService.php
index e8ed2d9..d91f577 100644
--- a/app/Services/AnalyticsService.php
+++ b/app/Services/AnalyticsService.php
@@ -174,18 +174,20 @@ public function getTrafficByDevice(Carbon $startDate): array
             return [];
         }
 
-        // Parse device types from user agent
+        // Parse device types from user agent without loading all sessions in memory.
         $devices = [];
 
-        // This is simplified - for production use a proper device detection library
-        $sessions = AnalyticsSession::where('created_at', '>=', $startDate)
+        AnalyticsSession::query()
+            ->where('created_at', '>=', $startDate)
             ->where('is_bot', false)
-            ->get();
-
-        foreach ($sessions as $session) {
-            $device = $this->detectDevice($session->user_agent);
-            $devices[$device] = ($devices[$device] ?? 0) + 1;
-        }
+            ->select(['id', 'user_agent'])
+            ->orderBy('id')
+            ->chunkById(1000, function ($sessions) use (&$devices): void {
+                foreach ($sessions as $session) {
+                    $device = $this->detectDevice((string) $session->user_agent);
+                    $devices[$device] = ($devices[$device] ?? 0) + 1;
+                }
+            });
 
         return collect($devices)
             ->map(function ($count, $device) use ($total) {
@@ -195,6 +197,7 @@ public function getTrafficByDevice(Carbon $startDate): array
                     'percentage' => round(($count / $total) * 100, 2),
                 ];
             })
+                ->filter(fn ($row) => $row['count'] > 0)
             ->toArray();
     }
 
diff --git a/app/Services/ModuleCrudService.php b/app/Services/ModuleCrudService.php
new file mode 100644
index 0000000..33e0cfe
--- /dev/null
+++ b/app/Services/ModuleCrudService.php
@@ -0,0 +1,188 @@
+<?php
+
+namespace App\Services;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Facades\File;
+use Illuminate\Validation\ValidationException;
+
+class ModuleCrudService
+{
+    private static array $cache = [];
+
+    /**
+     * Read and return the parsed admin-crud.json for a module.
+     */
+    public static function getConfig(string $moduleName): ?array
+    {
+        if (isset(self::$cache[$moduleName])) {
+            return self::$cache[$moduleName];
+        }
+
+        $path = base_path("app/Modules/{$moduleName}/admin-crud.json");
+
+        if (!File::exists($path)) {
+            return null;
+        }
+
+        $decoded = json_decode(File::get($path), true);
+
+        if (!is_array($decoded)) {
+            return null;
+        }
+
+        self::$cache[$moduleName] = $decoded;
+
+        return $decoded;
+    }
+
+    /**
+     * Resolve the Eloquent model class defined in the CRUD config.
+     */
+    public static function resolveModel(array $config): Model
+    {
+        $modelClass = trim((string) ($config['model'] ?? ''));
+
+        if ($modelClass === '' || !class_exists($modelClass)) {
+            abort(500, "Model class '{$modelClass}' not found.");
+        }
+
+        return new $modelClass();
+    }
+
+    /**
+     * Build Laravel validation rules from the form fields definition.
+     */
+    public static function buildValidationRules(array $config, bool $isUpdate = false): array
+    {
+        $rules = [];
+
+        foreach ($config['form']['sections'] ?? [] as $section) {
+            foreach ($section['fields'] ?? [] as $field) {
+                $name = (string) ($field['name'] ?? '');
+                if ($name === '' || ($field['type'] ?? '') === 'hidden') {
+                    continue;
+                }
+
+                $fieldRules = [];
+
+                $required = (bool) ($field['required'] ?? false);
+                $fieldRules[] = $required ? 'required' : 'nullable';
+
+                $fieldRules = array_merge($fieldRules, self::typeRules($field, $isUpdate));
+
+                $rules[$name] = $fieldRules;
+            }
+        }
+
+        return $rules;
+    }
+
+    /**
+     * Paginated list of records for the module model.
+     */
+    public static function paginate(array $config, ?string $search = null): \Illuminate\Contracts\Pagination\LengthAwarePaginator
+    {
+        $model = self::resolveModel($config);
+        $query = $model->newQuery();
+
+        $searchable = $config['list']['searchable'] ?? [];
+        if ($search !== null && $search !== '' && count($searchable) > 0) {
+            $query->where(function ($q) use ($search, $searchable) {
+                foreach ($searchable as $column) {
+                    $q->orWhere($column, 'like', '%' . $search . '%');
+                }
+            });
+        }
+
+        $perPage = (int) ($config['list']['per_page'] ?? 15);
+
+        return $query->paginate($perPage);
+    }
+
+    /**
+     * Find a single record by ID.
+     */
+    public static function find(array $config, int|string $id): Model
+    {
+        $model = self::resolveModel($config);
+        $record = $model->newQuery()->findOrFail($id);
+
+        return $record;
+    }
+
+    /**
+     * Store a new record.
+     */
+    public static function store(array $config, array $data): Model
+    {
+        $model = self::resolveModel($config);
+        $record = $model->newInstance($data);
+        $record->save();
+
+        return $record;
+    }
+
+    /**
+     * Update an existing record.
+     */
+    public static function update(array $config, int|string $id, array $data): Model
+    {
+        $record = self::find($config, $id);
+        $record->fill($data);
+        $record->save();
+
+        return $record;
+    }
+
+    /**
+     * Delete a record by ID.
+     */
+    public static function destroy(array $config, int|string $id): void
+    {
+        $record = self::find($config, $id);
+        $record->delete();
+    }
+
+    /**
+     * Resolve options for a relation field.
+     */
+    public static function resolveRelationOptions(array $field): array
+    {
+        $modelClass = trim((string) ($field['model'] ?? ''));
+        $valueField = (string) ($field['value_field'] ?? 'id');
+        $labelField = (string) ($field['label_field'] ?? 'name');
+
+        if ($modelClass === '' || !class_exists($modelClass)) {
+            return [];
+        }
+
+        return $modelClass::query()
+            ->get([$valueField, $labelField])
+            ->map(fn ($item) => ['value' => $item->{$valueField}, 'label' => $item->{$labelField}])
+            ->all();
+    }
+
+    public static function flushCache(): void
+    {
+        self::$cache = [];
+    }
+
+    private static function typeRules(array $field, bool $isUpdate): array
+    {
+        return match ($field['type'] ?? 'text') {
+            'text', 'slug'        => ['string', 'max:255'],
+            'textarea', 'richtext'=> ['string'],
+            'number'              => ['numeric'],
+            'toggle'              => ['boolean'],
+            'date'                => ['date'],
+            'datetime'            => ['date'],
+            'email'               => ['email', 'max:255'],
+            'image'               => $isUpdate ? ['nullable', 'image', 'max:2048'] : ['image', 'max:2048'],
+            'file'                => $isUpdate ? ['nullable', 'file', 'max:10240'] : ['file', 'max:10240'],
+            'select'              => [],
+            'relation'            => ['integer'],
+            default               => [],
+        };
+    }
+}
diff --git a/app/Services/ModuleRegistryService.php b/app/Services/ModuleRegistryService.php
index 804ad87..69c8649 100644
--- a/app/Services/ModuleRegistryService.php
+++ b/app/Services/ModuleRegistryService.php
@@ -3,14 +3,38 @@
 namespace App\Services;
 
 use App\Models\ManagedModule;
+use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\Facades\Schema;
 
 class ModuleRegistryService
 {
+    private const ADMIN_MENU_CACHE_KEY = 'module_registry.admin_menu_items';
+    private const ADMIN_MENU_CACHE_TTL = 300;
+
     private static ?array $stateCache = null;
     private static ?array $manifestCache = null;
 
+    public static function getAdminMenuItems(): array
+    {
+        return Cache::remember(self::ADMIN_MENU_CACHE_KEY, self::ADMIN_MENU_CACHE_TTL, static function (): array {
+            $items = [];
+
+            foreach (self::getEnabledModules() as $module) {
+                $menu = $module['admin_menu'] ?? null;
+                if (!is_array($menu) || empty($menu)) {
+                    continue;
+                }
+
+                $items[] = array_merge($menu, ['module' => $module['folder']]);
+            }
+
+            usort($items, static fn (array $a, array $b): int => ($a['order'] ?? 0) <=> ($b['order'] ?? 0));
+
+            return $items;
+        });
+    }
+
     public static function getEnabledProviders(): array
     {
         $providers = [];
@@ -165,6 +189,7 @@ public static function flushCache(): void
     {
         self::$stateCache = null;
         self::$manifestCache = null;
+        Cache::forget(self::ADMIN_MENU_CACHE_KEY);
     }
 
     private static function loadManifest(): array
@@ -207,6 +232,8 @@ private static function loadManifest(): array
                 'migrations' => (bool) ($config['migrations'] ?? false),
                 'views' => (bool) ($config['views'] ?? false),
                 'translations' => (bool) ($config['translations'] ?? false),
+                'admin_crud' => (string) ($config['admin_crud'] ?? ''),
+                'admin_menu' => is_array($config['admin_menu'] ?? null) ? $config['admin_menu'] : null,
                 'config' => $config,
             ];
         }
diff --git a/app/Traits/Cacheable.php b/app/Traits/Cacheable.php
index dca2717..bf77776 100755
--- a/app/Traits/Cacheable.php
+++ b/app/Traits/Cacheable.php
@@ -19,7 +19,9 @@ trait Cacheable
     protected function logDriver()
     {
         $driver = config('cache.default');
-        Log::debug("[Cacheable] Using cache driver: {$driver}");
+        if (app()->environment('local')) {
+            Log::debug("[Cacheable] Using cache driver: {$driver}");
+        }
         return $driver;
     }
 
@@ -32,11 +34,15 @@ public function getCached($id)
         $driver = $this->logDriver();
 
         if (Cache::has($cacheKey)) {
-            Log::debug("[Cacheable] HIT ({$driver}) key={$cacheKey}");
+            if (app()->environment('local')) {
+                Log::debug("[Cacheable] HIT ({$driver}) key={$cacheKey}");
+            }
             return Cache::get($cacheKey);
         }
 
-        Log::debug("[Cacheable] MISS ({$driver}) key={$cacheKey} → fetching from DB");
+        if (app()->environment('local')) {
+            Log::debug("[Cacheable] MISS ({$driver}) key={$cacheKey} → fetching from DB");
+        }
         $data = static::query()->find($id);
         Cache::put($cacheKey, $data, $this->cacheTTL * 60);
 
@@ -52,11 +58,15 @@ public function getCachedByField(string $field, $value)
         $driver = $this->logDriver();
 
         if (Cache::has($cacheKey)) {
-            Log::debug("[Cacheable] HIT ({$driver}) key={$cacheKey}");
+            if (app()->environment('local')) {
+                Log::debug("[Cacheable] HIT ({$driver}) key={$cacheKey}");
+            }
             return Cache::get($cacheKey);
         }
 
-        Log::debug("[Cacheable] MISS ({$driver}) key={$cacheKey} → fetching from DB");
+        if (app()->environment('local')) {
+            Log::debug("[Cacheable] MISS ({$driver}) key={$cacheKey} → fetching from DB");
+        }
         $data = static::query()->where($field, $value)->first();
         Cache::put($cacheKey, $data, $this->cacheTTL * 60);
 
@@ -74,11 +84,15 @@ public function getCachedList(Builder $query, ?int $perPage)
         $driver = $this->logDriver();
 
         if (Cache::has($cacheKey)) {
-            Log::debug("[Cacheable] HIT ({$driver}) key={$cacheKey}");
+            if (app()->environment('local')) {
+                Log::debug("[Cacheable] HIT ({$driver}) key={$cacheKey}");
+            }
             return Cache::get($cacheKey);
         }
 
-        Log::debug("[Cacheable] MISS ({$driver}) key={$cacheKey} → fetching list from DB");
+        if (app()->environment('local')) {
+            Log::debug("[Cacheable] MISS ({$driver}) key={$cacheKey} → fetching list from DB");
+        }
         $data = $query->paginate($perPage);
         Cache::put($cacheKey, $data, $this->cacheTTL * 60);
 
@@ -91,19 +105,25 @@ public function getCachedList(Builder $query, ?int $perPage)
     public function clearCache()
     {
         $driver = config('cache.default');
-        Log::debug("[Cacheable] clearCache() for model=" . static::class . " id=" . ($this->id ?? 'null') . " driver={$driver}");
+        if (app()->environment('local')) {
+            Log::debug("[Cacheable] clearCache() for model=" . static::class . " id=" . ($this->id ?? 'null') . " driver={$driver}");
+        }
 
         if ($this->id) {
             $key = $this->getCacheKey($this->id);
             Cache::forget($key);
-            Log::debug("[Cacheable] Cleared cache key={$key}");
+            if (app()->environment('local')) {
+                Log::debug("[Cacheable] Cleared cache key={$key}");
+            }
         }
 
         $store = Cache::getStore();
         if (method_exists($store, 'tags')) {
             $tag = $this->getCacheTag();
             Cache::tags($tag)->flush();
-            Log::debug("[Cacheable] Flushed cache tag={$tag}");
+            if (app()->environment('local')) {
+                Log::debug("[Cacheable] Flushed cache tag={$tag}");
+            }
         }
     }
 
@@ -113,12 +133,16 @@ public function clearCache()
     protected static function bootCacheable()
     {
         static::saved(function ($model) {
-            Log::debug("[Cacheable] bootCacheable() saved() triggered for " . static::class);
+            if (app()->environment('local')) {
+                Log::debug("[Cacheable] bootCacheable() saved() triggered for " . static::class);
+            }
             $model->clearCache();
         });
 
         static::deleted(function ($model) {
-            Log::debug("[Cacheable] bootCacheable() deleted() triggered for " . static::class);
+            if (app()->environment('local')) {
+                Log::debug("[Cacheable] bootCacheable() deleted() triggered for " . static::class);
+            }
             $model->clearCache();
         });
     }
diff --git a/config/donate.php b/config/donate.php
index 01afac6..5991fae 100644
--- a/config/donate.php
+++ b/config/donate.php
@@ -48,11 +48,10 @@
     /**
      * Donation plans configuration.
      * 
-     * @var array|callable
+     * @var array|null
      * 
-     * Development note: Set to null to load from database.
-     * 
-     * @example 'plans' => fn() => DonationPlan::active()->orderBy('sort_order')->get(),
+     * Development note: Plans are loaded from database at runtime.
+     * This config is not meant to be cached; query database directly in services.
      */
-    'plans' => fn() => DonationPlan::active()->orderBy('sort_order')->get(),
+    'plans' => null,
 ];
\ No newline at end of file
diff --git a/config/nexus.php b/config/nexus.php
new file mode 100644
index 0000000..24bc665
--- /dev/null
+++ b/config/nexus.php
@@ -0,0 +1,14 @@
+<?php
+
+return [
+    /*
+    |--------------------------------------------------------------------------
+    | Nexus CMS options
+    |--------------------------------------------------------------------------
+    |
+    | Runtime feature flags consumed by app services. Values are loaded from
+    | config so they can be cached safely in production.
+    |
+    */
+    'redis_enabled' => env('REDIS_ENABLED', false),
+];
diff --git a/database/migrations/2026_05_17_000010_add_analytics_performance_indexes.php b/database/migrations/2026_05_17_000010_add_analytics_performance_indexes.php
new file mode 100644
index 0000000..b99f757
--- /dev/null
+++ b/database/migrations/2026_05_17_000010_add_analytics_performance_indexes.php
@@ -0,0 +1,36 @@
+<?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::table('analytics_sessions', function (Blueprint $table) {
+            $table->index(['is_bot', 'created_at'], 'analytics_sessions_is_bot_created_idx');
+        });
+
+        Schema::table('analytics_page_views', function (Blueprint $table) {
+            $table->index(['session_id', 'created_at'], 'analytics_page_views_session_created_idx');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('analytics_page_views', function (Blueprint $table) {
+            $table->dropIndex('analytics_page_views_session_created_idx');
+        });
+
+        Schema::table('analytics_sessions', function (Blueprint $table) {
+            $table->dropIndex('analytics_sessions_is_bot_created_idx');
+        });
+    }
+};
diff --git a/docs/module-crud-system.md b/docs/module-crud-system.md
new file mode 100644
index 0000000..97cfa80
--- /dev/null
+++ b/docs/module-crud-system.md
@@ -0,0 +1,430 @@
+# Module CRUD System — Diseño e Implementación
+
+## Contexto
+
+Los módulos de NexusCMS ya tienen un sistema de registro y carga sólido. Lo que falta es un mecanismo estándar para que cada módulo exponga su gestión en el ACP (Admin Control Panel) sin necesidad de código repetitivo y sin acoplarse al módulo Admin.
+
+Además, se detecta un problema existente en `ModuleManagerController`: el toggle y el update escriben en **dos sitios** (DB + `module.json`), y no existe un `uninstall` limpio separado del `destroy`.
+
+---
+
+## Parte 1 — Correcciones en ModuleManagerController
+
+### 1.1 Añadir `uninstall` (solo limpia la BD)
+
+Actualmente `destroy` borra la carpeta del módulo y su registro en BD. Se necesita una acción separada `uninstall` que **solo elimina el registro en `managed_modules`** sin tocar el filesystem. Útil cuando se quiere "desvincular" un módulo sin perder su código.
+
+**Ruta nueva:**
+```
+DELETE /acp/modules/{module}/uninstall  →  admin.modules.uninstall
+```
+
+**Comportamiento:**
+- Llama a `ModuleRegistryService::deleteState($module)`
+- Limpia caché
+- **No** borra la carpeta ni corre rollback de migrations
+- Redirige a `admin.modules.index` con mensaje de éxito
+
+**Distinción visual en el index:**
+- `Uninstall` → desvincula de BD, deja el código intacto
+- `Delete` → borra carpeta + BD (comportamiento actual)
+
+### 1.2 Limpiar código muerto
+
+- Eliminar el método `buildModuleData()` (nunca se llama)
+- El `edit` / `update` solo debe permitir editar `name` y `module_type`. Los campos `namespace`, `routes`, `migrations`, `views`, `translations` son responsabilidad del desarrollador en `module.json`, no del admin.
+
+---
+
+## Parte 2 — Sistema de CRUD para módulos
+
+### Visión general
+
+Cada módulo puede declarar una sección de administración en el ACP mediante **uno** de dos modos mutuamente excluyentes:
+
+| Modo | Descripción | Activación |
+|------|-------------|------------|
+| **A — JSON CRUD** | El módulo define su CRUD mediante un JSON. El framework renderiza la UI automáticamente. | `"admin_crud": "json"` en `module.json` |
+| **B — Custom Views** | El módulo provee sus propias vistas Blade y controladores bajo `Admin/`. | `"admin_crud": "custom"` en `module.json` |
+
+> Si `admin_crud` no está definido, el módulo no expone sección de administración.  
+> Los modos A y B son **mutuamente excluyentes**: definir `custom` desactiva la lógica JSON.
+
+---
+
+## Modo A — JSON CRUD (Genérico)
+
+### Archivo de configuración: `admin-crud.json`
+
+Ubicación: `app/Modules/{ModuleName}/admin-crud.json`
+
+Este archivo describe el modelo que se gestiona, los campos del formulario y las columnas del listado.
+
+```json
+{
+    "title": "Forum Categories",
+    "model": "Modules\\Forum\\Domain\\Models\\ForumCategory",
+    "route_prefix": "admin.forum.categories",
+    "permissions": {
+        "index":   "manage.forum",
+        "create":  "manage.forum",
+        "edit":    "manage.forum",
+        "delete":  "manage.forum"
+    },
+    "list": {
+        "columns": [
+            { "field": "name",        "label": "Name",        "sortable": true  },
+            { "field": "slug",        "label": "Slug",        "sortable": false },
+            { "field": "created_at",  "label": "Created",     "sortable": true,  "format": "date" }
+        ],
+        "per_page": 15,
+        "searchable": ["name", "slug"]
+    },
+    "form": {
+        "layout": "single",
+        "sections": [
+            {
+                "title": "General",
+                "fields": [
+                    {
+                        "name": "name",
+                        "label": "Name",
+                        "type": "text",
+                        "required": true,
+                        "placeholder": "Category name"
+                    },
+                    {
+                        "name": "slug",
+                        "label": "Slug",
+                        "type": "slug",
+                        "source": "name",
+                        "required": false,
+                        "hint": "Auto-generated from Name"
+                    },
+                    {
+                        "name": "description",
+                        "label": "Description",
+                        "type": "textarea",
+                        "required": false,
+                        "rows": 4
+                    },
+                    {
+                        "name": "is_visible",
+                        "label": "Visible",
+                        "type": "toggle",
+                        "default": true
+                    }
+                ]
+            }
+        ]
+    }
+}
+```
+
+### Tipos de campo soportados (Modo A)
+
+| Tipo | Descripción |
+|------|-------------|
+| `text` | Input de texto simple |
+| `textarea` | Área de texto |
+| `richtext` | CKEditor (como en News) |
+| `slug` | Input con generación automática desde otro campo (`source`) |
+| `select` | Dropdown. Requiere `options: [{"value":"","label":""}]` o `relation` |
+| `toggle` | Checkbox booleano |
+| `number` | Input numérico |
+| `date` | Date picker |
+| `datetime` | Datetime picker |
+| `image` | Upload de imagen a `storage/` |
+| `file` | Upload de archivo genérico |
+| `relation` | Select cargado desde relación Eloquent. Requiere `model`, `value_field`, `label_field` |
+| `hidden` | Campo oculto con valor fijo o generado |
+
+### Layout del formulario
+
+El campo `"layout"` en `form` puede ser:
+
+- `"single"` — Una sola columna, secciones apiladas verticalmente
+- `"sidebar"` — Columna principal (2/3) + sidebar (1/3). Las secciones se asignan a `"position": "main"` o `"position": "sidebar"`
+
+Ejemplo con sidebar:
+```json
+"form": {
+    "layout": "sidebar",
+    "sections": [
+        {
+            "title": "Content",
+            "position": "main",
+            "fields": [...]
+        },
+        {
+            "title": "Settings",
+            "position": "sidebar",
+            "fields": [...]
+        }
+    ]
+}
+```
+
+### Componentes del sistema (Modo A)
+
+#### `ModuleCrudService`
+`app/Services/ModuleCrudService.php`
+
+Responsabilidades:
+- Leer y parsear `admin-crud.json` de un módulo
+- Validar la estructura del JSON
+- Generar reglas de validación Laravel desde la definición de campos
+- Resolver el modelo Eloquent
+- Ejecutar operaciones CRUD (index, store, update, delete) contra el modelo
+
+#### `GenericCrudController`
+`app/Modules/Admin/Http/Controllers/GenericCrudController.php`
+
+Controlador único que gestiona todos los módulos en Modo A:
+- Recibe `{module}` y `{action}` como parámetros de ruta
+- Delega en `ModuleCrudService`
+- Renderiza vistas genéricas reutilizables
+
+#### Vistas genéricas (Modo A)
+```
+app/Modules/Admin/Resources/views/generic-crud/
+├── index.blade.php   — Tabla de listado con paginación y búsqueda
+├── create.blade.php  — Formulario de creación
+└── edit.blade.php    — Formulario de edición
+```
+
+Estas vistas iteran sobre la definición de `admin-crud.json` y renderizan los campos dinámicamente mediante un componente Blade parcial por tipo de campo:
+
+```
+app/Modules/Admin/Resources/views/generic-crud/fields/
+├── text.blade.php
+├── textarea.blade.php
+├── richtext.blade.php
+├── slug.blade.php
+├── select.blade.php
+├── toggle.blade.php
+├── image.blade.php
+├── relation.blade.php
+└── ...
+```
+
+#### Rutas (Modo A)
+
+Se registran automáticamente para cada módulo con `admin_crud: json` activo:
+
+```
+GET    /acp/modules/{module}/manage          → index
+GET    /acp/modules/{module}/manage/create   → create
+POST   /acp/modules/{module}/manage          → store
+GET    /acp/modules/{module}/manage/{id}     → edit
+PUT    /acp/modules/{module}/manage/{id}     → update
+DELETE /acp/modules/{module}/manage/{id}     → destroy
+```
+
+Rutas nombradas:
+```
+admin.module-crud.index
+admin.module-crud.create
+admin.module-crud.store
+admin.module-crud.edit
+admin.module-crud.update
+admin.module-crud.destroy
+```
+
+El registro de estas rutas lo hace `ModuleServiceProvider` al detectar `admin_crud: json` en el manifest.
+
+---
+
+## Modo B — Custom Views (Vistas propias del módulo)
+
+### Estructura dentro del módulo
+
+```
+app/Modules/{ModuleName}/
+└── Admin/
+    ├── Controllers/
+    │   └── ForumAdminController.php
+    ├── routes.php
+    └── views/
+        ├── index.blade.php
+        ├── create.blade.php
+        └── edit.blade.php
+```
+
+### Activación
+
+En `module.json`:
+```json
+{
+    "admin_crud": "custom"
+}
+```
+
+Cuando `admin_crud` es `custom`:
+- El framework **no** registra rutas genéricas para este módulo
+- `BaseModuleServiceProvider` detecta la carpeta `Admin/` y:
+  - Carga `Admin/routes.php` dentro del middleware `auth + permission:access.admin.panel`
+  - Registra `Admin/views/` como namespace de vistas `{modulename}-admin::`
+  
+### Reglas del modo custom
+
+1. Las rutas deben definirse en `Admin/routes.php`
+2. Los controladores deben extender `App\Http\Controllers\Controller`
+3. Las vistas deben extender `admin::layouts.app` para mantener el layout del ACP
+4. El módulo es responsable de sus propias validaciones y lógica
+
+### Ejemplo: `Admin/routes.php`
+
+```php
+<?php
+use Illuminate\Support\Facades\Route;
+use Modules\Forum\Admin\Controllers\ForumAdminController;
+
+Route::middleware(['auth', 'permission:manage.forum'])
+    ->prefix('acp/forum')
+    ->name('admin.forum.')
+    ->group(function () {
+        Route::get('/', [ForumAdminController::class, 'index'])->name('index');
+        Route::get('/create', [ForumAdminController::class, 'create'])->name('create');
+        Route::post('/', [ForumAdminController::class, 'store'])->name('store');
+        Route::get('/{id}/edit', [ForumAdminController::class, 'edit'])->name('edit');
+        Route::put('/{id}', [ForumAdminController::class, 'update'])->name('update');
+        Route::delete('/{id}', [ForumAdminController::class, 'destroy'])->name('destroy');
+    });
+```
+
+---
+
+## Integración en el módulo Admin — Sidebar / Menú
+
+Tanto en Modo A como en Modo B, el módulo puede declarar su entrada en el menú lateral del ACP añadiendo una clave `admin_menu` en `module.json`:
+
+```json
+{
+    "admin_menu": {
+        "label": "Forum",
+        "icon": "fas fa-comments",
+        "route": "admin.forum.index",
+        "permission": "manage.forum",
+        "order": 30
+    }
+}
+```
+
+El layout del ACP (`admin::layouts.app`) leerá estos registros de los módulos activos y construirá el menú dinámicamente.
+
+---
+
+## Cambios en `module.json` — Resumen de nuevas claves
+
+```json
+{
+    "name": "Forum",
+    "description": "Forum module",
+    "version": "1.2.0",
+    "author": "WoW-CMS",
+    "enabled": true,
+    "routes": true,
+    "migrations": true,
+    "views": true,
+    "namespace": "Modules\\Forum",
+
+    "admin_crud": "custom",
+
+    "admin_menu": {
+        "label": "Forum",
+        "icon": "fas fa-comments",
+        "route": "admin.forum.index",
+        "permission": "manage.forum",
+        "order": 30
+    }
+}
+```
+
+---
+
+## Cambios en `BaseModuleServiceProvider`
+
+```php
+public function boot(): void
+{
+    parent::boot();
+
+    $adminCrud = $this->config['admin_crud'] ?? null;
+
+    if ($adminCrud === 'custom') {
+        $this->loadAdminRoutes();
+        $this->loadAdminViews();
+    }
+    // Si es 'json', las rutas genéricas las registra ModuleServiceProvider globalmente
+}
+
+private function loadAdminRoutes(): void
+{
+    $path = $this->modulePath . '/Admin/routes.php';
+    if (is_file($path)) {
+        Route::middleware(['web', 'auth'])
+            ->group($path);
+    }
+}
+
+private function loadAdminViews(): void
+{
+    $path = $this->modulePath . '/Admin/views';
+    if (is_dir($path)) {
+        $this->loadViewsFrom($path, strtolower($this->moduleName) . '-admin');
+    }
+}
+```
+
+---
+
+## Fases de implementación
+
+### Fase 1 — Correcciones ModuleManagerController
+- Añadir método `uninstall()` (solo borra BD)
+- Añadir ruta `DELETE /acp/modules/{module}/uninstall`
+- Quitar campos estructurales del formulario `edit` (namespace, routes, etc.)
+- Eliminar `buildModuleData()` (código muerto)
+- Actualizar vista `index.blade.php`: botón "Uninstall" separado de "Delete"
+
+### Fase 2 — Infraestructura base
+- Añadir clave `admin_crud` al parsing del manifest en `ModuleRegistryService`
+- Actualizar `BaseModuleServiceProvider` para detectar modo `custom`
+- Actualizar `module.json` del módulo Example con la nueva estructura
+
+### Fase 3 — Modo B (Custom Views)
+- Implementar carga de `Admin/routes.php` y `Admin/views/` en `BaseModuleServiceProvider`
+- Documentar con el módulo Example
+
+### Fase 4 — Modo A (JSON CRUD)
+- Implementar `ModuleCrudService` (parse + validación de `admin-crud.json`)
+- Implementar `GenericCrudController`
+- Crear vistas genéricas `generic-crud/index`, `create`, `edit`
+- Crear partiales por tipo de campo en `generic-crud/fields/`
+- Registrar rutas genéricas desde `ModuleServiceProvider` para módulos con `admin_crud: json`
+
+### Fase 5 — Menú dinámico del ACP
+- Implementar lectura de `admin_menu` desde el manifest
+- Actualizar `admin::layouts.app` para construir el sidebar dinámicamente
+
+---
+
+## Archivos afectados / nuevos
+
+| Archivo | Estado |
+|---------|--------|
+| `app/Modules/Admin/Http/Controllers/ModuleManagerController.php` | Modificar |
+| `app/Modules/Admin/Resources/views/modules/index.blade.php` | Modificar |
+| `app/Modules/Admin/Resources/views/modules/edit.blade.php` | Modificar |
+| `app/Services/ModuleRegistryService.php` | Modificar |
+| `app/Providers/BaseModuleServiceProvider.php` | Modificar |
+| `app/Providers/ModuleServiceProvider.php` | Modificar (Fase 4) |
+| `app/Services/ModuleCrudService.php` | Nuevo (Fase 4) |
+| `app/Modules/Admin/Http/Controllers/GenericCrudController.php` | Nuevo (Fase 4) |
+| `app/Modules/Admin/Resources/views/generic-crud/*.blade.php` | Nuevo (Fase 4) |
+| `app/Modules/Admin/Resources/views/generic-crud/fields/*.blade.php` | Nuevo (Fase 4) |
+| `app/Modules/{Name}/Admin/routes.php` | Nuevo por módulo (Fase 3) |
+| `app/Modules/{Name}/Admin/Controllers/*.php` | Nuevo por módulo (Fase 3) |
+| `app/Modules/{Name}/Admin/views/*.blade.php` | Nuevo por módulo (Fase 3) |
+| `app/Modules/{Name}/admin-crud.json` | Nuevo por módulo (Fase 4) |

From 9d601d43b015308e7cddfa5e653fd3464770684c Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 17 May 2026 03:05:10 +0200
Subject: [PATCH 112/132] Refactor form fields and enhance UI components

- Updated number, select, text, textarea, and toggle fields for improved styling and usability.
- Added new email, enum, and URL field types with consistent design patterns.
- Enhanced search functionality in the admin CRUD index with better layout and user experience.
- Improved error handling and hint display across form fields.
- Updated ModuleCrudService to support new enum field type and refined search logic.
- Adjusted admin-crud.json configuration for better search capabilities and added new field types.
- Refactored ModuleRegistryService for cleaner code and improved module retrieval.
---
 .../Controllers/GenericCrudController.php     |  38 +++-
 .../views/generic-crud/_section.blade.php     |  21 +-
 .../views/generic-crud/create.blade.php       |  97 +++++----
 .../views/generic-crud/edit.blade.php         | 120 ++++++++----
 .../views/generic-crud/fields/email.blade.php |  25 +++
 .../views/generic-crud/fields/enum.blade.php  |  48 +++++
 .../generic-crud/fields/number.blade.php      |  19 +-
 .../generic-crud/fields/select.blade.php      |  54 ++---
 .../views/generic-crud/fields/text.blade.php  |  16 +-
 .../generic-crud/fields/textarea.blade.php    |  15 +-
 .../generic-crud/fields/toggle.blade.php      |  36 ++--
 .../views/generic-crud/fields/url.blade.php   |  25 +++
 .../views/generic-crud/index.blade.php        | 185 +++++++++++++-----
 app/Modules/Example/Http/routes.php           |   3 +-
 app/Modules/Store/admin-crud.json             |  30 +--
 app/Services/ModuleCrudService.php            |  76 +++++--
 app/Services/ModuleRegistryService.php        |  41 ++--
 17 files changed, 614 insertions(+), 235 deletions(-)
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/email.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/enum.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/generic-crud/fields/url.blade.php

diff --git a/app/Modules/Admin/Http/Controllers/GenericCrudController.php b/app/Modules/Admin/Http/Controllers/GenericCrudController.php
index 950599f..a170a98 100644
--- a/app/Modules/Admin/Http/Controllers/GenericCrudController.php
+++ b/app/Modules/Admin/Http/Controllers/GenericCrudController.php
@@ -60,32 +60,54 @@ public function store(Request $request, string $module)
             ->with('success', 'Record created successfully.');
     }
 
-    public function edit(string $module, int|string $id)
+    public function edit(int|string $id, string $module)
     {
         $config = $this->getCrudConfigOrFail($module);
-        $record = ModuleCrudService::find($config, $id);
-        $base   = $this->crudRouteBase($module);
+
+        try {
+            $record = ModuleCrudService::find($config, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException) {
+            return redirect()
+                ->route($this->crudRouteBase($module) . 'index')
+                ->with('error', "Record #{$id} was not found.");
+        }
+
+        $base = $this->crudRouteBase($module);
 
         return view('admin::generic-crud.edit', compact('config', 'record', 'module', 'base'));
     }
 
-    public function update(Request $request, string $module, int|string $id)
+    public function update(Request $request, int|string $id, string $module)
     {
         $config = $this->getCrudConfigOrFail($module);
-        $data   = $request->validate(ModuleCrudService::buildValidationRules($config, isUpdate: true));
 
+        try {
+            ModuleCrudService::find($config, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException) {
+            return redirect()
+                ->route($this->crudRouteBase($module) . 'index')
+                ->with('error', "Record #{$id} was not found.");
+        }
+
+        $data = $request->validate(ModuleCrudService::buildValidationRules($config, isUpdate: true));
         ModuleCrudService::update($config, $id, $data);
 
         return redirect()
-            ->route($this->crudRouteBase($module) . 'index')
+            ->route($this->crudRouteBase($module) . 'edit', ['id' => $id])
             ->with('success', 'Record updated successfully.');
     }
 
-    public function destroy(string $module, int|string $id)
+    public function destroy(int|string $id, string $module)
     {
         $config = $this->getCrudConfigOrFail($module);
 
-        ModuleCrudService::destroy($config, $id);
+        try {
+            ModuleCrudService::destroy($config, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException) {
+            return redirect()
+                ->route($this->crudRouteBase($module) . 'index')
+                ->with('error', "Record #{$id} was not found.");
+        }
 
         return redirect()
             ->route($this->crudRouteBase($module) . 'index')
diff --git a/app/Modules/Admin/Resources/views/generic-crud/_section.blade.php b/app/Modules/Admin/Resources/views/generic-crud/_section.blade.php
index 9fbf79a..8462450 100644
--- a/app/Modules/Admin/Resources/views/generic-crud/_section.blade.php
+++ b/app/Modules/Admin/Resources/views/generic-crud/_section.blade.php
@@ -6,8 +6,25 @@
 
     <div class="space-y-5">
         @foreach($section['fields'] ?? [] as $field)
-            @php $type = $field['type'] ?? 'text'; @endphp
-            @include("admin::generic-crud.fields.{$type}", compact('field', 'record'))
+            @php
+                $type = $field['type'] ?? 'text';
+                // Normalize 'help' → 'hint' so both keys work in templates
+                if (!isset($field['hint']) && isset($field['help'])) {
+                    $field['hint'] = $field['help'];
+                }
+                // Map 'checkbox' to 'toggle' (aliases)
+                if ($type === 'checkbox') {
+                    $type = 'toggle';
+                    $field['type'] = 'toggle';
+                }
+                $templateExists = view()->exists("admin::generic-crud.fields.{$type}");
+            @endphp
+            @if($templateExists)
+                @include("admin::generic-crud.fields.{$type}", compact('field', 'record'))
+            @else
+                {{-- Fallback for unknown field types --}}
+                @include("admin::generic-crud.fields.text", ['field' => array_merge($field, ['type' => 'text']), 'record' => $record])
+            @endif
         @endforeach
     </div>
 </div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/create.blade.php b/app/Modules/Admin/Resources/views/generic-crud/create.blade.php
index 4e5d356..3ec993a 100644
--- a/app/Modules/Admin/Resources/views/generic-crud/create.blade.php
+++ b/app/Modules/Admin/Resources/views/generic-crud/create.blade.php
@@ -1,44 +1,75 @@
 @extends('admin::layouts.app')
 
-@section('title', 'Create — ' . ($config['title'] ?? 'Record'))
+@section('title', 'New ' . ($config['title'] ?? 'Record'))
 
 @section('content')
-<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
-    <h1 class="text-2xl font-bold text-gray-800">New {{ $config['title'] ?? 'Record' }}</h1>
-    <a href="{{ route($base . 'index') }}"
-       class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
-        <i class="fas fa-arrow-left mr-2"></i>Back
-    </a>
-</header>
-
-<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
-    @if($errors->any())
-        <div class="mb-6 p-4 bg-red-50 border-l-4 border-red-500 rounded-lg">
-            <p class="text-red-700 text-sm font-medium mb-2">Please fix the following errors:</p>
-            <ul class="text-sm text-red-700 list-disc list-inside">
-                @foreach($errors->all() as $error)
-                    <li>{{ $error }}</li>
-                @endforeach
-            </ul>
+
+{{-- Page header --}}
+<div class="bg-white border-b border-gray-200 px-6 py-4 flex items-center justify-between gap-4 shrink-0">
+    <div class="flex items-center gap-3">
+        <a href="{{ route($base . 'index') }}"
+           class="w-8 h-8 inline-flex items-center justify-center rounded-lg text-gray-400
+                  hover:text-gray-600 hover:bg-gray-100 transition">
+            <i class="fas fa-arrow-left text-sm"></i>
+        </a>
+        <div>
+            <div class="flex items-center gap-2 text-xs text-gray-400 mb-0.5">
+                <a href="{{ route($base . 'index') }}" class="hover:text-gray-600 transition">{{ $config['title'] ?? 'Records' }}</a>
+                <i class="fas fa-chevron-right text-[9px]"></i>
+                <span class="text-gray-500">New</span>
+            </div>
+            <h1 class="text-xl font-bold text-gray-900">
+                New {{ \Illuminate\Support\Str::singular($config['title'] ?? 'Record') }}
+            </h1>
         </div>
-    @endif
+    </div>
+</div>
 
-    <form method="POST" action="{{ route($base . 'store') }}"
-          enctype="multipart/form-data">
+<div class="flex-1 overflow-y-auto bg-gray-50">
+    <form method="POST" action="{{ route($base . 'store') }}" enctype="multipart/form-data" id="crud-form">
         @csrf
 
-        @include('admin::generic-crud._form', ['config' => $config, 'record' => null])
-
-        <div class="mt-6 flex items-center gap-3">
-            <button type="submit"
-                    class="px-5 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
-                <i class="fas fa-save mr-2"></i>Save
-            </button>
-            <a href="{{ route($base . 'index') }}"
-               class="px-5 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300 text-sm font-medium">
-                Cancel
-            </a>
+        <div class="p-6 pb-28">
+            {{-- Validation errors --}}
+            @if($errors->any())
+                <div class="mb-6 flex gap-3 p-4 bg-red-50 border border-red-200 rounded-xl text-sm">
+                    <i class="fas fa-circle-exclamation text-red-500 mt-0.5 shrink-0"></i>
+                    <div>
+                        <p class="font-semibold text-red-800 mb-1">Please fix the following errors:</p>
+                        <ul class="text-red-700 space-y-0.5 list-disc list-inside">
+                            @foreach($errors->all() as $error)
+                                <li>{{ $error }}</li>
+                            @endforeach
+                        </ul>
+                    </div>
+                </div>
+            @endif
+
+            @include('admin::generic-crud._form', ['config' => $config, 'record' => null])
+        </div>
+
+        {{-- Sticky save bar --}}
+        <div class="fixed bottom-0 right-0 left-0 md:left-64 bg-white border-t border-gray-200 px-6 py-3
+                    flex items-center justify-between gap-4 z-10 shadow-sm">
+            <p class="text-xs text-gray-400">
+                <i class="fas fa-circle-info mr-1"></i>
+                Fields marked <span class="text-red-500 font-semibold">*</span> are required.
+            </p>
+            <div class="flex items-center gap-2">
+                <a href="{{ route($base . 'index') }}"
+                   class="px-4 py-2 text-sm font-medium text-gray-600 bg-gray-100 rounded-lg hover:bg-gray-200 transition">
+                    Cancel
+                </a>
+                <button type="submit"
+                        class="inline-flex items-center gap-2 px-5 py-2 bg-blue-600 text-white text-sm font-medium
+                               rounded-lg hover:bg-blue-700 active:bg-blue-800 transition shadow-sm">
+                    <i class="fas fa-save text-xs"></i>
+                    Save
+                </button>
+            </div>
         </div>
+
     </form>
-</main>
+</div>
+
 @endsection
diff --git a/app/Modules/Admin/Resources/views/generic-crud/edit.blade.php b/app/Modules/Admin/Resources/views/generic-crud/edit.blade.php
index b4d9dce..a000ab9 100644
--- a/app/Modules/Admin/Resources/views/generic-crud/edit.blade.php
+++ b/app/Modules/Admin/Resources/views/generic-crud/edit.blade.php
@@ -3,48 +3,96 @@
 @section('title', 'Edit — ' . ($config['title'] ?? 'Record'))
 
 @section('content')
-<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
-    <h1 class="text-2xl font-bold text-gray-800">Edit {{ $config['title'] ?? 'Record' }}</h1>
-    <a href="{{ route($base . 'index') }}"
-       class="px-4 py-2 bg-gray-200 text-gray-800 rounded-lg hover:bg-gray-300 text-sm font-medium">
-        <i class="fas fa-arrow-left mr-2"></i>Back
-    </a>
-</header>
-
-<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
-    @if(session('success'))
-        <div class="mb-4 p-3 bg-green-50 text-green-700 border border-green-200 rounded-lg flex items-center gap-2">
-            <i class="fas fa-check-circle"></i> {{ session('success') }}
-        </div>
-    @endif
-    @if($errors->any())
-        <div class="mb-6 p-4 bg-red-50 border-l-4 border-red-500 rounded-lg">
-            <p class="text-red-700 text-sm font-medium mb-2">Please fix the following errors:</p>
-            <ul class="text-sm text-red-700 list-disc list-inside">
-                @foreach($errors->all() as $error)
-                    <li>{{ $error }}</li>
-                @endforeach
-            </ul>
+
+{{-- Page header --}}
+<div class="bg-white border-b border-gray-200 px-6 py-4 flex items-center justify-between gap-4 shrink-0">
+    <div class="flex items-center gap-3">
+        <a href="{{ route($base . 'index') }}"
+           class="w-8 h-8 inline-flex items-center justify-center rounded-lg text-gray-400
+                  hover:text-gray-600 hover:bg-gray-100 transition">
+            <i class="fas fa-arrow-left text-sm"></i>
+        </a>
+        <div>
+            <div class="flex items-center gap-2 text-xs text-gray-400 mb-0.5">
+                <a href="{{ route($base . 'index') }}" class="hover:text-gray-600 transition">{{ $config['title'] ?? 'Records' }}</a>
+                <i class="fas fa-chevron-right text-[9px]"></i>
+                <span class="text-gray-500">Edit #{{ $record->getKey() }}</span>
+            </div>
+            <h1 class="text-xl font-bold text-gray-900">
+                Edit {{ \Illuminate\Support\Str::singular($config['title'] ?? 'Record') }}
+            </h1>
         </div>
-    @endif
+    </div>
+    {{-- Danger zone: delete --}}
+    <form method="POST"
+          action="{{ route($base . 'destroy', $record->getKey()) }}"
+          onsubmit="return confirm('Delete this record? This cannot be undone.')">
+        @csrf @method('DELETE')
+        <button type="submit"
+                class="inline-flex items-center gap-2 px-3 py-1.5 text-xs font-medium text-red-600
+                       bg-red-50 hover:bg-red-100 border border-red-200 rounded-lg transition">
+            <i class="fas fa-trash-alt"></i>
+            Delete
+        </button>
+    </form>
+</div>
 
+<div class="flex-1 overflow-y-auto bg-gray-50">
     <form method="POST"
           action="{{ route($base . 'update', $record->getKey()) }}"
-          enctype="multipart/form-data">
+          enctype="multipart/form-data"
+          id="crud-form">
         @csrf @method('PUT')
 
-        @include('admin::generic-crud._form', ['config' => $config, 'record' => $record])
-
-        <div class="mt-6 flex items-center gap-3">
-            <button type="submit"
-                    class="px-5 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
-                <i class="fas fa-save mr-2"></i>Save Changes
-            </button>
-            <a href="{{ route($base . 'index') }}"
-               class="px-5 py-2 bg-gray-200 text-gray-700 rounded-lg hover:bg-gray-300 text-sm font-medium">
-                Cancel
-            </a>
+        <div class="p-6 pb-28">
+            {{-- Success flash --}}
+            @if(session('success'))
+                <div class="mb-5 flex items-center gap-3 px-4 py-3 bg-green-50 border border-green-200 text-green-800 rounded-xl text-sm">
+                    <i class="fas fa-check-circle text-green-500 shrink-0"></i>
+                    {{ session('success') }}
+                </div>
+            @endif
+
+            {{-- Validation errors --}}
+            @if($errors->any())
+                <div class="mb-6 flex gap-3 p-4 bg-red-50 border border-red-200 rounded-xl text-sm">
+                    <i class="fas fa-circle-exclamation text-red-500 mt-0.5 shrink-0"></i>
+                    <div>
+                        <p class="font-semibold text-red-800 mb-1">Please fix the following errors:</p>
+                        <ul class="text-red-700 space-y-0.5 list-disc list-inside">
+                            @foreach($errors->all() as $error)
+                                <li>{{ $error }}</li>
+                            @endforeach
+                        </ul>
+                    </div>
+                </div>
+            @endif
+
+            @include('admin::generic-crud._form', ['config' => $config, 'record' => $record])
+        </div>
+
+        {{-- Sticky save bar --}}
+        <div class="fixed bottom-0 right-0 left-0 md:left-64 bg-white border-t border-gray-200 px-6 py-3
+                    flex items-center justify-between gap-4 z-10 shadow-sm">
+            <p class="text-xs text-gray-400">
+                <i class="fas fa-circle-info mr-1"></i>
+                Fields marked <span class="text-red-500 font-semibold">*</span> are required.
+            </p>
+            <div class="flex items-center gap-2">
+                <a href="{{ route($base . 'index') }}"
+                   class="px-4 py-2 text-sm font-medium text-gray-600 bg-gray-100 rounded-lg hover:bg-gray-200 transition">
+                    Cancel
+                </a>
+                <button type="submit"
+                        class="inline-flex items-center gap-2 px-5 py-2 bg-blue-600 text-white text-sm font-medium
+                               rounded-lg hover:bg-blue-700 active:bg-blue-800 transition shadow-sm">
+                    <i class="fas fa-save text-xs"></i>
+                    Save Changes
+                </button>
+            </div>
         </div>
+
     </form>
-</main>
+</div>
+
 @endsection
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/email.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/email.blade.php
new file mode 100644
index 0000000..b2e71f1
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/email.blade.php
@@ -0,0 +1,25 @@
+@php $value = old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? '')); @endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1.5">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500 ml-0.5">*</span> @endif
+    </label>
+    <input type="email"
+           id="{{ $field['name'] }}"
+           name="{{ $field['name'] }}"
+           value="{{ $value }}"
+           placeholder="{{ $field['placeholder'] ?? '' }}"
+           @if(!empty($field['max'])) maxlength="{{ $field['max'] }}" @endif
+           class="w-full rounded-lg border text-sm px-3 py-2
+                  focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition
+                  @error($field['name']) border-red-400 bg-red-50 @else border-gray-300 bg-white @enderror"
+           {{ ($field['required'] ?? false) ? 'required' : '' }}>
+    @if(!empty($field['hint']))
+        <p class="mt-1.5 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600 flex items-center gap-1">
+            <i class="fas fa-circle-exclamation text-[10px]"></i>{{ $message }}
+        </p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/enum.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/enum.blade.php
new file mode 100644
index 0000000..5e00b96
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/enum.blade.php
@@ -0,0 +1,48 @@
+@php
+    $value = old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? ''));
+    $options = $field['options'] ?? [];
+    // Support both flat arrays ["val1","val2"] and label/value pairs [{"value":"v","label":"L"}]
+    $normalized = [];
+    foreach ($options as $opt) {
+        if (is_array($opt)) {
+            $normalized[] = $opt;
+        } else {
+            $normalized[] = ['value' => $opt, 'label' => $opt];
+        }
+    }
+@endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1.5">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500 ml-0.5">*</span> @endif
+    </label>
+    <div class="relative">
+        <select id="{{ $field['name'] }}"
+                name="{{ $field['name'] }}"
+                class="w-full appearance-none rounded-lg border text-sm px-3 py-2 pr-8
+                       focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition
+                       @error($field['name']) border-red-400 bg-red-50 @else border-gray-300 bg-white @enderror"
+                {{ ($field['required'] ?? false) ? 'required' : '' }}>
+            @if(!($field['required'] ?? false))
+                <option value="">— Select —</option>
+            @endif
+            @foreach($normalized as $option)
+                <option value="{{ $option['value'] }}"
+                        {{ (string) $value === (string) $option['value'] ? 'selected' : '' }}>
+                    {{ $option['label'] }}
+                </option>
+            @endforeach
+        </select>
+        <div class="pointer-events-none absolute inset-y-0 right-0 flex items-center px-2.5 text-gray-400">
+            <i class="fas fa-chevron-down text-[10px]"></i>
+        </div>
+    </div>
+    @if(!empty($field['hint']))
+        <p class="mt-1.5 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600 flex items-center gap-1">
+            <i class="fas fa-circle-exclamation text-[10px]"></i>{{ $message }}
+        </p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/number.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/number.blade.php
index e1de311..d7c5342 100644
--- a/app/Modules/Admin/Resources/views/generic-crud/fields/number.blade.php
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/number.blade.php
@@ -1,23 +1,26 @@
 @php $value = old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? '')); @endphp
 <div>
-    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1.5">
         {{ $field['label'] ?? $field['name'] }}
-        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+        @if($field['required'] ?? false) <span class="text-red-500 ml-0.5">*</span> @endif
     </label>
     <input type="number"
            id="{{ $field['name'] }}"
            name="{{ $field['name'] }}"
            value="{{ $value }}"
            step="{{ $field['step'] ?? 1 }}"
-           min="{{ $field['min'] ?? '' }}"
-           max="{{ $field['max'] ?? '' }}"
-           class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500 text-sm
-                  @error($field['name']) border-red-400 @enderror"
+           @if(isset($field['min'])) min="{{ $field['min'] }}" @endif
+           @if(isset($field['max'])) max="{{ $field['max'] }}" @endif
+           class="w-full rounded-lg border text-sm px-3 py-2
+                  focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition
+                  @error($field['name']) border-red-400 bg-red-50 @else border-gray-300 bg-white @enderror"
            {{ ($field['required'] ?? false) ? 'required' : '' }}>
     @if(!empty($field['hint']))
-        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+        <p class="mt-1.5 text-xs text-gray-400">{{ $field['hint'] }}</p>
     @endif
     @error($field['name'])
-        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+        <p class="mt-1 text-xs text-red-600 flex items-center gap-1">
+            <i class="fas fa-circle-exclamation text-[10px]"></i>{{ $message }}
+        </p>
     @enderror
 </div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/select.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/select.blade.php
index bb730bc..2f2b277 100644
--- a/app/Modules/Admin/Resources/views/generic-crud/fields/select.blade.php
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/select.blade.php
@@ -1,32 +1,40 @@
 @php $value = old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? '')); @endphp
 <div>
-    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1.5">
         {{ $field['label'] ?? $field['name'] }}
-        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+        @if($field['required'] ?? false) <span class="text-red-500 ml-0.5">*</span> @endif
     </label>
-    <select id="{{ $field['name'] }}"
-            name="{{ $field['name'] }}"
-            class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500 text-sm
-                   @error($field['name']) border-red-400 @enderror"
-            {{ ($field['required'] ?? false) ? 'required' : '' }}>
-        <option value="">— Select —</option>
-        @php
-            $options = $field['options'] ?? [];
-            if (!empty($field['relation'])) {
-                $options = \App\Services\ModuleCrudService::resolveRelationOptions($field['relation']);
-            }
-        @endphp
-        @foreach($options as $option)
-            <option value="{{ $option['value'] }}"
-                    {{ (string) $value === (string) $option['value'] ? 'selected' : '' }}>
-                {{ $option['label'] }}
-            </option>
-        @endforeach
-    </select>
+    <div class="relative">
+        <select id="{{ $field['name'] }}"
+                name="{{ $field['name'] }}"
+                class="w-full appearance-none rounded-lg border text-sm px-3 py-2 pr-8
+                       focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition
+                       @error($field['name']) border-red-400 bg-red-50 @else border-gray-300 bg-white @enderror"
+                {{ ($field['required'] ?? false) ? 'required' : '' }}>
+            <option value="">— Select —</option>
+            @php
+                $options = $field['options'] ?? [];
+                if (!empty($field['relation'])) {
+                    $options = \App\Services\ModuleCrudService::resolveRelationOptions($field['relation']);
+                }
+            @endphp
+            @foreach($options as $option)
+                <option value="{{ $option['value'] }}"
+                        {{ (string) $value === (string) $option['value'] ? 'selected' : '' }}>
+                    {{ $option['label'] }}
+                </option>
+            @endforeach
+        </select>
+        <div class="pointer-events-none absolute inset-y-0 right-0 flex items-center px-2.5 text-gray-400">
+            <i class="fas fa-chevron-down text-[10px]"></i>
+        </div>
+    </div>
     @if(!empty($field['hint']))
-        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+        <p class="mt-1.5 text-xs text-gray-400">{{ $field['hint'] }}</p>
     @endif
     @error($field['name'])
-        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+        <p class="mt-1 text-xs text-red-600 flex items-center gap-1">
+            <i class="fas fa-circle-exclamation text-[10px]"></i>{{ $message }}
+        </p>
     @enderror
 </div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/text.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/text.blade.php
index 7d99cb8..a2cbb3a 100644
--- a/app/Modules/Admin/Resources/views/generic-crud/fields/text.blade.php
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/text.blade.php
@@ -1,21 +1,25 @@
 @php $value = old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? '')); @endphp
 <div>
-    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1.5">
         {{ $field['label'] ?? $field['name'] }}
-        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+        @if($field['required'] ?? false) <span class="text-red-500 ml-0.5">*</span> @endif
     </label>
     <input type="text"
            id="{{ $field['name'] }}"
            name="{{ $field['name'] }}"
            value="{{ $value }}"
            placeholder="{{ $field['placeholder'] ?? '' }}"
-           class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500 text-sm
-                  @error($field['name']) border-red-400 @enderror"
+           @if(!empty($field['max'])) maxlength="{{ $field['max'] }}" @endif
+           class="w-full rounded-lg border text-sm px-3 py-2
+                  focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition
+                  @error($field['name']) border-red-400 bg-red-50 @else border-gray-300 bg-white @enderror"
            {{ ($field['required'] ?? false) ? 'required' : '' }}>
     @if(!empty($field['hint']))
-        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+        <p class="mt-1.5 text-xs text-gray-400">{{ $field['hint'] }}</p>
     @endif
     @error($field['name'])
-        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+        <p class="mt-1 text-xs text-red-600 flex items-center gap-1">
+            <i class="fas fa-circle-exclamation text-[10px]"></i>{{ $message }}
+        </p>
     @enderror
 </div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/textarea.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/textarea.blade.php
index 6e25c19..6faf40e 100644
--- a/app/Modules/Admin/Resources/views/generic-crud/fields/textarea.blade.php
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/textarea.blade.php
@@ -1,20 +1,23 @@
 @php $value = old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? '')); @endphp
 <div>
-    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1">
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1.5">
         {{ $field['label'] ?? $field['name'] }}
-        @if($field['required'] ?? false) <span class="text-red-500">*</span> @endif
+        @if($field['required'] ?? false) <span class="text-red-500 ml-0.5">*</span> @endif
     </label>
     <textarea id="{{ $field['name'] }}"
               name="{{ $field['name'] }}"
               rows="{{ $field['rows'] ?? 4 }}"
               placeholder="{{ $field['placeholder'] ?? '' }}"
-              class="w-full rounded-lg border-gray-300 focus:border-blue-500 focus:ring-blue-500 text-sm
-                     @error($field['name']) border-red-400 @enderror"
+              class="w-full rounded-lg border text-sm px-3 py-2 resize-y
+                     focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition
+                     @error($field['name']) border-red-400 bg-red-50 @else border-gray-300 bg-white @enderror"
               {{ ($field['required'] ?? false) ? 'required' : '' }}>{{ $value }}</textarea>
     @if(!empty($field['hint']))
-        <p class="mt-1 text-xs text-gray-400">{{ $field['hint'] }}</p>
+        <p class="mt-1.5 text-xs text-gray-400">{{ $field['hint'] }}</p>
     @endif
     @error($field['name'])
-        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
+        <p class="mt-1 text-xs text-red-600 flex items-center gap-1">
+            <i class="fas fa-circle-exclamation text-[10px]"></i>{{ $message }}
+        </p>
     @enderror
 </div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/toggle.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/toggle.blade.php
index 7493c59..c54e953 100644
--- a/app/Modules/Admin/Resources/views/generic-crud/fields/toggle.blade.php
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/toggle.blade.php
@@ -1,21 +1,33 @@
 @php $checked = (bool) old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? false)); @endphp
-<div>
-    <label class="flex items-center gap-3 cursor-pointer">
+<div class="flex items-start gap-4 py-1">
+    {{-- Toggle switch --}}
+    <label class="relative inline-flex items-center cursor-pointer shrink-0 mt-0.5">
         <input type="hidden" name="{{ $field['name'] }}" value="0">
         <input type="checkbox"
                id="{{ $field['name'] }}"
                name="{{ $field['name'] }}"
                value="1"
-               class="rounded border-gray-300 text-blue-600 focus:ring-blue-500 w-4 h-4"
+               class="sr-only peer"
                {{ $checked ? 'checked' : '' }}>
-        <span class="text-sm font-medium text-gray-700">
-            {{ $field['label'] ?? $field['name'] }}
-        </span>
+        <div class="w-10 h-5 bg-gray-200 rounded-full peer-focus:ring-2 peer-focus:ring-blue-400
+                    peer-checked:bg-blue-600 transition-colors duration-200 relative
+                    after:content-[''] after:absolute after:top-0.5 after:left-0.5
+                    after:w-4 after:h-4 after:bg-white after:rounded-full after:shadow
+                    after:transition-transform after:duration-200
+                    peer-checked:after:translate-x-5"></div>
     </label>
-    @if(!empty($field['hint']))
-        <p class="mt-1 ml-7 text-xs text-gray-400">{{ $field['hint'] }}</p>
-    @endif
-    @error($field['name'])
-        <p class="mt-1 text-xs text-red-600">{{ $message }}</p>
-    @enderror
+    <div class="flex-1 min-w-0">
+        <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 cursor-pointer leading-5">
+            {{ $field['label'] ?? $field['name'] }}
+            @if($field['required'] ?? false) <span class="text-red-500 ml-0.5">*</span> @endif
+        </label>
+        @if(!empty($field['hint']))
+            <p class="mt-0.5 text-xs text-gray-400">{{ $field['hint'] }}</p>
+        @endif
+        @error($field['name'])
+            <p class="mt-1 text-xs text-red-600 flex items-center gap-1">
+                <i class="fas fa-circle-exclamation text-[10px]"></i>{{ $message }}
+            </p>
+        @enderror
+    </div>
 </div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/fields/url.blade.php b/app/Modules/Admin/Resources/views/generic-crud/fields/url.blade.php
new file mode 100644
index 0000000..a58006f
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/generic-crud/fields/url.blade.php
@@ -0,0 +1,25 @@
+@php $value = old($field['name'], $record?->{$field['name']} ?? ($field['default'] ?? '')); @endphp
+<div>
+    <label for="{{ $field['name'] }}" class="block text-sm font-medium text-gray-700 mb-1.5">
+        {{ $field['label'] ?? $field['name'] }}
+        @if($field['required'] ?? false) <span class="text-red-500 ml-0.5">*</span> @endif
+    </label>
+    <input type="url"
+           id="{{ $field['name'] }}"
+           name="{{ $field['name'] }}"
+           value="{{ $value }}"
+           placeholder="{{ $field['placeholder'] ?? 'https://' }}"
+           @if(!empty($field['max'])) maxlength="{{ $field['max'] }}" @endif
+           class="w-full rounded-lg border text-sm px-3 py-2
+                  focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition
+                  @error($field['name']) border-red-400 bg-red-50 @else border-gray-300 bg-white @enderror"
+           {{ ($field['required'] ?? false) ? 'required' : '' }}>
+    @if(!empty($field['hint']))
+        <p class="mt-1.5 text-xs text-gray-400">{{ $field['hint'] }}</p>
+    @endif
+    @error($field['name'])
+        <p class="mt-1 text-xs text-red-600 flex items-center gap-1">
+            <i class="fas fa-circle-exclamation text-[10px]"></i>{{ $message }}
+        </p>
+    @enderror
+</div>
diff --git a/app/Modules/Admin/Resources/views/generic-crud/index.blade.php b/app/Modules/Admin/Resources/views/generic-crud/index.blade.php
index 1069485..99d0430 100644
--- a/app/Modules/Admin/Resources/views/generic-crud/index.blade.php
+++ b/app/Modules/Admin/Resources/views/generic-crud/index.blade.php
@@ -3,96 +3,151 @@
 @section('title', $config['title'] ?? 'Manage')
 
 @section('content')
-<header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
-    <div class="flex items-center gap-4">
-        <h1 class="text-2xl font-bold text-gray-800">{{ $config['title'] ?? 'Manage' }}</h1>
+
+{{-- Page header --}}
+<div class="bg-white border-b border-gray-200 px-6 py-4 flex items-center justify-between gap-4 shrink-0">
+    <div>
+        <h1 class="text-xl font-bold text-gray-900">{{ $config['title'] ?? 'Manage' }}</h1>
+        @if(!empty($config['description']))
+            <p class="text-sm text-gray-500 mt-0.5">{{ $config['description'] }}</p>
+        @endif
     </div>
     <a href="{{ route($base . 'create') }}"
-       class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
-        <i class="fas fa-plus mr-1"></i> New Record
+       class="inline-flex items-center gap-2 px-4 py-2 bg-blue-600 text-white text-sm font-medium rounded-lg
+              hover:bg-blue-700 active:bg-blue-800 transition-colors shadow-sm">
+        <i class="fas fa-plus text-xs"></i>
+        New {{ \Illuminate\Support\Str::singular($config['title'] ?? 'Record') }}
     </a>
-</header>
+</div>
 
-<main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+<div class="flex-1 overflow-y-auto bg-gray-50 p-6">
+
+    {{-- Flash messages --}}
     @if(session('success'))
-        <div class="mb-4 p-3 bg-green-50 text-green-700 border border-green-200 rounded-lg flex items-center gap-2">
-            <i class="fas fa-check-circle"></i> {{ session('success') }}
+        <div class="mb-5 flex items-center gap-3 px-4 py-3 bg-green-50 border border-green-200 text-green-800 rounded-lg text-sm">
+            <i class="fas fa-check-circle text-green-500 shrink-0"></i>
+            <span class="flex-1">{{ session('success') }}</span>
         </div>
     @endif
     @if(session('error'))
-        <div class="mb-4 p-3 bg-red-50 text-red-700 border border-red-200 rounded-lg flex items-center gap-2">
-            <i class="fas fa-exclamation-circle"></i> {{ session('error') }}
+        <div class="mb-5 flex items-center gap-3 px-4 py-3 bg-red-50 border border-red-200 text-red-800 rounded-lg text-sm">
+            <i class="fas fa-exclamation-circle text-red-500 shrink-0"></i>
+            {{ session('error') }}
         </div>
     @endif
 
-    <div class="bg-white rounded-lg shadow">
-        <div class="p-6 border-b border-gray-200 flex items-center justify-between gap-4">
-            <h2 class="text-lg font-bold text-gray-800">Records</h2>
-            {{-- Search --}}
-            @if(!empty($config['list']['searchable']))
-            <form method="GET" class="flex items-center gap-2">
-                <input type="text" name="search" value="{{ request('search') }}"
-                       placeholder="Search…"
-                       class="rounded-lg border-gray-300 text-sm focus:border-blue-500 focus:ring-blue-500 w-56">
-                <button type="submit" class="px-3 py-2 bg-gray-100 text-gray-700 rounded-lg hover:bg-gray-200 text-sm">
-                    <i class="fas fa-search"></i>
-                </button>
+    {{-- Table card --}}
+    <div class="bg-white rounded-xl border border-gray-200 shadow-sm overflow-hidden">
+
+        {{-- Toolbar --}}
+        <div class="flex items-center justify-between gap-4 px-5 py-3 border-b border-gray-100">
+            <div class="flex items-center gap-2 text-sm text-gray-500">
+                <span class="font-semibold text-gray-800">{{ $records->total() }}</span>
+                {{ \Illuminate\Support\Str::lower($config['title'] ?? 'records') }}
                 @if(request('search'))
-                <a href="{{ route($base . 'index') }}" class="px-3 py-2 text-gray-400 hover:text-gray-600 text-sm">
-                    <i class="fas fa-times"></i>
-                </a>
+                    <span class="text-gray-400">&mdash; matching <em>"{{ request('search') }}"</em></span>
                 @endif
+            </div>
+
+            @php
+                $searchEnabled = !empty($config['list']['searchable'])
+                    || !empty($config['list']['search_columns']);
+            @endphp
+            @if($searchEnabled)
+            <form method="GET" class="flex items-center gap-2">
+                <div class="relative">
+                    <i class="fas fa-search absolute left-3 top-1/2 -translate-y-1/2 text-gray-400 text-xs pointer-events-none"></i>
+                    <input type="text"
+                           name="search"
+                           value="{{ request('search') }}"
+                           placeholder="Search…"
+                           class="pl-8 pr-8 py-1.5 rounded-lg border border-gray-200 bg-gray-50 text-sm w-52
+                                  focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent transition">
+                    @if(request('search'))
+                        <a href="{{ route($base . 'index') }}"
+                           class="absolute right-2.5 top-1/2 -translate-y-1/2 text-gray-400 hover:text-gray-600 transition"
+                           title="Clear">
+                            <i class="fas fa-times text-xs"></i>
+                        </a>
+                    @endif
+                </div>
+                <button type="submit"
+                        class="px-3 py-1.5 bg-gray-100 hover:bg-gray-200 text-gray-700 text-sm font-medium rounded-lg transition">
+                    Search
+                </button>
             </form>
             @endif
         </div>
 
+        {{-- Table --}}
         <div class="overflow-x-auto">
             <table class="w-full text-sm">
                 <thead>
-                    <tr class="border-b border-gray-100 bg-gray-50">
+                    <tr class="bg-gray-50/80 border-b border-gray-100">
                         @foreach($config['list']['columns'] as $col)
-                            <th class="px-6 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider">
+                            <th class="px-5 py-3 text-left text-xs font-semibold text-gray-500 uppercase tracking-wider whitespace-nowrap">
                                 {{ $col['label'] ?? $col['field'] }}
                             </th>
                         @endforeach
-                        <th class="px-6 py-3 text-right text-xs font-semibold text-gray-500 uppercase tracking-wider">Actions</th>
+                        <th class="px-5 py-3 w-20"></th>
                     </tr>
                 </thead>
-                <tbody class="divide-y divide-gray-100">
+                <tbody class="divide-y divide-gray-50">
                     @forelse($records as $record)
-                    <tr class="hover:bg-gray-50 transition-colors">
+                    <tr class="hover:bg-blue-50/20 transition-colors">
                         @foreach($config['list']['columns'] as $col)
-                            <td class="px-6 py-4 text-gray-700">
+                            <td class="px-5 py-3.5 text-gray-700 align-middle">
                                 @php
-                                    $value = $record->{$col['field']} ?? null;
-                                    $format = $col['format'] ?? null;
+                                    $cellValue  = $record->{$col['field']} ?? null;
+                                    $cellFormat = $col['format'] ?? null;
                                 @endphp
-                                @if($format === 'date' && $value)
-                                    {{ \Carbon\Carbon::parse($value)->format('M d, Y') }}
-                                @elseif($format === 'datetime' && $value)
-                                    {{ \Carbon\Carbon::parse($value)->format('M d, Y H:i') }}
-                                @elseif($format === 'boolean')
-                                    <span class="px-2 py-0.5 rounded-full text-xs font-medium {{ $value ? 'bg-green-100 text-green-700' : 'bg-gray-100 text-gray-500' }}">
-                                        {{ $value ? 'Yes' : 'No' }}
+                                @if($cellFormat === 'date' && $cellValue)
+                                    {{ \Carbon\Carbon::parse($cellValue)->format('M d, Y') }}
+                                @elseif($cellFormat === 'datetime' && $cellValue)
+                                    {{ \Carbon\Carbon::parse($cellValue)->format('M d, Y · H:i') }}
+                                @elseif($cellFormat === 'boolean')
+                                    @if($cellValue)
+                                        <span class="inline-flex items-center gap-1 px-2 py-0.5 rounded-full text-xs font-medium bg-green-100 text-green-700">
+                                            <i class="fas fa-check text-[9px]"></i> Yes
+                                        </span>
+                                    @else
+                                        <span class="inline-flex items-center gap-1 px-2 py-0.5 rounded-full text-xs font-medium bg-gray-100 text-gray-400">
+                                            <i class="fas fa-minus text-[9px]"></i> No
+                                        </span>
+                                    @endif
+                                @elseif($cellFormat === 'image' && $cellValue)
+                                    <img src="{{ asset('storage/' . $cellValue) }}"
+                                         class="h-8 w-8 rounded-md object-cover border border-gray-200" alt="">
+                                @elseif($cellFormat === 'badge' && $cellValue)
+                                    <span class="px-2 py-0.5 rounded-md text-xs font-medium bg-blue-50 text-blue-700">{{ $cellValue }}</span>
+                                @elseif($cellFormat === 'truncate')
+                                    <span class="line-clamp-1 max-w-xs text-gray-600" title="{{ $cellValue }}">
+                                        {{ \Illuminate\Support\Str::limit($cellValue, 60) }}
                                     </span>
                                 @else
-                                    {{ $value }}
+                                    <span class="{{ $cellValue === null || $cellValue === '' ? 'text-gray-300' : '' }}">
+                                        {{ $cellValue ?? '—' }}
+                                    </span>
                                 @endif
                             </td>
                         @endforeach
-                        <td class="px-6 py-4 text-right">
-                            <div class="flex items-center justify-end gap-2">
+                        <td class="px-5 py-3.5 align-middle">
+                            <div class="flex items-center justify-end gap-0.5">
                                 <a href="{{ route($base . 'edit', $record->getKey()) }}"
-                                   class="px-3 py-1 bg-gray-100 text-gray-700 rounded hover:bg-gray-200 text-xs font-medium">
-                                    Edit
+                                   title="Edit"
+                                   class="w-8 h-8 inline-flex items-center justify-center rounded-lg
+                                          text-gray-400 hover:text-blue-600 hover:bg-blue-50 transition">
+                                    <i class="fas fa-pencil text-xs"></i>
                                 </a>
                                 <form method="POST"
                                       action="{{ route($base . 'destroy', $record->getKey()) }}"
-                                      onsubmit="return confirm('Delete this record?')">
+                                      onsubmit="return confirm('Delete this record? This cannot be undone.')">
                                     @csrf @method('DELETE')
                                     <button type="submit"
-                                            class="px-3 py-1 bg-red-50 text-red-700 rounded hover:bg-red-100 text-xs font-medium">
-                                        Delete
+                                            title="Delete"
+                                            class="w-8 h-8 inline-flex items-center justify-center rounded-lg
+                                                   text-gray-400 hover:text-red-600 hover:bg-red-50 transition">
+                                        <i class="fas fa-trash-alt text-xs"></i>
                                     </button>
                                 </form>
                             </div>
@@ -101,9 +156,25 @@ class="px-3 py-1 bg-red-50 text-red-700 rounded hover:bg-red-100 text-xs font-me
                     @empty
                     <tr>
                         <td colspan="{{ count($config['list']['columns']) + 1 }}"
-                            class="px-6 py-12 text-center text-gray-400">
-                            <i class="fas fa-inbox text-3xl mb-2 block"></i>
-                            No records found.
+                            class="px-6 py-16 text-center">
+                            <div class="inline-flex flex-col items-center gap-3 text-gray-400">
+                                <div class="w-14 h-14 rounded-full bg-gray-100 flex items-center justify-center">
+                                    <i class="fas fa-database text-xl text-gray-300"></i>
+                                </div>
+                                <div>
+                                    <p class="font-medium text-gray-500 text-sm">No records found</p>
+                                    @if(request('search'))
+                                        <p class="text-xs mt-1 text-gray-400">
+                                            Try a different search term or
+                                            <a href="{{ route($base . 'index') }}" class="text-blue-500 hover:underline">clear the filter</a>.
+                                        </p>
+                                    @else
+                                        <p class="text-xs mt-1 text-gray-400">
+                                            <a href="{{ route($base . 'create') }}" class="text-blue-500 hover:underline">Create the first record</a>
+                                        </p>
+                                    @endif
+                                </div>
+                            </div>
                         </td>
                     </tr>
                     @endforelse
@@ -111,11 +182,17 @@ class="px-6 py-12 text-center text-gray-400">
             </table>
         </div>
 
+        {{-- Pagination --}}
         @if($records->hasPages())
-        <div class="px-6 py-4 border-t border-gray-100">
+        <div class="px-5 py-3 border-t border-gray-100 flex items-center justify-between gap-4 text-xs text-gray-500">
+            <span>
+                Showing {{ $records->firstItem() }}–{{ $records->lastItem() }} of {{ $records->total() }}
+            </span>
             {{ $records->links() }}
         </div>
         @endif
+
     </div>
-</main>
+</div>
+
 @endsection
diff --git a/app/Modules/Example/Http/routes.php b/app/Modules/Example/Http/routes.php
index 6ab1818..72224e7 100644
--- a/app/Modules/Example/Http/routes.php
+++ b/app/Modules/Example/Http/routes.php
@@ -1,5 +1,6 @@
 <?php
 
 use Illuminate\Support\Facades\Route;
+use Modules\Example\Http\Controllers\ExampleController;
 
-Route::get('/example', 'ExampleController@index');
+Route::get('/example', [ExampleController::class, 'index']);
diff --git a/app/Modules/Store/admin-crud.json b/app/Modules/Store/admin-crud.json
index 820d063..ae59229 100644
--- a/app/Modules/Store/admin-crud.json
+++ b/app/Modules/Store/admin-crud.json
@@ -2,14 +2,13 @@
     "title": "Store Products",
     "model": "Modules\\Store\\Domain\\Models\\StoreProduct",
     "list": {
-        "searchable": true,
-        "search_columns": ["name", "key", "type"],
+        "searchable": ["name", "key", "type"],
         "order_by": "sort_order",
         "order_dir": "asc",
         "columns": [
             { "field": "sort_order", "label": "#" },
             { "field": "name",       "label": "Product" },
-            { "field": "key",        "label": "Key" },
+            { "field": "type",       "label": "Type" },
             { "field": "cost",       "label": "Cost (DP)" },
             { "field": "active",     "label": "Active", "format": "boolean" }
         ]
@@ -32,7 +31,7 @@
                         "type": "text",
                         "required": true,
                         "placeholder": "e.g. rename",
-                        "help": "Unique slug used for SOAP commands."
+                        "hint": "Unique slug used for SOAP commands."
                     },
                     {
                         "name": "description",
@@ -55,10 +54,19 @@
                     {
                         "name": "type",
                         "label": "SOAP Type",
-                        "type": "text",
+                        "type": "enum",
                         "required": false,
-                        "placeholder": "e.g. character_rename",
-                        "help": "SOAP command type to execute on purchase."
+                        "hint": "SOAP command type to execute on purchase.",
+                        "options": [
+                            { "value": "character_rename", "label": "Character Rename" },
+                            { "value": "character_customize", "label": "Character Customize" },
+                            { "value": "character_race_change", "label": "Race Change" },
+                            { "value": "character_class_change", "label": "Class Change" },
+                            { "value": "level_boost", "label": "Level Boost" },
+                            { "value": "gold", "label": "Gold" },
+                            { "value": "item", "label": "Item" },
+                            { "value": "custom", "label": "Custom" }
+                        ]
                     },
                     {
                         "name": "sort_order",
@@ -70,14 +78,14 @@
                     {
                         "name": "requires_character",
                         "label": "Requires Character",
-                        "type": "checkbox",
-                        "help": "If checked, the player must select a character during purchase."
+                        "type": "toggle",
+                        "hint": "If checked, the player must select a character during purchase."
                     },
                     {
                         "name": "active",
                         "label": "Active",
-                        "type": "checkbox",
-                        "help": "Inactive products are hidden in the store."
+                        "type": "toggle",
+                        "hint": "Inactive products are hidden in the store."
                     }
                 ]
             }
diff --git a/app/Services/ModuleCrudService.php b/app/Services/ModuleCrudService.php
index 33e0cfe..22d0b39 100644
--- a/app/Services/ModuleCrudService.php
+++ b/app/Services/ModuleCrudService.php
@@ -86,15 +86,28 @@ public static function paginate(array $config, ?string $search = null): \Illumin
         $model = self::resolveModel($config);
         $query = $model->newQuery();
 
-        $searchable = $config['list']['searchable'] ?? [];
-        if ($search !== null && $search !== '' && count($searchable) > 0) {
-            $query->where(function ($q) use ($search, $searchable) {
-                foreach ($searchable as $column) {
+        // Support both formats:
+        //   "searchable": ["col1", "col2"]       — array of columns
+        //   "searchable": true, "search_columns": ["col1", "col2"]  — legacy boolean + separate key
+        $searchableCfg = $config['list']['searchable'] ?? [];
+        $searchColumns = is_array($searchableCfg)
+            ? $searchableCfg
+            : (is_array($config['list']['search_columns'] ?? null) ? $config['list']['search_columns'] : []);
+
+        if ($search !== null && $search !== '' && count($searchColumns) > 0) {
+            $query->where(function ($q) use ($search, $searchColumns) {
+                foreach ($searchColumns as $column) {
                     $q->orWhere($column, 'like', '%' . $search . '%');
                 }
             });
         }
 
+        $orderBy  = (string) ($config['list']['order_by'] ?? '');
+        $orderDir = strtolower((string) ($config['list']['order_dir'] ?? 'asc')) === 'desc' ? 'desc' : 'asc';
+        if ($orderBy !== '') {
+            $query->orderBy($orderBy, $orderDir);
+        }
+
         $perPage = (int) ($config['list']['per_page'] ?? 15);
 
         return $query->paginate($perPage);
@@ -168,21 +181,50 @@ public static function flushCache(): void
         self::$cache = [];
     }
 
+    private static function enumRules(array $field): array
+    {
+        $options = $field['options'] ?? [];
+        $values = array_map(
+            fn($opt) => is_array($opt) ? (string) ($opt['value'] ?? '') : (string) $opt,
+            $options
+        );
+
+        if (empty($values)) {
+            return ['string'];
+        }
+
+        return ['string', 'in:' . implode(',', $values)];
+    }
+
     private static function typeRules(array $field, bool $isUpdate): array
     {
-        return match ($field['type'] ?? 'text') {
-            'text', 'slug'        => ['string', 'max:255'],
-            'textarea', 'richtext'=> ['string'],
-            'number'              => ['numeric'],
-            'toggle'              => ['boolean'],
-            'date'                => ['date'],
-            'datetime'            => ['date'],
-            'email'               => ['email', 'max:255'],
-            'image'               => $isUpdate ? ['nullable', 'image', 'max:2048'] : ['image', 'max:2048'],
-            'file'                => $isUpdate ? ['nullable', 'file', 'max:10240'] : ['file', 'max:10240'],
-            'select'              => [],
-            'relation'            => ['integer'],
-            default               => [],
+        $rules = match ($field['type'] ?? 'text') {
+            'text', 'slug'         => ['string', 'max:' . (int) ($field['max'] ?? 255)],
+            'textarea', 'richtext' => ['string'],
+            'number'               => ['numeric'],
+            'toggle', 'checkbox'   => ['boolean'],
+            'date'                 => ['date'],
+            'datetime'             => ['date'],
+            'email'                => ['email', 'max:' . (int) ($field['max'] ?? 255)],
+            'url'                  => ['url',   'max:' . (int) ($field['max'] ?? 255)],
+            'image'                => $isUpdate ? ['nullable', 'image', 'max:2048'] : ['image', 'max:2048'],
+            'file'                 => $isUpdate ? ['nullable', 'file',  'max:10240'] : ['file', 'max:10240'],
+            'select'               => [],
+            'relation'             => ['integer'],
+            'enum'                 => self::enumRules($field),
+            default                => [],
         };
+
+        // Append min/max constraints from config for numeric types
+        if (in_array($field['type'] ?? '', ['number', 'text', 'textarea', 'email', 'url', 'slug'], true)) {
+            if (isset($field['min']) && is_numeric($field['min'])) {
+                $rules[] = ($field['type'] === 'number') ? 'min:' . $field['min'] : 'min:' . (int) $field['min'];
+            }
+            if (isset($field['max']) && is_numeric($field['max']) && ($field['type'] === 'number')) {
+                $rules[] = 'max:' . $field['max'];
+            }
+        }
+
+        return $rules;
     }
 }
diff --git a/app/Services/ModuleRegistryService.php b/app/Services/ModuleRegistryService.php
index 69c8649..75d3784 100644
--- a/app/Services/ModuleRegistryService.php
+++ b/app/Services/ModuleRegistryService.php
@@ -3,36 +3,30 @@
 namespace App\Services;
 
 use App\Models\ManagedModule;
-use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\Facades\Schema;
 
 class ModuleRegistryService
 {
-    private const ADMIN_MENU_CACHE_KEY = 'module_registry.admin_menu_items';
-    private const ADMIN_MENU_CACHE_TTL = 300;
-
     private static ?array $stateCache = null;
     private static ?array $manifestCache = null;
 
     public static function getAdminMenuItems(): array
     {
-        return Cache::remember(self::ADMIN_MENU_CACHE_KEY, self::ADMIN_MENU_CACHE_TTL, static function (): array {
-            $items = [];
-
-            foreach (self::getEnabledModules() as $module) {
-                $menu = $module['admin_menu'] ?? null;
-                if (!is_array($menu) || empty($menu)) {
-                    continue;
-                }
+        $items = [];
 
-                $items[] = array_merge($menu, ['module' => $module['folder']]);
+        foreach (self::getEnabledModules() as $module) {
+            $menu = $module['admin_menu'] ?? null;
+            if (!is_array($menu) || empty($menu)) {
+                continue;
             }
 
-            usort($items, static fn (array $a, array $b): int => ($a['order'] ?? 0) <=> ($b['order'] ?? 0));
+            $items[] = array_merge($menu, ['module' => $module['folder']]);
+        }
+
+        usort($items, static fn (array $a, array $b): int => ($a['order'] ?? 0) <=> ($b['order'] ?? 0));
 
-            return $items;
-        });
+        return $items;
     }
 
     public static function getEnabledProviders(): array
@@ -71,7 +65,19 @@ public static function getModule(string $module): ?array
 
         $manifest = self::loadManifest();
 
-        return $manifest[$module] ?? null;
+        // Exact match first
+        if (isset($manifest[$module])) {
+            return $manifest[$module];
+        }
+
+        // Case-insensitive fallback (e.g. "store" → "Store")
+        foreach ($manifest as $key => $value) {
+            if (strcasecmp($key, $module) === 0) {
+                return $value;
+            }
+        }
+
+        return null;
     }
 
     public static function getModuleState(string $module, ?array $fallbackConfig = null): array
@@ -189,7 +195,6 @@ public static function flushCache(): void
     {
         self::$stateCache = null;
         self::$manifestCache = null;
-        Cache::forget(self::ADMIN_MENU_CACHE_KEY);
     }
 
     private static function loadManifest(): array

From bb83633a62f07fd4c14f0768cc601241978402b0 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 17 May 2026 03:30:46 +0200
Subject: [PATCH 113/132] feat(admin): add advanced settings for database
 seeders and cache management

---
 .../Controllers/AdminAdvancedController.php   |  70 +++
 app/Modules/Admin/Http/routes.php             |   4 +
 .../Admin/Resources/lang/en/settings.php      |  43 +-
 .../Admin/Resources/lang/es/settings.php      |  43 +-
 .../views/settings/advanced.blade.php         | 141 +++++-
 .../Resources/views/settings/index.blade.php  |  16 +
 docs/module-crud-system.md                    | 430 ------------------
 7 files changed, 305 insertions(+), 442 deletions(-)
 create mode 100644 app/Modules/Admin/Http/Controllers/AdminAdvancedController.php
 delete mode 100644 docs/module-crud-system.md

diff --git a/app/Modules/Admin/Http/Controllers/AdminAdvancedController.php b/app/Modules/Admin/Http/Controllers/AdminAdvancedController.php
new file mode 100644
index 0000000..b8727af
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/AdminAdvancedController.php
@@ -0,0 +1,70 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Artisan;
+
+class AdminAdvancedController extends Controller
+{
+    private const ALLOWED_SEEDERS = [
+        'roles_permissions' => \Database\Seeders\RolesAndPermissionsSeeder::class,
+        'forums'            => \Database\Seeders\ForumsSeeder::class,
+        'donation_plans'    => \Database\Seeders\DonationPlansSeeder::class,
+        'all'               => \Database\Seeders\DatabaseSeeder::class,
+    ];
+
+    private const ALLOWED_CACHES = [
+        'config' => 'config:clear',
+        'routes' => 'route:clear',
+        'views'  => 'view:clear',
+        'app'    => 'cache:clear',
+        'all'    => 'optimize:clear',
+    ];
+
+    public function runSeeder(Request $request)
+    {
+        $key = $request->input('seeder');
+
+        if (!array_key_exists($key, self::ALLOWED_SEEDERS)) {
+            return back()->with('advanced_error', __('admin::settings.advanced.seeder_invalid'));
+        }
+
+        try {
+            Artisan::call('db:seed', [
+                '--class' => self::ALLOWED_SEEDERS[$key],
+                '--force' => true,
+            ]);
+        } catch (\Throwable $e) {
+            return redirect()
+                ->route('admin.settings.index', ['view' => 'advanced'])
+                ->with('advanced_error', __('admin::settings.advanced.seeder_failed', ['error' => $e->getMessage()]));
+        }
+
+        return redirect()
+            ->route('admin.settings.index', ['view' => 'advanced'])
+            ->with('advanced_success', __('admin::settings.advanced.seeder_success'));
+    }
+
+    public function clearCache(Request $request)
+    {
+        $key = $request->input('cache');
+
+        if (!array_key_exists($key, self::ALLOWED_CACHES)) {
+            return back()->with('advanced_error', __('admin::settings.advanced.cache_invalid'));
+        }
+
+        try {
+            Artisan::call(self::ALLOWED_CACHES[$key]);
+        } catch (\Throwable $e) {
+            return redirect()
+                ->route('admin.settings.index', ['view' => 'advanced'])
+                ->with('advanced_error', __('admin::settings.advanced.cache_failed', ['error' => $e->getMessage()]));
+        }
+
+        return redirect()
+            ->route('admin.settings.index', ['view' => 'advanced'])
+            ->with('advanced_success', __('admin::settings.advanced.cache_success'));
+    }
+}
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index 0d525b9..7dacfa9 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -42,6 +42,10 @@
         Route::get('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'index'])->middleware('permission:manage.settings')->name('admin.settings.index');
         Route::post('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'store'])->middleware('permission:manage.settings')->name('admin.settings.store');
 
+        // Advanced actions
+        Route::post('/settings/advanced/seeder', [\Modules\Admin\Http\Controllers\AdminAdvancedController::class, 'runSeeder'])->middleware('permission:manage.settings')->name('admin.settings.advanced.seeder');
+        Route::post('/settings/advanced/cache', [\Modules\Admin\Http\Controllers\AdminAdvancedController::class, 'clearCache'])->middleware('permission:manage.settings')->name('admin.settings.advanced.cache');
+
         // Realm Management
         Route::get('/realms', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'index'])->middleware('permission:manage.realms')->name('admin.realms.index');
         Route::get('/realms/create', [\Modules\Admin\Http\Controllers\RealmManagementController::class, 'create'])->middleware('permission:manage.realms')->name('admin.realms.create');
diff --git a/app/Modules/Admin/Resources/lang/en/settings.php b/app/Modules/Admin/Resources/lang/en/settings.php
index c438f11..a8ff4f6 100644
--- a/app/Modules/Admin/Resources/lang/en/settings.php
+++ b/app/Modules/Admin/Resources/lang/en/settings.php
@@ -50,9 +50,46 @@
     ],
 
     'advanced' => [
-        'title' => 'Advanced Settings',
-        'description' => 'Configure advanced settings',
-        'under_construction' => 'This section is under construction.',
+        'title'       => 'Advanced Settings',
+        'description' => 'Database seeders, cache management, and other advanced operations.',
+
+        // Seeders
+        'seeders_title'       => 'Database Seeders',
+        'seeders_description' => 'Re-run seeders to synchronise default data. Seeders use firstOrCreate — they will not overwrite existing records.',
+        'seeder_roles_title'   => 'Roles & Permissions',
+        'seeder_roles_desc'    => 'Sync all roles and permissions to the latest definitions.',
+        'seeder_forums_title'  => 'Forums',
+        'seeder_forums_desc'   => 'Seed default forum categories and sections.',
+        'seeder_donations_title' => 'Donation Plans',
+        'seeder_donations_desc'  => 'Seed default donation/store plans.',
+        'seeder_all_title'    => 'Run All Seeders',
+        'seeder_all_desc'     => 'Run the full DatabaseSeeder (all of the above).',
+        'run'                 => 'Run',
+        'run_all'             => 'Run All',
+        'confirm_run'         => 'Are you sure you want to run this seeder?',
+        'confirm_run_all'     => 'Are you sure you want to run ALL seeders?',
+        'seeder_success'      => 'Seeder ran successfully.',
+        'seeder_failed'       => 'Seeder failed: :error',
+        'seeder_invalid'      => 'Invalid seeder selected.',
+
+        // Cache
+        'cache_title'       => 'Cache Management',
+        'cache_description' => 'Clear compiled caches. Use this after configuration or code changes.',
+        'cache_config_title' => 'Config Cache',
+        'cache_config_desc'  => 'Clear the compiled configuration cache.',
+        'cache_routes_title' => 'Routes Cache',
+        'cache_routes_desc'  => 'Clear the compiled routes cache.',
+        'cache_views_title'  => 'Views Cache',
+        'cache_views_desc'   => 'Clear compiled Blade view files.',
+        'cache_app_title'    => 'Application Cache',
+        'cache_app_desc'     => 'Clear the general application cache.',
+        'cache_all_title'    => 'Clear All Caches',
+        'cache_all_desc'     => 'Run optimize:clear — clears all caches at once.',
+        'clear'              => 'Clear',
+        'confirm_cache'      => 'Are you sure you want to clear this cache?',
+        'cache_success'      => 'Cache cleared successfully.',
+        'cache_failed'       => 'Cache clear failed: :error',
+        'cache_invalid'      => 'Invalid cache type selected.',
     ],
 
     'maintenance' => [
diff --git a/app/Modules/Admin/Resources/lang/es/settings.php b/app/Modules/Admin/Resources/lang/es/settings.php
index db42612..fc2158e 100644
--- a/app/Modules/Admin/Resources/lang/es/settings.php
+++ b/app/Modules/Admin/Resources/lang/es/settings.php
@@ -50,9 +50,46 @@
     ],
 
     'advanced' => [
-        'title' => 'Configuración avanzada',
-        'description' => 'Configura las opciones avanzadas',
-        'under_construction' => 'Esta sección está en construcción.',
+        'title'       => 'Configuración avanzada',
+        'description' => 'Seeders de base de datos, gestión de caché y otras operaciones avanzadas.',
+
+        // Seeders
+        'seeders_title'       => 'Seeders de base de datos',
+        'seeders_description' => 'Vuelve a ejecutar los seeders para sincronizar los datos por defecto. Los seeders usan firstOrCreate — no sobreescribirán registros existentes.',
+        'seeder_roles_title'   => 'Roles y permisos',
+        'seeder_roles_desc'    => 'Sincroniza todos los roles y permisos con las últimas definiciones.',
+        'seeder_forums_title'  => 'Foros',
+        'seeder_forums_desc'   => 'Crea las categorías y secciones de foro por defecto.',
+        'seeder_donations_title' => 'Planes de donación',
+        'seeder_donations_desc'  => 'Crea los planes de donación/tienda por defecto.',
+        'seeder_all_title'    => 'Ejecutar todos los seeders',
+        'seeder_all_desc'     => 'Ejecuta el DatabaseSeeder completo (todos los anteriores).',
+        'run'                 => 'Ejecutar',
+        'run_all'             => 'Ejecutar todo',
+        'confirm_run'         => '¿Estás seguro de que quieres ejecutar este seeder?',
+        'confirm_run_all'     => '¿Estás seguro de que quieres ejecutar TODOS los seeders?',
+        'seeder_success'      => 'Seeder ejecutado correctamente.',
+        'seeder_failed'       => 'El seeder falló: :error',
+        'seeder_invalid'      => 'Seeder seleccionado no válido.',
+
+        // Cache
+        'cache_title'       => 'Gestión de caché',
+        'cache_description' => 'Limpia las cachés compiladas. Úsalo después de cambios de configuración o código.',
+        'cache_config_title' => 'Caché de configuración',
+        'cache_config_desc'  => 'Limpia la caché de configuración compilada.',
+        'cache_routes_title' => 'Caché de rutas',
+        'cache_routes_desc'  => 'Limpia la caché de rutas compiladas.',
+        'cache_views_title'  => 'Caché de vistas',
+        'cache_views_desc'   => 'Limpia los archivos Blade compilados.',
+        'cache_app_title'    => 'Caché de la aplicación',
+        'cache_app_desc'     => 'Limpia la caché general de la aplicación.',
+        'cache_all_title'    => 'Limpiar todo',
+        'cache_all_desc'     => 'Ejecuta optimize:clear — limpia todas las cachés a la vez.',
+        'clear'              => 'Limpiar',
+        'confirm_cache'      => '¿Estás seguro de que quieres limpiar esta caché?',
+        'cache_success'      => 'Caché limpiada correctamente.',
+        'cache_failed'       => 'Error al limpiar la caché: :error',
+        'cache_invalid'      => 'Tipo de caché seleccionado no válido.',
     ],
 
     'maintenance' => [
diff --git a/app/Modules/Admin/Resources/views/settings/advanced.blade.php b/app/Modules/Admin/Resources/views/settings/advanced.blade.php
index 560434e..e16cc35 100644
--- a/app/Modules/Admin/Resources/views/settings/advanced.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/advanced.blade.php
@@ -1,13 +1,142 @@
 @extends('admin::settings.index')
 
 @section('settings_content')
-<div class="bg-white rounded-lg shadow">
-    <div class="p-6 border-b border-gray-200">
-        <h2 class="text-xl font-bold text-gray-800">{{ __('admin::settings.advanced.title') }}</h2>
-        <p class="text-sm text-gray-600 mt-1">{{ __('admin::settings.advanced.description') }}</p>
+<div class="space-y-6">
+
+    {{-- Seeders --}}
+    <div class="bg-white rounded-lg shadow">
+        <div class="p-6 border-b border-gray-200">
+            <h2 class="text-lg font-bold text-gray-800 flex items-center gap-2">
+                <i class="fas fa-database text-indigo-500"></i>
+                {{ __('admin::settings.advanced.seeders_title') }}
+            </h2>
+            <p class="text-sm text-gray-500 mt-1">{{ __('admin::settings.advanced.seeders_description') }}</p>
+        </div>
+        <div class="p-6 grid grid-cols-1 md:grid-cols-2 gap-4">
+
+            {{-- Roles & Permissions --}}
+            <div class="border border-gray-200 rounded-lg p-4 flex items-start gap-4">
+                <div class="flex-shrink-0 w-10 h-10 bg-purple-100 rounded-lg flex items-center justify-center">
+                    <i class="fas fa-shield-alt text-purple-600"></i>
+                </div>
+                <div class="flex-1 min-w-0">
+                    <p class="font-semibold text-gray-800 text-sm">{{ __('admin::settings.advanced.seeder_roles_title') }}</p>
+                    <p class="text-xs text-gray-500 mt-0.5">{{ __('admin::settings.advanced.seeder_roles_desc') }}</p>
+                </div>
+                <button form="seeder-roles" type="submit"
+                    class="flex-shrink-0 px-3 py-1.5 bg-indigo-600 text-white text-xs font-medium rounded-lg hover:bg-indigo-700 flex items-center gap-1"
+                    onclick="return confirm('{{ __('admin::settings.advanced.confirm_run') }}')">
+                    <i class="fas fa-play"></i> {{ __('admin::settings.advanced.run') }}
+                </button>
+            </div>
+
+            {{-- Forums --}}
+            <div class="border border-gray-200 rounded-lg p-4 flex items-start gap-4">
+                <div class="flex-shrink-0 w-10 h-10 bg-blue-100 rounded-lg flex items-center justify-center">
+                    <i class="fas fa-comments text-blue-600"></i>
+                </div>
+                <div class="flex-1 min-w-0">
+                    <p class="font-semibold text-gray-800 text-sm">{{ __('admin::settings.advanced.seeder_forums_title') }}</p>
+                    <p class="text-xs text-gray-500 mt-0.5">{{ __('admin::settings.advanced.seeder_forums_desc') }}</p>
+                </div>
+                <button form="seeder-forums" type="submit"
+                    class="flex-shrink-0 px-3 py-1.5 bg-indigo-600 text-white text-xs font-medium rounded-lg hover:bg-indigo-700 flex items-center gap-1"
+                    onclick="return confirm('{{ __('admin::settings.advanced.confirm_run') }}')">
+                    <i class="fas fa-play"></i> {{ __('admin::settings.advanced.run') }}
+                </button>
+            </div>
+
+            {{-- Donation Plans --}}
+            <div class="border border-gray-200 rounded-lg p-4 flex items-start gap-4">
+                <div class="flex-shrink-0 w-10 h-10 bg-green-100 rounded-lg flex items-center justify-center">
+                    <i class="fas fa-donate text-green-600"></i>
+                </div>
+                <div class="flex-1 min-w-0">
+                    <p class="font-semibold text-gray-800 text-sm">{{ __('admin::settings.advanced.seeder_donations_title') }}</p>
+                    <p class="text-xs text-gray-500 mt-0.5">{{ __('admin::settings.advanced.seeder_donations_desc') }}</p>
+                </div>
+                <button form="seeder-donations" type="submit"
+                    class="flex-shrink-0 px-3 py-1.5 bg-indigo-600 text-white text-xs font-medium rounded-lg hover:bg-indigo-700 flex items-center gap-1"
+                    onclick="return confirm('{{ __('admin::settings.advanced.confirm_run') }}')">
+                    <i class="fas fa-play"></i> {{ __('admin::settings.advanced.run') }}
+                </button>
+            </div>
+
+            {{-- All Seeders --}}
+            <div class="border border-orange-200 bg-orange-50 rounded-lg p-4 flex items-start gap-4">
+                <div class="flex-shrink-0 w-10 h-10 bg-orange-100 rounded-lg flex items-center justify-center">
+                    <i class="fas fa-layer-group text-orange-600"></i>
+                </div>
+                <div class="flex-1 min-w-0">
+                    <p class="font-semibold text-gray-800 text-sm">{{ __('admin::settings.advanced.seeder_all_title') }}</p>
+                    <p class="text-xs text-gray-500 mt-0.5">{{ __('admin::settings.advanced.seeder_all_desc') }}</p>
+                </div>
+                <button form="seeder-all" type="submit"
+                    class="flex-shrink-0 px-3 py-1.5 bg-orange-600 text-white text-xs font-medium rounded-lg hover:bg-orange-700 flex items-center gap-1"
+                    onclick="return confirm('{{ __('admin::settings.advanced.confirm_run_all') }}')">
+                    <i class="fas fa-play"></i> {{ __('admin::settings.advanced.run_all') }}
+                </button>
+            </div>
+
+        </div>
     </div>
-    <div class="p-6">
-        <p class="text-gray-500 italic">{{ __('admin::settings.advanced.under_construction') }}</p>
+
+    {{-- Cache Management --}}
+    <div class="bg-white rounded-lg shadow">
+        <div class="p-6 border-b border-gray-200">
+            <h2 class="text-lg font-bold text-gray-800 flex items-center gap-2">
+                <i class="fas fa-broom text-yellow-500"></i>
+                {{ __('admin::settings.advanced.cache_title') }}
+            </h2>
+            <p class="text-sm text-gray-500 mt-1">{{ __('admin::settings.advanced.cache_description') }}</p>
+        </div>
+        <div class="p-6 grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-4">
+
+            @php
+            $cacheItems = [
+                ['key' => 'config',  'icon' => 'fa-cog',        'color' => 'gray',   'form' => 'cache-config'],
+                ['key' => 'routes',  'icon' => 'fa-route',      'color' => 'blue',   'form' => 'cache-routes'],
+                ['key' => 'views',   'icon' => 'fa-eye',        'color' => 'teal',   'form' => 'cache-views'],
+                ['key' => 'app',     'icon' => 'fa-memory',     'color' => 'purple', 'form' => 'cache-app'],
+                ['key' => 'all',     'icon' => 'fa-trash-alt',  'color' => 'red',    'form' => 'cache-all'],
+            ];
+            @endphp
+
+            @foreach($cacheItems as $item)
+            <div class="border border-gray-200 rounded-lg p-4 flex items-center gap-3">
+                <div class="flex-shrink-0 w-9 h-9 bg-{{ $item['color'] }}-100 rounded-lg flex items-center justify-center">
+                    <i class="fas {{ $item['icon'] }} text-{{ $item['color'] }}-600 text-sm"></i>
+                </div>
+                <div class="flex-1 min-w-0">
+                    <p class="font-semibold text-gray-800 text-sm">{{ __('admin::settings.advanced.cache_' . $item['key'] . '_title') }}</p>
+                    <p class="text-xs text-gray-400">{{ __('admin::settings.advanced.cache_' . $item['key'] . '_desc') }}</p>
+                </div>
+                <button form="{{ $item['form'] }}" type="submit"
+                    class="flex-shrink-0 px-2.5 py-1.5 text-xs font-medium rounded-lg border border-gray-300 text-gray-700 hover:bg-gray-100 flex items-center gap-1"
+                    onclick="return confirm('{{ __('admin::settings.advanced.confirm_cache') }}')">
+                    <i class="fas fa-trash text-xs"></i> {{ __('admin::settings.advanced.clear') }}
+                </button>
+            </div>
+            @endforeach
+
+        </div>
     </div>
+
 </div>
 @endsection
+
+@push('after_settings_form')
+{{-- Seeder forms (outside main settings form to avoid nesting) --}}
+<form id="seeder-roles"     method="POST" action="{{ route('admin.settings.advanced.seeder') }}">@csrf<input type="hidden" name="seeder" value="roles_permissions"></form>
+<form id="seeder-forums"    method="POST" action="{{ route('admin.settings.advanced.seeder') }}">@csrf<input type="hidden" name="seeder" value="forums"></form>
+<form id="seeder-donations" method="POST" action="{{ route('admin.settings.advanced.seeder') }}">@csrf<input type="hidden" name="seeder" value="donation_plans"></form>
+<form id="seeder-all"       method="POST" action="{{ route('admin.settings.advanced.seeder') }}">@csrf<input type="hidden" name="seeder" value="all"></form>
+
+{{-- Cache forms --}}
+<form id="cache-config" method="POST" action="{{ route('admin.settings.advanced.cache') }}">@csrf<input type="hidden" name="cache" value="config"></form>
+<form id="cache-routes" method="POST" action="{{ route('admin.settings.advanced.cache') }}">@csrf<input type="hidden" name="cache" value="routes"></form>
+<form id="cache-views"  method="POST" action="{{ route('admin.settings.advanced.cache') }}">@csrf<input type="hidden" name="cache" value="views"></form>
+<form id="cache-app"    method="POST" action="{{ route('admin.settings.advanced.cache') }}">@csrf<input type="hidden" name="cache" value="app"></form>
+<form id="cache-all"    method="POST" action="{{ route('admin.settings.advanced.cache') }}">@csrf<input type="hidden" name="cache" value="all"></form>
+@endpush
+
diff --git a/app/Modules/Admin/Resources/views/settings/index.blade.php b/app/Modules/Admin/Resources/views/settings/index.blade.php
index 51eb074..3bd1779 100644
--- a/app/Modules/Admin/Resources/views/settings/index.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/index.blade.php
@@ -10,9 +10,11 @@
             <h1 class="text-2xl font-bold text-gray-800">System Settings</h1>
         </div>
         <div class="flex items-center gap-3">
+            @if(request('view', 'general') !== 'advanced')
             <button id="save-settings-btn" form="settings-form" type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium flex items-center gap-2 disabled:opacity-50 disabled:cursor-not-allowed">
                 <i class="fas fa-save"></i> Save All Changes
             </button>
+            @endif
         </div>
     </header>
     <main class="flex-1 flex overflow-hidden bg-gray-50">
@@ -25,11 +27,25 @@
                     <p>{{ session('success') }}</p>
                 </div>
             @endif
+            @if(session('advanced_success'))
+                <div class="bg-green-100 border-l-4 border-green-500 text-green-700 p-4 mb-4" role="alert">
+                    <p class="font-bold"><i class="fas fa-check-circle mr-1"></i> Done!</p>
+                    <p>{{ session('advanced_success') }}</p>
+                </div>
+            @endif
+            @if(session('advanced_error'))
+                <div class="bg-red-100 border-l-4 border-red-500 text-red-700 p-4 mb-4" role="alert">
+                    <p class="font-bold"><i class="fas fa-exclamation-circle mr-1"></i> Error</p>
+                    <p>{{ session('advanced_error') }}</p>
+                </div>
+            @endif
             <form id="settings-form" action="{{ route('admin.settings.store') }}" method="POST">
                 @csrf
                 <input type="hidden" name="view" value="{{ request('view', 'general') }}">
                 @yield('settings_content')
             </form>
+
+            @stack('after_settings_form')
         </div>
 
     </main>
diff --git a/docs/module-crud-system.md b/docs/module-crud-system.md
deleted file mode 100644
index 97cfa80..0000000
--- a/docs/module-crud-system.md
+++ /dev/null
@@ -1,430 +0,0 @@
-# Module CRUD System — Diseño e Implementación
-
-## Contexto
-
-Los módulos de NexusCMS ya tienen un sistema de registro y carga sólido. Lo que falta es un mecanismo estándar para que cada módulo exponga su gestión en el ACP (Admin Control Panel) sin necesidad de código repetitivo y sin acoplarse al módulo Admin.
-
-Además, se detecta un problema existente en `ModuleManagerController`: el toggle y el update escriben en **dos sitios** (DB + `module.json`), y no existe un `uninstall` limpio separado del `destroy`.
-
----
-
-## Parte 1 — Correcciones en ModuleManagerController
-
-### 1.1 Añadir `uninstall` (solo limpia la BD)
-
-Actualmente `destroy` borra la carpeta del módulo y su registro en BD. Se necesita una acción separada `uninstall` que **solo elimina el registro en `managed_modules`** sin tocar el filesystem. Útil cuando se quiere "desvincular" un módulo sin perder su código.
-
-**Ruta nueva:**
-```
-DELETE /acp/modules/{module}/uninstall  →  admin.modules.uninstall
-```
-
-**Comportamiento:**
-- Llama a `ModuleRegistryService::deleteState($module)`
-- Limpia caché
-- **No** borra la carpeta ni corre rollback de migrations
-- Redirige a `admin.modules.index` con mensaje de éxito
-
-**Distinción visual en el index:**
-- `Uninstall` → desvincula de BD, deja el código intacto
-- `Delete` → borra carpeta + BD (comportamiento actual)
-
-### 1.2 Limpiar código muerto
-
-- Eliminar el método `buildModuleData()` (nunca se llama)
-- El `edit` / `update` solo debe permitir editar `name` y `module_type`. Los campos `namespace`, `routes`, `migrations`, `views`, `translations` son responsabilidad del desarrollador en `module.json`, no del admin.
-
----
-
-## Parte 2 — Sistema de CRUD para módulos
-
-### Visión general
-
-Cada módulo puede declarar una sección de administración en el ACP mediante **uno** de dos modos mutuamente excluyentes:
-
-| Modo | Descripción | Activación |
-|------|-------------|------------|
-| **A — JSON CRUD** | El módulo define su CRUD mediante un JSON. El framework renderiza la UI automáticamente. | `"admin_crud": "json"` en `module.json` |
-| **B — Custom Views** | El módulo provee sus propias vistas Blade y controladores bajo `Admin/`. | `"admin_crud": "custom"` en `module.json` |
-
-> Si `admin_crud` no está definido, el módulo no expone sección de administración.  
-> Los modos A y B son **mutuamente excluyentes**: definir `custom` desactiva la lógica JSON.
-
----
-
-## Modo A — JSON CRUD (Genérico)
-
-### Archivo de configuración: `admin-crud.json`
-
-Ubicación: `app/Modules/{ModuleName}/admin-crud.json`
-
-Este archivo describe el modelo que se gestiona, los campos del formulario y las columnas del listado.
-
-```json
-{
-    "title": "Forum Categories",
-    "model": "Modules\\Forum\\Domain\\Models\\ForumCategory",
-    "route_prefix": "admin.forum.categories",
-    "permissions": {
-        "index":   "manage.forum",
-        "create":  "manage.forum",
-        "edit":    "manage.forum",
-        "delete":  "manage.forum"
-    },
-    "list": {
-        "columns": [
-            { "field": "name",        "label": "Name",        "sortable": true  },
-            { "field": "slug",        "label": "Slug",        "sortable": false },
-            { "field": "created_at",  "label": "Created",     "sortable": true,  "format": "date" }
-        ],
-        "per_page": 15,
-        "searchable": ["name", "slug"]
-    },
-    "form": {
-        "layout": "single",
-        "sections": [
-            {
-                "title": "General",
-                "fields": [
-                    {
-                        "name": "name",
-                        "label": "Name",
-                        "type": "text",
-                        "required": true,
-                        "placeholder": "Category name"
-                    },
-                    {
-                        "name": "slug",
-                        "label": "Slug",
-                        "type": "slug",
-                        "source": "name",
-                        "required": false,
-                        "hint": "Auto-generated from Name"
-                    },
-                    {
-                        "name": "description",
-                        "label": "Description",
-                        "type": "textarea",
-                        "required": false,
-                        "rows": 4
-                    },
-                    {
-                        "name": "is_visible",
-                        "label": "Visible",
-                        "type": "toggle",
-                        "default": true
-                    }
-                ]
-            }
-        ]
-    }
-}
-```
-
-### Tipos de campo soportados (Modo A)
-
-| Tipo | Descripción |
-|------|-------------|
-| `text` | Input de texto simple |
-| `textarea` | Área de texto |
-| `richtext` | CKEditor (como en News) |
-| `slug` | Input con generación automática desde otro campo (`source`) |
-| `select` | Dropdown. Requiere `options: [{"value":"","label":""}]` o `relation` |
-| `toggle` | Checkbox booleano |
-| `number` | Input numérico |
-| `date` | Date picker |
-| `datetime` | Datetime picker |
-| `image` | Upload de imagen a `storage/` |
-| `file` | Upload de archivo genérico |
-| `relation` | Select cargado desde relación Eloquent. Requiere `model`, `value_field`, `label_field` |
-| `hidden` | Campo oculto con valor fijo o generado |
-
-### Layout del formulario
-
-El campo `"layout"` en `form` puede ser:
-
-- `"single"` — Una sola columna, secciones apiladas verticalmente
-- `"sidebar"` — Columna principal (2/3) + sidebar (1/3). Las secciones se asignan a `"position": "main"` o `"position": "sidebar"`
-
-Ejemplo con sidebar:
-```json
-"form": {
-    "layout": "sidebar",
-    "sections": [
-        {
-            "title": "Content",
-            "position": "main",
-            "fields": [...]
-        },
-        {
-            "title": "Settings",
-            "position": "sidebar",
-            "fields": [...]
-        }
-    ]
-}
-```
-
-### Componentes del sistema (Modo A)
-
-#### `ModuleCrudService`
-`app/Services/ModuleCrudService.php`
-
-Responsabilidades:
-- Leer y parsear `admin-crud.json` de un módulo
-- Validar la estructura del JSON
-- Generar reglas de validación Laravel desde la definición de campos
-- Resolver el modelo Eloquent
-- Ejecutar operaciones CRUD (index, store, update, delete) contra el modelo
-
-#### `GenericCrudController`
-`app/Modules/Admin/Http/Controllers/GenericCrudController.php`
-
-Controlador único que gestiona todos los módulos en Modo A:
-- Recibe `{module}` y `{action}` como parámetros de ruta
-- Delega en `ModuleCrudService`
-- Renderiza vistas genéricas reutilizables
-
-#### Vistas genéricas (Modo A)
-```
-app/Modules/Admin/Resources/views/generic-crud/
-├── index.blade.php   — Tabla de listado con paginación y búsqueda
-├── create.blade.php  — Formulario de creación
-└── edit.blade.php    — Formulario de edición
-```
-
-Estas vistas iteran sobre la definición de `admin-crud.json` y renderizan los campos dinámicamente mediante un componente Blade parcial por tipo de campo:
-
-```
-app/Modules/Admin/Resources/views/generic-crud/fields/
-├── text.blade.php
-├── textarea.blade.php
-├── richtext.blade.php
-├── slug.blade.php
-├── select.blade.php
-├── toggle.blade.php
-├── image.blade.php
-├── relation.blade.php
-└── ...
-```
-
-#### Rutas (Modo A)
-
-Se registran automáticamente para cada módulo con `admin_crud: json` activo:
-
-```
-GET    /acp/modules/{module}/manage          → index
-GET    /acp/modules/{module}/manage/create   → create
-POST   /acp/modules/{module}/manage          → store
-GET    /acp/modules/{module}/manage/{id}     → edit
-PUT    /acp/modules/{module}/manage/{id}     → update
-DELETE /acp/modules/{module}/manage/{id}     → destroy
-```
-
-Rutas nombradas:
-```
-admin.module-crud.index
-admin.module-crud.create
-admin.module-crud.store
-admin.module-crud.edit
-admin.module-crud.update
-admin.module-crud.destroy
-```
-
-El registro de estas rutas lo hace `ModuleServiceProvider` al detectar `admin_crud: json` en el manifest.
-
----
-
-## Modo B — Custom Views (Vistas propias del módulo)
-
-### Estructura dentro del módulo
-
-```
-app/Modules/{ModuleName}/
-└── Admin/
-    ├── Controllers/
-    │   └── ForumAdminController.php
-    ├── routes.php
-    └── views/
-        ├── index.blade.php
-        ├── create.blade.php
-        └── edit.blade.php
-```
-
-### Activación
-
-En `module.json`:
-```json
-{
-    "admin_crud": "custom"
-}
-```
-
-Cuando `admin_crud` es `custom`:
-- El framework **no** registra rutas genéricas para este módulo
-- `BaseModuleServiceProvider` detecta la carpeta `Admin/` y:
-  - Carga `Admin/routes.php` dentro del middleware `auth + permission:access.admin.panel`
-  - Registra `Admin/views/` como namespace de vistas `{modulename}-admin::`
-  
-### Reglas del modo custom
-
-1. Las rutas deben definirse en `Admin/routes.php`
-2. Los controladores deben extender `App\Http\Controllers\Controller`
-3. Las vistas deben extender `admin::layouts.app` para mantener el layout del ACP
-4. El módulo es responsable de sus propias validaciones y lógica
-
-### Ejemplo: `Admin/routes.php`
-
-```php
-<?php
-use Illuminate\Support\Facades\Route;
-use Modules\Forum\Admin\Controllers\ForumAdminController;
-
-Route::middleware(['auth', 'permission:manage.forum'])
-    ->prefix('acp/forum')
-    ->name('admin.forum.')
-    ->group(function () {
-        Route::get('/', [ForumAdminController::class, 'index'])->name('index');
-        Route::get('/create', [ForumAdminController::class, 'create'])->name('create');
-        Route::post('/', [ForumAdminController::class, 'store'])->name('store');
-        Route::get('/{id}/edit', [ForumAdminController::class, 'edit'])->name('edit');
-        Route::put('/{id}', [ForumAdminController::class, 'update'])->name('update');
-        Route::delete('/{id}', [ForumAdminController::class, 'destroy'])->name('destroy');
-    });
-```
-
----
-
-## Integración en el módulo Admin — Sidebar / Menú
-
-Tanto en Modo A como en Modo B, el módulo puede declarar su entrada en el menú lateral del ACP añadiendo una clave `admin_menu` en `module.json`:
-
-```json
-{
-    "admin_menu": {
-        "label": "Forum",
-        "icon": "fas fa-comments",
-        "route": "admin.forum.index",
-        "permission": "manage.forum",
-        "order": 30
-    }
-}
-```
-
-El layout del ACP (`admin::layouts.app`) leerá estos registros de los módulos activos y construirá el menú dinámicamente.
-
----
-
-## Cambios en `module.json` — Resumen de nuevas claves
-
-```json
-{
-    "name": "Forum",
-    "description": "Forum module",
-    "version": "1.2.0",
-    "author": "WoW-CMS",
-    "enabled": true,
-    "routes": true,
-    "migrations": true,
-    "views": true,
-    "namespace": "Modules\\Forum",
-
-    "admin_crud": "custom",
-
-    "admin_menu": {
-        "label": "Forum",
-        "icon": "fas fa-comments",
-        "route": "admin.forum.index",
-        "permission": "manage.forum",
-        "order": 30
-    }
-}
-```
-
----
-
-## Cambios en `BaseModuleServiceProvider`
-
-```php
-public function boot(): void
-{
-    parent::boot();
-
-    $adminCrud = $this->config['admin_crud'] ?? null;
-
-    if ($adminCrud === 'custom') {
-        $this->loadAdminRoutes();
-        $this->loadAdminViews();
-    }
-    // Si es 'json', las rutas genéricas las registra ModuleServiceProvider globalmente
-}
-
-private function loadAdminRoutes(): void
-{
-    $path = $this->modulePath . '/Admin/routes.php';
-    if (is_file($path)) {
-        Route::middleware(['web', 'auth'])
-            ->group($path);
-    }
-}
-
-private function loadAdminViews(): void
-{
-    $path = $this->modulePath . '/Admin/views';
-    if (is_dir($path)) {
-        $this->loadViewsFrom($path, strtolower($this->moduleName) . '-admin');
-    }
-}
-```
-
----
-
-## Fases de implementación
-
-### Fase 1 — Correcciones ModuleManagerController
-- Añadir método `uninstall()` (solo borra BD)
-- Añadir ruta `DELETE /acp/modules/{module}/uninstall`
-- Quitar campos estructurales del formulario `edit` (namespace, routes, etc.)
-- Eliminar `buildModuleData()` (código muerto)
-- Actualizar vista `index.blade.php`: botón "Uninstall" separado de "Delete"
-
-### Fase 2 — Infraestructura base
-- Añadir clave `admin_crud` al parsing del manifest en `ModuleRegistryService`
-- Actualizar `BaseModuleServiceProvider` para detectar modo `custom`
-- Actualizar `module.json` del módulo Example con la nueva estructura
-
-### Fase 3 — Modo B (Custom Views)
-- Implementar carga de `Admin/routes.php` y `Admin/views/` en `BaseModuleServiceProvider`
-- Documentar con el módulo Example
-
-### Fase 4 — Modo A (JSON CRUD)
-- Implementar `ModuleCrudService` (parse + validación de `admin-crud.json`)
-- Implementar `GenericCrudController`
-- Crear vistas genéricas `generic-crud/index`, `create`, `edit`
-- Crear partiales por tipo de campo en `generic-crud/fields/`
-- Registrar rutas genéricas desde `ModuleServiceProvider` para módulos con `admin_crud: json`
-
-### Fase 5 — Menú dinámico del ACP
-- Implementar lectura de `admin_menu` desde el manifest
-- Actualizar `admin::layouts.app` para construir el sidebar dinámicamente
-
----
-
-## Archivos afectados / nuevos
-
-| Archivo | Estado |
-|---------|--------|
-| `app/Modules/Admin/Http/Controllers/ModuleManagerController.php` | Modificar |
-| `app/Modules/Admin/Resources/views/modules/index.blade.php` | Modificar |
-| `app/Modules/Admin/Resources/views/modules/edit.blade.php` | Modificar |
-| `app/Services/ModuleRegistryService.php` | Modificar |
-| `app/Providers/BaseModuleServiceProvider.php` | Modificar |
-| `app/Providers/ModuleServiceProvider.php` | Modificar (Fase 4) |
-| `app/Services/ModuleCrudService.php` | Nuevo (Fase 4) |
-| `app/Modules/Admin/Http/Controllers/GenericCrudController.php` | Nuevo (Fase 4) |
-| `app/Modules/Admin/Resources/views/generic-crud/*.blade.php` | Nuevo (Fase 4) |
-| `app/Modules/Admin/Resources/views/generic-crud/fields/*.blade.php` | Nuevo (Fase 4) |
-| `app/Modules/{Name}/Admin/routes.php` | Nuevo por módulo (Fase 3) |
-| `app/Modules/{Name}/Admin/Controllers/*.php` | Nuevo por módulo (Fase 3) |
-| `app/Modules/{Name}/Admin/views/*.blade.php` | Nuevo por módulo (Fase 3) |
-| `app/Modules/{Name}/admin-crud.json` | Nuevo por módulo (Fase 4) |

From 17f0f726d8497775644eafac8bd172c738a6ae20 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 17 May 2026 04:16:05 +0200
Subject: [PATCH 114/132] feat(provider): enhance view and translation loading
 for case sensitivity

---
 app/Providers/BaseModuleServiceProvider.php | 45 ++++++++++++---------
 1 file changed, 25 insertions(+), 20 deletions(-)

diff --git a/app/Providers/BaseModuleServiceProvider.php b/app/Providers/BaseModuleServiceProvider.php
index 45807d0..b777ee0 100644
--- a/app/Providers/BaseModuleServiceProvider.php
+++ b/app/Providers/BaseModuleServiceProvider.php
@@ -87,31 +87,29 @@ private function loadMigrations(): void
 
     /**
      * Load views from the module's resources/views directory.
-     * 
-     * @return void
+     * Supports both "views" and "Views" for case-sensitive filesystems.
      */
     private function loadViews(): void
     {
-        $path = $this->modulePath . '/Resources/views';
-        if (is_dir($path)) {
-            $this->loadViewsFrom($path, strtolower($this->moduleName));
+        foreach ([$this->modulePath . '/Resources/views', $this->modulePath . '/Resources/Views'] as $path) {
+            if (is_dir($path)) {
+                $this->loadViewsFrom($path, strtolower($this->moduleName));
+                return;
+            }
         }
     }
 
     /**
      * Load translations from the module's lang directory.
-     * 
-     * @return void
+     * Supports both "lang" and "Lang" for case-sensitive filesystems.
      */
     private function loadTranslations(): void
     {
-        $path = $this->modulePath . '/Resources/lang';
-
-        if (is_dir($path)) {
-            $this->loadTranslationsFrom(
-                $path,
-                strtolower($this->moduleName)
-            );
+        foreach ([$this->modulePath . '/Resources/lang', $this->modulePath . '/Resources/Lang'] as $path) {
+            if (is_dir($path)) {
+                $this->loadTranslationsFrom($path, strtolower($this->moduleName));
+                return;
+            }
         }
     }
 
@@ -130,15 +128,22 @@ private function loadAdminRoutes(): void
     }
 
     /**
-     * Register admin views namespace from the module's Admin/views directory (Modo B).
-     * 
-     * @return void
+     * Register admin views namespace from the module's Admin/Views directory (Modo B).
+     * Supports both "Views" (uppercase) and "views" (lowercase) to handle
+     * case-sensitive filesystems in production (Linux).
      */
     private function loadAdminViews(): void
     {
-        $path = $this->modulePath . '/Admin/views';
-        if (is_dir($path)) {
-            $this->loadViewsFrom($path, strtolower($this->moduleName) . '-admin');
+        $candidates = [
+            $this->modulePath . '/Admin/Views',
+            $this->modulePath . '/Admin/views',
+        ];
+
+        foreach ($candidates as $path) {
+            if (is_dir($path)) {
+                $this->loadViewsFrom($path, strtolower($this->moduleName) . '-admin');
+                return;
+            }
         }
     }
 }

From c312bae4aaad749d7c3057042f763fc4864e60ba Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 23 May 2026 23:45:42 +0200
Subject: [PATCH 115/132] feat: Implement built-in updater for NexusCMS

- Added UpdateService to handle fetching and applying updates from GitHub.
- Created update configuration file for managing update settings.
- Developed a Blade view for the system updates interface, including update checks and history.
- Implemented database migration for logging update history.
- Added pre-flight checks to ensure the environment is ready for updates.
- Included functionality for both Git and ZIP-based update methods.
---
 app/Models/UpdateLog.php                      |  28 +
 .../Controllers/AdminSettingsController.php   |   3 +-
 .../Http/Controllers/UpdateController.php     |  54 ++
 app/Modules/Admin/Http/routes.php             |   4 +
 .../Resources/views/layouts/app.blade.php     |   9 +
 .../views/settings/extends/menu.blade.php     |   2 +-
 .../views/settings/updates.blade.php          | 145 +++++
 .../Resources/views/updates/index.blade.php   | 404 ++++++++++++++
 app/Modules/Admin/Services/UpdateService.php  | 513 ++++++++++++++++++
 config/update.php                             |  86 +++
 ..._05_23_000001_create_update_logs_table.php |  27 +
 11 files changed, 1273 insertions(+), 2 deletions(-)
 create mode 100644 app/Models/UpdateLog.php
 create mode 100644 app/Modules/Admin/Http/Controllers/UpdateController.php
 create mode 100644 app/Modules/Admin/Resources/views/settings/updates.blade.php
 create mode 100644 app/Modules/Admin/Resources/views/updates/index.blade.php
 create mode 100644 app/Modules/Admin/Services/UpdateService.php
 create mode 100644 config/update.php
 create mode 100644 database/migrations/2026_05_23_000001_create_update_logs_table.php

diff --git a/app/Models/UpdateLog.php b/app/Models/UpdateLog.php
new file mode 100644
index 0000000..d63af88
--- /dev/null
+++ b/app/Models/UpdateLog.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class UpdateLog extends Model
+{
+    protected $fillable = [
+        'from_version',
+        'to_version',
+        'method',
+        'status',
+        'notes',
+        'executed_by',
+    ];
+
+    public function executor(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'executed_by');
+    }
+
+    public function isSuccess(): bool
+    {
+        return $this->status === 'success';
+    }
+}
diff --git a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
index eab930f..65584b8 100644
--- a/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminSettingsController.php
@@ -22,6 +22,7 @@ class AdminSettingsController extends Controller
         'maintenance' => 'admin::settings.maintenance',
         'localization' => 'admin::settings.localization',
         'advanced' => 'admin::settings.advanced',
+        'updates'  => 'admin::settings.updates',
     ];
 
     /**
@@ -65,7 +66,7 @@ public function store(Request $request)
 
             Setting::updateOrCreate(
                 ['key' => $key],
-                ['value' => $value]
+                ['value' => $value ?? '']
             );
         }
 
diff --git a/app/Modules/Admin/Http/Controllers/UpdateController.php b/app/Modules/Admin/Http/Controllers/UpdateController.php
new file mode 100644
index 0000000..9e571a3
--- /dev/null
+++ b/app/Modules/Admin/Http/Controllers/UpdateController.php
@@ -0,0 +1,54 @@
+<?php
+
+namespace Modules\Admin\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Modules\Admin\Services\UpdateService;
+
+class UpdateController extends Controller
+{
+    public function __construct(private readonly UpdateService $updates) {}
+
+    public function index()
+    {
+        $current    = config('app.version');
+        $latest     = $this->updates->getLatestRelease();
+        $outdated   = $this->updates->isOutdated($latest);
+        $method     = $this->updates->detectMethod();
+        $checks     = $this->updates->preflight();
+        $releases   = $this->updates->getReleases(5);
+        $history    = $this->updates->getHistory(10);
+        // Fetch the release matching the currently running version for correct release notes link
+        $currentRelease = $this->updates->getReleaseByTag($current)
+                       ?? $this->updates->getReleaseByTag('v' . ltrim($current, 'v'));
+
+        return view('admin::updates.index', compact(
+            'latest', 'outdated', 'method', 'checks', 'releases', 'history', 'current', 'currentRelease'
+        ));
+    }
+
+    public function apply(Request $request)
+    {
+        if (!settings('update.enabled', config('update.enabled', true))) {
+            return response()->json(['success' => false, 'error' => 'The auto-update system is disabled.'], 403);
+        }
+
+        $tag = trim((string) $request->input('tag', ''));
+
+        if ($tag === '') {
+            return response()->json(['success' => false, 'error' => 'No release tag specified.'], 422);
+        }
+
+        // Basic tag sanitization — allow semver + v-prefix + pre-release suffixes
+        if (!preg_match('/^v?[\d]+\.[\d]+(\.[\d]+)?([-.][a-z0-9]+)*$/i', $tag)) {
+            return response()->json(['success' => false, 'error' => 'Invalid tag format.'], 422);
+        }
+
+        $result = $this->updates->apply($tag, auth()->id());
+
+        $status = $result['success'] ? 200 : 500;
+
+        return response()->json($result, $status);
+    }
+}
diff --git a/app/Modules/Admin/Http/routes.php b/app/Modules/Admin/Http/routes.php
index 7dacfa9..ede7bce 100644
--- a/app/Modules/Admin/Http/routes.php
+++ b/app/Modules/Admin/Http/routes.php
@@ -38,6 +38,10 @@
         Route::get('/backups/{filename}/download', [\Modules\Admin\Http\Controllers\BackupController::class, 'download'])->middleware('permission:manage.backups')->name('admin.backups.download');
         Route::delete('/backups/{filename}', [\Modules\Admin\Http\Controllers\BackupController::class, 'destroy'])->middleware('permission:manage.backups')->name('admin.backups.destroy');
 
+        // Updates
+        Route::get('/updates', [\Modules\Admin\Http\Controllers\UpdateController::class, 'index'])->middleware('permission:manage.settings')->name('admin.updates.index');
+        Route::post('/updates/apply', [\Modules\Admin\Http\Controllers\UpdateController::class, 'apply'])->middleware('permission:manage.settings')->name('admin.updates.apply');
+
         // Settings
         Route::get('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'index'])->middleware('permission:manage.settings')->name('admin.settings.index');
         Route::post('/settings', [\Modules\Admin\Http\Controllers\AdminSettingsController::class, 'store'])->middleware('permission:manage.settings')->name('admin.settings.store');
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index 8e9cc4e..ecc386a 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -229,6 +229,15 @@ class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium
                 </a>
                 @endcan
                 @can('manage.settings')
+                @php $active = request()->routeIs('admin.updates.*'); @endphp
+                <a href="{{ route('admin.updates.index') }}"
+                   class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
+                          {{ $active ? 'nav-item-active bg-white/[0.08] text-white' : 'text-gray-400 hover:bg-white/[0.05] hover:text-gray-200' }}">
+                    <i class="fas fa-cloud-arrow-up w-4 text-center {{ $active ? 'text-blue-400' : '' }}"></i>
+                    Updates
+                </a>
+                @endcan
+                @can('manage.settings')
                 @php $active = request()->routeIs('admin.settings.*'); @endphp
                 <a href="{{ route('admin.settings.index') }}"
                    class="relative flex items-center gap-3 px-3 py-2 rounded-lg text-sm font-medium transition-all duration-150 mb-0.5
diff --git a/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php b/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
index fa5bdd3..1ac2689 100644
--- a/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/extends/menu.blade.php
@@ -14,9 +14,9 @@
                     'seo' => ['icon' => 'search', 'label' => __('admin::settings.menu.seo')],  
                     'api' => ['icon' => 'code', 'label' => __('admin::settings.menu.api')],
                     'maintenance' => ['icon' => 'tools', 'label' => __('admin::settings.menu.maintenance')],        
-                    'maintenance' => ['icon' => 'tools', 'label' => __('admin::settings.menu.maintenance')],        
                     'localization' => ['icon' => 'language', 'label' => __('admin::settings.menu.localization')],
                     'advanced' => ['icon' => 'cogs', 'label' => __('admin::settings.menu.advanced')],
+                    'updates'  => ['icon' => 'cloud-arrow-up', 'label' => 'Updates'],
                 ];
             @endphp
 
diff --git a/app/Modules/Admin/Resources/views/settings/updates.blade.php b/app/Modules/Admin/Resources/views/settings/updates.blade.php
new file mode 100644
index 0000000..5bcdf64
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/settings/updates.blade.php
@@ -0,0 +1,145 @@
+@extends('admin::settings.index')
+
+@section('settings_content')
+<div class="space-y-6">
+
+    {{-- Repository --}}
+    <div class="bg-white rounded-xl shadow border border-gray-200 overflow-hidden">
+        <div class="px-6 py-4 border-b border-gray-100">
+            <h2 class="text-base font-semibold text-gray-800 flex items-center gap-2">
+                <i class="fab fa-github text-gray-500"></i>
+                Source Repository
+            </h2>
+            <p class="text-sm text-gray-500 mt-0.5">GitHub repository to fetch updates from.</p>
+        </div>
+        <div class="p-6 grid sm:grid-cols-2 gap-6">
+            <div>
+                <label class="block text-sm font-medium text-gray-700 mb-1">Repository Owner</label>
+                <input type="text" name="update.repo_owner"
+                    value="{{ old('update.repo_owner', $settings->get('update.repo_owner', 'wow-cms')) }}"
+                    placeholder="e.g. wow-cms"
+                    class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+                <p class="text-xs text-gray-400 mt-1">GitHub username or organisation.</p>
+            </div>
+            <div>
+                <label class="block text-sm font-medium text-gray-700 mb-1">Repository Name</label>
+                <input type="text" name="update.repo_name"
+                    value="{{ old('update.repo_name', $settings->get('update.repo_name', 'nexuscms')) }}"
+                    placeholder="e.g. nexuscms"
+                    class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">
+                <p class="text-xs text-gray-400 mt-1">Exact repository name (case-sensitive).</p>
+            </div>
+            <div class="sm:col-span-2">
+                <label class="block text-sm font-medium text-gray-700 mb-1">
+                    GitHub Token
+                    <span class="text-xs font-normal text-gray-400 ml-1">(optional)</span>
+                </label>
+                <input type="password" name="update.github_token"
+                    value="{{ old('update.github_token', $settings->get('update.github_token', '')) }}"
+                    placeholder="ghp_xxxxxxxxxxxx"
+                    autocomplete="new-password"
+                    class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent font-mono">
+                <p class="text-xs text-gray-400 mt-1">
+                    Required for private repositories. Also increases the GitHub API rate limit from 60 to 5,000 requests/hour.
+                    Leave empty to use unauthenticated requests.
+                </p>
+            </div>
+        </div>
+    </div>
+
+    {{-- Update Behaviour --}}
+    <div class="bg-white rounded-xl shadow border border-gray-200 overflow-hidden">
+        <div class="px-6 py-4 border-b border-gray-100">
+            <h2 class="text-base font-semibold text-gray-800 flex items-center gap-2">
+                <i class="fas fa-sliders text-gray-500"></i>
+                Update Behaviour
+            </h2>
+        </div>
+        <div class="p-6 space-y-6">
+
+            {{-- Channel --}}
+            <div>
+                <label class="block text-sm font-medium text-gray-700 mb-2">Release Channel</label>
+                <div class="grid sm:grid-cols-3 gap-3">
+                    @php
+                        $currentChannel = $settings->get('update.channel', 'stable');
+                        $channels = [
+                            'stable' => ['label' => 'Stable', 'desc' => 'Only full releases', 'icon' => 'fa-shield-check', 'color' => 'green'],
+                            'beta'   => ['label' => 'Beta',   'desc' => 'Includes pre-releases', 'icon' => 'fa-flask', 'color' => 'orange'],
+                            'any'    => ['label' => 'Any',    'desc' => 'All published releases', 'icon' => 'fa-bolt', 'color' => 'red'],
+                        ];
+                    @endphp
+                    @foreach($channels as $val => $ch)
+                    <label class="relative cursor-pointer">
+                        <input type="radio" name="update.channel" value="{{ $val }}"
+                            {{ $currentChannel === $val ? 'checked' : '' }}
+                            class="sr-only peer">
+                        <div class="border-2 rounded-xl p-4 transition
+                            peer-checked:border-blue-500 peer-checked:bg-blue-50
+                            border-gray-200 hover:border-gray-300">
+                            <div class="flex items-center gap-2 mb-1">
+                                <i class="fas {{ $ch['icon'] }} text-{{ $ch['color'] }}-500 text-sm"></i>
+                                <span class="text-sm font-semibold text-gray-800">{{ $ch['label'] }}</span>
+                                <i class="fas fa-circle-check text-blue-500 ml-auto hidden peer-checked:block"></i>
+                            </div>
+                            <p class="text-xs text-gray-500">{{ $ch['desc'] }}</p>
+                        </div>
+                    </label>
+                    @endforeach
+                </div>
+            </div>
+
+            {{-- Toggles --}}
+            <div class="grid sm:grid-cols-2 gap-6">
+                {{-- Enabled --}}
+                <div class="flex items-start justify-between gap-4">
+                    <div>
+                        <p class="text-sm font-medium text-gray-700">Auto-update System</p>
+                        <p class="text-xs text-gray-400 mt-0.5">Enable or disable the update checker and apply button.</p>
+                    </div>
+                    <label class="relative inline-flex items-center cursor-pointer shrink-0">
+                        <input type="hidden" name="update.enabled" value="0">
+                        <input type="checkbox" name="update.enabled" value="1"
+                            {{ $settings->get('update.enabled', '1') == '1' ? 'checked' : '' }}
+                            class="sr-only peer">
+                        <div class="w-11 h-6 bg-gray-200 peer-focus:ring-2 peer-focus:ring-blue-300 rounded-full peer
+                                    peer-checked:after:translate-x-full peer-checked:after:border-white
+                                    after:content-[''] after:absolute after:top-[2px] after:left-[2px]
+                                    after:bg-white after:border-gray-300 after:border after:rounded-full
+                                    after:h-5 after:w-5 after:transition-all peer-checked:bg-blue-600"></div>
+                    </label>
+                </div>
+
+                {{-- Maintenance mode --}}
+                <div class="flex items-start justify-between gap-4">
+                    <div>
+                        <p class="text-sm font-medium text-gray-700">Maintenance Mode During Update</p>
+                        <p class="text-xs text-gray-400 mt-0.5">Put the site in maintenance mode while applying an update.</p>
+                    </div>
+                    <label class="relative inline-flex items-center cursor-pointer shrink-0">
+                        <input type="hidden" name="update.maintenance_mode" value="0">
+                        <input type="checkbox" name="update.maintenance_mode" value="1"
+                            {{ $settings->get('update.maintenance_mode', '1') == '1' ? 'checked' : '' }}
+                            class="sr-only peer">
+                        <div class="w-11 h-6 bg-gray-200 peer-focus:ring-2 peer-focus:ring-blue-300 rounded-full peer
+                                    peer-checked:after:translate-x-full peer-checked:after:border-white
+                                    after:content-[''] after:absolute after:top-[2px] after:left-[2px]
+                                    after:bg-white after:border-gray-300 after:border after:rounded-full
+                                    after:h-5 after:w-5 after:transition-all peer-checked:bg-blue-600"></div>
+                    </label>
+                </div>
+            </div>
+        </div>
+    </div>
+
+    {{-- Info box --}}
+    <div class="bg-blue-50 border border-blue-200 rounded-xl p-4 flex items-start gap-3 text-sm text-blue-800">
+        <i class="fas fa-circle-info text-blue-500 mt-0.5 shrink-0"></i>
+        <p>
+            These settings are stored in the database and take effect immediately without redeploying.
+            To apply updates, go to <a href="{{ route('admin.updates.index') }}" class="font-semibold underline">System &rsaquo; Updates</a>.
+        </p>
+    </div>
+
+</div>
+@endsection
diff --git a/app/Modules/Admin/Resources/views/updates/index.blade.php b/app/Modules/Admin/Resources/views/updates/index.blade.php
new file mode 100644
index 0000000..d7367ca
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/updates/index.blade.php
@@ -0,0 +1,404 @@
+@extends('admin::layouts.app')
+
+@section('Title', 'System Updates')
+
+@section('content')
+<div class="flex-1 flex flex-col overflow-hidden">
+
+    {{-- Header --}}
+    <header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6 shrink-0">
+        <div class="flex items-center gap-3">
+            <h1 class="text-xl font-bold text-gray-800 flex items-center gap-2">
+                <i class="fas fa-cloud-arrow-up text-blue-600"></i>
+                System Updates
+            </h1>
+            <span class="px-2.5 py-1 bg-gray-100 text-gray-600 text-xs font-semibold rounded-full">
+                Current: v{{ $current }}
+            </span>
+        </div>
+        <button onclick="checkForUpdates()" id="check-btn"
+            class="px-4 py-2 bg-white border border-gray-300 text-gray-700 rounded-lg hover:bg-gray-50 text-sm font-medium flex items-center gap-2 transition">
+            <i class="fas fa-sync-alt" id="check-icon"></i>
+            Check for Updates
+        </button>
+    </header>
+
+    {{-- Main Content --}}
+    <main class="flex-1 overflow-y-auto bg-gray-50 p-6 space-y-6">
+
+        @if(!settings('update.enabled', config('update.enabled', true)))
+        <div class="bg-yellow-50 border border-yellow-200 rounded-xl p-6 flex items-start gap-4">
+            <i class="fas fa-ban text-yellow-500 text-xl mt-0.5"></i>
+            <div>
+                <p class="font-semibold text-yellow-800">Auto-updates disabled</p>
+                <p class="text-sm text-yellow-700 mt-1">Set <code>UPDATE_ENABLED=true</code> in your <code>.env</code> to enable the updater.</p>
+            </div>
+        </div>
+        @elseif(!$latest)
+        <div class="bg-white rounded-xl shadow border border-gray-200 p-6 flex items-start gap-4">
+            <div class="w-12 h-12 bg-gray-100 rounded-xl flex items-center justify-center shrink-0">
+                <i class="fas fa-plug text-gray-400 text-xl"></i>
+            </div>
+            <div>
+                <p class="font-semibold text-gray-800">Could not reach GitHub</p>
+                <p class="text-sm text-gray-500 mt-1">
+                    Unable to fetch release information. Check your internet connection, verify the repository
+                    (<code>{{ settings('update.repo_owner', config('update.repository.owner')) }}/{{ settings('update.repo_name', config('update.repository.name')) }}</code>),
+                    or add a <code>GITHUB_TOKEN</code> if the repository is private.
+                </p>
+            </div>
+        </div>
+        @elseif($outdated)
+        {{-- Update Available --}}
+        <div class="bg-gradient-to-br from-blue-50 to-indigo-50 border border-blue-200 rounded-xl shadow overflow-hidden">
+            <div class="px-6 py-4 border-b border-blue-200 flex items-center justify-between">
+                <div class="flex items-center gap-3">
+                    <span class="w-2.5 h-2.5 rounded-full bg-green-500 animate-pulse"></span>
+                    <span class="font-bold text-gray-800">Update Available</span>
+                </div>
+                <div class="flex items-center gap-2 text-sm text-gray-500">
+                    <span>{{ $latest['tag_name'] }}</span>
+                    @if($latest['published_at'])
+                    <span class="text-gray-300">•</span>
+                    <span>{{ \Carbon\Carbon::parse($latest['published_at'])->format('M d, Y') }}</span>
+                    @endif
+                    @if($latest['html_url'])
+                    <span class="text-gray-300">•</span>
+                    <a href="{{ $latest['html_url'] }}" target="_blank" class="text-blue-600 hover:underline flex items-center gap-1">
+                        <i class="fab fa-github text-xs"></i> View on GitHub
+                    </a>
+                    @endif
+                </div>
+            </div>
+            <div class="p-6 grid md:grid-cols-3 gap-6">
+                <div class="flex items-center gap-4">
+                    <div class="text-center">
+                        <p class="text-xs text-gray-500 mb-1">Current</p>
+                        <span class="px-3 py-1.5 bg-gray-200 text-gray-700 rounded-lg font-mono text-sm font-semibold">v{{ $current }}</span>
+                    </div>
+                    <i class="fas fa-arrow-right text-gray-400"></i>
+                    <div class="text-center">
+                        <p class="text-xs text-gray-500 mb-1">Latest</p>
+                        <span class="px-3 py-1.5 bg-blue-600 text-white rounded-lg font-mono text-sm font-semibold">{{ $latest['tag_name'] }}</span>
+                    </div>
+                </div>
+                <div class="md:col-span-2">
+                    @if($latest['body'])
+                    <p class="text-xs font-semibold uppercase tracking-wide text-gray-500 mb-2">Release Notes</p>
+                    <div class="text-sm text-gray-700 bg-white rounded-lg border border-gray-200 p-3 max-h-36 overflow-y-auto leading-relaxed whitespace-pre-line">{{ $latest['body'] }}</div>
+                    @else
+                    <p class="text-sm text-gray-500 italic">No release notes provided.</p>
+                    @endif
+                </div>
+            </div>
+            <div class="px-6 pb-6 flex items-center justify-between gap-4 flex-wrap">
+                <div class="flex items-center gap-2 text-sm text-gray-600">
+                    <i class="fas fa-{{ $method === 'git' ? 'code-branch' : 'file-zipper' }} {{ $method === 'git' ? 'text-green-500' : 'text-orange-500' }}"></i>
+                    Update method: <strong>{{ strtoupper($method) }}</strong>
+                    @php $allOk = collect($checks)->every(fn($c) => $c['ok']) @endphp
+                    <span class="ml-3 flex items-center gap-1 {{ $allOk ? 'text-green-600' : 'text-red-600' }}">
+                        <i class="fas fa-{{ $allOk ? 'circle-check' : 'circle-exclamation' }} text-xs"></i>
+                        {{ $allOk ? 'Pre-flight OK' : 'Pre-flight issues detected' }}
+                    </span>
+                </div>
+                <button onclick="openUpdateModal('{{ $latest['tag_name'] }}')"
+                    {{ !$allOk ? 'disabled' : '' }}
+                    title="{{ !$allOk ? 'Fix pre-flight issues before updating' : '' }}"
+                    class="px-5 py-2.5 bg-blue-600 text-white font-semibold rounded-lg hover:bg-blue-700 text-sm flex items-center gap-2 transition disabled:opacity-50 disabled:cursor-not-allowed shadow-md">
+                    <i class="fas fa-cloud-arrow-up"></i>
+                    Apply Update {{ $latest['tag_name'] }}
+                </button>
+            </div>
+        </div>
+        @else
+        {{-- Up to Date --}}
+        <div class="bg-white border border-gray-200 rounded-xl shadow p-6 flex items-center gap-5">
+            <div class="w-14 h-14 bg-green-100 rounded-xl flex items-center justify-center shrink-0">
+                <i class="fas fa-circle-check text-green-500 text-2xl"></i>
+            </div>
+            <div class="flex-1">
+                <p class="font-bold text-gray-800 text-lg">You're running the latest version</p>
+                <p class="text-sm text-gray-500 mt-0.5">
+                    NexusCMS <strong>v{{ $current }}</strong>
+                    @if(($currentRelease['published_at'] ?? null))
+                    &mdash; released {{ \Carbon\Carbon::parse($currentRelease['published_at'])->diffForHumans() }}
+                    @elseif($latest['published_at'] ?? null)
+                    &mdash; released {{ \Carbon\Carbon::parse($latest['published_at'])->diffForHumans() }}
+                    @endif
+                </p>
+            </div>
+            @if(($currentRelease['html_url'] ?? null) ?? ($latest['html_url'] ?? null))
+            <a href="{{ $currentRelease['html_url'] ?? $latest['html_url'] }}" target="_blank"
+               class="px-4 py-2 border border-gray-300 text-gray-700 rounded-lg text-sm hover:bg-gray-50 flex items-center gap-2 transition">
+                <i class="fab fa-github"></i> Release Notes
+            </a>
+            @endif
+        </div>
+        @endif
+
+        {{-- Pre-flight Checks --}}
+        <div class="bg-white rounded-xl shadow border border-gray-200 overflow-hidden">
+            <button onclick="toggleSection('preflight')"
+                class="w-full px-6 py-4 flex items-center justify-between text-left hover:bg-gray-50 transition">
+                <span class="font-semibold text-gray-800 flex items-center gap-2">
+                    <i class="fas fa-list-check text-indigo-500"></i>
+                    Pre-flight Checks
+                    @php $allOk = collect($checks)->every(fn($c) => $c['ok']) @endphp
+                    <span class="text-xs font-normal px-2 py-0.5 rounded-full {{ $allOk ? 'bg-green-100 text-green-700' : 'bg-red-100 text-red-700' }}">
+                        {{ collect($checks)->where('ok', true)->count() }}/{{ count($checks) }} passed
+                    </span>
+                </span>
+                <i class="fas fa-chevron-down text-gray-400 transition-transform" id="preflight-chevron"></i>
+            </button>
+            <div id="preflight" class="hidden border-t border-gray-100">
+                <div class="p-6 grid sm:grid-cols-2 gap-3">
+                    @foreach($checks as $check)
+                    <div class="flex items-start gap-3 p-3 rounded-lg {{ $check['ok'] ? 'bg-green-50 border border-green-100' : 'bg-red-50 border border-red-100' }}">
+                        <i class="fas fa-{{ $check['ok'] ? 'circle-check text-green-500' : 'circle-xmark text-red-500' }} mt-0.5 shrink-0"></i>
+                        <div class="min-w-0">
+                            <p class="text-sm font-medium {{ $check['ok'] ? 'text-green-800' : 'text-red-800' }}">{{ $check['name'] }}</p>
+                            @if($check['detail'] ?? '')
+                            <p class="text-xs {{ $check['ok'] ? 'text-green-600' : 'text-red-600' }} mt-0.5 truncate" title="{{ $check['detail'] }}">{{ $check['detail'] }}</p>
+                            @endif
+                        </div>
+                    </div>
+                    @endforeach
+                </div>
+            </div>
+        </div>
+
+        {{-- Recent Releases --}}
+        @if(!empty($releases))
+        <div class="bg-white rounded-xl shadow border border-gray-200 overflow-hidden">
+            <div class="px-6 py-4 border-b border-gray-100 flex items-center gap-2">
+                <i class="fas fa-tags text-gray-400"></i>
+                <h3 class="font-semibold text-gray-800">Recent Releases</h3>
+            </div>
+            <div class="divide-y divide-gray-100">
+                @foreach($releases as $release)
+                <div class="px-6 py-4 flex items-center gap-4">
+                    <span class="font-mono text-sm font-semibold text-gray-800 w-24 shrink-0">{{ $release['tag_name'] }}</span>
+                    <span class="text-sm text-gray-600 flex-1 truncate">{{ $release['name'] ?? '' }}</span>
+                    @if($release['prerelease'] ?? false)
+                    <span class="px-2 py-0.5 bg-orange-100 text-orange-700 text-xs rounded-full font-medium">pre-release</span>
+                    @endif
+                    @if($release['published_at'] ?? null)
+                    <span class="text-xs text-gray-400 shrink-0">{{ \Carbon\Carbon::parse($release['published_at'])->format('Y-m-d') }}</span>
+                    @endif
+                    @if($release['html_url'] ?? null)
+                    <a href="{{ $release['html_url'] }}" target="_blank"
+                       class="text-xs text-blue-600 hover:underline shrink-0 flex items-center gap-1">
+                        <i class="fas fa-arrow-up-right-from-square text-[10px]"></i> Notes
+                    </a>
+                    @endif
+                </div>
+                @endforeach
+            </div>
+        </div>
+        @endif
+
+        {{-- Update History --}}
+        <div class="bg-white rounded-xl shadow border border-gray-200 overflow-hidden">
+            <div class="px-6 py-4 border-b border-gray-100 flex items-center gap-2">
+                <i class="fas fa-clock-rotate-left text-gray-400"></i>
+                <h3 class="font-semibold text-gray-800">Update History</h3>
+            </div>
+            @if($history->isEmpty())
+            <div class="px-6 py-8 text-center text-gray-400">
+                <i class="fas fa-inbox text-3xl mb-2 block"></i>
+                <p class="text-sm">No updates applied yet.</p>
+            </div>
+            @else
+            <div class="overflow-x-auto">
+                <table class="w-full text-sm">
+                    <thead class="bg-gray-50 text-xs text-gray-500 uppercase tracking-wider">
+                        <tr>
+                            <th class="px-6 py-3 text-left">From</th>
+                            <th class="px-6 py-3 text-left">To</th>
+                            <th class="px-6 py-3 text-left">Method</th>
+                            <th class="px-6 py-3 text-left">Status</th>
+                            <th class="px-6 py-3 text-left">By</th>
+                            <th class="px-6 py-3 text-left">Date</th>
+                            <th class="px-6 py-3 text-left">Log</th>
+                        </tr>
+                    </thead>
+                    <tbody class="divide-y divide-gray-100">
+                        @foreach($history as $entry)
+                        <tr class="hover:bg-gray-50">
+                            <td class="px-6 py-3 font-mono text-gray-600">{{ $entry->from_version ?? '—' }}</td>
+                            <td class="px-6 py-3 font-mono font-semibold text-gray-800">{{ $entry->to_version }}</td>
+                            <td class="px-6 py-3">
+                                <span class="px-2 py-0.5 text-xs rounded-full {{ $entry->method === 'git' ? 'bg-green-100 text-green-700' : 'bg-orange-100 text-orange-700' }}">
+                                    {{ $entry->method }}
+                                </span>
+                            </td>
+                            <td class="px-6 py-3">
+                                <span class="inline-flex items-center gap-1 px-2 py-0.5 text-xs rounded-full font-medium
+                                    {{ $entry->status === 'success' ? 'bg-green-100 text-green-700' : 'bg-red-100 text-red-700' }}">
+                                    <i class="fas fa-{{ $entry->status === 'success' ? 'check' : 'xmark' }} text-[10px]"></i>
+                                    {{ $entry->status }}
+                                </span>
+                            </td>
+                            <td class="px-6 py-3 text-gray-600">{{ $entry->executor?->name ?? 'System' }}</td>
+                            <td class="px-6 py-3 text-gray-500">{{ $entry->created_at->format('Y-m-d H:i') }}</td>
+                            <td class="px-6 py-3">
+                                @if($entry->notes)
+                                <button onclick="showLog({{ $entry->id }})"
+                                    class="text-blue-600 hover:underline text-xs flex items-center gap-1">
+                                    <i class="fas fa-terminal text-[10px]"></i> View
+                                </button>
+                                <pre id="log-{{ $entry->id }}" class="hidden mt-2 bg-gray-900 text-green-400 text-xs rounded p-3 overflow-x-auto max-w-xs max-h-48 leading-relaxed">{{ $entry->notes }}</pre>
+                                @endif
+                            </td>
+                        </tr>
+                        @endforeach
+                    </tbody>
+                </table>
+            </div>
+            @endif
+        </div>
+
+    </main>
+</div>
+
+{{-- Update Confirmation Modal --}}
+<div id="update-modal" class="fixed inset-0 bg-black/60 z-50 hidden items-center justify-center p-4">
+    <div class="bg-white rounded-2xl shadow-2xl max-w-lg w-full">
+        <div class="px-6 py-5 border-b border-gray-100 flex items-center justify-between">
+            <h2 class="text-lg font-bold text-gray-800 flex items-center gap-2">
+                <i class="fas fa-cloud-arrow-up text-blue-600"></i>
+                Apply Update <span id="modal-tag" class="text-blue-600 ml-1"></span>
+            </h2>
+            <button onclick="closeUpdateModal()" class="text-gray-400 hover:text-gray-600 transition">
+                <i class="fas fa-xmark text-lg"></i>
+            </button>
+        </div>
+        <div id="modal-confirm" class="p-6 space-y-4">
+            <div class="bg-amber-50 border border-amber-200 rounded-lg p-4 space-y-2">
+                <p class="text-sm font-semibold text-amber-800 flex items-center gap-2">
+                    <i class="fas fa-triangle-exclamation"></i> Before you proceed
+                </p>
+                <ul class="text-sm text-amber-700 space-y-1 list-disc list-inside">
+                    <li>Back up your <strong>database</strong> before updating</li>
+                    <li>The site will enter <strong>maintenance mode</strong> briefly</li>
+                    <li>Active sessions will be interrupted</li>
+                    <li>This action <strong>cannot be undone</strong> automatically</li>
+                </ul>
+            </div>
+            <p class="text-sm text-gray-600">
+                Update method: <strong class="capitalize">{{ $method }}</strong>.
+                Migrations will run automatically after files are applied.
+            </p>
+        </div>
+        <div id="modal-progress" class="hidden p-6">
+            <div class="flex items-center gap-3">
+                <div class="w-8 h-8 border-4 border-blue-600 border-t-transparent rounded-full animate-spin shrink-0"></div>
+                <p class="text-sm font-medium text-gray-700">Applying update — please do not close this page...</p>
+            </div>
+        </div>
+        <div id="modal-result" class="hidden p-6 space-y-3">
+            <div id="result-banner" class="rounded-lg p-4 text-sm font-semibold"></div>
+            <pre id="result-log" class="bg-gray-900 text-green-400 text-xs rounded-lg p-4 overflow-y-auto max-h-64 leading-relaxed"></pre>
+        </div>
+        <div id="modal-footer" class="px-6 py-4 border-t border-gray-100 flex items-center justify-end gap-3">
+            <button onclick="closeUpdateModal()"
+                class="px-4 py-2 text-sm text-gray-700 border border-gray-300 rounded-lg hover:bg-gray-50 transition">
+                Cancel
+            </button>
+            <button id="confirm-btn" onclick="applyUpdate()"
+                class="px-5 py-2 bg-blue-600 text-white text-sm font-semibold rounded-lg hover:bg-blue-700 transition flex items-center gap-2 shadow">
+                <i class="fas fa-cloud-arrow-up"></i> Apply Update
+            </button>
+        </div>
+    </div>
+</div>
+@endsection
+
+@push('scripts')
+<script>
+let pendingTag = null;
+
+function openUpdateModal(tag) {
+    pendingTag = tag;
+    document.getElementById('modal-tag').textContent = tag;
+    document.getElementById('modal-confirm').classList.remove('hidden');
+    document.getElementById('modal-progress').classList.add('hidden');
+    document.getElementById('modal-result').classList.add('hidden');
+    document.getElementById('modal-footer').classList.remove('hidden');
+    document.getElementById('confirm-btn').disabled = false;
+    document.getElementById('confirm-btn').classList.remove('hidden');
+    document.getElementById('update-modal').classList.remove('hidden');
+    document.getElementById('update-modal').classList.add('flex');
+}
+
+function closeUpdateModal() {
+    document.getElementById('update-modal').classList.add('hidden');
+    document.getElementById('update-modal').classList.remove('flex');
+    pendingTag = null;
+}
+
+async function applyUpdate() {
+    if (!pendingTag) return;
+    document.getElementById('modal-confirm').classList.add('hidden');
+    document.getElementById('modal-progress').classList.remove('hidden');
+    document.getElementById('modal-footer').classList.add('hidden');
+
+    try {
+        const response = await fetch('{{ route("admin.updates.apply") }}', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content,
+            },
+            body: JSON.stringify({ tag: pendingTag }),
+        });
+
+        const data = await response.json();
+        document.getElementById('modal-progress').classList.add('hidden');
+        document.getElementById('modal-result').classList.remove('hidden');
+
+        const banner = document.getElementById('result-banner');
+        if (data.success) {
+            banner.className = 'rounded-lg p-4 text-sm font-semibold bg-green-100 text-green-800';
+            banner.innerHTML = '<i class="fas fa-circle-check mr-2"></i>Update applied successfully! Reloading in 5 seconds...';
+            setTimeout(() => window.location.reload(), 5000);
+        } else {
+            banner.className = 'rounded-lg p-4 text-sm font-semibold bg-red-100 text-red-800';
+            banner.innerHTML = '<i class="fas fa-circle-xmark mr-2"></i>Update failed: ' + (data.error ?? 'Unknown error');
+        }
+
+        document.getElementById('result-log').textContent = (data.log ?? []).join('\n');
+        document.getElementById('modal-footer').classList.remove('hidden');
+        document.getElementById('confirm-btn').classList.add('hidden');
+
+    } catch (err) {
+        document.getElementById('modal-progress').classList.add('hidden');
+        document.getElementById('modal-result').classList.remove('hidden');
+        const banner = document.getElementById('result-banner');
+        banner.className = 'rounded-lg p-4 text-sm font-semibold bg-red-100 text-red-800';
+        banner.innerHTML = '<i class="fas fa-circle-xmark mr-2"></i>Network error: ' + err.message;
+        document.getElementById('modal-footer').classList.remove('hidden');
+        document.getElementById('confirm-btn').classList.add('hidden');
+    }
+}
+
+function checkForUpdates() {
+    document.getElementById('check-btn').disabled = true;
+    document.getElementById('check-icon').classList.add('fa-spin');
+    setTimeout(() => window.location.reload(), 400);
+}
+
+function toggleSection(id) {
+    document.getElementById(id).classList.toggle('hidden');
+    document.getElementById(id + '-chevron').classList.toggle('rotate-180');
+}
+
+function showLog(id) {
+    document.getElementById('log-' + id).classList.toggle('hidden');
+}
+
+document.getElementById('update-modal').addEventListener('click', function(e) {
+    if (e.target === this) closeUpdateModal();
+});
+</script>
+@endpush
diff --git a/app/Modules/Admin/Services/UpdateService.php b/app/Modules/Admin/Services/UpdateService.php
new file mode 100644
index 0000000..81bd51f
--- /dev/null
+++ b/app/Modules/Admin/Services/UpdateService.php
@@ -0,0 +1,513 @@
+<?php
+
+namespace Modules\Admin\Services;
+
+use App\Models\UpdateLog;
+use Illuminate\Support\Facades\Http;
+
+class UpdateService
+{
+    private const GITHUB_API = 'https://api.github.com';
+
+    private string $owner;
+    private string $repo;
+    private ?string $githubToken;
+    private string $channel;
+
+    public function __construct()
+    {
+        $this->owner        = settings('update.repo_owner', config('update.repository.owner', 'wow-cms'));
+        $this->repo         = settings('update.repo_name',  config('update.repository.name', 'nexuscms'));
+        $this->githubToken  = settings('update.github_token', config('update.github_token'));
+        $this->channel      = settings('update.channel',    config('update.channel', 'stable'));
+    }
+
+    // ─── HTTP Client ─────────────────────────────────────────────────────────
+
+    private function http(): \Illuminate\Http\Client\PendingRequest
+    {
+        $client = Http::timeout(15)
+            ->acceptJson()
+            ->withHeaders(['User-Agent' => 'NexusCMS-Updater/1.0']);
+
+        if (!empty($this->githubToken)) {
+            $client = $client->withToken($this->githubToken);
+        }
+
+        return $client;
+    }
+
+    // ─── Release Discovery ───────────────────────────────────────────────────
+
+    /**
+     * Fetch the latest release matching the configured channel.
+     */
+    public function getLatestRelease(): ?array
+    {
+        try {
+            if ($this->channel === 'stable') {
+                $response = $this->http()->get(
+                    self::GITHUB_API . "/repos/{$this->owner}/{$this->repo}/releases/latest"
+                );
+
+                if (!$response->ok()) {
+                    return null;
+                }
+
+                $data = $response->json();
+                return is_array($data) ? $this->normalize($data) : null;
+            }
+
+            // For beta/any channel, fetch list and pick first matching
+            $releases = $this->getReleases(20);
+            return $this->matchChannel($releases);
+
+        } catch (\Throwable) {
+            return null;
+        }
+    }
+
+    /**
+     * Fetch the N most recent releases.
+     */
+    public function getReleases(int $limit = 10): array
+    {
+        try {
+            $response = $this->http()->get(
+                self::GITHUB_API . "/repos/{$this->owner}/{$this->repo}/releases",
+                ['per_page' => min($limit, 30)]
+            );
+
+            if (!$response->ok()) {
+                return [];
+            }
+
+            $data = $response->json();
+            return is_array($data) ? array_map([$this, 'normalize'], $data) : [];
+
+        } catch (\Throwable) {
+            return [];
+        }
+    }
+
+    /**
+     * Fetch a specific release by tag name.
+     */
+    public function getReleaseByTag(string $tag): ?array
+    {
+        try {
+            $response = $this->http()->get(
+                self::GITHUB_API . "/repos/{$this->owner}/{$this->repo}/releases/tags/{$tag}"
+            );
+
+            if (!$response->ok()) {
+                return null;
+            }
+
+            $data = $response->json();
+            return is_array($data) ? $this->normalize($data) : null;
+
+        } catch (\Throwable) {
+            return null;
+        }
+    }
+
+    private function normalize(array $release): array
+    {
+        $rawTag = $release['tag_name'] ?? '';
+        $tag    = ltrim($rawTag, 'v');
+
+        return [
+            'tag'          => $tag,
+            'tag_name'     => $rawTag ?: $tag,
+            'name'         => $release['name'] ?? $rawTag,
+            'body'         => trim($release['body'] ?? ''),
+            'prerelease'   => (bool) ($release['prerelease'] ?? false),
+            'draft'        => (bool) ($release['draft'] ?? false),
+            'published_at' => $release['published_at'] ?? null,
+            'html_url'     => $release['html_url'] ?? '',
+            'zipball_url'  => $release['zipball_url'] ?? '',
+        ];
+    }
+
+    private function matchChannel(array $releases): ?array
+    {
+        foreach ($releases as $release) {
+            if ($release['draft']) {
+                continue;
+            }
+
+            if ($this->channel === 'stable' && $release['prerelease']) {
+                continue;
+            }
+
+            return $release;
+        }
+
+        return null;
+    }
+
+    // ─── Version Comparison ──────────────────────────────────────────────────
+
+    public function isOutdated(?array $latest = null): bool
+    {
+        $latest = $latest ?? $this->getLatestRelease();
+
+        if (!$latest) {
+            return false;
+        }
+
+        $current     = ltrim((string) config('app.version', '0.0.0'), 'v');
+        $latestClean = ltrim($latest['tag_name'] ?? $latest['tag'] ?? '', 'v');
+
+        // Compare base versions (strip pre-release suffix) first
+        $currentBase = preg_replace('/[-+].*$/', '', $current);
+        $latestBase  = preg_replace('/[-+].*$/', '', $latestClean);
+
+        if (version_compare($latestBase, $currentBase, '>')) {
+            return true;
+        }
+
+        if (version_compare($latestBase, $currentBase, '<')) {
+            return false;
+        }
+
+        // Base versions are equal — compare full strings so that
+        // 0.1.6-alpha.1 is considered newer than 0.1.6-alpha
+        if ($latestClean === $current) {
+            return false;
+        }
+
+        return version_compare($latestClean, $current, '>');
+    }
+
+    // ─── Pre-flight Checks ───────────────────────────────────────────────────
+
+    public function preflight(): array
+    {
+        $method  = $this->detectMethod();
+        $checks  = [];
+
+        $checks[] = $this->check(
+            'Write permission — base path',
+            is_writable(base_path()),
+            base_path()
+        );
+
+        $checks[] = $this->check(
+            'Write permission — storage',
+            is_writable(storage_path()),
+            storage_path()
+        );
+
+        $execEnabled = function_exists('exec') &&
+            !in_array('exec', array_map('trim', explode(',', (string) ini_get('disable_functions'))));
+
+        $checks[] = $this->check(
+            'PHP exec() enabled',
+            $execEnabled,
+            'Required to run Artisan commands post-update'
+        );
+
+        if ($method === 'git') {
+            $checks[] = $this->check(
+                'Git binary available',
+                $this->commandExists('git'),
+                'Used to checkout the target release tag'
+            );
+        } else {
+            $free = @disk_free_space(base_path());
+            $checks[] = $this->check(
+                'Disk space (> 50 MB)',
+                $free && $free > 50 * 1024 * 1024,
+                $free ? number_format($free / 1024 / 1024, 1) . ' MB available' : 'Could not determine'
+            );
+
+            $checks[] = $this->check(
+                'PHP ZipArchive extension',
+                class_exists('ZipArchive'),
+                'Required to extract the downloaded release archive'
+            );
+        }
+
+        return $checks;
+    }
+
+    private function check(string $name, bool $ok, string $detail = ''): array
+    {
+        return compact('name', 'ok', 'detail');
+    }
+
+    // ─── Update Method Detection ─────────────────────────────────────────────
+
+    public function detectMethod(): string
+    {
+        if (is_dir(base_path('.git')) && $this->commandExists('git')) {
+            return 'git';
+        }
+
+        return 'zip';
+    }
+
+    private function commandExists(string $command): bool
+    {
+        $test = PHP_OS_FAMILY === 'Windows' ? "where {$command}" : "which {$command}";
+        exec($test . ' 2>&1', $output, $code);
+
+        return $code === 0;
+    }
+
+    // ─── Apply Update ────────────────────────────────────────────────────────
+
+    /**
+     * Apply a specific release tag. Returns ['success', 'log', 'error?'].
+     */
+    public function apply(string $tag, ?int $userId = null): array
+    {
+        $fromVersion = (string) config('app.version', '0.0.0');
+        $method      = $this->detectMethod();
+        $log         = [];
+        $inMaintenance = false;
+
+        try {
+            // 1 ─ Maintenance mode
+            if (settings('update.maintenance_mode', config('update.maintenance_mode', true))) {
+                $this->run(PHP_BINARY . ' artisan down --retry=60', $log);
+                $inMaintenance = true;
+            }
+
+            // 2 ─ Apply files
+            if ($method === 'git') {
+                $this->applyViaGit($tag, $log);
+            } else {
+                $release = $this->getReleaseByTag($tag);
+
+                if (!$release || empty($release['zipball_url'])) {
+                    throw new \RuntimeException("Release '{$tag}' not found or has no downloadable archive.");
+                }
+
+                $this->applyViaZip($release['zipball_url'], $tag, $log);
+            }
+
+            // 3 ─ Composer (if composer.json changed)
+            if ($method === 'zip' && $this->commandExists('composer')) {
+                $this->run('composer install --no-dev --optimize-autoloader --no-interaction', $log);
+            }
+
+            // 4 ─ Migrations
+            $this->run(PHP_BINARY . ' artisan migrate --force', $log);
+
+            // 5 ─ Clear caches
+            $this->run(PHP_BINARY . ' artisan optimize:clear', $log);
+
+            // 6 ─ Update .env version
+            $this->writeEnvVersion($tag);
+            $log[] = "✔ Updated APP_VERSION={$tag} in .env";
+
+            // 7 ─ Bring back up
+            if ($inMaintenance) {
+                $this->run(PHP_BINARY . ' artisan up', $log);
+                $inMaintenance = false;
+            }
+
+            // 8 ─ Persist log
+            UpdateLog::create([
+                'from_version' => $fromVersion,
+                'to_version'   => $tag,
+                'method'       => $method,
+                'status'       => 'success',
+                'notes'        => implode("\n", $log),
+                'executed_by'  => $userId,
+            ]);
+
+            return ['success' => true, 'log' => $log];
+
+        } catch (\Throwable $e) {
+            // Always attempt to bring the site back up
+            if ($inMaintenance) {
+                try {
+                    $this->run(PHP_BINARY . ' artisan up', $log);
+                } catch (\Throwable) {
+                    $log[] = '⚠ Could not automatically bring the site back up — run `php artisan up` manually.';
+                }
+            }
+
+            $log[] = '✘ ERROR: ' . $e->getMessage();
+
+            UpdateLog::create([
+                'from_version' => $fromVersion,
+                'to_version'   => $tag,
+                'method'       => $method,
+                'status'       => 'failed',
+                'notes'        => implode("\n", $log),
+                'executed_by'  => $userId,
+            ]);
+
+            return ['success' => false, 'log' => $log, 'error' => $e->getMessage()];
+        }
+    }
+
+    // ─── Git Strategy ────────────────────────────────────────────────────────
+
+    private function applyViaGit(string $tag, array &$log): void
+    {
+        // Stash any local uncommitted changes to avoid conflicts
+        $this->run('git stash', $log);
+        $this->run('git fetch --tags --force', $log);
+        $this->run("git checkout tags/{$tag}", $log);
+    }
+
+    // ─── ZIP Strategy ────────────────────────────────────────────────────────
+
+    private function applyViaZip(string $url, string $tag, array &$log): void
+    {
+        if (!class_exists('ZipArchive')) {
+            throw new \RuntimeException('The PHP ZipArchive extension is required for ZIP-based updates.');
+        }
+
+        $log[] = "Downloading archive for {$tag}...";
+
+        $zipBytes = $this->http()->get($url)->body();
+
+        if (empty($zipBytes)) {
+            throw new \RuntimeException('Downloaded archive is empty. The GitHub token may be missing or the release URL is invalid.');
+        }
+
+        $tmpZip = sys_get_temp_dir() . DIRECTORY_SEPARATOR . "nexuscms-update-{$tag}.zip";
+        file_put_contents($tmpZip, $zipBytes);
+        $log[] = 'Archive saved to ' . $tmpZip;
+
+        $tmpDir = sys_get_temp_dir() . DIRECTORY_SEPARATOR . "nexuscms-update-{$tag}";
+        $zip = new \ZipArchive();
+
+        if ($zip->open($tmpZip) !== true) {
+            throw new \RuntimeException('Failed to open the downloaded ZIP archive.');
+        }
+
+        $zip->extractTo($tmpDir);
+        $zip->close();
+        $log[] = 'Archive extracted.';
+
+        // GitHub ZIP has a single top-level directory: owner-repo-{sha}/
+        $topDirs = glob($tmpDir . DIRECTORY_SEPARATOR . '*', GLOB_ONLYDIR);
+        $sourceDir = !empty($topDirs) ? $topDirs[0] : $tmpDir;
+
+        $log[] = 'Copying files to application root...';
+        $this->copyDirectory($sourceDir, base_path(), $log);
+
+        // Cleanup
+        @unlink($tmpZip);
+        $this->deleteDirectory($tmpDir);
+
+        $log[] = 'Files applied.';
+    }
+
+    private function copyDirectory(string $source, string $dest, array &$log): void
+    {
+        $skipPaths = config('update.skip_paths', []);
+
+        $iterator = new \RecursiveIteratorIterator(
+            new \RecursiveDirectoryIterator($source, \RecursiveDirectoryIterator::SKIP_DOTS),
+            \RecursiveIteratorIterator::SELF_FIRST
+        );
+
+        foreach ($iterator as $item) {
+            $relative = ltrim(str_replace($source, '', $item->getPathname()), DIRECTORY_SEPARATOR . '/');
+
+            foreach ($skipPaths as $skip) {
+                $skip = ltrim(rtrim($skip, '/'), '/');
+                if ($relative === $skip || str_starts_with($relative, $skip . DIRECTORY_SEPARATOR) || str_starts_with($relative, $skip . '/')) {
+                    continue 2;
+                }
+            }
+
+            $target = $dest . DIRECTORY_SEPARATOR . $relative;
+
+            if ($item->isDir()) {
+                if (!is_dir($target)) {
+                    mkdir($target, 0755, true);
+                }
+            } else {
+                copy($item->getPathname(), $target);
+            }
+        }
+    }
+
+    private function deleteDirectory(string $dir): void
+    {
+        if (!is_dir($dir)) {
+            return;
+        }
+
+        foreach (scandir($dir) as $entry) {
+            if ($entry === '.' || $entry === '..') {
+                continue;
+            }
+
+            $path = $dir . DIRECTORY_SEPARATOR . $entry;
+            is_dir($path) ? $this->deleteDirectory($path) : @unlink($path);
+        }
+
+        @rmdir($dir);
+    }
+
+    // ─── Shell Execution ─────────────────────────────────────────────────────
+
+    private function run(string $command, array &$log): void
+    {
+        $base = base_path();
+
+        $wrapped = PHP_OS_FAMILY === 'Windows'
+            ? 'cd /d ' . escapeshellarg($base) . ' && ' . $command . ' 2>&1'
+            : 'cd ' . escapeshellarg($base) . ' && ' . $command . ' 2>&1';
+
+        $output = [];
+        $code   = 0;
+        exec($wrapped, $output, $code);
+
+        $log[] = '$ ' . $command;
+        foreach ($output as $line) {
+            if (trim($line) !== '') {
+                $log[] = '  ' . $line;
+            }
+        }
+
+        if ($code !== 0) {
+            throw new \RuntimeException(
+                "Command failed (exit {$code}): {$command}\n" . implode("\n", array_filter($output))
+            );
+        }
+    }
+
+    // ─── .env Version Update ─────────────────────────────────────────────────
+
+    private function writeEnvVersion(string $tag): void
+    {
+        $envPath = base_path('.env');
+
+        if (!is_file($envPath) || !is_writable($envPath)) {
+            return;
+        }
+
+        $version = ltrim($tag, 'v');
+        $content = file_get_contents($envPath);
+
+        if (str_contains($content, 'APP_VERSION=')) {
+            $content = preg_replace('/^APP_VERSION=.*/m', "APP_VERSION={$version}", $content);
+        } else {
+            $content .= "\nAPP_VERSION={$version}";
+        }
+
+        file_put_contents($envPath, $content);
+    }
+
+    // ─── Update History ──────────────────────────────────────────────────────
+
+    public function getHistory(int $limit = 15): \Illuminate\Database\Eloquent\Collection
+    {
+        return UpdateLog::with('executor')
+            ->latest()
+            ->limit($limit)
+            ->get();
+    }
+}
diff --git a/config/update.php b/config/update.php
new file mode 100644
index 0000000..7512f75
--- /dev/null
+++ b/config/update.php
@@ -0,0 +1,86 @@
+<?php
+
+return [
+
+    /*
+    |--------------------------------------------------------------------------
+    | Auto-Update System
+    |--------------------------------------------------------------------------
+    |
+    | Configuration for the NexusCMS built-in updater.
+    | The updater fetches releases from GitHub (direct API or via proxy)
+    | and applies them either through git or zip extraction.
+    |
+    */
+
+    'enabled' => env('UPDATE_ENABLED', true),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Source Repository
+    |--------------------------------------------------------------------------
+    |
+    | The GitHub owner and repository name to check for updates.
+    | Change these if you are running a fork or a private mirror.
+    |
+    */
+    'repository' => [
+        'owner' => env('UPDATE_REPO_OWNER', 'wow-cms'),
+        'name'  => env('UPDATE_REPO_NAME', 'nexuscms'),
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | GitHub Token
+    |--------------------------------------------------------------------------
+    |
+    | Optional GitHub personal access token. Required for private repositories
+    | or to avoid GitHub API rate limits (60 requests/hour anonymous).
+    |
+    */
+    'github_token' => env('GITHUB_TOKEN'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Release Channel
+    |--------------------------------------------------------------------------
+    |
+    | Controls which releases are considered when checking for updates:
+    |   "stable" — only non-prerelease tagged releases  (recommended)
+    |   "beta"   — includes pre-releases flagged as beta
+    |   "any"    — includes all published releases (including alpha/RC)
+    |
+    */
+    'channel' => env('UPDATE_CHANNEL', 'any'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Maintenance Mode
+    |--------------------------------------------------------------------------
+    |
+    | If true, the updater will call `artisan down` before applying the update
+    | and `artisan up` afterwards, regardless of success or failure.
+    |
+    */
+    'maintenance_mode' => env('UPDATE_MAINTENANCE_MODE', true),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Paths Excluded from ZIP Updates
+    |--------------------------------------------------------------------------
+    |
+    | When applying a ZIP-based update, these paths (relative to base_path)
+    | will be skipped to avoid overwriting local configuration and data.
+    |
+    */
+    'skip_paths' => [
+        '.env',
+        '.env.production',
+        'vendor',
+        'node_modules',
+        'storage',
+        'public/uploads',
+        'public/storage',
+    ],
+
+];
diff --git a/database/migrations/2026_05_23_000001_create_update_logs_table.php b/database/migrations/2026_05_23_000001_create_update_logs_table.php
new file mode 100644
index 0000000..ed4399d
--- /dev/null
+++ b/database/migrations/2026_05_23_000001_create_update_logs_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
+{
+    public function up(): void
+    {
+        Schema::create('update_logs', function (Blueprint $table) {
+            $table->id();
+            $table->string('from_version', 50)->nullable();
+            $table->string('to_version', 50);
+            $table->string('method', 20)->default('git'); // git | zip
+            $table->string('status', 20)->default('pending'); // pending | success | failed
+            $table->text('notes')->nullable();
+            $table->foreignId('executed_by')->nullable()->constrained('users')->nullOnDelete();
+            $table->timestamps();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('update_logs');
+    }
+};

From c04dea030d51961dafde7c15080161bb55ef4886 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 23 May 2026 23:51:31 +0200
Subject: [PATCH 116/132] feat: Add CSRF token meta tag and enhance GitHub
 remote handling in UpdateService

---
 .../Admin/Resources/views/layouts/app.blade.php     |  1 +
 app/Modules/Admin/Services/UpdateService.php        | 13 +++++++++++--
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index ecc386a..2640697 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -3,6 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="csrf-token" content="{{ csrf_token() }}">
     <title>{{ config('app.name', 'NexusCMS') }} · @yield('title', 'Dashboard')</title>
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.0/css/all.min.css">
     <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
diff --git a/app/Modules/Admin/Services/UpdateService.php b/app/Modules/Admin/Services/UpdateService.php
index 81bd51f..0bbb9d1 100644
--- a/app/Modules/Admin/Services/UpdateService.php
+++ b/app/Modules/Admin/Services/UpdateService.php
@@ -351,10 +351,19 @@ public function apply(string $tag, ?int $userId = null): array
 
     private function applyViaGit(string $tag, array &$log): void
     {
-        // Stash any local uncommitted changes to avoid conflicts
+        // Build the GitHub remote URL from configured owner/repo
+        $token    = $this->githubToken;
+        $repoUrl  = $token
+            ? "https://{$token}@github.com/{$this->owner}/{$this->repo}.git"
+            : "https://github.com/{$this->owner}/{$this->repo}.git";
+
+        // Use a dedicated remote (nexus-update) so we don't disturb the existing origin
+        $this->run('git remote remove nexus-update 2>/dev/null || true', $log);
+        $this->run("git remote add nexus-update {$repoUrl}", $log);
         $this->run('git stash', $log);
-        $this->run('git fetch --tags --force', $log);
+        $this->run('git fetch nexus-update --tags --force', $log);
         $this->run("git checkout tags/{$tag}", $log);
+        $this->run('git remote remove nexus-update', $log);
     }
 
     // ─── ZIP Strategy ────────────────────────────────────────────────────────

From 089b070074c976e6f0887397d6b125d9fb493cbc Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 23 May 2026 23:53:04 +0200
Subject: [PATCH 117/132] feat: Enhance CSRF token handling and improve GitHub
 remote management in UpdateService

---
 .../Resources/views/updates/index.blade.php   |  2 +-
 app/Modules/Admin/Services/UpdateService.php  | 23 +++++++++++++++----
 2 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/app/Modules/Admin/Resources/views/updates/index.blade.php b/app/Modules/Admin/Resources/views/updates/index.blade.php
index d7367ca..d8cdac6 100644
--- a/app/Modules/Admin/Resources/views/updates/index.blade.php
+++ b/app/Modules/Admin/Resources/views/updates/index.blade.php
@@ -348,7 +348,7 @@ function closeUpdateModal() {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
-                'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').content,
+                'X-CSRF-TOKEN': (document.querySelector('meta[name="csrf-token"]')?.content) ?? '{{ csrf_token() }}',
             },
             body: JSON.stringify({ tag: pendingTag }),
         });
diff --git a/app/Modules/Admin/Services/UpdateService.php b/app/Modules/Admin/Services/UpdateService.php
index 0bbb9d1..7ebd452 100644
--- a/app/Modules/Admin/Services/UpdateService.php
+++ b/app/Modules/Admin/Services/UpdateService.php
@@ -352,18 +352,21 @@ public function apply(string $tag, ?int $userId = null): array
     private function applyViaGit(string $tag, array &$log): void
     {
         // Build the GitHub remote URL from configured owner/repo
-        $token    = $this->githubToken;
-        $repoUrl  = $token
+        $token   = $this->githubToken;
+        $repoUrl = $token
             ? "https://{$token}@github.com/{$this->owner}/{$this->repo}.git"
             : "https://github.com/{$this->owner}/{$this->repo}.git";
 
-        // Use a dedicated remote (nexus-update) so we don't disturb the existing origin
-        $this->run('git remote remove nexus-update 2>/dev/null || true', $log);
+        // Silently remove the temporary remote if it already exists (ignore errors)
+        $this->runSilent('git remote remove nexus-update', $log);
+
         $this->run("git remote add nexus-update {$repoUrl}", $log);
         $this->run('git stash', $log);
         $this->run('git fetch nexus-update --tags --force', $log);
         $this->run("git checkout tags/{$tag}", $log);
-        $this->run('git remote remove nexus-update', $log);
+
+        // Clean up the temporary remote (ignore errors)
+        $this->runSilent('git remote remove nexus-update', $log);
     }
 
     // ─── ZIP Strategy ────────────────────────────────────────────────────────
@@ -488,6 +491,16 @@ private function run(string $command, array &$log): void
         }
     }
 
+    // Same as run() but never throws — failures are logged as warnings only
+    private function runSilent(string $command, array &$log): void
+    {
+        try {
+            $this->run($command, $log);
+        } catch (\RuntimeException) {
+            // Intentionally ignored
+        }
+    }
+
     // ─── .env Version Update ─────────────────────────────────────────────────
 
     private function writeEnvVersion(string $tag): void

From 6996e079a9d4d992b4b87170b7fd8a4173adde18 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 26 May 2026 00:33:08 +0200
Subject: [PATCH 118/132] feat: Refactor update handling and settings for
 improved clarity and functionality

---
 .../Http/Controllers/AdminController.php      | 17 ++-----
 .../Http/Controllers/UpdateController.php     |  2 +-
 .../Admin/Resources/views/index.blade.php     | 28 ++++++-----
 .../views/settings/updates.blade.php          | 28 +++++------
 .../Resources/views/updates/index.blade.php   | 49 +++++++++++++++----
 app/Modules/Admin/Services/UpdateService.php  | 47 +++++++++++++-----
 6 files changed, 109 insertions(+), 62 deletions(-)

diff --git a/app/Modules/Admin/Http/Controllers/AdminController.php b/app/Modules/Admin/Http/Controllers/AdminController.php
index 706e9ff..da13711 100644
--- a/app/Modules/Admin/Http/Controllers/AdminController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminController.php
@@ -3,25 +3,18 @@
 namespace Modules\Admin\Http\Controllers;
 
 use App\Http\Controllers\Controller;
-use Modules\Admin\Services\ApiService;
+use Modules\Admin\Services\UpdateService;
 use Illuminate\Http\Request;
 
 class AdminController extends Controller
 {
-    protected ApiService $apiService;
-
-    public function __construct(ApiService $apiService)
-    {
-        $this->apiService = $apiService;
-    }
+    public function __construct(protected UpdateService $updateService) {}
 
     public function index(Request $request)
     {
-        $latestRelease = $this->apiService->latestRelease();
-        $checkVersion = $this->apiService->checkVersion('wow-cms', 'nexuscms', config('app.version'));
-
-        $outdated = $checkVersion['outdated'] ?? false;
+        $latestRelease = $this->updateService->getLatestRelease();
+        $outdated      = $this->updateService->isOutdated($latestRelease);
 
-        return view('admin::index', compact('latestRelease', 'checkVersion', 'outdated'));  
+        return view('admin::index', compact('latestRelease', 'outdated'));
     }
 }
diff --git a/app/Modules/Admin/Http/Controllers/UpdateController.php b/app/Modules/Admin/Http/Controllers/UpdateController.php
index 9e571a3..b08d8c7 100644
--- a/app/Modules/Admin/Http/Controllers/UpdateController.php
+++ b/app/Modules/Admin/Http/Controllers/UpdateController.php
@@ -30,7 +30,7 @@ public function index()
 
     public function apply(Request $request)
     {
-        if (!settings('update.enabled', config('update.enabled', true))) {
+        if (!settings('update_enabled', config('update.enabled', true))) {
             return response()->json(['success' => false, 'error' => 'The auto-update system is disabled.'], 403);
         }
 
diff --git a/app/Modules/Admin/Resources/views/index.blade.php b/app/Modules/Admin/Resources/views/index.blade.php
index 111c10e..abba016 100644
--- a/app/Modules/Admin/Resources/views/index.blade.php
+++ b/app/Modules/Admin/Resources/views/index.blade.php
@@ -248,14 +248,14 @@
                     <span class="px-3 py-1 bg-green-100 text-green-700 rounded-full text-xs font-semibold shadow-sm">v{{ config('app.version') }}</span>
                 </div>
                 <div class="p-6">
-                    @if(empty($checkVersion))
+                    @if($latestRelease === null)
                     <div class="flex items-start gap-4">
                         <div class="w-12 h-12 bg-gradient-to-br from-gray-400 to-gray-500 rounded-xl flex items-center justify-center shadow-md">
                             <i class="fas fa-plug text-white text-xl"></i>
                         </div>
                         <div class="flex-1">
                             <p class="text-base text-gray-800 font-semibold mb-1">Could not connect to the update server</p>
-                            <p class="text-sm text-gray-500">Version information is unavailable. Please check your internet connection and try again later.</p>
+                            <p class="text-sm text-gray-500">Version information is unavailable. Check your internet connection or verify the repository and GitHub token in <a href="{{ route('admin.settings.index') }}#updates" class="text-blue-600 hover:underline">Settings → Updates</a>.</p>
                         </div>
                     </div>
                     @elseif($outdated)
@@ -264,25 +264,27 @@
                             <i class="fas fa-rocket text-white text-xl"></i>
                         </div>
                         <div class="flex-1">
-                            <p class="text-base text-gray-800 font-semibold mb-1">NexusCMS v{{ $latestRelease['tag_name'] ?? 'N/A' }} is now available</p>
-                            <p class="text-sm text-gray-600 mb-3">{{ $latestRelease['body'] ?? 'N/A' }}</p>
+                            <p class="text-base text-gray-800 font-semibold mb-1">NexusCMS {{ $latestRelease['tag_name'] }} is now available</p>
+                            <p class="text-sm text-gray-600 mb-3">{{ Str::limit($latestRelease['body'] ?? '', 120) }}</p>
                             <div class="flex items-center gap-3">
-                                <a href="https://github.com/WoW-CMS/NexusCMS/releases/tag/{{ $latestRelease['tag_name'] ?? 'N/A' }}" target="_blank" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
+                                <a href="{{ route('admin.updates.index') }}" class="inline-flex items-center gap-1.5 px-4 py-1.5 bg-blue-600 text-white text-sm font-medium rounded-lg hover:bg-blue-700 transition shadow-sm">
+                                    <i class="fas fa-cloud-arrow-up text-xs"></i> Update now
+                                </a>
+                                <a href="{{ $latestRelease['html_url'] }}" target="_blank" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
                             </div>
                         </div>
                     </div>
                     @else
                     <div class="flex items-start gap-4">
-                        <div class="w-12 h-12 bg-gradient-to-br from-blue-500 to-indigo-600 rounded-xl flex items-center justify-center shadow-md">
-                            <i class="fas fa-rocket text-white text-xl"></i>
+                        <div class="w-12 h-12 bg-gradient-to-br from-green-400 to-emerald-500 rounded-xl flex items-center justify-center shadow-md">
+                            <i class="fas fa-circle-check text-white text-xl"></i>
                         </div>
                         <div class="flex-1">
-                            <p class="text-base text-gray-800 font-semibold mb-1">You are using the latest version</p>
-                            <p class="text-sm text-gray-600">Version {{ $latestRelease['tag_name'] ?? 'N/A' }}</p>
-                            <p class="text-sm text-gray-600">Released on {{ $latestRelease['published_at'] ?? 'N/A' }}</p>
-                            <div class="flex items-center gap-3">
-                                <a href="https://github.com/WoW-CMS/NexusCMS/releases/tag/{{ $latestRelease['tag_name'] ?? 'N/A' }}" target="_blank" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
-                                <span class="text-gray-300">•</span>
+                            <p class="text-base text-gray-800 font-semibold mb-1">You are up to date</p>
+                            <p class="text-sm text-gray-600">Version {{ $latestRelease['tag_name'] }} —
+                                released {{ \Carbon\Carbon::parse($latestRelease['published_at'])->diffForHumans() }}</p>
+                            <div class="flex items-center gap-3 mt-2">
+                                <a href="{{ $latestRelease['html_url'] }}" target="_blank" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
                             </div>
                         </div>
                     </div>
diff --git a/app/Modules/Admin/Resources/views/settings/updates.blade.php b/app/Modules/Admin/Resources/views/settings/updates.blade.php
index 5bcdf64..024ca66 100644
--- a/app/Modules/Admin/Resources/views/settings/updates.blade.php
+++ b/app/Modules/Admin/Resources/views/settings/updates.blade.php
@@ -15,16 +15,16 @@
         <div class="p-6 grid sm:grid-cols-2 gap-6">
             <div>
                 <label class="block text-sm font-medium text-gray-700 mb-1">Repository Owner</label>
-                <input type="text" name="update.repo_owner"
-                    value="{{ old('update.repo_owner', $settings->get('update.repo_owner', 'wow-cms')) }}"
+                <input type="text" name="update_repo_owner"
+                    value="{{ old('update_repo_owner', $settings->get('update_repo_owner', 'wow-cms')) }}"
                     placeholder="e.g. wow-cms"
                     class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">
                 <p class="text-xs text-gray-400 mt-1">GitHub username or organisation.</p>
             </div>
             <div>
                 <label class="block text-sm font-medium text-gray-700 mb-1">Repository Name</label>
-                <input type="text" name="update.repo_name"
-                    value="{{ old('update.repo_name', $settings->get('update.repo_name', 'nexuscms')) }}"
+                <input type="text" name="update_repo_name"
+                    value="{{ old('update_repo_name', $settings->get('update_repo_name', 'nexuscms')) }}"
                     placeholder="e.g. nexuscms"
                     class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent">
                 <p class="text-xs text-gray-400 mt-1">Exact repository name (case-sensitive).</p>
@@ -34,8 +34,8 @@ class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:ring-2 f
                     GitHub Token
                     <span class="text-xs font-normal text-gray-400 ml-1">(optional)</span>
                 </label>
-                <input type="password" name="update.github_token"
-                    value="{{ old('update.github_token', $settings->get('update.github_token', '')) }}"
+                <input type="password" name="update_github_token"
+                    value="{{ old('update_github_token', $settings->get('update_github_token', '')) }}"
                     placeholder="ghp_xxxxxxxxxxxx"
                     autocomplete="new-password"
                     class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:ring-2 focus:ring-blue-500 focus:border-transparent font-mono">
@@ -62,7 +62,7 @@ class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:ring-2 f
                 <label class="block text-sm font-medium text-gray-700 mb-2">Release Channel</label>
                 <div class="grid sm:grid-cols-3 gap-3">
                     @php
-                        $currentChannel = $settings->get('update.channel', 'stable');
+                        $currentChannel = $settings->get('update_channel', 'any');
                         $channels = [
                             'stable' => ['label' => 'Stable', 'desc' => 'Only full releases', 'icon' => 'fa-shield-check', 'color' => 'green'],
                             'beta'   => ['label' => 'Beta',   'desc' => 'Includes pre-releases', 'icon' => 'fa-flask', 'color' => 'orange'],
@@ -71,7 +71,7 @@ class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:ring-2 f
                     @endphp
                     @foreach($channels as $val => $ch)
                     <label class="relative cursor-pointer">
-                        <input type="radio" name="update.channel" value="{{ $val }}"
+                        <input type="radio" name="update_channel" value="{{ $val }}"
                             {{ $currentChannel === $val ? 'checked' : '' }}
                             class="sr-only peer">
                         <div class="border-2 rounded-xl p-4 transition
@@ -98,9 +98,9 @@ class="sr-only peer">
                         <p class="text-xs text-gray-400 mt-0.5">Enable or disable the update checker and apply button.</p>
                     </div>
                     <label class="relative inline-flex items-center cursor-pointer shrink-0">
-                        <input type="hidden" name="update.enabled" value="0">
-                        <input type="checkbox" name="update.enabled" value="1"
-                            {{ $settings->get('update.enabled', '1') == '1' ? 'checked' : '' }}
+                        <input type="hidden" name="update_enabled" value="0">
+                        <input type="checkbox" name="update_enabled" value="1"
+                            {{ $settings->get('update_enabled', '1') == '1' ? 'checked' : '' }}
                             class="sr-only peer">
                         <div class="w-11 h-6 bg-gray-200 peer-focus:ring-2 peer-focus:ring-blue-300 rounded-full peer
                                     peer-checked:after:translate-x-full peer-checked:after:border-white
@@ -117,9 +117,9 @@ class="sr-only peer">
                         <p class="text-xs text-gray-400 mt-0.5">Put the site in maintenance mode while applying an update.</p>
                     </div>
                     <label class="relative inline-flex items-center cursor-pointer shrink-0">
-                        <input type="hidden" name="update.maintenance_mode" value="0">
-                        <input type="checkbox" name="update.maintenance_mode" value="1"
-                            {{ $settings->get('update.maintenance_mode', '1') == '1' ? 'checked' : '' }}
+                        <input type="hidden" name="update_maintenance_mode" value="0">
+                        <input type="checkbox" name="update_maintenance_mode" value="1"
+                            {{ $settings->get('update_maintenance_mode', '1') == '1' ? 'checked' : '' }}
                             class="sr-only peer">
                         <div class="w-11 h-6 bg-gray-200 peer-focus:ring-2 peer-focus:ring-blue-300 rounded-full peer
                                     peer-checked:after:translate-x-full peer-checked:after:border-white
diff --git a/app/Modules/Admin/Resources/views/updates/index.blade.php b/app/Modules/Admin/Resources/views/updates/index.blade.php
index d8cdac6..962780b 100644
--- a/app/Modules/Admin/Resources/views/updates/index.blade.php
+++ b/app/Modules/Admin/Resources/views/updates/index.blade.php
@@ -26,7 +26,7 @@ class="px-4 py-2 bg-white border border-gray-300 text-gray-700 rounded-lg hover:
     {{-- Main Content --}}
     <main class="flex-1 overflow-y-auto bg-gray-50 p-6 space-y-6">
 
-        @if(!settings('update.enabled', config('update.enabled', true)))
+        @if(!settings('update_enabled', config('update.enabled', true)))
         <div class="bg-yellow-50 border border-yellow-200 rounded-xl p-6 flex items-start gap-4">
             <i class="fas fa-ban text-yellow-500 text-xl mt-0.5"></i>
             <div>
@@ -43,7 +43,7 @@ class="px-4 py-2 bg-white border border-gray-300 text-gray-700 rounded-lg hover:
                 <p class="font-semibold text-gray-800">Could not reach GitHub</p>
                 <p class="text-sm text-gray-500 mt-1">
                     Unable to fetch release information. Check your internet connection, verify the repository
-                    (<code>{{ settings('update.repo_owner', config('update.repository.owner')) }}/{{ settings('update.repo_name', config('update.repository.name')) }}</code>),
+                    (<code>{{ settings('update_repo_owner', config('update.repository.owner')) }}/{{ settings('update_repo_name', config('update.repository.name')) }}</code>),
                     or add a <code>GITHUB_TOKEN</code> if the repository is private.
                 </p>
             </div>
@@ -95,10 +95,13 @@ class="px-4 py-2 bg-white border border-gray-300 text-gray-700 rounded-lg hover:
                 <div class="flex items-center gap-2 text-sm text-gray-600">
                     <i class="fas fa-{{ $method === 'git' ? 'code-branch' : 'file-zipper' }} {{ $method === 'git' ? 'text-green-500' : 'text-orange-500' }}"></i>
                     Update method: <strong>{{ strtoupper($method) }}</strong>
-                    @php $allOk = collect($checks)->every(fn($c) => $c['ok']) @endphp
-                    <span class="ml-3 flex items-center gap-1 {{ $allOk ? 'text-green-600' : 'text-red-600' }}">
-                        <i class="fas fa-{{ $allOk ? 'circle-check' : 'circle-exclamation' }} text-xs"></i>
-                        {{ $allOk ? 'Pre-flight OK' : 'Pre-flight issues detected' }}
+                    @php
+                        $allOk = collect($checks)->every(fn($c) => $c['ok'] || !($c['required'] ?? true));
+                        $hasWarnings = collect($checks)->contains(fn($c) => !$c['ok'] && !($c['required'] ?? true));
+                    @endphp
+                    <span class="ml-3 flex items-center gap-1 {{ $allOk ? ($hasWarnings ? 'text-yellow-600' : 'text-green-600') : 'text-red-600' }}">
+                        <i class="fas fa-{{ $allOk ? ($hasWarnings ? 'triangle-exclamation' : 'circle-check') : 'circle-exclamation' }} text-xs"></i>
+                        {{ $allOk ? ($hasWarnings ? 'Pre-flight warnings' : 'Pre-flight OK') : 'Pre-flight issues detected' }}
                     </span>
                 </div>
                 <button onclick="openUpdateModal('{{ $latest['tag_name'] }}')"
@@ -153,12 +156,38 @@ class="w-full px-6 py-4 flex items-center justify-between text-left hover:bg-gra
             <div id="preflight" class="hidden border-t border-gray-100">
                 <div class="p-6 grid sm:grid-cols-2 gap-3">
                     @foreach($checks as $check)
-                    <div class="flex items-start gap-3 p-3 rounded-lg {{ $check['ok'] ? 'bg-green-50 border border-green-100' : 'bg-red-50 border border-red-100' }}">
-                        <i class="fas fa-{{ $check['ok'] ? 'circle-check text-green-500' : 'circle-xmark text-red-500' }} mt-0.5 shrink-0"></i>
+                    @php
+                        $required = $check['required'] ?? true;
+                        $ok = $check['ok'];
+                        if ($ok) {
+                            $bgClass = 'bg-green-50 border border-green-100';
+                            $icon = 'circle-check text-green-500';
+                            $textClass = 'text-green-800';
+                            $detailClass = 'text-green-600';
+                            $extraNote = null;
+                        } elseif (!$required) {
+                            $bgClass = 'bg-yellow-50 border border-yellow-100';
+                            $icon = 'triangle-exclamation text-yellow-500';
+                            $textClass = 'text-yellow-800';
+                            $detailClass = 'text-yellow-600';
+                            $extraNote = 'Warning only — won\'t block the update';
+                        } else {
+                            $bgClass = 'bg-red-50 border border-red-100';
+                            $icon = 'circle-xmark text-red-500';
+                            $textClass = 'text-red-800';
+                            $detailClass = 'text-red-600';
+                            $extraNote = null;
+                        }
+                    @endphp
+                    <div class="flex items-start gap-3 p-3 rounded-lg {{ $bgClass }}">
+                        <i class="fas fa-{{ $icon }} mt-0.5 shrink-0"></i>
                         <div class="min-w-0">
-                            <p class="text-sm font-medium {{ $check['ok'] ? 'text-green-800' : 'text-red-800' }}">{{ $check['name'] }}</p>
+                            <p class="text-sm font-medium {{ $textClass }}">{{ $check['name'] }}</p>
                             @if($check['detail'] ?? '')
-                            <p class="text-xs {{ $check['ok'] ? 'text-green-600' : 'text-red-600' }} mt-0.5 truncate" title="{{ $check['detail'] }}">{{ $check['detail'] }}</p>
+                            <p class="text-xs {{ $detailClass }} mt-0.5 truncate" title="{{ $check['detail'] }}">{{ $check['detail'] }}</p>
+                            @endif
+                            @if($extraNote)
+                            <p class="text-xs text-yellow-600 mt-0.5">{{ $extraNote }}</p>
                             @endif
                         </div>
                     </div>
diff --git a/app/Modules/Admin/Services/UpdateService.php b/app/Modules/Admin/Services/UpdateService.php
index 7ebd452..1d65256 100644
--- a/app/Modules/Admin/Services/UpdateService.php
+++ b/app/Modules/Admin/Services/UpdateService.php
@@ -16,10 +16,10 @@ class UpdateService
 
     public function __construct()
     {
-        $this->owner        = settings('update.repo_owner', config('update.repository.owner', 'wow-cms'));
-        $this->repo         = settings('update.repo_name',  config('update.repository.name', 'nexuscms'));
-        $this->githubToken  = settings('update.github_token', config('update.github_token'));
-        $this->channel      = settings('update.channel',    config('update.channel', 'stable'));
+        $this->owner        = settings('update_repo_owner', config('update.repository.owner', 'wow-cms'));
+        $this->repo         = settings('update_repo_name',  config('update.repository.name', 'nexuscms'));
+        $this->githubToken  = settings('update_github_token', config('update.github_token'));
+        $this->channel      = settings('update_channel',    config('update.channel', 'any'));
     }
 
     // ─── HTTP Client ─────────────────────────────────────────────────────────
@@ -185,18 +185,22 @@ public function isOutdated(?array $latest = null): bool
 
     public function preflight(): array
     {
-        $method  = $this->detectMethod();
-        $checks  = [];
+        $method = $this->detectMethod();
+        $checks = [];
 
+        // Write permission on base path: required for zip, warning-only for git
+        // (git runs as www-data via exec but ACLs may differ from PHP file_put_contents)
+        $baseWritable = $this->probeWrite(base_path());
         $checks[] = $this->check(
             'Write permission — base path',
-            is_writable(base_path()),
-            base_path()
+            $baseWritable,
+            base_path(),
+            required: $method !== 'git'
         );
 
         $checks[] = $this->check(
             'Write permission — storage',
-            is_writable(storage_path()),
+            $this->probeWrite(storage_path()),
             storage_path()
         );
 
@@ -233,9 +237,28 @@ class_exists('ZipArchive'),
         return $checks;
     }
 
-    private function check(string $name, bool $ok, string $detail = ''): array
+    private function check(string $name, bool $ok, string $detail = '', bool $required = true): array
     {
-        return compact('name', 'ok', 'detail');
+        return compact('name', 'ok', 'detail', 'required');
+    }
+
+    private function probeWrite(string $path): bool
+    {
+        if (!is_dir($path)) {
+            return false;
+        }
+        $probe = rtrim($path, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR
+            . '.nexus_write_test_' . getmypid();
+        try {
+            $result = @file_put_contents($probe, '1');
+            if ($result !== false) {
+                @unlink($probe);
+                return true;
+            }
+            return false;
+        } catch (\Throwable) {
+            return false;
+        }
     }
 
     // ─── Update Method Detection ─────────────────────────────────────────────
@@ -271,7 +294,7 @@ public function apply(string $tag, ?int $userId = null): array
 
         try {
             // 1 ─ Maintenance mode
-            if (settings('update.maintenance_mode', config('update.maintenance_mode', true))) {
+            if (settings('update_maintenance_mode', config('update.maintenance_mode', true))) {
                 $this->run(PHP_BINARY . ' artisan down --retry=60', $log);
                 $inMaintenance = true;
             }

From fa6ef469ff02c3bfdd839d78993f64a459f85741 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 26 May 2026 00:34:10 +0200
Subject: [PATCH 119/132] feat: Update application version to 0.1.6-alpha.3

---
 config/app.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/config/app.php b/config/app.php
index e20afbc..6cc5a37 100755
--- a/config/app.php
+++ b/config/app.php
@@ -131,5 +131,5 @@
     | The version of the CMS.
     |
     */
-    'version' => env('APP_VERSION', '0.1.6-alpha'),
+    'version' => env('APP_VERSION', '0.1.6-alpha.3'),
 ];

From 59cb7f1bb7cf091afc36011d5126da4e25a432a4 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Tue, 26 May 2026 02:31:53 +0200
Subject: [PATCH 120/132] feat: Enhance update page layout and improve
 preflight checks for update methods

---
 .../Resources/views/updates/index.blade.php   | 467 ++++++++++++++++++
 app/Modules/Admin/Services/UpdateService.php  |  10 +-
 2 files changed, 473 insertions(+), 4 deletions(-)

diff --git a/app/Modules/Admin/Resources/views/updates/index.blade.php b/app/Modules/Admin/Resources/views/updates/index.blade.php
index 962780b..7a424b1 100644
--- a/app/Modules/Admin/Resources/views/updates/index.blade.php
+++ b/app/Modules/Admin/Resources/views/updates/index.blade.php
@@ -2,6 +2,473 @@
 
 @section('Title', 'System Updates')
 
+@section('content')
+<div class="flex-1 flex flex-col overflow-hidden">
+
+    {{-- Header --}}
+    <header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6 shrink-0">
+        <h1 class="text-xl font-bold text-gray-800 flex items-center gap-2">
+            <i class="fas fa-cloud-arrow-up text-blue-600"></i>
+            System Updates
+        </h1>
+        <button onclick="checkForUpdates()" id="check-btn"
+            class="px-4 py-2 bg-white border border-gray-300 text-gray-700 rounded-lg hover:bg-gray-50 text-sm font-medium flex items-center gap-2 transition">
+            <i class="fas fa-sync-alt" id="check-icon"></i>
+            Check for Updates
+        </button>
+    </header>
+
+    {{-- Main Content --}}
+    <main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+
+        @if(!settings('update_enabled', config('update.enabled', true)))
+        <div class="mb-6 bg-yellow-50 border border-yellow-200 rounded-xl p-5 flex items-start gap-4">
+            <i class="fas fa-ban text-yellow-500 text-xl mt-0.5"></i>
+            <div>
+                <p class="font-semibold text-yellow-800">Auto-updates are disabled</p>
+                <p class="text-sm text-yellow-700 mt-1">Enable them from <a href="{{ route('admin.settings.index') }}#updates" class="underline font-medium">Settings → Updates</a>.</p>
+            </div>
+        </div>
+        @endif
+
+        {{-- Status Hero --}}
+        @if(!$latest)
+        {{-- Cannot reach GitHub --}}
+        <div class="mb-6 bg-white rounded-2xl border border-gray-200 shadow-sm overflow-hidden">
+            <div class="bg-gradient-to-r from-gray-100 to-slate-100 px-6 py-5 flex items-center gap-5">
+                <div class="w-14 h-14 bg-gray-300 rounded-2xl flex items-center justify-center shadow-inner shrink-0">
+                    <i class="fas fa-plug text-gray-500 text-xl"></i>
+                </div>
+                <div>
+                    <p class="text-xl font-bold text-gray-700">Could not reach GitHub</p>
+                    <p class="text-sm text-gray-500 mt-0.5">
+                        Unable to fetch release information for
+                        <code class="bg-white/60 px-1 rounded">{{ settings('update_repo_owner', config('update.repository.owner')) }}/{{ settings('update_repo_name', config('update.repository.name')) }}</code>.
+                        Check your connection or add a <code class="bg-white/60 px-1 rounded">GITHUB_TOKEN</code> if the repo is private.
+                    </p>
+                </div>
+            </div>
+        </div>
+
+        @elseif($outdated)
+        {{-- Update Available --}}
+        @php
+            $allOk = collect($checks)->every(fn($c) => $c['ok'] || !($c['required'] ?? true));
+            $requiredFailed = collect($checks)->contains(fn($c) => !$c['ok'] && ($c['required'] ?? true));
+        @endphp
+        <div class="mb-6 bg-white rounded-2xl border border-blue-200 shadow-sm overflow-hidden">
+            <div class="bg-gradient-to-r from-blue-600 to-indigo-600 px-6 py-5">
+                <div class="flex flex-col sm:flex-row sm:items-center justify-between gap-4">
+                    <div class="flex items-center gap-5">
+                        <div class="w-14 h-14 bg-white/20 rounded-2xl flex items-center justify-center shrink-0">
+                            <i class="fas fa-rocket text-white text-2xl"></i>
+                        </div>
+                        <div>
+                            <div class="flex items-center gap-2 mb-1">
+                                <span class="w-2 h-2 rounded-full bg-green-400 animate-pulse inline-block"></span>
+                                <span class="text-white/80 text-sm font-medium uppercase tracking-wide">Update Available</span>
+                            </div>
+                            <p class="text-2xl font-bold text-white">{{ $latest['tag_name'] }}</p>
+                            @if($latest['published_at'])
+                            <p class="text-blue-200 text-sm mt-0.5">Released {{ \Carbon\Carbon::parse($latest['published_at'])->format('F j, Y') }}</p>
+                            @endif
+                        </div>
+                    </div>
+                    <div class="flex items-center gap-3 shrink-0">
+                        <div class="text-center">
+                            <p class="text-blue-200 text-xs mb-1">Current</p>
+                            <span class="px-3 py-1.5 bg-white/20 text-white rounded-lg font-mono text-sm font-semibold">v{{ $current }}</span>
+                        </div>
+                        <i class="fas fa-arrow-right text-blue-300 text-lg"></i>
+                        <div class="text-center">
+                            <p class="text-blue-200 text-xs mb-1">Latest</p>
+                            <span class="px-3 py-1.5 bg-white text-blue-700 rounded-lg font-mono text-sm font-semibold shadow">{{ $latest['tag_name'] }}</span>
+                        </div>
+                    </div>
+                </div>
+            </div>
+
+            <div class="grid md:grid-cols-5 divide-y md:divide-y-0 md:divide-x divide-gray-100">
+                {{-- Release Notes --}}
+                <div class="md:col-span-3 p-6">
+                    <p class="text-xs font-semibold uppercase tracking-wider text-gray-400 mb-3 flex items-center gap-1.5">
+                        <i class="fas fa-file-lines"></i> Release Notes
+                    </p>
+                    @if($latest['body'])
+                    <div class="text-sm text-gray-700 leading-relaxed whitespace-pre-line max-h-40 overflow-y-auto pr-1">{{ $latest['body'] }}</div>
+                    @else
+                    <p class="text-sm text-gray-400 italic">No release notes provided.</p>
+                    @endif
+                    @if($latest['html_url'])
+                    <a href="{{ $latest['html_url'] }}" target="_blank"
+                       class="inline-flex items-center gap-1.5 mt-4 text-sm text-blue-600 hover:text-blue-700 font-medium hover:underline">
+                        <i class="fab fa-github text-base"></i> View on GitHub
+                    </a>
+                    @endif
+                </div>
+
+                {{-- Pre-flight + Apply --}}
+                <div class="md:col-span-2 p-6 bg-gray-50/50 flex flex-col gap-4">
+                    <p class="text-xs font-semibold uppercase tracking-wider text-gray-400 flex items-center gap-1.5">
+                        <i class="fas fa-list-check"></i> Pre-flight
+                        <span class="ml-auto font-normal px-2 py-0.5 rounded-full text-[10px]
+                            {{ $requiredFailed ? 'bg-red-100 text-red-700' : (collect($checks)->contains(fn($c) => !$c['ok']) ? 'bg-yellow-100 text-yellow-700' : 'bg-green-100 text-green-700') }}">
+                            {{ collect($checks)->where('ok', true)->count() }}/{{ count($checks) }} passed
+                        </span>
+                    </p>
+                    <div class="space-y-2">
+                        @foreach($checks as $check)
+                        @php
+                            $req = $check['required'] ?? true;
+                            if ($check['ok']) {
+                                $dot = 'bg-green-500'; $txt = 'text-green-700'; $sub = 'text-green-500';
+                            } elseif (!$req) {
+                                $dot = 'bg-yellow-400'; $txt = 'text-yellow-700'; $sub = 'text-yellow-500';
+                            } else {
+                                $dot = 'bg-red-500'; $txt = 'text-red-700'; $sub = 'text-red-500';
+                            }
+                        @endphp
+                        <div class="flex items-start gap-2.5 p-2.5 rounded-lg {{ $check['ok'] ? 'bg-green-50' : ($req ? 'bg-red-50' : 'bg-yellow-50') }}">
+                            <span class="w-2 h-2 rounded-full {{ $dot }} mt-1.5 shrink-0"></span>
+                            <div class="min-w-0">
+                                <p class="text-xs font-semibold {{ $txt }}">{{ $check['name'] }}</p>
+                                @if($check['detail'] ?? '')
+                                <p class="text-[11px] {{ $sub }} truncate" title="{{ $check['detail'] }}">{{ $check['detail'] }}</p>
+                                @endif
+                                @if(!$check['ok'] && !$req)
+                                <p class="text-[10px] text-yellow-500 italic">Warning only</p>
+                                @endif
+                            </div>
+                        </div>
+                        @endforeach
+                    </div>
+                    <div class="mt-auto pt-2">
+                        <button onclick="openUpdateModal('{{ $latest['tag_name'] }}')"
+                            @if($requiredFailed) disabled title="Fix required pre-flight issues first" @endif
+                            class="w-full px-5 py-3 bg-blue-600 text-white font-bold rounded-xl hover:bg-blue-700 text-sm flex items-center justify-center gap-2 transition shadow-md disabled:opacity-50 disabled:cursor-not-allowed">
+                            <i class="fas fa-cloud-arrow-up"></i>
+                            Apply Update {{ $latest['tag_name'] }}
+                        </button>
+                        <p class="text-center text-xs text-gray-400 mt-2">
+                            Method: <span class="font-semibold {{ $method === 'git' ? 'text-green-600' : 'text-orange-500' }}">{{ strtoupper($method) }}</span>
+                        </p>
+                    </div>
+                </div>
+            </div>
+        </div>
+
+        @else
+        {{-- Up to date --}}
+        <div class="mb-6 bg-white rounded-2xl border border-gray-200 shadow-sm overflow-hidden">
+            <div class="bg-gradient-to-r from-emerald-500 to-green-500 px-6 py-5 flex items-center gap-5">
+                <div class="w-14 h-14 bg-white/20 rounded-2xl flex items-center justify-center shrink-0">
+                    <i class="fas fa-circle-check text-white text-2xl"></i>
+                </div>
+                <div>
+                    <p class="text-white/80 text-sm font-medium uppercase tracking-wide mb-0.5">Up to Date</p>
+                    <p class="text-2xl font-bold text-white">v{{ $current }}</p>
+                    @php
+                        $pubAt = $currentRelease['published_at'] ?? ($latest['published_at'] ?? null);
+                    @endphp
+                    @if($pubAt)
+                    <p class="text-emerald-100 text-sm mt-0.5">Released {{ \Carbon\Carbon::parse($pubAt)->diffForHumans() }}</p>
+                    @endif
+                </div>
+                <div class="ml-auto shrink-0">
+                    @php $noteUrl = $currentRelease['html_url'] ?? ($latest['html_url'] ?? null); @endphp
+                    @if($noteUrl)
+                    <a href="{{ $noteUrl }}" target="_blank"
+                       class="inline-flex items-center gap-2 px-4 py-2 bg-white/20 hover:bg-white/30 text-white text-sm font-medium rounded-lg transition">
+                        <i class="fab fa-github"></i> Release Notes
+                    </a>
+                    @endif
+                </div>
+            </div>
+        </div>
+        @endif
+
+        {{-- Bottom grid: Pre-flight (standalone) + Recent Releases + History --}}
+        <div class="space-y-6">
+
+            {{-- Pre-flight Checks (standalone card, always visible) --}}
+            @if(!$outdated && $latest)
+            @php
+                $allOk = collect($checks)->every(fn($c) => $c['ok'] || !($c['required'] ?? true));
+                $requiredFailed = collect($checks)->contains(fn($c) => !$c['ok'] && ($c['required'] ?? true));
+            @endphp
+            <div class="bg-white rounded-2xl border border-gray-200 shadow-sm overflow-hidden">
+                <div class="px-6 py-4 border-b border-gray-100 flex items-center justify-between">
+                    <h3 class="font-semibold text-gray-800 flex items-center gap-2">
+                        <i class="fas fa-list-check text-indigo-500"></i>
+                        Pre-flight Checks
+                    </h3>
+                    <span class="text-xs font-semibold px-2.5 py-1 rounded-full
+                        {{ $requiredFailed ? 'bg-red-100 text-red-700' : (collect($checks)->contains(fn($c) => !$c['ok']) ? 'bg-yellow-100 text-yellow-700' : 'bg-green-100 text-green-700') }}">
+                        {{ collect($checks)->where('ok', true)->count() }}/{{ count($checks) }} passed
+                    </span>
+                </div>
+                <div class="p-6 grid sm:grid-cols-2 gap-3">
+                    @foreach($checks as $check)
+                    @php
+                        $req = $check['required'] ?? true;
+                        if ($check['ok']) {
+                            $bg = 'bg-green-50 border border-green-100'; $icon = 'circle-check text-green-500'; $t = 'text-green-800'; $d = 'text-green-600';
+                        } elseif (!$req) {
+                            $bg = 'bg-yellow-50 border border-yellow-100'; $icon = 'triangle-exclamation text-yellow-500'; $t = 'text-yellow-800'; $d = 'text-yellow-600';
+                        } else {
+                            $bg = 'bg-red-50 border border-red-100'; $icon = 'circle-xmark text-red-500'; $t = 'text-red-800'; $d = 'text-red-600';
+                        }
+                    @endphp
+                    <div class="flex items-start gap-3 p-3 rounded-xl {{ $bg }}">
+                        <i class="fas fa-{{ $icon }} mt-0.5 shrink-0 text-sm"></i>
+                        <div class="min-w-0">
+                            <p class="text-sm font-semibold {{ $t }}">{{ $check['name'] }}</p>
+                            @if($check['detail'] ?? '')
+                            <p class="text-xs {{ $d }} mt-0.5 truncate" title="{{ $check['detail'] }}">{{ $check['detail'] }}</p>
+                            @endif
+                            @if(!$check['ok'] && !$req)
+                            <p class="text-[10px] text-yellow-500 italic mt-0.5">Warning only — won't block the update</p>
+                            @endif
+                        </div>
+                    </div>
+                    @endforeach
+                </div>
+            </div>
+            @endif
+
+            {{-- Recent Releases --}}
+            @if(!empty($releases))
+            <div class="bg-white rounded-2xl border border-gray-200 shadow-sm overflow-hidden">
+                <div class="px-6 py-4 border-b border-gray-100 flex items-center gap-2">
+                    <i class="fas fa-tags text-gray-400"></i>
+                    <h3 class="font-semibold text-gray-800">Recent Releases</h3>
+                </div>
+                <div class="divide-y divide-gray-50">
+                    @foreach($releases as $release)
+                    <div class="px-6 py-3.5 flex items-center gap-4 hover:bg-gray-50 transition">
+                        <span class="font-mono text-sm font-bold text-gray-800 w-24 shrink-0">{{ $release['tag_name'] }}</span>
+                        <span class="text-sm text-gray-600 flex-1 truncate">{{ $release['name'] ?? '' }}</span>
+                        @if($release['prerelease'] ?? false)
+                        <span class="px-2 py-0.5 bg-orange-100 text-orange-700 text-xs rounded-full font-semibold">pre-release</span>
+                        @endif
+                        @if($release['published_at'] ?? null)
+                        <span class="text-xs text-gray-400 shrink-0">{{ \Carbon\Carbon::parse($release['published_at'])->format('Y-m-d') }}</span>
+                        @endif
+                        @if($release['html_url'] ?? null)
+                        <a href="{{ $release['html_url'] }}" target="_blank"
+                           class="text-xs text-blue-600 hover:underline shrink-0 flex items-center gap-1">
+                            <i class="fas fa-arrow-up-right-from-square text-[10px]"></i> Notes
+                        </a>
+                        @endif
+                    </div>
+                    @endforeach
+                </div>
+            </div>
+            @endif
+
+            {{-- Update History --}}
+            <div class="bg-white rounded-2xl border border-gray-200 shadow-sm overflow-hidden">
+                <div class="px-6 py-4 border-b border-gray-100 flex items-center gap-2">
+                    <i class="fas fa-clock-rotate-left text-gray-400"></i>
+                    <h3 class="font-semibold text-gray-800">Update History</h3>
+                </div>
+                @if($history->isEmpty())
+                <div class="px-6 py-12 text-center text-gray-400">
+                    <i class="fas fa-inbox text-4xl mb-3 block opacity-40"></i>
+                    <p class="text-sm">No updates applied yet.</p>
+                </div>
+                @else
+                <div class="overflow-x-auto">
+                    <table class="w-full text-sm">
+                        <thead class="bg-gray-50 text-xs text-gray-500 uppercase tracking-wider border-b border-gray-100">
+                            <tr>
+                                <th class="px-6 py-3 text-left font-semibold">From</th>
+                                <th class="px-6 py-3 text-left font-semibold">To</th>
+                                <th class="px-6 py-3 text-left font-semibold">Method</th>
+                                <th class="px-6 py-3 text-left font-semibold">Status</th>
+                                <th class="px-6 py-3 text-left font-semibold">By</th>
+                                <th class="px-6 py-3 text-left font-semibold">Date</th>
+                                <th class="px-6 py-3 text-left font-semibold">Log</th>
+                            </tr>
+                        </thead>
+                        <tbody class="divide-y divide-gray-50">
+                            @foreach($history as $entry)
+                            <tr class="hover:bg-gray-50 transition">
+                                <td class="px-6 py-3 font-mono text-gray-500 text-xs">{{ $entry->from_version ?? '—' }}</td>
+                                <td class="px-6 py-3 font-mono font-bold text-gray-800 text-xs">{{ $entry->to_version }}</td>
+                                <td class="px-6 py-3">
+                                    <span class="px-2 py-0.5 text-xs rounded-full font-semibold {{ $entry->method === 'git' ? 'bg-green-100 text-green-700' : 'bg-orange-100 text-orange-700' }}">
+                                        {{ $entry->method }}
+                                    </span>
+                                </td>
+                                <td class="px-6 py-3">
+                                    <span class="inline-flex items-center gap-1 px-2 py-0.5 text-xs rounded-full font-semibold
+                                        {{ $entry->status === 'success' ? 'bg-green-100 text-green-700' : 'bg-red-100 text-red-700' }}">
+                                        <i class="fas fa-{{ $entry->status === 'success' ? 'check' : 'xmark' }} text-[10px]"></i>
+                                        {{ $entry->status }}
+                                    </span>
+                                </td>
+                                <td class="px-6 py-3 text-gray-600">{{ $entry->executor?->name ?? 'System' }}</td>
+                                <td class="px-6 py-3 text-gray-400 text-xs">{{ $entry->created_at->format('Y-m-d H:i') }}</td>
+                                <td class="px-6 py-3">
+                                    @if($entry->notes)
+                                    <button onclick="showLog({{ $entry->id }})"
+                                        class="text-blue-600 hover:underline text-xs flex items-center gap-1">
+                                        <i class="fas fa-terminal text-[10px]"></i> View
+                                    </button>
+                                    <pre id="log-{{ $entry->id }}" class="hidden mt-2 bg-gray-900 text-green-400 text-xs rounded-lg p-3 overflow-x-auto max-w-xs max-h-48 leading-relaxed">{{ $entry->notes }}</pre>
+                                    @endif
+                                </td>
+                            </tr>
+                            @endforeach
+                        </tbody>
+                    </table>
+                </div>
+                @endif
+            </div>
+
+        </div>
+    </main>
+</div>
+
+{{-- Update Confirmation Modal --}}
+<div id="update-modal" class="fixed inset-0 bg-black/60 backdrop-blur-sm z-50 hidden items-center justify-center p-4">
+    <div class="bg-white rounded-2xl shadow-2xl max-w-lg w-full">
+        <div class="px-6 py-5 border-b border-gray-100 flex items-center justify-between">
+            <h2 class="text-lg font-bold text-gray-800 flex items-center gap-2">
+                <i class="fas fa-cloud-arrow-up text-blue-600"></i>
+                Apply Update <span id="modal-tag" class="text-blue-600 ml-1 font-mono"></span>
+            </h2>
+            <button onclick="closeUpdateModal()" class="text-gray-400 hover:text-gray-600 transition w-8 h-8 flex items-center justify-center rounded-lg hover:bg-gray-100">
+                <i class="fas fa-xmark text-lg"></i>
+            </button>
+        </div>
+        <div id="modal-confirm" class="p-6 space-y-4">
+            <div class="bg-amber-50 border border-amber-200 rounded-xl p-4 space-y-2">
+                <p class="text-sm font-semibold text-amber-800 flex items-center gap-2">
+                    <i class="fas fa-triangle-exclamation"></i> Before you proceed
+                </p>
+                <ul class="text-sm text-amber-700 space-y-1 list-disc list-inside">
+                    <li>Back up your <strong>database</strong> before updating</li>
+                    <li>The site will enter <strong>maintenance mode</strong> briefly</li>
+                    <li>Active sessions will be interrupted</li>
+                    <li>This action <strong>cannot be undone</strong> automatically</li>
+                </ul>
+            </div>
+            <p class="text-sm text-gray-600">
+                Update method: <strong class="capitalize">{{ $method }}</strong>.
+                Migrations will run automatically after files are applied.
+            </p>
+        </div>
+        <div id="modal-progress" class="hidden p-8">
+            <div class="flex flex-col items-center gap-4 text-center">
+                <div class="w-12 h-12 border-4 border-blue-600 border-t-transparent rounded-full animate-spin"></div>
+                <p class="text-sm font-medium text-gray-700">Applying update — please do not close this page...</p>
+            </div>
+        </div>
+        <div id="modal-result" class="hidden p-6 space-y-3">
+            <div id="result-banner" class="rounded-xl p-4 text-sm font-semibold"></div>
+            <pre id="result-log" class="bg-gray-900 text-green-400 text-xs rounded-xl p-4 overflow-y-auto max-h-64 leading-relaxed"></pre>
+        </div>
+        <div id="modal-footer" class="px-6 py-4 border-t border-gray-100 flex items-center justify-end gap-3">
+            <button onclick="closeUpdateModal()"
+                class="px-4 py-2 text-sm text-gray-700 border border-gray-300 rounded-lg hover:bg-gray-50 transition">
+                Cancel
+            </button>
+            <button id="confirm-btn" onclick="applyUpdate()"
+                class="px-5 py-2.5 bg-blue-600 text-white text-sm font-bold rounded-lg hover:bg-blue-700 transition flex items-center gap-2 shadow">
+                <i class="fas fa-cloud-arrow-up"></i> Apply Update
+            </button>
+        </div>
+    </div>
+</div>
+@endsection
+
+@push('scripts')
+<script>
+let pendingTag = null;
+
+function openUpdateModal(tag) {
+    pendingTag = tag;
+    document.getElementById('modal-tag').textContent = tag;
+    document.getElementById('modal-confirm').classList.remove('hidden');
+    document.getElementById('modal-progress').classList.add('hidden');
+    document.getElementById('modal-result').classList.add('hidden');
+    document.getElementById('modal-footer').classList.remove('hidden');
+    document.getElementById('confirm-btn').disabled = false;
+    document.getElementById('confirm-btn').classList.remove('hidden');
+    document.getElementById('update-modal').classList.remove('hidden');
+    document.getElementById('update-modal').classList.add('flex');
+}
+
+function closeUpdateModal() {
+    document.getElementById('update-modal').classList.add('hidden');
+    document.getElementById('update-modal').classList.remove('flex');
+    pendingTag = null;
+}
+
+async function applyUpdate() {
+    if (!pendingTag) return;
+    document.getElementById('modal-confirm').classList.add('hidden');
+    document.getElementById('modal-progress').classList.remove('hidden');
+    document.getElementById('modal-footer').classList.add('hidden');
+
+    try {
+        const response = await fetch('{{ route("admin.updates.apply") }}', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-CSRF-TOKEN': (document.querySelector('meta[name="csrf-token"]')?.content) ?? '{{ csrf_token() }}',
+            },
+            body: JSON.stringify({ tag: pendingTag }),
+        });
+
+        const data = await response.json();
+        document.getElementById('modal-progress').classList.add('hidden');
+        document.getElementById('modal-result').classList.remove('hidden');
+
+        const banner = document.getElementById('result-banner');
+        if (data.success) {
+            banner.className = 'rounded-xl p-4 text-sm font-semibold bg-green-100 text-green-800';
+            banner.innerHTML = '<i class="fas fa-circle-check mr-2"></i>Update applied successfully! Reloading in 5 seconds...';
+            setTimeout(() => window.location.reload(), 5000);
+        } else {
+            banner.className = 'rounded-xl p-4 text-sm font-semibold bg-red-100 text-red-800';
+            banner.innerHTML = '<i class="fas fa-circle-xmark mr-2"></i>Update failed: ' + (data.error ?? 'Unknown error');
+        }
+
+        document.getElementById('result-log').textContent = (data.log ?? []).join('\n');
+        document.getElementById('modal-footer').classList.remove('hidden');
+        document.getElementById('confirm-btn').classList.add('hidden');
+
+    } catch (err) {
+        document.getElementById('modal-progress').classList.add('hidden');
+        document.getElementById('modal-result').classList.remove('hidden');
+        const banner = document.getElementById('result-banner');
+        banner.className = 'rounded-xl p-4 text-sm font-semibold bg-red-100 text-red-800';
+        banner.innerHTML = '<i class="fas fa-circle-xmark mr-2"></i>Network error: ' + err.message;
+        document.getElementById('modal-footer').classList.remove('hidden');
+        document.getElementById('confirm-btn').classList.add('hidden');
+    }
+}
+
+function checkForUpdates() {
+    document.getElementById('check-btn').disabled = true;
+    document.getElementById('check-icon').classList.add('fa-spin');
+    setTimeout(() => window.location.reload(), 400);
+}
+
+function showLog(id) {
+    document.getElementById('log-' + id).classList.toggle('hidden');
+}
+
+document.getElementById('update-modal').addEventListener('click', function(e) {
+    if (e.target === this) closeUpdateModal();
+});
+</script>
+@endpush
+
+
 @section('content')
 <div class="flex-1 flex flex-col overflow-hidden">
 
diff --git a/app/Modules/Admin/Services/UpdateService.php b/app/Modules/Admin/Services/UpdateService.php
index 1d65256..a70c7bc 100644
--- a/app/Modules/Admin/Services/UpdateService.php
+++ b/app/Modules/Admin/Services/UpdateService.php
@@ -188,16 +188,18 @@ public function preflight(): array
         $method = $this->detectMethod();
         $checks = [];
 
-        // Write permission on base path: required for zip, warning-only for git
-        // (git runs as www-data via exec but ACLs may differ from PHP file_put_contents)
-        $baseWritable = $this->probeWrite(base_path());
+        // For git-based updates, PHP itself does NOT write to base_path —
+        // the git binary (running via exec) handles all file operations.
+        // So this is a warning only, never a blocker.
         $checks[] = $this->check(
             'Write permission — base path',
-            $baseWritable,
+            $this->probeWrite(base_path()),
             base_path(),
             required: $method !== 'git'
         );
 
+        // storage/ is needed for cache, compiled views, migrations etc.
+        // For zip: required. For git: artisan still needs it → required.
         $checks[] = $this->check(
             'Write permission — storage',
             $this->probeWrite(storage_path()),

From dea064ea3dfedffb1b4170c83ac749b9ace6f4c9 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 29 May 2026 23:37:17 +0200
Subject: [PATCH 121/132] feat: Implement role-based access control in
 RoleController and UpdateController

- Added authorization checks in RoleController for viewing, creating, updating, and deleting roles.
- Integrated authorization in UpdateController for viewing updates and applying updates.
- Updated views to reflect new authorization logic.

feat: Enhance update service with command sanitization

- Introduced a method to sanitize command strings by masking GitHub tokens in logs.
- Updated logging to use the new sanitization method for better security.

feat: Add new models for Backup, Log, and Module

- Created Backup, Log, and Module models to represent respective entities in the application.

feat: Implement policies for various resources

- Added policies for AdminUser, Analytics, Backup, Log, Module, News, NewsCategory, Realm, Role, and Update.
- Each policy includes methods for managing permissions related to their respective resources.

feat: Register policies in AuthServiceProvider

- Registered all newly created policies in the AuthServiceProvider for proper authorization handling.
---
 app/Models/Backup.php                         |  23 +
 app/Models/Log.php                            |  18 +
 app/Models/Module.php                         |  27 ++
 .../AdminNewsCategoryController.php           |  15 +
 .../Http/Controllers/AdminNewsController.php  |  16 +
 .../Http/Controllers/AdminUserController.php  |  26 +-
 .../Http/Controllers/AnalyticsController.php  |   6 +
 .../Http/Controllers/BackupController.php     |  12 +
 .../Admin/Http/Controllers/LogController.php  |   6 +
 .../Controllers/ModuleManagerController.php   |  18 +
 .../Controllers/RealmManagementController.php |  17 +
 .../Admin/Http/Controllers/RoleController.php |  15 +
 .../Http/Controllers/UpdateController.php     |   8 +
 .../Resources/views/updates/index.blade.php   | 433 +-----------------
 app/Modules/Admin/Services/UpdateService.php  |  19 +-
 app/Policies/AdminUserPolicy.php              |  43 ++
 app/Policies/AnalyticsPolicy.php              |  24 +
 app/Policies/BackupPolicy.php                 |  33 ++
 app/Policies/LogPolicy.php                    |  23 +
 app/Policies/ModulePolicy.php                 |  48 ++
 app/Policies/NewsCategoryPolicy.php           |  39 ++
 app/Policies/NewsPolicy.php                   |  47 ++
 app/Policies/RealmPolicy.php                  |  43 ++
 app/Policies/RolePolicy.php                   |  38 ++
 app/Policies/UpdatePolicy.php                 |  28 ++
 app/Providers/AuthServiceProvider.php         |  57 +++
 bootstrap/providers.php                       |   1 +
 27 files changed, 641 insertions(+), 442 deletions(-)
 create mode 100644 app/Models/Backup.php
 create mode 100644 app/Models/Log.php
 create mode 100644 app/Models/Module.php
 create mode 100644 app/Policies/AdminUserPolicy.php
 create mode 100644 app/Policies/AnalyticsPolicy.php
 create mode 100644 app/Policies/BackupPolicy.php
 create mode 100644 app/Policies/LogPolicy.php
 create mode 100644 app/Policies/ModulePolicy.php
 create mode 100644 app/Policies/NewsCategoryPolicy.php
 create mode 100644 app/Policies/NewsPolicy.php
 create mode 100644 app/Policies/RealmPolicy.php
 create mode 100644 app/Policies/RolePolicy.php
 create mode 100644 app/Policies/UpdatePolicy.php
 create mode 100644 app/Providers/AuthServiceProvider.php

diff --git a/app/Models/Backup.php b/app/Models/Backup.php
new file mode 100644
index 0000000..47c18fe
--- /dev/null
+++ b/app/Models/Backup.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+/**
+ * Backup file model (represents a backup ZIP file on disk).
+ *
+ * @property string $filename
+ * @property int $size
+ * @property int $date
+ */
+class Backup extends Model
+{
+    public $timestamps = false;
+
+    protected $fillable = [
+        'filename',
+        'size',
+        'date',
+    ];
+}
\ No newline at end of file
diff --git a/app/Models/Log.php b/app/Models/Log.php
new file mode 100644
index 0000000..067124f
--- /dev/null
+++ b/app/Models/Log.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+/**
+ * Log model (represents a log file entry).
+ *
+ * @property string $filename
+ * @property string $level
+ * @property string $message
+ * @property string $timestamp
+ */
+class Log extends Model
+{
+    public $timestamps = false;
+}
\ No newline at end of file
diff --git a/app/Models/Module.php b/app/Models/Module.php
new file mode 100644
index 0000000..eb19257
--- /dev/null
+++ b/app/Models/Module.php
@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Models;
+
+/**
+ * Module model (represents a NexusCMS module).
+ *
+ * @property string $name
+ * @property string $folder
+ * @property bool $enabled
+ * @property string $module_type
+ */
+class Module extends Model
+{
+    public $timestamps = false;
+
+    protected $fillable = [
+        'name',
+        'folder',
+        'enabled',
+        'module_type',
+    ];
+
+    protected $casts = [
+        'enabled' => 'bool',
+    ];
+}
\ No newline at end of file
diff --git a/app/Modules/Admin/Http/Controllers/AdminNewsCategoryController.php b/app/Modules/Admin/Http/Controllers/AdminNewsCategoryController.php
index c1bda89..353bd39 100644
--- a/app/Modules/Admin/Http/Controllers/AdminNewsCategoryController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminNewsCategoryController.php
@@ -6,11 +6,16 @@
 use App\Models\NewsCategory;
 use Illuminate\Http\Request;
 use Illuminate\Support\Str;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
 
 class AdminNewsCategoryController extends Controller
 {
+    use AuthorizesRequests;
+
     public function index()
     {
+        $this->authorize('viewAny', NewsCategory::class);
+
         $categories = NewsCategory::withCount('news')
             ->withTrashed()
             ->orderBy('order')
@@ -22,11 +27,15 @@ public function index()
 
     public function create()
     {
+        $this->authorize('create', NewsCategory::class);
+
         return view('admin::news.categories.create');
     }
 
     public function store(Request $request)
     {
+        $this->authorize('create', NewsCategory::class);
+
         $validated = $request->validate([
             'name'        => ['required', 'string', 'max:100'],
             'slug'        => ['nullable', 'string', 'max:150', 'unique:news_category,slug'],
@@ -62,11 +71,15 @@ public function store(Request $request)
 
     public function edit(NewsCategory $newsCategory)
     {
+        $this->authorize('update', $newsCategory);
+
         return view('admin::news.categories.edit', compact('newsCategory'));
     }
 
     public function update(Request $request, NewsCategory $newsCategory)
     {
+        $this->authorize('update', $newsCategory);
+
         $validated = $request->validate([
             'name'        => ['required', 'string', 'max:100'],
             'slug'        => ['nullable', 'string', 'max:150', "unique:news_category,slug,{$newsCategory->id}"],
@@ -94,6 +107,8 @@ public function update(Request $request, NewsCategory $newsCategory)
 
     public function destroy(NewsCategory $newsCategory)
     {
+        $this->authorize('delete', $newsCategory);
+
         if ($newsCategory->news()->count() > 0) {
             return redirect()
                 ->route('admin.news.categories.index')
diff --git a/app/Modules/Admin/Http/Controllers/AdminNewsController.php b/app/Modules/Admin/Http/Controllers/AdminNewsController.php
index 8b16994..ee236ce 100644
--- a/app/Modules/Admin/Http/Controllers/AdminNewsController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminNewsController.php
@@ -10,11 +10,15 @@
 use Illuminate\Support\Str;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\Storage;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
 
 class AdminNewsController extends Controller
 {
+    use AuthorizesRequests;
     public function index()
     {
+        $this->authorize('viewAny', News::class);
+
         $news = News::withTrashed()
             ->with(['author', 'category'])
             ->orderBy('created_at', 'desc')
@@ -25,6 +29,8 @@ public function index()
 
     public function create()
     {
+        $this->authorize('create', News::class);
+
         $categories      = NewsCategory::where('is_active', true)->orderBy('name')->get();
         $activeLocales   = LocalizationService::getActiveLocales();
         $defaultLocale   = LocalizationService::getDefaultLocale();
@@ -38,6 +44,8 @@ public function create()
 
     public function store(Request $request)
     {
+        $this->authorize('create', News::class);
+
         $activeLocales  = LocalizationService::getActiveLocales();
         $defaultLocale  = LocalizationService::getDefaultLocale();
         $isMultilingual = LocalizationService::isMultilingualEnabled();
@@ -116,6 +124,8 @@ public function store(Request $request)
 
     public function edit(News $news)
     {
+        $this->authorize('update', $news);
+
         $categories     = NewsCategory::where('is_active', true)->orderBy('name')->get();
         $activeLocales  = LocalizationService::getActiveLocales();
         $defaultLocale  = LocalizationService::getDefaultLocale();
@@ -129,6 +139,8 @@ public function edit(News $news)
 
     public function update(Request $request, News $news)
     {
+        $this->authorize('update', $news);
+
         $activeLocales  = LocalizationService::getActiveLocales();
         $defaultLocale  = LocalizationService::getDefaultLocale();
         $isMultilingual = LocalizationService::isMultilingualEnabled();
@@ -197,6 +209,8 @@ public function update(Request $request, News $news)
 
     public function destroy(News $news)
     {
+        $this->authorize('delete', $news);
+
         $news->delete();
 
         return redirect()
@@ -207,6 +221,8 @@ public function destroy(News $news)
     public function restore(int $id)
     {
         $news = News::withTrashed()->findOrFail($id);
+        $this->authorize('restore', $news);
+
         $news->restore();
 
         return redirect()
diff --git a/app/Modules/Admin/Http/Controllers/AdminUserController.php b/app/Modules/Admin/Http/Controllers/AdminUserController.php
index 94a055e..a96af4f 100644
--- a/app/Modules/Admin/Http/Controllers/AdminUserController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminUserController.php
@@ -9,16 +9,19 @@
 use Illuminate\Validation\Rule;
 use Modules\Donate\Domain\Models\DonationTransaction;
 use Spatie\Permission\Models\Role;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
 
 class AdminUserController extends Controller
 {
+    use AuthorizesRequests;
+
     /**
      * Display a listing of the resource.
-     * 
-     * @return \Illuminate\Http\Response
      */
     public function index()
     {
+        $this->authorize('viewAny', User::class);
+
         $users = User::orderBy('name')->paginate(15);
         return view('admin::users.index', compact('users'));
     }
@@ -30,6 +33,8 @@ public function index()
      */
     public function create()
     {
+        $this->authorize('create', User::class);
+
         $roles = Role::orderBy('name')->get();
         return view('admin::users.create', compact('roles'));
     }
@@ -42,6 +47,8 @@ public function create()
      */
     public function show(User $user)
     {
+        $this->authorize('view', $user);
+
         $user->load('roles');
 
         $donationTransactions = DonationTransaction::query()
@@ -61,6 +68,8 @@ public function show(User $user)
      */
     public function store(Request $request)
     {
+        $this->authorize('create', User::class);
+
         $validated = $request->validate([
             'name' => ['required', 'string', 'max:100', 'unique:users,name'],
             'email' => ['required', 'email', 'max:255', 'unique:users,email'],
@@ -97,6 +106,8 @@ public function store(Request $request)
      */
     public function edit(User $user)
     {
+        $this->authorize('update', $user);
+
         $roles = Role::orderBy('name')->get();
         $assigned = $user->roles()->pluck('name')->toArray();
         return view('admin::users.edit', compact('user', 'roles', 'assigned'));
@@ -111,6 +122,8 @@ public function edit(User $user)
      */
     public function update(Request $request, User $user)
     {
+        $this->authorize('update', $user);
+
         $validated = $request->validate([
             'name' => ['required', 'string', 'max:100', Rule::unique('users', 'name')->ignore($user->id)],
             'email' => ['required', 'email', 'max:255', Rule::unique('users', 'email')->ignore($user->id)],
@@ -151,12 +164,11 @@ public function update(Request $request, User $user)
      */
     public function destroy(User $user)
     {
-        if (!$user->hasRole('Admin')) {
-            $user->delete();
-            return redirect()->route('admin.users.index')->with('success', 'User deleted successfully');
-        }
+        $this->authorize('delete', $user);
+
+        $user->delete();
 
-        return redirect()->route('admin.users.index')->with('error', 'The user is an administrator and cannot be deleted');
+        return redirect()->route('admin.users.index')->with('success', 'User deleted successfully');
     }
 }
 
diff --git a/app/Modules/Admin/Http/Controllers/AnalyticsController.php b/app/Modules/Admin/Http/Controllers/AnalyticsController.php
index b560d95..644ecaf 100644
--- a/app/Modules/Admin/Http/Controllers/AnalyticsController.php
+++ b/app/Modules/Admin/Http/Controllers/AnalyticsController.php
@@ -5,9 +5,13 @@
 use App\Http\Controllers\Controller;
 use App\Services\AnalyticsService;
 use Illuminate\Http\Request;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
+use App\Models\AnalyticsSession;
 
 class AnalyticsController extends Controller
 {
+    use AuthorizesRequests;
+
     protected AnalyticsService $analyticsService;
 
     public function __construct(AnalyticsService $analyticsService)
@@ -20,6 +24,8 @@ public function __construct(AnalyticsService $analyticsService)
      */
     public function index(Request $request)
     {
+        $this->authorize('viewAny', AnalyticsSession::class);
+
         $period = $request->query('period', '30d');
         $startDate = $this->analyticsService->getStartDate($period);
 
diff --git a/app/Modules/Admin/Http/Controllers/BackupController.php b/app/Modules/Admin/Http/Controllers/BackupController.php
index 8fec4df..6d140cb 100644
--- a/app/Modules/Admin/Http/Controllers/BackupController.php
+++ b/app/Modules/Admin/Http/Controllers/BackupController.php
@@ -8,9 +8,13 @@
 use Illuminate\Support\Facades\DB;
 use Symfony\Component\Process\Process;
 use ZipArchive;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
+use App\Models\Backup;
 
 class BackupController extends Controller
 {
+    use AuthorizesRequests;
+
     protected string $backupPath;
 
     public function __construct()
@@ -20,6 +24,8 @@ public function __construct()
 
     public function index()
     {
+        $this->authorize('viewAny', Backup::class);
+
         File::ensureDirectoryExists($this->backupPath);
 
         $backups = collect(File::glob($this->backupPath . '/backup-*.zip'))
@@ -41,6 +47,8 @@ public function index()
 
     public function create()
     {
+        $this->authorize('create', Backup::class);
+
         File::ensureDirectoryExists($this->backupPath);
 
         $timestamp = now()->format('Y-m-d-His');
@@ -105,6 +113,8 @@ public function create()
 
     public function download(string $filename)
     {
+        $this->authorize('download', Backup::class);
+
         if (!preg_match('/^backup-[\d-]+\.zip$/', $filename)) {
             abort(403);
         }
@@ -120,6 +130,8 @@ public function download(string $filename)
 
     public function destroy(string $filename)
     {
+        $this->authorize('delete', Backup::class);
+
         if (!preg_match('/^backup-[\d-]+\.zip$/', $filename)) {
             abort(403);
         }
diff --git a/app/Modules/Admin/Http/Controllers/LogController.php b/app/Modules/Admin/Http/Controllers/LogController.php
index 88cc185..d72879c 100644
--- a/app/Modules/Admin/Http/Controllers/LogController.php
+++ b/app/Modules/Admin/Http/Controllers/LogController.php
@@ -5,11 +5,17 @@
 use App\Http\Controllers\Controller;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\File;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
+use App\Models\Log;
 
 class LogController extends Controller
 {
+    use AuthorizesRequests;
+
     public function index(Request $request)
     {
+        $this->authorize('viewAny', Log::class);
+
         $logPath = storage_path('logs');
         $logFiles = collect(File::glob($logPath . '/laravel*.log'))
             ->map(fn($file) => basename($file))
diff --git a/app/Modules/Admin/Http/Controllers/ModuleManagerController.php b/app/Modules/Admin/Http/Controllers/ModuleManagerController.php
index ced554a..7e86c5e 100644
--- a/app/Modules/Admin/Http/Controllers/ModuleManagerController.php
+++ b/app/Modules/Admin/Http/Controllers/ModuleManagerController.php
@@ -7,11 +7,17 @@
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Artisan;
 use Illuminate\Support\Facades\File;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
+use App\Models\Module;
 
 class ModuleManagerController extends Controller
 {
+    use AuthorizesRequests;
+
     public function index()
     {
+        $this->authorize('viewAny', Module::class);
+
         $discoveredModules = $this->discoverModules();
         ModuleRegistryService::syncDiscoveredModules($discoveredModules);
 
@@ -24,6 +30,8 @@ public function index()
 
     public function edit(string $module)
     {
+        $this->authorize('update', Module::class);
+
         $moduleData = $this->getModuleDataOrFail($module);
 
         return view('admin::modules.edit', ['module' => $moduleData]);
@@ -31,6 +39,8 @@ public function edit(string $module)
 
     public function update(Request $request, string $module)
     {
+        $this->authorize('update', Module::class);
+
         $moduleData = $this->getModuleDataOrFail($module);
 
         $validated = $request->validate([
@@ -57,6 +67,8 @@ public function update(Request $request, string $module)
 
     public function uninstall(string $module)
     {
+        $this->authorize('uninstall', Module::class);
+
         $moduleData = $this->getModuleDataOrFail($module);
 
         if ($moduleData['folder'] === 'Admin') {
@@ -82,6 +94,8 @@ public function uninstall(string $module)
 
     public function toggle(string $module)
     {
+        $this->authorize('toggle', Module::class);
+
         $moduleData = $this->getModuleDataOrFail($module);
 
         $config = $moduleData['config'];
@@ -105,6 +119,8 @@ public function toggle(string $module)
 
     public function migrate(string $module)
     {
+        $this->authorize('migrate', Module::class);
+
         $moduleData = $this->getModuleDataOrFail($module);
         $migrationsPath = $moduleData['migrations_path'];
 
@@ -129,6 +145,8 @@ public function migrate(string $module)
 
     public function destroy(Request $request, string $module)
     {
+        $this->authorize('delete', Module::class);
+
         $moduleData = $this->getModuleDataOrFail($module);
 
         if ($moduleData['folder'] === 'Admin') {
diff --git a/app/Modules/Admin/Http/Controllers/RealmManagementController.php b/app/Modules/Admin/Http/Controllers/RealmManagementController.php
index b02ea00..88a8469 100644
--- a/app/Modules/Admin/Http/Controllers/RealmManagementController.php
+++ b/app/Modules/Admin/Http/Controllers/RealmManagementController.php
@@ -9,14 +9,19 @@
 use GameCrypto\SoapAccountCreator;
 use Illuminate\Http\Request;
 use Illuminate\Validation\Rule;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
 
 class RealmManagementController extends Controller
 {
+    use AuthorizesRequests;
+
     /**
      * Display realms listing.
      */
     public function index()
     {
+        $this->authorize('viewAny', Realm::class);
+
         $realms = Realm::query()->latest()->paginate(12);
 
         return view('admin::realms.index', compact('realms'));
@@ -27,6 +32,8 @@ public function index()
      */
     public function create()
     {
+        $this->authorize('create', Realm::class);
+
         return view('admin::realms.create');
     }
 
@@ -35,6 +42,8 @@ public function create()
      */
     public function store(Request $request)
     {
+        $this->authorize('create', Realm::class);
+
         $validated = $request->validate($this->validationRules());
 
         Realm::create($this->realmPayload($validated));
@@ -49,6 +58,8 @@ public function store(Request $request)
      */
     public function edit(Realm $realm)
     {
+        $this->authorize('update', $realm);
+
         return view('admin::realms.edit', [
             'realm' => $realm,
             'authConfig' => $this->decodeDatabaseConfig($realm->auth_database),
@@ -62,6 +73,8 @@ public function edit(Realm $realm)
      */
     public function update(Request $request, Realm $realm)
     {
+        $this->authorize('update', $realm);
+
         $validated = $request->validate($this->validationRules($realm->id));
 
         $realm->update($this->realmPayload($validated));
@@ -76,6 +89,8 @@ public function update(Request $request, Realm $realm)
      */
     public function destroy(Realm $realm)
     {
+        $this->authorize('delete', $realm);
+
         $realm->delete();
 
         return redirect()
@@ -88,6 +103,8 @@ public function destroy(Realm $realm)
      */
     public function soapTest(Realm $realm)
     {
+        $this->authorize('soapTest', $realm);
+
         try {
             $soap = new SoapAccountCreator(
                 (string) $realm->console_hostname,
diff --git a/app/Modules/Admin/Http/Controllers/RoleController.php b/app/Modules/Admin/Http/Controllers/RoleController.php
index 19e446d..da74e90 100644
--- a/app/Modules/Admin/Http/Controllers/RoleController.php
+++ b/app/Modules/Admin/Http/Controllers/RoleController.php
@@ -6,14 +6,19 @@
 use Illuminate\Http\Request;
 use Spatie\Permission\Models\Role;
 use Spatie\Permission\Models\Permission;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
 
 class RoleController extends Controller
 {
+    use AuthorizesRequests;
+
     /**
      * Display a listing of the roles.
      */
     public function index()
     {
+        $this->authorize('viewAny', Role::class);
+
         $roles = Role::query()->withCount('permissions')->orderBy('name')->get();
         return view('admin::roles.index', compact('roles'));
     }
@@ -23,6 +28,8 @@ public function index()
      */
     public function create()
     {
+        $this->authorize('create', Role::class);
+
         $permissions = Permission::query()->orderBy('name')->get();
         return view('admin::roles.create', compact('permissions'));
     }
@@ -32,6 +39,8 @@ public function create()
      */
     public function store(Request $request)
     {
+        $this->authorize('create', Role::class);
+
         $validated = $request->validate([
             'name' => ['required', 'string', 'max:100', 'unique:roles,name'],
             'permissions' => ['array'],
@@ -53,6 +62,8 @@ public function store(Request $request)
      */
     public function edit(Role $role)
     {
+        $this->authorize('update', $role);
+
         $permissions = Permission::query()->orderBy('name')->get();
         $selected = $role->permissions()->pluck('name')->toArray();
         return view('admin::roles.edit', compact('role', 'permissions', 'selected'));
@@ -63,6 +74,8 @@ public function edit(Role $role)
      */
     public function update(Request $request, Role $role)
     {
+        $this->authorize('update', $role);
+
         $validated = $request->validate([
             'name' => ['required', 'string', 'max:100', 'unique:roles,name,' . $role->id],
             'permissions' => ['array'],
@@ -83,6 +96,8 @@ public function update(Request $request, Role $role)
      */
     public function destroy(Role $role)
     {
+        $this->authorize('delete', $role);
+
         $role->delete();
         return redirect()->route('admin.roles.index')->with('success', 'Role deleted successfully.');
     }
diff --git a/app/Modules/Admin/Http/Controllers/UpdateController.php b/app/Modules/Admin/Http/Controllers/UpdateController.php
index b08d8c7..eb36afc 100644
--- a/app/Modules/Admin/Http/Controllers/UpdateController.php
+++ b/app/Modules/Admin/Http/Controllers/UpdateController.php
@@ -5,13 +5,19 @@
 use App\Http\Controllers\Controller;
 use Illuminate\Http\Request;
 use Modules\Admin\Services\UpdateService;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
+use App\Models\UpdateLog;
 
 class UpdateController extends Controller
 {
+    use AuthorizesRequests;
+
     public function __construct(private readonly UpdateService $updates) {}
 
     public function index()
     {
+        $this->authorize('viewAny', UpdateLog::class);
+
         $current    = config('app.version');
         $latest     = $this->updates->getLatestRelease();
         $outdated   = $this->updates->isOutdated($latest);
@@ -30,6 +36,8 @@ public function index()
 
     public function apply(Request $request)
     {
+        $this->authorize('apply', UpdateLog::class);
+
         if (!settings('update_enabled', config('update.enabled', true))) {
             return response()->json(['success' => false, 'error' => 'The auto-update system is disabled.'], 403);
         }
diff --git a/app/Modules/Admin/Resources/views/updates/index.blade.php b/app/Modules/Admin/Resources/views/updates/index.blade.php
index 7a424b1..ef9972e 100644
--- a/app/Modules/Admin/Resources/views/updates/index.blade.php
+++ b/app/Modules/Admin/Resources/views/updates/index.blade.php
@@ -466,435 +466,4 @@ function showLog(id) {
     if (e.target === this) closeUpdateModal();
 });
 </script>
-@endpush
-
-
-@section('content')
-<div class="flex-1 flex flex-col overflow-hidden">
-
-    {{-- Header --}}
-    <header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6 shrink-0">
-        <div class="flex items-center gap-3">
-            <h1 class="text-xl font-bold text-gray-800 flex items-center gap-2">
-                <i class="fas fa-cloud-arrow-up text-blue-600"></i>
-                System Updates
-            </h1>
-            <span class="px-2.5 py-1 bg-gray-100 text-gray-600 text-xs font-semibold rounded-full">
-                Current: v{{ $current }}
-            </span>
-        </div>
-        <button onclick="checkForUpdates()" id="check-btn"
-            class="px-4 py-2 bg-white border border-gray-300 text-gray-700 rounded-lg hover:bg-gray-50 text-sm font-medium flex items-center gap-2 transition">
-            <i class="fas fa-sync-alt" id="check-icon"></i>
-            Check for Updates
-        </button>
-    </header>
-
-    {{-- Main Content --}}
-    <main class="flex-1 overflow-y-auto bg-gray-50 p-6 space-y-6">
-
-        @if(!settings('update_enabled', config('update.enabled', true)))
-        <div class="bg-yellow-50 border border-yellow-200 rounded-xl p-6 flex items-start gap-4">
-            <i class="fas fa-ban text-yellow-500 text-xl mt-0.5"></i>
-            <div>
-                <p class="font-semibold text-yellow-800">Auto-updates disabled</p>
-                <p class="text-sm text-yellow-700 mt-1">Set <code>UPDATE_ENABLED=true</code> in your <code>.env</code> to enable the updater.</p>
-            </div>
-        </div>
-        @elseif(!$latest)
-        <div class="bg-white rounded-xl shadow border border-gray-200 p-6 flex items-start gap-4">
-            <div class="w-12 h-12 bg-gray-100 rounded-xl flex items-center justify-center shrink-0">
-                <i class="fas fa-plug text-gray-400 text-xl"></i>
-            </div>
-            <div>
-                <p class="font-semibold text-gray-800">Could not reach GitHub</p>
-                <p class="text-sm text-gray-500 mt-1">
-                    Unable to fetch release information. Check your internet connection, verify the repository
-                    (<code>{{ settings('update_repo_owner', config('update.repository.owner')) }}/{{ settings('update_repo_name', config('update.repository.name')) }}</code>),
-                    or add a <code>GITHUB_TOKEN</code> if the repository is private.
-                </p>
-            </div>
-        </div>
-        @elseif($outdated)
-        {{-- Update Available --}}
-        <div class="bg-gradient-to-br from-blue-50 to-indigo-50 border border-blue-200 rounded-xl shadow overflow-hidden">
-            <div class="px-6 py-4 border-b border-blue-200 flex items-center justify-between">
-                <div class="flex items-center gap-3">
-                    <span class="w-2.5 h-2.5 rounded-full bg-green-500 animate-pulse"></span>
-                    <span class="font-bold text-gray-800">Update Available</span>
-                </div>
-                <div class="flex items-center gap-2 text-sm text-gray-500">
-                    <span>{{ $latest['tag_name'] }}</span>
-                    @if($latest['published_at'])
-                    <span class="text-gray-300">•</span>
-                    <span>{{ \Carbon\Carbon::parse($latest['published_at'])->format('M d, Y') }}</span>
-                    @endif
-                    @if($latest['html_url'])
-                    <span class="text-gray-300">•</span>
-                    <a href="{{ $latest['html_url'] }}" target="_blank" class="text-blue-600 hover:underline flex items-center gap-1">
-                        <i class="fab fa-github text-xs"></i> View on GitHub
-                    </a>
-                    @endif
-                </div>
-            </div>
-            <div class="p-6 grid md:grid-cols-3 gap-6">
-                <div class="flex items-center gap-4">
-                    <div class="text-center">
-                        <p class="text-xs text-gray-500 mb-1">Current</p>
-                        <span class="px-3 py-1.5 bg-gray-200 text-gray-700 rounded-lg font-mono text-sm font-semibold">v{{ $current }}</span>
-                    </div>
-                    <i class="fas fa-arrow-right text-gray-400"></i>
-                    <div class="text-center">
-                        <p class="text-xs text-gray-500 mb-1">Latest</p>
-                        <span class="px-3 py-1.5 bg-blue-600 text-white rounded-lg font-mono text-sm font-semibold">{{ $latest['tag_name'] }}</span>
-                    </div>
-                </div>
-                <div class="md:col-span-2">
-                    @if($latest['body'])
-                    <p class="text-xs font-semibold uppercase tracking-wide text-gray-500 mb-2">Release Notes</p>
-                    <div class="text-sm text-gray-700 bg-white rounded-lg border border-gray-200 p-3 max-h-36 overflow-y-auto leading-relaxed whitespace-pre-line">{{ $latest['body'] }}</div>
-                    @else
-                    <p class="text-sm text-gray-500 italic">No release notes provided.</p>
-                    @endif
-                </div>
-            </div>
-            <div class="px-6 pb-6 flex items-center justify-between gap-4 flex-wrap">
-                <div class="flex items-center gap-2 text-sm text-gray-600">
-                    <i class="fas fa-{{ $method === 'git' ? 'code-branch' : 'file-zipper' }} {{ $method === 'git' ? 'text-green-500' : 'text-orange-500' }}"></i>
-                    Update method: <strong>{{ strtoupper($method) }}</strong>
-                    @php
-                        $allOk = collect($checks)->every(fn($c) => $c['ok'] || !($c['required'] ?? true));
-                        $hasWarnings = collect($checks)->contains(fn($c) => !$c['ok'] && !($c['required'] ?? true));
-                    @endphp
-                    <span class="ml-3 flex items-center gap-1 {{ $allOk ? ($hasWarnings ? 'text-yellow-600' : 'text-green-600') : 'text-red-600' }}">
-                        <i class="fas fa-{{ $allOk ? ($hasWarnings ? 'triangle-exclamation' : 'circle-check') : 'circle-exclamation' }} text-xs"></i>
-                        {{ $allOk ? ($hasWarnings ? 'Pre-flight warnings' : 'Pre-flight OK') : 'Pre-flight issues detected' }}
-                    </span>
-                </div>
-                <button onclick="openUpdateModal('{{ $latest['tag_name'] }}')"
-                    {{ !$allOk ? 'disabled' : '' }}
-                    title="{{ !$allOk ? 'Fix pre-flight issues before updating' : '' }}"
-                    class="px-5 py-2.5 bg-blue-600 text-white font-semibold rounded-lg hover:bg-blue-700 text-sm flex items-center gap-2 transition disabled:opacity-50 disabled:cursor-not-allowed shadow-md">
-                    <i class="fas fa-cloud-arrow-up"></i>
-                    Apply Update {{ $latest['tag_name'] }}
-                </button>
-            </div>
-        </div>
-        @else
-        {{-- Up to Date --}}
-        <div class="bg-white border border-gray-200 rounded-xl shadow p-6 flex items-center gap-5">
-            <div class="w-14 h-14 bg-green-100 rounded-xl flex items-center justify-center shrink-0">
-                <i class="fas fa-circle-check text-green-500 text-2xl"></i>
-            </div>
-            <div class="flex-1">
-                <p class="font-bold text-gray-800 text-lg">You're running the latest version</p>
-                <p class="text-sm text-gray-500 mt-0.5">
-                    NexusCMS <strong>v{{ $current }}</strong>
-                    @if(($currentRelease['published_at'] ?? null))
-                    &mdash; released {{ \Carbon\Carbon::parse($currentRelease['published_at'])->diffForHumans() }}
-                    @elseif($latest['published_at'] ?? null)
-                    &mdash; released {{ \Carbon\Carbon::parse($latest['published_at'])->diffForHumans() }}
-                    @endif
-                </p>
-            </div>
-            @if(($currentRelease['html_url'] ?? null) ?? ($latest['html_url'] ?? null))
-            <a href="{{ $currentRelease['html_url'] ?? $latest['html_url'] }}" target="_blank"
-               class="px-4 py-2 border border-gray-300 text-gray-700 rounded-lg text-sm hover:bg-gray-50 flex items-center gap-2 transition">
-                <i class="fab fa-github"></i> Release Notes
-            </a>
-            @endif
-        </div>
-        @endif
-
-        {{-- Pre-flight Checks --}}
-        <div class="bg-white rounded-xl shadow border border-gray-200 overflow-hidden">
-            <button onclick="toggleSection('preflight')"
-                class="w-full px-6 py-4 flex items-center justify-between text-left hover:bg-gray-50 transition">
-                <span class="font-semibold text-gray-800 flex items-center gap-2">
-                    <i class="fas fa-list-check text-indigo-500"></i>
-                    Pre-flight Checks
-                    @php $allOk = collect($checks)->every(fn($c) => $c['ok']) @endphp
-                    <span class="text-xs font-normal px-2 py-0.5 rounded-full {{ $allOk ? 'bg-green-100 text-green-700' : 'bg-red-100 text-red-700' }}">
-                        {{ collect($checks)->where('ok', true)->count() }}/{{ count($checks) }} passed
-                    </span>
-                </span>
-                <i class="fas fa-chevron-down text-gray-400 transition-transform" id="preflight-chevron"></i>
-            </button>
-            <div id="preflight" class="hidden border-t border-gray-100">
-                <div class="p-6 grid sm:grid-cols-2 gap-3">
-                    @foreach($checks as $check)
-                    @php
-                        $required = $check['required'] ?? true;
-                        $ok = $check['ok'];
-                        if ($ok) {
-                            $bgClass = 'bg-green-50 border border-green-100';
-                            $icon = 'circle-check text-green-500';
-                            $textClass = 'text-green-800';
-                            $detailClass = 'text-green-600';
-                            $extraNote = null;
-                        } elseif (!$required) {
-                            $bgClass = 'bg-yellow-50 border border-yellow-100';
-                            $icon = 'triangle-exclamation text-yellow-500';
-                            $textClass = 'text-yellow-800';
-                            $detailClass = 'text-yellow-600';
-                            $extraNote = 'Warning only — won\'t block the update';
-                        } else {
-                            $bgClass = 'bg-red-50 border border-red-100';
-                            $icon = 'circle-xmark text-red-500';
-                            $textClass = 'text-red-800';
-                            $detailClass = 'text-red-600';
-                            $extraNote = null;
-                        }
-                    @endphp
-                    <div class="flex items-start gap-3 p-3 rounded-lg {{ $bgClass }}">
-                        <i class="fas fa-{{ $icon }} mt-0.5 shrink-0"></i>
-                        <div class="min-w-0">
-                            <p class="text-sm font-medium {{ $textClass }}">{{ $check['name'] }}</p>
-                            @if($check['detail'] ?? '')
-                            <p class="text-xs {{ $detailClass }} mt-0.5 truncate" title="{{ $check['detail'] }}">{{ $check['detail'] }}</p>
-                            @endif
-                            @if($extraNote)
-                            <p class="text-xs text-yellow-600 mt-0.5">{{ $extraNote }}</p>
-                            @endif
-                        </div>
-                    </div>
-                    @endforeach
-                </div>
-            </div>
-        </div>
-
-        {{-- Recent Releases --}}
-        @if(!empty($releases))
-        <div class="bg-white rounded-xl shadow border border-gray-200 overflow-hidden">
-            <div class="px-6 py-4 border-b border-gray-100 flex items-center gap-2">
-                <i class="fas fa-tags text-gray-400"></i>
-                <h3 class="font-semibold text-gray-800">Recent Releases</h3>
-            </div>
-            <div class="divide-y divide-gray-100">
-                @foreach($releases as $release)
-                <div class="px-6 py-4 flex items-center gap-4">
-                    <span class="font-mono text-sm font-semibold text-gray-800 w-24 shrink-0">{{ $release['tag_name'] }}</span>
-                    <span class="text-sm text-gray-600 flex-1 truncate">{{ $release['name'] ?? '' }}</span>
-                    @if($release['prerelease'] ?? false)
-                    <span class="px-2 py-0.5 bg-orange-100 text-orange-700 text-xs rounded-full font-medium">pre-release</span>
-                    @endif
-                    @if($release['published_at'] ?? null)
-                    <span class="text-xs text-gray-400 shrink-0">{{ \Carbon\Carbon::parse($release['published_at'])->format('Y-m-d') }}</span>
-                    @endif
-                    @if($release['html_url'] ?? null)
-                    <a href="{{ $release['html_url'] }}" target="_blank"
-                       class="text-xs text-blue-600 hover:underline shrink-0 flex items-center gap-1">
-                        <i class="fas fa-arrow-up-right-from-square text-[10px]"></i> Notes
-                    </a>
-                    @endif
-                </div>
-                @endforeach
-            </div>
-        </div>
-        @endif
-
-        {{-- Update History --}}
-        <div class="bg-white rounded-xl shadow border border-gray-200 overflow-hidden">
-            <div class="px-6 py-4 border-b border-gray-100 flex items-center gap-2">
-                <i class="fas fa-clock-rotate-left text-gray-400"></i>
-                <h3 class="font-semibold text-gray-800">Update History</h3>
-            </div>
-            @if($history->isEmpty())
-            <div class="px-6 py-8 text-center text-gray-400">
-                <i class="fas fa-inbox text-3xl mb-2 block"></i>
-                <p class="text-sm">No updates applied yet.</p>
-            </div>
-            @else
-            <div class="overflow-x-auto">
-                <table class="w-full text-sm">
-                    <thead class="bg-gray-50 text-xs text-gray-500 uppercase tracking-wider">
-                        <tr>
-                            <th class="px-6 py-3 text-left">From</th>
-                            <th class="px-6 py-3 text-left">To</th>
-                            <th class="px-6 py-3 text-left">Method</th>
-                            <th class="px-6 py-3 text-left">Status</th>
-                            <th class="px-6 py-3 text-left">By</th>
-                            <th class="px-6 py-3 text-left">Date</th>
-                            <th class="px-6 py-3 text-left">Log</th>
-                        </tr>
-                    </thead>
-                    <tbody class="divide-y divide-gray-100">
-                        @foreach($history as $entry)
-                        <tr class="hover:bg-gray-50">
-                            <td class="px-6 py-3 font-mono text-gray-600">{{ $entry->from_version ?? '—' }}</td>
-                            <td class="px-6 py-3 font-mono font-semibold text-gray-800">{{ $entry->to_version }}</td>
-                            <td class="px-6 py-3">
-                                <span class="px-2 py-0.5 text-xs rounded-full {{ $entry->method === 'git' ? 'bg-green-100 text-green-700' : 'bg-orange-100 text-orange-700' }}">
-                                    {{ $entry->method }}
-                                </span>
-                            </td>
-                            <td class="px-6 py-3">
-                                <span class="inline-flex items-center gap-1 px-2 py-0.5 text-xs rounded-full font-medium
-                                    {{ $entry->status === 'success' ? 'bg-green-100 text-green-700' : 'bg-red-100 text-red-700' }}">
-                                    <i class="fas fa-{{ $entry->status === 'success' ? 'check' : 'xmark' }} text-[10px]"></i>
-                                    {{ $entry->status }}
-                                </span>
-                            </td>
-                            <td class="px-6 py-3 text-gray-600">{{ $entry->executor?->name ?? 'System' }}</td>
-                            <td class="px-6 py-3 text-gray-500">{{ $entry->created_at->format('Y-m-d H:i') }}</td>
-                            <td class="px-6 py-3">
-                                @if($entry->notes)
-                                <button onclick="showLog({{ $entry->id }})"
-                                    class="text-blue-600 hover:underline text-xs flex items-center gap-1">
-                                    <i class="fas fa-terminal text-[10px]"></i> View
-                                </button>
-                                <pre id="log-{{ $entry->id }}" class="hidden mt-2 bg-gray-900 text-green-400 text-xs rounded p-3 overflow-x-auto max-w-xs max-h-48 leading-relaxed">{{ $entry->notes }}</pre>
-                                @endif
-                            </td>
-                        </tr>
-                        @endforeach
-                    </tbody>
-                </table>
-            </div>
-            @endif
-        </div>
-
-    </main>
-</div>
-
-{{-- Update Confirmation Modal --}}
-<div id="update-modal" class="fixed inset-0 bg-black/60 z-50 hidden items-center justify-center p-4">
-    <div class="bg-white rounded-2xl shadow-2xl max-w-lg w-full">
-        <div class="px-6 py-5 border-b border-gray-100 flex items-center justify-between">
-            <h2 class="text-lg font-bold text-gray-800 flex items-center gap-2">
-                <i class="fas fa-cloud-arrow-up text-blue-600"></i>
-                Apply Update <span id="modal-tag" class="text-blue-600 ml-1"></span>
-            </h2>
-            <button onclick="closeUpdateModal()" class="text-gray-400 hover:text-gray-600 transition">
-                <i class="fas fa-xmark text-lg"></i>
-            </button>
-        </div>
-        <div id="modal-confirm" class="p-6 space-y-4">
-            <div class="bg-amber-50 border border-amber-200 rounded-lg p-4 space-y-2">
-                <p class="text-sm font-semibold text-amber-800 flex items-center gap-2">
-                    <i class="fas fa-triangle-exclamation"></i> Before you proceed
-                </p>
-                <ul class="text-sm text-amber-700 space-y-1 list-disc list-inside">
-                    <li>Back up your <strong>database</strong> before updating</li>
-                    <li>The site will enter <strong>maintenance mode</strong> briefly</li>
-                    <li>Active sessions will be interrupted</li>
-                    <li>This action <strong>cannot be undone</strong> automatically</li>
-                </ul>
-            </div>
-            <p class="text-sm text-gray-600">
-                Update method: <strong class="capitalize">{{ $method }}</strong>.
-                Migrations will run automatically after files are applied.
-            </p>
-        </div>
-        <div id="modal-progress" class="hidden p-6">
-            <div class="flex items-center gap-3">
-                <div class="w-8 h-8 border-4 border-blue-600 border-t-transparent rounded-full animate-spin shrink-0"></div>
-                <p class="text-sm font-medium text-gray-700">Applying update — please do not close this page...</p>
-            </div>
-        </div>
-        <div id="modal-result" class="hidden p-6 space-y-3">
-            <div id="result-banner" class="rounded-lg p-4 text-sm font-semibold"></div>
-            <pre id="result-log" class="bg-gray-900 text-green-400 text-xs rounded-lg p-4 overflow-y-auto max-h-64 leading-relaxed"></pre>
-        </div>
-        <div id="modal-footer" class="px-6 py-4 border-t border-gray-100 flex items-center justify-end gap-3">
-            <button onclick="closeUpdateModal()"
-                class="px-4 py-2 text-sm text-gray-700 border border-gray-300 rounded-lg hover:bg-gray-50 transition">
-                Cancel
-            </button>
-            <button id="confirm-btn" onclick="applyUpdate()"
-                class="px-5 py-2 bg-blue-600 text-white text-sm font-semibold rounded-lg hover:bg-blue-700 transition flex items-center gap-2 shadow">
-                <i class="fas fa-cloud-arrow-up"></i> Apply Update
-            </button>
-        </div>
-    </div>
-</div>
-@endsection
-
-@push('scripts')
-<script>
-let pendingTag = null;
-
-function openUpdateModal(tag) {
-    pendingTag = tag;
-    document.getElementById('modal-tag').textContent = tag;
-    document.getElementById('modal-confirm').classList.remove('hidden');
-    document.getElementById('modal-progress').classList.add('hidden');
-    document.getElementById('modal-result').classList.add('hidden');
-    document.getElementById('modal-footer').classList.remove('hidden');
-    document.getElementById('confirm-btn').disabled = false;
-    document.getElementById('confirm-btn').classList.remove('hidden');
-    document.getElementById('update-modal').classList.remove('hidden');
-    document.getElementById('update-modal').classList.add('flex');
-}
-
-function closeUpdateModal() {
-    document.getElementById('update-modal').classList.add('hidden');
-    document.getElementById('update-modal').classList.remove('flex');
-    pendingTag = null;
-}
-
-async function applyUpdate() {
-    if (!pendingTag) return;
-    document.getElementById('modal-confirm').classList.add('hidden');
-    document.getElementById('modal-progress').classList.remove('hidden');
-    document.getElementById('modal-footer').classList.add('hidden');
-
-    try {
-        const response = await fetch('{{ route("admin.updates.apply") }}', {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'X-CSRF-TOKEN': (document.querySelector('meta[name="csrf-token"]')?.content) ?? '{{ csrf_token() }}',
-            },
-            body: JSON.stringify({ tag: pendingTag }),
-        });
-
-        const data = await response.json();
-        document.getElementById('modal-progress').classList.add('hidden');
-        document.getElementById('modal-result').classList.remove('hidden');
-
-        const banner = document.getElementById('result-banner');
-        if (data.success) {
-            banner.className = 'rounded-lg p-4 text-sm font-semibold bg-green-100 text-green-800';
-            banner.innerHTML = '<i class="fas fa-circle-check mr-2"></i>Update applied successfully! Reloading in 5 seconds...';
-            setTimeout(() => window.location.reload(), 5000);
-        } else {
-            banner.className = 'rounded-lg p-4 text-sm font-semibold bg-red-100 text-red-800';
-            banner.innerHTML = '<i class="fas fa-circle-xmark mr-2"></i>Update failed: ' + (data.error ?? 'Unknown error');
-        }
-
-        document.getElementById('result-log').textContent = (data.log ?? []).join('\n');
-        document.getElementById('modal-footer').classList.remove('hidden');
-        document.getElementById('confirm-btn').classList.add('hidden');
-
-    } catch (err) {
-        document.getElementById('modal-progress').classList.add('hidden');
-        document.getElementById('modal-result').classList.remove('hidden');
-        const banner = document.getElementById('result-banner');
-        banner.className = 'rounded-lg p-4 text-sm font-semibold bg-red-100 text-red-800';
-        banner.innerHTML = '<i class="fas fa-circle-xmark mr-2"></i>Network error: ' + err.message;
-        document.getElementById('modal-footer').classList.remove('hidden');
-        document.getElementById('confirm-btn').classList.add('hidden');
-    }
-}
-
-function checkForUpdates() {
-    document.getElementById('check-btn').disabled = true;
-    document.getElementById('check-icon').classList.add('fa-spin');
-    setTimeout(() => window.location.reload(), 400);
-}
-
-function toggleSection(id) {
-    document.getElementById(id).classList.toggle('hidden');
-    document.getElementById(id + '-chevron').classList.toggle('rotate-180');
-}
-
-function showLog(id) {
-    document.getElementById('log-' + id).classList.toggle('hidden');
-}
-
-document.getElementById('update-modal').addEventListener('click', function(e) {
-    if (e.target === this) closeUpdateModal();
-});
-</script>
-@endpush
+@endpush
\ No newline at end of file
diff --git a/app/Modules/Admin/Services/UpdateService.php b/app/Modules/Admin/Services/UpdateService.php
index a70c7bc..72f7ee2 100644
--- a/app/Modules/Admin/Services/UpdateService.php
+++ b/app/Modules/Admin/Services/UpdateService.php
@@ -357,7 +357,7 @@ public function apply(string $tag, ?int $userId = null): array
                 }
             }
 
-            $log[] = '✘ ERROR: ' . $e->getMessage();
+            $log[] = '✘ ERROR: ' . $this->sanitizeCommand($e->getMessage());
 
             UpdateLog::create([
                 'from_version' => $fromVersion,
@@ -490,6 +490,19 @@ private function deleteDirectory(string $dir): void
 
     // ─── Shell Execution ─────────────────────────────────────────────────────
 
+    /**
+     * Sanitize a command string by masking any embedded GitHub token.
+     */
+    private function sanitizeCommand(string $command): string
+    {
+        // Match: https://{token}@github.com/... or any token=xxx patterns
+        return preg_replace_callback(
+            '/(https?:\/\/)([a-zA-Z0-9_-]+)(@github\.com)/',
+            fn(array $m) => $m[1] . '****' . $m[3],
+            $command
+        );
+    }
+
     private function run(string $command, array &$log): void
     {
         $base = base_path();
@@ -502,7 +515,7 @@ private function run(string $command, array &$log): void
         $code   = 0;
         exec($wrapped, $output, $code);
 
-        $log[] = '$ ' . $command;
+        $log[] = '$ ' . $this->sanitizeCommand($command);
         foreach ($output as $line) {
             if (trim($line) !== '') {
                 $log[] = '  ' . $line;
@@ -511,7 +524,7 @@ private function run(string $command, array &$log): void
 
         if ($code !== 0) {
             throw new \RuntimeException(
-                "Command failed (exit {$code}): {$command}\n" . implode("\n", array_filter($output))
+                "Command failed (exit {$code}): " . $this->sanitizeCommand($command) . "\n" . implode("\n", array_filter($output))
             );
         }
     }
diff --git a/app/Policies/AdminUserPolicy.php b/app/Policies/AdminUserPolicy.php
new file mode 100644
index 0000000..4b13829
--- /dev/null
+++ b/app/Policies/AdminUserPolicy.php
@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\User;
+
+class AdminUserPolicy
+{
+    public function before(User $user): ?bool
+    {
+        return $user->hasPermissionTo('manage.admin.users') ? true : null;
+    }
+
+    public function viewAny(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.admin.users');
+    }
+
+    public function view(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.admin.users');
+    }
+
+    public function create(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.admin.users');
+    }
+
+    public function update(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.admin.users');
+    }
+
+    public function delete(User $user): bool
+    {
+        // Admin role users cannot be deleted
+        if ($user->hasRole('Admin')) {
+            return false;
+        }
+
+        return $user->hasPermissionTo('manage.admin.users');
+    }
+}
\ No newline at end of file
diff --git a/app/Policies/AnalyticsPolicy.php b/app/Policies/AnalyticsPolicy.php
new file mode 100644
index 0000000..3568064
--- /dev/null
+++ b/app/Policies/AnalyticsPolicy.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\User;
+
+class AnalyticsPolicy
+{
+    public function before(User $user): ?bool
+    {
+        // Analytics uses a different permission: view.analytics
+        return $user->hasPermissionTo('view.analytics') ? true : null;
+    }
+
+    public function viewAny(User $user): bool
+    {
+        return $user->hasPermissionTo('view.analytics');
+    }
+
+    public function view(User $user): bool
+    {
+        return $user->hasPermissionTo('view.analytics');
+    }
+}
\ No newline at end of file
diff --git a/app/Policies/BackupPolicy.php b/app/Policies/BackupPolicy.php
new file mode 100644
index 0000000..68e99c6
--- /dev/null
+++ b/app/Policies/BackupPolicy.php
@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\User;
+
+class BackupPolicy
+{
+    public function before(User $user): ?bool
+    {
+        return $user->hasPermissionTo('manage.backups') ? true : null;
+    }
+
+    public function viewAny(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.backups');
+    }
+
+    public function create(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.backups');
+    }
+
+    public function download(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.backups');
+    }
+
+    public function delete(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.backups');
+    }
+}
\ No newline at end of file
diff --git a/app/Policies/LogPolicy.php b/app/Policies/LogPolicy.php
new file mode 100644
index 0000000..bd690dc
--- /dev/null
+++ b/app/Policies/LogPolicy.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\User;
+
+class LogPolicy
+{
+    public function before(User $user): ?bool
+    {
+        return $user->hasPermissionTo('view.logs') ? true : null;
+    }
+
+    public function viewAny(User $user): bool
+    {
+        return $user->hasPermissionTo('view.logs');
+    }
+
+    public function view(User $user): bool
+    {
+        return $user->hasPermissionTo('view.logs');
+    }
+}
\ No newline at end of file
diff --git a/app/Policies/ModulePolicy.php b/app/Policies/ModulePolicy.php
new file mode 100644
index 0000000..c98c991
--- /dev/null
+++ b/app/Policies/ModulePolicy.php
@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\User;
+
+class ModulePolicy
+{
+    public function before(User $user): ?bool
+    {
+        return $user->hasPermissionTo('manage.modules') ? true : null;
+    }
+
+    public function viewAny(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.modules');
+    }
+
+    public function view(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.modules');
+    }
+
+    public function update(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.modules');
+    }
+
+    public function toggle(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.modules');
+    }
+
+    public function migrate(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.modules');
+    }
+
+    public function delete(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.modules');
+    }
+
+    public function uninstall(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.modules');
+    }
+}
\ No newline at end of file
diff --git a/app/Policies/NewsCategoryPolicy.php b/app/Policies/NewsCategoryPolicy.php
new file mode 100644
index 0000000..7d5c6d1
--- /dev/null
+++ b/app/Policies/NewsCategoryPolicy.php
@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\User;
+use App\Models\NewsCategory;
+
+class NewsCategoryPolicy
+{
+    public function before(User $user): ?bool
+    {
+        return $user->hasPermissionTo('manage.news') ? true : null;
+    }
+
+    public function viewAny(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.news');
+    }
+
+    public function view(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.news');
+    }
+
+    public function create(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.news');
+    }
+
+    public function update(User $user, NewsCategory $newsCategory): bool
+    {
+        return $user->hasPermissionTo('manage.news');
+    }
+
+    public function delete(User $user, NewsCategory $newsCategory): bool
+    {
+        return $user->hasPermissionTo('manage.news');
+    }
+}
\ No newline at end of file
diff --git a/app/Policies/NewsPolicy.php b/app/Policies/NewsPolicy.php
new file mode 100644
index 0000000..e83e07f
--- /dev/null
+++ b/app/Policies/NewsPolicy.php
@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\User;
+use App\Models\News;
+
+class NewsPolicy
+{
+    /**
+     * Only users with manage.news permission can perform any action.
+     */
+    public function before(User $user): ?bool
+    {
+        return $user->hasPermissionTo('manage.news') ? true : null;
+    }
+
+    public function viewAny(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.news');
+    }
+
+    public function view(User $user, News $news): bool
+    {
+        return $user->hasPermissionTo('manage.news');
+    }
+
+    public function create(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.news');
+    }
+
+    public function update(User $user, News $news): bool
+    {
+        return $user->hasPermissionTo('manage.news');
+    }
+
+    public function delete(User $user, News $news): bool
+    {
+        return $user->hasPermissionTo('manage.news');
+    }
+
+    public function restore(User $user, News $news): bool
+    {
+        return $user->hasPermissionTo('manage.news');
+    }
+}
\ No newline at end of file
diff --git a/app/Policies/RealmPolicy.php b/app/Policies/RealmPolicy.php
new file mode 100644
index 0000000..29e5cd0
--- /dev/null
+++ b/app/Policies/RealmPolicy.php
@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\User;
+
+class RealmPolicy
+{
+    public function before(User $user): ?bool
+    {
+        return $user->hasPermissionTo('manage.realms') ? true : null;
+    }
+
+    public function viewAny(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.realms');
+    }
+
+    public function view(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.realms');
+    }
+
+    public function create(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.realms');
+    }
+
+    public function update(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.realms');
+    }
+
+    public function delete(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.realms');
+    }
+
+    public function soapTest(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.realms');
+    }
+}
\ No newline at end of file
diff --git a/app/Policies/RolePolicy.php b/app/Policies/RolePolicy.php
new file mode 100644
index 0000000..8789c87
--- /dev/null
+++ b/app/Policies/RolePolicy.php
@@ -0,0 +1,38 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\User;
+
+class RolePolicy
+{
+    public function before(User $user): ?bool
+    {
+        return $user->hasPermissionTo('manage.roles') ? true : null;
+    }
+
+    public function viewAny(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.roles');
+    }
+
+    public function view(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.roles');
+    }
+
+    public function create(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.roles');
+    }
+
+    public function update(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.roles');
+    }
+
+    public function delete(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.roles');
+    }
+}
\ No newline at end of file
diff --git a/app/Policies/UpdatePolicy.php b/app/Policies/UpdatePolicy.php
new file mode 100644
index 0000000..9cf2ce4
--- /dev/null
+++ b/app/Policies/UpdatePolicy.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\User;
+
+class UpdatePolicy
+{
+    public function before(User $user): ?bool
+    {
+        return $user->hasPermissionTo('manage.settings') ? true : null;
+    }
+
+    public function viewAny(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.settings');
+    }
+
+    public function view(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.settings');
+    }
+
+    public function apply(User $user): bool
+    {
+        return $user->hasPermissionTo('manage.settings');
+    }
+}
\ No newline at end of file
diff --git a/app/Providers/AuthServiceProvider.php b/app/Providers/AuthServiceProvider.php
new file mode 100644
index 0000000..a7253b8
--- /dev/null
+++ b/app/Providers/AuthServiceProvider.php
@@ -0,0 +1,57 @@
+<?php
+
+namespace App\Providers;
+
+use App\Models\User;
+use App\Models\News;
+use App\Models\NewsCategory;
+use App\Models\Role;
+use App\Models\Permission;
+use App\Models\UpdateLog;
+use App\Models\Backup;
+use App\Models\Module;
+use App\Models\Log;
+use App\Models\Realm;
+use App\Models\AnalyticsSession;
+use App\Policies\PermissionPolicy;
+use App\Policies\NewsPolicy;
+use App\Policies\NewsCategoryPolicy;
+use App\Policies\RolePolicy;
+use App\Policies\AdminUserPolicy;
+use App\Policies\RealmPolicy;
+use App\Policies\BackupPolicy;
+use App\Policies\UpdatePolicy;
+use App\Policies\ModulePolicy;
+use App\Policies\LogPolicy;
+use App\Policies\AnalyticsPolicy;
+use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;
+
+class AuthServiceProvider extends ServiceProvider
+{
+    /**
+     * The model to policy mappings for the application.
+     *
+     * @var array<class-string, class-string>
+     */
+    protected $policies = [
+        User::class            => AdminUserPolicy::class,
+        News::class            => NewsPolicy::class,
+        NewsCategory::class    => NewsCategoryPolicy::class,
+        Role::class            => RolePolicy::class,
+        Permission::class      => PermissionPolicy::class,
+        UpdateLog::class       => UpdatePolicy::class,
+        Backup::class          => BackupPolicy::class,
+        Module::class          => ModulePolicy::class,
+        Log::class             => LogPolicy::class,
+        Realm::class           => RealmPolicy::class,
+        AnalyticsSession::class => AnalyticsPolicy::class,
+    ];
+
+    /**
+     * Register any authentication / authorization services.
+     */
+    public function boot(): void
+    {
+        $this->registerPolicies();
+    }
+}
\ No newline at end of file
diff --git a/bootstrap/providers.php b/bootstrap/providers.php
index 8e23487..a0784c8 100755
--- a/bootstrap/providers.php
+++ b/bootstrap/providers.php
@@ -3,6 +3,7 @@
 // Core providers
 $providers = [
     App\Providers\AppServiceProvider::class,
+    App\Providers\AuthServiceProvider::class,
     Spatie\Permission\PermissionServiceProvider::class,
     App\Providers\ModuleServiceProvider::class,
 ];

From bfd51eb5f3cecc5135be626cf8f772e2f57af0e1 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 30 May 2026 01:19:50 +0200
Subject: [PATCH 122/132] feat: Implement comment deletion authorization and
 add security headers middleware

---
 .../Frontend/CommentController.php            | 19 +++++--------
 .../Frontend/Users/UserController.php         |  2 +-
 app/Http/Middleware/SecurityHeaders.php       | 28 +++++++++++++++++++
 .../Http/Controllers/BackupController.php     |  6 ----
 app/Policies/CommentPolicy.php                | 14 ++++++++++
 app/Providers/AuthServiceProvider.php         |  2 ++
 bootstrap/app.php                             |  1 +
 resources/views/forums/thread.blade.php       |  2 +-
 resources/views/news/show.blade.php           |  4 +--
 resources/views/ucp/manageAccount.blade.php   |  8 +++---
 routes/web.php                                |  2 +-
 11 files changed, 61 insertions(+), 27 deletions(-)
 create mode 100644 app/Http/Middleware/SecurityHeaders.php
 create mode 100644 app/Policies/CommentPolicy.php

diff --git a/app/Http/Controllers/Frontend/CommentController.php b/app/Http/Controllers/Frontend/CommentController.php
index b4426b9..789c5d0 100644
--- a/app/Http/Controllers/Frontend/CommentController.php
+++ b/app/Http/Controllers/Frontend/CommentController.php
@@ -7,9 +7,11 @@
 use App\Models\News;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Auth;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
 
 class CommentController extends Controller
 {
+    use AuthorizesRequests;
     /**
      * Store a newly created comment.
      *
@@ -37,19 +39,12 @@ public function store(Request $request, $slug)
 
     /**
      * Remove the specified comment.
-     *
-     * @param  int  $id
-     * @return \Illuminate\Http\Response
      */
-    public function destroy($id)
+    public function destroy(Comment $comment)
     {
-        $comment = Comment::findOrFail($id);
-        
-        if (Auth::id() == $comment->user_id || (Auth::user() && Auth::user()->hasRole('Admin'))) {
-            $comment->delete();
-            return redirect()->back()->with('success', 'Comment deleted successfully!');
-        }
-        
-        return redirect()->back()->with('error', 'You are not authorized to delete this comment.');
+        $this->authorize('delete', $comment);
+
+        $comment->delete();
+        return redirect()->back()->with('success', 'Comment deleted successfully!');
     }
 }
\ No newline at end of file
diff --git a/app/Http/Controllers/Frontend/Users/UserController.php b/app/Http/Controllers/Frontend/Users/UserController.php
index cd6fb33..09ff538 100755
--- a/app/Http/Controllers/Frontend/Users/UserController.php
+++ b/app/Http/Controllers/Frontend/Users/UserController.php
@@ -293,7 +293,7 @@ public function createGameAccount(Request $request)
         // Generate password using WoWCrypto
         $username = strtoupper($request->username);
         $email    = strtoupper($request->email);
-        $password = strtoupper($request->password);
+        $password = $request->password;
 
         try {
             // Obtain realm configuration
diff --git a/app/Http/Middleware/SecurityHeaders.php b/app/Http/Middleware/SecurityHeaders.php
new file mode 100644
index 0000000..c31bd62
--- /dev/null
+++ b/app/Http/Middleware/SecurityHeaders.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class SecurityHeaders
+{
+    /**
+     * Handle an incoming request.
+     *
+     * @param  \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response)  $next
+     */
+    public function handle(Request $request, Closure $next): Response
+    {
+        $response = $next($request);
+
+        $response->headers->set('X-Frame-Options', 'SAMEORIGIN');
+        $response->headers->set('X-Content-Type-Options', 'nosniff');
+        $response->headers->set('X-XSS-Protection', '1; mode=block');
+        $response->headers->set('Referrer-Policy', 'strict-origin-when-cross-origin');
+        $response->headers->set('Permissions-Policy', 'camera=(), microphone=(), geolocation=()');
+
+        return $response;
+    }
+}
\ No newline at end of file
diff --git a/app/Modules/Admin/Http/Controllers/BackupController.php b/app/Modules/Admin/Http/Controllers/BackupController.php
index 6d140cb..11ce8d9 100644
--- a/app/Modules/Admin/Http/Controllers/BackupController.php
+++ b/app/Modules/Admin/Http/Controllers/BackupController.php
@@ -74,12 +74,6 @@ public function create()
                 $zip->addFile($dumpFile, 'database.sql');
             }
 
-            // Add .env
-            $envPath = base_path('.env');
-            if (File::exists($envPath)) {
-                $zip->addFile($envPath, '.env');
-            }
-
             // Add config files
             $this->addDirectoryToZip($zip, config_path(), 'config');
 
diff --git a/app/Policies/CommentPolicy.php b/app/Policies/CommentPolicy.php
new file mode 100644
index 0000000..751f70b
--- /dev/null
+++ b/app/Policies/CommentPolicy.php
@@ -0,0 +1,14 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\User;
+use App\Models\Comment;
+
+class CommentPolicy
+{
+    public function delete(User $user, Comment $comment): bool
+    {
+        return $user->id === $comment->user_id || $user->hasRole('Admin');
+    }
+}
\ No newline at end of file
diff --git a/app/Providers/AuthServiceProvider.php b/app/Providers/AuthServiceProvider.php
index a7253b8..6941b40 100644
--- a/app/Providers/AuthServiceProvider.php
+++ b/app/Providers/AuthServiceProvider.php
@@ -13,6 +13,7 @@
 use App\Models\Log;
 use App\Models\Realm;
 use App\Models\AnalyticsSession;
+use App\Models\Comment;
 use App\Policies\PermissionPolicy;
 use App\Policies\NewsPolicy;
 use App\Policies\NewsCategoryPolicy;
@@ -45,6 +46,7 @@ class AuthServiceProvider extends ServiceProvider
         Log::class             => LogPolicy::class,
         Realm::class           => RealmPolicy::class,
         AnalyticsSession::class => AnalyticsPolicy::class,
+        Comment::class          => CommentPolicy::class,
     ];
 
     /**
diff --git a/bootstrap/app.php b/bootstrap/app.php
index 9dbbb37..e99aa04 100755
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -13,6 +13,7 @@
     ->withMiddleware(function (Middleware $middleware) {
         $middleware->web(append: [
             \App\Http\Middleware\CheckMaintenanceMode::class,
+            \App\Http\Middleware\SecurityHeaders::class,
         ]);
 
         $middleware->alias([
diff --git a/resources/views/forums/thread.blade.php b/resources/views/forums/thread.blade.php
index 2d712c5..6534850 100755
--- a/resources/views/forums/thread.blade.php
+++ b/resources/views/forums/thread.blade.php
@@ -114,7 +114,7 @@
                         </div>
                     </div>
                     <div class="flex-grow md:pl-8 text-white max-w-none">
-                        {!! $post->content !!}
+                        {{ $post->content }}
                     </div>
                 </div>
             </div>
diff --git a/resources/views/news/show.blade.php b/resources/views/news/show.blade.php
index 2247789..9872080 100644
--- a/resources/views/news/show.blade.php
+++ b/resources/views/news/show.blade.php
@@ -136,7 +136,7 @@ class="w-10 h-10 flex items-center justify-center rounded-full bg-slate-800/60 h
                     prose-code:text-blue-300 prose-code:bg-slate-800/60 prose-code:rounded prose-code:px-1
                     prose-pre:bg-slate-800/80 prose-pre:border prose-pre:border-slate-700
                     prose-img:rounded-xl prose-img:shadow-2xl">
-                    {!! $item->display_content !!}
+                    {{ $item->display_content }}
                 </article>
 
                 {{-- Share mobile --}}
@@ -225,7 +225,7 @@ class="w-full px-4 py-3 bg-slate-800/50 border border-slate-700 rounded-xl text-
                                     <span class="text-xs text-slate-500 ml-auto">{{ $comment->created_at->format('d/m/Y H:i') }}</span>
                                 </div>
                                 <div class="text-slate-300 text-sm leading-relaxed">
-                                    {!! $comment->comment !!}
+                                    {{ $comment->comment }}
                                 </div>
                             </div>
                         </div>
diff --git a/resources/views/ucp/manageAccount.blade.php b/resources/views/ucp/manageAccount.blade.php
index c5a0143..1a2a08f 100755
--- a/resources/views/ucp/manageAccount.blade.php
+++ b/resources/views/ucp/manageAccount.blade.php
@@ -251,17 +251,17 @@ class="flex-1 px-3 py-2 bg-gray-800/70 border border-gray-600 rounded text-gray-
                                     <form class="space-y-4">
                                         <div>
                                             <label class="block text-sm font-medium text-gray-300 mb-2">Contraseña Actual</label>
-                                            <input type="password" class="w-full px-3 py-2 bg-gray-800/70 border border-gray-600 rounded text-gray-300 focus:outline-none focus:ring-2 focus:ring-indigo-500">
+                                            <input type="password" class="w-full px-3 py-2 bg-gray-800/70 border border-gray-600 rounded text-gray-300 focus:outline-none focus:ring-2 focus:ring-indigo-500" disabled>
                                         </div>
                                         <div>
                                             <label class="block text-sm font-medium text-gray-300 mb-2">Nueva Contraseña</label>
-                                            <input type="password" class="w-full px-3 py-2 bg-gray-800/70 border border-gray-600 rounded text-gray-300 focus:outline-none focus:ring-2 focus:ring-indigo-500">
+                                            <input type="password" class="w-full px-3 py-2 bg-gray-800/70 border border-gray-600 rounded text-gray-300 focus:outline-none focus:ring-2 focus:ring-indigo-500" disabled>
                                         </div>
                                         <div>
                                             <label class="block text-sm font-medium text-gray-300 mb-2">Confirmar Nueva Contraseña</label>
-                                            <input type="password" class="w-full px-3 py-2 bg-gray-800/70 border border-gray-600 rounded text-gray-300 focus:outline-none focus:ring-2 focus:ring-indigo-500">
+                                            <input type="password" class="w-full px-3 py-2 bg-gray-800/70 border border-gray-600 rounded text-gray-300 focus:outline-none focus:ring-2 focus:ring-indigo-500" disabled>
                                         </div>
-                                        <button type="submit" class="px-6 py-2 bg-yellow-600 text-white rounded hover:bg-yellow-500 transition-colors">
+                                        <button type="submit" class="px-6 py-2 bg-yellow-600 text-white rounded hover:bg-yellow-500 transition-colors" disabled title="Funcionalidad pendiente de implementar">
                                             <i class="fas fa-save mr-2"></i>Cambiar Contraseña
                                         </button>
                                     </form>
diff --git a/routes/web.php b/routes/web.php
index ebb3280..88b57e4 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -23,7 +23,7 @@
     Route::get('/', [NewsController::class, 'index'])->name('news');
     Route::get('/{slug}', [NewsController::class, 'show'])->name('news.show');
     Route::post('/{slug}/comment', [CommentController::class, 'store'])->middleware('auth')->name('news.comment.store');
-    Route::delete('/comment/{id}', [CommentController::class, 'destroy'])->middleware('auth')->name('news.comment.destroy');
+    Route::delete('/comment/{comment}', [CommentController::class, 'destroy'])->middleware('auth')->name('news.comment.destroy');
     Route::post('/subscribe', [SubscriptionController::class, 'subscribe'])->name('subscribe');
     Route::get('/confirm-subscription/{token}', [SubscriptionController::class, 'confirmSubscription'])->name('confirm.subscription');
     Route::get('/unsubscribe/{token}', [SubscriptionController::class, 'unsubscribe'])->name('unsubscribe');

From 1e041e7040b83bebf3bf3ad77c13ffbbcb4186a9 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 30 May 2026 02:14:22 +0200
Subject: [PATCH 123/132] Update app version to 0.1.6-alpha.4 and add
 SystemInfoService for system diagnostics

---
 .../Http/Controllers/AdminController.php      |   12 +-
 .../Admin/Resources/views/index.blade.php     |   68 +-
 app/Services/SystemInfoService.php            |  112 +
 composer.json                                 |   14 +-
 composer.lock                                 | 2612 +++++++++--------
 config/app.php                                |    2 +-
 6 files changed, 1458 insertions(+), 1362 deletions(-)
 create mode 100644 app/Services/SystemInfoService.php

diff --git a/app/Modules/Admin/Http/Controllers/AdminController.php b/app/Modules/Admin/Http/Controllers/AdminController.php
index da13711..4783f22 100644
--- a/app/Modules/Admin/Http/Controllers/AdminController.php
+++ b/app/Modules/Admin/Http/Controllers/AdminController.php
@@ -3,18 +3,20 @@
 namespace Modules\Admin\Http\Controllers;
 
 use App\Http\Controllers\Controller;
-use Modules\Admin\Services\UpdateService;
+use App\Services\SystemInfoService;
 use Illuminate\Http\Request;
 
 class AdminController extends Controller
 {
-    public function __construct(protected UpdateService $updateService) {}
+    public function __construct(
+        protected SystemInfoService $systemInfo,
+    ) {}
 
     public function index(Request $request)
     {
-        $latestRelease = $this->updateService->getLatestRelease();
-        $outdated      = $this->updateService->isOutdated($latestRelease);
+        $systemInfo    = $this->systemInfo->getInfo();
+        $isDebug       = $this->systemInfo->isDebugEnabled();
 
-        return view('admin::index', compact('latestRelease', 'outdated'));
+        return view('admin::index', compact('systemInfo', 'isDebug'));
     }
 }
diff --git a/app/Modules/Admin/Resources/views/index.blade.php b/app/Modules/Admin/Resources/views/index.blade.php
index abba016..43b7286 100644
--- a/app/Modules/Admin/Resources/views/index.blade.php
+++ b/app/Modules/Admin/Resources/views/index.blade.php
@@ -237,58 +237,33 @@
 
         <!-- Right Column -->
         <div class="space-y-6">
-            <!-- CMS Update and version -->
-            <!-- CMS Update & Version -->
-            <div class="bg-gradient-to-br from-blue-50 to-indigo-50 rounded-xl shadow-lg border border-blue-100 overflow-hidden">
-                <div class="px-6 py-4 bg-white/60 backdrop-blur-sm border-b border-blue-100 flex items-center justify-between">
-                    <h2 class="text-lg font-bold text-gray-800 flex items-center gap-2">
-                        <i class="fas fa-rocket text-blue-600"></i>
-                        System Update
+            <!-- System Information -->
+            <div class="bg-white rounded-lg shadow">
+                <div class="p-4 border-b border-gray-200 flex items-center justify-between">
+                    <h2 class="text-base font-bold text-gray-800 flex items-center gap-2">
+                        <i class="fas fa-info-circle text-blue-600"></i>
+                        System Information
                     </h2>
-                    <span class="px-3 py-1 bg-green-100 text-green-700 rounded-full text-xs font-semibold shadow-sm">v{{ config('app.version') }}</span>
+                    @if($isDebug)
+                    <span class="px-2 py-0.5 bg-red-100 text-red-700 rounded text-xs font-semibold">DEBUG ON</span>
+                    @endif
                 </div>
-                <div class="p-6">
-                    @if($latestRelease === null)
-                    <div class="flex items-start gap-4">
-                        <div class="w-12 h-12 bg-gradient-to-br from-gray-400 to-gray-500 rounded-xl flex items-center justify-center shadow-md">
-                            <i class="fas fa-plug text-white text-xl"></i>
-                        </div>
-                        <div class="flex-1">
-                            <p class="text-base text-gray-800 font-semibold mb-1">Could not connect to the update server</p>
-                            <p class="text-sm text-gray-500">Version information is unavailable. Check your internet connection or verify the repository and GitHub token in <a href="{{ route('admin.settings.index') }}#updates" class="text-blue-600 hover:underline">Settings → Updates</a>.</p>
-                        </div>
-                    </div>
-                    @elseif($outdated)
-                    <div class="flex items-start gap-4">
-                        <div class="w-12 h-12 bg-gradient-to-br from-blue-500 to-indigo-600 rounded-xl flex items-center justify-center shadow-md">
-                            <i class="fas fa-rocket text-white text-xl"></i>
-                        </div>
-                        <div class="flex-1">
-                            <p class="text-base text-gray-800 font-semibold mb-1">NexusCMS {{ $latestRelease['tag_name'] }} is now available</p>
-                            <p class="text-sm text-gray-600 mb-3">{{ Str::limit($latestRelease['body'] ?? '', 120) }}</p>
-                            <div class="flex items-center gap-3">
-                                <a href="{{ route('admin.updates.index') }}" class="inline-flex items-center gap-1.5 px-4 py-1.5 bg-blue-600 text-white text-sm font-medium rounded-lg hover:bg-blue-700 transition shadow-sm">
-                                    <i class="fas fa-cloud-arrow-up text-xs"></i> Update now
-                                </a>
-                                <a href="{{ $latestRelease['html_url'] }}" target="_blank" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
+                <div class="p-4">
+                    <div class="grid grid-cols-2 gap-3">
+                        @foreach($systemInfo as $item)
+                        <div class="flex items-center gap-3 p-2 rounded-lg bg-gray-50 hover:bg-gray-100 transition">
+                            <div class="w-8 h-8 rounded-lg flex items-center justify-center bg-{{ $item['color'] }}-100">
+                                <i class="{{ $item['icon'] }} text-{{ $item['color'] }}-600 text-sm"></i>
                             </div>
-                        </div>
-                    </div>
-                    @else
-                    <div class="flex items-start gap-4">
-                        <div class="w-12 h-12 bg-gradient-to-br from-green-400 to-emerald-500 rounded-xl flex items-center justify-center shadow-md">
-                            <i class="fas fa-circle-check text-white text-xl"></i>
-                        </div>
-                        <div class="flex-1">
-                            <p class="text-base text-gray-800 font-semibold mb-1">You are up to date</p>
-                            <p class="text-sm text-gray-600">Version {{ $latestRelease['tag_name'] }} —
-                                released {{ \Carbon\Carbon::parse($latestRelease['published_at'])->diffForHumans() }}</p>
-                            <div class="flex items-center gap-3 mt-2">
-                                <a href="{{ $latestRelease['html_url'] }}" target="_blank" class="text-sm font-medium text-blue-600 hover:text-blue-700 hover:underline transition">Release notes</a>
+                            <div class="min-w-0">
+                                <p class="text-xs text-gray-500 truncate">{{ $item['label'] }}</p>
+                                <p class="text-sm font-semibold text-gray-800 truncate" title="{{ $item['value'] }}">
+                                    {{ $item['value'] }}
+                                </p>
                             </div>
                         </div>
+                        @endforeach
                     </div>
-                    @endif
                 </div>
             </div>
 
@@ -331,6 +306,7 @@
                 </div>
             </div>
 
+        
             <!-- Recent Donations -->
             <div class="bg-white rounded-lg shadow">
                 <div class="p-6 border-b border-gray-200">
diff --git a/app/Services/SystemInfoService.php b/app/Services/SystemInfoService.php
new file mode 100644
index 0000000..eebfdae
--- /dev/null
+++ b/app/Services/SystemInfoService.php
@@ -0,0 +1,112 @@
+<?php
+
+namespace App\Services;
+
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\Redis;
+use Illuminate\Support\Str;
+
+class SystemInfoService
+{
+    public function getInfo(): array
+    {
+        return [
+            'php' => [
+                'label' => 'PHP Version',
+                'value' => PHP_VERSION,
+                'icon'  => 'fab fa-php',
+                'color' => 'purple',
+            ],
+            'laravel' => [
+                'label' => 'Laravel',
+                'value' => app()->version(),
+                'icon'  => 'fab fa-laravel',
+                'color' => 'red',
+            ],
+            'nexuscms' => [
+                'label' => 'NexusCMS',
+                'value' => config('app.version', 'Unknown'),
+                'icon'  => 'fas fa-cubes',
+                'color' => 'blue',
+            ],
+            'database' => [
+                'label' => 'Database',
+                'value' => $this->getDatabaseInfo(),
+                'icon'  => 'fas fa-database',
+                'color' => 'green',
+            ],
+            'cache' => [
+                'label' => 'Cache Driver',
+                'value' => config('cache.default'),
+                'icon'  => 'fas fa-bolt',
+                'color' => 'yellow',
+            ],
+            'queue' => [
+                'label' => 'Queue Driver',
+                'value' => config('queue.default'),
+                'icon'  => 'fas fa-clock',
+                'color' => 'cyan',
+            ],
+            'environment' => [
+                'label' => 'Environment',
+                'value' => app()->environment(),
+                'icon'  => 'fas fa-server',
+                'color' => $this->isProduction() ? 'red' : 'green',
+            ],
+            'timezone' => [
+                'label' => 'Timezone',
+                'value' => config('app.timezone'),
+                'icon'  => 'fas fa-globe',
+                'color' => 'indigo',
+            ],
+        ];
+    }
+
+    public function getDatabaseInfo(): string
+    {
+        $driver = config('database.default');
+        $connections = config('database.connections');
+
+        if (isset($connections[$driver])) {
+            $db = $connections[$driver]['database'] ?? 'unknown';
+            return ucfirst($driver) . " ({$db})";
+        }
+
+        return ucfirst($driver);
+    }
+
+    public function isProduction(): bool
+    {
+        return app()->environment('production');
+    }
+
+    public function isDebugEnabled(): bool
+    {
+        return config('app.debug') === true;
+    }
+
+    public function getUptime(): string
+    {
+        if (!function_exists('shell_exec')) {
+            return 'N/A';
+        }
+
+        $uptime = @shell_exec('uptime -p 2>&1');
+        if ($uptime === null) {
+            // Windows
+            $uptime = @shell_exec('net stats srv 2>&1');
+            if ($uptime && preg_match('/Statistics since (\d{1,2}\/\d{1,2}\/\d{4})/', $uptime, $m)) {
+                return 'Since ' . $m[1];
+            }
+            return 'N/A';
+        }
+
+        return trim($uptime) ?: 'N/A';
+    }
+
+    public function getServerSoftware(): string
+    {
+        return $_SERVER['SERVER_SOFTWARE'] ?? $_SERVER['SERVER_SIGNATURE'] ?? 'Unknown';
+    }
+}
\ No newline at end of file
diff --git a/composer.json b/composer.json
index 985f7ed..632cfb6 100755
--- a/composer.json
+++ b/composer.json
@@ -13,9 +13,10 @@
     ],
     "require": {
         "php": "^8.4",
-        "laravel/framework": "12.40.2",
-        "laravel/pulse": "^1.4",
-        "laravel/tinker": "2.10.1",
+        "laravel/framework": "^13.0",
+        "laravel/boost": "^2.4.8",
+        "laravel/pulse": "^1.7.3",
+        "laravel/tinker": "^3.0.2",
         "predis/predis": "3.2.0",
         "spatie/laravel-permission": "^6.18",
         "wowcrypto/wowcrypto": "1.3.0",
@@ -23,12 +24,11 @@
     },
     "require-dev": {
         "fakerphp/faker": "1.23",
-        "laravel/pail": "1.2.3",
+        "laravel/pail": "1.2.7",
         "laravel/pint": "1.25.1",
-        "laravel/sail": "1.46.0",
+        "laravel/sail": "1.61.0",
         "mockery/mockery": "1.6.12",
-        "nunomaduro/collision": "8.6",
-        "phpunit/phpunit": "11.5.3",
+        "phpunit/phpunit": "^12.0",
         "squizlabs/php_codesniffer": "3.12"
     },
     "autoload": {
diff --git a/composer.lock b/composer.lock
index d31bb2a..169f733 100755
--- a/composer.lock
+++ b/composer.lock
@@ -4,20 +4,20 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "9fbb1cd1ea041d3f404fc90d747bfcec",
+    "content-hash": "196b8ac9910b8afc2c519ab587c11f3c",
     "packages": [
         {
             "name": "braintree/braintree_php",
-            "version": "6.31.0",
+            "version": "6.35.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/braintree/braintree_php.git",
-                "reference": "5c41da561a821d4131bcd336322e196e0198ef83"
+                "reference": "5a217cd832c0f6cd1e7b2af99686421598f93224"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/braintree/braintree_php/zipball/5c41da561a821d4131bcd336322e196e0198ef83",
-                "reference": "5c41da561a821d4131bcd336322e196e0198ef83",
+                "url": "https://api.github.com/repos/braintree/braintree_php/zipball/5a217cd832c0f6cd1e7b2af99686421598f93224",
+                "reference": "5a217cd832c0f6cd1e7b2af99686421598f93224",
                 "shasum": ""
             },
             "require": {
@@ -51,22 +51,22 @@
             "description": "Braintree PHP Client Library",
             "support": {
                 "issues": "https://github.com/braintree/braintree_php/issues",
-                "source": "https://github.com/braintree/braintree_php/tree/6.31.0"
+                "source": "https://github.com/braintree/braintree_php/tree/6.35.0"
             },
-            "time": "2025-12-11T16:27:18+00:00"
+            "time": "2026-05-27T19:15:31+00:00"
         },
         {
             "name": "brick/math",
-            "version": "0.14.1",
+            "version": "0.14.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/brick/math.git",
-                "reference": "f05858549e5f9d7bb45875a75583240a38a281d0"
+                "reference": "63422359a44b7f06cae63c3b429b59e8efcc0629"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/brick/math/zipball/f05858549e5f9d7bb45875a75583240a38a281d0",
-                "reference": "f05858549e5f9d7bb45875a75583240a38a281d0",
+                "url": "https://api.github.com/repos/brick/math/zipball/63422359a44b7f06cae63c3b429b59e8efcc0629",
+                "reference": "63422359a44b7f06cae63c3b429b59e8efcc0629",
                 "shasum": ""
             },
             "require": {
@@ -105,7 +105,7 @@
             ],
             "support": {
                 "issues": "https://github.com/brick/math/issues",
-                "source": "https://github.com/brick/math/tree/0.14.1"
+                "source": "https://github.com/brick/math/tree/0.14.8"
             },
             "funding": [
                 {
@@ -113,7 +113,7 @@
                     "type": "github"
                 }
             ],
-            "time": "2025-11-24T14:40:29+00:00"
+            "time": "2026-02-10T14:33:43+00:00"
         },
         {
             "name": "carbonphp/carbon-doctrine-types",
@@ -428,16 +428,16 @@
         },
         {
             "name": "doctrine/sql-formatter",
-            "version": "1.5.3",
+            "version": "1.5.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/sql-formatter.git",
-                "reference": "a8af23a8e9d622505baa2997465782cbe8bb7fc7"
+                "reference": "9563949f5cd3bd12a17d12fb980528bc141c5806"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/sql-formatter/zipball/a8af23a8e9d622505baa2997465782cbe8bb7fc7",
-                "reference": "a8af23a8e9d622505baa2997465782cbe8bb7fc7",
+                "url": "https://api.github.com/repos/doctrine/sql-formatter/zipball/9563949f5cd3bd12a17d12fb980528bc141c5806",
+                "reference": "9563949f5cd3bd12a17d12fb980528bc141c5806",
                 "shasum": ""
             },
             "require": {
@@ -477,9 +477,9 @@
             ],
             "support": {
                 "issues": "https://github.com/doctrine/sql-formatter/issues",
-                "source": "https://github.com/doctrine/sql-formatter/tree/1.5.3"
+                "source": "https://github.com/doctrine/sql-formatter/tree/1.5.4"
             },
-            "time": "2025-10-26T09:35:14+00:00"
+            "time": "2026-02-08T16:21:46+00:00"
         },
         {
             "name": "dragonmantank/cron-expression",
@@ -614,31 +614,31 @@
         },
         {
             "name": "fruitcake/php-cors",
-            "version": "v1.3.0",
+            "version": "v1.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/fruitcake/php-cors.git",
-                "reference": "3d158f36e7875e2f040f37bc0573956240a5a38b"
+                "reference": "38aaa6c3fd4c157ffe2a4d10aa8b9b16ba8de379"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/fruitcake/php-cors/zipball/3d158f36e7875e2f040f37bc0573956240a5a38b",
-                "reference": "3d158f36e7875e2f040f37bc0573956240a5a38b",
+                "url": "https://api.github.com/repos/fruitcake/php-cors/zipball/38aaa6c3fd4c157ffe2a4d10aa8b9b16ba8de379",
+                "reference": "38aaa6c3fd4c157ffe2a4d10aa8b9b16ba8de379",
                 "shasum": ""
             },
             "require": {
-                "php": "^7.4|^8.0",
-                "symfony/http-foundation": "^4.4|^5.4|^6|^7"
+                "php": "^8.1",
+                "symfony/http-foundation": "^5.4|^6.4|^7.3|^8"
             },
             "require-dev": {
-                "phpstan/phpstan": "^1.4",
+                "phpstan/phpstan": "^2",
                 "phpunit/phpunit": "^9",
-                "squizlabs/php_codesniffer": "^3.5"
+                "squizlabs/php_codesniffer": "^4"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "1.2-dev"
+                    "dev-master": "1.3-dev"
                 }
             },
             "autoload": {
@@ -669,7 +669,7 @@
             ],
             "support": {
                 "issues": "https://github.com/fruitcake/php-cors/issues",
-                "source": "https://github.com/fruitcake/php-cors/tree/v1.3.0"
+                "source": "https://github.com/fruitcake/php-cors/tree/v1.4.0"
             },
             "funding": [
                 {
@@ -681,28 +681,28 @@
                     "type": "github"
                 }
             ],
-            "time": "2023-10-12T05:21:21+00:00"
+            "time": "2025-12-03T09:33:47+00:00"
         },
         {
             "name": "graham-campbell/result-type",
-            "version": "v1.1.3",
+            "version": "v1.1.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/GrahamCampbell/Result-Type.git",
-                "reference": "3ba905c11371512af9d9bdd27d99b782216b6945"
+                "reference": "e01f4a821471308ba86aa202fed6698b6b695e3b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/GrahamCampbell/Result-Type/zipball/3ba905c11371512af9d9bdd27d99b782216b6945",
-                "reference": "3ba905c11371512af9d9bdd27d99b782216b6945",
+                "url": "https://api.github.com/repos/GrahamCampbell/Result-Type/zipball/e01f4a821471308ba86aa202fed6698b6b695e3b",
+                "reference": "e01f4a821471308ba86aa202fed6698b6b695e3b",
                 "shasum": ""
             },
             "require": {
                 "php": "^7.2.5 || ^8.0",
-                "phpoption/phpoption": "^1.9.3"
+                "phpoption/phpoption": "^1.9.5"
             },
             "require-dev": {
-                "phpunit/phpunit": "^8.5.39 || ^9.6.20 || ^10.5.28"
+                "phpunit/phpunit": "^8.5.41 || ^9.6.22 || ^10.5.45 || ^11.5.7"
             },
             "type": "library",
             "autoload": {
@@ -731,7 +731,7 @@
             ],
             "support": {
                 "issues": "https://github.com/GrahamCampbell/Result-Type/issues",
-                "source": "https://github.com/GrahamCampbell/Result-Type/tree/v1.1.3"
+                "source": "https://github.com/GrahamCampbell/Result-Type/tree/v1.1.4"
             },
             "funding": [
                 {
@@ -743,20 +743,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-07-20T21:45:45+00:00"
+            "time": "2025-12-27T19:43:20+00:00"
         },
         {
             "name": "guzzlehttp/guzzle",
-            "version": "7.10.0",
+            "version": "7.10.5",
             "source": {
                 "type": "git",
                 "url": "https://github.com/guzzle/guzzle.git",
-                "reference": "b51ac707cfa420b7bfd4e4d5e510ba8008e822b4"
+                "reference": "7c8d84b39e680315f687e8662a9d6fb0865c5148"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/guzzle/zipball/b51ac707cfa420b7bfd4e4d5e510ba8008e822b4",
-                "reference": "b51ac707cfa420b7bfd4e4d5e510ba8008e822b4",
+                "url": "https://api.github.com/repos/guzzle/guzzle/zipball/7c8d84b39e680315f687e8662a9d6fb0865c5148",
+                "reference": "7c8d84b39e680315f687e8662a9d6fb0865c5148",
                 "shasum": ""
             },
             "require": {
@@ -774,8 +774,9 @@
                 "bamarni/composer-bin-plugin": "^1.8.2",
                 "ext-curl": "*",
                 "guzzle/client-integration-tests": "3.0.2",
+                "guzzlehttp/test-server": "^0.4",
                 "php-http/message-factory": "^1.1",
-                "phpunit/phpunit": "^8.5.39 || ^9.6.20",
+                "phpunit/phpunit": "^8.5.52 || ^9.6.34",
                 "psr/log": "^1.1 || ^2.0 || ^3.0"
             },
             "suggest": {
@@ -853,7 +854,7 @@
             ],
             "support": {
                 "issues": "https://github.com/guzzle/guzzle/issues",
-                "source": "https://github.com/guzzle/guzzle/tree/7.10.0"
+                "source": "https://github.com/guzzle/guzzle/tree/7.10.5"
             },
             "funding": [
                 {
@@ -869,20 +870,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-08-23T22:36:01+00:00"
+            "time": "2026-05-27T11:53:46+00:00"
         },
         {
             "name": "guzzlehttp/promises",
-            "version": "2.3.0",
+            "version": "2.4.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/guzzle/promises.git",
-                "reference": "481557b130ef3790cf82b713667b43030dc9c957"
+                "reference": "09e8a212562fb1fb6a512c4156ed71525969d6c2"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/promises/zipball/481557b130ef3790cf82b713667b43030dc9c957",
-                "reference": "481557b130ef3790cf82b713667b43030dc9c957",
+                "url": "https://api.github.com/repos/guzzle/promises/zipball/09e8a212562fb1fb6a512c4156ed71525969d6c2",
+                "reference": "09e8a212562fb1fb6a512c4156ed71525969d6c2",
                 "shasum": ""
             },
             "require": {
@@ -890,7 +891,7 @@
             },
             "require-dev": {
                 "bamarni/composer-bin-plugin": "^1.8.2",
-                "phpunit/phpunit": "^8.5.44 || ^9.6.25"
+                "phpunit/phpunit": "^8.5.52 || ^9.6.34"
             },
             "type": "library",
             "extra": {
@@ -936,7 +937,7 @@
             ],
             "support": {
                 "issues": "https://github.com/guzzle/promises/issues",
-                "source": "https://github.com/guzzle/promises/tree/2.3.0"
+                "source": "https://github.com/guzzle/promises/tree/2.4.1"
             },
             "funding": [
                 {
@@ -952,20 +953,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-08-22T14:34:08+00:00"
+            "time": "2026-05-20T22:57:30+00:00"
         },
         {
             "name": "guzzlehttp/psr7",
-            "version": "2.8.0",
+            "version": "2.10.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/guzzle/psr7.git",
-                "reference": "21dc724a0583619cd1652f673303492272778051"
+                "reference": "d2a1a094e396da8957e797489fddaf860c340cfc"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/psr7/zipball/21dc724a0583619cd1652f673303492272778051",
-                "reference": "21dc724a0583619cd1652f673303492272778051",
+                "url": "https://api.github.com/repos/guzzle/psr7/zipball/d2a1a094e396da8957e797489fddaf860c340cfc",
+                "reference": "d2a1a094e396da8957e797489fddaf860c340cfc",
                 "shasum": ""
             },
             "require": {
@@ -980,8 +981,9 @@
             },
             "require-dev": {
                 "bamarni/composer-bin-plugin": "^1.8.2",
-                "http-interop/http-factory-tests": "0.9.0",
-                "phpunit/phpunit": "^8.5.44 || ^9.6.25"
+                "http-interop/http-factory-tests": "1.1.0",
+                "jshttp/mime-db": "1.54.0.1",
+                "phpunit/phpunit": "^8.5.52 || ^9.6.34"
             },
             "suggest": {
                 "laminas/laminas-httphandlerrunner": "Emit PSR-7 responses"
@@ -1052,7 +1054,7 @@
             ],
             "support": {
                 "issues": "https://github.com/guzzle/psr7/issues",
-                "source": "https://github.com/guzzle/psr7/tree/2.8.0"
+                "source": "https://github.com/guzzle/psr7/tree/2.10.4"
             },
             "funding": [
                 {
@@ -1068,20 +1070,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-08-23T21:21:41+00:00"
+            "time": "2026-05-29T12:59:07+00:00"
         },
         {
             "name": "guzzlehttp/uri-template",
-            "version": "v1.0.5",
+            "version": "v1.0.6",
             "source": {
                 "type": "git",
                 "url": "https://github.com/guzzle/uri-template.git",
-                "reference": "4f4bbd4e7172148801e76e3decc1e559bdee34e1"
+                "reference": "eef7f87bab6f204eba3c39224d8075c70c637946"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/uri-template/zipball/4f4bbd4e7172148801e76e3decc1e559bdee34e1",
-                "reference": "4f4bbd4e7172148801e76e3decc1e559bdee34e1",
+                "url": "https://api.github.com/repos/guzzle/uri-template/zipball/eef7f87bab6f204eba3c39224d8075c70c637946",
+                "reference": "eef7f87bab6f204eba3c39224d8075c70c637946",
                 "shasum": ""
             },
             "require": {
@@ -1090,7 +1092,7 @@
             },
             "require-dev": {
                 "bamarni/composer-bin-plugin": "^1.8.2",
-                "phpunit/phpunit": "^8.5.44 || ^9.6.25",
+                "phpunit/phpunit": "^8.5.52 || ^9.6.34",
                 "uri-template/tests": "1.0.0"
             },
             "type": "library",
@@ -1138,7 +1140,7 @@
             ],
             "support": {
                 "issues": "https://github.com/guzzle/uri-template/issues",
-                "source": "https://github.com/guzzle/uri-template/tree/v1.0.5"
+                "source": "https://github.com/guzzle/uri-template/tree/v1.0.6"
             },
             "funding": [
                 {
@@ -1154,28 +1156,94 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-08-22T14:27:06+00:00"
+            "time": "2026-05-23T22:00:21+00:00"
+        },
+        {
+            "name": "laravel/boost",
+            "version": "v2.4.8",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/laravel/boost.git",
+                "reference": "d11d720cf9537f8d236a11d973e99563a598ec9c"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/laravel/boost/zipball/d11d720cf9537f8d236a11d973e99563a598ec9c",
+                "reference": "d11d720cf9537f8d236a11d973e99563a598ec9c",
+                "shasum": ""
+            },
+            "require": {
+                "guzzlehttp/guzzle": "^7.9",
+                "illuminate/console": "^11.45.3|^12.41.1|^13.0",
+                "illuminate/contracts": "^11.45.3|^12.41.1|^13.0",
+                "illuminate/routing": "^11.45.3|^12.41.1|^13.0",
+                "illuminate/support": "^11.45.3|^12.41.1|^13.0",
+                "laravel/mcp": "^0.5.1|^0.6.0|~0.7.0,<0.7.1",
+                "laravel/prompts": "^0.3.10",
+                "laravel/roster": "^0.5.0",
+                "php": "^8.2"
+            },
+            "require-dev": {
+                "laravel/pint": "^1.27.0",
+                "mockery/mockery": "^1.6.12",
+                "orchestra/testbench": "^9.15.0|^10.6|^11.0",
+                "pestphp/pest": "^2.36.0|^3.8.4|^4.1.5",
+                "phpstan/phpstan": "^2.1.27",
+                "rector/rector": "^2.1"
+            },
+            "type": "library",
+            "extra": {
+                "laravel": {
+                    "providers": [
+                        "Laravel\\Boost\\BoostServiceProvider"
+                    ]
+                },
+                "branch-alias": {
+                    "dev-master": "1.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Laravel\\Boost\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "description": "Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, Laravel-specific code.",
+            "homepage": "https://github.com/laravel/boost",
+            "keywords": [
+                "ai",
+                "dev",
+                "laravel"
+            ],
+            "support": {
+                "issues": "https://github.com/laravel/boost/issues",
+                "source": "https://github.com/laravel/boost"
+            },
+            "time": "2026-05-19T20:09:50+00:00"
         },
         {
             "name": "laravel/framework",
-            "version": "v12.40.2",
+            "version": "v13.12.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/framework.git",
-                "reference": "1ccd99220b474500e672b373f32bd709ec38de50"
+                "reference": "6ac27a7fcfa728250c9f77921cb8fb955546b591"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/framework/zipball/1ccd99220b474500e672b373f32bd709ec38de50",
-                "reference": "1ccd99220b474500e672b373f32bd709ec38de50",
+                "url": "https://api.github.com/repos/laravel/framework/zipball/6ac27a7fcfa728250c9f77921cb8fb955546b591",
+                "reference": "6ac27a7fcfa728250c9f77921cb8fb955546b591",
                 "shasum": ""
             },
             "require": {
-                "brick/math": "^0.11|^0.12|^0.13|^0.14",
+                "brick/math": "^0.14.2 || ^0.15 || ^0.16 || ^0.17",
                 "composer-runtime-api": "^2.2",
                 "doctrine/inflector": "^2.0.5",
                 "dragonmantank/cron-expression": "^3.4",
-                "egulias/email-validator": "^3.2.1|^4.0",
+                "egulias/email-validator": "^4.0",
                 "ext-ctype": "*",
                 "ext-filter": "*",
                 "ext-hash": "*",
@@ -1185,35 +1253,36 @@
                 "ext-tokenizer": "*",
                 "fruitcake/php-cors": "^1.3",
                 "guzzlehttp/guzzle": "^7.8.2",
+                "guzzlehttp/promises": "^2.0.3",
                 "guzzlehttp/uri-template": "^1.0",
                 "laravel/prompts": "^0.3.0",
-                "laravel/serializable-closure": "^1.3|^2.0",
-                "league/commonmark": "^2.7",
+                "laravel/serializable-closure": "^2.0.10",
+                "league/commonmark": "^2.8.1",
                 "league/flysystem": "^3.25.1",
                 "league/flysystem-local": "^3.25.1",
                 "league/uri": "^7.5.1",
                 "monolog/monolog": "^3.0",
                 "nesbot/carbon": "^3.8.4",
                 "nunomaduro/termwind": "^2.0",
-                "php": "^8.2",
-                "psr/container": "^1.1.1|^2.0.1",
-                "psr/log": "^1.0|^2.0|^3.0",
-                "psr/simple-cache": "^1.0|^2.0|^3.0",
+                "php": "^8.3",
+                "psr/container": "^1.1.1 || ^2.0.1",
+                "psr/log": "^1.0 || ^2.0 || ^3.0",
+                "psr/simple-cache": "^1.0 || ^2.0 || ^3.0",
                 "ramsey/uuid": "^4.7",
-                "symfony/console": "^7.2.0",
-                "symfony/error-handler": "^7.2.0",
-                "symfony/finder": "^7.2.0",
-                "symfony/http-foundation": "^7.2.0",
-                "symfony/http-kernel": "^7.2.0",
-                "symfony/mailer": "^7.2.0",
-                "symfony/mime": "^7.2.0",
-                "symfony/polyfill-php83": "^1.33",
-                "symfony/polyfill-php84": "^1.33",
-                "symfony/polyfill-php85": "^1.33",
-                "symfony/process": "^7.2.0",
-                "symfony/routing": "^7.2.0",
-                "symfony/uid": "^7.2.0",
-                "symfony/var-dumper": "^7.2.0",
+                "symfony/console": "^7.4.0 || ^8.0.0",
+                "symfony/error-handler": "^7.4.0 || ^8.0.0",
+                "symfony/finder": "^7.4.0 || ^8.0.0",
+                "symfony/http-foundation": "^7.4.0 || ^8.0.0",
+                "symfony/http-kernel": "^7.4.0 || ^8.0.0",
+                "symfony/mailer": "^7.4.0 || ^8.0.0",
+                "symfony/mime": "^7.4.0 || ^8.0.0",
+                "symfony/polyfill-php84": "^1.36",
+                "symfony/polyfill-php85": "^1.36",
+                "symfony/polyfill-php86": "^1.36",
+                "symfony/process": "^7.4.5 || ^8.0.5",
+                "symfony/routing": "^7.4.0 || ^8.0.0",
+                "symfony/uid": "^7.4.0 || ^8.0.0",
+                "symfony/var-dumper": "^7.4.0 || ^8.0.0",
                 "tijsverkoyen/css-to-inline-styles": "^2.2.5",
                 "vlucas/phpdotenv": "^5.6.1",
                 "voku/portable-ascii": "^2.0.2"
@@ -1222,9 +1291,9 @@
                 "tightenco/collect": "<5.5.33"
             },
             "provide": {
-                "psr/container-implementation": "1.1|2.0",
-                "psr/log-implementation": "1.0|2.0|3.0",
-                "psr/simple-cache-implementation": "1.0|2.0|3.0"
+                "psr/container-implementation": "1.1 || 2.0",
+                "psr/log-implementation": "1.0 || 2.0 || 3.0",
+                "psr/simple-cache-implementation": "1.0 || 2.0 || 3.0"
             },
             "replace": {
                 "illuminate/auth": "self.version",
@@ -1255,6 +1324,7 @@
                 "illuminate/process": "self.version",
                 "illuminate/queue": "self.version",
                 "illuminate/redis": "self.version",
+                "illuminate/reflection": "self.version",
                 "illuminate/routing": "self.version",
                 "illuminate/session": "self.version",
                 "illuminate/support": "self.version",
@@ -1269,8 +1339,7 @@
                 "aws/aws-sdk-php": "^3.322.9",
                 "ext-gmp": "*",
                 "fakerphp/faker": "^1.24",
-                "guzzlehttp/promises": "^2.0.3",
-                "guzzlehttp/psr7": "^2.4",
+                "guzzlehttp/psr7": "^2.9",
                 "laravel/pint": "^1.18",
                 "league/flysystem-aws-s3-v3": "^3.25.1",
                 "league/flysystem-ftp": "^3.25.1",
@@ -1279,22 +1348,23 @@
                 "league/flysystem-sftp-v3": "^3.25.1",
                 "mockery/mockery": "^1.6.10",
                 "opis/json-schema": "^2.4.1",
-                "orchestra/testbench-core": "^10.8.0",
-                "pda/pheanstalk": "^5.0.6|^7.0.0",
+                "orchestra/testbench-core": "^11.0.0",
+                "pda/pheanstalk": "^7.0.0 || ^8.0.0",
                 "php-http/discovery": "^1.15",
                 "phpstan/phpstan": "^2.0",
-                "phpunit/phpunit": "^10.5.35|^11.5.3|^12.0.1",
-                "predis/predis": "^2.3|^3.0",
-                "resend/resend-php": "^0.10.0|^1.0",
-                "symfony/cache": "^7.2.0",
-                "symfony/http-client": "^7.2.0",
-                "symfony/psr-http-message-bridge": "^7.2.0",
-                "symfony/translation": "^7.2.0"
+                "phpunit/phpunit": "^11.5.50 || ^12.5.8 || ^13.0.3",
+                "predis/predis": "^2.3 || ^3.0",
+                "rector/rector": "^2.3",
+                "resend/resend-php": "^1.0",
+                "symfony/cache": "^7.4.0 || ^8.0.0",
+                "symfony/http-client": "^7.4.0 || ^8.0.0",
+                "symfony/psr-http-message-bridge": "^7.4.0 || ^8.0.0",
+                "symfony/translation": "^7.4.0 || ^8.0.0"
             },
             "suggest": {
                 "ably/ably-php": "Required to use the Ably broadcast driver (^1.0).",
                 "aws/aws-sdk-php": "Required to use the SQS queue driver, DynamoDb failed job storage, and SES mail driver (^3.322.9).",
-                "brianium/paratest": "Required to run tests in parallel (^7.0|^8.0).",
+                "brianium/paratest": "Required to run tests in parallel (^7.0 || ^8.0).",
                 "ext-apcu": "Required to use the APC cache driver.",
                 "ext-fileinfo": "Required to use the Filesystem class.",
                 "ext-ftp": "Required to use the Flysystem FTP driver.",
@@ -1303,7 +1373,7 @@
                 "ext-pcntl": "Required to use all features of the queue worker and console signal trapping.",
                 "ext-pdo": "Required to use all database features.",
                 "ext-posix": "Required to use all features of the queue worker.",
-                "ext-redis": "Required to use the Redis cache and queue drivers (^4.0|^5.0|^6.0).",
+                "ext-redis": "Required to use the Redis cache and queue drivers (^4.0 || ^5.0 || ^6.0).",
                 "fakerphp/faker": "Required to generate fake data using the fake() helper (^1.23).",
                 "filp/whoops": "Required for friendly error pages in development (^2.14.3).",
                 "laravel/tinker": "Required to use the tinker console command (^2.0).",
@@ -1313,24 +1383,25 @@
                 "league/flysystem-read-only": "Required to use read-only disks (^3.25.1)",
                 "league/flysystem-sftp-v3": "Required to use the Flysystem SFTP driver (^3.25.1).",
                 "mockery/mockery": "Required to use mocking (^1.6).",
-                "pda/pheanstalk": "Required to use the beanstalk queue driver (^5.0).",
+                "pda/pheanstalk": "Required to use the beanstalk queue driver (^7.0 || ^8.0).",
                 "php-http/discovery": "Required to use PSR-7 bridging features (^1.15).",
-                "phpunit/phpunit": "Required to use assertions and run tests (^10.5.35|^11.5.3|^12.0.1).",
-                "predis/predis": "Required to use the predis connector (^2.3|^3.0).",
+                "phpunit/phpunit": "Required to use assertions and run tests (^11.5.50 || ^12.5.8 || ^13.0.3).",
+                "predis/predis": "Required to use the predis connector (^2.3 || ^3.0).",
                 "psr/http-message": "Required to allow Storage::put to accept a StreamInterface (^1.0).",
-                "pusher/pusher-php-server": "Required to use the Pusher broadcast driver (^6.0|^7.0).",
-                "resend/resend-php": "Required to enable support for the Resend mail transport (^0.10.0|^1.0).",
-                "symfony/cache": "Required to PSR-6 cache bridge (^7.2).",
-                "symfony/filesystem": "Required to enable support for relative symbolic links (^7.2).",
-                "symfony/http-client": "Required to enable support for the Symfony API mail transports (^7.2).",
-                "symfony/mailgun-mailer": "Required to enable support for the Mailgun mail transport (^7.2).",
-                "symfony/postmark-mailer": "Required to enable support for the Postmark mail transport (^7.2).",
-                "symfony/psr-http-message-bridge": "Required to use PSR-7 bridging features (^7.2)."
+                "pusher/pusher-php-server": "Required to use the Pusher broadcast driver (^6.0 || ^7.0).",
+                "resend/resend-php": "Required to enable support for the Resend mail transport (^0.10.0 || ^1.0).",
+                "spatie/fork": "Required to use the 'fork' concurrency driver (^1.2).",
+                "symfony/cache": "Required to PSR-6 cache bridge (^7.4 || ^8.0).",
+                "symfony/filesystem": "Required to enable support for relative symbolic links (^7.4 || ^8.0).",
+                "symfony/http-client": "Required to enable support for the Symfony API mail transports (^7.4 || ^8.0).",
+                "symfony/mailgun-mailer": "Required to enable support for the Mailgun mail transport (^7.4 || ^8.0).",
+                "symfony/postmark-mailer": "Required to enable support for the Postmark mail transport (^7.4 || ^8.0).",
+                "symfony/psr-http-message-bridge": "Required to use PSR-7 bridging features (^7.4 || ^8.0)."
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "12.x-dev"
+                    "dev-master": "13.0.x-dev"
                 }
             },
             "autoload": {
@@ -1341,6 +1412,7 @@
                     "src/Illuminate/Filesystem/functions.php",
                     "src/Illuminate/Foundation/helpers.php",
                     "src/Illuminate/Log/functions.php",
+                    "src/Illuminate/Reflection/helpers.php",
                     "src/Illuminate/Support/functions.php",
                     "src/Illuminate/Support/helpers.php"
                 ],
@@ -1349,7 +1421,8 @@
                     "Illuminate\\Support\\": [
                         "src/Illuminate/Macroable/",
                         "src/Illuminate/Collections/",
-                        "src/Illuminate/Conditionable/"
+                        "src/Illuminate/Conditionable/",
+                        "src/Illuminate/Reflection/"
                     ]
                 }
             },
@@ -1373,34 +1446,107 @@
                 "issues": "https://github.com/laravel/framework/issues",
                 "source": "https://github.com/laravel/framework"
             },
-            "time": "2025-11-26T19:24:25+00:00"
+            "time": "2026-05-26T23:39:26+00:00"
+        },
+        {
+            "name": "laravel/mcp",
+            "version": "v0.7.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/laravel/mcp.git",
+                "reference": "3513b4feca5f1678be4d2261dcfa8e456436d02a"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/laravel/mcp/zipball/3513b4feca5f1678be4d2261dcfa8e456436d02a",
+                "reference": "3513b4feca5f1678be4d2261dcfa8e456436d02a",
+                "shasum": ""
+            },
+            "require": {
+                "ext-json": "*",
+                "ext-mbstring": "*",
+                "illuminate/console": "^11.45.3|^12.41.1|^13.0",
+                "illuminate/container": "^11.45.3|^12.41.1|^13.0",
+                "illuminate/contracts": "^11.45.3|^12.41.1|^13.0",
+                "illuminate/http": "^11.45.3|^12.41.1|^13.0",
+                "illuminate/json-schema": "^12.41.1|^13.0",
+                "illuminate/routing": "^11.45.3|^12.41.1|^13.0",
+                "illuminate/support": "^11.45.3|^12.41.1|^13.0",
+                "illuminate/validation": "^11.45.3|^12.41.1|^13.0",
+                "php": "^8.2"
+            },
+            "require-dev": {
+                "laravel/pint": "^1.20",
+                "orchestra/testbench": "^9.15|^10.8|^11.0",
+                "pestphp/pest": "^3.8.5|^4.3.2",
+                "phpstan/phpstan": "^2.1.27",
+                "rector/rector": "^2.2.4"
+            },
+            "type": "library",
+            "extra": {
+                "laravel": {
+                    "aliases": {
+                        "Mcp": "Laravel\\Mcp\\Server\\Facades\\Mcp"
+                    },
+                    "providers": [
+                        "Laravel\\Mcp\\Server\\McpServiceProvider"
+                    ]
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Laravel\\Mcp\\": "src/",
+                    "Laravel\\Mcp\\Server\\": "src/Server/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Taylor Otwell",
+                    "email": "taylor@laravel.com"
+                }
+            ],
+            "description": "Rapidly build MCP servers for your Laravel applications.",
+            "homepage": "https://github.com/laravel/mcp",
+            "keywords": [
+                "laravel",
+                "mcp"
+            ],
+            "support": {
+                "issues": "https://github.com/laravel/mcp/issues",
+                "source": "https://github.com/laravel/mcp"
+            },
+            "time": "2026-04-21T10:23:03+00:00"
         },
         {
             "name": "laravel/prompts",
-            "version": "v0.3.8",
+            "version": "v0.3.18",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/prompts.git",
-                "reference": "096748cdfb81988f60090bbb839ce3205ace0d35"
+                "reference": "a19af51bb144bf87f08397921fa619f85c7d4e72"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/prompts/zipball/096748cdfb81988f60090bbb839ce3205ace0d35",
-                "reference": "096748cdfb81988f60090bbb839ce3205ace0d35",
+                "url": "https://api.github.com/repos/laravel/prompts/zipball/a19af51bb144bf87f08397921fa619f85c7d4e72",
+                "reference": "a19af51bb144bf87f08397921fa619f85c7d4e72",
                 "shasum": ""
             },
             "require": {
                 "composer-runtime-api": "^2.2",
                 "ext-mbstring": "*",
                 "php": "^8.1",
-                "symfony/console": "^6.2|^7.0"
+                "symfony/console": "^6.2|^7.0|^8.0"
             },
             "conflict": {
                 "illuminate/console": ">=10.17.0 <10.25.0",
                 "laravel/framework": ">=10.17.0 <10.25.0"
             },
             "require-dev": {
-                "illuminate/collections": "^10.0|^11.0|^12.0",
+                "illuminate/collections": "^10.0|^11.0|^12.0|^13.0",
                 "mockery/mockery": "^1.5",
                 "pestphp/pest": "^2.3|^3.4|^4.0",
                 "phpstan/phpstan": "^1.12.28",
@@ -1430,44 +1576,45 @@
             "description": "Add beautiful and user-friendly forms to your command-line applications.",
             "support": {
                 "issues": "https://github.com/laravel/prompts/issues",
-                "source": "https://github.com/laravel/prompts/tree/v0.3.8"
+                "source": "https://github.com/laravel/prompts/tree/v0.3.18"
             },
-            "time": "2025-11-21T20:52:52+00:00"
+            "time": "2026-05-19T00:47:18+00:00"
         },
         {
             "name": "laravel/pulse",
-            "version": "v1.4.4",
+            "version": "v1.7.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/pulse.git",
-                "reference": "4a39a82087c045a2e827f9ecb0e9a510d1d00dca"
+                "reference": "dfd3b8e98cd1ada8d105e528da0afe1bbfe7d990"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/pulse/zipball/4a39a82087c045a2e827f9ecb0e9a510d1d00dca",
-                "reference": "4a39a82087c045a2e827f9ecb0e9a510d1d00dca",
+                "url": "https://api.github.com/repos/laravel/pulse/zipball/dfd3b8e98cd1ada8d105e528da0afe1bbfe7d990",
+                "reference": "dfd3b8e98cd1ada8d105e528da0afe1bbfe7d990",
                 "shasum": ""
             },
             "require": {
                 "doctrine/sql-formatter": "^1.4.1",
                 "guzzlehttp/promises": "^1.0|^2.0",
-                "illuminate/auth": "^10.48.4|^11.0.8|^12.0",
-                "illuminate/cache": "^10.48.4|^11.0.8|^12.0",
-                "illuminate/config": "^10.48.4|^11.0.8|^12.0",
-                "illuminate/console": "^10.48.4|^11.0.8|^12.0",
-                "illuminate/contracts": "^10.48.4|^11.0.8|^12.0",
-                "illuminate/database": "^10.48.4|^11.0.8|^12.0",
-                "illuminate/events": "^10.48.4|^11.0.8|^12.0",
-                "illuminate/http": "^10.48.4|^11.0.8|^12.0",
-                "illuminate/queue": "^10.48.4|^11.0.8|^12.0",
-                "illuminate/redis": "^10.48.4|^11.0.8|^12.0",
-                "illuminate/routing": "^10.48.4|^11.0.8|^12.0",
-                "illuminate/support": "^10.48.4|^11.0.8|^12.0",
-                "illuminate/view": "^10.48.4|^11.0.8|^12.0",
-                "livewire/livewire": "^3.6.4",
+                "illuminate/auth": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "illuminate/cache": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "illuminate/config": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "illuminate/console": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "illuminate/contracts": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "illuminate/database": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "illuminate/events": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "illuminate/http": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "illuminate/queue": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "illuminate/redis": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "illuminate/routing": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "illuminate/support": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "illuminate/view": "^10.48.4|^11.0.8|^12.0|^13.0",
+                "laravel/sentinel": "^1.0",
+                "livewire/livewire": "^3.6.4|^4.0",
                 "nesbot/carbon": "^2.67|^3.0",
                 "php": "^8.1",
-                "symfony/console": "^6.0|^7.0"
+                "symfony/console": "^6.0|^7.0|^8.0"
             },
             "conflict": {
                 "nunomaduro/collision": "<7.7.0"
@@ -1475,9 +1622,9 @@
             "require-dev": {
                 "guzzlehttp/guzzle": "^7.7",
                 "mockery/mockery": "^1.0",
-                "orchestra/testbench": "^8.36|^9.15|^10.8",
+                "orchestra/testbench": "^8.36|^9.15|^10.8|^11.0",
                 "pestphp/pest": "^2.0|^3.0|^4.0",
-                "pestphp/pest-plugin-laravel": "^2.2",
+                "pestphp/pest-plugin-laravel": "^2.2|^3.0|^4.0",
                 "phpstan/phpstan": "^1.12.21",
                 "predis/predis": "^1.0|^2.0"
             },
@@ -1519,31 +1666,148 @@
                 "issues": "https://github.com/laravel/pulse/issues",
                 "source": "https://github.com/laravel/pulse"
             },
-            "time": "2025-11-24T14:05:55+00:00"
+            "time": "2026-03-26T14:27:31+00:00"
+        },
+        {
+            "name": "laravel/roster",
+            "version": "v0.5.1",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/laravel/roster.git",
+                "reference": "5089de7615f72f78e831590ff9d0435fed0102bb"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/laravel/roster/zipball/5089de7615f72f78e831590ff9d0435fed0102bb",
+                "reference": "5089de7615f72f78e831590ff9d0435fed0102bb",
+                "shasum": ""
+            },
+            "require": {
+                "illuminate/console": "^11.0|^12.0|^13.0",
+                "illuminate/contracts": "^11.0|^12.0|^13.0",
+                "illuminate/routing": "^11.0|^12.0|^13.0",
+                "illuminate/support": "^11.0|^12.0|^13.0",
+                "php": "^8.2",
+                "symfony/yaml": "^7.2|^8.0"
+            },
+            "require-dev": {
+                "laravel/pint": "^1.14",
+                "mockery/mockery": "^1.6",
+                "orchestra/testbench": "^9.0|^10.0|^11.0",
+                "pestphp/pest": "^3.0|^4.1",
+                "phpstan/phpstan": "^2.0"
+            },
+            "type": "library",
+            "extra": {
+                "laravel": {
+                    "providers": [
+                        "Laravel\\Roster\\RosterServiceProvider"
+                    ]
+                },
+                "branch-alias": {
+                    "dev-master": "1.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Laravel\\Roster\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "description": "Detect packages & approaches in use within a Laravel project",
+            "homepage": "https://github.com/laravel/roster",
+            "keywords": [
+                "dev",
+                "laravel"
+            ],
+            "support": {
+                "issues": "https://github.com/laravel/roster/issues",
+                "source": "https://github.com/laravel/roster"
+            },
+            "time": "2026-03-05T07:58:43+00:00"
+        },
+        {
+            "name": "laravel/sentinel",
+            "version": "v1.1.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/laravel/sentinel.git",
+                "reference": "972d9885d9d14312a118e9565c4e6ecc5e751ea1"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/laravel/sentinel/zipball/972d9885d9d14312a118e9565c4e6ecc5e751ea1",
+                "reference": "972d9885d9d14312a118e9565c4e6ecc5e751ea1",
+                "shasum": ""
+            },
+            "require": {
+                "ext-json": "*",
+                "illuminate/container": "^8.37|^9.0|^10.0|^11.0|^12.0|^13.0",
+                "php": "^8.0"
+            },
+            "require-dev": {
+                "laravel/pint": "^1.27",
+                "orchestra/testbench": "^6.47.1|^7.56|^8.37|^9.16|^10.9|^11.0",
+                "phpstan/phpstan": "^2.1.33"
+            },
+            "type": "library",
+            "extra": {
+                "laravel": {
+                    "providers": [
+                        "Laravel\\Sentinel\\SentinelServiceProvider"
+                    ]
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Laravel\\Sentinel\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Taylor Otwell",
+                    "email": "taylor@laravel.com"
+                },
+                {
+                    "name": "Mior Muhammad Zaki",
+                    "email": "mior@laravel.com"
+                }
+            ],
+            "support": {
+                "source": "https://github.com/laravel/sentinel/tree/v1.1.0"
+            },
+            "time": "2026-03-24T14:03:38+00:00"
         },
         {
             "name": "laravel/serializable-closure",
-            "version": "v2.0.7",
+            "version": "v2.0.13",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/serializable-closure.git",
-                "reference": "cb291e4c998ac50637c7eeb58189c14f5de5b9dd"
+                "reference": "b566ee0dd251f3c4078bed003a7ce015f5ea6dce"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/serializable-closure/zipball/cb291e4c998ac50637c7eeb58189c14f5de5b9dd",
-                "reference": "cb291e4c998ac50637c7eeb58189c14f5de5b9dd",
+                "url": "https://api.github.com/repos/laravel/serializable-closure/zipball/b566ee0dd251f3c4078bed003a7ce015f5ea6dce",
+                "reference": "b566ee0dd251f3c4078bed003a7ce015f5ea6dce",
                 "shasum": ""
             },
             "require": {
                 "php": "^8.1"
             },
             "require-dev": {
-                "illuminate/support": "^10.0|^11.0|^12.0",
+                "illuminate/support": "^10.0|^11.0|^12.0|^13.0",
                 "nesbot/carbon": "^2.67|^3.0",
                 "pestphp/pest": "^2.36|^3.0|^4.0",
                 "phpstan/phpstan": "^2.0",
-                "symfony/var-dumper": "^6.2.0|^7.0.0"
+                "symfony/var-dumper": "^6.2.0|^7.0.0|^8.0.0"
             },
             "type": "library",
             "extra": {
@@ -1580,37 +1844,37 @@
                 "issues": "https://github.com/laravel/serializable-closure/issues",
                 "source": "https://github.com/laravel/serializable-closure"
             },
-            "time": "2025-11-21T20:52:36+00:00"
+            "time": "2026-04-16T14:03:50+00:00"
         },
         {
             "name": "laravel/tinker",
-            "version": "v2.10.1",
+            "version": "v3.0.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/tinker.git",
-                "reference": "22177cc71807d38f2810c6204d8f7183d88a57d3"
+                "reference": "4faba77764bd33411735936acdf30446d058c78b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/tinker/zipball/22177cc71807d38f2810c6204d8f7183d88a57d3",
-                "reference": "22177cc71807d38f2810c6204d8f7183d88a57d3",
+                "url": "https://api.github.com/repos/laravel/tinker/zipball/4faba77764bd33411735936acdf30446d058c78b",
+                "reference": "4faba77764bd33411735936acdf30446d058c78b",
                 "shasum": ""
             },
             "require": {
-                "illuminate/console": "^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0",
-                "illuminate/contracts": "^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0",
-                "illuminate/support": "^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0",
-                "php": "^7.2.5|^8.0",
-                "psy/psysh": "^0.11.1|^0.12.0",
-                "symfony/var-dumper": "^4.3.4|^5.0|^6.0|^7.0"
+                "illuminate/console": "^8.0|^9.0|^10.0|^11.0|^12.0|^13.0",
+                "illuminate/contracts": "^8.0|^9.0|^10.0|^11.0|^12.0|^13.0",
+                "illuminate/support": "^8.0|^9.0|^10.0|^11.0|^12.0|^13.0",
+                "php": "^8.1",
+                "psy/psysh": "^0.12.0",
+                "symfony/var-dumper": "^5.4|^6.0|^7.0|^8.0"
             },
             "require-dev": {
                 "mockery/mockery": "~1.3.3|^1.4.2",
                 "phpstan/phpstan": "^1.10",
-                "phpunit/phpunit": "^8.5.8|^9.3.3|^10.0"
+                "phpunit/phpunit": "^10.5|^11.5"
             },
             "suggest": {
-                "illuminate/database": "The Illuminate Database package (^6.0|^7.0|^8.0|^9.0|^10.0|^11.0|^12.0)."
+                "illuminate/database": "The Illuminate Database package (^8.0|^9.0|^10.0|^11.0|^12.0|^13.0)."
             },
             "type": "library",
             "extra": {
@@ -1618,6 +1882,9 @@
                     "providers": [
                         "Laravel\\Tinker\\TinkerServiceProvider"
                     ]
+                },
+                "branch-alias": {
+                    "dev-master": "3.x-dev"
                 }
             },
             "autoload": {
@@ -1644,22 +1911,22 @@
             ],
             "support": {
                 "issues": "https://github.com/laravel/tinker/issues",
-                "source": "https://github.com/laravel/tinker/tree/v2.10.1"
+                "source": "https://github.com/laravel/tinker/tree/v3.0.2"
             },
-            "time": "2025-01-27T14:24:01+00:00"
+            "time": "2026-03-17T14:54:13+00:00"
         },
         {
             "name": "league/commonmark",
-            "version": "2.8.0",
+            "version": "2.8.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/thephpleague/commonmark.git",
-                "reference": "4efa10c1e56488e658d10adf7b7b7dcd19940bfb"
+                "reference": "59fb075d2101740c337c7216e3f32b36c204218b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/thephpleague/commonmark/zipball/4efa10c1e56488e658d10adf7b7b7dcd19940bfb",
-                "reference": "4efa10c1e56488e658d10adf7b7b7dcd19940bfb",
+                "url": "https://api.github.com/repos/thephpleague/commonmark/zipball/59fb075d2101740c337c7216e3f32b36c204218b",
+                "reference": "59fb075d2101740c337c7216e3f32b36c204218b",
                 "shasum": ""
             },
             "require": {
@@ -1684,9 +1951,9 @@
                 "phpstan/phpstan": "^1.8.2",
                 "phpunit/phpunit": "^9.5.21 || ^10.5.9 || ^11.0.0",
                 "scrutinizer/ocular": "^1.8.1",
-                "symfony/finder": "^5.3 | ^6.0 | ^7.0",
-                "symfony/process": "^5.4 | ^6.0 | ^7.0",
-                "symfony/yaml": "^2.3 | ^3.0 | ^4.0 | ^5.0 | ^6.0 | ^7.0",
+                "symfony/finder": "^5.3 | ^6.0 | ^7.0 || ^8.0",
+                "symfony/process": "^5.4 | ^6.0 | ^7.0 || ^8.0",
+                "symfony/yaml": "^2.3 | ^3.0 | ^4.0 | ^5.0 | ^6.0 | ^7.0 || ^8.0",
                 "unleashedtech/php-coding-standard": "^3.1.1",
                 "vimeo/psalm": "^4.24.0 || ^5.0.0 || ^6.0.0"
             },
@@ -1753,7 +2020,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-11-26T21:48:24+00:00"
+            "time": "2026-03-19T13:16:38+00:00"
         },
         {
             "name": "league/config",
@@ -1839,16 +2106,16 @@
         },
         {
             "name": "league/flysystem",
-            "version": "3.30.2",
+            "version": "3.34.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/thephpleague/flysystem.git",
-                "reference": "5966a8ba23e62bdb518dd9e0e665c2dbd4b5b277"
+                "reference": "2daaac3b0d4c83ea7ed5d8586e786f5d00f3540e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/thephpleague/flysystem/zipball/5966a8ba23e62bdb518dd9e0e665c2dbd4b5b277",
-                "reference": "5966a8ba23e62bdb518dd9e0e665c2dbd4b5b277",
+                "url": "https://api.github.com/repos/thephpleague/flysystem/zipball/2daaac3b0d4c83ea7ed5d8586e786f5d00f3540e",
+                "reference": "2daaac3b0d4c83ea7ed5d8586e786f5d00f3540e",
                 "shasum": ""
             },
             "require": {
@@ -1916,22 +2183,22 @@
             ],
             "support": {
                 "issues": "https://github.com/thephpleague/flysystem/issues",
-                "source": "https://github.com/thephpleague/flysystem/tree/3.30.2"
+                "source": "https://github.com/thephpleague/flysystem/tree/3.34.0"
             },
-            "time": "2025-11-10T17:13:11+00:00"
+            "time": "2026-05-14T10:28:08+00:00"
         },
         {
             "name": "league/flysystem-local",
-            "version": "3.30.2",
+            "version": "3.31.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/thephpleague/flysystem-local.git",
-                "reference": "ab4f9d0d672f601b102936aa728801dd1a11968d"
+                "reference": "2f669db18a4c20c755c2bb7d3a7b0b2340488079"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/thephpleague/flysystem-local/zipball/ab4f9d0d672f601b102936aa728801dd1a11968d",
-                "reference": "ab4f9d0d672f601b102936aa728801dd1a11968d",
+                "url": "https://api.github.com/repos/thephpleague/flysystem-local/zipball/2f669db18a4c20c755c2bb7d3a7b0b2340488079",
+                "reference": "2f669db18a4c20c755c2bb7d3a7b0b2340488079",
                 "shasum": ""
             },
             "require": {
@@ -1965,9 +2232,9 @@
                 "local"
             ],
             "support": {
-                "source": "https://github.com/thephpleague/flysystem-local/tree/3.30.2"
+                "source": "https://github.com/thephpleague/flysystem-local/tree/3.31.0"
             },
-            "time": "2025-11-10T11:23:37+00:00"
+            "time": "2026-01-23T15:30:45+00:00"
         },
         {
             "name": "league/mime-type-detection",
@@ -2027,20 +2294,20 @@
         },
         {
             "name": "league/uri",
-            "version": "7.6.0",
+            "version": "7.8.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/thephpleague/uri.git",
-                "reference": "f625804987a0a9112d954f9209d91fec52182344"
+                "reference": "08cf38e3924d4f56238125547b5720496fac8fd4"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/thephpleague/uri/zipball/f625804987a0a9112d954f9209d91fec52182344",
-                "reference": "f625804987a0a9112d954f9209d91fec52182344",
+                "url": "https://api.github.com/repos/thephpleague/uri/zipball/08cf38e3924d4f56238125547b5720496fac8fd4",
+                "reference": "08cf38e3924d4f56238125547b5720496fac8fd4",
                 "shasum": ""
             },
             "require": {
-                "league/uri-interfaces": "^7.6",
+                "league/uri-interfaces": "^7.8.1",
                 "php": "^8.1",
                 "psr/http-factory": "^1"
             },
@@ -2054,11 +2321,11 @@
                 "ext-gmp": "to improve IPV4 host parsing",
                 "ext-intl": "to handle IDN host with the best performance",
                 "ext-uri": "to use the PHP native URI class",
-                "jeremykendall/php-domain-parser": "to resolve Public Suffix and Top Level Domain",
-                "league/uri-components": "Needed to easily manipulate URI objects components",
-                "league/uri-polyfill": "Needed to backport the PHP URI extension for older versions of PHP",
+                "jeremykendall/php-domain-parser": "to further parse the URI host and resolve its Public Suffix and Top Level Domain",
+                "league/uri-components": "to provide additional tools to manipulate URI objects components",
+                "league/uri-polyfill": "to backport the PHP URI extension for older versions of PHP",
                 "php-64bit": "to improve IPV4 host parsing",
-                "rowbot/url": "to handle WHATWG URL",
+                "rowbot/url": "to handle URLs using the WHATWG URL Living Standard specification",
                 "symfony/polyfill-intl-idn": "to handle IDN host via the Symfony polyfill if ext-intl is not present"
             },
             "type": "library",
@@ -2113,7 +2380,7 @@
                 "docs": "https://uri.thephpleague.com",
                 "forum": "https://thephpleague.slack.com",
                 "issues": "https://github.com/thephpleague/uri-src/issues",
-                "source": "https://github.com/thephpleague/uri/tree/7.6.0"
+                "source": "https://github.com/thephpleague/uri/tree/7.8.1"
             },
             "funding": [
                 {
@@ -2121,20 +2388,20 @@
                     "type": "github"
                 }
             ],
-            "time": "2025-11-18T12:17:23+00:00"
+            "time": "2026-03-15T20:22:25+00:00"
         },
         {
             "name": "league/uri-interfaces",
-            "version": "7.6.0",
+            "version": "7.8.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/thephpleague/uri-interfaces.git",
-                "reference": "ccbfb51c0445298e7e0b7f4481b942f589665368"
+                "reference": "85d5c77c5d6d3af6c54db4a78246364908f3c928"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/thephpleague/uri-interfaces/zipball/ccbfb51c0445298e7e0b7f4481b942f589665368",
-                "reference": "ccbfb51c0445298e7e0b7f4481b942f589665368",
+                "url": "https://api.github.com/repos/thephpleague/uri-interfaces/zipball/85d5c77c5d6d3af6c54db4a78246364908f3c928",
+                "reference": "85d5c77c5d6d3af6c54db4a78246364908f3c928",
                 "shasum": ""
             },
             "require": {
@@ -2147,7 +2414,7 @@
                 "ext-gmp": "to improve IPV4 host parsing",
                 "ext-intl": "to handle IDN host with the best performance",
                 "php-64bit": "to improve IPV4 host parsing",
-                "rowbot/url": "to handle WHATWG URL",
+                "rowbot/url": "to handle URLs using the WHATWG URL Living Standard specification",
                 "symfony/polyfill-intl-idn": "to handle IDN host via the Symfony polyfill if ext-intl is not present"
             },
             "type": "library",
@@ -2197,7 +2464,7 @@
                 "docs": "https://uri.thephpleague.com",
                 "forum": "https://thephpleague.slack.com",
                 "issues": "https://github.com/thephpleague/uri-src/issues",
-                "source": "https://github.com/thephpleague/uri-interfaces/tree/7.6.0"
+                "source": "https://github.com/thephpleague/uri-interfaces/tree/7.8.1"
             },
             "funding": [
                 {
@@ -2205,40 +2472,40 @@
                     "type": "github"
                 }
             ],
-            "time": "2025-11-18T12:17:23+00:00"
+            "time": "2026-03-08T20:05:35+00:00"
         },
         {
             "name": "livewire/livewire",
-            "version": "v3.7.0",
+            "version": "v4.3.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/livewire/livewire.git",
-                "reference": "f5f9efe6d5a7059116bd695a89d95ceedf33f3cb"
+                "reference": "19ebb1ee4d057debceccf70ff01950e6a6114edc"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/livewire/livewire/zipball/f5f9efe6d5a7059116bd695a89d95ceedf33f3cb",
-                "reference": "f5f9efe6d5a7059116bd695a89d95ceedf33f3cb",
+                "url": "https://api.github.com/repos/livewire/livewire/zipball/19ebb1ee4d057debceccf70ff01950e6a6114edc",
+                "reference": "19ebb1ee4d057debceccf70ff01950e6a6114edc",
                 "shasum": ""
             },
             "require": {
-                "illuminate/database": "^10.0|^11.0|^12.0",
-                "illuminate/routing": "^10.0|^11.0|^12.0",
-                "illuminate/support": "^10.0|^11.0|^12.0",
-                "illuminate/validation": "^10.0|^11.0|^12.0",
+                "illuminate/database": "^10.0|^11.0|^12.0|^13.0",
+                "illuminate/routing": "^10.0|^11.0|^12.0|^13.0",
+                "illuminate/support": "^10.0|^11.0|^12.0|^13.0",
+                "illuminate/validation": "^10.0|^11.0|^12.0|^13.0",
                 "laravel/prompts": "^0.1.24|^0.2|^0.3",
                 "league/mime-type-detection": "^1.9",
                 "php": "^8.1",
-                "symfony/console": "^6.0|^7.0",
-                "symfony/http-kernel": "^6.2|^7.0"
+                "symfony/console": "^6.0|^7.0|^8.0",
+                "symfony/http-kernel": "^6.2|^7.0|^8.0"
             },
             "require-dev": {
                 "calebporzio/sushi": "^2.1",
-                "laravel/framework": "^10.15.0|^11.0|^12.0",
+                "laravel/framework": "^10.15.0|^11.0|^12.0|^13.0",
                 "mockery/mockery": "^1.3.1",
-                "orchestra/testbench": "^8.21.0|^9.0|^10.0",
-                "orchestra/testbench-dusk": "^8.24|^9.1|^10.0",
-                "phpunit/phpunit": "^10.4|^11.5",
+                "orchestra/testbench": "^8.21.0|^9.0|^10.0|^11.0",
+                "orchestra/testbench-dusk": "^8.24|^9.1|^10.0|^11.0",
+                "phpunit/phpunit": "^10.4|^11.5|^12.5",
                 "psy/psysh": "^0.11.22|^0.12"
             },
             "type": "library",
@@ -2273,7 +2540,7 @@
             "description": "A front-end framework for Laravel.",
             "support": {
                 "issues": "https://github.com/livewire/livewire/issues",
-                "source": "https://github.com/livewire/livewire/tree/v3.7.0"
+                "source": "https://github.com/livewire/livewire/tree/v4.3.0"
             },
             "funding": [
                 {
@@ -2281,20 +2548,20 @@
                     "type": "github"
                 }
             ],
-            "time": "2025-11-12T17:58:16+00:00"
+            "time": "2026-05-01T00:46:07+00:00"
         },
         {
             "name": "monolog/monolog",
-            "version": "3.9.0",
+            "version": "3.10.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/Seldaek/monolog.git",
-                "reference": "10d85740180ecba7896c87e06a166e0c95a0e3b6"
+                "reference": "b321dd6749f0bf7189444158a3ce785cc16d69b0"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/Seldaek/monolog/zipball/10d85740180ecba7896c87e06a166e0c95a0e3b6",
-                "reference": "10d85740180ecba7896c87e06a166e0c95a0e3b6",
+                "url": "https://api.github.com/repos/Seldaek/monolog/zipball/b321dd6749f0bf7189444158a3ce785cc16d69b0",
+                "reference": "b321dd6749f0bf7189444158a3ce785cc16d69b0",
                 "shasum": ""
             },
             "require": {
@@ -2312,7 +2579,7 @@
                 "graylog2/gelf-php": "^1.4.2 || ^2.0",
                 "guzzlehttp/guzzle": "^7.4.5",
                 "guzzlehttp/psr7": "^2.2",
-                "mongodb/mongodb": "^1.8",
+                "mongodb/mongodb": "^1.8 || ^2.0",
                 "php-amqplib/php-amqplib": "~2.4 || ^3",
                 "php-console/php-console": "^3.1.8",
                 "phpstan/phpstan": "^2",
@@ -2372,7 +2639,7 @@
             ],
             "support": {
                 "issues": "https://github.com/Seldaek/monolog/issues",
-                "source": "https://github.com/Seldaek/monolog/tree/3.9.0"
+                "source": "https://github.com/Seldaek/monolog/tree/3.10.0"
             },
             "funding": [
                 {
@@ -2384,20 +2651,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-03-24T10:02:05+00:00"
+            "time": "2026-01-02T08:56:05+00:00"
         },
         {
             "name": "nesbot/carbon",
-            "version": "3.10.3",
+            "version": "3.11.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/CarbonPHP/carbon.git",
-                "reference": "8e3643dcd149ae0fe1d2ff4f2c8e4bbfad7c165f"
+                "reference": "e890471a3494740f7d9326d72ce6a8c559ffee60"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/CarbonPHP/carbon/zipball/8e3643dcd149ae0fe1d2ff4f2c8e4bbfad7c165f",
-                "reference": "8e3643dcd149ae0fe1d2ff4f2c8e4bbfad7c165f",
+                "url": "https://api.github.com/repos/CarbonPHP/carbon/zipball/e890471a3494740f7d9326d72ce6a8c559ffee60",
+                "reference": "e890471a3494740f7d9326d72ce6a8c559ffee60",
                 "shasum": ""
             },
             "require": {
@@ -2405,9 +2672,9 @@
                 "ext-json": "*",
                 "php": "^8.1",
                 "psr/clock": "^1.0",
-                "symfony/clock": "^6.3.12 || ^7.0",
+                "symfony/clock": "^6.3.12 || ^7.0 || ^8.0",
                 "symfony/polyfill-mbstring": "^1.0",
-                "symfony/translation": "^4.4.18 || ^5.2.1 || ^6.0 || ^7.0"
+                "symfony/translation": "^4.4.18 || ^5.2.1 || ^6.0 || ^7.0 || ^8.0"
             },
             "provide": {
                 "psr/clock-implementation": "1.0"
@@ -2421,7 +2688,7 @@
                 "phpstan/extension-installer": "^1.4.3",
                 "phpstan/phpstan": "^2.1.22",
                 "phpunit/phpunit": "^10.5.53",
-                "squizlabs/php_codesniffer": "^3.13.4"
+                "squizlabs/php_codesniffer": "^3.13.4 || ^4.0.0"
             },
             "bin": [
                 "bin/carbon"
@@ -2464,14 +2731,14 @@
                 }
             ],
             "description": "An API extension for DateTime that supports 281 different languages.",
-            "homepage": "https://carbon.nesbot.com",
+            "homepage": "https://carbonphp.github.io/carbon/",
             "keywords": [
                 "date",
                 "datetime",
                 "time"
             ],
             "support": {
-                "docs": "https://carbon.nesbot.com/docs",
+                "docs": "https://carbonphp.github.io/carbon/guide/getting-started/introduction.html",
                 "issues": "https://github.com/CarbonPHP/carbon/issues",
                 "source": "https://github.com/CarbonPHP/carbon"
             },
@@ -2489,20 +2756,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-06T13:39:36+00:00"
+            "time": "2026-04-07T09:57:54+00:00"
         },
         {
             "name": "nette/schema",
-            "version": "v1.3.3",
+            "version": "v1.3.5",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nette/schema.git",
-                "reference": "2befc2f42d7c715fd9d95efc31b1081e5d765004"
+                "reference": "f0ab1a3cda782dbc5da270d28545236aa80c4002"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nette/schema/zipball/2befc2f42d7c715fd9d95efc31b1081e5d765004",
-                "reference": "2befc2f42d7c715fd9d95efc31b1081e5d765004",
+                "url": "https://api.github.com/repos/nette/schema/zipball/f0ab1a3cda782dbc5da270d28545236aa80c4002",
+                "reference": "f0ab1a3cda782dbc5da270d28545236aa80c4002",
                 "shasum": ""
             },
             "require": {
@@ -2510,8 +2777,10 @@
                 "php": "8.1 - 8.5"
             },
             "require-dev": {
-                "nette/tester": "^2.5.2",
-                "phpstan/phpstan-nette": "^2.0@stable",
+                "nette/phpstan-rules": "^1.0",
+                "nette/tester": "^2.6",
+                "phpstan/extension-installer": "^1.4@stable",
+                "phpstan/phpstan": "^2.1.39@stable",
                 "tracy/tracy": "^2.8"
             },
             "type": "library",
@@ -2552,26 +2821,26 @@
             ],
             "support": {
                 "issues": "https://github.com/nette/schema/issues",
-                "source": "https://github.com/nette/schema/tree/v1.3.3"
+                "source": "https://github.com/nette/schema/tree/v1.3.5"
             },
-            "time": "2025-10-30T22:57:59+00:00"
+            "time": "2026-02-23T03:47:12+00:00"
         },
         {
             "name": "nette/utils",
-            "version": "v4.0.9",
+            "version": "v4.1.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nette/utils.git",
-                "reference": "505a30ad386daa5211f08a318e47015b501cad30"
+                "reference": "7da6c396d7ebe142bc857c20479d5e70a5e1aac7"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nette/utils/zipball/505a30ad386daa5211f08a318e47015b501cad30",
-                "reference": "505a30ad386daa5211f08a318e47015b501cad30",
+                "url": "https://api.github.com/repos/nette/utils/zipball/7da6c396d7ebe142bc857c20479d5e70a5e1aac7",
+                "reference": "7da6c396d7ebe142bc857c20479d5e70a5e1aac7",
                 "shasum": ""
             },
             "require": {
-                "php": "8.0 - 8.5"
+                "php": "8.2 - 8.5"
             },
             "conflict": {
                 "nette/finder": "<3",
@@ -2579,8 +2848,10 @@
             },
             "require-dev": {
                 "jetbrains/phpstorm-attributes": "^1.2",
+                "nette/phpstan-rules": "^1.0",
                 "nette/tester": "^2.5",
-                "phpstan/phpstan-nette": "^2.0@stable",
+                "phpstan/extension-installer": "^1.4@stable",
+                "phpstan/phpstan": "^2.1@stable",
                 "tracy/tracy": "^2.9"
             },
             "suggest": {
@@ -2594,7 +2865,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "4.0-dev"
+                    "dev-master": "4.1-dev"
                 }
             },
             "autoload": {
@@ -2641,22 +2912,22 @@
             ],
             "support": {
                 "issues": "https://github.com/nette/utils/issues",
-                "source": "https://github.com/nette/utils/tree/v4.0.9"
+                "source": "https://github.com/nette/utils/tree/v4.1.4"
             },
-            "time": "2025-10-31T00:45:47+00:00"
+            "time": "2026-05-11T20:49:54+00:00"
         },
         {
             "name": "nikic/php-parser",
-            "version": "v5.6.2",
+            "version": "v5.7.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nikic/PHP-Parser.git",
-                "reference": "3a454ca033b9e06b63282ce19562e892747449bb"
+                "reference": "dca41cd15c2ac9d055ad70dbfd011130757d1f82"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/3a454ca033b9e06b63282ce19562e892747449bb",
-                "reference": "3a454ca033b9e06b63282ce19562e892747449bb",
+                "url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/dca41cd15c2ac9d055ad70dbfd011130757d1f82",
+                "reference": "dca41cd15c2ac9d055ad70dbfd011130757d1f82",
                 "shasum": ""
             },
             "require": {
@@ -2699,37 +2970,37 @@
             ],
             "support": {
                 "issues": "https://github.com/nikic/PHP-Parser/issues",
-                "source": "https://github.com/nikic/PHP-Parser/tree/v5.6.2"
+                "source": "https://github.com/nikic/PHP-Parser/tree/v5.7.0"
             },
-            "time": "2025-10-21T19:32:17+00:00"
+            "time": "2025-12-06T11:56:16+00:00"
         },
         {
             "name": "nunomaduro/termwind",
-            "version": "v2.3.3",
+            "version": "v2.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nunomaduro/termwind.git",
-                "reference": "6fb2a640ff502caace8e05fd7be3b503a7e1c017"
+                "reference": "712a31b768f5daea284c2169a7d227031001b9a8"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nunomaduro/termwind/zipball/6fb2a640ff502caace8e05fd7be3b503a7e1c017",
-                "reference": "6fb2a640ff502caace8e05fd7be3b503a7e1c017",
+                "url": "https://api.github.com/repos/nunomaduro/termwind/zipball/712a31b768f5daea284c2169a7d227031001b9a8",
+                "reference": "712a31b768f5daea284c2169a7d227031001b9a8",
                 "shasum": ""
             },
             "require": {
                 "ext-mbstring": "*",
                 "php": "^8.2",
-                "symfony/console": "^7.3.6"
+                "symfony/console": "^7.4.4 || ^8.0.4"
             },
             "require-dev": {
-                "illuminate/console": "^11.46.1",
-                "laravel/pint": "^1.25.1",
+                "illuminate/console": "^11.47.0",
+                "laravel/pint": "^1.27.1",
                 "mockery/mockery": "^1.6.12",
-                "pestphp/pest": "^2.36.0 || ^3.8.4 || ^4.1.3",
+                "pestphp/pest": "^2.36.0 || ^3.8.4 || ^4.3.2",
                 "phpstan/phpstan": "^1.12.32",
                 "phpstan/phpstan-strict-rules": "^1.6.2",
-                "symfony/var-dumper": "^7.3.5",
+                "symfony/var-dumper": "^7.3.5 || ^8.0.4",
                 "thecodingmachine/phpstan-strict-rules": "^1.0.0"
             },
             "type": "library",
@@ -2761,7 +3032,7 @@
                     "email": "enunomaduro@gmail.com"
                 }
             ],
-            "description": "Its like Tailwind CSS, but for the console.",
+            "description": "It's like Tailwind CSS, but for the console.",
             "keywords": [
                 "cli",
                 "console",
@@ -2772,7 +3043,7 @@
             ],
             "support": {
                 "issues": "https://github.com/nunomaduro/termwind/issues",
-                "source": "https://github.com/nunomaduro/termwind/tree/v2.3.3"
+                "source": "https://github.com/nunomaduro/termwind/tree/v2.4.0"
             },
             "funding": [
                 {
@@ -2788,20 +3059,20 @@
                     "type": "github"
                 }
             ],
-            "time": "2025-11-20T02:34:59+00:00"
+            "time": "2026-02-16T23:10:27+00:00"
         },
         {
             "name": "phpoption/phpoption",
-            "version": "1.9.4",
+            "version": "1.9.5",
             "source": {
                 "type": "git",
                 "url": "https://github.com/schmittjoh/php-option.git",
-                "reference": "638a154f8d4ee6a5cfa96d6a34dfbe0cffa9566d"
+                "reference": "75365b91986c2405cf5e1e012c5595cd487a98be"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/schmittjoh/php-option/zipball/638a154f8d4ee6a5cfa96d6a34dfbe0cffa9566d",
-                "reference": "638a154f8d4ee6a5cfa96d6a34dfbe0cffa9566d",
+                "url": "https://api.github.com/repos/schmittjoh/php-option/zipball/75365b91986c2405cf5e1e012c5595cd487a98be",
+                "reference": "75365b91986c2405cf5e1e012c5595cd487a98be",
                 "shasum": ""
             },
             "require": {
@@ -2851,7 +3122,7 @@
             ],
             "support": {
                 "issues": "https://github.com/schmittjoh/php-option/issues",
-                "source": "https://github.com/schmittjoh/php-option/tree/1.9.4"
+                "source": "https://github.com/schmittjoh/php-option/tree/1.9.5"
             },
             "funding": [
                 {
@@ -2863,7 +3134,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-08-21T11:53:16+00:00"
+            "time": "2025-12-27T19:41:33+00:00"
         },
         {
             "name": "predis/predis",
@@ -3342,16 +3613,16 @@
         },
         {
             "name": "psy/psysh",
-            "version": "v0.12.14",
+            "version": "v0.12.23",
             "source": {
                 "type": "git",
                 "url": "https://github.com/bobthecow/psysh.git",
-                "reference": "95c29b3756a23855a30566b745d218bee690bef2"
+                "reference": "4dcc0f08047d52bbde475eda481146fd8e27e1a4"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/bobthecow/psysh/zipball/95c29b3756a23855a30566b745d218bee690bef2",
-                "reference": "95c29b3756a23855a30566b745d218bee690bef2",
+                "url": "https://api.github.com/repos/bobthecow/psysh/zipball/4dcc0f08047d52bbde475eda481146fd8e27e1a4",
+                "reference": "4dcc0f08047d52bbde475eda481146fd8e27e1a4",
                 "shasum": ""
             },
             "require": {
@@ -3359,8 +3630,8 @@
                 "ext-tokenizer": "*",
                 "nikic/php-parser": "^5.0 || ^4.0",
                 "php": "^8.0 || ^7.4",
-                "symfony/console": "^7.0 || ^6.0 || ^5.0 || ^4.0 || ^3.4",
-                "symfony/var-dumper": "^7.0 || ^6.0 || ^5.0 || ^4.0 || ^3.4"
+                "symfony/console": "^8.0 || ^7.0 || ^6.0 || ^5.0 || ^4.0 || ^3.4",
+                "symfony/var-dumper": "^8.0 || ^7.0 || ^6.0 || ^5.0 || ^4.0 || ^3.4"
             },
             "conflict": {
                 "symfony/console": "4.4.37 || 5.3.14 || 5.3.15 || 5.4.3 || 5.4.4 || 6.0.3 || 6.0.4"
@@ -3415,9 +3686,9 @@
             ],
             "support": {
                 "issues": "https://github.com/bobthecow/psysh/issues",
-                "source": "https://github.com/bobthecow/psysh/tree/v0.12.14"
+                "source": "https://github.com/bobthecow/psysh/tree/v0.12.23"
             },
-            "time": "2025-10-27T17:15:31+00:00"
+            "time": "2026-05-23T13:41:31+00:00"
         },
         {
             "name": "ralouphie/getallheaders",
@@ -3541,20 +3812,20 @@
         },
         {
             "name": "ramsey/uuid",
-            "version": "4.9.1",
+            "version": "4.9.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/ramsey/uuid.git",
-                "reference": "81f941f6f729b1e3ceea61d9d014f8b6c6800440"
+                "reference": "8429c78ca35a09f27565311b98101e2826affde0"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/ramsey/uuid/zipball/81f941f6f729b1e3ceea61d9d014f8b6c6800440",
-                "reference": "81f941f6f729b1e3ceea61d9d014f8b6c6800440",
+                "url": "https://api.github.com/repos/ramsey/uuid/zipball/8429c78ca35a09f27565311b98101e2826affde0",
+                "reference": "8429c78ca35a09f27565311b98101e2826affde0",
                 "shasum": ""
             },
             "require": {
-                "brick/math": "^0.8.8 || ^0.9 || ^0.10 || ^0.11 || ^0.12 || ^0.13 || ^0.14",
+                "brick/math": "^0.8.16 || ^0.9 || ^0.10 || ^0.11 || ^0.12 || ^0.13 || ^0.14",
                 "php": "^8.0",
                 "ramsey/collection": "^1.2 || ^2.0"
             },
@@ -3613,36 +3884,37 @@
             ],
             "support": {
                 "issues": "https://github.com/ramsey/uuid/issues",
-                "source": "https://github.com/ramsey/uuid/tree/4.9.1"
+                "source": "https://github.com/ramsey/uuid/tree/4.9.2"
             },
-            "time": "2025-09-04T20:59:21+00:00"
+            "time": "2025-12-14T04:43:48+00:00"
         },
         {
             "name": "spatie/laravel-permission",
-            "version": "6.23.0",
+            "version": "6.25.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/spatie/laravel-permission.git",
-                "reference": "9e41247bd512b1e6c229afbc1eb528f7565ae3bb"
+                "reference": "d7d4cb0d58616722f1afc90e0484e4825155b9b3"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/spatie/laravel-permission/zipball/9e41247bd512b1e6c229afbc1eb528f7565ae3bb",
-                "reference": "9e41247bd512b1e6c229afbc1eb528f7565ae3bb",
+                "url": "https://api.github.com/repos/spatie/laravel-permission/zipball/d7d4cb0d58616722f1afc90e0484e4825155b9b3",
+                "reference": "d7d4cb0d58616722f1afc90e0484e4825155b9b3",
                 "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",
+                "illuminate/auth": "^8.12|^9.0|^10.0|^11.0|^12.0|^13.0",
+                "illuminate/container": "^8.12|^9.0|^10.0|^11.0|^12.0|^13.0",
+                "illuminate/contracts": "^8.12|^9.0|^10.0|^11.0|^12.0|^13.0",
+                "illuminate/database": "^8.12|^9.0|^10.0|^11.0|^12.0|^13.0",
                 "php": "^8.0"
             },
             "require-dev": {
-                "laravel/passport": "^11.0|^12.0",
+                "laravel/passport": "^11.0|^12.0|^13.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"
+                "orchestra/testbench": "^6.23|^7.0|^8.0|^9.0|^10.0|^11.0",
+                "pestphp/pest": "^2.0|^3.0|^4.0",
+                "pestphp/pest-plugin-laravel": "^2.0|^3.0|^4.0"
             },
             "type": "library",
             "extra": {
@@ -3690,7 +3962,7 @@
             ],
             "support": {
                 "issues": "https://github.com/spatie/laravel-permission/issues",
-                "source": "https://github.com/spatie/laravel-permission/tree/6.23.0"
+                "source": "https://github.com/spatie/laravel-permission/tree/6.25.0"
             },
             "funding": [
                 {
@@ -3698,26 +3970,25 @@
                     "type": "github"
                 }
             ],
-            "time": "2025-11-03T20:16:13+00:00"
+            "time": "2026-03-17T22:46:46+00:00"
         },
         {
             "name": "symfony/clock",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/clock.git",
-                "reference": "9169f24776edde469914c1e7a1442a50f7a4e110"
+                "reference": "701ef4de9705d6c32292ebee5e8044094a09fbf6"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/clock/zipball/9169f24776edde469914c1e7a1442a50f7a4e110",
-                "reference": "9169f24776edde469914c1e7a1442a50f7a4e110",
+                "url": "https://api.github.com/repos/symfony/clock/zipball/701ef4de9705d6c32292ebee5e8044094a09fbf6",
+                "reference": "701ef4de9705d6c32292ebee5e8044094a09fbf6",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
-                "psr/clock": "^1.0",
-                "symfony/polyfill-php83": "^1.28"
+                "php": ">=8.4.1",
+                "psr/clock": "^1.0"
             },
             "provide": {
                 "psr/clock-implementation": "1.0"
@@ -3756,7 +4027,7 @@
                 "time"
             ],
             "support": {
-                "source": "https://github.com/symfony/clock/tree/v7.4.0"
+                "source": "https://github.com/symfony/clock/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -3776,51 +4047,53 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-11-12T15:39:26+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/console",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "0bc0f45254b99c58d45a8fbf9fb955d46cbd1bb8"
+                "reference": "f5a856c6ecb56b3c21ed94a5b7bf940d857d110a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/0bc0f45254b99c58d45a8fbf9fb955d46cbd1bb8",
-                "reference": "0bc0f45254b99c58d45a8fbf9fb955d46cbd1bb8",
+                "url": "https://api.github.com/repos/symfony/console/zipball/f5a856c6ecb56b3c21ed94a5b7bf940d857d110a",
+                "reference": "f5a856c6ecb56b3c21ed94a5b7bf940d857d110a",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
+                "php": ">=8.4.1",
                 "symfony/deprecation-contracts": "^2.5|^3",
-                "symfony/polyfill-mbstring": "~1.0",
+                "symfony/polyfill-mbstring": "^1.0",
+                "symfony/polyfill-php85": "^1.32",
                 "symfony/service-contracts": "^2.5|^3",
-                "symfony/string": "^7.2|^8.0"
+                "symfony/string": "^7.4.6|^8.0.6"
             },
             "conflict": {
-                "symfony/dependency-injection": "<6.4",
-                "symfony/dotenv": "<6.4",
-                "symfony/event-dispatcher": "<6.4",
-                "symfony/lock": "<6.4",
-                "symfony/process": "<6.4"
+                "symfony/dependency-injection": "<8.1",
+                "symfony/event-dispatcher": "<8.1"
             },
             "provide": {
                 "psr/log-implementation": "1.0|2.0|3.0"
             },
             "require-dev": {
                 "psr/log": "^1|^2|^3",
-                "symfony/config": "^6.4|^7.0|^8.0",
-                "symfony/dependency-injection": "^6.4|^7.0|^8.0",
-                "symfony/event-dispatcher": "^6.4|^7.0|^8.0",
-                "symfony/http-foundation": "^6.4|^7.0|^8.0",
-                "symfony/http-kernel": "^6.4|^7.0|^8.0",
-                "symfony/lock": "^6.4|^7.0|^8.0",
-                "symfony/messenger": "^6.4|^7.0|^8.0",
-                "symfony/process": "^6.4|^7.0|^8.0",
-                "symfony/stopwatch": "^6.4|^7.0|^8.0",
-                "symfony/var-dumper": "^6.4|^7.0|^8.0"
+                "symfony/config": "^7.4|^8.0",
+                "symfony/dependency-injection": "^8.1",
+                "symfony/event-dispatcher": "^8.1",
+                "symfony/filesystem": "^7.4|^8.0",
+                "symfony/http-foundation": "^7.4|^8.0",
+                "symfony/http-kernel": "^7.4|^8.0",
+                "symfony/lock": "^7.4|^8.0",
+                "symfony/messenger": "^7.4|^8.0",
+                "symfony/mime": "^7.4|^8.0",
+                "symfony/process": "^7.4|^8.0",
+                "symfony/stopwatch": "^7.4|^8.0",
+                "symfony/uid": "^7.4|^8.0",
+                "symfony/validator": "^7.4|^8.0",
+                "symfony/var-dumper": "^7.4|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -3854,7 +4127,7 @@
                 "terminal"
             ],
             "support": {
-                "source": "https://github.com/symfony/console/tree/v7.4.0"
+                "source": "https://github.com/symfony/console/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -3874,24 +4147,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-11-27T13:27:24+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/css-selector",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "ab862f478513e7ca2fe9ec117a6f01a8da6e1135"
+                "reference": "dc0e2be45c9b5588c82414f02ac574b4b986abcd"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/ab862f478513e7ca2fe9ec117a6f01a8da6e1135",
-                "reference": "ab862f478513e7ca2fe9ec117a6f01a8da6e1135",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/dc0e2be45c9b5588c82414f02ac574b4b986abcd",
+                "reference": "dc0e2be45c9b5588c82414f02ac574b4b986abcd",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.4.1"
             },
             "type": "library",
             "autoload": {
@@ -3923,7 +4196,7 @@
             "description": "Converts CSS selectors to XPath expressions",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/v7.4.0"
+                "source": "https://github.com/symfony/css-selector/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -3943,20 +4216,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-10-30T13:39:42+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/deprecation-contracts",
-            "version": "v3.6.0",
+            "version": "v3.7.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/deprecation-contracts.git",
-                "reference": "63afe740e99a13ba87ec199bb07bbdee937a5b62"
+                "reference": "50f59d1f3ca46d41ac911f97a78626b6756af35b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/63afe740e99a13ba87ec199bb07bbdee937a5b62",
-                "reference": "63afe740e99a13ba87ec199bb07bbdee937a5b62",
+                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/50f59d1f3ca46d41ac911f97a78626b6756af35b",
+                "reference": "50f59d1f3ca46d41ac911f97a78626b6756af35b",
                 "shasum": ""
             },
             "require": {
@@ -3969,7 +4242,7 @@
                     "name": "symfony/contracts"
                 },
                 "branch-alias": {
-                    "dev-main": "3.6-dev"
+                    "dev-main": "3.7-dev"
                 }
             },
             "autoload": {
@@ -3994,7 +4267,7 @@
             "description": "A generic function and convention to trigger deprecation notices",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/deprecation-contracts/tree/v3.6.0"
+                "source": "https://github.com/symfony/deprecation-contracts/tree/v3.7.0"
             },
             "funding": [
                 {
@@ -4005,42 +4278,45 @@
                     "url": "https://github.com/fabpot",
                     "type": "github"
                 },
+                {
+                    "url": "https://github.com/nicolas-grekas",
+                    "type": "github"
+                },
                 {
                     "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-09-25T14:21:43+00:00"
+            "time": "2026-04-13T15:52:40+00:00"
         },
         {
             "name": "symfony/error-handler",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/error-handler.git",
-                "reference": "48be2b0653594eea32dcef130cca1c811dcf25c2"
+                "reference": "d8aeb1abd3fef84795567850d3a567bdb5945ee5"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/error-handler/zipball/48be2b0653594eea32dcef130cca1c811dcf25c2",
-                "reference": "48be2b0653594eea32dcef130cca1c811dcf25c2",
+                "url": "https://api.github.com/repos/symfony/error-handler/zipball/d8aeb1abd3fef84795567850d3a567bdb5945ee5",
+                "reference": "d8aeb1abd3fef84795567850d3a567bdb5945ee5",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
+                "php": ">=8.4.1",
                 "psr/log": "^1|^2|^3",
                 "symfony/polyfill-php85": "^1.32",
-                "symfony/var-dumper": "^6.4|^7.0|^8.0"
+                "symfony/var-dumper": "^7.4|^8.0"
             },
             "conflict": {
-                "symfony/deprecation-contracts": "<2.5",
-                "symfony/http-kernel": "<6.4"
+                "symfony/deprecation-contracts": "<2.5"
             },
             "require-dev": {
-                "symfony/console": "^6.4|^7.0|^8.0",
+                "symfony/console": "^7.4|^8.0",
                 "symfony/deprecation-contracts": "^2.5|^3",
-                "symfony/http-kernel": "^6.4|^7.0|^8.0",
-                "symfony/serializer": "^6.4|^7.0|^8.0",
+                "symfony/http-kernel": "^7.4|^8.0",
+                "symfony/serializer": "^7.4|^8.0",
                 "symfony/webpack-encore-bundle": "^1.0|^2.0"
             },
             "bin": [
@@ -4072,7 +4348,7 @@
             "description": "Provides tools to manage errors and ease debugging PHP code",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/error-handler/tree/v7.4.0"
+                "source": "https://github.com/symfony/error-handler/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -4092,24 +4368,25 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-11-05T14:29:59+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/event-dispatcher",
-            "version": "v8.0.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/event-dispatcher.git",
-                "reference": "573f95783a2ec6e38752979db139f09fec033f03"
+                "reference": "f249ae3f680958b6f1f9dd76e5747cf0695b4102"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/event-dispatcher/zipball/573f95783a2ec6e38752979db139f09fec033f03",
-                "reference": "573f95783a2ec6e38752979db139f09fec033f03",
+                "url": "https://api.github.com/repos/symfony/event-dispatcher/zipball/f249ae3f680958b6f1f9dd76e5747cf0695b4102",
+                "reference": "f249ae3f680958b6f1f9dd76e5747cf0695b4102",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.4",
+                "php": ">=8.4.1",
+                "symfony/deprecation-contracts": "^2.5|^3",
                 "symfony/event-dispatcher-contracts": "^2.5|^3"
             },
             "conflict": {
@@ -4157,7 +4434,7 @@
             "description": "Provides tools that allow your application components to communicate with each other by dispatching events and listening to them",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/event-dispatcher/tree/v8.0.0"
+                "source": "https://github.com/symfony/event-dispatcher/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -4177,20 +4454,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-10-30T14:17:19+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/event-dispatcher-contracts",
-            "version": "v3.6.0",
+            "version": "v3.7.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/event-dispatcher-contracts.git",
-                "reference": "59eb412e93815df44f05f342958efa9f46b1e586"
+                "reference": "ccba7060602b7fed0b03c85bf025257f76d9ef32"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/event-dispatcher-contracts/zipball/59eb412e93815df44f05f342958efa9f46b1e586",
-                "reference": "59eb412e93815df44f05f342958efa9f46b1e586",
+                "url": "https://api.github.com/repos/symfony/event-dispatcher-contracts/zipball/ccba7060602b7fed0b03c85bf025257f76d9ef32",
+                "reference": "ccba7060602b7fed0b03c85bf025257f76d9ef32",
                 "shasum": ""
             },
             "require": {
@@ -4204,7 +4481,7 @@
                     "name": "symfony/contracts"
                 },
                 "branch-alias": {
-                    "dev-main": "3.6-dev"
+                    "dev-main": "3.7-dev"
                 }
             },
             "autoload": {
@@ -4237,7 +4514,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/event-dispatcher-contracts/tree/v3.6.0"
+                "source": "https://github.com/symfony/event-dispatcher-contracts/tree/v3.7.0"
             },
             "funding": [
                 {
@@ -4248,32 +4525,36 @@
                     "url": "https://github.com/fabpot",
                     "type": "github"
                 },
+                {
+                    "url": "https://github.com/nicolas-grekas",
+                    "type": "github"
+                },
                 {
                     "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-09-25T14:21:43+00:00"
+            "time": "2026-01-05T13:30:16+00:00"
         },
         {
             "name": "symfony/finder",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "340b9ed7320570f319028a2cbec46d40535e94bd"
+                "reference": "58d2e767a66052c1487356f953445634a8194c64"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/340b9ed7320570f319028a2cbec46d40535e94bd",
-                "reference": "340b9ed7320570f319028a2cbec46d40535e94bd",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/58d2e767a66052c1487356f953445634a8194c64",
+                "reference": "58d2e767a66052c1487356f953445634a8194c64",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.4.1"
             },
             "require-dev": {
-                "symfony/filesystem": "^6.4|^7.0|^8.0"
+                "symfony/filesystem": "^7.4|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -4301,7 +4582,7 @@
             "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v7.4.0"
+                "source": "https://github.com/symfony/finder/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -4321,41 +4602,40 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-11-05T05:42:40+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/http-foundation",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-foundation.git",
-                "reference": "769c1720b68e964b13b58529c17d4a385c62167b"
+                "reference": "af11474600f06718086c2cda4fa6fa8d0a672e7e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-foundation/zipball/769c1720b68e964b13b58529c17d4a385c62167b",
-                "reference": "769c1720b68e964b13b58529c17d4a385c62167b",
+                "url": "https://api.github.com/repos/symfony/http-foundation/zipball/af11474600f06718086c2cda4fa6fa8d0a672e7e",
+                "reference": "af11474600f06718086c2cda4fa6fa8d0a672e7e",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
+                "php": ">=8.4.1",
                 "symfony/deprecation-contracts": "^2.5|^3",
                 "symfony/polyfill-mbstring": "^1.1"
             },
             "conflict": {
-                "doctrine/dbal": "<3.6",
-                "symfony/cache": "<6.4.12|>=7.0,<7.1.5"
+                "doctrine/dbal": "<4.3"
             },
             "require-dev": {
-                "doctrine/dbal": "^3.6|^4",
+                "doctrine/dbal": "^4.3",
                 "predis/predis": "^1.1|^2.0",
-                "symfony/cache": "^6.4.12|^7.1.5|^8.0",
-                "symfony/clock": "^6.4|^7.0|^8.0",
-                "symfony/dependency-injection": "^6.4|^7.0|^8.0",
-                "symfony/expression-language": "^6.4|^7.0|^8.0",
-                "symfony/http-kernel": "^6.4|^7.0|^8.0",
-                "symfony/mime": "^6.4|^7.0|^8.0",
-                "symfony/rate-limiter": "^6.4|^7.0|^8.0"
+                "symfony/cache": "^7.4|^8.0",
+                "symfony/clock": "^7.4|^8.0",
+                "symfony/dependency-injection": "^7.4|^8.0",
+                "symfony/expression-language": "^7.4|^8.0",
+                "symfony/http-kernel": "^7.4|^8.0",
+                "symfony/mime": "^7.4|^8.0",
+                "symfony/rate-limiter": "^7.4|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -4383,7 +4663,7 @@
             "description": "Defines an object-oriented layer for the HTTP specification",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-foundation/tree/v7.4.0"
+                "source": "https://github.com/symfony/http-foundation/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -4403,78 +4683,68 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-11-13T08:49:24+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/http-kernel",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-kernel.git",
-                "reference": "7348193cd384495a755554382e4526f27c456085"
+                "reference": "cefeb37c82eed3e0c42fa25ba64cd3a908d90f39"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-kernel/zipball/7348193cd384495a755554382e4526f27c456085",
-                "reference": "7348193cd384495a755554382e4526f27c456085",
+                "url": "https://api.github.com/repos/symfony/http-kernel/zipball/cefeb37c82eed3e0c42fa25ba64cd3a908d90f39",
+                "reference": "cefeb37c82eed3e0c42fa25ba64cd3a908d90f39",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
+                "php": ">=8.4.1",
                 "psr/log": "^1|^2|^3",
                 "symfony/deprecation-contracts": "^2.5|^3",
-                "symfony/error-handler": "^6.4|^7.0|^8.0",
-                "symfony/event-dispatcher": "^7.3|^8.0",
+                "symfony/error-handler": "^7.4|^8.0",
+                "symfony/event-dispatcher": "^7.4|^8.0",
                 "symfony/http-foundation": "^7.4|^8.0",
                 "symfony/polyfill-ctype": "^1.8"
             },
             "conflict": {
-                "symfony/browser-kit": "<6.4",
-                "symfony/cache": "<6.4",
-                "symfony/config": "<6.4",
-                "symfony/console": "<6.4",
-                "symfony/dependency-injection": "<6.4",
-                "symfony/doctrine-bridge": "<6.4",
+                "symfony/dependency-injection": "<8.1",
                 "symfony/flex": "<2.10",
-                "symfony/form": "<6.4",
-                "symfony/http-client": "<6.4",
                 "symfony/http-client-contracts": "<2.5",
-                "symfony/mailer": "<6.4",
-                "symfony/messenger": "<6.4",
-                "symfony/translation": "<6.4",
                 "symfony/translation-contracts": "<2.5",
-                "symfony/twig-bridge": "<6.4",
-                "symfony/validator": "<6.4",
-                "symfony/var-dumper": "<6.4",
-                "twig/twig": "<3.12"
+                "symfony/var-dumper": "<8.1",
+                "symfony/web-profiler-bundle": "<8.1",
+                "twig/twig": "<3.21"
             },
             "provide": {
                 "psr/log-implementation": "1.0|2.0|3.0"
             },
             "require-dev": {
                 "psr/cache": "^1.0|^2.0|^3.0",
-                "symfony/browser-kit": "^6.4|^7.0|^8.0",
-                "symfony/clock": "^6.4|^7.0|^8.0",
-                "symfony/config": "^6.4|^7.0|^8.0",
-                "symfony/console": "^6.4|^7.0|^8.0",
-                "symfony/css-selector": "^6.4|^7.0|^8.0",
-                "symfony/dependency-injection": "^6.4|^7.0|^8.0",
-                "symfony/dom-crawler": "^6.4|^7.0|^8.0",
-                "symfony/expression-language": "^6.4|^7.0|^8.0",
-                "symfony/finder": "^6.4|^7.0|^8.0",
+                "symfony/browser-kit": "^7.4|^8.0",
+                "symfony/clock": "^7.4|^8.0",
+                "symfony/config": "^7.4|^8.0",
+                "symfony/console": "^7.4|^8.0",
+                "symfony/css-selector": "^7.4|^8.0",
+                "symfony/dependency-injection": "^8.1",
+                "symfony/dom-crawler": "^7.4|^8.0",
+                "symfony/expression-language": "^7.4|^8.0",
+                "symfony/finder": "^7.4|^8.0",
                 "symfony/http-client-contracts": "^2.5|^3",
-                "symfony/process": "^6.4|^7.0|^8.0",
-                "symfony/property-access": "^7.1|^8.0",
-                "symfony/routing": "^6.4|^7.0|^8.0",
-                "symfony/serializer": "^7.1|^8.0",
-                "symfony/stopwatch": "^6.4|^7.0|^8.0",
-                "symfony/translation": "^6.4|^7.0|^8.0",
+                "symfony/process": "^7.4|^8.0",
+                "symfony/property-access": "^7.4|^8.0",
+                "symfony/rate-limiter": "^7.4|^8.0",
+                "symfony/routing": "^7.4|^8.0",
+                "symfony/serializer": "^7.4|^8.0",
+                "symfony/stopwatch": "^7.4|^8.0",
+                "symfony/translation": "^7.4|^8.0",
                 "symfony/translation-contracts": "^2.5|^3",
-                "symfony/uid": "^6.4|^7.0|^8.0",
-                "symfony/validator": "^6.4|^7.0|^8.0",
-                "symfony/var-dumper": "^6.4|^7.0|^8.0",
-                "symfony/var-exporter": "^6.4|^7.0|^8.0",
-                "twig/twig": "^3.12"
+                "symfony/uid": "^7.4|^8.0",
+                "symfony/validator": "^7.4|^8.0",
+                "symfony/var-dumper": "^8.1",
+                "symfony/var-exporter": "^7.4|^8.0",
+                "twig/twig": "^3.21"
             },
             "type": "library",
             "autoload": {
@@ -4502,7 +4772,7 @@
             "description": "Provides a structured process for converting a Request into a Response",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-kernel/tree/v7.4.0"
+                "source": "https://github.com/symfony/http-kernel/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -4522,43 +4792,39 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-11-27T13:38:24+00:00"
+            "time": "2026-05-29T08:46:08+00:00"
         },
         {
             "name": "symfony/mailer",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/mailer.git",
-                "reference": "a3d9eea8cfa467ece41f0f54ba28185d74bd53fd"
+                "reference": "9418d772df3a03a142e3bc06f602adb2b8724877"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/mailer/zipball/a3d9eea8cfa467ece41f0f54ba28185d74bd53fd",
-                "reference": "a3d9eea8cfa467ece41f0f54ba28185d74bd53fd",
+                "url": "https://api.github.com/repos/symfony/mailer/zipball/9418d772df3a03a142e3bc06f602adb2b8724877",
+                "reference": "9418d772df3a03a142e3bc06f602adb2b8724877",
                 "shasum": ""
             },
             "require": {
                 "egulias/email-validator": "^2.1.10|^3|^4",
-                "php": ">=8.2",
+                "php": ">=8.4.1",
                 "psr/event-dispatcher": "^1",
                 "psr/log": "^1|^2|^3",
-                "symfony/event-dispatcher": "^6.4|^7.0|^8.0",
-                "symfony/mime": "^7.2|^8.0",
+                "symfony/event-dispatcher": "^7.4|^8.0",
+                "symfony/mime": "^7.4|^8.0",
                 "symfony/service-contracts": "^2.5|^3"
             },
             "conflict": {
-                "symfony/http-client-contracts": "<2.5",
-                "symfony/http-kernel": "<6.4",
-                "symfony/messenger": "<6.4",
-                "symfony/mime": "<6.4",
-                "symfony/twig-bridge": "<6.4"
+                "symfony/http-client-contracts": "<2.5"
             },
             "require-dev": {
-                "symfony/console": "^6.4|^7.0|^8.0",
-                "symfony/http-client": "^6.4|^7.0|^8.0",
-                "symfony/messenger": "^6.4|^7.0|^8.0",
-                "symfony/twig-bridge": "^6.4|^7.0|^8.0"
+                "symfony/console": "^7.4|^8.0",
+                "symfony/http-client": "^7.4|^8.0",
+                "symfony/messenger": "^7.4|^8.0",
+                "symfony/twig-bridge": "^7.4|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -4586,7 +4852,7 @@
             "description": "Helps sending emails",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/mailer/tree/v7.4.0"
+                "source": "https://github.com/symfony/mailer/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -4606,44 +4872,41 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-11-21T15:26:00+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/mime",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/mime.git",
-                "reference": "bdb02729471be5d047a3ac4a69068748f1a6be7a"
+                "reference": "b164ae7e3f7915aacfe9ee155f2f358502440664"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/mime/zipball/bdb02729471be5d047a3ac4a69068748f1a6be7a",
-                "reference": "bdb02729471be5d047a3ac4a69068748f1a6be7a",
+                "url": "https://api.github.com/repos/symfony/mime/zipball/b164ae7e3f7915aacfe9ee155f2f358502440664",
+                "reference": "b164ae7e3f7915aacfe9ee155f2f358502440664",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
-                "symfony/deprecation-contracts": "^2.5|^3",
+                "php": ">=8.4.1",
                 "symfony/polyfill-intl-idn": "^1.10",
                 "symfony/polyfill-mbstring": "^1.0"
             },
             "conflict": {
                 "egulias/email-validator": "~3.0.0",
-                "phpdocumentor/reflection-docblock": "<3.2.2",
-                "phpdocumentor/type-resolver": "<1.4.0",
-                "symfony/mailer": "<6.4",
-                "symfony/serializer": "<6.4.3|>7.0,<7.0.3"
+                "phpdocumentor/reflection-docblock": "<5.2|>=7",
+                "phpdocumentor/type-resolver": "<1.5.1"
             },
             "require-dev": {
                 "egulias/email-validator": "^2.1.10|^3.1|^4",
                 "league/html-to-markdown": "^5.0",
-                "phpdocumentor/reflection-docblock": "^3.0|^4.0|^5.0",
-                "symfony/dependency-injection": "^6.4|^7.0|^8.0",
-                "symfony/process": "^6.4|^7.0|^8.0",
-                "symfony/property-access": "^6.4|^7.0|^8.0",
-                "symfony/property-info": "^6.4|^7.0|^8.0",
-                "symfony/serializer": "^6.4.3|^7.0.3|^8.0"
+                "phpdocumentor/reflection-docblock": "^5.2|^6.0",
+                "symfony/dependency-injection": "^7.4|^8.0",
+                "symfony/process": "^7.4|^8.0",
+                "symfony/property-access": "^7.4|^8.0",
+                "symfony/property-info": "^7.4|^8.0",
+                "symfony/serializer": "^7.4|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -4675,7 +4938,7 @@
                 "mime-type"
             ],
             "support": {
-                "source": "https://github.com/symfony/mime/tree/v7.4.0"
+                "source": "https://github.com/symfony/mime/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -4695,20 +4958,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-11-16T10:14:42+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/polyfill-ctype",
-            "version": "v1.33.0",
+            "version": "v1.37.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-ctype.git",
-                "reference": "a3cc8b044a6ea513310cbd48ef7333b384945638"
+                "reference": "141046a8f9477948ff284fa65be2095baafb94f2"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/a3cc8b044a6ea513310cbd48ef7333b384945638",
-                "reference": "a3cc8b044a6ea513310cbd48ef7333b384945638",
+                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/141046a8f9477948ff284fa65be2095baafb94f2",
+                "reference": "141046a8f9477948ff284fa65be2095baafb94f2",
                 "shasum": ""
             },
             "require": {
@@ -4758,7 +5021,7 @@
                 "portable"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.33.0"
+                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.37.0"
             },
             "funding": [
                 {
@@ -4778,20 +5041,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-09-09T11:45:10+00:00"
+            "time": "2026-04-10T16:19:22+00:00"
         },
         {
             "name": "symfony/polyfill-intl-grapheme",
-            "version": "v1.33.0",
+            "version": "v1.38.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-grapheme.git",
-                "reference": "380872130d3a5dd3ace2f4010d95125fde5d5c70"
+                "reference": "e9247d281d694a5120554d9afaf54e070e88a603"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/380872130d3a5dd3ace2f4010d95125fde5d5c70",
-                "reference": "380872130d3a5dd3ace2f4010d95125fde5d5c70",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/e9247d281d694a5120554d9afaf54e070e88a603",
+                "reference": "e9247d281d694a5120554d9afaf54e070e88a603",
                 "shasum": ""
             },
             "require": {
@@ -4840,7 +5103,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.33.0"
+                "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.38.1"
             },
             "funding": [
                 {
@@ -4860,20 +5123,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-06-27T09:58:17+00:00"
+            "time": "2026-05-26T05:58:03+00:00"
         },
         {
             "name": "symfony/polyfill-intl-idn",
-            "version": "v1.33.0",
+            "version": "v1.38.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-idn.git",
-                "reference": "9614ac4d8061dc257ecc64cba1b140873dce8ad3"
+                "reference": "dc21118016c039a66235cf93d96b435ffb282412"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-idn/zipball/9614ac4d8061dc257ecc64cba1b140873dce8ad3",
-                "reference": "9614ac4d8061dc257ecc64cba1b140873dce8ad3",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-idn/zipball/dc21118016c039a66235cf93d96b435ffb282412",
+                "reference": "dc21118016c039a66235cf93d96b435ffb282412",
                 "shasum": ""
             },
             "require": {
@@ -4927,7 +5190,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-idn/tree/v1.33.0"
+                "source": "https://github.com/symfony/polyfill-intl-idn/tree/v1.38.1"
             },
             "funding": [
                 {
@@ -4947,20 +5210,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-09-10T14:38:51+00:00"
+            "time": "2026-05-25T15:22:23+00:00"
         },
         {
             "name": "symfony/polyfill-intl-normalizer",
-            "version": "v1.33.0",
+            "version": "v1.38.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-normalizer.git",
-                "reference": "3833d7255cc303546435cb650316bff708a1c75c"
+                "reference": "2d446c214bdbe5b71bde5011b060a05fece3ae6b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/3833d7255cc303546435cb650316bff708a1c75c",
-                "reference": "3833d7255cc303546435cb650316bff708a1c75c",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/2d446c214bdbe5b71bde5011b060a05fece3ae6b",
+                "reference": "2d446c214bdbe5b71bde5011b060a05fece3ae6b",
                 "shasum": ""
             },
             "require": {
@@ -5012,7 +5275,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.33.0"
+                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.38.0"
             },
             "funding": [
                 {
@@ -5032,20 +5295,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-09-09T11:45:10+00:00"
+            "time": "2026-05-25T13:48:31+00:00"
         },
         {
             "name": "symfony/polyfill-mbstring",
-            "version": "v1.33.0",
+            "version": "v1.38.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-mbstring.git",
-                "reference": "6d857f4d76bd4b343eac26d6b539585d2bc56493"
+                "reference": "14c5439eec4ccff081ac14eca2dc57feb2a66d92"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/6d857f4d76bd4b343eac26d6b539585d2bc56493",
-                "reference": "6d857f4d76bd4b343eac26d6b539585d2bc56493",
+                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/14c5439eec4ccff081ac14eca2dc57feb2a66d92",
+                "reference": "14c5439eec4ccff081ac14eca2dc57feb2a66d92",
                 "shasum": ""
             },
             "require": {
@@ -5097,7 +5360,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.33.0"
+                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.38.1"
             },
             "funding": [
                 {
@@ -5117,20 +5380,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-12-23T08:48:59+00:00"
+            "time": "2026-05-26T12:51:13+00:00"
         },
         {
             "name": "symfony/polyfill-php80",
-            "version": "v1.33.0",
+            "version": "v1.37.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php80.git",
-                "reference": "0cc9dd0f17f61d8131e7df6b84bd344899fe2608"
+                "reference": "dfb55726c3a76ea3b6459fcfda1ec2d80a682411"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/0cc9dd0f17f61d8131e7df6b84bd344899fe2608",
-                "reference": "0cc9dd0f17f61d8131e7df6b84bd344899fe2608",
+                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/dfb55726c3a76ea3b6459fcfda1ec2d80a682411",
+                "reference": "dfb55726c3a76ea3b6459fcfda1ec2d80a682411",
                 "shasum": ""
             },
             "require": {
@@ -5181,7 +5444,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php80/tree/v1.33.0"
+                "source": "https://github.com/symfony/polyfill-php80/tree/v1.37.0"
             },
             "funding": [
                 {
@@ -5201,20 +5464,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-01-02T08:10:11+00:00"
+            "time": "2026-04-10T16:19:22+00:00"
         },
         {
-            "name": "symfony/polyfill-php83",
-            "version": "v1.33.0",
+            "name": "symfony/polyfill-php84",
+            "version": "v1.38.1",
             "source": {
                 "type": "git",
-                "url": "https://github.com/symfony/polyfill-php83.git",
-                "reference": "17f6f9a6b1735c0f163024d959f700cfbc5155e5"
+                "url": "https://github.com/symfony/polyfill-php84.git",
+                "reference": "f4e1dfaee5b74aba5964fe1fd4dfc7ba5e3085fa"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php83/zipball/17f6f9a6b1735c0f163024d959f700cfbc5155e5",
-                "reference": "17f6f9a6b1735c0f163024d959f700cfbc5155e5",
+                "url": "https://api.github.com/repos/symfony/polyfill-php84/zipball/f4e1dfaee5b74aba5964fe1fd4dfc7ba5e3085fa",
+                "reference": "f4e1dfaee5b74aba5964fe1fd4dfc7ba5e3085fa",
                 "shasum": ""
             },
             "require": {
@@ -5232,7 +5495,7 @@
                     "bootstrap.php"
                 ],
                 "psr-4": {
-                    "Symfony\\Polyfill\\Php83\\": ""
+                    "Symfony\\Polyfill\\Php84\\": ""
                 },
                 "classmap": [
                     "Resources/stubs"
@@ -5252,7 +5515,7 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony polyfill backporting some PHP 8.3+ features to lower PHP versions",
+            "description": "Symfony polyfill backporting some PHP 8.4+ features to lower PHP versions",
             "homepage": "https://symfony.com",
             "keywords": [
                 "compatibility",
@@ -5261,7 +5524,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php83/tree/v1.33.0"
+                "source": "https://github.com/symfony/polyfill-php84/tree/v1.38.1"
             },
             "funding": [
                 {
@@ -5281,20 +5544,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-07-08T02:45:35+00:00"
+            "time": "2026-05-26T12:51:13+00:00"
         },
         {
-            "name": "symfony/polyfill-php84",
-            "version": "v1.33.0",
+            "name": "symfony/polyfill-php85",
+            "version": "v1.38.1",
             "source": {
                 "type": "git",
-                "url": "https://github.com/symfony/polyfill-php84.git",
-                "reference": "d8ced4d875142b6a7426000426b8abc631d6b191"
+                "url": "https://github.com/symfony/polyfill-php85.git",
+                "reference": "ba2ba04f3352cfa2dcbbcb90aee13ed967f505b1"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php84/zipball/d8ced4d875142b6a7426000426b8abc631d6b191",
-                "reference": "d8ced4d875142b6a7426000426b8abc631d6b191",
+                "url": "https://api.github.com/repos/symfony/polyfill-php85/zipball/ba2ba04f3352cfa2dcbbcb90aee13ed967f505b1",
+                "reference": "ba2ba04f3352cfa2dcbbcb90aee13ed967f505b1",
                 "shasum": ""
             },
             "require": {
@@ -5312,7 +5575,7 @@
                     "bootstrap.php"
                 ],
                 "psr-4": {
-                    "Symfony\\Polyfill\\Php84\\": ""
+                    "Symfony\\Polyfill\\Php85\\": ""
                 },
                 "classmap": [
                     "Resources/stubs"
@@ -5332,7 +5595,7 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony polyfill backporting some PHP 8.4+ features to lower PHP versions",
+            "description": "Symfony polyfill backporting some PHP 8.5+ features to lower PHP versions",
             "homepage": "https://symfony.com",
             "keywords": [
                 "compatibility",
@@ -5341,7 +5604,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php84/tree/v1.33.0"
+                "source": "https://github.com/symfony/polyfill-php85/tree/v1.38.1"
             },
             "funding": [
                 {
@@ -5361,20 +5624,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-06-24T13:30:11+00:00"
+            "time": "2026-05-26T02:25:22+00:00"
         },
         {
-            "name": "symfony/polyfill-php85",
-            "version": "v1.33.0",
+            "name": "symfony/polyfill-php86",
+            "version": "v1.38.0",
             "source": {
                 "type": "git",
-                "url": "https://github.com/symfony/polyfill-php85.git",
-                "reference": "d4e5fcd4ab3d998ab16c0db48e6cbb9a01993f91"
+                "url": "https://github.com/symfony/polyfill-php86.git",
+                "reference": "fcec68d64f46dc84e1f6ffcf2c6dda40ff3143ad"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php85/zipball/d4e5fcd4ab3d998ab16c0db48e6cbb9a01993f91",
-                "reference": "d4e5fcd4ab3d998ab16c0db48e6cbb9a01993f91",
+                "url": "https://api.github.com/repos/symfony/polyfill-php86/zipball/fcec68d64f46dc84e1f6ffcf2c6dda40ff3143ad",
+                "reference": "fcec68d64f46dc84e1f6ffcf2c6dda40ff3143ad",
                 "shasum": ""
             },
             "require": {
@@ -5392,7 +5655,7 @@
                     "bootstrap.php"
                 ],
                 "psr-4": {
-                    "Symfony\\Polyfill\\Php85\\": ""
+                    "Symfony\\Polyfill\\Php86\\": ""
                 },
                 "classmap": [
                     "Resources/stubs"
@@ -5412,7 +5675,7 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony polyfill backporting some PHP 8.5+ features to lower PHP versions",
+            "description": "Symfony polyfill backporting some PHP 8.6+ features to lower PHP versions",
             "homepage": "https://symfony.com",
             "keywords": [
                 "compatibility",
@@ -5421,7 +5684,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php85/tree/v1.33.0"
+                "source": "https://github.com/symfony/polyfill-php86/tree/v1.38.0"
             },
             "funding": [
                 {
@@ -5441,20 +5704,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-06-23T16:12:55+00:00"
+            "time": "2026-05-25T11:52:35+00:00"
         },
         {
             "name": "symfony/polyfill-uuid",
-            "version": "v1.33.0",
+            "version": "v1.37.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-uuid.git",
-                "reference": "21533be36c24be3f4b1669c4725c7d1d2bab4ae2"
+                "reference": "26dfec253c4cf3e51b541b52ddf7e42cb0908e94"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-uuid/zipball/21533be36c24be3f4b1669c4725c7d1d2bab4ae2",
-                "reference": "21533be36c24be3f4b1669c4725c7d1d2bab4ae2",
+                "url": "https://api.github.com/repos/symfony/polyfill-uuid/zipball/26dfec253c4cf3e51b541b52ddf7e42cb0908e94",
+                "reference": "26dfec253c4cf3e51b541b52ddf7e42cb0908e94",
                 "shasum": ""
             },
             "require": {
@@ -5504,7 +5767,7 @@
                 "uuid"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-uuid/tree/v1.33.0"
+                "source": "https://github.com/symfony/polyfill-uuid/tree/v1.37.0"
             },
             "funding": [
                 {
@@ -5524,24 +5787,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-09-09T11:45:10+00:00"
+            "time": "2026-04-10T16:19:22+00:00"
         },
         {
             "name": "symfony/process",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/process.git",
-                "reference": "7ca8dc2d0dcf4882658313aba8be5d9fd01026c8"
+                "reference": "c4a9e58f235a6bf7f97ffbfedae2687353ac79e5"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/7ca8dc2d0dcf4882658313aba8be5d9fd01026c8",
-                "reference": "7ca8dc2d0dcf4882658313aba8be5d9fd01026c8",
+                "url": "https://api.github.com/repos/symfony/process/zipball/c4a9e58f235a6bf7f97ffbfedae2687353ac79e5",
+                "reference": "c4a9e58f235a6bf7f97ffbfedae2687353ac79e5",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.4.1"
             },
             "type": "library",
             "autoload": {
@@ -5569,7 +5832,7 @@
             "description": "Executes commands in sub-processes",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/process/tree/v7.4.0"
+                "source": "https://github.com/symfony/process/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -5589,38 +5852,33 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-10-16T11:21:06+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/routing",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/routing.git",
-                "reference": "4720254cb2644a0b876233d258a32bf017330db7"
+                "reference": "fe0bfec72c8a806109fb9c3a5f2b898fe0c76eb3"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/routing/zipball/4720254cb2644a0b876233d258a32bf017330db7",
-                "reference": "4720254cb2644a0b876233d258a32bf017330db7",
+                "url": "https://api.github.com/repos/symfony/routing/zipball/fe0bfec72c8a806109fb9c3a5f2b898fe0c76eb3",
+                "reference": "fe0bfec72c8a806109fb9c3a5f2b898fe0c76eb3",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
+                "php": ">=8.4.1",
                 "symfony/deprecation-contracts": "^2.5|^3"
             },
-            "conflict": {
-                "symfony/config": "<6.4",
-                "symfony/dependency-injection": "<6.4",
-                "symfony/yaml": "<6.4"
-            },
             "require-dev": {
                 "psr/log": "^1|^2|^3",
-                "symfony/config": "^6.4|^7.0|^8.0",
-                "symfony/dependency-injection": "^6.4|^7.0|^8.0",
-                "symfony/expression-language": "^6.4|^7.0|^8.0",
-                "symfony/http-foundation": "^6.4|^7.0|^8.0",
-                "symfony/yaml": "^6.4|^7.0|^8.0"
+                "symfony/config": "^7.4|^8.0",
+                "symfony/dependency-injection": "^7.4|^8.0",
+                "symfony/expression-language": "^7.4|^8.0",
+                "symfony/http-foundation": "^7.4|^8.0",
+                "symfony/yaml": "^7.4|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -5654,7 +5912,7 @@
                 "url"
             ],
             "support": {
-                "source": "https://github.com/symfony/routing/tree/v7.4.0"
+                "source": "https://github.com/symfony/routing/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -5674,20 +5932,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-11-27T13:27:24+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/service-contracts",
-            "version": "v3.6.1",
+            "version": "v3.7.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/service-contracts.git",
-                "reference": "45112560a3ba2d715666a509a0bc9521d10b6c43"
+                "reference": "d25d82433a80eba6aa0e6c24b61d7370d99e444a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/45112560a3ba2d715666a509a0bc9521d10b6c43",
-                "reference": "45112560a3ba2d715666a509a0bc9521d10b6c43",
+                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/d25d82433a80eba6aa0e6c24b61d7370d99e444a",
+                "reference": "d25d82433a80eba6aa0e6c24b61d7370d99e444a",
                 "shasum": ""
             },
             "require": {
@@ -5705,7 +5963,7 @@
                     "name": "symfony/contracts"
                 },
                 "branch-alias": {
-                    "dev-main": "3.6-dev"
+                    "dev-main": "3.7-dev"
                 }
             },
             "autoload": {
@@ -5741,7 +5999,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/service-contracts/tree/v3.6.1"
+                "source": "https://github.com/symfony/service-contracts/tree/v3.7.0"
             },
             "funding": [
                 {
@@ -5761,24 +6019,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-07-15T11:30:57+00:00"
+            "time": "2026-03-28T09:44:51+00:00"
         },
         {
             "name": "symfony/string",
-            "version": "v8.0.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/string.git",
-                "reference": "f929eccf09531078c243df72398560e32fa4cf4f"
+                "reference": "afd5944f4005862d961efb85c8bbd5c523c4e3c9"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/string/zipball/f929eccf09531078c243df72398560e32fa4cf4f",
-                "reference": "f929eccf09531078c243df72398560e32fa4cf4f",
+                "url": "https://api.github.com/repos/symfony/string/zipball/afd5944f4005862d961efb85c8bbd5c523c4e3c9",
+                "reference": "afd5944f4005862d961efb85c8bbd5c523c4e3c9",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.4",
+                "php": ">=8.4.1",
                 "symfony/polyfill-ctype": "^1.8",
                 "symfony/polyfill-intl-grapheme": "^1.33",
                 "symfony/polyfill-intl-normalizer": "^1.0",
@@ -5831,7 +6089,7 @@
                 "utf8"
             ],
             "support": {
-                "source": "https://github.com/symfony/string/tree/v8.0.0"
+                "source": "https://github.com/symfony/string/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -5851,38 +6109,31 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-11T14:37:55+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/translation",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/translation.git",
-                "reference": "2d01ca0da3f092f91eeedb46f24aa30d2fca8f68"
+                "reference": "b2bd012ca28c4acae830ee1206a5b6e35dd99693"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/translation/zipball/2d01ca0da3f092f91eeedb46f24aa30d2fca8f68",
-                "reference": "2d01ca0da3f092f91eeedb46f24aa30d2fca8f68",
+                "url": "https://api.github.com/repos/symfony/translation/zipball/b2bd012ca28c4acae830ee1206a5b6e35dd99693",
+                "reference": "b2bd012ca28c4acae830ee1206a5b6e35dd99693",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
-                "symfony/deprecation-contracts": "^2.5|^3",
-                "symfony/polyfill-mbstring": "~1.0",
-                "symfony/translation-contracts": "^2.5.3|^3.3"
+                "php": ">=8.4.1",
+                "symfony/polyfill-mbstring": "^1.0",
+                "symfony/translation-contracts": "^3.6.1"
             },
             "conflict": {
                 "nikic/php-parser": "<5.0",
-                "symfony/config": "<6.4",
-                "symfony/console": "<6.4",
-                "symfony/dependency-injection": "<6.4",
                 "symfony/http-client-contracts": "<2.5",
-                "symfony/http-kernel": "<6.4",
-                "symfony/service-contracts": "<2.5",
-                "symfony/twig-bundle": "<6.4",
-                "symfony/yaml": "<6.4"
+                "symfony/service-contracts": "<2.5"
             },
             "provide": {
                 "symfony/translation-implementation": "2.3|3.0"
@@ -5890,17 +6141,17 @@
             "require-dev": {
                 "nikic/php-parser": "^5.0",
                 "psr/log": "^1|^2|^3",
-                "symfony/config": "^6.4|^7.0|^8.0",
-                "symfony/console": "^6.4|^7.0|^8.0",
-                "symfony/dependency-injection": "^6.4|^7.0|^8.0",
-                "symfony/finder": "^6.4|^7.0|^8.0",
+                "symfony/config": "^7.4|^8.0",
+                "symfony/console": "^7.4|^8.0",
+                "symfony/dependency-injection": "^7.4|^8.0",
+                "symfony/finder": "^7.4|^8.0",
                 "symfony/http-client-contracts": "^2.5|^3.0",
-                "symfony/http-kernel": "^6.4|^7.0|^8.0",
-                "symfony/intl": "^6.4|^7.0|^8.0",
+                "symfony/http-kernel": "^7.4|^8.0",
+                "symfony/intl": "^7.4|^8.0",
                 "symfony/polyfill-intl-icu": "^1.21",
-                "symfony/routing": "^6.4|^7.0|^8.0",
+                "symfony/routing": "^7.4|^8.0",
                 "symfony/service-contracts": "^2.5|^3",
-                "symfony/yaml": "^6.4|^7.0|^8.0"
+                "symfony/yaml": "^7.4|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -5931,7 +6182,7 @@
             "description": "Provides tools to internationalize your application",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/translation/tree/v7.4.0"
+                "source": "https://github.com/symfony/translation/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -5951,20 +6202,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-11-27T13:27:24+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/translation-contracts",
-            "version": "v3.6.1",
+            "version": "v3.7.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/translation-contracts.git",
-                "reference": "65a8bc82080447fae78373aa10f8d13b38338977"
+                "reference": "0ab302977a952b42fd51475c4ebac81f8da0a95d"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/65a8bc82080447fae78373aa10f8d13b38338977",
-                "reference": "65a8bc82080447fae78373aa10f8d13b38338977",
+                "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/0ab302977a952b42fd51475c4ebac81f8da0a95d",
+                "reference": "0ab302977a952b42fd51475c4ebac81f8da0a95d",
                 "shasum": ""
             },
             "require": {
@@ -5977,7 +6228,7 @@
                     "name": "symfony/contracts"
                 },
                 "branch-alias": {
-                    "dev-main": "3.6-dev"
+                    "dev-main": "3.7-dev"
                 }
             },
             "autoload": {
@@ -6013,7 +6264,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/translation-contracts/tree/v3.6.1"
+                "source": "https://github.com/symfony/translation-contracts/tree/v3.7.0"
             },
             "funding": [
                 {
@@ -6033,28 +6284,28 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-07-15T13:41:35+00:00"
+            "time": "2026-01-05T13:30:16+00:00"
         },
         {
             "name": "symfony/uid",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/uid.git",
-                "reference": "2498e9f81b7baa206f44de583f2f48350b90142c"
+                "reference": "7393f157a55f7e70a4de0334435c55a5a8fe749a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/uid/zipball/2498e9f81b7baa206f44de583f2f48350b90142c",
-                "reference": "2498e9f81b7baa206f44de583f2f48350b90142c",
+                "url": "https://api.github.com/repos/symfony/uid/zipball/7393f157a55f7e70a4de0334435c55a5a8fe749a",
+                "reference": "7393f157a55f7e70a4de0334435c55a5a8fe749a",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
+                "php": ">=8.4.1",
                 "symfony/polyfill-uuid": "^1.15"
             },
             "require-dev": {
-                "symfony/console": "^6.4|^7.0|^8.0"
+                "symfony/console": "^7.4|^8.0"
             },
             "type": "library",
             "autoload": {
@@ -6091,7 +6342,7 @@
                 "uuid"
             ],
             "support": {
-                "source": "https://github.com/symfony/uid/tree/v7.4.0"
+                "source": "https://github.com/symfony/uid/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -6111,35 +6362,35 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-25T11:02:55+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
             "name": "symfony/var-dumper",
-            "version": "v7.4.0",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/var-dumper.git",
-                "reference": "41fd6c4ae28c38b294b42af6db61446594a0dece"
+                "reference": "c2c4df1d21477cc21c9f6dc1b14d07c3abc4963e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/var-dumper/zipball/41fd6c4ae28c38b294b42af6db61446594a0dece",
-                "reference": "41fd6c4ae28c38b294b42af6db61446594a0dece",
+                "url": "https://api.github.com/repos/symfony/var-dumper/zipball/c2c4df1d21477cc21c9f6dc1b14d07c3abc4963e",
+                "reference": "c2c4df1d21477cc21c9f6dc1b14d07c3abc4963e",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
-                "symfony/deprecation-contracts": "^2.5|^3",
-                "symfony/polyfill-mbstring": "~1.0"
+                "php": ">=8.4.1",
+                "symfony/polyfill-mbstring": "^1.0"
             },
             "conflict": {
-                "symfony/console": "<6.4"
+                "symfony/console": "<7.4",
+                "symfony/error-handler": "<7.4"
             },
             "require-dev": {
-                "symfony/console": "^6.4|^7.0|^8.0",
-                "symfony/http-kernel": "^6.4|^7.0|^8.0",
-                "symfony/process": "^6.4|^7.0|^8.0",
-                "symfony/uid": "^6.4|^7.0|^8.0",
+                "symfony/console": "^7.4|^8.0",
+                "symfony/http-kernel": "^7.4|^8.0",
+                "symfony/process": "^7.4|^8.0",
+                "symfony/uid": "^7.4|^8.0",
                 "twig/twig": "^3.12"
             },
             "bin": [
@@ -6178,7 +6429,7 @@
                 "dump"
             ],
             "support": {
-                "source": "https://github.com/symfony/var-dumper/tree/v7.4.0"
+                "source": "https://github.com/symfony/var-dumper/tree/v8.1.0"
             },
             "funding": [
                 {
@@ -6198,42 +6449,118 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-10-27T20:36:44+00:00"
+            "time": "2026-05-29T05:06:50+00:00"
         },
         {
-            "name": "tijsverkoyen/css-to-inline-styles",
-            "version": "v2.3.0",
+            "name": "symfony/yaml",
+            "version": "v8.1.0",
             "source": {
                 "type": "git",
-                "url": "https://github.com/tijsverkoyen/CssToInlineStyles.git",
-                "reference": "0d72ac1c00084279c1816675284073c5a337c20d"
+                "url": "https://github.com/symfony/yaml.git",
+                "reference": "efb42bd2c6f4f3ccfd4683583449938b5fc146b0"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/tijsverkoyen/CssToInlineStyles/zipball/0d72ac1c00084279c1816675284073c5a337c20d",
-                "reference": "0d72ac1c00084279c1816675284073c5a337c20d",
+                "url": "https://api.github.com/repos/symfony/yaml/zipball/efb42bd2c6f4f3ccfd4683583449938b5fc146b0",
+                "reference": "efb42bd2c6f4f3ccfd4683583449938b5fc146b0",
                 "shasum": ""
             },
             "require": {
-                "ext-dom": "*",
-                "ext-libxml": "*",
-                "php": "^7.4 || ^8.0",
-                "symfony/css-selector": "^5.4 || ^6.0 || ^7.0"
+                "php": ">=8.4.1",
+                "symfony/polyfill-ctype": "^1.8"
+            },
+            "conflict": {
+                "symfony/console": "<7.4"
             },
             "require-dev": {
-                "phpstan/phpstan": "^2.0",
-                "phpstan/phpstan-phpunit": "^2.0",
-                "phpunit/phpunit": "^8.5.21 || ^9.5.10"
+                "symfony/console": "^7.4|^8.0",
+                "yaml/yaml-test-suite": "*"
             },
+            "bin": [
+                "Resources/bin/yaml-lint"
+            ],
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "2.x-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
-                    "TijsVerkoyen\\CssToInlineStyles\\": "src"
+                    "Symfony\\Component\\Yaml\\": ""
+                },
+                "exclude-from-classmap": [
+                    "/Tests/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Fabien Potencier",
+                    "email": "fabien@symfony.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Loads and dumps YAML files",
+            "homepage": "https://symfony.com",
+            "support": {
+                "source": "https://github.com/symfony/yaml/tree/v8.1.0"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://github.com/nicolas-grekas",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2026-05-29T05:06:50+00:00"
+        },
+        {
+            "name": "tijsverkoyen/css-to-inline-styles",
+            "version": "v2.4.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/tijsverkoyen/CssToInlineStyles.git",
+                "reference": "f0292ccf0ec75843d65027214426b6b163b48b41"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/tijsverkoyen/CssToInlineStyles/zipball/f0292ccf0ec75843d65027214426b6b163b48b41",
+                "reference": "f0292ccf0ec75843d65027214426b6b163b48b41",
+                "shasum": ""
+            },
+            "require": {
+                "ext-dom": "*",
+                "ext-libxml": "*",
+                "php": "^7.4 || ^8.0",
+                "symfony/css-selector": "^5.4 || ^6.0 || ^7.0 || ^8.0"
+            },
+            "require-dev": {
+                "phpstan/phpstan": "^2.0",
+                "phpstan/phpstan-phpunit": "^2.0",
+                "phpunit/phpunit": "^8.5.21 || ^9.5.10"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "2.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "TijsVerkoyen\\CssToInlineStyles\\": "src"
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -6251,32 +6578,32 @@
             "homepage": "https://github.com/tijsverkoyen/CssToInlineStyles",
             "support": {
                 "issues": "https://github.com/tijsverkoyen/CssToInlineStyles/issues",
-                "source": "https://github.com/tijsverkoyen/CssToInlineStyles/tree/v2.3.0"
+                "source": "https://github.com/tijsverkoyen/CssToInlineStyles/tree/v2.4.0"
             },
-            "time": "2024-12-21T16:25:41+00:00"
+            "time": "2025-12-02T11:56:42+00:00"
         },
         {
             "name": "vlucas/phpdotenv",
-            "version": "v5.6.2",
+            "version": "v5.6.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/vlucas/phpdotenv.git",
-                "reference": "24ac4c74f91ee2c193fa1aaa5c249cb0822809af"
+                "reference": "955e7815d677a3eaa7075231212f2110983adecc"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/vlucas/phpdotenv/zipball/24ac4c74f91ee2c193fa1aaa5c249cb0822809af",
-                "reference": "24ac4c74f91ee2c193fa1aaa5c249cb0822809af",
+                "url": "https://api.github.com/repos/vlucas/phpdotenv/zipball/955e7815d677a3eaa7075231212f2110983adecc",
+                "reference": "955e7815d677a3eaa7075231212f2110983adecc",
                 "shasum": ""
             },
             "require": {
                 "ext-pcre": "*",
-                "graham-campbell/result-type": "^1.1.3",
+                "graham-campbell/result-type": "^1.1.4",
                 "php": "^7.2.5 || ^8.0",
-                "phpoption/phpoption": "^1.9.3",
-                "symfony/polyfill-ctype": "^1.24",
-                "symfony/polyfill-mbstring": "^1.24",
-                "symfony/polyfill-php80": "^1.24"
+                "phpoption/phpoption": "^1.9.5",
+                "symfony/polyfill-ctype": "^1.26",
+                "symfony/polyfill-mbstring": "^1.26",
+                "symfony/polyfill-php80": "^1.26"
             },
             "require-dev": {
                 "bamarni/composer-bin-plugin": "^1.8.2",
@@ -6325,7 +6652,7 @@
             ],
             "support": {
                 "issues": "https://github.com/vlucas/phpdotenv/issues",
-                "source": "https://github.com/vlucas/phpdotenv/tree/v5.6.2"
+                "source": "https://github.com/vlucas/phpdotenv/tree/v5.6.3"
             },
             "funding": [
                 {
@@ -6337,27 +6664,27 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-04-30T23:37:27+00:00"
+            "time": "2025-12-27T19:49:13+00:00"
         },
         {
             "name": "voku/portable-ascii",
-            "version": "2.0.3",
+            "version": "2.1.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/voku/portable-ascii.git",
-                "reference": "b1d923f88091c6bf09699efcd7c8a1b1bfd7351d"
+                "reference": "8e1051fe39379367aecf014f41744ce7539a856f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/voku/portable-ascii/zipball/b1d923f88091c6bf09699efcd7c8a1b1bfd7351d",
-                "reference": "b1d923f88091c6bf09699efcd7c8a1b1bfd7351d",
+                "url": "https://api.github.com/repos/voku/portable-ascii/zipball/8e1051fe39379367aecf014f41744ce7539a856f",
+                "reference": "8e1051fe39379367aecf014f41744ce7539a856f",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.0.0"
+                "php": ">=7.1.0"
             },
             "require-dev": {
-                "phpunit/phpunit": "~6.0 || ~7.0 || ~9.0"
+                "phpunit/phpunit": "~8.5 || ~9.6 || ~10.5 || ~11.5"
             },
             "suggest": {
                 "ext-intl": "Use Intl for transliterator_transliterate() support"
@@ -6387,7 +6714,7 @@
             ],
             "support": {
                 "issues": "https://github.com/voku/portable-ascii/issues",
-                "source": "https://github.com/voku/portable-ascii/tree/2.0.3"
+                "source": "https://github.com/voku/portable-ascii/tree/2.1.1"
             },
             "funding": [
                 {
@@ -6411,14 +6738,14 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-11-21T01:49:47+00:00"
+            "time": "2026-04-26T05:33:54+00:00"
         },
         {
             "name": "wowcrypto/wowcrypto",
             "version": "1.3.0",
             "source": {
                 "type": "git",
-                "url": "git@github.com:WoW-CMS/WowCrypto.git",
+                "url": "https://github.com/WoW-CMS/WowCrypto",
                 "reference": "05489e3d9dc70e9979b86b6cdf70d3d5b7ffc1a0"
             },
             "dist": {
@@ -6522,77 +6849,6 @@
             },
             "time": "2023-06-12T08:44:38+00:00"
         },
-        {
-            "name": "filp/whoops",
-            "version": "2.18.4",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/filp/whoops.git",
-                "reference": "d2102955e48b9fd9ab24280a7ad12ed552752c4d"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/filp/whoops/zipball/d2102955e48b9fd9ab24280a7ad12ed552752c4d",
-                "reference": "d2102955e48b9fd9ab24280a7ad12ed552752c4d",
-                "shasum": ""
-            },
-            "require": {
-                "php": "^7.1 || ^8.0",
-                "psr/log": "^1.0.1 || ^2.0 || ^3.0"
-            },
-            "require-dev": {
-                "mockery/mockery": "^1.0",
-                "phpunit/phpunit": "^7.5.20 || ^8.5.8 || ^9.3.3",
-                "symfony/var-dumper": "^4.0 || ^5.0"
-            },
-            "suggest": {
-                "symfony/var-dumper": "Pretty print complex values better with var-dumper available",
-                "whoops/soap": "Formats errors as SOAP responses"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "2.7-dev"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "Whoops\\": "src/Whoops/"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Filipe Dobreira",
-                    "homepage": "https://github.com/filp",
-                    "role": "Developer"
-                }
-            ],
-            "description": "php error handling for cool kids",
-            "homepage": "https://filp.github.io/whoops/",
-            "keywords": [
-                "error",
-                "exception",
-                "handling",
-                "library",
-                "throwable",
-                "whoops"
-            ],
-            "support": {
-                "issues": "https://github.com/filp/whoops/issues",
-                "source": "https://github.com/filp/whoops/tree/2.18.4"
-            },
-            "funding": [
-                {
-                    "url": "https://github.com/denis-sokolov",
-                    "type": "github"
-                }
-            ],
-            "time": "2025-08-08T12:00:00+00:00"
-        },
         {
             "name": "hamcrest/hamcrest-php",
             "version": "v2.1.1",
@@ -6646,37 +6902,38 @@
         },
         {
             "name": "laravel/pail",
-            "version": "v1.2.3",
+            "version": "v1.2.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/pail.git",
-                "reference": "8cc3d575c1f0e57eeb923f366a37528c50d2385a"
+                "reference": "2f7d27dada8effc48b8c424445a69cca7007daaa"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/pail/zipball/8cc3d575c1f0e57eeb923f366a37528c50d2385a",
-                "reference": "8cc3d575c1f0e57eeb923f366a37528c50d2385a",
+                "url": "https://api.github.com/repos/laravel/pail/zipball/2f7d27dada8effc48b8c424445a69cca7007daaa",
+                "reference": "2f7d27dada8effc48b8c424445a69cca7007daaa",
                 "shasum": ""
             },
             "require": {
                 "ext-mbstring": "*",
-                "illuminate/console": "^10.24|^11.0|^12.0",
-                "illuminate/contracts": "^10.24|^11.0|^12.0",
-                "illuminate/log": "^10.24|^11.0|^12.0",
-                "illuminate/process": "^10.24|^11.0|^12.0",
-                "illuminate/support": "^10.24|^11.0|^12.0",
+                "illuminate/console": "^10.24|^11.0|^12.0|^13.0",
+                "illuminate/contracts": "^10.24|^11.0|^12.0|^13.0",
+                "illuminate/log": "^10.24|^11.0|^12.0|^13.0",
+                "illuminate/process": "^10.24|^11.0|^12.0|^13.0",
+                "illuminate/support": "^10.24|^11.0|^12.0|^13.0",
                 "nunomaduro/termwind": "^1.15|^2.0",
                 "php": "^8.2",
-                "symfony/console": "^6.0|^7.0"
+                "symfony/console": "^6.0|^7.0|^8.0"
             },
             "require-dev": {
-                "laravel/framework": "^10.24|^11.0|^12.0",
+                "laravel/framework": "^10.24|^11.0|^12.0|^13.0",
                 "laravel/pint": "^1.13",
-                "orchestra/testbench-core": "^8.13|^9.0|^10.0",
-                "pestphp/pest": "^2.20|^3.0",
-                "pestphp/pest-plugin-type-coverage": "^2.3|^3.0",
+                "orchestra/testbench-core": "^8.13|^9.17|^10.8|^11.0",
+                "pestphp/pest": "^2.20|^3.0|^4.0",
+                "pestphp/pest-plugin-type-coverage": "^2.3|^3.0|^4.0",
                 "phpstan/phpstan": "^1.12.27",
-                "symfony/var-dumper": "^6.3|^7.0"
+                "symfony/var-dumper": "^6.3|^7.0|^8.0",
+                "symfony/yaml": "^6.3|^7.0|^8.0"
             },
             "type": "library",
             "extra": {
@@ -6721,7 +6978,7 @@
                 "issues": "https://github.com/laravel/pail/issues",
                 "source": "https://github.com/laravel/pail"
             },
-            "time": "2025-06-05T13:55:57+00:00"
+            "time": "2026-05-20T22:24:57+00:00"
         },
         {
             "name": "laravel/pint",
@@ -6791,29 +7048,29 @@
         },
         {
             "name": "laravel/sail",
-            "version": "v1.46.0",
+            "version": "v1.61.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/laravel/sail.git",
-                "reference": "eb90c4f113c4a9637b8fdd16e24cfc64f2b0ae6e"
+                "reference": "68ef35015630fe510432e63e11e21749006df688"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/laravel/sail/zipball/eb90c4f113c4a9637b8fdd16e24cfc64f2b0ae6e",
-                "reference": "eb90c4f113c4a9637b8fdd16e24cfc64f2b0ae6e",
+                "url": "https://api.github.com/repos/laravel/sail/zipball/68ef35015630fe510432e63e11e21749006df688",
+                "reference": "68ef35015630fe510432e63e11e21749006df688",
                 "shasum": ""
             },
             "require": {
-                "illuminate/console": "^9.52.16|^10.0|^11.0|^12.0",
-                "illuminate/contracts": "^9.52.16|^10.0|^11.0|^12.0",
-                "illuminate/support": "^9.52.16|^10.0|^11.0|^12.0",
+                "illuminate/console": "^9.52.16|^10.0|^11.0|^12.0|^13.0",
+                "illuminate/contracts": "^9.52.16|^10.0|^11.0|^12.0|^13.0",
+                "illuminate/support": "^9.52.16|^10.0|^11.0|^12.0|^13.0",
                 "php": "^8.0",
-                "symfony/console": "^6.0|^7.0",
-                "symfony/yaml": "^6.0|^7.0"
+                "symfony/console": "^6.0|^7.0|^8.0",
+                "symfony/yaml": "^6.0|^7.0|^8.0"
             },
             "require-dev": {
-                "orchestra/testbench": "^7.0|^8.0|^9.0|^10.0",
-                "phpstan/phpstan": "^1.10"
+                "orchestra/testbench": "^7.0|^8.0|^9.0|^10.0|^11.0",
+                "phpstan/phpstan": "^2.0"
             },
             "bin": [
                 "bin/sail"
@@ -6850,7 +7107,7 @@
                 "issues": "https://github.com/laravel/sail/issues",
                 "source": "https://github.com/laravel/sail"
             },
-            "time": "2025-09-23T13:44:39+00:00"
+            "time": "2026-05-23T23:33:57+00:00"
         },
         {
             "name": "mockery/mockery",
@@ -6995,103 +7252,6 @@
             ],
             "time": "2025-08-01T08:46:24+00:00"
         },
-        {
-            "name": "nunomaduro/collision",
-            "version": "v8.6.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/nunomaduro/collision.git",
-                "reference": "a94c0fb8f33da6a113cdc0eac936f7c42134de9d"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/nunomaduro/collision/zipball/a94c0fb8f33da6a113cdc0eac936f7c42134de9d",
-                "reference": "a94c0fb8f33da6a113cdc0eac936f7c42134de9d",
-                "shasum": ""
-            },
-            "require": {
-                "filp/whoops": "^2.16.0",
-                "nunomaduro/termwind": "^2.3.0",
-                "php": "^8.2.0",
-                "symfony/console": "^7.2.1"
-            },
-            "conflict": {
-                "laravel/framework": "<11.39.1 || >=13.0.0",
-                "phpunit/phpunit": "<11.5.3 || >=12.0.0"
-            },
-            "require-dev": {
-                "larastan/larastan": "^2.9.12",
-                "laravel/framework": "^11.39.1",
-                "laravel/pint": "^1.20.0",
-                "laravel/sail": "^1.40.0",
-                "laravel/sanctum": "^4.0.7",
-                "laravel/tinker": "^2.10.0",
-                "orchestra/testbench-core": "^9.9.2",
-                "pestphp/pest": "^2.36.0 || ^3.7.2",
-                "sebastian/environment": "^6.1.0 || ^7.2.0"
-            },
-            "type": "library",
-            "extra": {
-                "laravel": {
-                    "providers": [
-                        "NunoMaduro\\Collision\\Adapters\\Laravel\\CollisionServiceProvider"
-                    ]
-                },
-                "branch-alias": {
-                    "dev-8.x": "8.x-dev"
-                }
-            },
-            "autoload": {
-                "files": [
-                    "./src/Adapters/Phpunit/Autoload.php"
-                ],
-                "psr-4": {
-                    "NunoMaduro\\Collision\\": "src/"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Nuno Maduro",
-                    "email": "enunomaduro@gmail.com"
-                }
-            ],
-            "description": "Cli error handling for console/command-line PHP applications.",
-            "keywords": [
-                "artisan",
-                "cli",
-                "command-line",
-                "console",
-                "error",
-                "handling",
-                "laravel",
-                "laravel-zero",
-                "php",
-                "symfony"
-            ],
-            "support": {
-                "issues": "https://github.com/nunomaduro/collision/issues",
-                "source": "https://github.com/nunomaduro/collision"
-            },
-            "funding": [
-                {
-                    "url": "https://www.paypal.com/paypalme/enunomaduro",
-                    "type": "custom"
-                },
-                {
-                    "url": "https://github.com/nunomaduro",
-                    "type": "github"
-                },
-                {
-                    "url": "https://www.patreon.com/nunomaduro",
-                    "type": "patreon"
-                }
-            ],
-            "time": "2025-01-23T12:48:18+00:00"
-        },
         {
             "name": "phar-io/manifest",
             "version": "2.0.4",
@@ -7212,35 +7372,33 @@
         },
         {
             "name": "phpunit/php-code-coverage",
-            "version": "11.0.11",
+            "version": "12.5.6",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/php-code-coverage.git",
-                "reference": "4f7722aa9a7b76aa775e2d9d4e95d1ea16eeeef4"
+                "reference": "876099a072646c7745f673d7aeab5382c4439691"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/php-code-coverage/zipball/4f7722aa9a7b76aa775e2d9d4e95d1ea16eeeef4",
-                "reference": "4f7722aa9a7b76aa775e2d9d4e95d1ea16eeeef4",
+                "url": "https://api.github.com/repos/sebastianbergmann/php-code-coverage/zipball/876099a072646c7745f673d7aeab5382c4439691",
+                "reference": "876099a072646c7745f673d7aeab5382c4439691",
                 "shasum": ""
             },
             "require": {
                 "ext-dom": "*",
                 "ext-libxml": "*",
                 "ext-xmlwriter": "*",
-                "nikic/php-parser": "^5.4.0",
-                "php": ">=8.2",
-                "phpunit/php-file-iterator": "^5.1.0",
-                "phpunit/php-text-template": "^4.0.1",
-                "sebastian/code-unit-reverse-lookup": "^4.0.1",
-                "sebastian/complexity": "^4.0.1",
-                "sebastian/environment": "^7.2.0",
-                "sebastian/lines-of-code": "^3.0.1",
-                "sebastian/version": "^5.0.2",
-                "theseer/tokenizer": "^1.2.3"
+                "nikic/php-parser": "^5.7.0",
+                "php": ">=8.3",
+                "phpunit/php-text-template": "^5.0",
+                "sebastian/complexity": "^5.0",
+                "sebastian/environment": "^8.0.3",
+                "sebastian/lines-of-code": "^4.0",
+                "sebastian/version": "^6.0",
+                "theseer/tokenizer": "^2.0.1"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.5.2"
+                "phpunit/phpunit": "^12.5.1"
             },
             "suggest": {
                 "ext-pcov": "PHP extension that provides line coverage",
@@ -7249,7 +7407,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "11.0.x-dev"
+                    "dev-main": "12.5.x-dev"
                 }
             },
             "autoload": {
@@ -7278,7 +7436,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/php-code-coverage/issues",
                 "security": "https://github.com/sebastianbergmann/php-code-coverage/security/policy",
-                "source": "https://github.com/sebastianbergmann/php-code-coverage/tree/11.0.11"
+                "source": "https://github.com/sebastianbergmann/php-code-coverage/tree/12.5.6"
             },
             "funding": [
                 {
@@ -7298,32 +7456,32 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-08-27T14:37:49+00:00"
+            "time": "2026-04-15T08:23:17+00:00"
         },
         {
             "name": "phpunit/php-file-iterator",
-            "version": "5.1.0",
+            "version": "6.0.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/php-file-iterator.git",
-                "reference": "118cfaaa8bc5aef3287bf315b6060b1174754af6"
+                "reference": "3d1cd096ef6bea4bf2762ba586e35dbd317cbfd5"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/php-file-iterator/zipball/118cfaaa8bc5aef3287bf315b6060b1174754af6",
-                "reference": "118cfaaa8bc5aef3287bf315b6060b1174754af6",
+                "url": "https://api.github.com/repos/sebastianbergmann/php-file-iterator/zipball/3d1cd096ef6bea4bf2762ba586e35dbd317cbfd5",
+                "reference": "3d1cd096ef6bea4bf2762ba586e35dbd317cbfd5",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.3"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.0"
+                "phpunit/phpunit": "^12.0"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "5.0-dev"
+                    "dev-main": "6.0-dev"
                 }
             },
             "autoload": {
@@ -7351,36 +7509,48 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/php-file-iterator/issues",
                 "security": "https://github.com/sebastianbergmann/php-file-iterator/security/policy",
-                "source": "https://github.com/sebastianbergmann/php-file-iterator/tree/5.1.0"
+                "source": "https://github.com/sebastianbergmann/php-file-iterator/tree/6.0.1"
             },
             "funding": [
                 {
                     "url": "https://github.com/sebastianbergmann",
                     "type": "github"
+                },
+                {
+                    "url": "https://liberapay.com/sebastianbergmann",
+                    "type": "liberapay"
+                },
+                {
+                    "url": "https://thanks.dev/u/gh/sebastianbergmann",
+                    "type": "thanks_dev"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/phpunit/php-file-iterator",
+                    "type": "tidelift"
                 }
             ],
-            "time": "2024-08-27T05:02:59+00:00"
+            "time": "2026-02-02T14:04:18+00:00"
         },
         {
             "name": "phpunit/php-invoker",
-            "version": "5.0.1",
+            "version": "6.0.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/php-invoker.git",
-                "reference": "c1ca3814734c07492b3d4c5f794f4b0995333da2"
+                "reference": "12b54e689b07a25a9b41e57736dfab6ec9ae5406"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/php-invoker/zipball/c1ca3814734c07492b3d4c5f794f4b0995333da2",
-                "reference": "c1ca3814734c07492b3d4c5f794f4b0995333da2",
+                "url": "https://api.github.com/repos/sebastianbergmann/php-invoker/zipball/12b54e689b07a25a9b41e57736dfab6ec9ae5406",
+                "reference": "12b54e689b07a25a9b41e57736dfab6ec9ae5406",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.3"
             },
             "require-dev": {
                 "ext-pcntl": "*",
-                "phpunit/phpunit": "^11.0"
+                "phpunit/phpunit": "^12.0"
             },
             "suggest": {
                 "ext-pcntl": "*"
@@ -7388,7 +7558,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "5.0-dev"
+                    "dev-main": "6.0-dev"
                 }
             },
             "autoload": {
@@ -7415,7 +7585,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/php-invoker/issues",
                 "security": "https://github.com/sebastianbergmann/php-invoker/security/policy",
-                "source": "https://github.com/sebastianbergmann/php-invoker/tree/5.0.1"
+                "source": "https://github.com/sebastianbergmann/php-invoker/tree/6.0.0"
             },
             "funding": [
                 {
@@ -7423,32 +7593,32 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-07-03T05:07:44+00:00"
+            "time": "2025-02-07T04:58:58+00:00"
         },
         {
             "name": "phpunit/php-text-template",
-            "version": "4.0.1",
+            "version": "5.0.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/php-text-template.git",
-                "reference": "3e0404dc6b300e6bf56415467ebcb3fe4f33e964"
+                "reference": "e1367a453f0eda562eedb4f659e13aa900d66c53"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/php-text-template/zipball/3e0404dc6b300e6bf56415467ebcb3fe4f33e964",
-                "reference": "3e0404dc6b300e6bf56415467ebcb3fe4f33e964",
+                "url": "https://api.github.com/repos/sebastianbergmann/php-text-template/zipball/e1367a453f0eda562eedb4f659e13aa900d66c53",
+                "reference": "e1367a453f0eda562eedb4f659e13aa900d66c53",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.3"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.0"
+                "phpunit/phpunit": "^12.0"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "4.0-dev"
+                    "dev-main": "5.0-dev"
                 }
             },
             "autoload": {
@@ -7475,7 +7645,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/php-text-template/issues",
                 "security": "https://github.com/sebastianbergmann/php-text-template/security/policy",
-                "source": "https://github.com/sebastianbergmann/php-text-template/tree/4.0.1"
+                "source": "https://github.com/sebastianbergmann/php-text-template/tree/5.0.0"
             },
             "funding": [
                 {
@@ -7483,32 +7653,32 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-07-03T05:08:43+00:00"
+            "time": "2025-02-07T04:59:16+00:00"
         },
         {
             "name": "phpunit/php-timer",
-            "version": "7.0.1",
+            "version": "8.0.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/php-timer.git",
-                "reference": "3b415def83fbcb41f991d9ebf16ae4ad8b7837b3"
+                "reference": "f258ce36aa457f3aa3339f9ed4c81fc66dc8c2cc"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/php-timer/zipball/3b415def83fbcb41f991d9ebf16ae4ad8b7837b3",
-                "reference": "3b415def83fbcb41f991d9ebf16ae4ad8b7837b3",
+                "url": "https://api.github.com/repos/sebastianbergmann/php-timer/zipball/f258ce36aa457f3aa3339f9ed4c81fc66dc8c2cc",
+                "reference": "f258ce36aa457f3aa3339f9ed4c81fc66dc8c2cc",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.3"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.0"
+                "phpunit/phpunit": "^12.0"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "7.0-dev"
+                    "dev-main": "8.0-dev"
                 }
             },
             "autoload": {
@@ -7535,7 +7705,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/php-timer/issues",
                 "security": "https://github.com/sebastianbergmann/php-timer/security/policy",
-                "source": "https://github.com/sebastianbergmann/php-timer/tree/7.0.1"
+                "source": "https://github.com/sebastianbergmann/php-timer/tree/8.0.0"
             },
             "funding": [
                 {
@@ -7543,20 +7713,20 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-07-03T05:09:35+00:00"
+            "time": "2025-02-07T04:59:38+00:00"
         },
         {
             "name": "phpunit/phpunit",
-            "version": "11.5.3",
+            "version": "12.5.28",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/phpunit.git",
-                "reference": "30e319e578a7b5da3543073e30002bf82042f701"
+                "reference": "5895d05f5bf421ed230fbd76e1277e4b8955def4"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/phpunit/zipball/30e319e578a7b5da3543073e30002bf82042f701",
-                "reference": "30e319e578a7b5da3543073e30002bf82042f701",
+                "url": "https://api.github.com/repos/sebastianbergmann/phpunit/zipball/5895d05f5bf421ed230fbd76e1277e4b8955def4",
+                "reference": "5895d05f5bf421ed230fbd76e1277e4b8955def4",
                 "shasum": ""
             },
             "require": {
@@ -7566,37 +7736,34 @@
                 "ext-mbstring": "*",
                 "ext-xml": "*",
                 "ext-xmlwriter": "*",
-                "myclabs/deep-copy": "^1.12.1",
+                "myclabs/deep-copy": "^1.13.4",
                 "phar-io/manifest": "^2.0.4",
                 "phar-io/version": "^3.2.1",
-                "php": ">=8.2",
-                "phpunit/php-code-coverage": "^11.0.8",
-                "phpunit/php-file-iterator": "^5.1.0",
-                "phpunit/php-invoker": "^5.0.1",
-                "phpunit/php-text-template": "^4.0.1",
-                "phpunit/php-timer": "^7.0.1",
-                "sebastian/cli-parser": "^3.0.2",
-                "sebastian/code-unit": "^3.0.2",
-                "sebastian/comparator": "^6.3.0",
-                "sebastian/diff": "^6.0.2",
-                "sebastian/environment": "^7.2.0",
-                "sebastian/exporter": "^6.3.0",
-                "sebastian/global-state": "^7.0.2",
-                "sebastian/object-enumerator": "^6.0.1",
-                "sebastian/type": "^5.1.0",
-                "sebastian/version": "^5.0.2",
+                "php": ">=8.3",
+                "phpunit/php-code-coverage": "^12.5.6",
+                "phpunit/php-file-iterator": "^6.0.1",
+                "phpunit/php-invoker": "^6.0.0",
+                "phpunit/php-text-template": "^5.0.0",
+                "phpunit/php-timer": "^8.0.0",
+                "sebastian/cli-parser": "^4.2.1",
+                "sebastian/comparator": "^7.1.8",
+                "sebastian/diff": "^7.0.0",
+                "sebastian/environment": "^8.1.2",
+                "sebastian/exporter": "^7.0.3",
+                "sebastian/global-state": "^8.0.2",
+                "sebastian/object-enumerator": "^7.0.0",
+                "sebastian/recursion-context": "^7.0.1",
+                "sebastian/type": "^6.0.4",
+                "sebastian/version": "^6.0.0",
                 "staabm/side-effects-detector": "^1.0.5"
             },
-            "suggest": {
-                "ext-soap": "To be able to generate mocks based on WSDL files"
-            },
             "bin": [
                 "phpunit"
             ],
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "11.5-dev"
+                    "dev-main": "12.5-dev"
                 }
             },
             "autoload": {
@@ -7628,48 +7795,40 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/phpunit/issues",
                 "security": "https://github.com/sebastianbergmann/phpunit/security/policy",
-                "source": "https://github.com/sebastianbergmann/phpunit/tree/11.5.3"
+                "source": "https://github.com/sebastianbergmann/phpunit/tree/12.5.28"
             },
             "funding": [
                 {
-                    "url": "https://phpunit.de/sponsors.html",
-                    "type": "custom"
-                },
-                {
-                    "url": "https://github.com/sebastianbergmann",
-                    "type": "github"
-                },
-                {
-                    "url": "https://tidelift.com/funding/github/packagist/phpunit/phpunit",
-                    "type": "tidelift"
+                    "url": "https://phpunit.de/sponsoring.html",
+                    "type": "other"
                 }
             ],
-            "time": "2025-01-13T09:36:00+00:00"
+            "time": "2026-05-27T14:01:10+00:00"
         },
         {
             "name": "sebastian/cli-parser",
-            "version": "3.0.2",
+            "version": "4.2.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/cli-parser.git",
-                "reference": "15c5dd40dc4f38794d383bb95465193f5e0ae180"
+                "reference": "7d05781b13f7dec9043a629a21d086ed74582a15"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/cli-parser/zipball/15c5dd40dc4f38794d383bb95465193f5e0ae180",
-                "reference": "15c5dd40dc4f38794d383bb95465193f5e0ae180",
+                "url": "https://api.github.com/repos/sebastianbergmann/cli-parser/zipball/7d05781b13f7dec9043a629a21d086ed74582a15",
+                "reference": "7d05781b13f7dec9043a629a21d086ed74582a15",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.3"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.0"
+                "phpunit/phpunit": "^12.5.25"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "3.0-dev"
+                    "dev-main": "4.2-dev"
                 }
             },
             "autoload": {
@@ -7693,152 +7852,51 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/cli-parser/issues",
                 "security": "https://github.com/sebastianbergmann/cli-parser/security/policy",
-                "source": "https://github.com/sebastianbergmann/cli-parser/tree/3.0.2"
+                "source": "https://github.com/sebastianbergmann/cli-parser/tree/4.2.1"
             },
             "funding": [
                 {
                     "url": "https://github.com/sebastianbergmann",
                     "type": "github"
-                }
-            ],
-            "time": "2024-07-03T04:41:36+00:00"
-        },
-        {
-            "name": "sebastian/code-unit",
-            "version": "3.0.3",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/sebastianbergmann/code-unit.git",
-                "reference": "54391c61e4af8078e5b276ab082b6d3c54c9ad64"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/code-unit/zipball/54391c61e4af8078e5b276ab082b6d3c54c9ad64",
-                "reference": "54391c61e4af8078e5b276ab082b6d3c54c9ad64",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=8.2"
-            },
-            "require-dev": {
-                "phpunit/phpunit": "^11.5"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-main": "3.0-dev"
-                }
-            },
-            "autoload": {
-                "classmap": [
-                    "src/"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "BSD-3-Clause"
-            ],
-            "authors": [
-                {
-                    "name": "Sebastian Bergmann",
-                    "email": "sebastian@phpunit.de",
-                    "role": "lead"
-                }
-            ],
-            "description": "Collection of value objects that represent the PHP code units",
-            "homepage": "https://github.com/sebastianbergmann/code-unit",
-            "support": {
-                "issues": "https://github.com/sebastianbergmann/code-unit/issues",
-                "security": "https://github.com/sebastianbergmann/code-unit/security/policy",
-                "source": "https://github.com/sebastianbergmann/code-unit/tree/3.0.3"
-            },
-            "funding": [
+                },
                 {
-                    "url": "https://github.com/sebastianbergmann",
-                    "type": "github"
-                }
-            ],
-            "time": "2025-03-19T07:56:08+00:00"
-        },
-        {
-            "name": "sebastian/code-unit-reverse-lookup",
-            "version": "4.0.1",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/sebastianbergmann/code-unit-reverse-lookup.git",
-                "reference": "183a9b2632194febd219bb9246eee421dad8d45e"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/code-unit-reverse-lookup/zipball/183a9b2632194febd219bb9246eee421dad8d45e",
-                "reference": "183a9b2632194febd219bb9246eee421dad8d45e",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=8.2"
-            },
-            "require-dev": {
-                "phpunit/phpunit": "^11.0"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-main": "4.0-dev"
-                }
-            },
-            "autoload": {
-                "classmap": [
-                    "src/"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "BSD-3-Clause"
-            ],
-            "authors": [
+                    "url": "https://liberapay.com/sebastianbergmann",
+                    "type": "liberapay"
+                },
                 {
-                    "name": "Sebastian Bergmann",
-                    "email": "sebastian@phpunit.de"
-                }
-            ],
-            "description": "Looks up which function or method a line of code belongs to",
-            "homepage": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/",
-            "support": {
-                "issues": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/issues",
-                "security": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/security/policy",
-                "source": "https://github.com/sebastianbergmann/code-unit-reverse-lookup/tree/4.0.1"
-            },
-            "funding": [
+                    "url": "https://thanks.dev/u/gh/sebastianbergmann",
+                    "type": "thanks_dev"
+                },
                 {
-                    "url": "https://github.com/sebastianbergmann",
-                    "type": "github"
+                    "url": "https://tidelift.com/funding/github/packagist/sebastian/cli-parser",
+                    "type": "tidelift"
                 }
             ],
-            "time": "2024-07-03T04:45:54+00:00"
+            "time": "2026-05-17T05:29:34+00:00"
         },
         {
             "name": "sebastian/comparator",
-            "version": "6.3.2",
+            "version": "7.1.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/comparator.git",
-                "reference": "85c77556683e6eee4323e4c5468641ca0237e2e8"
+                "reference": "7c65c1e79836812819705b473a90c12399542485"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/comparator/zipball/85c77556683e6eee4323e4c5468641ca0237e2e8",
-                "reference": "85c77556683e6eee4323e4c5468641ca0237e2e8",
+                "url": "https://api.github.com/repos/sebastianbergmann/comparator/zipball/7c65c1e79836812819705b473a90c12399542485",
+                "reference": "7c65c1e79836812819705b473a90c12399542485",
                 "shasum": ""
             },
             "require": {
                 "ext-dom": "*",
                 "ext-mbstring": "*",
-                "php": ">=8.2",
-                "sebastian/diff": "^6.0",
-                "sebastian/exporter": "^6.0"
+                "php": ">=8.3",
+                "sebastian/diff": "^7.0",
+                "sebastian/exporter": "^7.0.3"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.4"
+                "phpunit/phpunit": "^12.5.25"
             },
             "suggest": {
                 "ext-bcmath": "For comparing BcMath\\Number objects"
@@ -7846,7 +7904,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "6.3-dev"
+                    "dev-main": "7.1-dev"
                 }
             },
             "autoload": {
@@ -7886,7 +7944,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/comparator/issues",
                 "security": "https://github.com/sebastianbergmann/comparator/security/policy",
-                "source": "https://github.com/sebastianbergmann/comparator/tree/6.3.2"
+                "source": "https://github.com/sebastianbergmann/comparator/tree/7.1.8"
             },
             "funding": [
                 {
@@ -7906,33 +7964,33 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-08-10T08:07:46+00:00"
+            "time": "2026-05-21T04:45:25+00:00"
         },
         {
             "name": "sebastian/complexity",
-            "version": "4.0.1",
+            "version": "5.0.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/complexity.git",
-                "reference": "ee41d384ab1906c68852636b6de493846e13e5a0"
+                "reference": "bad4316aba5303d0221f43f8cee37eb58d384bbb"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/complexity/zipball/ee41d384ab1906c68852636b6de493846e13e5a0",
-                "reference": "ee41d384ab1906c68852636b6de493846e13e5a0",
+                "url": "https://api.github.com/repos/sebastianbergmann/complexity/zipball/bad4316aba5303d0221f43f8cee37eb58d384bbb",
+                "reference": "bad4316aba5303d0221f43f8cee37eb58d384bbb",
                 "shasum": ""
             },
             "require": {
                 "nikic/php-parser": "^5.0",
-                "php": ">=8.2"
+                "php": ">=8.3"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.0"
+                "phpunit/phpunit": "^12.0"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "4.0-dev"
+                    "dev-main": "5.0-dev"
                 }
             },
             "autoload": {
@@ -7956,7 +8014,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/complexity/issues",
                 "security": "https://github.com/sebastianbergmann/complexity/security/policy",
-                "source": "https://github.com/sebastianbergmann/complexity/tree/4.0.1"
+                "source": "https://github.com/sebastianbergmann/complexity/tree/5.0.0"
             },
             "funding": [
                 {
@@ -7964,33 +8022,33 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-07-03T04:49:50+00:00"
+            "time": "2025-02-07T04:55:25+00:00"
         },
         {
             "name": "sebastian/diff",
-            "version": "6.0.2",
+            "version": "7.0.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/diff.git",
-                "reference": "b4ccd857127db5d41a5b676f24b51371d76d8544"
+                "reference": "7ab1ea946c012266ca32390913653d844ecd085f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/diff/zipball/b4ccd857127db5d41a5b676f24b51371d76d8544",
-                "reference": "b4ccd857127db5d41a5b676f24b51371d76d8544",
+                "url": "https://api.github.com/repos/sebastianbergmann/diff/zipball/7ab1ea946c012266ca32390913653d844ecd085f",
+                "reference": "7ab1ea946c012266ca32390913653d844ecd085f",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.3"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.0",
-                "symfony/process": "^4.2 || ^5"
+                "phpunit/phpunit": "^12.0",
+                "symfony/process": "^7.2"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "6.0-dev"
+                    "dev-main": "7.0-dev"
                 }
             },
             "autoload": {
@@ -8023,7 +8081,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/diff/issues",
                 "security": "https://github.com/sebastianbergmann/diff/security/policy",
-                "source": "https://github.com/sebastianbergmann/diff/tree/6.0.2"
+                "source": "https://github.com/sebastianbergmann/diff/tree/7.0.0"
             },
             "funding": [
                 {
@@ -8031,27 +8089,27 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-07-03T04:53:05+00:00"
+            "time": "2025-02-07T04:55:46+00:00"
         },
         {
             "name": "sebastian/environment",
-            "version": "7.2.1",
+            "version": "8.1.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/environment.git",
-                "reference": "a5c75038693ad2e8d4b6c15ba2403532647830c4"
+                "reference": "9d32c685773823b1983e256ae4ecd48a10d6e439"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/environment/zipball/a5c75038693ad2e8d4b6c15ba2403532647830c4",
-                "reference": "a5c75038693ad2e8d4b6c15ba2403532647830c4",
+                "url": "https://api.github.com/repos/sebastianbergmann/environment/zipball/9d32c685773823b1983e256ae4ecd48a10d6e439",
+                "reference": "9d32c685773823b1983e256ae4ecd48a10d6e439",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.3"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.3"
+                "phpunit/phpunit": "^12.5.26"
             },
             "suggest": {
                 "ext-posix": "*"
@@ -8059,7 +8117,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "7.2-dev"
+                    "dev-main": "8.1-dev"
                 }
             },
             "autoload": {
@@ -8087,7 +8145,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/environment/issues",
                 "security": "https://github.com/sebastianbergmann/environment/security/policy",
-                "source": "https://github.com/sebastianbergmann/environment/tree/7.2.1"
+                "source": "https://github.com/sebastianbergmann/environment/tree/8.1.2"
             },
             "funding": [
                 {
@@ -8107,34 +8165,34 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-05-21T11:55:47+00:00"
+            "time": "2026-05-25T13:40:20+00:00"
         },
         {
             "name": "sebastian/exporter",
-            "version": "6.3.2",
+            "version": "7.0.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/exporter.git",
-                "reference": "70a298763b40b213ec087c51c739efcaa90bcd74"
+                "reference": "c5e21b5de653ce0a769fb36f5cdfcb5e7a32cf23"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/exporter/zipball/70a298763b40b213ec087c51c739efcaa90bcd74",
-                "reference": "70a298763b40b213ec087c51c739efcaa90bcd74",
+                "url": "https://api.github.com/repos/sebastianbergmann/exporter/zipball/c5e21b5de653ce0a769fb36f5cdfcb5e7a32cf23",
+                "reference": "c5e21b5de653ce0a769fb36f5cdfcb5e7a32cf23",
                 "shasum": ""
             },
             "require": {
                 "ext-mbstring": "*",
-                "php": ">=8.2",
-                "sebastian/recursion-context": "^6.0"
+                "php": ">=8.3",
+                "sebastian/recursion-context": "^7.0.1"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.3"
+                "phpunit/phpunit": "^12.5.25"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "6.3-dev"
+                    "dev-main": "7.0-dev"
                 }
             },
             "autoload": {
@@ -8177,7 +8235,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/exporter/issues",
                 "security": "https://github.com/sebastianbergmann/exporter/security/policy",
-                "source": "https://github.com/sebastianbergmann/exporter/tree/6.3.2"
+                "source": "https://github.com/sebastianbergmann/exporter/tree/7.0.3"
             },
             "funding": [
                 {
@@ -8197,35 +8255,35 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-09-24T06:12:51+00:00"
+            "time": "2026-05-20T04:37:17+00:00"
         },
         {
             "name": "sebastian/global-state",
-            "version": "7.0.2",
+            "version": "8.0.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/global-state.git",
-                "reference": "3be331570a721f9a4b5917f4209773de17f747d7"
+                "reference": "ef1377171613d09edd25b7816f05be8313f9115d"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/global-state/zipball/3be331570a721f9a4b5917f4209773de17f747d7",
-                "reference": "3be331570a721f9a4b5917f4209773de17f747d7",
+                "url": "https://api.github.com/repos/sebastianbergmann/global-state/zipball/ef1377171613d09edd25b7816f05be8313f9115d",
+                "reference": "ef1377171613d09edd25b7816f05be8313f9115d",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
-                "sebastian/object-reflector": "^4.0",
-                "sebastian/recursion-context": "^6.0"
+                "php": ">=8.3",
+                "sebastian/object-reflector": "^5.0",
+                "sebastian/recursion-context": "^7.0"
             },
             "require-dev": {
                 "ext-dom": "*",
-                "phpunit/phpunit": "^11.0"
+                "phpunit/phpunit": "^12.0"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "7.0-dev"
+                    "dev-main": "8.0-dev"
                 }
             },
             "autoload": {
@@ -8251,41 +8309,53 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/global-state/issues",
                 "security": "https://github.com/sebastianbergmann/global-state/security/policy",
-                "source": "https://github.com/sebastianbergmann/global-state/tree/7.0.2"
+                "source": "https://github.com/sebastianbergmann/global-state/tree/8.0.2"
             },
             "funding": [
                 {
                     "url": "https://github.com/sebastianbergmann",
                     "type": "github"
+                },
+                {
+                    "url": "https://liberapay.com/sebastianbergmann",
+                    "type": "liberapay"
+                },
+                {
+                    "url": "https://thanks.dev/u/gh/sebastianbergmann",
+                    "type": "thanks_dev"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/sebastian/global-state",
+                    "type": "tidelift"
                 }
             ],
-            "time": "2024-07-03T04:57:36+00:00"
+            "time": "2025-08-29T11:29:25+00:00"
         },
         {
             "name": "sebastian/lines-of-code",
-            "version": "3.0.1",
+            "version": "4.0.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/lines-of-code.git",
-                "reference": "d36ad0d782e5756913e42ad87cb2890f4ffe467a"
+                "reference": "d543b8ef219dcd8da262cbb958639a96bedba10e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/lines-of-code/zipball/d36ad0d782e5756913e42ad87cb2890f4ffe467a",
-                "reference": "d36ad0d782e5756913e42ad87cb2890f4ffe467a",
+                "url": "https://api.github.com/repos/sebastianbergmann/lines-of-code/zipball/d543b8ef219dcd8da262cbb958639a96bedba10e",
+                "reference": "d543b8ef219dcd8da262cbb958639a96bedba10e",
                 "shasum": ""
             },
             "require": {
-                "nikic/php-parser": "^5.0",
-                "php": ">=8.2"
+                "nikic/php-parser": "^5.7.0",
+                "php": ">=8.3"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.0"
+                "phpunit/phpunit": "^12.5.25"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "3.0-dev"
+                    "dev-main": "4.0-dev"
                 }
             },
             "autoload": {
@@ -8309,42 +8379,54 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/lines-of-code/issues",
                 "security": "https://github.com/sebastianbergmann/lines-of-code/security/policy",
-                "source": "https://github.com/sebastianbergmann/lines-of-code/tree/3.0.1"
+                "source": "https://github.com/sebastianbergmann/lines-of-code/tree/4.0.1"
             },
             "funding": [
                 {
                     "url": "https://github.com/sebastianbergmann",
                     "type": "github"
+                },
+                {
+                    "url": "https://liberapay.com/sebastianbergmann",
+                    "type": "liberapay"
+                },
+                {
+                    "url": "https://thanks.dev/u/gh/sebastianbergmann",
+                    "type": "thanks_dev"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/sebastian/lines-of-code",
+                    "type": "tidelift"
                 }
             ],
-            "time": "2024-07-03T04:58:38+00:00"
+            "time": "2026-05-19T16:22:07+00:00"
         },
         {
             "name": "sebastian/object-enumerator",
-            "version": "6.0.1",
+            "version": "7.0.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/object-enumerator.git",
-                "reference": "f5b498e631a74204185071eb41f33f38d64608aa"
+                "reference": "1effe8e9b8e068e9ae228e542d5d11b5d16db894"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/object-enumerator/zipball/f5b498e631a74204185071eb41f33f38d64608aa",
-                "reference": "f5b498e631a74204185071eb41f33f38d64608aa",
+                "url": "https://api.github.com/repos/sebastianbergmann/object-enumerator/zipball/1effe8e9b8e068e9ae228e542d5d11b5d16db894",
+                "reference": "1effe8e9b8e068e9ae228e542d5d11b5d16db894",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2",
-                "sebastian/object-reflector": "^4.0",
-                "sebastian/recursion-context": "^6.0"
+                "php": ">=8.3",
+                "sebastian/object-reflector": "^5.0",
+                "sebastian/recursion-context": "^7.0"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.0"
+                "phpunit/phpunit": "^12.0"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "6.0-dev"
+                    "dev-main": "7.0-dev"
                 }
             },
             "autoload": {
@@ -8367,7 +8449,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/object-enumerator/issues",
                 "security": "https://github.com/sebastianbergmann/object-enumerator/security/policy",
-                "source": "https://github.com/sebastianbergmann/object-enumerator/tree/6.0.1"
+                "source": "https://github.com/sebastianbergmann/object-enumerator/tree/7.0.0"
             },
             "funding": [
                 {
@@ -8375,32 +8457,32 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-07-03T05:00:13+00:00"
+            "time": "2025-02-07T04:57:48+00:00"
         },
         {
             "name": "sebastian/object-reflector",
-            "version": "4.0.1",
+            "version": "5.0.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/object-reflector.git",
-                "reference": "6e1a43b411b2ad34146dee7524cb13a068bb35f9"
+                "reference": "4bfa827c969c98be1e527abd576533293c634f6a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/object-reflector/zipball/6e1a43b411b2ad34146dee7524cb13a068bb35f9",
-                "reference": "6e1a43b411b2ad34146dee7524cb13a068bb35f9",
+                "url": "https://api.github.com/repos/sebastianbergmann/object-reflector/zipball/4bfa827c969c98be1e527abd576533293c634f6a",
+                "reference": "4bfa827c969c98be1e527abd576533293c634f6a",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.3"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.0"
+                "phpunit/phpunit": "^12.0"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "4.0-dev"
+                    "dev-main": "5.0-dev"
                 }
             },
             "autoload": {
@@ -8423,7 +8505,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/object-reflector/issues",
                 "security": "https://github.com/sebastianbergmann/object-reflector/security/policy",
-                "source": "https://github.com/sebastianbergmann/object-reflector/tree/4.0.1"
+                "source": "https://github.com/sebastianbergmann/object-reflector/tree/5.0.0"
             },
             "funding": [
                 {
@@ -8431,32 +8513,32 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-07-03T05:01:32+00:00"
+            "time": "2025-02-07T04:58:17+00:00"
         },
         {
             "name": "sebastian/recursion-context",
-            "version": "6.0.3",
+            "version": "7.0.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/recursion-context.git",
-                "reference": "f6458abbf32a6c8174f8f26261475dc133b3d9dc"
+                "reference": "0b01998a7d5b1f122911a66bebcb8d46f0c82d8c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/recursion-context/zipball/f6458abbf32a6c8174f8f26261475dc133b3d9dc",
-                "reference": "f6458abbf32a6c8174f8f26261475dc133b3d9dc",
+                "url": "https://api.github.com/repos/sebastianbergmann/recursion-context/zipball/0b01998a7d5b1f122911a66bebcb8d46f0c82d8c",
+                "reference": "0b01998a7d5b1f122911a66bebcb8d46f0c82d8c",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.3"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.3"
+                "phpunit/phpunit": "^12.0"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "6.0-dev"
+                    "dev-main": "7.0-dev"
                 }
             },
             "autoload": {
@@ -8487,7 +8569,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/recursion-context/issues",
                 "security": "https://github.com/sebastianbergmann/recursion-context/security/policy",
-                "source": "https://github.com/sebastianbergmann/recursion-context/tree/6.0.3"
+                "source": "https://github.com/sebastianbergmann/recursion-context/tree/7.0.1"
             },
             "funding": [
                 {
@@ -8507,32 +8589,32 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-08-13T04:42:22+00:00"
+            "time": "2025-08-13T04:44:59+00:00"
         },
         {
             "name": "sebastian/type",
-            "version": "5.1.3",
+            "version": "6.0.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/type.git",
-                "reference": "f77d2d4e78738c98d9a68d2596fe5e8fa380f449"
+                "reference": "82ff822c2edc46724be9f7411d3163021f602773"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/type/zipball/f77d2d4e78738c98d9a68d2596fe5e8fa380f449",
-                "reference": "f77d2d4e78738c98d9a68d2596fe5e8fa380f449",
+                "url": "https://api.github.com/repos/sebastianbergmann/type/zipball/82ff822c2edc46724be9f7411d3163021f602773",
+                "reference": "82ff822c2edc46724be9f7411d3163021f602773",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.3"
             },
             "require-dev": {
-                "phpunit/phpunit": "^11.3"
+                "phpunit/phpunit": "^12.5.25"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "5.1-dev"
+                    "dev-main": "6.0-dev"
                 }
             },
             "autoload": {
@@ -8556,7 +8638,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/type/issues",
                 "security": "https://github.com/sebastianbergmann/type/security/policy",
-                "source": "https://github.com/sebastianbergmann/type/tree/5.1.3"
+                "source": "https://github.com/sebastianbergmann/type/tree/6.0.4"
             },
             "funding": [
                 {
@@ -8576,29 +8658,29 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-08-09T06:55:48+00:00"
+            "time": "2026-05-20T06:45:45+00:00"
         },
         {
             "name": "sebastian/version",
-            "version": "5.0.2",
+            "version": "6.0.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/sebastianbergmann/version.git",
-                "reference": "c687e3387b99f5b03b6caa64c74b63e2936ff874"
+                "reference": "3e6ccf7657d4f0a59200564b08cead899313b53c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/sebastianbergmann/version/zipball/c687e3387b99f5b03b6caa64c74b63e2936ff874",
-                "reference": "c687e3387b99f5b03b6caa64c74b63e2936ff874",
+                "url": "https://api.github.com/repos/sebastianbergmann/version/zipball/3e6ccf7657d4f0a59200564b08cead899313b53c",
+                "reference": "3e6ccf7657d4f0a59200564b08cead899313b53c",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.2"
+                "php": ">=8.3"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "5.0-dev"
+                    "dev-main": "6.0-dev"
                 }
             },
             "autoload": {
@@ -8622,7 +8704,7 @@
             "support": {
                 "issues": "https://github.com/sebastianbergmann/version/issues",
                 "security": "https://github.com/sebastianbergmann/version/security/policy",
-                "source": "https://github.com/sebastianbergmann/version/tree/5.0.2"
+                "source": "https://github.com/sebastianbergmann/version/tree/6.0.0"
             },
             "funding": [
                 {
@@ -8630,7 +8712,7 @@
                     "type": "github"
                 }
             ],
-            "time": "2024-10-09T05:16:32+00:00"
+            "time": "2025-02-07T05:00:38+00:00"
         },
         {
             "name": "squizlabs/php_codesniffer",
@@ -8768,101 +8850,25 @@
             ],
             "time": "2024-10-20T05:08:20+00:00"
         },
-        {
-            "name": "symfony/yaml",
-            "version": "v7.4.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/symfony/yaml.git",
-                "reference": "6c84a4b55aee4cd02034d1c528e83f69ddf63810"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/symfony/yaml/zipball/6c84a4b55aee4cd02034d1c528e83f69ddf63810",
-                "reference": "6c84a4b55aee4cd02034d1c528e83f69ddf63810",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=8.2",
-                "symfony/deprecation-contracts": "^2.5|^3",
-                "symfony/polyfill-ctype": "^1.8"
-            },
-            "conflict": {
-                "symfony/console": "<6.4"
-            },
-            "require-dev": {
-                "symfony/console": "^6.4|^7.0|^8.0"
-            },
-            "bin": [
-                "Resources/bin/yaml-lint"
-            ],
-            "type": "library",
-            "autoload": {
-                "psr-4": {
-                    "Symfony\\Component\\Yaml\\": ""
-                },
-                "exclude-from-classmap": [
-                    "/Tests/"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Fabien Potencier",
-                    "email": "fabien@symfony.com"
-                },
-                {
-                    "name": "Symfony Community",
-                    "homepage": "https://symfony.com/contributors"
-                }
-            ],
-            "description": "Loads and dumps YAML files",
-            "homepage": "https://symfony.com",
-            "support": {
-                "source": "https://github.com/symfony/yaml/tree/v7.4.0"
-            },
-            "funding": [
-                {
-                    "url": "https://symfony.com/sponsor",
-                    "type": "custom"
-                },
-                {
-                    "url": "https://github.com/fabpot",
-                    "type": "github"
-                },
-                {
-                    "url": "https://github.com/nicolas-grekas",
-                    "type": "github"
-                },
-                {
-                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
-                    "type": "tidelift"
-                }
-            ],
-            "time": "2025-11-16T10:14:42+00:00"
-        },
         {
             "name": "theseer/tokenizer",
-            "version": "1.3.1",
+            "version": "2.0.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/theseer/tokenizer.git",
-                "reference": "b7489ce515e168639d17feec34b8847c326b0b3c"
+                "reference": "7989e43bf381af0eac72e4f0ca5bcbfa81658be4"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/theseer/tokenizer/zipball/b7489ce515e168639d17feec34b8847c326b0b3c",
-                "reference": "b7489ce515e168639d17feec34b8847c326b0b3c",
+                "url": "https://api.github.com/repos/theseer/tokenizer/zipball/7989e43bf381af0eac72e4f0ca5bcbfa81658be4",
+                "reference": "7989e43bf381af0eac72e4f0ca5bcbfa81658be4",
                 "shasum": ""
             },
             "require": {
                 "ext-dom": "*",
                 "ext-tokenizer": "*",
                 "ext-xmlwriter": "*",
-                "php": "^7.2 || ^8.0"
+                "php": "^8.1"
             },
             "type": "library",
             "autoload": {
@@ -8884,7 +8890,7 @@
             "description": "A small library for converting tokenized PHP source code into XML and potentially other formats",
             "support": {
                 "issues": "https://github.com/theseer/tokenizer/issues",
-                "source": "https://github.com/theseer/tokenizer/tree/1.3.1"
+                "source": "https://github.com/theseer/tokenizer/tree/2.0.1"
             },
             "funding": [
                 {
@@ -8892,7 +8898,7 @@
                     "type": "github"
                 }
             ],
-            "time": "2025-11-17T20:03:58+00:00"
+            "time": "2025-12-08T11:19:18+00:00"
         }
     ],
     "aliases": [],
diff --git a/config/app.php b/config/app.php
index 6cc5a37..e346add 100755
--- a/config/app.php
+++ b/config/app.php
@@ -131,5 +131,5 @@
     | The version of the CMS.
     |
     */
-    'version' => env('APP_VERSION', '0.1.6-alpha.3'),
+    'version' => env('APP_VERSION', '0.1.6-alpha.4'),
 ];

From 15496fa2ce788def51373c207a146aadce94e50c Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sat, 30 May 2026 02:22:09 +0200
Subject: [PATCH 124/132] feat: Update application version to 0.1.6-alpha.5

---
 config/app.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/config/app.php b/config/app.php
index e346add..2c353f4 100755
--- a/config/app.php
+++ b/config/app.php
@@ -131,5 +131,5 @@
     | The version of the CMS.
     |
     */
-    'version' => env('APP_VERSION', '0.1.6-alpha.4'),
+    'version' => env('APP_VERSION', '0.1.6-alpha.5'),
 ];

From fcbbf4b637085d165846868b45d3841867b4cc91 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Fri, 12 Jun 2026 02:03:55 +0200
Subject: [PATCH 125/132] feat(admin): add full-featured menu management system

This commit introduces a complete admin menu editor with drag-and-drop reordering, nested menu support, route picking, and bulk save functionality for web and UCP menus.

Additional changes:
- Refactor `menu_items` helper to support recursive nested menus with safety checks
- Add `RouteDiscoveryService` to catalog and categorize application named routes
- Update frontend navigation and UCP sidebar to render nested menu items
- Fix minor template and styling issues across the codebase
---
 app/Helpers/SettingsHelper.php                |  47 +-
 app/Models/Module.php                         |   2 +
 .../Controllers/MenuManagerController.php     |  72 +-
 .../Resources/views/menus/index.blade.php     | 635 ++++++++++++++----
 .../views/menus/partials/item.blade.php       | 102 +++
 .../Resources/views/news/create.blade.php     |   5 +-
 .../Admin/Resources/views/news/edit.blade.php |   5 +-
 .../Resources/views/users/index.blade.php     |   2 +-
 app/Services/RouteDiscoveryService.php        | 105 +++
 resources/css/main.css                        |  19 +-
 resources/views/layouts/main.blade.php        |  34 +-
 .../views/ucp/components/sidebar.blade.php    |  24 +-
 12 files changed, 874 insertions(+), 178 deletions(-)
 create mode 100644 app/Modules/Admin/Resources/views/menus/partials/item.blade.php
 create mode 100644 app/Services/RouteDiscoveryService.php

diff --git a/app/Helpers/SettingsHelper.php b/app/Helpers/SettingsHelper.php
index 3d4814e..917879b 100644
--- a/app/Helpers/SettingsHelper.php
+++ b/app/Helpers/SettingsHelper.php
@@ -132,48 +132,71 @@ function menu_config(string $menu): array
 }
 
 if (!function_exists('menu_items')) {
-    function menu_items(string $menu): array
+    function menu_items(string $menu, int $maxDepth = 1): array
     {
         $items = menu_config($menu);
         $user = auth()->user();
 
-        return array_values(array_filter($items, function ($item) use ($user) {
+        return menu_items_recursive($items, $user, $maxDepth);
+    }
+}
+
+if (!function_exists('menu_items_recursive')) {
+    function menu_items_recursive(array $items, $user, int $maxDepth = 1, int $depth = 0): array
+    {
+        $filtered = [];
+
+        foreach ($items as $item) {
             if (!is_array($item)) {
-                return false;
+                continue;
             }
 
             if (!(bool) ($item['enabled'] ?? true)) {
-                return false;
+                continue;
             }
 
             $authRule = $item['auth'] ?? 'any';
             if ($authRule === 'auth' && !$user) {
-                return false;
+                continue;
             }
 
             if ($authRule === 'guest' && $user) {
-                return false;
+                continue;
             }
 
             $permission = trim((string) ($item['permission'] ?? ''));
             if ($permission !== '' && (!$user || !$user->can($permission))) {
-                return false;
+                continue;
             }
 
             $module = trim((string) ($item['module'] ?? ''));
             if (!menu_module_enabled($module)) {
-                return false;
+                continue;
             }
 
             $routeName = trim((string) ($item['route'] ?? ''));
             $url = trim((string) ($item['url'] ?? ''));
 
-            if ($routeName !== '') {
-                return Route::has($routeName);
+            if ($routeName !== '' && !Route::has($routeName)) {
+                continue;
+            }
+
+            if ($routeName === '' && $url === '') {
+                continue;
+            }
+
+            $children = $item['children'] ?? [];
+            $processedChildren = [];
+
+            if ($depth < $maxDepth && !empty($children) && is_array($children)) {
+                $processedChildren = menu_items_recursive($children, $user, $maxDepth, $depth + 1);
             }
 
-            return $url !== '';
-        }));
+            $item['children'] = $processedChildren;
+            $filtered[] = $item;
+        }
+
+        return $filtered;
     }
 }
 
diff --git a/app/Models/Module.php b/app/Models/Module.php
index eb19257..86a1003 100644
--- a/app/Models/Module.php
+++ b/app/Models/Module.php
@@ -2,6 +2,8 @@
 
 namespace App\Models;
 
+use Illuminate\Database\Eloquent\Model;
+
 /**
  * Module model (represents a NexusCMS module).
  *
diff --git a/app/Modules/Admin/Http/Controllers/MenuManagerController.php b/app/Modules/Admin/Http/Controllers/MenuManagerController.php
index 5111891..3183fe2 100644
--- a/app/Modules/Admin/Http/Controllers/MenuManagerController.php
+++ b/app/Modules/Admin/Http/Controllers/MenuManagerController.php
@@ -3,20 +3,30 @@
 namespace Modules\Admin\Http\Controllers;
 
 use App\Http\Controllers\Controller;
+use App\Services\RouteDiscoveryService;
+use App\Services\ModuleRegistryService;
 use Modules\Admin\Domain\Models\Setting;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Cache;
-use Illuminate\Support\Facades\File;
+use Illuminate\Support\Str;
 
 class MenuManagerController extends Controller
 {
+    public function __construct(
+        protected RouteDiscoveryService $routeDiscovery,
+    ) {}
+
     public function index()
     {
         $webMenu = menu_config('web');
         $ucpMenu = menu_config('ucp');
         $modules = $this->discoverModules();
+        $availableRoutes = $this->routeDiscovery->getRoutesForMenuPicker();
+        $moduleRoutes = $this->routeDiscovery->getRoutesByModule();
 
-        return view('admin::menus.index', compact('webMenu', 'ucpMenu', 'modules'));
+        return view('admin::menus.index', compact(
+            'webMenu', 'ucpMenu', 'modules', 'availableRoutes', 'moduleRoutes'
+        ));
     }
 
     public function update(Request $request)
@@ -60,6 +70,9 @@ public function update(Request $request)
             ->with('success', $message);
     }
 
+    /**
+     * Normalize items recursively — supports nested children.
+     */
     protected function normalizeItems(array $items): array
     {
         $normalized = [];
@@ -73,7 +86,8 @@ protected function normalizeItems(array $items): array
                 continue;
             }
 
-            $normalized[] = [
+            $normalizedItem = [
+                'id' => $this->generateItemId(),
                 'label' => $label,
                 'route' => $route,
                 'url' => $url,
@@ -83,35 +97,43 @@ protected function normalizeItems(array $items): array
                     ? $item['auth']
                     : 'any',
                 'permission' => trim((string) ($item['permission'] ?? '')),
-                'enabled' => isset($item['enabled']) && (string) $item['enabled'] === '1',
+                'enabled' => in_array('1', (array) ($item['enabled'] ?? ['1'])),
+                'children' => [],
             ];
+
+            // Recursively normalize children
+            if (!empty($item['children']) && is_array($item['children'])) {
+                $normalizedItem['children'] = $this->normalizeItems($item['children']);
+            }
+
+            $normalized[] = $normalizedItem;
         }
 
         return $normalized;
     }
 
-    protected function discoverModules(): array
+    /**
+     * Generate a unique item ID (ULID-like).
+     */
+    protected function generateItemId(): string
     {
-        $modulesPath = base_path('app/Modules');
-        if (!is_dir($modulesPath)) {
-            return [];
-        }
+        return 'item_' . Str::random(13);
+    }
 
+    /**
+     * Discover modules using ModuleRegistryService.
+     */
+    protected function discoverModules(): array
+    {
         $modules = [];
 
-        foreach (glob($modulesPath . '/*', GLOB_ONLYDIR) as $moduleDir) {
-            $moduleName = basename($moduleDir);
-            $configPath = $moduleDir . DIRECTORY_SEPARATOR . 'module.json';
-            $enabled = true;
-
-            if (File::exists($configPath)) {
-                $decoded = json_decode(File::get($configPath), true);
-                if (is_array($decoded) && array_key_exists('enabled', $decoded)) {
-                    $enabled = (bool) $decoded['enabled'];
-                }
+        foreach (ModuleRegistryService::getAllModules() as $module) {
+            $moduleName = trim((string) ($module['folder'] ?? ''));
+            if ($moduleName === '') {
+                continue;
             }
 
-            $modules[$moduleName] = $enabled;
+            $modules[$moduleName] = (bool) ($module['enabled'] ?? true);
         }
 
         ksort($modules);
@@ -140,6 +162,16 @@ protected function handleDisabledModuleItems(array $items, array $modules, strin
                 }
             }
 
+            // Recursively handle children
+            if (!empty($item['children'])) {
+                [$item['children'], $childAffected] = $this->handleDisabledModuleItems(
+                    $item['children'],
+                    $modules,
+                    $action
+                );
+                $affected += $childAffected;
+            }
+
             $result[] = $item;
         }
 
diff --git a/app/Modules/Admin/Resources/views/menus/index.blade.php b/app/Modules/Admin/Resources/views/menus/index.blade.php
index d7db0a8..2248d08 100644
--- a/app/Modules/Admin/Resources/views/menus/index.blade.php
+++ b/app/Modules/Admin/Resources/views/menus/index.blade.php
@@ -6,7 +6,18 @@
 <header class="h-16 bg-white border-b border-gray-200 flex items-center justify-between px-6">
     <div>
         <h1 class="text-2xl font-bold text-gray-800">Menu Manager</h1>
-        <p class="text-sm text-gray-500">Configure Web and UCP menus with module-aware safety rules.</p>
+        <p class="text-sm text-gray-500">Drag items to reorder — click to edit — nest by dragging onto another item</p>
+    </div>
+    <div class="flex items-center gap-3">
+        <button type="button" onclick="addNewItem('web')" class="px-3 py-2 rounded-lg text-sm bg-blue-50 text-blue-700 hover:bg-blue-100 border border-blue-200">
+            <i class="fas fa-plus mr-1"></i> Add Web Item
+        </button>
+        <button type="button" onclick="addNewItem('ucp')" class="px-3 py-2 rounded-lg text-sm bg-green-50 text-green-700 hover:bg-green-100 border border-green-200">
+            <i class="fas fa-plus mr-1"></i> Add UCP Item
+        </button>
+        <button type="submit" form="menu-form" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+            <i class="fas fa-save mr-2"></i> Save Menus
+        </button>
     </div>
 </header>
 
@@ -18,166 +29,518 @@
         </div>
     @endif
 
-    <div class="grid grid-cols-1 md:grid-cols-4 gap-4 mb-6">
-        <div class="bg-white rounded-xl border border-gray-200 p-4">
-            <p class="text-xs uppercase tracking-wider text-gray-500">Modules</p>
-            <p class="text-2xl font-bold text-gray-800 mt-1">{{ count($modules) }}</p>
-        </div>
-        <div class="bg-white rounded-xl border border-gray-200 p-4">
-            <p class="text-xs uppercase tracking-wider text-gray-500">Enabled Modules</p>
-            <p class="text-2xl font-bold text-green-700 mt-1">{{ collect($modules)->filter(fn ($enabled) => $enabled === true)->count() }}</p>
-        </div>
-        <div class="bg-white rounded-xl border border-gray-200 p-4">
-            <p class="text-xs uppercase tracking-wider text-gray-500">Disabled Modules</p>
-            <p class="text-2xl font-bold text-red-700 mt-1">{{ collect($modules)->filter(fn ($enabled) => $enabled === false)->count() }}</p>
-        </div>
-        <div class="bg-white rounded-xl border border-gray-200 p-4">
-            <p class="text-xs uppercase tracking-wider text-gray-500">Menu Items</p>
-            <p class="text-2xl font-bold text-blue-700 mt-1">{{ count($webMenu) + count($ucpMenu) }}</p>
-        </div>
-    </div>
-
-    <form method="POST" action="{{ route('admin.menus.update') }}" class="space-y-6">
+    <form id="menu-form" method="POST" action="{{ route('admin.menus.update') }}" class="space-y-6" onsubmit="syncEnabledCheckboxes()">
         @csrf
         @method('PUT')
 
-        <div class="bg-amber-50 border border-amber-200 rounded-xl p-4 flex flex-col lg:flex-row lg:items-center lg:justify-between gap-3">
-            <div>
-                <p class="text-sm font-semibold text-amber-900">Disabled module safety tools</p>
-                <p class="text-xs text-amber-800">Use these actions to avoid broken links when a module is disabled or removed.</p>
+        <div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
+            {{-- WEB MENU --}}
+            <div class="bg-white rounded-xl shadow border border-gray-200">
+                <div class="p-4 border-b border-gray-200 flex items-center justify-between bg-gradient-to-r from-slate-50 to-white">
+                    <div>
+                        <h2 class="text-lg font-bold text-gray-800">Web Menu</h2>
+                        <p class="text-xs text-gray-500 mt-0.5">Top navigation — frontend</p>
+                    </div>
+                    <button type="button" onclick="addNewItem('web')" class="px-3 py-1.5 rounded-lg text-xs bg-blue-50 text-blue-700 hover:bg-blue-100 border border-blue-200">
+                        <i class="fas fa-plus mr-1"></i> Add Item
+                    </button>
+                </div>
+                <div class="p-4">
+                    <div id="web-menu-list" class="space-y-2 min-h-[100px]"
+                         ondragover="handleDragOver(event)"
+                         ondragleave="handleDragLeave(event)"
+                         ondrop="handleDrop(event, 'web')">
+                        @forelse($webMenu as $index => $item)
+                            @include('admin::menus.partials.item', ['prefix' => 'web_items', 'index' => $index, 'item' => $item, 'menuType' => 'web'])
+                        @empty
+                            <div class="text-center py-8 text-gray-400 text-sm border-2 border-dashed border-gray-200 rounded-lg">
+                                <i class="fas fa-bars text-2xl mb-2"></i>
+                                <p>No items yet. Click "Add Item" to start building your menu.</p>
+                            </div>
+                        @endforelse
+                    </div>
+                </div>
             </div>
-            <div class="flex gap-2">
-                <button type="submit" name="action" value="disable-disabled-modules" class="px-3 py-2 rounded-lg text-sm bg-yellow-100 text-yellow-800 hover:bg-yellow-200">
-                    <i class="fas fa-toggle-off mr-1"></i>Disable Items of Disabled Modules
-                </button>
-                <button type="submit" name="action" value="remove-disabled-modules" class="px-3 py-2 rounded-lg text-sm bg-red-100 text-red-800 hover:bg-red-200" onclick="return confirm('This will permanently remove all menu items linked to disabled or missing modules. Continue?')">
-                    <i class="fas fa-trash mr-1"></i>Delete Items of Disabled Modules
-                </button>
+
+            {{-- UCP MENU --}}
+            <div class="bg-white rounded-xl shadow border border-gray-200">
+                <div class="p-4 border-b border-gray-200 flex items-center justify-between bg-gradient-to-r from-slate-50 to-white">
+                    <div>
+                        <h2 class="text-lg font-bold text-gray-800">UCP Menu</h2>
+                        <p class="text-xs text-gray-500 mt-0.5">Sidebar navigation — user control panel</p>
+                    </div>
+                    <button type="button" onclick="addNewItem('ucp')" class="px-3 py-1.5 rounded-lg text-xs bg-green-50 text-green-700 hover:bg-green-100 border border-green-200">
+                        <i class="fas fa-plus mr-1"></i> Add Item
+                    </button>
+                </div>
+                <div class="p-4">
+                    <div id="ucp-menu-list" class="space-y-2 min-h-[100px]"
+                         ondragover="handleDragOver(event)"
+                         ondragleave="handleDragLeave(event)"
+                         ondrop="handleDrop(event, 'ucp')">
+                        @forelse($ucpMenu as $index => $item)
+                            @include('admin::menus.partials.item', ['prefix' => 'ucp_items', 'index' => $index, 'item' => $item, 'menuType' => 'ucp'])
+                        @empty
+                            <div class="text-center py-8 text-gray-400 text-sm border-2 border-dashed border-gray-200 rounded-lg">
+                                <i class="fas fa-bars text-2xl mb-2"></i>
+                                <p>No items yet. Click "Add Item" to start building your menu.</p>
+                            </div>
+                        @endforelse
+                    </div>
+                </div>
             </div>
         </div>
 
-        <div class="bg-white rounded-xl shadow border border-gray-200">
-            <div class="p-6 border-b border-gray-200 flex items-center justify-between bg-gradient-to-r from-slate-50 to-white">
-                <div>
-                    <h2 class="text-lg font-bold text-gray-800">Web Menu</h2>
-                    <p class="text-sm text-gray-500">Top navigation in frontend layout.</p>
+        {{-- Route Picker Modal --}}
+        <div id="route-picker-modal" class="hidden fixed inset-0 z-50 flex items-center justify-center bg-black/50">
+            <div class="bg-white rounded-xl shadow-2xl w-full max-w-lg mx-4 max-h-[80vh] flex flex-col">
+                <div class="p-4 border-b border-gray-200 flex items-center justify-between">
+                    <h3 class="font-bold text-gray-800">Select Route</h3>
+                    <button type="button" onclick="closeRoutePicker()" class="text-gray-400 hover:text-gray-600">
+                        <i class="fas fa-times"></i>
+                    </button>
+                </div>
+                <div class="p-4 overflow-y-auto flex-1">
+                    <input type="text" id="route-search" placeholder="Search routes..." class="w-full px-3 py-2 border border-gray-300 rounded-lg mb-4 text-sm" oninput="filterRoutes()">
+                    <div id="route-list" class="space-y-1"></div>
                 </div>
-                <button type="button" onclick="addMenuRow('web-menu-body', 'web_items')" class="px-3 py-2 rounded-lg text-sm bg-blue-50 text-blue-700 hover:bg-blue-100 border border-blue-200">
-                    <i class="fas fa-plus mr-1"></i>Add Item
-                </button>
-            </div>
-            <div class="p-6 overflow-x-auto">
-                <table class="min-w-full divide-y divide-gray-200 text-sm">
-                    <thead class="bg-gray-50">
-                        <tr>
-                            <th class="px-3 py-2 text-left">Label</th>
-                            <th class="px-3 py-2 text-left">Module</th>
-                            <th class="px-3 py-2 text-left">Route</th>
-                            <th class="px-3 py-2 text-left">URL</th>
-                            <th class="px-3 py-2 text-left">Icon</th>
-                            <th class="px-3 py-2 text-left">Auth</th>
-                            <th class="px-3 py-2 text-left">Permission</th>
-                            <th class="px-3 py-2 text-left">Enabled</th>
-                            <th class="px-3 py-2 text-right">Action</th>
-                        </tr>
-                    </thead>
-                    <tbody id="web-menu-body" class="divide-y divide-gray-100">
-                        @foreach($webMenu as $index => $item)
-                            @include('admin::menus.partials.row', ['prefix' => 'web_items', 'index' => $index, 'item' => $item, 'modules' => $modules])
-                        @endforeach
-                    </tbody>
-                </table>
             </div>
         </div>
 
-        <div class="bg-white rounded-xl shadow border border-gray-200">
-            <div class="p-6 border-b border-gray-200 flex items-center justify-between bg-gradient-to-r from-slate-50 to-white">
-                <div>
-                    <h2 class="text-lg font-bold text-gray-800">UCP Menu</h2>
-                    <p class="text-sm text-gray-500">Sidebar navigation in UCP pages.</p>
-                </div>
-                <button type="button" onclick="addMenuRow('ucp-menu-body', 'ucp_items')" class="px-3 py-2 rounded-lg text-sm bg-blue-50 text-blue-700 hover:bg-blue-100 border border-blue-200">
-                    <i class="fas fa-plus mr-1"></i>Add Item
+        {{-- Item Editor Sidebar --}}
+        <div id="item-editor" class="hidden fixed inset-y-0 right-0 w-80 bg-white shadow-2xl z-50 flex flex-col border-l border-gray-200">
+            <div class="p-4 border-b border-gray-200 flex items-center justify-between bg-gray-50">
+                <h3 class="font-bold text-gray-800">Edit Item</h3>
+                <button type="button" onclick="closeEditor()" class="text-gray-400 hover:text-gray-600">
+                    <i class="fas fa-times"></i>
                 </button>
             </div>
-            <div class="p-6 overflow-x-auto">
-                <table class="min-w-full divide-y divide-gray-200 text-sm">
-                    <thead class="bg-gray-50">
-                        <tr>
-                            <th class="px-3 py-2 text-left">Label</th>
-                            <th class="px-3 py-2 text-left">Module</th>
-                            <th class="px-3 py-2 text-left">Route</th>
-                            <th class="px-3 py-2 text-left">URL</th>
-                            <th class="px-3 py-2 text-left">Icon</th>
-                            <th class="px-3 py-2 text-left">Auth</th>
-                            <th class="px-3 py-2 text-left">Permission</th>
-                            <th class="px-3 py-2 text-left">Enabled</th>
-                            <th class="px-3 py-2 text-right">Action</th>
-                        </tr>
-                    </thead>
-                    <tbody id="ucp-menu-body" class="divide-y divide-gray-100">
-                        @foreach($ucpMenu as $index => $item)
-                            @include('admin::menus.partials.row', ['prefix' => 'ucp_items', 'index' => $index, 'item' => $item, 'modules' => $modules])
+            <div class="flex-1 overflow-y-auto p-4 space-y-4" id="editor-fields">
+               <input type="hidden" id="edit-index" value="">
+                <input type="hidden" id="edit-menu-type" value="">
+
+                <div class="panel-section">
+                    <label class="block text-xs font-semibold text-gray-600 uppercase tracking-wider mb-1">Label</label>
+                    <input type="text" id="edit-label" class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm" placeholder="Menu label">
+                </div>
+
+                <div class="panel-section">
+                    <label class="block text-xs font-semibold text-gray-600 uppercase tracking-wider mb-1">Route</label>
+                    <div class="flex gap-2">
+                        <input type="text" id="edit-route" class="flex-1 px-3 py-2 border border-gray-300 rounded-lg text-sm" placeholder="route.name">
+                        <button type="button" onclick="openRoutePicker()" class="px-3 py-2 bg-gray-100 border border-gray-300 rounded-lg text-sm hover:bg-gray-200">
+                            <i class="fas fa-search"></i>
+                        </button>
+                    </div>
+                </div>
+
+                <div class="panel-section">
+                    <label class="block text-xs font-semibold text-gray-600 uppercase tracking-wider mb-1">URL Override</label>
+                    <input type="text" id="edit-url" class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm" placeholder="/custom-url (optional)">
+                </div>
+
+                <div class="panel-section">
+                    <label class="block text-xs font-semibold text-gray-600 uppercase tracking-wider mb-1">Icon (FontAwesome class)</label>
+                    <input type="text" id="edit-icon" class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm" placeholder="fas fa-home">
+                    <p class="text-xs text-gray-400 mt-1">Examples: <code class="bg-gray-100 px-1 rounded">fas fa-home</code>, <code class="bg-gray-100 px-1 rounded">fas fa-users</code></p>
+                </div>
+
+                <div class="panel-section">
+                    <label class="block text-xs font-semibold text-gray-600 uppercase tracking-wider mb-1">Module</label>
+                    <select id="edit-module" class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm">
+                        <option value="">Core / No Module</option>
+                        @foreach($modules as $moduleName => $isEnabled)
+                            <option value="{{ $moduleName }}">{{ $moduleName }} {{ $isEnabled ? '(enabled)' : '(disabled)' }}</option>
                         @endforeach
-                    </tbody>
-                </table>
-            </div>
-        </div>
+                    </select>
+                </div>
 
-        <div class="flex items-center justify-end">
-            <button type="submit" name="action" value="save" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
-                <i class="fas fa-save mr-2"></i>Save Menus
-            </button>
+                <div class="panel-section">
+                    <label class="block text-xs font-semibold text-gray-600 uppercase tracking-wider mb-1">Auth Rule</label>
+                    <select id="edit-auth" class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm">
+                        <option value="any">Any — visible to everyone</option>
+                        <option value="auth">Auth — logged in users only</option>
+                        <option value="guest">Guest — logged out users only</option>
+                    </select>
+                </div>
+
+                <div class="panel-section">
+                    <label class="block text-xs font-semibold text-gray-600 uppercase tracking-wider mb-1">Permission (optional)</label>
+                    <input type="text" id="edit-permission" class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm" placeholder="permission.name">
+                </div>
+
+                <div class="panel-section flex items-center justify-between">
+                    <label class="text-xs font-semibold text-gray-600 uppercase tracking-wider">Enabled</label>
+                    <input type="checkbox" id="edit-enabled" class="w-5 h-5 rounded border-gray-300 text-blue-600">
+                </div>
+
+                <div class="pt-4 border-t border-gray-200">
+                    <button type="button" onclick="saveEditedItem()" class="w-full px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                        <i class="fas fa-save mr-2"></i>Apply Changes
+                    </button>
+                    <button type="button" onclick="deleteCurrentItem()" class="w-full mt-2 px-4 py-2 bg-red-50 text-red-700 rounded-lg hover:bg-red-100 text-sm font-medium border border-red-200">
+                        <i class="fas fa-trash mr-2"></i>Delete Item
+                    </button>
+                </div>
+            </div>
         </div>
     </form>
 </main>
-
-<template id="menu-row-template">
-    <tr>
-        <td class="px-3 py-2"><input type="text" class="w-full rounded border-gray-300" data-field="label" placeholder="Label"></td>
-        <td class="px-3 py-2">
-            <select class="w-full rounded border-gray-300" data-field="module">
-                <option value="">Core / No Module</option>
-                @foreach($modules as $moduleName => $isEnabled)
-                    <option value="{{ $moduleName }}">{{ $moduleName }} {{ $isEnabled ? '(enabled)' : '(disabled)' }}</option>
-                @endforeach
-            </select>
-        </td>
-        <td class="px-3 py-2"><input type="text" class="w-full rounded border-gray-300" data-field="route" placeholder="route.name"></td>
-        <td class="px-3 py-2"><input type="text" class="w-full rounded border-gray-300" data-field="url" placeholder="/custom-url"></td>
-        <td class="px-3 py-2"><input type="text" class="w-full rounded border-gray-300" data-field="icon" placeholder="fas fa-home"></td>
-        <td class="px-3 py-2">
-            <select class="w-full rounded border-gray-300" data-field="auth">
-                <option value="any">Any</option>
-                <option value="auth">Auth</option>
-                <option value="guest">Guest</option>
-            </select>
-        </td>
-        <td class="px-3 py-2"><input type="text" class="w-full rounded border-gray-300" data-field="permission" placeholder="permission.name"></td>
-        <td class="px-3 py-2 text-center"><input type="checkbox" value="1" data-field="enabled" checked></td>
-        <td class="px-3 py-2 text-right">
-            <button type="button" class="px-2 py-1 text-xs rounded bg-red-50 text-red-700 hover:bg-red-100" onclick="this.closest('tr').remove()">Remove</button>
-        </td>
-    </tr>
-</template>
 @endsection
 
+@php
+$allRoutesForPicker = [];
+foreach (['public', 'auth', 'ucp'] as $cat) {
+    $allRoutesForPicker[$cat] = $availableRoutes[$cat] ?? [];
+}
+@endphp
+
 @push('scripts')
 <script>
-    function bindRowInputs(row, prefix, index) {
-        row.querySelectorAll('[data-field]').forEach((element) => {
-            const field = element.getAttribute('data-field');
-            element.setAttribute('name', `${prefix}[${index}][${field}]`);
+    // ─── Data ───────────────────────────────────────────────────────────────────
+    const availableRoutes = @json($allRoutesForPicker);
+    const moduleRoutes = @json($moduleRoutes);
+    const modules = @json($modules);
+
+    let editingItemId = null;
+    let editingMenuType = null;
+    let itemCounter = Date.now();
+
+    // ─── Drag& Drop ─────────────────────────────────────────────────────────
+    function handleDragStart(event) {
+        event.dataTransfer.setData('text/plain', event.target.dataset.itemId);
+        event.dataTransfer.setData('text/menu', event.target.dataset.menuType);
+        event.target.classList.add('opacity-50');
+    }
+
+    function handleDragEnd(event) {
+        event.target.classList.remove('opacity-50');
+        document.querySelectorAll('.drag-over').forEach(el => el.classList.remove('drag-over'));
+    }
+
+    function handleDragOver(event) {
+        event.preventDefault();
+        event.currentTarget.classList.add('drag-over');
+    }
+
+    function handleDragLeave(event) {
+        event.currentTarget.classList.remove('drag-over');
+    }
+
+    function handleDrop(event, targetMenu) {
+        event.preventDefault();
+        event.currentTarget.classList.remove('drag-over');
+
+        const itemId = event.dataTransfer.getData('text/plain');
+        const sourceMenu = event.dataTransfer.getData('text/menu');
+
+        const sourceList = document.getElementById(`${sourceMenu}-menu-list`);
+        const targetList = document.getElementById(`${targetMenu}-menu-list`);
+        const draggedEl = sourceList.querySelector(`[data-item-id="${itemId}"]`);
+
+        if (!draggedEl) return;
+
+        // If dropping on another item, make it a child
+        const targetEl = event.target.closest('[data-item-id]');
+        if (targetEl && targetEl !== draggedEl && targetEl.dataset.menuType === targetMenu) {
+            moveToChildren(targetEl, draggedEl, sourceList, targetList);
+        } else {
+            // Move to end of target list
+            targetList.appendChild(draggedEl);
+            draggedEl.dataset.menuType = targetMenu;
+        }
+
+        reindexItems(sourceMenu);
+        reindexItems(targetMenu);
+    }
+
+    function moveToChildren(targetEl, draggedEl, sourceList, targetList) {
+        const childrenContainer = targetEl.querySelector('.children-container');
+        if (!childrenContainer) return;
+
+        draggedEl.dataset.menuType = targetEl.dataset.menuType;
+        draggedEl.classList.add('child-item');
+        childrenContainer.appendChild(draggedEl);
+    }
+
+    function reindexItems(menuType) {
+        const list = document.getElementById(`${menuType}-menu-list`);
+        const prefix = `${menuType}_items`;
+        let index = 0;
+
+        list.querySelectorAll(':scope > [data-item-id]').forEach(card => {
+            card.querySelectorAll('[data-field]').forEach(input => {
+                const field = input.dataset.field;
+                const name = `${prefix}[${index}][${field}]`;
+                input.name = name;
+            });
+
+            // Children
+            const childrenContainer = card.querySelector('.children-container');
+            if (childrenContainer) {
+                let childIndex = 0;
+                childrenContainer.querySelectorAll('[data-item-id]').forEach(childCard => {
+                    childCard.querySelectorAll('[data-field]').forEach(input => {
+                        const field = input.dataset.field;
+                        const name = `${prefix}[${index}][children][${childIndex}][${field}]`;
+                        input.name = name;
+                    });
+                    childIndex++;
+                });
+            }
+
+            index++;
+        });
+    }
+
+    // ─── Add Item ───────────────────────────────────────────────────────────
+    function addNewItem(menuType) {
+        const list = document.getElementById(`${menuType}-menu-list`);
+        const emptyState = list.querySelector('.empty-state');
+        if (emptyState) emptyState.remove();
+
+        const id = `new_${itemCounter++}`;
+        const index = list.querySelectorAll(':scope > [data-item-id]').length;
+        const prefix = `${menuType}_items`;
+
+        const card = createItemCard(id, index, {
+            id,
+            label: '',
+            route: '',
+            url: '',
+            icon: '',
+            module: '',
+            auth: 'any',
+            permission: '',
+            enabled: true,
+            children: [],
+        }, menuType, prefix);
+
+        list.appendChild(card);
+ }
+
+    function createItemCard(id, index, item, menuType, prefix) {
+        const card = document.createElement('div');
+        card.className = `menu-item-card bg-white border border-gray-200 rounded-lg p-3 ${item._isChild ? 'child-item' : ''}`;
+        card.dataset.itemId = id;
+        card.dataset.menuType = menuType;
+        card.draggable = true;
+
+        card.innerHTML = `
+            <div class="flex items-start gap-3">
+                <div class="drag-handle flex-shrink-0 pt-1 text-gray-300 hover:text-gray-500" draggable="true"
+ ondragstart="handleDragStart(event)" ondragend="handleDragEnd(event)">
+                    <i class="fas fa-bars"></i>
+                </div>
+                <div class="flex-1 min-w-0">
+                    <div class="flex items-center gap-2 mb-1">
+                        <input type="text" data-field="label" value="${escapeHtml(item.label || '')}"
+ placeholder="Label" onchange="updateCardLabel(this)"
+                               class="font-semibold text-sm text-gray-800 bg-transparent border-none outline-none focus:ring-0 p-0 w-full">
+<span class="icon-preview text-gray-400"><i class="${escapeHtml(item.icon || 'fas fa-link')}"></i></span>
+                        ${item.module ? `<span class="module-badge ${(modules[item.module] ?? false) ? 'enabled' : 'disabled'}">${escapeHtml(item.module)}</span>` : ''}
+                       <input type="checkbox" data-field="enabled" ${(item.enabled !== false) ? 'checked' : ''}
+ class="w-4 h-4 rounded border-gray-300 text-blue-600 ml-auto" title="Enabled">
+                    </div>
+                    <div class="flex items-center gap-2 text-xs text-gray-500">
+                        ${item.route ? `<span class="route-chip">${escapeHtml(item.route)}</span>` : ''}
+                        ${item.url ? `<span class="text-gray-400">${escapeHtml(item.url)}</span>` : ''}
+                        ${item.auth !== 'any' ? `<span class="bg-amber-100 text-amber-700 px-1.5 py-0.5 rounded text-xs">${item.auth}</span>` : ''}
+                    </div>
+                   <div class="children-container mt-2 space-y-1"></div>
+                </div>
+                <div class="flex flex-col gap-1 flex-shrink-0">
+                    <button type="button" onclick="openEditor('${id}', '${menuType}')" class="px-2 py-1 text-xs text-blue-600 hover:bg-blue-50 rounded" title="Edit">
+                        <i class="fas fa-pen"></i>
+                    </button>
+                    <button type="button" onclick="deleteItem('${id}', '${menuType}')" class="px-2 py-1 text-xs text-red-500 hover:bg-red-50 rounded" title="Delete">
+                        <i class="fas fa-trash"></i>
+                    </button>
+                </div>
+            </div>
+        `;
+
+        // Add hidden inputs
+        ['label', 'route', 'url', 'icon', 'module', 'auth', 'permission', 'enabled', 'id'].forEach(field => {
+            const input = document.createElement('input');
+            input.type = field === 'enabled' ? 'checkbox' : 'hidden';
+            input.dataset.field = field;
+            input.name = `${prefix}[${index}][${field}]`;
+            if (field === 'enabled') {
+                input.checked = item.enabled !== false;
+                input.className = 'w-4 h-4 rounded border-gray-300 text-blue-600';
+            } else {
+                input.value = item[field] ?? '';
+            }
+            card.appendChild(input);
+        });
+
+        // Add children recursively
+        if (item.children && item.children.length > 0) {
+            const container = card.querySelector('.children-container');
+            item.children.forEach((child, ci) => {
+                const childCard = createItemCard(`child_${id}_${ci}`, ci, { ...child, _isChild: true }, menuType, `${prefix}[${index}][children]`);
+                container.appendChild(childCard);
+            });
+        }
+
+        return card;
+    }
+
+    function escapeHtml(str) {
+        const div = document.createElement('div');
+        div.textContent = str;
+        return div.innerHTML;
+    }
+
+    function updateCardLabel(input) {
+        const card = input.closest('.menu-item-card');
+        const labelSpan = card.querySelector('.item-label');
+        if (labelSpan) labelSpan.textContent = input.value;
+    }
+
+    // ─── Item Editor ──────────────────────────────────────────────────────────
+    function openEditor(itemId, menuType) {
+        editingItemId = itemId;
+        editingMenuType = menuType;
+
+        const list = document.getElementById(`${menuType}-menu-list`);
+        const card = list.querySelector(`[data-item-id="${itemId}"]`);
+
+        document.getElementById('edit-label').value = card.querySelector('[data-field="label"]').value;
+        document.getElementById('edit-route').value = card.querySelector('[data-field="route"]').value;
+        document.getElementById('edit-url').value = card.querySelector('[data-field="url"]').value;
+        document.getElementById('edit-icon').value = card.querySelector('[data-field="icon"]').value;
+        document.getElementById('edit-module').value = card.querySelector('[data-field="module"]').value;
+        document.getElementById('edit-auth').value = card.querySelector('[data-field="auth"]').value;
+        document.getElementById('edit-permission').value = card.querySelector('[data-field="permission"]').value;
+        document.getElementById('edit-enabled').checked = card.querySelector('[data-field="enabled"]').checked;
+
+        document.getElementById('item-editor').classList.remove('hidden');
+    }
+
+    function closeEditor() {
+        document.getElementById('item-editor').classList.add('hidden');
+        editingItemId = null;
+        editingMenuType = null;
+    }
+
+    function saveEditedItem() {
+        if (!editingItemId) return;
+
+        const list = document.getElementById(`${editingMenuType}-menu-list`);
+        const card = list.querySelector(`[data-item-id="${editingItemId}"]`);
+
+        card.querySelector('[data-field="label"]').value = document.getElementById('edit-label').value;
+        card.querySelector('[data-field="route"]').value = document.getElementById('edit-route').value;
+        card.querySelector('[data-field="url"]').value = document.getElementById('edit-url').value;
+        card.querySelector('[data-field="icon"]').value = document.getElementById('edit-icon').value;
+        card.querySelector('[data-field="module"]').value = document.getElementById('edit-module').value;
+        card.querySelector('[data-field="auth"]').value = document.getElementById('edit-auth').value;
+        card.querySelector('[data-field="permission"]').value = document.getElementById('edit-permission').value;
+        card.querySelector('[data-field="enabled"]').checked = document.getElementById('edit-enabled').checked;
+
+        closeEditor();
+    }
+
+    function deleteCurrentItem() {
+        if (!editingItemId) return;
+        deleteItem(editingItemId, editingMenuType);
+        closeEditor();
+    }
+
+    function deleteItem(itemId, menuType) {
+        const list = document.getElementById(`${menuType}-menu-list`);
+        const card = list.querySelector(`[data-item-id="${itemId}"]`);
+        if (card) card.remove();
+
+        if (list.children.length === 0) {
+            list.innerHTML = `
+                <div class="empty-state text-center py-8 text-gray-400 text-sm border-2 border-dashed border-gray-200 rounded-lg">
+                    <i class="fas fa-bars text-2xl mb-2"></i>
+                    <p>No items yet. Click "Add Item" to start building your menu.</p>
+                </div>
+            `;
+        }
+
+        reindexItems(menuType);
+    }
+
+    // ─── Route Picker ─────────────────────────────────────────────────────────
+    function openRoutePicker() {
+        document.getElementById('route-picker-modal').classList.remove('hidden');
+        document.getElementById('route-search').value = '';
+        renderRouteList(availableRoutes);
+    }
+
+    function closeRoutePicker() {
+        document.getElementById('route-picker-modal').classList.add('hidden');
+    }
+
+    function renderRouteList(routes) {
+        const container = document.getElementById('route-list');
+        container.innerHTML = '';
+
+        ['public', 'auth', 'ucp'].forEach(cat => {
+            if (!routes[cat] || routes[cat].length === 0) return;
+
+            const section = document.createElement('div');
+            section.className = 'mb-4';
+
+            const catLabel = cat === 'public' ? 'Public Routes' : cat === 'auth' ? 'Auth Required' : 'UCP Routes';
+            section.innerHTML = `<p class="text-xs font-bold text-gray-500 uppercase tracking-wider mb-2">${catLabel}</p>`;
+
+            routes[cat].forEach(route => {
+                const btn = document.createElement('button');
+                btn.type = 'button';
+                btn.className = 'w-full text-left px-3 py-2 rounded-lg hover:bg-blue-50 text-sm flex items-center justify-between gap-2';
+                btn.innerHTML = `
+                    <span class="flex-1 min-w-0">
+                        <span class="font-medium text-gray-800 truncate block">${route.name}</span>
+                        <span class="text-gray-400 text-xs truncate block">${route.uri}</span>
+                    </span>
+                    <span class="text-xs text-gray-400 flex-shrink-0">${route.methods[0]}</span>
+                `;
+                btn.onclick = () => selectRoute(route.name);
+                section.appendChild(btn);
+            });
+
+            container.appendChild(section);
         });
     }
 
-    function addMenuRow(tbodyId, prefix) {
-        const tbody = document.getElementById(tbodyId);
-        const template = document.getElementById('menu-row-template');
-        const row = template.content.firstElementChild.cloneNode(true);
-        const index = tbody.querySelectorAll('tr').length;
-        bindRowInputs(row, prefix, index);
-        tbody.appendChild(row);
+    function filterRoutes() {
+        const query = document.getElementById('route-search').value.toLowerCase();
+        const filtered = {};
+        ['public', 'auth', 'ucp'].forEach(cat => {
+            if (!availableRoutes[cat]) return;
+            filtered[cat] = availableRoutes[cat].filter(r =>
+                r.name.toLowerCase().includes(query) || r.uri.toLowerCase().includes(query)
+            );
+        });
+        renderRouteList(filtered);
+    }
+
+    function selectRoute(routeName) {
+        document.getElementById('edit-route').value = routeName;
+        closeRoutePicker();
     }
+
+    // ─── Sync enabled checkboxes before submit ─────────────────────────────
+    function syncEnabledCheckboxes() {
+        document.querySelectorAll('.menu-item-card').forEach(card => {
+            const visible = card.querySelector('input[data-field="enabled"][type="checkbox"]');
+            const hidden = card.querySelector('input[data-field="enabled"][type="hidden"]');
+            if (visible && hidden) {
+                hidden.value = visible.checked ? '1' : '0';
+            }
+        });
+    }
+
+    // ─── Init: bind drag events to existing cards ────────────────────────────
+    document.querySelectorAll('[data-item-id]').forEach(card => {
+        card.addEventListener('dragstart', handleDragStart);
+        card.addEventListener('dragend', handleDragEnd);
+    });
 </script>
 @endpush
diff --git a/app/Modules/Admin/Resources/views/menus/partials/item.blade.php b/app/Modules/Admin/Resources/views/menus/partials/item.blade.php
new file mode 100644
index 0000000..7efb0ad
--- /dev/null
+++ b/app/Modules/Admin/Resources/views/menus/partials/item.blade.php
@@ -0,0 +1,102 @@
+@php
+$itemId = $item['id'] ?? "item_{$index}";
+$isChild = $item['_isChild'] ?? false;
+$enabled = !empty($item['enabled']);
+@endphp
+
+<div class="menu-item-card bg-white border border-gray-200 rounded-lg p-3 {{ $isChild ? 'child-item' : '' }}"
+     data-item-id="{{ $itemId }}"
+     data-menu-type="{{ $menuType }}"
+     draggable="true"
+     ondragstart="handleDragStart(event)"
+     ondragend="handleDragEnd(event)">
+
+    <div class="flex items-start gap-3">
+        <div class="drag-handle flex-shrink-0 pt-1 text-gray-300 hover:text-gray-500">
+            <i class="fas fa-bars"></i>
+        </div>
+        <div class="flex-1 min-w-0">
+            <div class="flex items-center gap-2 mb-1 flex-wrap">
+                <input type="text"
+                       data-field="label"
+                       value="{{ $item['label'] ?? '' }}"
+                       placeholder="Label"
+                       class="font-semibold text-sm text-gray-800 bg-transparent border-none outline-none focus:ring-0 p-0 w-full min-w-[100px]">
+
+                <span class="icon-preview text-gray-400">
+                    <i class="{{ $item['icon'] ?? 'fas fa-link' }}"></i>
+                </span>
+
+                @if(!empty($item['module']) && isset($modules[$item['module']]))
+                    <span class="module-badge {{ $modules[$item['module']] ? 'enabled' : 'disabled' }}">
+                        {{ $item['module'] }}
+                    </span>
+                @endif
+
+                {{-- Visible checkbox (UI only, no name) --}}
+                <input type="checkbox"
+                       data-field="enabled"
+                       class="w-4 h-4 rounded border-gray-300 text-blue-600 ml-auto"
+                       title="Enabled"
+                       {{ $enabled ? 'checked' : '' }}>
+            </div>
+
+            <div class="flex items-center gap-2 text-xs text-gray-500 flex-wrap">
+                @if(!empty($item['route']))
+                    <span class="route-chip">{{ $item['route'] }}</span>
+                @endif
+                @if(!empty($item['url']))
+                    <span class="text-gray-400">{{ $item['url'] }}</span>
+                @endif
+                @if(($item['auth'] ?? 'any') !== 'any')
+                    <span class="bg-amber-100 text-amber-700 px-1.5 py-0.5 rounded text-xs">{{ $item['auth'] }}</span>
+                @endif
+                @if(!empty($item['permission']))
+                    <span class="text-gray-400">{{ $item['permission'] }}</span>
+                @endif
+            </div>
+
+            @if(!empty($item['children']))
+                <div class="children-container mt-2 space-y-1 pl-3 border-l-2 border-gray-200">
+                    @foreach($item['children'] as $childIndex => $childItem)
+                        @include('admin::menus.partials.item', [
+                            'prefix' => "{$prefix}[{$index}][children]",
+                            'index' => $childIndex,
+                            'item' => array_merge($childItem, ['_isChild' => true]),
+                            'menuType' => $menuType,
+                            'modules' => $modules
+                        ])
+                    @endforeach
+                </div>
+            @else
+                <div class="children-container mt-2 space-y-1"></div>
+            @endif
+        </div>
+
+        <div class="flex flex-col gap-1 flex-shrink-0">
+            <button type="button"
+                    onclick="openEditor('{{ $itemId }}', '{{ $menuType }}')"
+                    class="px-2 py-1 text-xs text-blue-600 hover:bg-blue-50 rounded"
+                    title="Edit">
+                <i class="fas fa-pen"></i>
+            </button>
+            <button type="button"
+                    onclick="deleteItem('{{ $itemId }}', '{{ $menuType }}')"
+                    class="px-2 py-1 text-xs text-red-500 hover:bg-red-50 rounded"
+                    title="Delete">
+                <i class="fas fa-trash"></i>
+            </button>
+        </div>
+    </div>
+
+    {{-- Hidden inputs for form submission --}}
+    <input type="hidden" data-field="id" name="{{ $prefix }}[{{ $index }}][id]" value="{{ $itemId }}">
+    <input type="hidden" data-field="label" name="{{ $prefix }}[{{ $index }}][label]" value="{{ $item['label'] ?? '' }}">
+    <input type="hidden" data-field="route" name="{{ $prefix }}[{{ $index }}][route]" value="{{ $item['route'] ?? '' }}">
+    <input type="hidden" data-field="url" name="{{ $prefix }}[{{ $index }}][url]" value="{{ $item['url'] ?? '' }}">
+    <input type="hidden" data-field="icon" name="{{ $prefix }}[{{ $index }}][icon]" value="{{ $item['icon'] ?? '' }}">
+    <input type="hidden" data-field="module" name="{{ $prefix }}[{{ $index }}][module]" value="{{ $item['module'] ?? '' }}">
+    <input type="hidden" data-field="auth" name="{{ $prefix }}[{{ $index }}][auth]" value="{{ $item['auth'] ?? 'any' }}">
+    <input type="hidden" data-field="permission" name="{{ $prefix }}[{{ $index }}][permission]" value="{{ $item['permission'] ?? '' }}">
+    <input type="hidden" data-field="enabled" name="{{ $prefix }}[{{ $index }}][enabled]" value="{{ $enabled ? '1' : '0' }}">
+</div>
diff --git a/app/Modules/Admin/Resources/views/news/create.blade.php b/app/Modules/Admin/Resources/views/news/create.blade.php
index 7b9a240..bfa3fdf 100644
--- a/app/Modules/Admin/Resources/views/news/create.blade.php
+++ b/app/Modules/Admin/Resources/views/news/create.blade.php
@@ -226,11 +226,14 @@ class="w-full px-3 py-2 text-sm border border-gray-300 rounded-lg focus:outline-
     </form>
 </main>
 
-@push('scripts')
+@push('styles')
 <style>
     .ck-editor__editable { min-height: 500px !important; }
     .ck-excerpt .ck-editor__editable { min-height: 130px !important; }
 </style>
+@endpush
+
+@push('scripts')
 <script src="https://cdn.ckeditor.com/ckeditor5/41.4.2/classic/ckeditor.js"></script>
 
 <script>
diff --git a/app/Modules/Admin/Resources/views/news/edit.blade.php b/app/Modules/Admin/Resources/views/news/edit.blade.php
index daa7991..eb42fee 100644
--- a/app/Modules/Admin/Resources/views/news/edit.blade.php
+++ b/app/Modules/Admin/Resources/views/news/edit.blade.php
@@ -262,11 +262,14 @@ class="w-full px-4 py-2 bg-red-50 text-red-700 border border-red-200 rounded-lg
     </form>
 </main>
 
-@push('scripts')
+@push('styles')
 <style>
     .ck-editor__editable { min-height: 500px !important; }
     .ck-excerpt .ck-editor__editable { min-height: 130px !important; }
 </style>
+@endpush
+
+@push('scripts')
 <script src="https://cdn.ckeditor.com/ckeditor5/41.4.2/classic/ckeditor.js"></script>
 
 <script>
diff --git a/app/Modules/Admin/Resources/views/users/index.blade.php b/app/Modules/Admin/Resources/views/users/index.blade.php
index 2695fd3..97c61c5 100644
--- a/app/Modules/Admin/Resources/views/users/index.blade.php
+++ b/app/Modules/Admin/Resources/views/users/index.blade.php
@@ -210,7 +210,7 @@ class="w-full pl-10 pr-4 py-2.5 bg-gray-50 border border-gray-200 rounded-lg foc
                                             </svg>
                                             Edit
                                         </a>
-                                        <form action="{{ route('admin.users.destroy', $user->id) }}" method="POST" onsubmit="return confirm('Are you sure you want to delete this user? This action cannot be undone.');" style="display: inline;">
+                                        <form action="{{ route('admin.users.destroy', $user->id) }}" method="POST" onsubmit="return confirm('Are you sure you want to delete this user? This action cannot be undone.');" class="inline">
                                             @csrf
                                             @method('DELETE')
                                             <button type="submit" class="inline-flex items-center gap-1 px-3 py-1.5 bg-red-50 text-red-700 rounded-lg hover:bg-red-100 text-xs font-medium">
diff --git a/app/Services/RouteDiscoveryService.php b/app/Services/RouteDiscoveryService.php
new file mode 100644
index 0000000..9655624
--- /dev/null
+++ b/app/Services/RouteDiscoveryService.php
@@ -0,0 +1,105 @@
+<?php
+
+namespace App\Services;
+
+use Illuminate\Support\Facades\Route;
+use Illuminate\Support\Str;
+
+class RouteDiscoveryService
+{
+    /**
+     * Returns all named routes grouped by category.
+     */
+    public function getAllRoutes(): array
+    {
+        $routes = collect(Route::getRoutes()->getRoutesByName())
+            ->map(function ($route) {
+                $middleware = $route->middleware();
+                $uri = $route->uri();
+
+                return [
+                    'name' => $route->getName(),
+                    'uri' => '/' . ltrim($uri, '/'),
+                    'methods' => $route->methods(),
+                    'middleware' => $middleware,
+                    'is_admin' => Str::startsWith($uri, 'acp/'),
+                    'is_ucp' => Str::startsWith($uri, 'ucp/'),
+                    'is_public' => !$this->hasAuthMiddleware($middleware),
+                    'has_auth' => in_array('auth', $middleware, true),
+                    'has_permission' => $this->hasPermissionMiddleware($middleware),
+                    'permissions' => $this->extractPermissions($middleware),
+                ];
+            })
+            ->filter(fn($r) => $r['name'] !== null)
+            ->values();
+
+        return [
+            'public' => $routes->filter(fn($r) => $r['is_public'] && !$r['is_admin'] && !$r['is_ucp'])->values()->all(),
+            'auth' => $routes->filter(fn($r) => $r['has_auth'] && !$r['has_permission'] && !$r['is_admin'] && !$r['is_ucp'])->values()->all(),
+            'ucp' => $routes->filter(fn($r) => $r['is_ucp'])->values()->all(),
+            'admin' => $routes->filter(fn($r) => $r['is_admin'])->values()->all(),
+        ];
+    }
+
+    /**
+     * Returns routes suitable for the menu picker (user-facing, non-admin).
+     */
+    public function getRoutesForMenuPicker(): array
+    {
+        $all = $this->getAllRoutes();
+
+        return [
+            'public' => $all['public'],
+            'auth' => $all['auth'],
+            'ucp' => $all['ucp'],
+        ];
+    }
+
+    /**
+     * Returns routes grouped by module name.
+     */
+    public function getRoutesByModule(): array
+    {
+        $routes = collect(Route::getRoutes()->getRoutesByName())
+            ->map(fn($route) => [
+                'name' => $route->getName(),
+                'uri' => '/' . ltrim($route->uri(), '/'),
+                'methods' => $route->methods(),
+                'middleware' => $route->middleware(),
+            ])
+            ->filter(fn($r) => $r['name'] !== null)
+            ->values();
+
+        $prefixes = ['armory', 'donate', 'forum', 'store'];
+
+        $byModule = [];
+        foreach ($prefixes as $prefix) {
+            $filtered = $routes->filter(fn($r) => Str::startsWith($r['name'], "{$prefix}."))->values()->all();
+            if (count($filtered) > 0) {
+                $byModule[$prefix] = $filtered;
+            }
+        }
+
+        return $byModule;
+    }
+
+    private function hasAuthMiddleware(array $middleware): bool
+    {
+        return in_array('auth', $middleware, true)
+            || in_array('auth:api', $middleware, true);
+    }
+
+    private function hasPermissionMiddleware(array $middleware): bool
+    {
+        return collect($middleware)->contains(fn($m) => Str::startsWith($m, 'permission:'));
+    }
+
+    private function extractPermissions(array $middleware): array
+    {
+        return collect($middleware)
+            ->filter(fn($m) => Str::startsWith($m, 'permission:'))
+            ->map(fn($m) => Str::after($m, 'permission:'))
+            ->values()
+            ->all();
+    }
+}
diff --git a/resources/css/main.css b/resources/css/main.css
index fcecbb3..da8f77a 100644
--- a/resources/css/main.css
+++ b/resources/css/main.css
@@ -310,4 +310,21 @@
 .talent-point:hover {
     transform: scale(1.1);
     cursor: pointer;
-}
\ No newline at end of file
+}
+
+/* ─── Menu Manager ──────────────────────────────────────────────────── */
+.drag-handle { cursor: grab; }
+.drag-handle:active { cursor: grabbing; }
+.drag-over { border-color: #3b82f6 !important; background: #eff6ff !important; }
+.menu-item-card { transition: transform 0.15s, box-shadow 0.15s; }
+.menu-item-card:hover { transform: translateY(-1px); box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1); }
+.child-item { margin-left: 1.5rem; border-left: 2px solid #e5e7eb; }
+.nested-indicator { width: 12px; display: inline-block; }
+.icon-preview { width: 24px; text-align: center; }
+.route-chip { font-size: 11px; padding: 2px 6px; background: #f3f4f6; border-radius: 4px; color: #6b7280; }
+.module-badge { font-size: 10px; padding: 1px 5px; border-radius: 3px; }
+.module-badge.enabled { background: #d1fae5; color: #065f46; }
+.module-badge.disabled { background: #fee2e2; color: #991b1b; }
+.add-route-btn { font-size: 11px; padding: 3px 8px; }
+.panel-section { border-bottom: 1px solid #e5e7eb; padding-bottom: 1rem; margin-bottom: 1rem; }
+.panel-section:last-child { border-bottom: none; margin-bottom: 0; padding-bottom: 0; }
\ No newline at end of file
diff --git a/resources/views/layouts/main.blade.php b/resources/views/layouts/main.blade.php
index 23b3248..d5a072e 100644
--- a/resources/views/layouts/main.blade.php
+++ b/resources/views/layouts/main.blade.php
@@ -24,7 +24,28 @@
                     </div>
                     <div class="hidden md:flex gap-6">
                         @foreach(menu_items('web') as $item)
-                            <a href="{{ menu_item_href($item) }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">{{ $item['label'] ?? 'MENU' }}</a>
+                            @if(!empty($item['children']))
+ <div class="relative group" x-data="{ open: false }" @mouseenter="open = true" @mouseleave="open = false">
+                                    <button class="flex items-center gap-1 text-slate-300 hover:text-white transition-colors duration-200 font-medium">
+                                        {{ $item['label'] ?? 'MENU' }}
+                                        <i class="fas fa-chevron-down text-xs opacity-70"></i>
+                                    </button>
+                                    <div x-show="open"
+                                         x-transition:enter="transition ease-out duration-100"
+                                         x-transition:enter-start="opacity-0 transform scale-95"
+                                         x-transition:enter-end="opacity-100 transform scale-100"
+                                         class="absolute left-0 mt-2 w-48 bg-slate-800 border border-slate-700 rounded-lg shadow-xl py-1 z-50">
+                                        @foreach($item['children'] as $child)
+                                            <a href="{{ menu_item_href($child) }}"
+                                               class="block px-4 py-2 text-sm text-slate-300 hover:text-white hover:bg-slate-700 transition-colors">
+                                                {{ $child['label'] ?? '' }}
+                                            </a>
+                                        @endforeach
+                                    </div>
+                                </div>
+                            @else
+                                <a href="{{ menu_item_href($item) }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium">{{ $item['label'] ?? 'MENU' }}</a>
+                            @endif
                         @endforeach
                     </div>
                 </div>
@@ -54,7 +75,16 @@
             <div id="mobile-menu" class="hidden md:hidden pb-4">
                 <div class="flex flex-col gap-2">
                     @foreach(menu_items('web') as $item)
-                        <a href="{{ menu_item_href($item) }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">{{ $item['label'] ?? 'MENU' }}</a>
+                        @if(!empty($item['children']))
+                            <div class="pl-4 border-l-2 border-slate-700">
+                                <p class="text-slate-500 text-xs uppercase tracking-wider py-1">{{ $item['label'] }}</p>
+                                @foreach($item['children'] as $child)
+                                    <a href="{{ menu_item_href($child) }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2 block">{{ $child['label'] ?? '' }}</a>
+                                @endforeach
+                            </div>
+                        @else
+                            <a href="{{ menu_item_href($item) }}" class="text-slate-300 hover:text-white transition-colors duration-200 font-medium py-2">{{ $item['label'] ?? 'MENU' }}</a>
+                        @endif
                     @endforeach
                     @auth
                         <div class="flex flex-col gap-2 pt-2">
diff --git a/resources/views/ucp/components/sidebar.blade.php b/resources/views/ucp/components/sidebar.blade.php
index c193200..4e68364 100755
--- a/resources/views/ucp/components/sidebar.blade.php
+++ b/resources/views/ucp/components/sidebar.blade.php
@@ -24,10 +24,26 @@
                         $isActive = !empty($item['route']) ? request()->routeIs($item['route']) : false;
                         $iconClass = $item['icon'] ?? 'fas fa-link w-5';
                     @endphp
-                    <a href="{{ menu_item_href($item) }}" class="flex items-center space-x-3 px-4 py-3 rounded-xl transition-all duration-200 {{ $isActive ? 'bg-blue-500/20 text-blue-300 border border-blue-500/30 hover:bg-blue-500/30' : 'text-gray-400 hover:bg-slate-700/50 hover:text-white' }}">
-                        <i class="{{ $iconClass }}"></i>
-                        <span class="font-medium">{{ $item['label'] ?? 'Menu' }}</span>
-                    </a>
+                    @if(!empty($item['children']))
+                        <div class="pt-2 pb-2 border-t border-slate-700/50 first:border-t-0 first:pt-0">
+                            <p class="px-4 text-xs font-semibold text-gray-500 uppercase tracking-wider mb-2">{{ $item['label'] }}</p>
+                            <div class="space-y-1">
+                                @foreach($item['children'] as $child)
+                                    @php $childActive = !empty($child['route']) ? request()->routeIs($child['route']) : false; @endphp
+                                    <a href="{{ menu_item_href($child) }}"
+                                       class="flex items-center space-x-3 px-4 py-2 rounded-lg transition-all duration-200 text-sm {{ $childActive ? 'bg-blue-500/20 text-blue-300 border border-blue-500/30' : 'text-gray-400 hover:bg-slate-700/50 hover:text-white' }}">
+                                        <i class="{{ $child['icon'] ?? 'fas fa-link w-4' }}"></i>
+                                        <span class="font-medium">{{ $child['label'] ?? 'Menu' }}</span>
+                                    </a>
+                                @endforeach
+                            </div>
+                        </div>
+                    @else
+                        <a href="{{ menu_item_href($item) }}" class="flex items-center space-x-3 px-4 py-3 rounded-xl transition-all duration-200 {{ $isActive ? 'bg-blue-500/20 text-blue-300 border border-blue-500/30 hover:bg-blue-500/30' : 'text-gray-400 hover:bg-slate-700/50 hover:text-white' }}">
+                            <i class="{{ $iconClass }}"></i>
+                            <span class="font-medium">{{ $item['label'] ?? 'Menu' }}</span>
+                       </a>
+                    @endif
                 @endforeach
             </div>
 

From 95d557840ae680df6beee25d85c63627b72a4dcc Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 14 Jun 2026 03:46:17 +0200
Subject: [PATCH 126/132] fix(donate): replace dp_total references with dp_base

adjust donation plan data selection, calculation, and frontend display to use dp_base instead of dp_total
---
 app/Modules/Donate/Http/Controllers/DonateController.php | 4 ++--
 app/Modules/Donate/Resources/views/home.blade.php        | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/app/Modules/Donate/Http/Controllers/DonateController.php b/app/Modules/Donate/Http/Controllers/DonateController.php
index 88458b2..715b7d2 100644
--- a/app/Modules/Donate/Http/Controllers/DonateController.php
+++ b/app/Modules/Donate/Http/Controllers/DonateController.php
@@ -16,7 +16,7 @@ public function index(GatewayManager $gateways)
         $available = array_map(fn($g) => ['id' => $g->id(), 'name' => $g->displayName()], $gateways->all());
         $plans = DonationPlan::query()
             ->where('active', true)
-            ->select(['id', 'name', 'amount', 'dp_total', 'sort_order'])
+            ->select(['id', 'name', 'amount', 'dp_base', 'sort_order'])
             ->orderBy('sort_order')
             ->get();
         
@@ -30,7 +30,7 @@ public function checkout(Request $request, GatewayManager $gateways)
         if ($request->filled('plan_id')) {
             $plan = DonationPlan::findOrFail($request->input('plan_id'));
             $amount = $plan->amount;
-            $dpAmount = $plan->dp_total;
+            $dpAmount = $plan->dp_base;
         } else {
             $amount = $request->input('amount', 0);
             $rate = (int) config('donate.dp_rate', 100);
diff --git a/app/Modules/Donate/Resources/views/home.blade.php b/app/Modules/Donate/Resources/views/home.blade.php
index 26e3d76..b213137 100644
--- a/app/Modules/Donate/Resources/views/home.blade.php
+++ b/app/Modules/Donate/Resources/views/home.blade.php
@@ -41,7 +41,7 @@
                     <ul class="space-y-3 mb-8">
                         <li class="flex items-start gap-2">
                             <i class="fas fa-check text-blue-500 mt-1"></i>
-                            <span class="text-slate-300">{{ number_format($plan->dp_total) }} Donation Points</span>
+                            <span class="text-slate-300">{{ number_format($plan->dp_base) }} Donation Points</span>
                         </li>
                         @if($plan->extra_pct > 0)
                             <li class="flex items-start gap-2">
@@ -86,7 +86,7 @@
                                 @endif
                             </div>
                             <div class="text-center mb-4">
-                                <span class="text-slate-300">{{ number_format($plan->dp_total) }} DP</span>
+                                <span class="text-slate-300">{{ number_format($plan->dp_base) }} DP</span>
                             </div>
                             @auth
                                 <form method="POST" action="{{ route('donate.checkout') }}">

From 43e7c19be5995cd1fcaa4e3d21130293e145f02e Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Sun, 14 Jun 2026 03:59:42 +0200
Subject: [PATCH 127/132] feat(donate): add dynamic store products and admin
 transaction filters

- replace hardcoded donate store product cards with dynamic active store listings
- add search, date range and filter controls for admin donation transactions
- fix nested blade section and dynamic balance display in store page
---
 .../Controllers/DonateAdminController.php     | 31 ++++++++--
 .../Admin/Views/transactions/index.blade.php  | 57 +++++++++++++++++++
 .../Http/Controllers/DonateController.php     | 16 +++++-
 .../Donate/Resources/views/home.blade.php     | 45 ++++-----------
 .../Store/Resources/views/store.blade.php     | 27 +++++----
 5 files changed, 123 insertions(+), 53 deletions(-)

diff --git a/app/Modules/Donate/Admin/Controllers/DonateAdminController.php b/app/Modules/Donate/Admin/Controllers/DonateAdminController.php
index 2982103..758e7aa 100644
--- a/app/Modules/Donate/Admin/Controllers/DonateAdminController.php
+++ b/app/Modules/Donate/Admin/Controllers/DonateAdminController.php
@@ -91,13 +91,36 @@ public function plansDestroy(DonationPlan $plan): RedirectResponse
 
     // ─── Transactions ─────────────────────────────────────────────────────────
 
-    public function transactionsIndex(): View
+    public function transactionsIndex(Request $request): View
     {
         $transactions = DonationTransaction::query()
             ->with('user')
+            ->when($request->filled('q'), function ($q) use ($request) {
+                $term = '%' . $request->string('q') . '%';
+                $q->where(function ($q) use ($term) {
+                    $q->where('transaction_id', 'like', $term)
+                      ->orWhereHas('user', function ($q) use ($term) {
+                          $q->where('name', 'like', $term)
+                            ->orWhere('email', 'like', $term);
+                      });
+                });
+            })
+            ->when($request->filled('gateway'), fn ($q) => $q->where('gateway', $request->string('gateway')))
+            ->when($request->filled('status'),   fn ($q) => $q->where('status', $request->string('status')))
+            ->when($request->filled('from'),     fn ($q) => $q->whereDate('created_at', '>=', $request->date('from')))
+            ->when($request->filled('to'),       fn ($q) => $q->whereDate('created_at', '<=', $request->date('to')))
             ->latest()
-            ->paginate(50);
-
-        return view('donate-admin::transactions.index', compact('transactions'));
+            ->paginate(50)
+            ->withQueryString();
+
+        $gateways = DonationTransaction::query()
+            ->select('gateway')
+            ->whereNotNull('gateway')
+            ->distinct()
+            ->orderBy('gateway')
+            ->pluck('gateway')
+            ->all();
+
+        return view('donate-admin::transactions.index', compact('transactions', 'gateways'));
     }
 }
diff --git a/app/Modules/Donate/Admin/Views/transactions/index.blade.php b/app/Modules/Donate/Admin/Views/transactions/index.blade.php
index a5d2378..6a0aaf3 100644
--- a/app/Modules/Donate/Admin/Views/transactions/index.blade.php
+++ b/app/Modules/Donate/Admin/Views/transactions/index.blade.php
@@ -11,6 +11,63 @@
 </header>
 
 <main class="flex-1 overflow-y-auto bg-gray-50 p-6">
+    {{-- Filters --}}
+    <form method="GET" action="{{ route('admin.donate.transactions.index') }}"
+          class="bg-white rounded-lg shadow p-4 mb-4 grid grid-cols-1 md:grid-cols-12 gap-3 items-end">
+        <div class="md:col-span-4">
+            <label class="block text-xs font-medium text-gray-600 mb-1">Search</label>
+            <input type="search" name="q" value="{{ request('q') }}"
+                   placeholder="User name, email, transaction ID…"
+                   class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:outline-none focus:ring-2 focus:ring-blue-500">
+        </div>
+
+        <div class="md:col-span-2">
+            <label class="block text-xs font-medium text-gray-600 mb-1">Gateway</label>
+            <select name="gateway" class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <option value="">All</option>
+                @foreach(($gateways ?? []) as $gw)
+                    <option value="{{ $gw }}" @selected(request('gateway') === $gw)>{{ ucfirst($gw) }}</option>
+                @endforeach
+            </select>
+        </div>
+
+        <div class="md:col-span-2">
+            <label class="block text-xs font-medium text-gray-600 mb-1">Status</label>
+            <select name="status" class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:outline-none focus:ring-2 focus:ring-blue-500">
+                <option value="">All</option>
+                @foreach(['completed', 'pending', 'failed', 'refunded'] as $st)
+                    <option value="{{ $st }}" @selected(request('status') === $st)>{{ ucfirst($st) }}</option>
+                @endforeach
+            </select>
+        </div>
+
+        <div class="md:col-span-2">
+            <label class="block text-xs font-medium text-gray-600 mb-1">From</label>
+            <input type="date" name="from" value="{{ request('from') }}"
+                   class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:outline-none focus:ring-2 focus:ring-blue-500">
+        </div>
+
+        <div class="md:col-span-2">
+            <label class="block text-xs font-medium text-gray-600 mb-1">To</label>
+            <input type="date" name="to" value="{{ request('to') }}"
+                   class="w-full px-3 py-2 border border-gray-300 rounded-lg text-sm focus:outline-none focus:ring-2 focus:ring-blue-500">
+        </div>
+
+        <div class="md:col-span-12 flex items-center gap-2">
+            <button type="submit" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 text-sm font-medium">
+                <i class="fas fa-filter mr-1"></i>Apply Filters
+            </button>
+            @if(request()->hasAny(['q', 'gateway', 'status', 'from', 'to']))
+                <a href="{{ route('admin.donate.transactions.index') }}" class="px-4 py-2 bg-gray-100 text-gray-700 rounded-lg hover:bg-gray-200 text-sm font-medium">
+                    <i class="fas fa-times mr-1"></i>Clear
+                </a>
+            @endif
+            <span class="ml-auto text-sm text-gray-500">
+                {{ $transactions->total() }} {{ Str::plural('transaction', $transactions->total()) }}
+            </span>
+        </div>
+    </form>
+
     <div class="bg-white rounded-lg shadow overflow-hidden">
         <table class="min-w-full divide-y divide-gray-200 text-sm">
             <thead class="bg-gray-50">
diff --git a/app/Modules/Donate/Http/Controllers/DonateController.php b/app/Modules/Donate/Http/Controllers/DonateController.php
index 715b7d2..1f21ac2 100644
--- a/app/Modules/Donate/Http/Controllers/DonateController.php
+++ b/app/Modules/Donate/Http/Controllers/DonateController.php
@@ -8,6 +8,7 @@
 use Modules\Donate\Domain\Models\DonationTransaction;
 use Illuminate\Support\Facades\DB;
 use Modules\Donate\Domain\Models\DonationPlan;
+use Modules\Store\Domain\Models\StoreProduct;
 
 class DonateController extends Controller
 {
@@ -19,8 +20,19 @@ public function index(GatewayManager $gateways)
             ->select(['id', 'name', 'amount', 'dp_base', 'sort_order'])
             ->orderBy('sort_order')
             ->get();
-        
-        return view('donate::home', ['gateways' => $available, 'plans' => $plans]); 
+
+        $storeProducts = StoreProduct::query()
+            ->where('active', true)
+            ->select(['id', 'name', 'description', 'cost', 'type', 'sort_order'])
+            ->orderBy('sort_order')
+            ->limit(4)
+            ->get();
+
+        return view('donate::home', [
+            'gateways'      => $available,
+            'plans'         => $plans,
+            'storeProducts' => $storeProducts,
+        ]);
     }
 
     public function checkout(Request $request, GatewayManager $gateways)
diff --git a/app/Modules/Donate/Resources/views/home.blade.php b/app/Modules/Donate/Resources/views/home.blade.php
index b213137..f58cfdd 100644
--- a/app/Modules/Donate/Resources/views/home.blade.php
+++ b/app/Modules/Donate/Resources/views/home.blade.php
@@ -160,41 +160,20 @@
             </div>
 
             <div class="grid md:grid-cols-4 gap-6">
-                <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-6 hover:border-blue-500/50 transition-all duration-300">
-                    <h4 class="font-bold mb-2">Epic Mount</h4>
-                    <p class="text-slate-400 text-sm mb-4">Exclusive flying mount</p>
-                    <div class="flex items-center justify-between">
-                        <span class="text-blue-500 font-semibold">1,500 DP</span>
-                        <button class="text-sm text-slate-400 hover:text-white">View</button>
-                    </div>
-                </div>
-
-                <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-6 hover:border-blue-500/50 transition-all duration-300">
-                    <h4 class="font-bold mb-2">Transmog Set</h4>
-                    <p class="text-slate-400 text-sm mb-4">Legendary appearance</p>
-                    <div class="flex items-center justify-between">
-                        <span class="text-blue-500 font-semibold">2,000 DP</span>
-                        <button class="text-sm text-slate-400 hover:text-white">View</button>
-                    </div>
-                </div>
-
-                <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-6 hover:border-blue-500/50 transition-all duration-300">
-                    <h4 class="font-bold mb-2">Name Change</h4>
-                    <p class="text-slate-400 text-sm mb-4">Change character name</p>
-                    <div class="flex items-center justify-between">
-                        <span class="text-blue-500 font-semibold">500 DP</span>
-                        <button class="text-sm text-slate-400 hover:text-white">View</button>
+                @forelse(($storeProducts ?? collect()) as $product)
+                    <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-6 hover:border-blue-500/50 transition-all duration-300">
+                        <h4 class="font-bold mb-2">{{ $product->name }}</h4>
+                        <p class="text-slate-400 text-sm mb-4">{{ $product->description ?? '—' }}</p>
+                        <div class="flex items-center justify-between">
+                            <span class="text-blue-500 font-semibold">{{ number_format($product->cost) }} DP</span>
+                            <a href="{{ route('store.index') }}" class="text-sm text-slate-400 hover:text-white">View</a>
+                        </div>
                     </div>
-                </div>
-
-                <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-6 hover:border-blue-500/50 transition-all duration-300">
-                    <h4 class="font-bold mb-2">Level Boost</h4>
-                    <p class="text-slate-400 text-sm mb-4">Instant level 70</p>
-                    <div class="flex items-center justify-between">
-                        <span class="text-blue-500 font-semibold">3,000 DP</span>
-                        <button class="text-sm text-slate-400 hover:text-white">View</button>
+                @empty
+                    <div class="md:col-span-4 text-center py-8 text-slate-400 text-sm border border-dashed border-slate-700 rounded-xl">
+                        No store products available right now.
                     </div>
-                </div>
+                @endforelse
             </div>
 
             <div class="text-center mt-8">
diff --git a/app/Modules/Store/Resources/views/store.blade.php b/app/Modules/Store/Resources/views/store.blade.php
index 6977179..3fd5adf 100644
--- a/app/Modules/Store/Resources/views/store.blade.php
+++ b/app/Modules/Store/Resources/views/store.blade.php
@@ -4,7 +4,7 @@
 
 @section('content')
     <!-- Hero Section -->
-    <div class="relative pt-32 pb-20 px-4 sm:px-6 lg:px-8">
+    <div class="relative pt-32 pb-12 px-4 sm:px-6 lg:px-8">
         <div class="max-w-7xl mx-auto">
             <div class="text-center mb-8">
                 <h1 class="text-5xl md:text-6xl font-bold mb-6">
@@ -17,27 +17,26 @@
                     <i class="fas fa-coins text-yellow-500 text-xl"></i>
                     <div class="text-left">
                         <div class="text-xs text-slate-400">Your Balance</div>
-                        <div class="text-2xl font-bold text-yellow-500">2,450 DP</div>
+                        <div class="text-2xl font-bold text-yellow-500">{{ number_format($balance) }} DP</div>
                     </div>
                 </div>
             </div>
         </div>
     </div>
 
-    @section('content')
-        <div class="max-w-7xl mx-auto pt-24 pb-14 px-4 sm:px-6 lg:px-8">
-            <div class="mb-8 bg-slate-900/60 border border-slate-800 rounded-2xl p-6 md:p-8">
-                <div class="flex flex-col md:flex-row md:items-center md:justify-between gap-6">
-                    <div>
-                        <h1 class="text-3xl md:text-4xl font-bold mb-2">Donation Store</h1>
-                        <p class="text-slate-300">Purchase account services and rewards using your Donation Points.</p>
-                    </div>
-                    <div class="rounded-xl bg-slate-950/80 border border-slate-700 px-6 py-4 min-w-[180px]">
-                        <p class="text-xs uppercase tracking-widest text-slate-400">Current Balance</p>
-                        <p class="text-3xl font-bold text-yellow-400">{{ number_format($balance) }} DP</p>
-                    </div>
+    <div class="max-w-7xl mx-auto pb-14 px-4 sm:px-6 lg:px-8">
+        <div class="mb-8 bg-slate-900/60 border border-slate-800 rounded-2xl p-6 md:p-8">
+            <div class="flex flex-col md:flex-row md:items-center md:justify-between gap-6">
+                <div>
+                    <h2 class="text-3xl md:text-4xl font-bold mb-2">Donation Store</h2>
+                    <p class="text-slate-300">Purchase account services and rewards using your Donation Points.</p>
+                </div>
+                <div class="rounded-xl bg-slate-950/80 border border-slate-700 px-6 py-4 min-w-[180px]">
+                    <p class="text-xs uppercase tracking-widest text-slate-400">Current Balance</p>
+                    <p class="text-3xl font-bold text-yellow-400">{{ number_format($balance) }} DP</p>
                 </div>
             </div>
+        </div>
 
             @if (session('success'))
                 <div class="mb-6 rounded-lg border border-green-700/60 bg-green-900/30 text-green-200 px-4 py-3">

From 7a5178d9949bccdcf28fbbb8196cc59d74a9be1d Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Mon, 6 Jul 2026 01:08:46 +0200
Subject: [PATCH 128/132] feat: implement Braintree donation checkout, user
 comment system, site installation flow, and main layout structure

---
 .env.example                                  |   3 +
 ROADMAP.md                                    | 349 ++++++++++++++++++
 .../Frontend/CommentController.php            |   2 +-
 .../Frontend/InstallController.php            |  16 +-
 .../Frontend/Users/UserController.php         |   9 +-
 app/Http/Middleware/SecurityHeaders.php       | 263 ++++++++++++-
 .../Resources/views/layouts/app.blade.php     |  17 +
 .../Http/Controllers/DonateController.php     | 267 ++++++++++++--
 app/Modules/Donate/Http/routes.php            |  34 +-
 .../Resources/views/braintree.blade.php       |  39 +-
 .../Resources/views/receipt-pdf.blade.php     |  73 ++++
 .../Donate/Resources/views/receipt.blade.php  |  13 +-
 app/Providers/AppServiceProvider.php          |  34 ++
 app/Services/InstallService.php               |  24 +-
 app/Services/SystemInfoService.php            |  30 +-
 composer.json                                 |   1 +
 config/app.php                                |   6 +-
 resources/js/bootstrap.js                     |  20 +-
 resources/views/install/index.blade.php       |   1 +
 resources/views/layouts/main.blade.php        |   1 +
 routes/console.php                            |  67 ++++
 routes/web.php                                |   2 +-
 22 files changed, 1217 insertions(+), 54 deletions(-)
 create mode 100644 ROADMAP.md
 create mode 100644 app/Modules/Donate/Resources/views/receipt-pdf.blade.php

diff --git a/.env.example b/.env.example
index bafb420..abd3c5c 100644
--- a/.env.example
+++ b/.env.example
@@ -4,6 +4,9 @@ APP_KEY=
 APP_DEBUG=true
 APP_URL="https://nexuscms.test"
 
+APP_VERSION="0.1.6-alpha.5"
+APP_CODENAME="Anvil"
+
 APP_LOCALE="en"
 APP_FALLBACK_LOCALE=en
 APP_FAKER_LOCALE=en_US
diff --git a/ROADMAP.md b/ROADMAP.md
new file mode 100644
index 0000000..804bb01
--- /dev/null
+++ b/ROADMAP.md
@@ -0,0 +1,349 @@
+# NexusCMS Roadmap — 0.1.6 → 0.2.0
+
+> Solo-developer focused. Phases are ordered by dependency, not by date.
+> Every release ships a usable, non-broken version on a fresh install.
+
+---
+
+## The Arc
+
+```
+Anvil → Vault → Hearth → Spire → Nexus
+ forge   hoard   gather   watch   connect
+```
+
+| Version | Codename    | Theme                                  | Headline                                                |
+|---------|-------------|----------------------------------------|---------------------------------------------------------|
+| 0.1.6   | **Anvil**   | Foundation. Shape the metal.            | Stability, refunds, hardened middleware, real tests.    |
+| 0.1.7   | **Vault**   | Store of value. Hold it safely.         | Multi-gateway donations + real Store CRUD.              |
+| 0.1.8   | **Hearth**  | Gathering place. The warm spot.         | Real-time notifications, profiles, 2FA, dark mode.      |
+| 0.1.9   | **Spire**   | High vantage. The watchtower.           | Operational dashboard, backups 2.0, alert webhooks.     |
+| 0.2.0   | **Nexus**   | The crossing point. The platform.       | Public REST API v1 + OAuth2 + theming + multi-tenant.   |
+
+---
+
+## Guiding Principles
+
+1. **Ship a complete phase, not half of two.** Every release is usable end-to-end on a fresh install.
+2. **Refactors before features.** Pay down debt as you go so the headline feature lands on solid ground.
+3. **One big thing per milestone.** Smaller releases are mostly quality; one release carries the headline.
+4. **Modules stay opt-in.** Nothing in a module becomes a blocker for the core install.
+5. **No paid infrastructure required.** Every headline feature must work on a single VPS. Optional integrations (Discord, S3, etc.) are pluggable.
+
+---
+
+## 🟢 0.1.6 — **Anvil**
+
+> Foundation. Where metal is shaped into something reliable.
+
+### Stability & bug fixes
+
+- Refunds flow for `DonationTransaction` (model column, controller method, admin button, `DonationPolicy`).
+- `User->dp` / `User->vp` consistency — confirm columns exist, add accessor + cast if missing.
+- Replace hardcoded dashboard counters in `app/Modules/Admin/Resources/views/index.blade.php` with real queries.
+- Sanity sweep: every `@push('styles')` is well-formed; no inline `style=""` left; no duplicate `@section('content')` anywhere.
+
+### Quality
+
+- Mail on successful donation (`DonationReceiptMail` + queue).
+- Rate-limit `donate.checkout` (`throttle:5,1`).
+- PDF receipt via a queued Artisan command (`php artisan donate:receipt-pdf {tx}`).
+- CSRF token meta + `axios` interceptor already in place — verify it's used everywhere there's AJAX (menu manager, route picker).
+- Strengthen `SecurityHeaders` middleware: add `Permissions-Policy`, harden `Content-Security-Policy` with nonce for inline scripts.
+
+### Testing
+
+- Feature tests for `DonateController` (with mocked Braintree).
+- Feature tests for `MenuManagerController` (CRUD + reorder).
+- Feature tests for `UpdateService` (with mocked GitHub).
+- Feature tests for `SecurityHeaders` middleware.
+- Optional: browser tests (Pest + Laravel Dusk) for menu drag & drop and donate checkout.
+
+### DX
+
+- One-command install + seed: `php artisan nexus:install --demo`.
+- `php artisan nexus:health` (uses `SystemInfoService` and reports issues).
+
+### Done when
+
+- All `must` and `should` items above are merged.
+- No `alpha` / `beta` tag in `config/app.php` — just `0.1.6`.
+- `CHANGELOG.md` lists every closed issue.
+
+---
+
+## 🔵 0.1.7 — **Vault**
+
+> Store of value. Where money and modules accumulate safely.
+
+### Headline: Multi-gateway donations with a unified interface
+
+- Move `GatewayManager` behind a proper `DonationService` that handles:
+  - Gateway selection.
+  - Transaction lifecycle: `pending → completed / failed / refunded`.
+  - Idempotency key.
+  - Webhook routing.
+- Add **Stripe** gateway (`StripeGateway implements PaymentGatewayInterface`).
+- Add **PayPal** gateway (IPN + REST).
+- Per-gateway settings tabs in `Settings → Payment`.
+- Gateway enable/disable + sandbox toggle per gateway.
+
+### Store: real persistence
+
+- Replace JSON product list with a proper admin CRUD backed by `store_products` table (migration already exists).
+- Admin UI: list, create, edit, archive products. Reuse the existing `GenericCrudController` machinery.
+- Frontend `store.blade.php` reads from DB and filters by realm / type / category.
+- Purchase history per user.
+
+### Forum v2
+
+- Thread subscriptions + email notifications.
+- Reactions (curated emoji set, no third-party).
+- Soft-delete with "deleted by" + restore for moderators.
+- Per-forum permissions — finish what's already partially in place.
+
+### Admin polish
+
+- Audit log: who did what, when, from where. New `audit_logs` table + observer on every admin controller.
+- Bulk actions on Users: ban, role change, send password reset.
+- Bulk actions on Realms: test connection, sync characters.
+- Saved filters on Users / Transactions.
+
+### Refactor
+
+- Extract a real `PermissionService` so policies stop reading settings directly.
+- Centralize flash messages via a Blade component: `<x-flash type="success">…</x-flash>`.
+
+### Done when
+
+- A donation can be started in Braintree sandbox and completed in Stripe sandbox with the same UX.
+- The admin can create, edit, archive, and unarchive a store product through the UI.
+- Every admin write action appears in `audit_logs`.
+
+---
+
+## 🟣 0.1.8 — **Hearth**
+
+> Gathering place. Where the community comes back to.
+
+### Headline: Real-time notifications with Laravel Reverb
+
+- Bell icon in the layout becomes functional.
+- Channels:
+  - New forum reply.
+  - New donation received (admin).
+  - New comment on a followed news post.
+  - System alert.
+- Server-side: broadcasting events.
+- Client-side: a small JS listener that fetches and renders.
+- Per-user preferences: in-app, email, both, none.
+
+### News & content
+
+- Featured image, gallery, tags.
+- Scheduled publishing (`publish_at` + scheduler).
+- RSS feed per category.
+- Full-text search on news + forum threads (SQLite FTS5 or MySQL FULLTEXT).
+
+### User-facing account
+
+- Profile page: linked realms, donation history, forum threads, news comments.
+- Notification center (in-app history).
+- Two-factor auth (TOTP) — opt-in per user, mandatory for admins.
+
+### Frontend
+
+- Dark mode toggle with persisted preference.
+- Locale switcher that respects URL (`/es/...`, `/en/...`) and user preference.
+- PWA basics: manifest, service worker, offline fallback.
+
+### Refactor
+
+- Move all hardcoded English strings into `lang/en` + `lang/es` (donation and store views have a lot).
+- Standardize icons: one set (FontAwesome subset or Lucide) across all modules.
+
+### Done when
+
+- An admin sees a notification within ~2 seconds of a new donation, both in the bell icon and via the optional Discord webhook.
+- A forum subscriber receives an email and an in-app notification when a reply is posted.
+- Dark mode preference survives a logout.
+
+---
+
+## 🟠 0.1.9 — **Spire**
+
+> High vantage point. The watchtower over the whole operation.
+
+### Headline: Operational dashboard & alerting
+
+- Replace the current admin dashboard with a real ops view:
+  - Error rate.
+  - p95 response time.
+  - Donation / hour.
+  - Online players / realm.
+  - Queue depth.
+- Optional integrations:
+  - Discord webhooks (admin alerts, new donations).
+  - Telegram bot.
+  - Email digests.
+- SLO tracking: configurable thresholds, breach notifications.
+
+### Backups 2.0
+
+- Scheduled backups (Laravel scheduler).
+- Off-site destinations: S3, Backblaze B2, FTP/SFTP.
+- Encrypted backups (per-environment key).
+- One-click restore to a chosen environment with a dry-run preview.
+
+### Updates 2.0
+
+- Pre-flight check before applying:
+  - PHP version.
+  - Required extensions.
+  - Migration compatibility.
+  - Disk space.
+- Staged rollout: download → verify checksum → migrate → swap symlinks → rollback on failure.
+- Update channels: `stable`, `beta`, `nightly`.
+
+### Security
+
+- IP allowlist for `/acp` (optional).
+- Force password reset on next login for users flagged in a breach.
+- Session hardening dashboard: active sessions, kill remote.
+
+### DX
+
+- `php artisan nexus:smoke` — boots the app, hits key routes, verifies DB + cache + queue, reports health.
+- Generated OpenAPI spec for the internal admin API.
+- Telemetry opt-in (anonymous version + module count for project stats).
+
+### Done when
+
+- A scheduled backup runs at 03:00 every night, ships to S3, and is restorable in a dry run.
+- A breach of an SLO threshold pings a Discord channel within one minute.
+- `nexus:smoke` exits non-zero when any dependency is broken.
+
+---
+
+## 🔴 0.2.0 — **Nexus**
+
+> The crossing point. Where NexusCMS stops being a CMS and becomes a platform.
+
+### Headline: Public REST API v1
+
+- Versioned, OAuth2-protected (Passport or first-party OAuth via Sanctum).
+- Resources:
+  - Users (scoped).
+  - Realms.
+  - Characters.
+  - News.
+  - Forum threads.
+  - Donations (read-only).
+  - Store products.
+- Webhooks:
+  - `donation.completed`
+  - `donation.refunded`
+  - `user.created`
+  - `forum.thread.created`
+- Rate limiting per token.
+- Public OpenAPI 3.1 spec served at `/api/docs` (using Scribe or Spectacle).
+- Client SDKs: PHP, JavaScript / TypeScript (auto-generated from OpenAPI).
+- Sandbox keys + live keys, per-key scopes.
+
+### Theming & white-label
+
+- Theme = Blade views + CSS + JSON config, packaged as a module.
+- Three reference themes shipped: `default-dark`, `default-light`, `esports`.
+- Theme marketplace metadata (manifest, preview image, version). Distribution itself is 0.3.x.
+
+### Multi-tenant light
+
+- Single installation serves multiple isolated realm communities, each with its own domain / subdomain, theme, and admin team.
+- Tenant-aware cache keys, queue names, log channels.
+- Cross-tenant prevention is test-covered.
+
+### Breaking-change prep
+
+- Drop Laravel 11 support, require Laravel 12.
+- Drop PHP 8.2 support, require PHP 8.3+.
+- Public API v1 contract frozen; deprecation policy documented.
+
+### Refactor
+
+- Extract core into `NexusCMS\Core` package consumable by both the monolithic app and a future slim headless install.
+- Move admin module behind a feature flag so a headless install can run without it.
+
+### Done when
+
+- A partner can register an OAuth app, get a token, and list donations with one curl command.
+- Two tenants on the same install cannot see each other's data, even through the admin panel.
+- The OpenAPI spec builds and ships green from CI.
+
+---
+
+## ⚪ Stretch / Post-0.2.0 (parking lot)
+
+These are real candidates but **explicitly out** of the 0.1.6 → 0.2.0 line. They get evaluated after 0.2.0 ships.
+
+- **Theme marketplace** — distribution + payments for community themes.
+- **Plugin marketplace** — discovery + signed distribution of community modules.
+- **Mobile app** (React Native or Flutter) consuming the public API.
+- **AI assistant module** — admin-side natural-language queries over the DB.
+- **Mobile push** via the same Reverb channel, bridged through APNs / FCM.
+- **Donation store frontends** as embeddable widgets (`<nexus-store realm="..."></nexus-store>`).
+
+---
+
+## Decision Log (assumptions made)
+
+1. **Solo-dev throughput**: each phase is a few weeks of focused work, not months. Anything that doesn't fit in one phase gets split or parked.
+2. **WoW private-server context stays primary**: the realm model, TrinityCore integration, and SOAP account creator stay first-class. Multi-game expansion is out of scope.
+3. **No paid infrastructure required**: every headline feature works on a single VPS. Optional integrations are pluggable.
+4. **Backwards compatibility within 0.1.x**: data and config migrations only when truly necessary. Schema-breaking changes are reserved for 0.2.0.
+5. **English-first, Spanish-mirrored**: copy lives in `lang/en`, with `lang/es` updated as part of the same PR. No machine-translation pipelines in core.
+6. **Solo-dev sanity**: each phase's "Done when" must be checkable by one person in one sitting. If it isn't, the phase is too big.
+
+---
+
+## How to use the codenames
+
+### In `CHANGELOG.md`
+
+```markdown
+## 0.2.0 "Nexus" — Headless & Extensible
+
+Public REST API v1 with OAuth2...
+```
+
+### In commit messages and PR titles
+
+```
+feat(api): release public REST v1 (0.2.0 "Nexus")
+```
+
+### In `config/app.php`
+
+```php
+'version'   => env('APP_VERSION', '0.2.0'),
+'codename'  => env('APP_CODENAME', 'Nexus'),
+```
+
+The `SystemInfoService` already exposes the version; wire it to also expose the codename so the admin dashboard reads:
+
+```
+NexusCMS 0.2.0 · Nexus
+```
+
+---
+
+## Micro-release convention
+
+If a phase grows too large for one release slot, split it into a `.1` and `.2` keeping the same codename suffix:
+
+| Release     | Codename        |
+|-------------|-----------------|
+| 0.1.7.0     | Vault           |
+| 0.1.7.1     | Vault Patch     |
+| 0.1.7.2     | Vault Reforge   |
+
+Use the suffix only when the work is recognizably inside the same codename's theme. If you have to explain why a patch fits, it doesn't — cut a new minor instead.
diff --git a/app/Http/Controllers/Frontend/CommentController.php b/app/Http/Controllers/Frontend/CommentController.php
index 789c5d0..a5cd8c9 100644
--- a/app/Http/Controllers/Frontend/CommentController.php
+++ b/app/Http/Controllers/Frontend/CommentController.php
@@ -22,7 +22,7 @@ class CommentController extends Controller
     public function store(Request $request, $slug)
     {
         $request->validate([
-            'body' => 'required|string',
+            'body' => 'required|string|max:10000',
         ]);
 
         $news = News::where('slug', $slug)->firstOrFail();
diff --git a/app/Http/Controllers/Frontend/InstallController.php b/app/Http/Controllers/Frontend/InstallController.php
index 92dfde2..05a055a 100644
--- a/app/Http/Controllers/Frontend/InstallController.php
+++ b/app/Http/Controllers/Frontend/InstallController.php
@@ -52,7 +52,14 @@ public function testDb(Request $request)
 
             return response()->json(['success' => true, 'message' => '✅ Conexión exitosa']);
         } catch (Exception $e) {
-            return response()->json(['success' => false, 'message' => '❌ Error: ' . $e->getMessage()]);
+            \Illuminate\Support\Facades\Log::warning('Install DB test failed', [
+                'host' => $payload['db_host'],
+                'port' => $payload['db_port'],
+                'database' => $payload['db_name'],
+                'error' => $e->getMessage(),
+            ]);
+
+            return response()->json(['success' => false, 'message' => '❌ No se pudo conectar a la base de datos. Verifique las credenciales e intente de nuevo.']);
         }
     }
 
@@ -73,9 +80,14 @@ public function install(Request $request)
         try {
             $service->run($validated);
         } catch (\Throwable $exception) {
+            \Illuminate\Support\Facades\Log::error('Installation failed', [
+                'error' => $exception->getMessage(),
+                'trace' => $exception->getTraceAsString(),
+            ]);
+
             return back()
                 ->withInput()
-                ->withErrors(['install' => 'No se pudo completar la instalación: ' . $exception->getMessage()]);
+                ->withErrors(['install' => 'No se pudo completar la instalación. Revise los logs del servidor para más detalles.']);
         }
 
         $lockContent = now()->toDateTimeString();
diff --git a/app/Http/Controllers/Frontend/Users/UserController.php b/app/Http/Controllers/Frontend/Users/UserController.php
index 09ff538..65a3173 100755
--- a/app/Http/Controllers/Frontend/Users/UserController.php
+++ b/app/Http/Controllers/Frontend/Users/UserController.php
@@ -6,6 +6,7 @@
 use Illuminate\Http\Request;
 use Illuminate\Contracts\Auth\Factory as AuthFactory;
 use Illuminate\Contracts\Hashing\Hasher as HasherContract;
+use Illuminate\Support\Facades\Log;
 use App\Exceptions\UserNotFoundException;
 use App\Helpers\RealmHelper;
 use App\Libraries\Auth\AccountLibrary;
@@ -374,9 +375,15 @@ public function createGameAccount(Request $request)
                 ->with('success', 'Cuenta de juego creada y vinculada exitosamente.');
 
         } catch (\Exception $e) {
+            Log::error('Game account creation failed', [
+                'user_id' => $request->user()?->id,
+                'realm_id' => $request->realm,
+                'error' => $e->getMessage(),
+            ]);
+
             return redirect()->back()
                 ->withInput()
-                ->with('error', 'Error al crear la cuenta de juego: ' . $e->getMessage());
+                ->with('error', 'Error al crear la cuenta de juego. Por favor, inténtalo de nuevo más tarde.');
         }
     }
 }
diff --git a/app/Http/Middleware/SecurityHeaders.php b/app/Http/Middleware/SecurityHeaders.php
index c31bd62..3621569 100644
--- a/app/Http/Middleware/SecurityHeaders.php
+++ b/app/Http/Middleware/SecurityHeaders.php
@@ -4,6 +4,7 @@
 
 use Closure;
 use Illuminate\Http\Request;
+use Illuminate\Support\Str;
 use Symfony\Component\HttpFoundation\Response;
 
 class SecurityHeaders
@@ -11,18 +12,274 @@ class SecurityHeaders
     /**
      * Handle an incoming request.
      *
+     * Adds a hardened set of security response headers, including a
+     * Content-Security-Policy with strict allowlists for scripts,
+     * styles, fonts, images, frames and connections.
+     *
+     * Implementation notes:
+     *  - A per-request nonce is generated and exposed as
+     *    `$request->attributes->get('csp_nonce')` so views can opt in
+     *    to a stricter CSP later by writing
+     *    `<script nonce="{{ $csp_nonce }}">…</script>`. The nonce is
+     *    **not** included in the CSP source list right now on purpose:
+     *    per CSP spec, when a nonce is present, `'unsafe-inline'` is
+     *    ignored — so until every inline script is migrated, the
+     *    nonce would silently break the app.
+     *  - `'unsafe-inline'` is currently allowed in script-src and
+     *    style-src. It can be removed once every <script> and inline
+     *    event handler is migrated to use the nonce (or bound via
+     *    addEventListener).
+     *  - `'unsafe-eval'` is whitelisted only in non-production because
+     *    Vite's dev server ships ES modules that need it.
+     *  - Cross-Origin-Opener-Policy (and the related COEP/CORP trio)
+     *    are only emitted when the response's origin is a "potentially
+     *    trustworthy origin" (HTTPS or localhost). On plain HTTP dev
+     *    URLs the browser ignores them anyway and warns noisily in the
+     *    console, so we just don't send the header.
+     *
      * @param  \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response)  $next
      */
     public function handle(Request $request, Closure $next): Response
     {
+        // Generate a per-request nonce even though we don't put it in
+        // CSP yet, so views can start adopting it (`<script nonce="{{ $csp_nonce }}">`)
+        // without a second middleware change.
+        $nonce = Str::random(24);
+        $request->attributes->set('csp_nonce', $nonce);
+
+        /** @var Response $response */
         $response = $next($request);
 
+        $isProduction     = app()->environment('production');
+        $trustworthyOrigin = $this->isTrustworthyOrigin($request);
+
+        // ─── Frame / sniffing / XSS basics ────────────────────────────────
         $response->headers->set('X-Frame-Options', 'SAMEORIGIN');
         $response->headers->set('X-Content-Type-Options', 'nosniff');
-        $response->headers->set('X-XSS-Protection', '1; mode=block');
+        $response->headers->set('X-XSS-Protection', '0');
+        // X-XSS-Protection is deprecated and can introduce vulnerabilities
+        // in older browsers. Modern browsers honor CSP instead.
         $response->headers->set('Referrer-Policy', 'strict-origin-when-cross-origin');
-        $response->headers->set('Permissions-Policy', 'camera=(), microphone=(), geolocation=()');
+
+        // ─── Permissions Policy ──────────────────────────────────────────
+        // Disable every powerful browser feature by default. Add back the
+        // ones the app actually needs (none, currently).
+        $response->headers->set('Permissions-Policy', implode(', ', [
+            'accelerometer=()',
+            'autoplay=()',
+            'camera=()',
+            'cross-origin-isolated=()',
+            'display-capture=()',
+            'encrypted-media=()',
+            'fullscreen=(self)',
+            'geolocation=()',
+            'gyroscope=()',
+            'keyboard-map=()',
+            'magnetometer=()',
+            'microphone=()',
+            'midi=()',
+            'payment=()',
+            'picture-in-picture=()',
+            'publickey-credentials-get=()',
+            'screen-wake-lock=()',
+            'sync-xhr=()',
+            'usb=()',
+            'xr-spatial-tracking=()',
+        ]));
+
+        // ─── Cross-origin isolation ──────────────────────────────────────
+        // Browsers silently ignore these on non-trustworthy origins,
+        // but they still log a console warning — so we don't send them
+        // at all when serving plain HTTP from a non-localhost host.
+        if ($trustworthyOrigin) {
+            $response->headers->set('Cross-Origin-Opener-Policy', 'same-origin');
+            $response->headers->set('Cross-Origin-Resource-Policy', 'same-origin');
+        }
+
+        // ─── HSTS — production only ──────────────────────────────────────
+        // 1 year, include subdomains, eligible for preload. We only set
+        // this in production because dev runs over plain HTTP.
+        if ($isProduction) {
+            $response->headers->set(
+                'Strict-Transport-Security',
+                'max-age=31536000; includeSubDomains; preload'
+            );
+        }
+
+        // ─── Content-Security-Policy ─────────────────────────────────────
+        $csp = $this->buildContentSecurityPolicy($isProduction);
+        $response->headers->set('Content-Security-Policy', $csp);
+
+        // ─── Hide identifying headers ────────────────────────────────────
+        $response->headers->remove('X-Powered-By');
+        $response->headers->remove('Server');
 
         return $response;
     }
-}
\ No newline at end of file
+
+    /**
+     * Build the Content-Security-Policy header value.
+     *
+     * Centralized so we can iterate on it without touching the rest of
+     * the middleware. The list of allowed sources mirrors what the app
+     * actually loads — nothing more, nothing less.
+     *
+     * TODO(security-hardening): the legacy menu manager, installer wizard,
+     * admin update view, and donate checkout still rely on inline event
+     * handlers and inline <script> blocks. Once those are migrated to
+     * nonce'd scripts and addEventListener bindings, drop `'unsafe-inline'`
+     * from `script-src` and `style-src` here. Then re-add `'nonce-…'`
+     * (currently omitted to avoid the spec rule that says 'unsafe-inline'
+     * is ignored when a nonce is present).
+     *
+     * CSP is intentionally still useful without removing 'unsafe-inline':
+     * - `frame-ancestors 'self'` blocks clickjacking via iframe.
+     * - `object-src 'none'` blocks Flash/Java applets (still required by PCI).
+     * - `base-uri 'self'` blocks <base href> hijacking.
+     * - `form-action 'self'` blocks form submission to attacker hosts.
+     * - The per-origin allowlists for scripts/frames/connect prevent
+     *   arbitrary third-party JS execution.
+     */
+    protected function buildContentSecurityPolicy(bool $isProduction): string
+    {
+        // Source list used by both production and dev CSP. The nonce is
+        // intentionally NOT included right now (see class docblock) —
+        // 'unsafe-inline' takes effect only when no nonce is present.
+        $scriptSrc = [
+            "'self'",
+            // TODO(security-hardening): remove once every inline script
+            // and inline event handler carries a nonce attribute. Until
+            // then this is the load-bearing entry that keeps the app working.
+            "'unsafe-inline'",
+            // ── Third-party hosts actually used by the app ──────────────
+            'https://unpkg.com',           // Alpine.js
+            'https://cdn.ckeditor.com',    // CKEditor 5
+            'https://cdnjs.cloudflare.com',// FontAwesome, etc.
+            'https://kit.fontawesome.com', // FA kit
+            'https://cdn.tailwindcss.com', // Tailwind CDN (maintenance page)
+            'https://js.braintreegateway.com', // Braintree loader
+            'https://assets.braintreegateway.com', // Braintree drop-in iframe scripts
+        ];
+
+        $styleSrc = [
+            "'self'",
+            // Tailwind via Vite emits inline styles in dev. Required
+            // until the build pipeline inlines all stylesheets.
+            "'unsafe-inline'",
+            'https://fonts.googleapis.com',
+            'https://cdnjs.cloudflare.com',
+            'https://ka-f.fontawesome.com',
+            'https://assets.braintreegateway.com', // Braintree drop-in CSS
+        ];
+
+        $fontSrc = [
+            "'self'",
+            'data:',
+            'https://fonts.gstatic.com',
+            'https://cdnjs.cloudflare.com',
+            'https://ka-f.fontawesome.com',
+        ];
+
+        $imgSrc = [
+            "'self'",
+            'data:',
+            'blob:',
+            'https:',                       // Wowhead icons, ui-avatars, etc.
+            'https://assets.braintreegateway.com', // Braintree drop-in card icons
+        ];
+
+        $connectSrc = [
+            "'self'",
+            // CKEditor may need to talk to its CDN for assets
+            'https://cdn.ckeditor.com',
+            // ── Braintree ───────────────────────────────────────────────
+            // The drop-in UI loads in an iframe from assets.braintreegateway.com
+            // and that iframe talks to the Braintree GraphQL endpoints below
+            // for tokenization, 3DS, and PayPal flows. Without these in
+            // connect-src the browser blocks those XHRs.
+            'https://js.braintreegateway.com',
+            'https://assets.braintreegateway.com',
+            'https://payments.sandbox.braintree-api.com',
+            'https://payments.braintree-api.com',
+            'https://api.sandbox.braintreegateway.com',
+            'https://api.braintreegateway.com',
+            'https://client-analytics.sandbox.braintree-api.com',
+            'https://client-analytics.braintree-api.com',
+            // ── PayPal ──────────────────────────────────────────────────
+            'https://www.paypal.com',
+            'https://www.sandbox.paypal.com',
+            // ── Stripe ──────────────────────────────────────────────────
+            'https://api.stripe.com',
+        ];
+
+        $frameSrc = [
+            "'self'",
+            // Braintree hosted fields, PayPal smart buttons
+            'https://js.braintreegateway.com',
+            'https://assets.braintreegateway.com',
+            'https://www.paypal.com',
+            'https://hooks.stripe.com',
+        ];
+
+        $mediaSrc     = ["'self'"];
+        $objectSrc    = ["'none'"];
+        $baseUri      = ["'self'"];
+        $formAction   = ["'self'"];
+        $frameAncestors = ["'self'"];
+        $manifestSrc  = ["'self'"];
+
+        // Vite dev server needs unsafe-eval and the @vite host.
+        if (!$isProduction) {
+            $scriptSrc[] = "'unsafe-eval'";
+            $scriptSrc[] = 'http://localhost:5173';
+            $scriptSrc[] = 'ws://localhost:5173';
+            $connectSrc[] = 'ws://localhost:5173';
+            $connectSrc[] = 'http://localhost:5173';
+        }
+
+        $directives = [
+            "default-src 'self'",
+            "script-src " . implode(' ', $scriptSrc),
+            "style-src " . implode(' ', $styleSrc),
+            "font-src " . implode(' ', $fontSrc),
+            "img-src " . implode(' ', $imgSrc),
+            "connect-src " . implode(' ', $connectSrc),
+            "frame-src " . implode(' ', $frameSrc),
+            "media-src " . implode(' ', $mediaSrc),
+            "object-src " . implode(' ', $objectSrc),
+            "base-uri " . implode(' ', $baseUri),
+            "form-action " . implode(' ', $formAction),
+            "frame-ancestors " . implode(' ', $frameAncestors),
+            "manifest-src " . implode(' ', $manifestSrc),
+            $isProduction ? 'upgrade-insecure-requests' : '',
+            'block-all-mixed-content',
+        ];
+
+        return implode('; ', array_filter($directives));
+    }
+
+    /**
+     * Whether the response will be served from a "potentially trustworthy
+     * origin" — i.e. one where the browser will honor headers like
+     * Cross-Origin-Opener-Policy and Cross-Origin-Embedder-Policy.
+     *
+     * Per the HTML spec, trustworthy origins are:
+     *  - HTTPS (any host)
+     *  - localhost (any port)
+     *  - 127.0.0.1 / ::1 (any port)
+     *  - file:// (rare in web context)
+     *
+     * Reference: https://www.w3.org/TR/powerful-features/#potentially-trustworthy-origin
+     */
+    protected function isTrustworthyOrigin(Request $request): bool
+    {
+        if ($request->isSecure()) {
+            return true;
+        }
+
+        $host = strtolower((string) $request->getHost());
+
+        return in_array($host, ['localhost', '127.0.0.1', '[::1]', '::1'], true)
+            || str_ends_with($host, '.localhost');
+    }
+}
diff --git a/app/Modules/Admin/Resources/views/layouts/app.blade.php b/app/Modules/Admin/Resources/views/layouts/app.blade.php
index 2640697..8781428 100644
--- a/app/Modules/Admin/Resources/views/layouts/app.blade.php
+++ b/app/Modules/Admin/Resources/views/layouts/app.blade.php
@@ -321,6 +321,23 @@ class="w-9 h-9 flex items-center justify-center rounded-lg text-gray-500 hover:b
             @yield('content')
         </main>
 
+        {{-- Footer --}}
+        <footer class="shrink-0 bg-white border-t border-gray-200 px-6 py-2.5 flex items-center justify-between text-xs text-gray-500">
+            <div class="flex items-center gap-2">
+                <i class="fas fa-cubes text-blue-500"></i>
+                <span class="font-semibold text-gray-700">{{ config('app.name', 'NexusCMS') }}</span>
+                <span class="text-gray-400">·</span>
+                <span>{{ app(\App\Services\SystemInfoService::class)->getFullVersion() }}</span>
+            </div>
+            <div class="flex items-center gap-3">
+                <a href="{{ route('admin.updates.index') }}" class="hover:text-blue-600 transition" title="Check for updates">
+                    <i class="fas fa-cloud-arrow-up"></i>
+                </a>
+                <span class="text-gray-300">|</span>
+                <span>&copy; {{ date('Y') }} {{ config('app.name', 'NexusCMS') }}</span>
+            </div>
+        </footer>
+
     </div>
 </div>
 
diff --git a/app/Modules/Donate/Http/Controllers/DonateController.php b/app/Modules/Donate/Http/Controllers/DonateController.php
index 1f21ac2..7f4ada7 100644
--- a/app/Modules/Donate/Http/Controllers/DonateController.php
+++ b/app/Modules/Donate/Http/Controllers/DonateController.php
@@ -4,9 +4,12 @@
 
 use App\Http\Controllers\Controller;
 use Illuminate\Http\Request;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
 use Modules\Donate\Services\GatewayManager;
 use Modules\Donate\Domain\Models\DonationTransaction;
-use Illuminate\Support\Facades\DB;
 use Modules\Donate\Domain\Models\DonationPlan;
 use Modules\Store\Domain\Models\StoreProduct;
 
@@ -35,64 +38,168 @@ public function index(GatewayManager $gateways)
         ]);
     }
 
+    /**
+     * Handle a donation checkout request.
+     *
+     * Authorization: the user must be authenticated.
+     */
     public function checkout(Request $request, GatewayManager $gateways)
     {
         $gatewayId = $request->string('gateway')->toString();
-        
+
         if ($request->filled('plan_id')) {
             $plan = DonationPlan::findOrFail($request->input('plan_id'));
             $amount = $plan->amount;
             $dpAmount = $plan->dp_base;
         } else {
-            $amount = $request->input('amount', 0);
+            $amount = (float) $request->input('amount', 0);
             $rate = (int) config('donate.dp_rate', 100);
-            $dpAmount = (int) (($request->input('amount', 0)) * $rate);
+            $dpAmount = (int) ($amount * $rate);
         }
-        
+
         $gateway = $gateways->get($gatewayId);
         abort_unless($gateway, 404);
-        
+
         $meta = ['user_id' => optional($request->user())->id];
-        
+
         if ($request->filled('nonce')) {
             $meta['nonce'] = $request->input('nonce');
         }
-        
+
+        // ─── Idempotency: nonce is single-use by Braintree's design ──────
+        // If the same nonce arrives twice (double-click, back-button,
+        // network retry), short-circuit to the existing transaction's
+        // receipt instead of re-submitting to Braintree (which would
+        // return "Cannot use a paymentMethodNonce more than once").
+        //
+        // We use a Cache lock so two concurrent requests with the same
+        // nonce can't both reach Braintree — the second one waits on
+        // the lock and then reads the cached tx id the first one wrote.
+        if (!empty($meta['nonce'])) {
+            $nonce    = $meta['nonce'];
+            $cacheKey = "donate:nonce:{$nonce}";
+
+            $outcome = Cache::lock($cacheKey, 15)->block(5, function () use ($cacheKey, $gateway, $amount, $meta, $gatewayId, $dpAmount, $request) {
+                // Did a previous request already complete this nonce?
+                $cached = Cache::get("{$cacheKey}:tx");
+                if ($cached) {
+                    return ['status' => 'duplicate', 'tx_id' => $cached];
+                }
+
+                $result = $gateway->createCheckout($amount, $meta);
+
+                if (($result['status'] ?? null) === 'success') {
+                    $txId = $this->persistSuccessfulDonation(
+                        $request->user(),
+                        $gatewayId,
+                        $amount,
+                        $dpAmount,
+                        $result
+                    );
+
+                    if ($txId) {
+                        // Remember for 24h — covers retries, back-button,
+                        // impatient users. Long enough to outlive any
+                        // reasonable duplicate submission.
+                        Cache::put("{$cacheKey}:tx", $txId, now()->addDay());
+                        return ['status' => 'success', 'tx_id' => $txId];
+                    }
+                }
+
+                // Gateway failed (or DB write failed). Surface the
+                // raw gateway response so the user sees the real error.
+                // We deliberately do NOT cache this — a transient card
+                // decline with the same nonce is impossible (the nonce
+                // is already consumed on the Braintree side), but we
+                // also don't want to lock the user out for 24h.
+                return ['status' => 'error', 'result' => $result];
+            });
+
+            switch ($outcome['status']) {
+                case 'duplicate':
+                case 'success':
+                    return redirect()->route('donate.receipt', ['id' => $outcome['tx_id']]);
+
+                case 'error':
+                default:
+                    return response()->json(
+                        $outcome['result'] ?? ['status' => 'error', 'errors' => ['unknown']],
+                        400
+                    );
+            }
+        }
+
+        // ─── First leg: no nonce yet, just return the Drop-in form ──────
         $result = $gateway->createCheckout($amount, $meta);
-        
+
         if (isset($result['client_token'])) {
             return view('donate::braintree', ['token' => $result['client_token'], 'amount' => $amount]);
         }
-        
+
         if (isset($result['redirect_url'])) {
             return redirect()->away($result['redirect_url']);
         }
-        
+
+        // Some gateways complete on first call (no Drop-in UI).
         if (($result['status'] ?? null) === 'success') {
-            $user = $request->user();
-            $txId = null;
-            
-            DB::transaction(function () use ($user, $gatewayId, $amount, $dpAmount, $result, &$txId) {
-                $tx = DonationTransaction::create([
-                    'user_id' => $user->id,
-                    'gateway' => $gatewayId,
-                    'transaction_id' => $result['transaction_id'] ?? null,
-                    'amount' => $amount,
-                    'currency' => 'USD',
-                    'dp_awarded' => $dpAmount,
-                    'status' => 'completed',
-                    'meta' => ['raw' => $result],
-                ]);
-                $user->increment('dp', $dpAmount);
-                $txId = $tx->id;
-            });
-            
-            return redirect()->route('donate.receipt', ['id' => $txId]);
+            $txId = $this->persistSuccessfulDonation(
+                $request->user(),
+                $gatewayId,
+                $amount,
+                $dpAmount,
+                $result
+            );
+
+            if ($txId) {
+                return redirect()->route('donate.receipt', ['id' => $txId]);
+            }
         }
-        
+
         return response()->json($result, 400);
     }
 
+    /**
+     * Persist a successful gateway response to the DB and credit the
+     * user with DP. Returns the new transaction ID, or null on failure.
+     *
+     * Kept private so the idempotency wrapper in checkout() can call it
+     * from inside the lock without re-implementing the write logic.
+     */
+    protected function persistSuccessfulDonation(
+        $user,
+        string $gatewayId,
+        float $amount,
+        int $dpAmount,
+        array $result
+    ): ?int {
+        if (!$user) {
+            Log::error('Donate: successful gateway response but no authenticated user', [
+                'gateway'        => $gatewayId,
+                'transaction_id' => $result['transaction_id'] ?? null,
+            ]);
+            return null;
+        }
+
+        $txId = null;
+
+        DB::transaction(function () use ($user, $gatewayId, $amount, $dpAmount, $result, &$txId) {
+            $tx = DonationTransaction::create([
+                'user_id'        => $user->id,
+                'gateway'        => $gatewayId,
+                'transaction_id' => $result['transaction_id'] ?? null,
+                'amount'         => $amount,
+                'currency'       => 'USD',
+                'dp_awarded'     => $dpAmount,
+                'status'         => 'completed',
+                'meta'           => ['raw' => $result],
+            ]);
+            $user->increment('dp', $dpAmount);
+            $txId = $tx->id;
+        });
+
+        return $txId;
+    }
+
     public function callback(string $gateway, Request $request, GatewayManager $gateways)
     {
         $gw = $gateways->get($gateway);
@@ -117,4 +224,102 @@ public function receipt(int $id)
             ->firstOrFail();
         return view('donate::receipt', ['tx' => $tx]);
     }
+
+    /**
+     * Stream the donation receipt as a PDF download.
+     *
+     * Authorization: the user must own the transaction. There is no
+     * admin override on this route — admins should download via the
+     * admin transactions panel if needed.
+     *
+     * Flow:
+     *   1. Resolve the transaction (404 / 403 otherwise).
+     *   2. Persist the rendered PDF to storage/app/receipts/ so the
+     *      nightly cleanup task can prune old files (see
+     *      routes/console.php). The filename is deterministic — same
+     *      transaction always maps to the same file — so re-downloads
+     *      don't accumulate duplicates.
+     *   3. Stream the persisted file as the response. If writing to
+     *      disk fails for any reason, we fall back to streaming the
+     *      PDF directly from DomPDF without persistence.
+     *
+     * If the barryvdh/laravel-dompdf package is not installed, we
+     * fall back to the HTML receipt so the user always gets *something*
+     * useful instead of a 500.
+     */
+    public function receiptPdf(int $id)
+    {
+        $tx = DonationTransaction::query()
+            ->with('user')
+            ->where('id', $id)
+            ->where('user_id', auth()->id())
+            ->firstOrFail();
+
+        $filename     = 'donation-receipt-' . $tx->id . '.pdf';
+        $downloadName = 'donation-receipt-' . $tx->id . '.pdf';
+
+        if (!class_exists(\Barryvdh\DomPDF\Facade\Pdf::class)) {
+            // Graceful fallback: log it so the operator notices in prod,
+            // and serve the HTML receipt so the user is not stranded.
+            Log::warning('barryvdh/laravel-dompdf is not installed; serving HTML receipt instead of PDF.', [
+                'transaction_id' => $tx->id,
+                'user_id'        => auth()->id(),
+            ]);
+
+            // `view(...)` returns Illuminate\View\View which doesn't
+            // expose `header()`. Use `response()->view(...)` so the
+            // Response builder (which DOES have `header()`) wraps the
+            // rendered HTML and we can set Content-Disposition.
+            return response()
+                ->view('donate::receipt-pdf', ['tx' => $tx])
+                ->header(
+                    'Content-Disposition',
+                    'inline; filename="' . pathinfo($filename, PATHINFO_FILENAME) . '.pdf"'
+                );
+        }
+
+        $directory = storage_path('app/receipts');
+        $path      = $directory . DIRECTORY_SEPARATOR . $filename;
+
+        // Render the PDF. We *always* re-render so any change to the
+        // template is picked up immediately; the cost is negligible and
+        // donation receipts are infrequent events.
+        $pdf = \Barryvdh\DomPDF\Facade\Pdf::loadView('donate::receipt-pdf', ['tx' => $tx]);
+
+        // ── Persist to disk (best effort) ───────────────────────────────
+        // We intentionally do NOT abort the download if this fails —
+        // the user should still get their receipt. The cleanup task
+        // will simply find nothing to prune.
+        $persisted = false;
+        try {
+            if (!is_dir($directory) && !@mkdir($directory, 0775, true) && !is_dir($directory)) {
+                throw new \RuntimeException("Could not create receipts directory: {$directory}");
+            }
+
+            // DomPDF's save() writes to disk; output() returns raw bytes.
+            // We use save() so the on-disk artifact is what is streamed.
+            $pdf->save($path);
+            $persisted = is_file($path) && filesize($path) > 0;
+        } catch (\Throwable $e) {
+            Log::warning('Receipt PDF could not be persisted to disk; streaming in-memory only.', [
+                'transaction_id' => $tx->id,
+                'user_id'        => auth()->id(),
+                'path'           => $path,
+                'error'          => $e->getMessage(),
+            ]);
+        }
+
+        if ($persisted) {
+            return response()
+                ->download($path, $downloadName, [
+                    'Content-Type'        => 'application/pdf',
+                    'Cache-Control'       => 'private, max-age=0, must-revalidate',
+                    'X-Content-Type-Options' => 'nosniff',
+                ])
+                ->deleteFileAfter(false);
+        }
+
+        // ── Fallback: stream the PDF without persistence ────────────────
+        return $pdf->download($downloadName);
+    }
 }
diff --git a/app/Modules/Donate/Http/routes.php b/app/Modules/Donate/Http/routes.php
index 09cd3a4..b4330af 100644
--- a/app/Modules/Donate/Http/routes.php
+++ b/app/Modules/Donate/Http/routes.php
@@ -7,8 +7,34 @@
     ->prefix(strtolower('Donate'))
     ->group(function () {
         Route::get('/', [DonateController::class, 'index'])->name('donate');
-        Route::post('/checkout', [DonateController::class, 'checkout'])->middleware('auth')->name('donate.checkout');
-        Route::match(['get', 'post'], '/callback/{gateway}', [DonateController::class, 'callback'])->name('donate.callback');
-        Route::post('/webhook/{gateway}', [DonateController::class, 'webhook'])->name('donate.webhook');
-        Route::get('/receipt/{id}', [DonateController::class, 'receipt'])->middleware('auth')->where('id', '[0-9]+')->name('donate.receipt');
+
+        // ─── Checkout ─────────────────────────────────────────────────────
+        // Throttled at 5 attempts per minute per user. Protects against
+        // scripted donation abuse and accidental double-submits.
+        Route::post('/checkout', [DonateController::class, 'checkout'])
+            ->middleware(['auth', 'throttle:donate-checkout'])
+            ->name('donate.checkout');
+
+        // ─── Gateway callbacks / webhooks ────────────────────────────────
+        // GET + POST for callback (gateways vary). Webhook is POST-only.
+        Route::match(['get', 'post'], '/callback/{gateway}', [DonateController::class, 'callback'])
+            ->name('donate.callback');
+
+        // Webhooks from payment providers are throttled more aggressively
+        // because a compromised/duplicated webhook must never reach the
+        // business logic faster than a legitimate one.
+        Route::post('/webhook/{gateway}', [DonateController::class, 'webhook'])
+            ->middleware('throttle:donate-webhook')
+            ->name('donate.webhook');
+
+        // ─── Receipts ────────────────────────────────────────────────────
+        Route::get('/receipt/{id}', [DonateController::class, 'receipt'])
+            ->middleware('auth')
+            ->where('id', '[0-9]+')
+            ->name('donate.receipt');
+
+        Route::get('/receipt/{id}/pdf', [DonateController::class, 'receiptPdf'])
+            ->middleware(['auth', 'throttle:donate-receipt'])
+            ->where('id', '[0-9]+')
+            ->name('donate.receipt.pdf');
     });
diff --git a/app/Modules/Donate/Resources/views/braintree.blade.php b/app/Modules/Donate/Resources/views/braintree.blade.php
index 58ae155..8ded6cd 100644
--- a/app/Modules/Donate/Resources/views/braintree.blade.php
+++ b/app/Modules/Donate/Resources/views/braintree.blade.php
@@ -23,18 +23,53 @@
 <script src="https://js.braintreegateway.com/web/dropin/1.39.0/js/dropin.min.js"></script>
 <script>
 document.addEventListener('DOMContentLoaded', function () {
-    var form = document.getElementById('bt-form');
+    var form   = document.getElementById('bt-form');
     var button = document.getElementById('submit-button');
+    var submitting = false;
+
+    function lockButton() {
+        submitting = true;
+        button.disabled = true;
+        button.classList.add('opacity-60', 'cursor-not-allowed');
+        button.innerHTML = '<i class="fas fa-spinner fa-spin mr-2"></i>Processing…';
+    }
+
+    function unlockButton() {
+        submitting = false;
+        button.disabled = false;
+        button.classList.remove('opacity-60', 'cursor-not-allowed');
+        button.innerHTML = 'Pay';
+    }
+
     braintree.dropin.create({
         authorization: '{{ $token }}',
         container: '#dropin-container'
     }, function (createErr, instance) {
         form.addEventListener('submit', function (event) {
             event.preventDefault();
+
+            // ─── Client-side idempotency: ignore subsequent submits ──────
+            // Braintree nonces are single-use. The server also dedupes
+            // (see DonateController::checkout), but locking the button
+            // here prevents the user from queuing two POSTs before the
+            // server-side lock kicks in.
+            if (submitting) {
+                return;
+            }
+            lockButton();
+
             instance.requestPaymentMethod(function (err, payload) {
-                if (err) return;
+                if (err) {
+                    // Drop-in couldn't tokenize (validation error, etc.).
+                    // Re-enable the button so the user can retry.
+                    unlockButton();
+                    return;
+                }
                 document.getElementById('nonce').value = payload.nonce;
                 form.submit();
+                // Don't unlockButton() — once the form is submitting,
+                // navigation away is the only way out. If the request
+                // fails server-side, the redirect/error page handles it.
             });
         });
     });
diff --git a/app/Modules/Donate/Resources/views/receipt-pdf.blade.php b/app/Modules/Donate/Resources/views/receipt-pdf.blade.php
new file mode 100644
index 0000000..e680513
--- /dev/null
+++ b/app/Modules/Donate/Resources/views/receipt-pdf.blade.php
@@ -0,0 +1,73 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <title>Donation Receipt #{{ $tx->id }}</title>
+    <style>
+        @page { margin: 36px; }
+        body { font-family: DejaVu Sans, sans-serif; font-size: 12px; color: #1f2937; }
+        .header { border-bottom: 2px solid #2563eb; padding-bottom: 16px; margin-bottom: 24px; }
+        .header h1 { margin: 0 0 4px; font-size: 22px; color: #111827; }
+        .header p  { margin: 0; color: #6b7280; font-size: 11px; }
+        .meta { width: 100%; margin-bottom: 24px; border-collapse: collapse; }
+        .meta td { padding: 8px 12px; border: 1px solid #e5e7eb; vertical-align: top; }
+        .meta td.label { background: #f9fafb; font-weight: 600; width: 30%; color: #374151; }
+        .meta td.value { color: #111827; }
+        .amount { font-size: 24px; color: #2563eb; font-weight: 700; }
+        .status-completed { color: #059669; font-weight: 600; }
+        .status-pending   { color: #d97706; font-weight: 600; }
+        .status-failed    { color: #dc2626; font-weight: 600; }
+        .footer { margin-top: 40px; padding-top: 12px; border-top: 1px solid #e5e7eb; color: #6b7280; font-size: 10px; }
+        .footer p { margin: 4px 0; }
+    </style>
+</head>
+<body>
+    <div class="header">
+        <h1>Donation Receipt</h1>
+        <p>{{ config('app.name', 'NexusCMS') }} · Generated {{ now()->format('Y-m-d H:i') }} UTC</p>
+    </div>
+
+    <table class="meta">
+        <tr>
+            <td class="label">Receipt ID</td>
+            <td class="value">#{{ $tx->id }}</td>
+        </tr>
+        <tr>
+            <td class="label">Date</td>
+            <td class="value">{{ $tx->created_at->format('Y-m-d H:i:s') }}</td>
+        </tr>
+        <tr>
+            <td class="label">Donor</td>
+            <td class="value">{{ $tx->user?->name ?? 'N/A' }} ({{ $tx->user?->email ?? '—' }})</td>
+        </tr>
+        <tr>
+            <td class="label">Gateway</td>
+            <td class="value">{{ ucfirst($tx->gateway) }}</td>
+        </tr>
+        <tr>
+            <td class="label">Gateway Transaction ID</td>
+            <td class="value">{{ $tx->transaction_id ?? 'N/A' }}</td>
+        </tr>
+        <tr>
+            <td class="label">Amount</td>
+            <td class="value"><span class="amount">${{ number_format((float) $tx->amount, 2) }} {{ $tx->currency }}</span></td>
+        </tr>
+        <tr>
+            <td class="label">Donation Points Awarded</td>
+            <td class="value"><strong>{{ number_format((int) $tx->dp_awarded) }} DP</strong></td>
+        </tr>
+        <tr>
+            <td class="label">Status</td>
+            <td class="value">
+                <span class="status-{{ $tx->status }}">{{ ucfirst($tx->status) }}</span>
+            </td>
+        </tr>
+    </table>
+
+    <div class="footer">
+        <p>This receipt is your proof of donation. Please retain it for your records.</p>
+        <p>Thank you for supporting {{ config('app.name', 'NexusCMS') }}.</p>
+        <p>Receipt hash: {{ substr(hash('sha256', $tx->id . '|' . $tx->transaction_id . '|' . $tx->amount . '|' . config('app.key')), 0, 16) }}</p>
+    </div>
+</body>
+</html>
diff --git a/app/Modules/Donate/Resources/views/receipt.blade.php b/app/Modules/Donate/Resources/views/receipt.blade.php
index 448b035..baf4442 100644
--- a/app/Modules/Donate/Resources/views/receipt.blade.php
+++ b/app/Modules/Donate/Resources/views/receipt.blade.php
@@ -7,9 +7,16 @@
     <div class="bg-slate-900/50 border border-slate-800 rounded-xl p-8">
         <div class="flex items-center justify-between mb-6">
             <h2 class="text-2xl font-bold">Donation Receipt</h2>
-            <button onclick="window.print()" class="px-4 py-2 bg-slate-700 hover:bg-slate-600 rounded-lg text-white font-semibold">
-                Print / Save as PDF
-            </button>
+            <div class="flex items-center gap-2">
+                <a href="{{ route('donate.receipt.pdf', $tx->id) }}"
+                   class="inline-flex items-center gap-2 px-4 py-2 bg-blue-600 hover:bg-blue-700 rounded-lg text-white font-semibold"
+                   title="Download a PDF copy of this receipt">
+                    <i class="fas fa-file-pdf"></i> Download PDF
+                </a>
+                <button onclick="window.print()" class="px-4 py-2 bg-slate-700 hover:bg-slate-600 rounded-lg text-white font-semibold">
+                    Print
+                </button>
+            </div>
         </div>
         <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
             <div>
diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php
index 11b9f2e..8bcd57c 100755
--- a/app/Providers/AppServiceProvider.php
+++ b/app/Providers/AppServiceProvider.php
@@ -3,6 +3,9 @@
 namespace App\Providers;
 
 use App\Libraries\Redis\RedisLibrary;
+use Illuminate\Cache\RateLimiting\Limit;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\RateLimiter;
 use Illuminate\Support\ServiceProvider;
 use Illuminate\Support\Facades\Config;
 use Modules\Armory\Services\ArmoryService;
@@ -51,5 +54,36 @@ public function boot(): void
             Config::set('cache.default', 'file');
             Config::set('queue.default', 'sync');
         }
+
+        $this->configureRateLimiters();
+    }
+
+    /**
+     * Register named rate limiters used by the donate module and elsewhere.
+     *
+     * - donate-checkout: per authenticated user, 5 attempts/min. Hard cap
+     *   against scripted donation abuse; reasonable for legit double-clicks.
+     * - donate-webhook: per IP, 30/min. Legit gateways can retry a handful
+     *   of times; this stops flood / replay attempts.
+     * - donate-receipt: per authenticated user, 20/min. Generous because
+     *   the user may open the receipt several times (email link, browser
+     *   back, etc.).
+     */
+    protected function configureRateLimiters(): void
+    {
+        RateLimiter::for('donate-checkout', function (Request $request) {
+            return Limit::perMinute(5)
+                ->by('donate-checkout:' . optional($request->user())->id ?: $request->ip());
+        });
+
+        RateLimiter::for('donate-webhook', function (Request $request) {
+            return Limit::perMinute(30)
+                ->by('donate-webhook:' . $request->ip());
+        });
+
+        RateLimiter::for('donate-receipt', function (Request $request) {
+            return Limit::perMinute(20)
+                ->by('donate-receipt:' . optional($request->user())->id ?: $request->ip());
+        });
     }
 }
diff --git a/app/Services/InstallService.php b/app/Services/InstallService.php
index e32626c..0d654d7 100644
--- a/app/Services/InstallService.php
+++ b/app/Services/InstallService.php
@@ -134,18 +134,38 @@ protected function updateEnv(array $data)
 
         foreach ($data as $key => $value) {
             if ($value !== null) {
+                $sanitized = $this->sanitizeEnvValue((string) $value);
+
                 if (preg_match("/^{$key}=.*/m", $envContent)) {
                     $envContent = preg_replace(
                         "/^{$key}=.*/m",
-                        "{$key}=\"{$value}\"",
+                        "{$key}={$sanitized}",
                         $envContent
                     );
                 } else {
-                    $envContent .= PHP_EOL."{$key}=\"{$value}\"";
+                    $envContent .= PHP_EOL."{$key}={$sanitized}";
                 }
             }
         }
 
         $this->files->put($envPath, $envContent);
     }
+
+    /**
+     * Sanitize a value for safe inclusion in a .env file.
+     *
+     * Strips control characters (newlines, carriage returns, null bytes)
+     * that could be used to inject additional environment variables,
+     * then wraps the value in double quotes with internal quotes escaped.
+     */
+    protected function sanitizeEnvValue(string $value): string
+    {
+        // Remove characters that could break out of the value context
+        $value = str_replace(["\n", "\r", "\0", "\x1a"], '', $value);
+
+        // Escape any embedded double quotes
+        $value = str_replace('"', '\\"', $value);
+
+        return "\"{$value}\"";
+    }
 }
diff --git a/app/Services/SystemInfoService.php b/app/Services/SystemInfoService.php
index eebfdae..4c5450a 100644
--- a/app/Services/SystemInfoService.php
+++ b/app/Services/SystemInfoService.php
@@ -26,7 +26,7 @@ public function getInfo(): array
             ],
             'nexuscms' => [
                 'label' => 'NexusCMS',
-                'value' => config('app.version', 'Unknown'),
+                'value' => $this->getFullVersion(),
                 'icon'  => 'fas fa-cubes',
                 'color' => 'blue',
             ],
@@ -81,6 +81,34 @@ public function isProduction(): bool
         return app()->environment('production');
     }
 
+    /**
+     * Get the bare version string, e.g. "0.1.6-alpha.5".
+     */
+    public function getVersion(): string
+    {
+        return (string) config('app.version', '0.0.0');
+    }
+
+    /**
+     * Get the release codename, e.g. "Anvil".
+     */
+    public function getCodename(): string
+    {
+        return (string) config('app.codename', '');
+    }
+
+    /**
+     * Get the version + codename combined for display, e.g. "0.1.6 · Anvil".
+     * Falls back to just the version if no codename is configured.
+     */
+    public function getFullVersion(): string
+    {
+        $version  = $this->getVersion();
+        $codename = $this->getCodename();
+
+        return $codename !== '' ? "{$version} · {$codename}" : $version;
+    }
+
     public function isDebugEnabled(): bool
     {
         return config('app.debug') === true;
diff --git a/composer.json b/composer.json
index 632cfb6..da871bd 100755
--- a/composer.json
+++ b/composer.json
@@ -17,6 +17,7 @@
         "laravel/boost": "^2.4.8",
         "laravel/pulse": "^1.7.3",
         "laravel/tinker": "^3.0.2",
+        "barryvdh/laravel-dompdf": "^3.1",
         "predis/predis": "3.2.0",
         "spatie/laravel-permission": "^6.18",
         "wowcrypto/wowcrypto": "1.3.0",
diff --git a/config/app.php b/config/app.php
index 2c353f4..c86812a 100755
--- a/config/app.php
+++ b/config/app.php
@@ -128,8 +128,10 @@
     | Version CMS
     |--------------------------------------------------------------------------
     |
-    | The version of the CMS.
+    | The version of the CMS. The codename is the release nickname
+    | (see ROADMAP.md) and is shown alongside the version in the admin panel.
     |
     */
-    'version' => env('APP_VERSION', '0.1.6-alpha.5'),
+    'version'  => env('APP_VERSION', '0.1.6-alpha.5'),
+    'codename' => env('APP_CODENAME', 'Anvil'),
 ];
diff --git a/resources/js/bootstrap.js b/resources/js/bootstrap.js
index 5f1390b..3f923bd 100755
--- a/resources/js/bootstrap.js
+++ b/resources/js/bootstrap.js
@@ -1,4 +1,22 @@
 import axios from 'axios';
-window.axios = axios;
 
+window.axios = axios;
 window.axios.defaults.headers.common['X-Requested-With'] = 'XMLHttpRequest';
+
+// Read the CSRF token from the <meta name="csrf-token"> tag.
+// Laravel emits this in the layout; without it, every POST/PUT/DELETE
+// from axios would fail with 419. We log a warning (not throw) if the
+// meta tag is missing so the page still loads — the warning is enough
+// to catch the issue during development.
+const csrfMeta = document.head.querySelector('meta[name="csrf-token"]');
+
+if (csrfMeta && csrfMeta.content) {
+    window.axios.defaults.headers.common['X-CSRF-TOKEN'] = csrfMeta.content;
+} else {
+    // eslint-disable-next-line no-console
+    console.warn(
+        '[NexusCMS] <meta name="csrf-token"> not found. '
+        + 'Any axios POST/PUT/DELETE will return 419. '
+        + 'Make sure your layout includes @csrf or the meta tag explicitly.'
+    );
+}
diff --git a/resources/views/install/index.blade.php b/resources/views/install/index.blade.php
index 59b5378..4f0da39 100644
--- a/resources/views/install/index.blade.php
+++ b/resources/views/install/index.blade.php
@@ -3,6 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="csrf-token" content="{{ csrf_token() }}">
     <title>NexusCMS &mdash; Installation Wizard</title>
     <style>
         *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
diff --git a/resources/views/layouts/main.blade.php b/resources/views/layouts/main.blade.php
index d5a072e..253e900 100644
--- a/resources/views/layouts/main.blade.php
+++ b/resources/views/layouts/main.blade.php
@@ -3,6 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="csrf-token" content="{{ csrf_token() }}">
     <title>{{ settings('site_name') }} - @yield('title', 'World of Warcraft Private Server')</title>
     <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0-beta3/css/all.min.css">
     <link href="https://fonts.googleapis.com/css2?family=Cinzel:wght@400;700&family=Inter:wght@300;400;600&display=swap" rel="stylesheet">
diff --git a/routes/console.php b/routes/console.php
index 3c9adf1..b02c6e4 100755
--- a/routes/console.php
+++ b/routes/console.php
@@ -2,7 +2,74 @@
 
 use Illuminate\Foundation\Inspiring;
 use Illuminate\Support\Facades\Artisan;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Facades\Schedule;
 
 Artisan::command('inspire', function () {
     $this->comment(Inspiring::quote());
 })->purpose('Display an inspiring quote');
+
+/*
+|--------------------------------------------------------------------------
+| Receipt PDF cleanup
+|--------------------------------------------------------------------------
+|
+| Donation receipts are persisted to storage/app/receipts/ on demand
+| whenever a user downloads one. To keep that folder from growing
+| forever, prune any PDF older than 7 days once a day.
+|
+| The schedule is intentionally quiet during the day (runs at 03:30)
+| and uses file mtime — *not* a database column — because the file
+| itself is the source of truth for "when was this generated".
+|
+| On environments where the scheduler is not running, the cleanup
+| can be triggered manually with:
+|   php artisan schedule:run
+| or for an explicit sweep:
+|   php artisan tinker --execute="require base_path('routes/console.php');"
+*/
+Schedule::call(function () {
+    $directory = storage_path('app/receipts');
+
+    if (!is_dir($directory)) {
+        return;
+    }
+
+    $cutoff   = now()->subDays(7)->timestamp;
+    $deleted  = 0;
+    $bytesFreed = 0;
+
+    foreach (glob($directory . DIRECTORY_SEPARATOR . 'donation-receipt-*.pdf') ?: [] as $file) {
+        if (!is_file($file)) {
+            continue;
+        }
+
+        // Defense-in-depth: only delete files whose name matches the
+        // expected pattern AND whose mtime is older than the cutoff.
+        // This protects against an operator changing the directory
+        // and the sweep clobbering something unrelated.
+        if (filemtime($file) >= $cutoff) {
+            continue;
+        }
+
+        $bytesFreed += @filesize($file) ?: 0;
+
+        if (@unlink($file)) {
+            $deleted++;
+        } else {
+            Log::warning('Receipt PDF cleanup: could not delete file', ['path' => $file]);
+        }
+    }
+
+    if ($deleted > 0) {
+        Log::info('Receipt PDF cleanup', [
+            'deleted'      => $deleted,
+            'bytes_freed'  => $bytesFreed,
+            'directory'    => $directory,
+        ]);
+    }
+})
+->name('receipts:cleanup')
+->dailyAt('03:30')
+->withoutOverlapping()
+->onOneServer();
diff --git a/routes/web.php b/routes/web.php
index 88b57e4..2aab7b3 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -24,7 +24,7 @@
     Route::get('/{slug}', [NewsController::class, 'show'])->name('news.show');
     Route::post('/{slug}/comment', [CommentController::class, 'store'])->middleware('auth')->name('news.comment.store');
     Route::delete('/comment/{comment}', [CommentController::class, 'destroy'])->middleware('auth')->name('news.comment.destroy');
-    Route::post('/subscribe', [SubscriptionController::class, 'subscribe'])->name('subscribe');
+    Route::post('/subscribe', [SubscriptionController::class, 'subscribe'])->middleware('throttle:5,1')->name('subscribe');
     Route::get('/confirm-subscription/{token}', [SubscriptionController::class, 'confirmSubscription'])->name('confirm.subscription');
     Route::get('/unsubscribe/{token}', [SubscriptionController::class, 'unsubscribe'])->name('unsubscribe');
 });

From 0783e27ce1c0bc9782bab0a03ae2360f443a1abd Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Mon, 6 Jul 2026 02:00:44 +0200
Subject: [PATCH 129/132] chore(Armory): remove admin crud and menu config

remove the admin_crud setting and admin menu block from the Armory module's module.json file
---
 app/Modules/Armory/module.json | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/app/Modules/Armory/module.json b/app/Modules/Armory/module.json
index 4a16ec0..2d464d3 100644
--- a/app/Modules/Armory/module.json
+++ b/app/Modules/Armory/module.json
@@ -4,12 +4,5 @@
     "routes": true,
     "migrations": true,
     "views": true,
-    "namespace": "Modules\\Armory",
-    "admin_crud": "custom",
-    "admin_menu": {
-        "label": "Armory",
-        "icon": "fas fa-shield-alt",
-        "route": "admin.armory.index",
-        "order": 35
-    }
+    "namespace": "Modules\\Armory"
 }

From 815f90ae0e9aa706f998dbd89e0af5e3a177a895 Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 9 Jul 2026 00:37:10 +0200
Subject: [PATCH 130/132] Update composer.lock

---
 composer.lock | 524 +++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 523 insertions(+), 1 deletion(-)

diff --git a/composer.lock b/composer.lock
index 169f733..81ea020 100755
--- a/composer.lock
+++ b/composer.lock
@@ -4,8 +4,85 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "196b8ac9910b8afc2c519ab587c11f3c",
+    "content-hash": "dbb58cd5282c17ab11a84567634e5a24",
     "packages": [
+        {
+            "name": "barryvdh/laravel-dompdf",
+            "version": "v3.1.2",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/barryvdh/laravel-dompdf.git",
+                "reference": "ee3b72b19ccdf57d0243116ecb2b90261344dedc"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/barryvdh/laravel-dompdf/zipball/ee3b72b19ccdf57d0243116ecb2b90261344dedc",
+                "reference": "ee3b72b19ccdf57d0243116ecb2b90261344dedc",
+                "shasum": ""
+            },
+            "require": {
+                "dompdf/dompdf": "^3.0",
+                "illuminate/support": "^9|^10|^11|^12|^13.0",
+                "php": "^8.1"
+            },
+            "require-dev": {
+                "larastan/larastan": "^2.7|^3.0",
+                "orchestra/testbench": "^7|^8|^9.16|^10|^11.0",
+                "phpro/grumphp": "^2.5",
+                "squizlabs/php_codesniffer": "^3.5"
+            },
+            "type": "library",
+            "extra": {
+                "laravel": {
+                    "aliases": {
+                        "PDF": "Barryvdh\\DomPDF\\Facade\\Pdf",
+                        "Pdf": "Barryvdh\\DomPDF\\Facade\\Pdf"
+                    },
+                    "providers": [
+                        "Barryvdh\\DomPDF\\ServiceProvider"
+                    ]
+                },
+                "branch-alias": {
+                    "dev-master": "3.0-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Barryvdh\\DomPDF\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Barry vd. Heuvel",
+                    "email": "barryvdh@gmail.com"
+                }
+            ],
+            "description": "A DOMPDF Wrapper for Laravel",
+            "keywords": [
+                "dompdf",
+                "laravel",
+                "pdf"
+            ],
+            "support": {
+                "issues": "https://github.com/barryvdh/laravel-dompdf/issues",
+                "source": "https://github.com/barryvdh/laravel-dompdf/tree/v3.1.2"
+            },
+            "funding": [
+                {
+                    "url": "https://fruitcake.nl",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/barryvdh",
+                    "type": "github"
+                }
+            ],
+            "time": "2026-02-21T08:51:10+00:00"
+        },
         {
             "name": "braintree/braintree_php",
             "version": "6.35.0",
@@ -481,6 +558,161 @@
             },
             "time": "2026-02-08T16:21:46+00:00"
         },
+        {
+            "name": "dompdf/dompdf",
+            "version": "v3.1.5",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/dompdf/dompdf.git",
+                "reference": "f11ead23a8a76d0ff9bbc6c7c8fd7e05ca328496"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/dompdf/dompdf/zipball/f11ead23a8a76d0ff9bbc6c7c8fd7e05ca328496",
+                "reference": "f11ead23a8a76d0ff9bbc6c7c8fd7e05ca328496",
+                "shasum": ""
+            },
+            "require": {
+                "dompdf/php-font-lib": "^1.0.0",
+                "dompdf/php-svg-lib": "^1.0.0",
+                "ext-dom": "*",
+                "ext-mbstring": "*",
+                "masterminds/html5": "^2.0",
+                "php": "^7.1 || ^8.0"
+            },
+            "require-dev": {
+                "ext-gd": "*",
+                "ext-json": "*",
+                "ext-zip": "*",
+                "mockery/mockery": "^1.3",
+                "phpunit/phpunit": "^7.5 || ^8 || ^9 || ^10 || ^11",
+                "squizlabs/php_codesniffer": "^3.5",
+                "symfony/process": "^4.4 || ^5.4 || ^6.2 || ^7.0"
+            },
+            "suggest": {
+                "ext-gd": "Needed to process images",
+                "ext-gmagick": "Improves image processing performance",
+                "ext-imagick": "Improves image processing performance",
+                "ext-zlib": "Needed for pdf stream compression"
+            },
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "Dompdf\\": "src/"
+                },
+                "classmap": [
+                    "lib/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "LGPL-2.1"
+            ],
+            "authors": [
+                {
+                    "name": "The Dompdf Community",
+                    "homepage": "https://github.com/dompdf/dompdf/blob/master/AUTHORS.md"
+                }
+            ],
+            "description": "DOMPDF is a CSS 2.1 compliant HTML to PDF converter",
+            "homepage": "https://github.com/dompdf/dompdf",
+            "support": {
+                "issues": "https://github.com/dompdf/dompdf/issues",
+                "source": "https://github.com/dompdf/dompdf/tree/v3.1.5"
+            },
+            "time": "2026-03-03T13:54:37+00:00"
+        },
+        {
+            "name": "dompdf/php-font-lib",
+            "version": "1.0.2",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/dompdf/php-font-lib.git",
+                "reference": "a6e9a688a2a80016ac080b97be73d3e10c444c9a"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/dompdf/php-font-lib/zipball/a6e9a688a2a80016ac080b97be73d3e10c444c9a",
+                "reference": "a6e9a688a2a80016ac080b97be73d3e10c444c9a",
+                "shasum": ""
+            },
+            "require": {
+                "ext-mbstring": "*",
+                "php": "^7.1 || ^8.0"
+            },
+            "require-dev": {
+                "phpunit/phpunit": "^7.5 || ^8 || ^9 || ^10 || ^11 || ^12"
+            },
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "FontLib\\": "src/FontLib"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "LGPL-2.1-or-later"
+            ],
+            "authors": [
+                {
+                    "name": "The FontLib Community",
+                    "homepage": "https://github.com/dompdf/php-font-lib/blob/master/AUTHORS.md"
+                }
+            ],
+            "description": "A library to read, parse, export and make subsets of different types of font files.",
+            "homepage": "https://github.com/dompdf/php-font-lib",
+            "support": {
+                "issues": "https://github.com/dompdf/php-font-lib/issues",
+                "source": "https://github.com/dompdf/php-font-lib/tree/1.0.2"
+            },
+            "time": "2026-01-20T14:10:26+00:00"
+        },
+        {
+            "name": "dompdf/php-svg-lib",
+            "version": "1.0.2",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/dompdf/php-svg-lib.git",
+                "reference": "8259ffb930817e72b1ff1caef5d226501f3dfeb1"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/dompdf/php-svg-lib/zipball/8259ffb930817e72b1ff1caef5d226501f3dfeb1",
+                "reference": "8259ffb930817e72b1ff1caef5d226501f3dfeb1",
+                "shasum": ""
+            },
+            "require": {
+                "ext-mbstring": "*",
+                "php": "^7.1 || ^8.0",
+                "sabberworm/php-css-parser": "^8.4 || ^9.0"
+            },
+            "require-dev": {
+                "phpunit/phpunit": "^7.5 || ^8 || ^9 || ^10 || ^11"
+            },
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "Svg\\": "src/Svg"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "LGPL-3.0-or-later"
+            ],
+            "authors": [
+                {
+                    "name": "The SvgLib Community",
+                    "homepage": "https://github.com/dompdf/php-svg-lib/blob/master/AUTHORS.md"
+                }
+            ],
+            "description": "A library to read, parse and export to PDF SVG files.",
+            "homepage": "https://github.com/dompdf/php-svg-lib",
+            "support": {
+                "issues": "https://github.com/dompdf/php-svg-lib/issues",
+                "source": "https://github.com/dompdf/php-svg-lib/tree/1.0.2"
+            },
+            "time": "2026-01-02T16:01:13+00:00"
+        },
         {
             "name": "dragonmantank/cron-expression",
             "version": "v3.6.0",
@@ -2550,6 +2782,73 @@
             ],
             "time": "2026-05-01T00:46:07+00:00"
         },
+        {
+            "name": "masterminds/html5",
+            "version": "2.10.1",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/Masterminds/html5-php.git",
+                "reference": "fd5018f6815fff903946d0564977b44ce8010e29"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/Masterminds/html5-php/zipball/fd5018f6815fff903946d0564977b44ce8010e29",
+                "reference": "fd5018f6815fff903946d0564977b44ce8010e29",
+                "shasum": ""
+            },
+            "require": {
+                "ext-dom": "*",
+                "php": ">=5.3.0"
+            },
+            "require-dev": {
+                "phpunit/phpunit": "^4.8.35 || ^5.7.21 || ^6 || ^7 || ^8 || ^9 || ^10"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "2.7-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Masterminds\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Matt Butcher",
+                    "email": "technosophos@gmail.com"
+                },
+                {
+                    "name": "Matt Farina",
+                    "email": "matt@mattfarina.com"
+                },
+                {
+                    "name": "Asmir Mustafic",
+                    "email": "goetas@gmail.com"
+                }
+            ],
+            "description": "An HTML5 parser and serializer.",
+            "homepage": "http://masterminds.github.io/html5-php",
+            "keywords": [
+                "HTML5",
+                "dom",
+                "html",
+                "parser",
+                "querypath",
+                "serializer",
+                "xml"
+            ],
+            "support": {
+                "issues": "https://github.com/Masterminds/html5-php/issues",
+                "source": "https://github.com/Masterminds/html5-php/tree/2.10.1"
+            },
+            "time": "2026-06-23T18:43:15+00:00"
+        },
         {
             "name": "monolog/monolog",
             "version": "3.10.0",
@@ -3888,6 +4187,86 @@
             },
             "time": "2025-12-14T04:43:48+00:00"
         },
+        {
+            "name": "sabberworm/php-css-parser",
+            "version": "v9.4.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/MyIntervals/PHP-CSS-Parser.git",
+                "reference": "fd3bf9fb173e0df649bc4e3e0d088a1b2417c08f"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/MyIntervals/PHP-CSS-Parser/zipball/fd3bf9fb173e0df649bc4e3e0d088a1b2417c08f",
+                "reference": "fd3bf9fb173e0df649bc4e3e0d088a1b2417c08f",
+                "shasum": ""
+            },
+            "require": {
+                "ext-iconv": "*",
+                "php": "^7.2.0 || ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0",
+                "thecodingmachine/safe": "^1.3 || ^2.5 || ^3.4"
+            },
+            "require-dev": {
+                "php-parallel-lint/php-parallel-lint": "1.4.0",
+                "phpstan/extension-installer": "1.4.3",
+                "phpstan/phpstan": "1.12.33 || 2.2.2",
+                "phpstan/phpstan-phpunit": "1.4.2 || 2.0.16",
+                "phpstan/phpstan-strict-rules": "1.6.2 || 2.0.11",
+                "phpunit/phpunit": "8.5.52",
+                "rawr/phpunit-data-provider": "3.3.1",
+                "rector/rector": "1.2.10 || 2.4.6",
+                "rector/type-perfect": "1.0.0 || 2.1.3",
+                "squizlabs/php_codesniffer": "4.0.1",
+                "thecodingmachine/phpstan-safe-rule": "1.2.0 || 1.4.3"
+            },
+            "suggest": {
+                "ext-mbstring": "for parsing UTF-8 CSS"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "9.5.x-dev"
+                }
+            },
+            "autoload": {
+                "files": [
+                    "src/Rule/Rule.php",
+                    "src/RuleSet/RuleContainer.php"
+                ],
+                "psr-4": {
+                    "Sabberworm\\CSS\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Raphael Schweikert"
+                },
+                {
+                    "name": "Oliver Klee",
+                    "email": "github@oliverklee.de"
+                },
+                {
+                    "name": "Jake Hotson",
+                    "email": "jake.github@qzdesign.co.uk"
+                }
+            ],
+            "description": "Parser for CSS Files written in PHP",
+            "homepage": "https://www.sabberworm.com/blog/2010/6/10/php-css-parser",
+            "keywords": [
+                "css",
+                "parser",
+                "stylesheet"
+            ],
+            "support": {
+                "issues": "https://github.com/MyIntervals/PHP-CSS-Parser/issues",
+                "source": "https://github.com/MyIntervals/PHP-CSS-Parser/tree/v9.4.0"
+            },
+            "time": "2026-06-18T15:10:53+00:00"
+        },
         {
             "name": "spatie/laravel-permission",
             "version": "6.25.0",
@@ -6527,6 +6906,149 @@
             ],
             "time": "2026-05-29T05:06:50+00:00"
         },
+        {
+            "name": "thecodingmachine/safe",
+            "version": "v3.4.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/thecodingmachine/safe.git",
+                "reference": "705683a25bacf0d4860c7dea4d7947bfd09eea19"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/thecodingmachine/safe/zipball/705683a25bacf0d4860c7dea4d7947bfd09eea19",
+                "reference": "705683a25bacf0d4860c7dea4d7947bfd09eea19",
+                "shasum": ""
+            },
+            "require": {
+                "php": "^8.1"
+            },
+            "require-dev": {
+                "php-parallel-lint/php-parallel-lint": "^1.4",
+                "phpstan/phpstan": "^2",
+                "phpunit/phpunit": "^10",
+                "squizlabs/php_codesniffer": "^3.2"
+            },
+            "type": "library",
+            "autoload": {
+                "files": [
+                    "lib/special_cases.php",
+                    "generated/apache.php",
+                    "generated/apcu.php",
+                    "generated/array.php",
+                    "generated/bzip2.php",
+                    "generated/calendar.php",
+                    "generated/classobj.php",
+                    "generated/com.php",
+                    "generated/cubrid.php",
+                    "generated/curl.php",
+                    "generated/datetime.php",
+                    "generated/dir.php",
+                    "generated/eio.php",
+                    "generated/errorfunc.php",
+                    "generated/exec.php",
+                    "generated/fileinfo.php",
+                    "generated/filesystem.php",
+                    "generated/filter.php",
+                    "generated/fpm.php",
+                    "generated/ftp.php",
+                    "generated/funchand.php",
+                    "generated/gettext.php",
+                    "generated/gmp.php",
+                    "generated/gnupg.php",
+                    "generated/hash.php",
+                    "generated/ibase.php",
+                    "generated/ibmDb2.php",
+                    "generated/iconv.php",
+                    "generated/image.php",
+                    "generated/imap.php",
+                    "generated/info.php",
+                    "generated/inotify.php",
+                    "generated/json.php",
+                    "generated/ldap.php",
+                    "generated/libxml.php",
+                    "generated/lzf.php",
+                    "generated/mailparse.php",
+                    "generated/mbstring.php",
+                    "generated/misc.php",
+                    "generated/mysql.php",
+                    "generated/mysqli.php",
+                    "generated/network.php",
+                    "generated/oci8.php",
+                    "generated/opcache.php",
+                    "generated/openssl.php",
+                    "generated/outcontrol.php",
+                    "generated/pcntl.php",
+                    "generated/pcre.php",
+                    "generated/pgsql.php",
+                    "generated/posix.php",
+                    "generated/ps.php",
+                    "generated/pspell.php",
+                    "generated/readline.php",
+                    "generated/rnp.php",
+                    "generated/rpminfo.php",
+                    "generated/rrd.php",
+                    "generated/sem.php",
+                    "generated/session.php",
+                    "generated/shmop.php",
+                    "generated/sockets.php",
+                    "generated/sodium.php",
+                    "generated/solr.php",
+                    "generated/spl.php",
+                    "generated/sqlsrv.php",
+                    "generated/ssdeep.php",
+                    "generated/ssh2.php",
+                    "generated/stream.php",
+                    "generated/strings.php",
+                    "generated/swoole.php",
+                    "generated/uodbc.php",
+                    "generated/uopz.php",
+                    "generated/url.php",
+                    "generated/var.php",
+                    "generated/xdiff.php",
+                    "generated/xml.php",
+                    "generated/xmlrpc.php",
+                    "generated/yaml.php",
+                    "generated/yaz.php",
+                    "generated/zip.php",
+                    "generated/zlib.php"
+                ],
+                "classmap": [
+                    "lib/DateTime.php",
+                    "lib/DateTimeImmutable.php",
+                    "lib/Exceptions/",
+                    "generated/Exceptions/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "description": "PHP core functions that throw exceptions instead of returning FALSE on error",
+            "support": {
+                "issues": "https://github.com/thecodingmachine/safe/issues",
+                "source": "https://github.com/thecodingmachine/safe/tree/v3.4.0"
+            },
+            "funding": [
+                {
+                    "url": "https://github.com/OskarStark",
+                    "type": "github"
+                },
+                {
+                    "url": "https://github.com/shish",
+                    "type": "github"
+                },
+                {
+                    "url": "https://github.com/silasjoisten",
+                    "type": "github"
+                },
+                {
+                    "url": "https://github.com/staabm",
+                    "type": "github"
+                }
+            ],
+            "time": "2026-02-04T18:08:13+00:00"
+        },
         {
             "name": "tijsverkoyen/css-to-inline-styles",
             "version": "v2.4.0",

From 37e8a1a55940a8f6d7fee0f47ca26862a2bf6f5f Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 9 Jul 2026 01:35:44 +0200
Subject: [PATCH 131/132] Update nixpacks

---
 nixpacks.toml | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 nixpacks.toml

diff --git a/nixpacks.toml b/nixpacks.toml
new file mode 100644
index 0000000..e69de29

From c63b3f191ac6e5fa8ee0a5db6cab5b1366fddd1f Mon Sep 17 00:00:00 2001
From: sayghteight <sayghteight@gmail.com>
Date: Thu, 9 Jul 2026 01:37:54 +0200
Subject: [PATCH 132/132] Update nixpacks

---
 nixpacks.toml | 183 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 183 insertions(+)

diff --git a/nixpacks.toml b/nixpacks.toml
index e69de29..c5ec072 100644
--- a/nixpacks.toml
+++ b/nixpacks.toml
@@ -0,0 +1,183 @@
+[phases.setup]
+nixPkgs = ["...", "python311Packages.supervisor"]
+
+[phases.build]
+cmds = [
+    "mkdir -p /etc/supervisor/conf.d/",
+    "cp /assets/worker-*.conf /etc/supervisor/conf.d/",
+    "cp /assets/supervisord.conf /etc/supervisord.conf",
+    "chmod +x /assets/start.sh",
+    "..."
+]
+
+[start]
+cmd = '/assets/start.sh'
+
+[staticAssets]
+"start.sh" = '''
+#!/bin/bash
+
+# Ensure storage and bootstrap cache are writable by www-data
+chown -R www-data:www-data /app/storage /app/bootstrap/cache
+chmod -R 775 /app/storage /app/bootstrap/cache
+
+# Transform the nginx configuration
+node /assets/scripts/prestart.mjs /assets/nginx.template.conf /etc/nginx.conf
+
+# Start supervisor
+supervisord -c /etc/supervisord.conf -n
+'''
+
+"supervisord.conf" = '''
+[unix_http_server]
+file=/assets/supervisor.sock
+
+[supervisord]
+logfile=/var/log/supervisord.log
+logfile_maxbytes=50MB
+logfile_backups=10
+loglevel=info
+pidfile=/assets/supervisord.pid
+nodaemon=false
+silent=false
+minfds=1024
+minprocs=200
+
+[rpcinterface:supervisor]
+supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
+
+[supervisorctl]
+serverurl=unix:///assets/supervisor.sock
+
+[include]
+files = /etc/supervisor/conf.d/*.conf
+'''
+
+"worker-nginx.conf" = '''
+[program:worker-nginx]
+process_name=%(program_name)s_%(process_num)02d
+command=nginx -c /etc/nginx.conf
+autostart=true
+autorestart=true
+stdout_logfile=/var/log/worker-nginx.log
+stderr_logfile=/var/log/worker-nginx.log
+'''
+
+"worker-phpfpm.conf" = '''
+[program:worker-phpfpm]
+process_name=%(program_name)s_%(process_num)02d
+command=php-fpm -y /assets/php-fpm.conf -F
+autostart=true
+autorestart=true
+stdout_logfile=/var/log/worker-phpfpm.log
+stderr_logfile=/var/log/worker-phpfpm.log
+'''
+
+"worker-laravel.conf" = '''
+[program:worker-laravel]
+process_name=%(program_name)s_%(process_num)02d
+command=bash -c 'exec php /app/artisan queue:work --sleep=3 --tries=3 --max-time=3600'
+user=www-data
+autostart=true
+autorestart=true
+stopasgroup=true
+killasgroup=true
+numprocs=12 # To reduce memory/CPU usage, change to 2.
+startsecs=0
+stopwaitsecs=3600
+stdout_logfile=/var/log/worker-laravel.log
+stderr_logfile=/var/log/worker-laravel.log
+'''
+
+"php-fpm.conf" = '''
+[www]
+listen = 127.0.0.1:9000
+user = www-data
+group = www-data
+listen.owner = www-data
+listen.group = www-data
+pm = dynamic
+pm.max_children = 50
+pm.min_spare_servers = 4
+pm.max_spare_servers = 32
+pm.start_servers = 18
+clear_env = no
+php_admin_value[post_max_size] = 35M
+php_admin_value[upload_max_filesize] = 30M
+'''
+
+"nginx.template.conf" = '''
+user www-data www-data;
+worker_processes 5;
+daemon off;
+
+worker_rlimit_nofile 8192;
+
+events {
+  worker_connections  4096;  # Default: 1024
+}
+
+http {
+    include    $!{nginx}/conf/mime.types;
+    index    index.html index.htm index.php;
+
+    default_type application/octet-stream;
+    log_format   main '$remote_addr - $remote_user [$time_local]  $status '
+        '"$request" $body_bytes_sent "$http_referer" '
+        '"$http_user_agent" "$http_x_forwarded_for"';
+    access_log /var/log/nginx-access.log;
+    error_log /var/log/nginx-error.log;
+    sendfile     on;
+    tcp_nopush   on;
+    server_names_hash_bucket_size 128; # this seems to be required for some vhosts
+
+    server {
+        listen ${PORT};
+        listen [::]:${PORT};
+        server_name localhost;
+
+        $if(NIXPACKS_PHP_ROOT_DIR) (
+            root ${NIXPACKS_PHP_ROOT_DIR};
+        ) else (
+            root /app;
+        )
+
+        add_header X-Content-Type-Options "nosniff";
+
+        client_max_body_size 35M;
+     
+        index index.php;
+     
+        charset utf-8;
+     
+
+        $if(NIXPACKS_PHP_FALLBACK_PATH) (
+            location / {
+                try_files $uri $uri/ ${NIXPACKS_PHP_FALLBACK_PATH}?$query_string;
+            }
+        ) else (
+          location / {
+                try_files $uri $uri/ /index.php?$query_string;
+           }
+        )
+     
+        location = /favicon.ico { access_log off; log_not_found off; }
+        location = /robots.txt  { access_log off; log_not_found off; }
+     
+        $if(IS_LARAVEL) (
+            error_page 404 /index.php;
+        ) else ()
+     
+        location ~ \.php$ {
+            fastcgi_pass 127.0.0.1:9000;
+            fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
+            include $!{nginx}/conf/fastcgi_params;
+            include $!{nginx}/conf/fastcgi.conf;
+        }
+     
+        location ~ /\.(?!well-known).* {
+            deny all;
+        }
+    }
+}
+'''
\ No newline at end of file