Rename controller namespaces: drop V1 prefix, clarify roles

V1/Admin     -> Company       (company-scoped controllers)
V1/SuperAdmin -> Admin        (platform-wide admin controllers)
V1/Customer  -> CustomerPortal (customer-facing portal)
V1/Installation -> Setup      (installation wizard)
V1/PDF       -> Pdf           (consistent casing)
V1/Modules   -> Modules       (drop V1 prefix)
V1/Webhook   -> Webhook       (drop V1 prefix)

The V1 prefix served no purpose - API versioning is in the route prefix
(/api/v1/), not the controller namespace. "Admin" was misleading for
company-scoped controllers. "SuperAdmin" is now simply "Admin" for
platform administration.

app/Http/Controllers/Admin/Backup/ApiController.php

@@ -0,0 +1,18 @@
+<?php
+
+// Implementation taken from nova-backup-tool - https://github.com/spatie/nova-backup-tool/
+
+namespace App\Http\Controllers\Admin\Backup;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\JsonResponse;
+
+class ApiController extends Controller
+{
+    public function respondSuccess(): JsonResponse
+    {
+        return response()->json([
+            'success' => true,
+        ]);
+    }
+}

app/Http/Controllers/Admin/Backup/BackupsController.php

@@ -0,0 +1,111 @@
+<?php
+
+// Implementation taken from nova-backup-tool - https://github.com/spatie/nova-backup-tool/
+
+namespace App\Http\Controllers\Admin\Backup;
+
+use App\Jobs\CreateBackupJob;
+use App\Models\FileDisk;
+use App\Rules\Backup\PathToZip;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Cache;
+use Spatie\Backup\BackupDestination\Backup;
+use Spatie\Backup\BackupDestination\BackupDestination;
+use Spatie\Backup\Helpers\Format;
+
+class BackupsController extends ApiController
+{
+    /**
+     * Display a listing of the resource.
+     *
+     * @return JsonResponse
+     */
+    public function index(Request $request)
+    {
+        $this->authorize('manage backups');
+
+        $configuredBackupDisks = config('backup.backup.destination.disks');
+
+        try {
+            if ($request->file_disk_id) {
+                $fileDisk = FileDisk::find($request->file_disk_id);
+                if ($fileDisk) {
+                    $fileDisk->setConfig();
+                    $prefix = env('DYNAMIC_DISK_PREFIX', 'temp_');
+                    config(['backup.backup.destination.disks' => [$prefix.$fileDisk->driver]]);
+                    $configuredBackupDisks = config('backup.backup.destination.disks');
+                }
+            }
+
+            $backupDestination = BackupDestination::create(config('filesystems.default'), config('backup.backup.name'));
+
+            $backups = Cache::remember("backups-{$request->file_disk_id}", now()->addSeconds(4), function () use ($backupDestination) {
+                return $backupDestination
+                    ->backups()
+                    ->map(function (Backup $backup) {
+                        return [
+                            'path' => $backup->path(),
+                            'created_at' => $backup->date()->format('Y-m-d H:i:s'),
+                            'size' => Format::humanReadableSize($backup->sizeInBytes()),
+                        ];
+                    })
+                    ->toArray();
+            });
+
+            return response()->json([
+                'backups' => $backups,
+                'disks' => $configuredBackupDisks,
+            ]);
+        } catch (\Exception $e) {
+            return response()->json([
+                'backups' => [],
+                'error' => 'invalid_disk_credentials',
+                'error_message' => $e->getMessage(),
+                'disks' => $configuredBackupDisks,
+            ]);
+        }
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     *
+     * @return JsonResponse
+     */
+    public function store(Request $request)
+    {
+        $this->authorize('manage backups');
+
+        $data = $request->all();
+        $data['company'] = $request->header('company');
+
+        dispatch(new CreateBackupJob($data))->onQueue(config('backup.queue.name'));
+
+        return $this->respondSuccess();
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     *
+     * @return JsonResponse
+     */
+    public function destroy($disk, Request $request)
+    {
+        $this->authorize('manage backups');
+
+        $validated = $request->validate([
+            'path' => ['required', new PathToZip],
+        ]);
+
+        $backupDestination = BackupDestination::create(config('filesystems.default'), config('backup.backup.name'));
+
+        $backupDestination
+            ->backups()
+            ->first(function (Backup $backup) use ($validated) {
+                return $backup->path() === $validated['path'];
+            })
+            ->delete();
+
+        return $this->respondSuccess();
+    }
+}

app/Http/Controllers/Admin/Backup/DownloadBackupController.php

@@ -0,0 +1,59 @@
+<?php
+
+// Implementation taken from nova-backup-tool - https://github.com/spatie/nova-backup-tool/
+
+namespace App\Http\Controllers\Admin\Backup;
+
+use App\Rules\Backup\PathToZip;
+use Illuminate\Http\Request;
+use Spatie\Backup\BackupDestination\Backup;
+use Spatie\Backup\BackupDestination\BackupDestination;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpFoundation\StreamedResponse;
+
+class DownloadBackupController extends ApiController
+{
+    public function __invoke(Request $request)
+    {
+        $this->authorize('manage backups');
+
+        $validated = $request->validate([
+            'path' => ['required', new PathToZip],
+        ]);
+
+        $backupDestination = BackupDestination::create(config('filesystems.default'), config('backup.backup.name'));
+
+        $backup = $backupDestination->backups()->first(function (Backup $backup) use ($validated) {
+            return $backup->path() === $validated['path'];
+        });
+
+        if (! $backup) {
+            return response('Backup not found', Response::HTTP_UNPROCESSABLE_ENTITY);
+        }
+
+        return $this->respondWithBackupStream($backup);
+    }
+
+    public function respondWithBackupStream(Backup $backup): StreamedResponse
+    {
+        $fileName = pathinfo($backup->path(), PATHINFO_BASENAME);
+
+        $downloadHeaders = [
+            'Cache-Control' => 'must-revalidate, post-check=0, pre-check=0',
+            'Content-Type' => 'application/zip',
+            'Content-Length' => $backup->sizeInBytes(),
+            'Content-Disposition' => 'attachment; filename="'.$fileName.'"',
+            'Pragma' => 'public',
+        ];
+
+        return response()->stream(function () use ($backup) {
+            $stream = $backup->stream();
+
+            fpassthru($stream);
+
+            if (is_resource($stream)) {
+                fclose($stream);
+            }
+        }, 200, $downloadHeaders);
+    }
+}

app/Http/Controllers/Admin/CompaniesController.php

@@ -0,0 +1,57 @@
+<?php
+
+namespace App\Http\Controllers\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\AdminCompanyUpdateRequest;
+use App\Http\Resources\CompanyResource;
+use App\Models\Company;
+use Illuminate\Http\Request;
+
+class CompaniesController extends Controller
+{
+    public function index(Request $request)
+    {
+        $companies = Company::query()
+            ->with(['owner', 'address'])
+            ->when($request->has('search'), function ($query) use ($request) {
+                $query->where('name', 'like', '%'.$request->search.'%');
+            })
+            ->when($request->has('orderByField') && $request->has('orderBy'), function ($query) use ($request) {
+                $query->orderBy($request->orderByField, $request->orderBy);
+            }, function ($query) {
+                $query->orderBy('name', 'asc');
+            })
+            ->paginate($request->input('limit', 10));
+
+        return CompanyResource::collection($companies);
+    }
+
+    public function show(Company $company)
+    {
+        $company->load(['owner', 'address']);
+
+        return new CompanyResource($company);
+    }
+
+    public function update(AdminCompanyUpdateRequest $request, Company $company)
+    {
+        $company->update([
+            'name' => $request->name,
+            'vat_id' => $request->vat_id,
+            'tax_id' => $request->tax_id,
+            'owner_id' => $request->owner_id,
+        ]);
+
+        if ($request->has('address')) {
+            $company->address()->updateOrCreate(
+                ['company_id' => $company->id],
+                $request->address,
+            );
+        }
+
+        $company->load(['owner', 'address']);
+
+        return new CompanyResource($company);
+    }
+}

app/Http/Controllers/Admin/CountriesController.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Http\Controllers\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Http\Resources\CountryResource;
+use App\Models\Country;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class CountriesController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return JsonResponse
+     */
+    public function __invoke(Request $request)
+    {
+        $countries = Country::all();
+
+        return CountryResource::collection($countries);
+    }
+}

app/Http/Controllers/Admin/CurrenciesController.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Http\Controllers\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Http\Resources\CurrencyResource;
+use App\Models\Currency;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class CurrenciesController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request)
+    {
+        $currencies = Currency::latest()->get();
+
+        return CurrencyResource::collection($currencies);
+    }
+}

