Download Student Applications as PDF (background process) and Excel

.env.example

@@ -24,12 +24,16 @@ DB_PASSWORD=
 # SENTRY_ENABLE_LOGS=true
 # SENTRY_LOG_LEVEL=debug
 
+CACHE_DRIVER=redis
+REDIS_PORT=6379
+QUEUE_CONNECTION=database
+
 BROADCAST_DRIVER=log
 CACHE_DRIVER=file
 SESSION_DRIVER=file
 SESSION_LIFETIME=120
-QUEUE_DRIVER=sync
 IMAGE_DRIVER=gd
+PDF_DRIVER=
 
 IMAGE_MAX_MB=10
 
@@ -92,6 +96,7 @@ ENABLE_STUDENTS=false
 
 # Export profiles to PDF (requires exporter installation)
 ENABLE_PDF=false
+ENABLE_AUTO_CLEAN_PDFS_DIR=false
 # CHROME_PATH="/path/to/my/chrome"
 # CHROME_ARGS="{\"font-render-hinting\": \"none\"}"
 # NODE_PATH="/path/to/my/node"

app/Console/Commands/CleanUpPdfFiles.php

@@ -0,0 +1,85 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Carbon\Carbon;
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\Storage;
+
+class CleanUpPdfFiles extends Command
+{
+    protected $signature = 'files:clean-up-pdfs
+                            {--root=tmp/reports : Root directory where timestamped folders live}
+                            {--hours=2 : Delete folders older than this many hours}
+                            {--disk= : Filesystem disk to use (defaults to FILESYSTEM_DISK)}
+                            {--dry : Show what would be deleted, but don\'t delete}';
+
+    protected $description = 'Delete temporary PDF folders (Ymd_Hi format) older than the specified number of hours. Default: 2 hours.';
+
+    public function handle(): int
+    {
+        $disk_name = $this->option('disk') ?: config('filesystems.default');
+        $disk     = Storage::disk($disk_name);
+
+        $root     = rtrim($this->option('root') ?? 'tmp/reports', '/');
+        $hours_opt = (string) ($this->option('hours') ?? '2');
+
+
+        if (!ctype_digit($hours_opt)) { // validate hours
+            $this->error("Invalid --hours value: {$hours_opt}. Use a non-negative integer.");
+            return self::FAILURE;
+        }
+        $hours = (int) $hours_opt;
+
+        $now    = now()->second(0);
+        $cutoff = $now->copy()->subHours($hours);
+
+        if (!$disk->exists($root)) {
+            $this->info("Root '{$root}' does not exist on disk '{$disk_name}'. Nothing to do.");
+            return self::SUCCESS;
+        }
+
+        // Only consider folders named Ymd_Hi (e.g., 20250826_1430)
+        $dirs = collect($disk->directories($root))
+                ->filter(fn ($path) => (bool) preg_match('~^' . preg_quote($root, '~') . '/\d{8}_\d{4}$~', $path))
+                ->sort()
+                ->values();
+
+        if ($dirs->isEmpty()) {
+            $this->info("No timestamped folders found under '{$root}'.");
+            return self::SUCCESS;
+        }
+
+        $dry = (bool) $this->option('dry');
+        $deleted = 0; $skipped = 0;
+
+        foreach ($dirs as $dir) {
+            $stamp = basename($dir);
+
+            // Parse folder timestamp; skip if malformed
+            $bucket_time = Carbon::createFromFormat('Ymd_Hi', $stamp, $now->timezone)->second(0);
+            if ($bucket_time === false) {
+                $this->warn("Skipping malformed folder name: {$dir}");
+                $skipped++;
+                continue;
+            }
+
+            if ($bucket_time->lt($cutoff)) {
+                if ($dry) {
+                    $this->line("[DRY] Would delete: {$dir} ({$bucket_time->toDateTimeString()})");
+                } else {
+                    $disk->deleteDirectory($dir);
+                    $this->line("Deleted: {$dir} ({$bucket_time->toDateTimeString()})");
+                }
+                $deleted++;
+            } else {
+                $skipped++;
+            }
+        }
+
+        $summary = $dry ? 'would delete' : 'deleted';
+        $this->info("Cleanup complete: {$summary} {$deleted}, kept {$skipped}. Disk='{$disk_name}', Root='{$root}', Cutoff='{$cutoff->toDateTimeString()}'.");
+
+        return self::SUCCESS;
+    }
+}

app/Console/Kernel.php

@@ -36,6 +36,13 @@ protected function schedule(Schedule $schedule)
         $schedule->command('profiles:update-orcid')->weekly()->sundays()->at('05:00')->when(function() {
             return config('app.enable_orcid_update');
         });
+        $schedule
+            ->command('files:clean-up-pdfs --root=tmp/reports --hours=2')
+            ->everyTwoHours()
+            ->withoutOverlapping()
+            ->when(function() {
+               return config('app.enable_auto_clean_pdfs_dir'); 
+            });
     }
 
     /**

app/Helpers/BrowsershotPdfHelper.php

@@ -0,0 +1,81 @@
+<?php
+
+namespace App\Helpers;
+
+use App\Helpers\Contracts\PdfGenerationHelperContract;
+use App\PdfGenerationResult;
+use Carbon\Carbon;
+use Illuminate\Support\Facades\Storage;
+use Spatie\Browsershot\Browsershot;
+use Illuminate\Support\Str;
+
+class BrowsershotPdfHelper implements PdfGenerationHelperContract
+{
+    public function generate(array $payload): PdfGenerationResult
+    {
+        $filename = $payload['filename'] ?? '';
+        $data = $payload['data'] ?? '';
+        $view = $payload['view'] ?? '';
+
+        $folder_timestamp = $this->currentReportBucket();
+        $dir = "tmp/reports/{$folder_timestamp}";
+
+        $file_timestamp = Carbon::now()->addMinutes(30)->format('YmdHis');
+        $filename = "{$filename}_{$file_timestamp}.pdf";
+
+        $storage_path = "$dir/$filename";
+        $absolute_path = Storage::path($storage_path); 
+
+        Storage::makeDirectory($dir);
+
+        $html = '';
+        $html .= view($view, $data)->render();
+
+        $content = Browsershot::html($html)
+                        ->waitUntilNetworkIdle()
+                        ->ignoreHttpsErrors()
+                        ->margins(30, 15, 30, 15);
+
+        if (config('pdf.node')) {
+            $content = $content->setNodeBinary(config('pdf.node'));
+        }
+
+        if (config('pdf.npm')) {
+            $content = $content->setNpmBinary(config('pdf.npm'));
+        }
+
+        if (config('pdf.modules')) {
+            $content = $content->setIncludePath(config('pdf.modules'));
+        }
+
+        if (config('pdf.chrome')) {
+            $content = $content->setChromePath(config('pdf.chrome'));
+        }
+
+        if (config('pdf.chrome_arguments')) {
+            $content = $content->addChromiumArguments(config('pdf.chrome_arguments'));
+        }
+
+        $content->timeout(60)
+                ->save($absolute_path);
+
+        return new PdfGenerationResult(
+            success: true,
+            filename: $filename,
+            path: $storage_path,
+            job_id: (string) Str::ulid(),
+        );
+    }
+
+
+    public function currentReportBucket()
+    {
+        $t = Carbon::now()->copy()->second(0);
+
+        $bucket_minute = (int) (floor($t->minute / 30) * 30);
+        $t->minute($bucket_minute);
+
+        return $t->format('Ymd_Hi');
+    }
+
+}

app/Helpers/Contracts/PdfGenerationHelperContract.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace App\Helpers\Contracts;
+
+use App\PdfGenerationResult;
+
+interface PdfGenerationHelperContract {
+
+    public function generate(array $payload): PdfGenerationResult;
+
+}

app/Helpers/LambdaPdfHelper.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Helpers;
+
+use App\Helpers\Contracts\PdfGenerationHelperContract;
+use App\PdfGenerationResult;
+use Illuminate\Support\Str;
+
+class LambdaPdfHelper implements PdfGenerationHelperContract
+{
+    public function generate(array $payload): PdfGenerationResult
+    {
+
+        // Pdf::view('pdf.invoice', $data)
+        //     ->onLambda()
+        //     ->save('invoice.pdf');
+
+        $filename = $payload['filename'] ?? '';
+        $storage_path = $payload['storage_path'] ?? '';
+        $job_id = $payload['job_id'] ?? (string) Str::ulid();
+
+        return new PdfGenerationResult(
+            success: true,
+            filename: $filename,
+            path: $storage_path,
+            job_id: $job_id,
+        );
+    }
+}

app/Http/Controllers/AppController.php

@@ -2,6 +2,7 @@
 
 namespace App\Http\Controllers;
 
+use App\User;
 use Illuminate\Http\Request;
 use Illuminate\Contracts\View\View as ViewContract;
 use Illuminate\View\View;
@@ -23,4 +24,10 @@ public function faq(): View|ViewContract
     {
         return view('faq');
     }
+
+    public function requestDownload(User $user, string $token)
+    {
+        return view('initiate-download', compact('token'));
+    }
+
 }

app/Http/Controllers/Controller.php

@@ -10,4 +10,5 @@
 class Controller extends BaseController
 {
     use AuthorizesRequests, DispatchesJobs, ValidatesRequests;
+
 }

app/Http/Controllers/ProfileStudentsController.php

@@ -4,7 +4,6 @@
 
 use App\Profile;
 use Illuminate\Contracts\View\View as ViewContract;
-use Illuminate\Http\Request;
 use Illuminate\View\View;
 
 class ProfileStudentsController extends Controller

app/Http/Controllers/StudentsController.php

@@ -108,6 +108,7 @@ public function show(Request $request, Student $student): View|ViewContract
             'custom_questions' => StudentData::customQuestions(),
             'languages' => StudentData::$languages,
             'majors' => StudentData::majors(),
+            'user' => $request->user(),
         ]);
     }
 
@@ -122,6 +123,7 @@ public function edit(Student $student): View|ViewContract
             'custom_questions' => StudentData::customQuestions(),
             'languages' => StudentData::$languages,
             'majors' => StudentData::majors(),
+            'user' => auth()->user(),
         ]);
     }
 

app/Http/Kernel.php

@@ -3,6 +3,7 @@
 namespace App\Http;
 
 use Illuminate\Foundation\Http\Kernel as HttpKernel;
+use Illuminate\Routing\Middleware\ValidateSignature;
 
 class Kernel extends HttpKernel
 {
@@ -62,4 +63,8 @@ class Kernel extends HttpKernel
         'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
         // 'cors'  => \App\Http\Middleware\Cors::class,
     ];
+
+    protected $routeMiddleware = [
+        'signed' => ValidateSignature::class,
+    ];
 }

app/Http/Livewire/Concerns/HasFilters.php

@@ -2,6 +2,9 @@
 
 namespace App\Http\Livewire\Concerns;
 
+use App\StudentData;
+use Illuminate\Support\Collection;
+
 trait HasFilters
 {
     public function resetFilters()
@@ -23,6 +26,13 @@ protected function emitFilterUpdatedEvent($name, $value)
         }
     }
 
+    public function getSelectedFilters()
+    {
+        return collect($this->only($this->availableFilters()))
+                                        ->filter(fn($value) => filled(trim($value)))
+                                        ->all();
+    }
+
     protected function availableFilters(): array
     {
         return array_filter(array_keys(get_class_vars(self::class)), function ($property_name) {
@@ -35,4 +45,5 @@ protected function isAFilter($name)
         // Any property with a name including "_filter"
         return strpos($name, '_filter') !== false;
     }
+
 }

app/Http/Livewire/Concerns/HasPdfDownloads.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Http\Livewire\Concerns;
+
+use App\Jobs\ProcessPdfJob;
+use Illuminate\Support\Facades\Cache;
+use Illuminate\Support\Facades\URL;
+use Illuminate\Support\Str;
+
+trait HasPdfDownloads
+{
+    public function initiatePdfDownload($view, $data, $filename, $file_description = '')
+    {
+        if (!$data) { return false; }
+
+        $user = auth()->user();
+        $token = (string) Str::ulid();
+
+        $this->cachePdfToken($user, $token);
+
+        $download_request_url = URL::temporarySignedRoute('pdf.requestDownload', now()->addMinutes(10), ['user' => $user, 'token' => $token]);
+
+        ProcessPdfJob::dispatch($user, $view, $filename, $file_description, $token, $data);
+
+        $this->dispatchBrowserEvent('initiatePdfDownload', ['download_request_url' => $download_request_url]);
+    }
+
+    protected function cachePdfToken($user, $token) {
+        $user_tokens = Cache::get("pdf:tokens:{$user->pea}", collect());
+        $user_tokens->push($token);
+
+        Cache::put("pdf:tokens:{$user->pea}", $user_tokens, now()->addMinutes(30));
+    }
+
+}