feat: Integrate Pusher for real-time chat functionality in Vertex Chat module, enhance environment configuration for broadcasting, and implement Google reCAPTCHA for improved security during user authentication.

Author: RabbitVisual

.env.example

@@ -34,6 +34,13 @@ SESSION_PATH=/
 SESSION_DOMAIN=null
 
 BROADCAST_CONNECTION=log
+# BROADCAST_CONNECTION=pusher # Use for Vertex Chat VIP real-time
+
+# Pusher (Vertex Chat VIP - set when using real-time)
+# PUSHER_APP_ID=
+# PUSHER_APP_KEY=
+# PUSHER_APP_SECRET=
+# PUSHER_APP_CLUSTER=mt1
 FILESYSTEM_DISK=local
 QUEUE_CONNECTION=sync
 
@@ -70,5 +77,9 @@ VITE_APP_NAME="${APP_NAME}"
 # TELESCOPE_ENABLED=false
 # PULSE_ENABLED=false
 
+# Google reCAPTCHA v3 (Admin > Configurações > Segurança - grátis em https://www.google.com/recaptcha/admin)
+# RECAPTCHA_SITE_KEY=
+# RECAPTCHA_SECRET_KEY=
+
 # Jules AI (Keep empty in example, set in .env or GitHub Secrets)
 JULES_API_KEY=

.env.testing

@@ -34,6 +34,7 @@ SESSION_PATH=/
 SESSION_DOMAIN=null
 
 BROADCAST_CONNECTION=log
+# PUSHER_APP_ID= PUSHER_APP_KEY= PUSHER_APP_SECRET= PUSHER_APP_CLUSTER=mt1 # Vertex Chat VIP
 FILESYSTEM_DISK=local
 QUEUE_CONNECTION=sync
 

AUDITORIA_PRODUCAO.md