app/Http/Controllers/Admin/Modules/ApiTokenController.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Modules;
+
+use App\Http\Controllers\Controller;
+use App\Services\Module\ModuleInstaller;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class ApiTokenController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request)
+    {
+        $this->authorize('manage modules');
+
+        $response = ModuleInstaller::checkToken($request->api_token);
+
+        return $response;
+    }
+}

app/Http/Controllers/Admin/Modules/CompleteModuleInstallationController.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Modules;
+
+use App\Http\Controllers\Controller;
+use App\Services\Module\ModuleInstaller;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class CompleteModuleInstallationController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request)
+    {
+        $this->authorize('manage modules');
+
+        $response = ModuleInstaller::complete($request->module, $request->version);
+
+        return response()->json([
+            'success' => $response,
+        ]);
+    }
+}

app/Http/Controllers/Admin/Modules/CopyModuleController.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Modules;
+
+use App\Http\Controllers\Controller;
+use App\Services\Module\ModuleInstaller;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class CopyModuleController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request)
+    {
+        $this->authorize('manage modules');
+
+        $response = ModuleInstaller::copyFiles($request->module, $request->path);
+
+        return response()->json([
+            'success' => $response,
+        ]);
+    }
+}

app/Http/Controllers/Admin/Modules/DisableModuleController.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Modules;
+
+use App\Events\ModuleDisabledEvent;
+use App\Http\Controllers\Controller;
+use App\Models\Module as ModelsModule;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Nwidart\Modules\Facades\Module;
+
+class DisableModuleController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request, string $module)
+    {
+        $this->authorize('manage modules');
+
+        $module = ModelsModule::where('name', $module)->first();
+        $module->update(['enabled' => false]);
+        $installedModule = Module::find($module->name);
+        $installedModule->disable();
+
+        ModuleDisabledEvent::dispatch($module);
+
+        return response()->json(['success' => true]);
+    }
+}

