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);
+    }
+}