@@ -10,6 +10,7 @@ class Inspection extends Model
 {
     protected $fillable = [
         'ticket_id',
+        'conversation_id',
         'agent_id',
         'user_id',
         'status',
@@ -30,6 +31,11 @@ public function ticket(): BelongsTo
         return $this->belongsTo(Ticket::class);
     }
 
+    public function conversation(): BelongsTo
+    {
+        return $this->belongsTo(\Modules\VertexChat\Models\Conversation::class);
+    }
+
     public function agent(): BelongsTo
     {
         return $this->belongsTo(User::class, 'agent_id');

Modules/Core/app/Models/Inspection.php

@@ -2,6 +2,7 @@
 
 namespace Modules\Core\Providers;
 
+use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\Blade;
 use Illuminate\Support\Facades\View;
 use Illuminate\Support\ServiceProvider;
@@ -49,13 +50,27 @@ public function boot(): void
         // Share inspection sync flag: real user has active inspection (not agent) → enable real-time URL sync
         View::composer(['paneluser::components.layouts.master', 'paneluser::layouts.master'], function ($view) {
             $syncActive = false;
-            if (auth()->check() && !session('original_agent_id')) {
-                $syncActive = \Modules\Core\Models\Inspection::where('user_id', auth()->id())
+            if (Auth::check() && !session('original_agent_id')) {
+                $syncActive = \Modules\Core\Models\Inspection::where('user_id', Auth::id())
                     ->where('status', 'active')
                     ->exists();
             }
             $view->with('inspectionSyncActive', $syncActive);
         });
+
+        // Share branding variables for logo, favicon and panel names across all relevant views
+        View::composer([
+            'paneladmin::*',
+            'paneluser::*',
+            'panelsuporte::*',
+            'homepage::*',
+            'core::*',
+            'errors.*',
+        ], function ($view) {
+            $view->with('brandingLogoUrl', fn (string $context = 'default', bool $dark = false) => branding_logo_url($context, $dark));
+            $view->with('brandingFaviconUrl', branding_favicon_url());
+            $view->with('brandingPanelName', fn (string $panel) => branding_panel_name($panel));
+        });
     }
 
     /**
@@ -97,6 +112,26 @@ protected function overrideConfigsFromDatabase(): void
                 'mail.from.address' => $settings->get('mail_from_address', env('MAIL_FROM_ADDRESS', 'hello@example.com')),
                 'mail.from.name' => $settings->get('mail_from_name', env('MAIL_FROM_NAME', env('APP_NAME', 'Vertex Contas'))),
             ]);
+
+            // Override Pusher/broadcasting configs (prioridade: DB > .env)
+            $broadcastConn = $settings->get('broadcast_connection') ?? env('BROADCAST_CONNECTION', 'log');
+            config(['broadcasting.default' => $broadcastConn]);
+
+            $pusherAppId = $settings->get('pusher_app_id') ?? env('PUSHER_APP_ID');
+            if ($pusherAppId) {
+                config([
+                    'broadcasting.connections.pusher.key' => $settings->get('pusher_app_key', env('PUSHER_APP_KEY')),
+                    'broadcasting.connections.pusher.secret' => $settings->get('pusher_app_secret', env('PUSHER_APP_SECRET')),
+                    'broadcasting.connections.pusher.app_id' => $pusherAppId,
+                    'broadcasting.connections.pusher.options.cluster' => $settings->get('pusher_app_cluster', env('PUSHER_APP_CLUSTER', 'mt1')),
+                ]);
+            }
+
+            // Override session lifetime from security settings
+            $sessionLifetime = (int) $settings->get('session_lifetime', config('session.lifetime', 120));
+            if ($sessionLifetime > 0) {
+                config(['session.lifetime' => $sessionLifetime]);
+            }
         } catch (\Exception $e) {
             // Silently fail if database is not ready (e.g., during migrations)
             \Illuminate\Support\Facades\Log::debug('Settings override skipped: ' . $e->getMessage());

Modules/Core/app/Providers/CoreServiceProvider.php

@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Core\Services;
+
+use Illuminate\Support\Facades\Http;
+
+class RecaptchaService
+{
+    protected const VERIFY_URL = 'https://www.google.com/recaptcha/api/siteverify';
+
+    public function __construct(
+        protected SettingService $settingService
+    ) {}
+
+    public function isEnabled(): bool
+    {
+        return (bool) $this->settingService->get('recaptcha_enabled', false);
+    }
+
+    public function getSiteKey(): ?string
+    {
+        $key = $this->settingService->get('recaptcha_site_key');
+
+        return $key ? (string) $key : null;
+    }
+
+    public function verify(string $token, ?string $action = 'login'): bool
+    {
+        $secret = $this->settingService->get('recaptcha_secret_key');
+        if (! $secret) {
+            return false;
+        }
+
+        $response = Http::asForm()->post(self::VERIFY_URL, [
+            'secret' => $secret,
+            'response' => $token,
+        ]);
+
+        if (! $response->successful()) {
+            return false;
+        }
+
+        $data = $response->json();
+        if (! ($data['success'] ?? false)) {
+            return false;
+        }
+
+        $minScore = (float) ($this->settingService->get('recaptcha_min_score', 0.5));
+        $score = (float) ($data['score'] ?? 0);
+
+        return $score >= $minScore;
+    }
+}

Modules/Core/app/Services/RecaptchaService.php

@@ -81,17 +81,18 @@ public function getTemplateData(): array
     {
         $settings = $this->settingService->getByGroup('document_templates');
         $general = $this->settingService->getByGroup('general');
-        $branding = $this->settingService->getByGroup('branding');
+
+        $companyName = $settings->get('company_name') ?? $general->get('app_name') ?? config('app.name', 'Vertex Contas');
 
         return [
-            'company_name' => $settings->get('company_name') ?? $general->get('app_name') ?? 'Vertex Contas',
+            'company_name' => $companyName,
             'company_address' => $settings->get('company_address') ?? '',
             'company_cnpj' => $settings->get('company_cnpj') ?? '',
             'company_phone' => $settings->get('company_phone') ?? '',
             'company_email' => $settings->get('company_email') ?? '',
-            'document_footer_text' => $settings->get('document_footer_text') ?? 'Vertex Contas - Sistema de Gestão Financeira',
+            'document_footer_text' => $settings->get('document_footer_text') ?? $companyName . ' - Sistema de Gestão Financeira',
             'app_url' => $general->get('app_url') ?? config('app.url'),
-            'logo_path' => $branding->get('app_logo') ? asset($branding->get('app_logo')) : asset('storage/logos/logo.svg'),
+            'logo_path' => branding_logo_url('default', false),
         ];
     }
 

Modules/Core/app/Services/TemplateDocumentService.php

@@ -0,0 +1,32 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     * Makes inspections support Ticket OR Chat flow.
+     */
+    public function up(): void
+    {
+        Schema::table('inspections', function (Blueprint $table) {
+            $table->foreignId('ticket_id')->nullable()->change();
+            $table->foreignId('conversation_id')->nullable()->after('ticket_id')
+                ->constrained('vertex_chat_conversations')->onDelete('cascade');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('inspections', function (Blueprint $table) {
+            $table->dropForeign(['conversation_id']);
+            $table->foreignId('ticket_id')->nullable(false)->change();
+        });
+    }
+};