app/Http/Controllers/Admin/Modules/DownloadModuleController.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Modules;
+
+use App\Http\Controllers\Controller;
+use App\Services\Module\ModuleInstaller;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class DownloadModuleController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request)
+    {
+        $this->authorize('manage modules');
+
+        $response = ModuleInstaller::download($request->module, $request->version);
+
+        return response()->json($response);
+    }
+}

app/Http/Controllers/Admin/Modules/EnableModuleController.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Modules;
+
+use App\Events\ModuleEnabledEvent;
+use App\Http\Controllers\Controller;
+use App\Models\Module as ModelsModule;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Nwidart\Modules\Facades\Module;
+
+class EnableModuleController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request, string $module)
+    {
+        $this->authorize('manage modules');
+
+        $module = ModelsModule::where('name', $module)->first();
+        $module->update(['enabled' => true]);
+        $installedModule = Module::find($module->name);
+        $installedModule->enable();
+
+        ModuleEnabledEvent::dispatch($module);
+
+        return response()->json(['success' => true]);
+    }
+}

app/Http/Controllers/Admin/Modules/ModuleController.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Modules;
+
+use App\Http\Controllers\Controller;
+use App\Http\Resources\ModuleResource;
+use App\Services\Module\ModuleInstaller;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class ModuleController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request, string $module)
+    {
+        $this->authorize('manage modules');
+
+        $response = ModuleInstaller::getModule($module);
+
+        if (! $response->success) {
+            return response()->json($response);
+        }
+
+        return (new ModuleResource($response->module))
+            ->additional(['meta' => [
+                'modules' => ModuleResource::collection(collect($response->modules)),
+            ]]);
+    }
+}

app/Http/Controllers/Admin/Modules/ModulesController.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Modules;
+
+use App\Http\Controllers\Controller;
+use App\Services\Module\ModuleInstaller;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class ModulesController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request)
+    {
+        $this->authorize('manage modules');
+
+        $response = ModuleInstaller::getModules();
+
+        return $response;
+    }
+}

app/Http/Controllers/Admin/Modules/UnzipModuleController.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Modules;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\UnzipUpdateRequest;
+use App\Services\Module\ModuleInstaller;
+use Illuminate\Http\Response;
+
+class UnzipModuleController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(UnzipUpdateRequest $request)
+    {
+        $this->authorize('manage modules');
+
+        $path = ModuleInstaller::unzip($request->module, $request->path);
+
+        return response()->json([
+            'success' => true,
+            'path' => $path,
+        ]);
+    }
+}

app/Http/Controllers/Admin/Modules/UploadModuleController.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Modules;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\UploadModuleRequest;
+use App\Services\Module\ModuleInstaller;
+use Illuminate\Http\Response;
+
+class UploadModuleController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(UploadModuleRequest $request)
+    {
+        $this->authorize('manage modules');
+
+        $response = ModuleInstaller::upload($request);
+
+        return response()->json($response);
+    }
+}

app/Http/Controllers/Admin/Settings/DiskController.php

@@ -0,0 +1,195 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Settings;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\DiskEnvironmentRequest;
+use App\Http\Resources\FileDiskResource;
+use App\Models\FileDisk;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class DiskController extends Controller
+{
+    /**
+     * @return JsonResponse
+     */
+    public function index(Request $request)
+    {
+        $this->authorize('manage file disk');
+
+        $limit = $request->has('limit') ? $request->limit : 5;
+        $disks = FileDisk::applyFilters($request->all())
+            ->latest()
+            ->paginateData($limit);
+
+        return FileDiskResource::collection($disks);
+    }
+
+    /**
+     * @return JsonResponse
+     */
+    public function store(DiskEnvironmentRequest $request)
+    {
+        $this->authorize('manage file disk');
+
+        if (! FileDisk::validateCredentials($request->credentials, $request->driver)) {
+            return respondJson('invalid_credentials', 'Invalid Credentials.');
+        }
+
+        $disk = FileDisk::createDisk($request);
+
+        return new FileDiskResource($disk);
+    }
+
+    /**
+     * @param  FileDisk  $file_disk
+     * @return JsonResponse
+     */
+    public function update(FileDisk $disk, Request $request)
+    {
+        $this->authorize('manage file disk');
+
+        $credentials = $request->credentials;
+        $driver = $request->driver;
+
+        if ($credentials && $driver && $disk->type !== 'SYSTEM') {
+            if (! FileDisk::validateCredentials($credentials, $driver)) {
+                return respondJson('invalid_credentials', 'Invalid Credentials.');
+            }
+
+            $disk->updateDisk($request);
+        } elseif ($request->set_as_default) {
+            $disk->setAsDefaultDisk();
+        }
+
+        return new FileDiskResource($disk);
+    }
+
+    /**
+     * @param  Request  $request
+     * @return JsonResponse
+     */
+    public function show($disk)
+    {
+        $this->authorize('manage file disk');
+
+        $diskData = [];
+        switch ($disk) {
+            case 'local':
+                $diskData = [
+                    'root' => config('filesystems.disks.local.root'),
+                ];
+
+                break;
+
+            case 's3':
+                $diskData = [
+                    'key' => '',
+                    'secret' => '',
+                    'region' => '',
+                    'bucket' => '',
+                    'root' => '',
+                ];
+
+                break;
+
+            case 's3compat':
+                $diskData = [
+                    'endpoint' => '',
+                    'key' => '',
+                    'secret' => '',
+                    'region' => '',
+                    'bucket' => '',
+                    'root' => '',
+                ];
+
+            case 'doSpaces':
+                $diskData = [
+                    'key' => '',
+                    'secret' => '',
+                    'region' => '',
+                    'bucket' => '',
+                    'endpoint' => '',
+                    'root' => '',
+                ];
+
+                break;
+
+            case 'dropbox':
+                $diskData = [
+                    'token' => '',
+                    'key' => '',
+                    'secret' => '',
+                    'app' => '',
+                    'root' => '',
+                ];
+
+                break;
+        }
+
+        $data = array_merge($diskData);
+
+        return response()->json($data);
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     *
+     * @param  FileDisk  $taxType
+     * @return Response
+     */
+    public function destroy(FileDisk $disk)
+    {
+        $this->authorize('manage file disk');
+
+        if ($disk->setAsDefault() && $disk->type === 'SYSTEM') {
+            return respondJson('not_allowed', 'Not Allowed');
+        }
+
+        $disk->delete();
+
+        return response()->json([
+            'success' => true,
+        ]);
+    }
+
+    /**
+     * @return JsonResponse
+     */
+    public function getDiskDrivers()
+    {
+        $this->authorize('manage file disk');
+
+        $drivers = [
+            [
+                'name' => 'Local',
+                'value' => 'local',
+            ],
+            [
+                'name' => 'Amazon S3',
+                'value' => 's3',
+            ],
+            [
+                'name' => 'S3 Compatible Storage',
+                'value' => 's3compat',
+            ],
+            [
+                'name' => 'Digital Ocean Spaces',
+                'value' => 'doSpaces',
+            ],
+            [
+                'name' => 'Dropbox',
+                'value' => 'dropbox',
+            ],
+        ];
+
+        $default = config('filesystems.default');
+
+        return response()->json([
+            'drivers' => $drivers,
+            'default' => $default,
+        ]);
+    }
+}

app/Http/Controllers/Admin/Settings/GetSettingsController.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Settings;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\GetSettingRequest;
+use App\Models\Setting;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class GetSettingsController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @param  Request  $request
+     * @return Response
+     */
+    public function __invoke(GetSettingRequest $request)
+    {
+        $this->authorize('manage settings');
+
+        $setting = Setting::getSetting($request->key);
+
+        return response()->json([
+            $request->key => $setting,
+        ]);
+    }
+}

app/Http/Controllers/Admin/Settings/MailConfigurationController.php

@@ -0,0 +1,257 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Settings;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\MailEnvironmentRequest;
+use App\Mail\TestMail;
+use App\Models\Setting;
+use App\Services\Installation\EnvironmentManager;
+use Illuminate\Auth\Access\AuthorizationException;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Validation\ValidationException;
+use Mail;
+
+class MailConfigurationController extends Controller
+{
+    /**
+     * The environment manager
+     *
+     * @var EnvironmentManager
+     */
+    protected $environmentManager;
+
+    /**
+     * The constructor
+     */
+    public function __construct(EnvironmentManager $environmentManager)
+    {
+        $this->environmentManager = $environmentManager;
+    }
+
+    /**
+     * Save the mail environment variables
+     *
+     * @return JsonResponse
+     *
+     * @throws AuthorizationException
+     */
+    public function saveMailEnvironment(MailEnvironmentRequest $request)
+    {
+        $this->authorize('manage email config');
+
+        $setting = Setting::getSetting('profile_complete');
+
+        // Prepare mail settings for database storage
+        $mailSettings = $this->prepareMailSettingsForDatabase($request);
+
+        // Save mail settings to database
+        Setting::setSettings($mailSettings);
+
+        if ($setting !== 'COMPLETED') {
+            Setting::setSetting('profile_complete', 4);
+        }
+
+        return response()->json([
+            'success' => 'mail_variables_save_successfully',
+        ]);
+    }
+
+    /**
+     * Prepare mail settings for database storage
+     *
+     * @return array
+     */
+    private function prepareMailSettingsForDatabase(MailEnvironmentRequest $request)
+    {
+        $driver = $request->get('mail_driver');
+
+        // Base settings that are always saved
+        $settings = [
+            'mail_driver' => $driver,
+            'from_name' => $request->get('from_name'),
+            'from_mail' => $request->get('from_mail'),
+        ];
+
+        // Driver-specific settings
+        switch ($driver) {
+            case 'smtp':
+                $settings = array_merge($settings, [
+                    'mail_host' => $request->get('mail_host'),
+                    'mail_port' => $request->get('mail_port'),
+                    'mail_username' => $request->get('mail_username'),
+                    'mail_password' => $request->get('mail_password'),
+                    'mail_encryption' => $request->get('mail_encryption', 'none'),
+                    'mail_scheme' => $request->get('mail_scheme'),
+                    'mail_url' => $request->get('mail_url'),
+                    'mail_timeout' => $request->get('mail_timeout'),
+                    'mail_local_domain' => $request->get('mail_local_domain'),
+                ]);
+                break;
+
+            case 'mailgun':
+                $settings = array_merge($settings, [
+                    'mail_mailgun_domain' => $request->get('mail_mailgun_domain'),
+                    'mail_mailgun_secret' => $request->get('mail_mailgun_secret'),
+                    'mail_mailgun_endpoint' => $request->get('mail_mailgun_endpoint', 'api.mailgun.net'),
+                    'mail_mailgun_scheme' => $request->get('mail_mailgun_scheme', 'https'),
+                ]);
+                break;
+
+            case 'ses':
+                $settings = array_merge($settings, [
+                    'mail_ses_key' => $request->get('mail_ses_key'),
+                    'mail_ses_secret' => $request->get('mail_ses_secret'),
+                    'mail_ses_region' => $request->get('mail_ses_region', 'us-east-1'),
+                ]);
+                break;
+
+            case 'sendmail':
+                $settings = array_merge($settings, [
+                    'mail_sendmail_path' => $request->get('mail_sendmail_path', '/usr/sbin/sendmail -bs -i'),
+                ]);
+                break;
+        }
+
+        return $settings;
+    }
+
+    /**
+     * Return the mail environment variables
+     *
+     * @return JsonResponse
+     *
+     * @throws AuthorizationException
+     */
+    public function getMailEnvironment()
+    {
+        $this->authorize('manage email config');
+
+        // Get mail settings from database
+        $mailSettings = Setting::getSettings([
+            'mail_driver',
+            'mail_host',
+            'mail_port',
+            'mail_username',
+            'mail_password',
+            'mail_encryption',
+            'mail_scheme',
+            'mail_url',
+            'mail_timeout',
+            'mail_local_domain',
+            'from_name',
+            'from_mail',
+            'mail_mailgun_domain',
+            'mail_mailgun_secret',
+            'mail_mailgun_endpoint',
+            'mail_mailgun_scheme',
+            'mail_ses_key',
+            'mail_ses_secret',
+            'mail_ses_region',
+            'mail_sendmail_path',
+        ]);
+
+        $driver = $mailSettings['mail_driver'] ?? config('mail.default');
+
+        // Base data that's always available
+        $MailData = [
+            'mail_driver' => $driver,
+            'from_name' => $mailSettings['from_name'] ?? config('mail.from.name'),
+            'from_mail' => $mailSettings['from_mail'] ?? config('mail.from.address'),
+        ];
+
+        // Driver-specific configuration
+        switch ($driver) {
+            case 'smtp':
+                $MailData = array_merge($MailData, [
+                    'mail_host' => $mailSettings['mail_host'] ?? config('mail.mailers.smtp.host', ''),
+                    'mail_port' => $mailSettings['mail_port'] ?? config('mail.mailers.smtp.port', ''),
+                    'mail_username' => $mailSettings['mail_username'] ?? config('mail.mailers.smtp.username', ''),
+                    'mail_password' => $mailSettings['mail_password'] ?? config('mail.mailers.smtp.password', ''),
+                    'mail_encryption' => $mailSettings['mail_encryption'] ?? config('mail.mailers.smtp.encryption', 'none'),
+                    'mail_scheme' => $mailSettings['mail_scheme'] ?? '',
+                    'mail_url' => $mailSettings['mail_url'] ?? '',
+                    'mail_timeout' => $mailSettings['mail_timeout'] ?? '',
+                    'mail_local_domain' => $mailSettings['mail_local_domain'] ?? '',
+                ]);
+                break;
+
+            case 'mailgun':
+                $MailData = array_merge($MailData, [
+                    'mail_mailgun_domain' => $mailSettings['mail_mailgun_domain'] ?? '',
+                    'mail_mailgun_secret' => $mailSettings['mail_mailgun_secret'] ?? '',
+                    'mail_mailgun_endpoint' => $mailSettings['mail_mailgun_endpoint'] ?? 'api.mailgun.net',
+                    'mail_mailgun_scheme' => $mailSettings['mail_mailgun_scheme'] ?? 'https',
+                ]);
+                break;
+
+            case 'ses':
+                $MailData = array_merge($MailData, [
+                    'mail_ses_key' => $mailSettings['mail_ses_key'] ?? '',
+                    'mail_ses_secret' => $mailSettings['mail_ses_secret'] ?? '',
+                    'mail_ses_region' => $mailSettings['mail_ses_region'] ?? 'us-east-1',
+                ]);
+                break;
+
+            case 'sendmail':
+                $MailData = array_merge($MailData, [
+                    'mail_sendmail_path' => $mailSettings['mail_sendmail_path'] ?? '/usr/sbin/sendmail -bs -i',
+                ]);
+                break;
+
+            default:
+                // For unknown drivers, return minimal configuration
+                break;
+        }
+
+        return response()->json($MailData);
+    }
+
+    /**
+     * Return the available mail drivers
+     *
+     * @return JsonResponse
+     *
+     * @throws AuthorizationException
+     */
+    public function getMailDrivers()
+    {
+        $this->authorize('manage email config');
+
+        $drivers = [
+            'smtp',
+            'mail',
+            'sendmail',
+            'mailgun',
+            'ses',
+        ];
+
+        return response()->json($drivers);
+    }
+
+    /**
+     * Test the email configuration
+     *
+     * @return JsonResponse
+     *
+     * @throws AuthorizationException
+     * @throws ValidationException
+     */
+    public function testEmailConfig(Request $request)
+    {
+        $this->authorize('manage email config');
+
+        $this->validate($request, [
+            'to' => 'required|email',
+            'subject' => 'required',
+            'message' => 'required',
+        ]);
+
+        Mail::to($request->to)->send(new TestMail($request->subject, $request->message));
+
+        return response()->json([
+            'success' => true,
+        ]);
+    }
+}

app/Http/Controllers/Admin/Settings/PDFConfigurationController.php

@@ -0,0 +1,102 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Settings;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\PDFConfigurationRequest;
+use App\Models\Setting;
+use App\Services\Installation\EnvironmentManager;
+
+class PDFConfigurationController extends Controller
+{
+    /**
+     * @var EnvironmentManager
+     */
+    protected $environmentManager;
+
+    public function __construct(EnvironmentManager $environmentManager)
+    {
+        $this->environmentManager = $environmentManager;
+    }
+
+    public function getDrivers()
+    {
+        $this->authorize('manage pdf config');
+
+        $drivers = [
+            'dompdf',
+            'gotenberg',
+        ];
+
+        return response()->json($drivers);
+    }
+
+    public function getEnvironment()
+    {
+        $this->authorize('manage pdf config');
+
+        // Get PDF settings from database
+        $pdfSettings = Setting::getSettings([
+            'pdf_driver',
+            'gotenberg_host',
+            'gotenberg_papersize',
+            'gotenberg_margins',
+        ]);
+
+        $config = [
+            'pdf_driver' => $pdfSettings['pdf_driver'] ?? config('pdf.driver'),
+            'gotenberg_host' => $pdfSettings['gotenberg_host'] ?? config('pdf.connections.gotenberg.host'),
+            'gotenberg_margins' => $pdfSettings['gotenberg_margins'] ?? config('pdf.connections.gotenberg.margins'),
+            'gotenberg_papersize' => $pdfSettings['gotenberg_papersize'] ?? config('pdf.connections.gotenberg.papersize'),
+        ];
+
+        return response()->json($config);
+    }
+
+    public function saveEnvironment(PDFConfigurationRequest $request)
+    {
+        $this->authorize('manage pdf config');
+
+        // Prepare PDF settings for database storage
+        $pdfSettings = $this->preparePDFSettingsForDatabase($request);
+
+        // Save PDF settings to database
+        Setting::setSettings($pdfSettings);
+
+        return response()->json([
+            'success' => 'pdf_variables_save_successfully',
+        ]);
+    }
+
+    /**
+     * Prepare PDF settings for database storage
+     *
+     * @return array
+     */
+    private function preparePDFSettingsForDatabase(PDFConfigurationRequest $request)
+    {
+        $driver = $request->get('pdf_driver');
+
+        // Base settings that are always saved
+        $settings = [
+            'pdf_driver' => $driver,
+        ];
+
+        // Driver-specific settings
+        switch ($driver) {
+            case 'gotenberg':
+                $settings = array_merge($settings, [
+                    'gotenberg_host' => $request->get('gotenberg_host'),
+                    'gotenberg_papersize' => $request->get('gotenberg_papersize'),
+                    'gotenberg_margins' => $request->get('gotenberg_margins'),
+                ]);
+                break;
+
+            case 'dompdf':
+                // dompdf doesn't have additional configuration in the current setup
+                break;
+        }
+
+        return $settings;
+    }
+}

app/Http/Controllers/Admin/Settings/UpdateSettingsController.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Settings;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\SettingRequest;
+use App\Models\Setting;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class UpdateSettingsController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @param  Request  $request
+     * @return Response
+     */
+    public function __invoke(SettingRequest $request)
+    {
+        $this->authorize('manage settings');
+
+        Setting::setSettings($request->settings);
+
+        return response()->json([
+            'success' => true,
+            $request->settings,
+        ]);
+    }
+}

app/Http/Controllers/Admin/Update/CheckVersionController.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Update;
+
+use App\Http\Controllers\Controller;
+use App\Services\Update\Updater;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\File;
+
+class CheckVersionController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return JsonResponse
+     */
+    public function __invoke(Request $request)
+    {
+        if ((! $request->user()) || (! $request->user()->isOwner())) {
+            return response()->json([
+                'success' => false,
+                'message' => 'You are not allowed to update this app.',
+            ], 401);
+        }
+
+        set_time_limit(600); // 10 minutes
+
+        $channel = $request->get('channel', 'stable');
+        $version = preg_replace('~[\r\n]+~', '', File::get(base_path('version.md')));
+        $response = Updater::checkForUpdate($version, $channel);
+
+        return response()->json($response);
+    }
+}

app/Http/Controllers/Admin/Update/CopyFilesController.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Update;
+
+use App\Http\Controllers\Controller;
+use App\Services\Update\Updater;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class CopyFilesController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request)
+    {
+        if ((! $request->user()) || (! $request->user()->isOwner())) {
+            return response()->json([
+                'success' => false,
+                'message' => 'You are not allowed to update this app.',
+            ], 401);
+        }
+
+        $request->validate([
+            'path' => 'required',
+        ]);
+
+        $path = Updater::copyFiles($request->path);
+
+        return response()->json([
+            'success' => true,
+            'path' => $path,
+        ]);
+    }
+}

app/Http/Controllers/Admin/Update/DeleteFilesController.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Update;
+
+use App\Http\Controllers\Controller;
+use App\Services\Update\Updater;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class DeleteFilesController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request)
+    {
+        if ((! $request->user()) || (! $request->user()->isOwner())) {
+            return response()->json([
+                'success' => false,
+                'message' => 'You are not allowed to update this app.',
+            ], 401);
+        }
+
+        if (isset($request->deleted_files) && ! empty($request->deleted_files)) {
+            Updater::deleteFiles($request->deleted_files);
+        }
+
+        return response()->json([
+            'success' => true,
+        ]);
+    }
+}

app/Http/Controllers/Admin/Update/DownloadUpdateController.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Update;
+
+use App\Http\Controllers\Controller;
+use App\Services\Update\Updater;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class DownloadUpdateController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request)
+    {
+        if ((! $request->user()) || (! $request->user()->isOwner())) {
+            return response()->json([
+                'success' => false,
+                'message' => 'You are not allowed to update this app.',
+            ], 401);
+        }
+
+        $request->validate([
+            'version' => 'required',
+        ]);
+
+        $path = Updater::download($request->version);
+
+        return response()->json([
+            'success' => true,
+            'path' => $path,
+        ]);
+    }
+}

app/Http/Controllers/Admin/Update/FinishUpdateController.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Update;
+
+use App\Http\Controllers\Controller;
+use App\Services\Update\Updater;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class FinishUpdateController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request)
+    {
+        if ((! $request->user()) || (! $request->user()->isOwner())) {
+            return response()->json([
+                'success' => false,
+                'message' => 'You are not allowed to update this app.',
+            ], 401);
+        }
+
+        $request->validate([
+            'installed' => 'required',
+            'version' => 'required',
+        ]);
+
+        $json = Updater::finishUpdate($request->installed, $request->version);
+
+        return response()->json($json);
+    }
+}

app/Http/Controllers/Admin/Update/MigrateUpdateController.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Update;
+
+use App\Http\Controllers\Controller;
+use App\Services\Update\Updater;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class MigrateUpdateController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request)
+    {
+        if ((! $request->user()) || (! $request->user()->isOwner())) {
+            return response()->json([
+                'success' => false,
+                'message' => 'You are not allowed to update this app.',
+            ], 401);
+        }
+
+        Updater::migrateUpdate();
+
+        return response()->json([
+            'success' => true,
+        ]);
+    }
+}

app/Http/Controllers/Admin/Update/UnzipUpdateController.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Update;
+
+use App\Http\Controllers\Controller;
+use App\Services\Update\Updater;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class UnzipUpdateController extends Controller
+{
+    /**
+     * Handle the incoming request.
+     *
+     * @return Response
+     */
+    public function __invoke(Request $request)
+    {
+        if ((! $request->user()) || (! $request->user()->isOwner())) {
+            return response()->json([
+                'success' => false,
+                'message' => 'You are not allowed to update this app.',
+            ], 401);
+        }
+
+        $request->validate([
+            'path' => 'required',
+        ]);
+
+        try {
+            $path = Updater::unzip($request->path);
+
+            return response()->json([
+                'success' => true,
+                'path' => $path,
+            ]);
+        } catch (\Exception $e) {
+            return response()->json([
+                'success' => false,
+                'error' => $e->getMessage(),
+            ], 500);
+        }
+    }
+}

app/Http/Controllers/Admin/Update/UpdateController.php

@@ -0,0 +1,102 @@
+<?php
+
+namespace App\Http\Controllers\Admin\Update;
+
+use App\Http\Controllers\Controller;
+use App\Models\Setting;
+use App\Services\Update\Updater;
+use Illuminate\Http\Request;
+
+class UpdateController extends Controller
+{
+    public function download(Request $request)
+    {
+        $this->authorize('manage update app');
+
+        $request->validate([
+            'version' => 'required',
+        ]);
+
+        $path = Updater::download($request->version);
+
+        return response()->json([
+            'success' => true,
+            'path' => $path,
+        ]);
+    }
+
+    public function unzip(Request $request)
+    {
+        $this->authorize('manage update app');
+
+        $request->validate([
+            'path' => 'required',
+        ]);
+
+        try {
+            $path = Updater::unzip($request->path);
+
+            return response()->json([
+                'success' => true,
+                'path' => $path,
+            ]);
+        } catch (\Exception $e) {
+            return response()->json([
+                'success' => false,
+                'error' => $e->getMessage(),
+            ], 500);
+        }
+    }
+
+    public function copyFiles(Request $request)
+    {
+        $this->authorize('manage update app');
+
+        $request->validate([
+            'path' => 'required',
+        ]);
+
+        $path = Updater::copyFiles($request->path);
+
+        return response()->json([
+            'success' => true,
+            'path' => $path,
+        ]);
+    }
+
+    public function migrate(Request $request)
+    {
+        $this->authorize('manage update app');
+
+        Updater::migrateUpdate();
+
+        return response()->json([
+            'success' => true,
+        ]);
+    }
+
+    public function finishUpdate(Request $request)
+    {
+        $this->authorize('manage update app');
+
+        $request->validate([
+            'installed' => 'required',
+            'version' => 'required',
+        ]);
+
+        $json = Updater::finishUpdate($request->installed, $request->version);
+
+        return response()->json($json);
+    }
+
+    public function checkLatestVersion(Request $request)
+    {
+        $this->authorize('manage update app');
+
+        set_time_limit(600); // 10 minutes
+
+        $json = Updater::checkForUpdate(Setting::getSetting('version'));
+
+        return response()->json($json);
+    }
+}

app/Http/Controllers/Admin/UsersController.php

@@ -0,0 +1,101 @@
+<?php
+
+namespace App\Http\Controllers\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\AdminUserUpdateRequest;
+use App\Http\Resources\UserResource;
+use App\Models\ImpersonationLog;
+use App\Models\User;
+use Illuminate\Http\Request;
+use Laravel\Sanctum\PersonalAccessToken;
+
+class UsersController extends Controller
+{
+    public function index(Request $request)
+    {
+        $limit = $request->has('limit') ? $request->limit : 10;
+
+        $users = User::with('companies')
+            ->applyFilters($request->all())
+            ->latest()
+            ->paginate($limit);
+
+        return UserResource::collection($users);
+    }
+
+    public function show(User $user)
+    {
+        $user->load('companies');
+
+        return new UserResource($user);
+    }
+
+    public function update(AdminUserUpdateRequest $request, User $user)
+    {
+        $data = $request->only(['name', 'email', 'phone']);
+
+        if ($request->filled('password')) {
+            $data['password'] = $request->password;
+        }
+
+        $user->update($data);
+
+        return new UserResource($user);
+    }
+
+    public function impersonate(Request $request, User $user)
+    {
+        $admin = $request->user();
+
+        if ($admin->id === $user->id) {
+            return response()->json([
+                'error' => 'cannot_impersonate_self',
+                'message' => 'You cannot impersonate yourself.',
+            ], 422);
+        }
+
+        $token = $user->createToken(
+            'impersonation-by-'.$admin->id,
+            ['*'],
+            now()->addHours(2),
+        );
+
+        $log = ImpersonationLog::create([
+            'admin_id' => $admin->id,
+            'user_id' => $user->id,
+            'ip_address' => $request->ip(),
+            'token_id' => $token->accessToken->id,
+        ]);
+
+        return response()->json([
+            'token' => $token->plainTextToken,
+            'impersonation_log_id' => $log->id,
+            'user' => new UserResource($user),
+        ]);
+    }
+
+    public function stopImpersonating(Request $request)
+    {
+        $token = $request->user()->currentAccessToken();
+
+        if ($token instanceof PersonalAccessToken && str_starts_with($token->name, 'impersonation-by-')) {
+            $log = ImpersonationLog::where('token_id', $token->id)
+                ->whereNull('stopped_at')
+                ->first();
+
+            if ($log) {
+                $log->update(['stopped_at' => now()]);
+            }
+
+            $token->delete();
+
+            return response()->json(['success' => true]);
+        }
+
+        return response()->json([
+            'error' => 'not_impersonating',
+            'message' => 'No active impersonation session.',
+        ], 422);
+    }
+}