feat: Add Laravel DomPDF integration for PDF generation, enhance consulting report features with AI-generated insights, and improve user experience with new tour functionalities in the dashboard.

Author: RabbitVisual

.env.production.example

@@ -0,0 +1,146 @@
+# =============================================================================
+# VERTEX CONTAS - Template para produção (sem credenciais reais)
+# =============================================================================
+# No servidor: copie para .env, preencha os valores e execute php artisan key:generate
+# Nunca commite o .env com senhas ou chaves reais.
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# APLICAÇÃO
+# -----------------------------------------------------------------------------
+APP_NAME="Vertex Contas"
+APP_ENV=production
+APP_KEY=
+# Gere no servidor: php artisan key:generate
+
+APP_DEBUG=false
+APP_URL=https://seu-dominio.com.br
+
+APP_LOCALE=pt-BR
+APP_FALLBACK_LOCALE=pt-BR
+APP_FAKER_LOCALE=pt_BR
+APP_TIMEZONE=America/Sao_Paulo
+
+APP_MAINTENANCE_DRIVER=file
+
+BCRYPT_ROUNDS=12
+
+# -----------------------------------------------------------------------------
+# LOG
+# -----------------------------------------------------------------------------
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=error
+LOG_DAILY_DAYS=14
+
+# -----------------------------------------------------------------------------
+# BANCO DE DADOS - Preencher no servidor
+# -----------------------------------------------------------------------------
+DB_CONNECTION=mysql
+DB_HOST=localhost
+DB_PORT=3306
+DB_DATABASE=
+DB_USERNAME=
+DB_PASSWORD=
+DB_CHARSET=utf8mb4
+DB_COLLATION=utf8mb4_unicode_ci
+
+# -----------------------------------------------------------------------------
+# SESSÃO
+# -----------------------------------------------------------------------------
+SESSION_DRIVER=database
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=true
+SESSION_PATH=/
+SESSION_DOMAIN=null
+SESSION_SECURE_COOKIE=true
+SESSION_SAME_SITE=lax
+SESSION_HTTP_ONLY=true
+
+# -----------------------------------------------------------------------------
+# CACHE
+# -----------------------------------------------------------------------------
+CACHE_STORE=file
+CACHE_PREFIX=vertex-contas-cache-
+
+# -----------------------------------------------------------------------------
+# ARQUIVOS
+# -----------------------------------------------------------------------------
+FILESYSTEM_DISK=local
+
+# -----------------------------------------------------------------------------
+# FILA (database + cron a cada minuto para envio de e-mails)
+# -----------------------------------------------------------------------------
+QUEUE_CONNECTION=database
+
+# -----------------------------------------------------------------------------
+# BROADCAST (Vertex Chat VIP - opcional)
+# -----------------------------------------------------------------------------
+BROADCAST_CONNECTION=log
+# BROADCAST_CONNECTION=pusher
+
+# PUSHER_APP_ID=
+# PUSHER_APP_KEY=
+# PUSHER_APP_SECRET=
+# PUSHER_APP_CLUSTER=sa1
+
+# -----------------------------------------------------------------------------
+# E-MAIL - SMTP - Preencher no servidor
+# -----------------------------------------------------------------------------
+MAIL_MAILER=smtp
+MAIL_HOST=
+MAIL_PORT=465
+MAIL_USERNAME=
+MAIL_PASSWORD=
+MAIL_ENCRYPTION=ssl
+MAIL_FROM_ADDRESS=
+MAIL_FROM_NAME="${APP_NAME}"
+
+# -----------------------------------------------------------------------------
+# REDIS (opcional)
+# -----------------------------------------------------------------------------
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+# -----------------------------------------------------------------------------
+# MEMCACHED (opcional)
+# -----------------------------------------------------------------------------
+MEMCACHED_HOST=127.0.0.1
+MEMCACHED_PORT=11211
+
+# -----------------------------------------------------------------------------
+# AWS S3 (opcional)
+# -----------------------------------------------------------------------------
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+# -----------------------------------------------------------------------------
+# VITE / FRONTEND
+# -----------------------------------------------------------------------------
+VITE_APP_NAME="${APP_NAME}"
+
+# -----------------------------------------------------------------------------
+# reCAPTCHA v3 (Admin > Configurações > Segurança)
+# -----------------------------------------------------------------------------
+# RECAPTCHA_SITE_KEY=
+# RECAPTCHA_SECRET_KEY=
+
+# -----------------------------------------------------------------------------
+# Google Gemini (Vertex Bot - Admin > Configurações > IA)
+# -----------------------------------------------------------------------------
+# GEMINI_API_KEY=
+
+# -----------------------------------------------------------------------------
+# PAGAMENTOS - Preencher no servidor ou configurar no Admin (Gateways)
+# -----------------------------------------------------------------------------
+# STRIPE_KEY=
+# STRIPE_SECRET=
+# STRIPE_WEBHOOK_SECRET=
+# MERCADOPAGO_PUBLIC_KEY=
+# MERCADOPAGO_ACCESS_TOKEN=

Config.md

@@ -1,41 +1,92 @@
-@.cursorrules
-@Modules/Gamification
-@Modules/Core/Services/FinancialHealthService.php
-@Modules/Core/app/Services/SettingService.php
-@Modules/Gamification/resources/views/components/vertex-bot.blade.php
+### 1. O "Segredo" Técnico: Headless Chrome
+
+Empresas profissionais usam ferramentas que rodam um "navegador escondido" (Chromium) no servidor. Ele renderiza o HTML exatamente como você desenhou e o transforma em PDF antes de enviar para o usuário.
+
+**A Recomendação de Ouro:** Use o pacote **[Spatie Browsershot]()**.
+
+* Ele usa o Puppeteer (Node.js) para controlar o Chrome.
+* É o que há de mais moderno: aceita Tailwind CSS v4, JavaScript, Gráficos (ApexCharts/Chart.js) e alinhamentos perfeitos.
+
+### 2. O Segredo do Design: CSS de Impressão (@page)
+
+Para o PDF não sair cortado e respeitar a folha A4, você precisa definir regras específicas de CSS que o navegador de renderização vai seguir:
+
+```css
+@media print {
+    @page {
+        size: A4;
+        margin: 1cm; /* Margens de segurança */
+    }
+    
+    /* Evita que um card ou linha de tabela seja cortada no meio entre duas páginas */
+    .no-break {
+        break-inside: avoid;
+    }
+
+    /* Força o fundo das cores (Tailwind precisa disso no PDF) */
+    * {
+        -webkit-print-color-adjust: exact !important;
+        print-color-adjust: exact !important;
+    }
+}
+
+/* Container fixo para simular o A4 no desenvolvimento */
+.a4-container {
+    width: 210mm;
+    min-height: 297mm;
+    margin: auto;
+}
+
+```
+
+### 3. Anatomia de uma Invoice Profissional (Estilo Stripe)
 
-**Role:** Senior AI Engineer & UX Master.
-**Goal:** Replace the static insight system with the Google Gemini AI API to provide real-time, hyper-personalized financial coaching. Also, upgrade the Bot's visual design to a Premium "Fintech Elite" style.
+Para não parecer um "emaranhado de coisas", o layout deve seguir esta hierarquia:
+
+1. **Header:** Logo à esquerda (em alta resolução ou SVG) e Status (Ex: PAGO em verde) à direita.
+2. **Meta Dados:** Número do relatório, Data e Cliente em blocos de 3 colunas.
+3. **Tabela de Itens:** Fundo branco, linhas alternadas (zebra) em cinza ultra claro, bordas apenas horizontais.
+4. **Resumo Financeiro:** Alinhado à direita no rodapé, com o Total em negrito e fonte maior.
+5. **Rodapé Legal:** Termos e identificação da Vertex Solutions em fonte pequena (8pt).
 
 ---
 
-### Phase 1: Gemini AI Integration (The New Brain)
-1. **API Setup:** Configure o cliente Guzzle para conectar à API do Google Gemini (utilize uma chave `GEMINI_API_KEY` no `.env`).
-2. **Context Provider:** No `GamificationService`, crie um método que gera um "Prompt Contextual":
-    * Inclua: Percentuais 50/30/20 reais, Score Financeiro, e títulos dos últimos 3 posts do Blog.
-    * **Segurança LGPD:** Use os helpers existentes para NUNCA enviar nomes reais ou CPFs para a API. Envie apenas métricas e números.
-3. **Logic:** Se a API falhar ou estiver sem internet, o sistema deve fazer fallback AUTOMÁTICO para as dicas locais da `insights_bank`.
-
-### Phase 2: High-End UI Redesign (Visual Iron Man)
-1. **Component Update:** Refatore o `vertex-bot.blade.php`.
-    * **Visual:** O balão deve ser maior, com `backdrop-blur-xl`, bordas arredondadas suaves e tipografia Inter 14px.
-    * **Animations:** Use Tailwind v4 para criar uma entrada "Spring" (suave). Adicione um efeito de "pulsação de luz" no robô quando ele estiver "analisando dados".
-2. **Readability:** Garanta que o texto tenha contraste alto (Texto branco em fundo Slate-950/80).
-
-### Phase 3: Strategic Behavior (Anti-Irritation)
-1. **Cooldown:** Implemente uma trava. O robô só aparece:
-    * No primeiro login do dia.
-    * OU se o usuário realizar uma transação que mude drasticamente um pilar do 50/30/20.
-2. **Typewriter Effect:** Adicione um efeito de "digitando" no balão para simular a resposta da IA em tempo real.
+### 🚀 Prompt Cursor: Criar Relatório PDF de Elite (Estilo Business Statement)
+
+Para que o Cursor implemente isso para você, use este prompt detalhado:
+
+```markdown
+@.cursorrules
+@Modules/Core/app/Services/ReportService.php
+@Modules/Core/resources/views/documents/
+
+**Role:** Senior UI/UX Engineer & PDF Specialist.
+**Goal:** Create a world-class professional PDF template for "Consultoria PRO" and "Extratos". The design must follow the "Fintech Elite" style (Stripe/PayPal) and be optimized for A4 printing.
 
 ---
 
-### Phase 4: Pro-Only Features
-1. **Diferenciação:** Para usuários FREE, o Gemini dá dicas curtas. Para usuários PRO, o Gemini faz uma análise profunda cruzando os gastos com os artigos do Blog.
+### Phase 1: Engine Setup (Information)
+1. Verifique se o sistema pode usar `Spatie/Browsershot` ou `Laravel-Snappy` para renderização via servidor. Se não for possível no ambiente atual, utilize `DomPDF` com configurações estritas de A4.
 
-**Technical Constraints:**
-* Use FontAwesome 7.1 Pro Duotone.
-* Mantenha o processamento assíncrono para não travar o carregamento da página.
-* O robô deve sempre se identificar como "Vertex Bot - Seu Mentor de Elite".
+### Phase 2: Professional CSS Blueprint
+1. Crie um arquivo `resources/css/pdf-pro.css` ou injete no Blade:
+    * Defina `@page { size: A4; margin: 1.5cm; }`.
+    * Use a fonte 'Inter' ou 'Helvetica'.
+    * Implemente classes `.break-before` e `.avoid-break`.
+    * Garanta que as cores de fundo (bg-slate-50, etc.) sejam forçadas na impressão.
 
-**Execute Phase 1 (Gemini Connection) and Phase 2 (New Design) first.**
+### Phase 3: High-End Layout Structure
+1. **Header:** Use a logo da Vertex via base64 para garantir o carregamento. Adicione o título do documento e a data de emissão em um grid elegante.
+2. **Typography:** O tamanho da fonte principal deve ser 10pt (padrão financeiro). Títulos em 14pt.
+3. **Tables:** Refatore as tabelas para terem padding generoso, bordas finas (#e2e8f0) e alinhamento decimal para valores monetários.
+4. **AI Conclusion:** A seção de "Conclusão Estratégica" deve vir em um box com borda lateral azul (indigo-600) para destacar a consultoria.
+
+### Phase 4: Implementation
+1. Refatore a view `consulting-report.blade.php` para seguir este novo padrão "Business Statement".
+2. Remova elementos desnecessários (botões, menus de navegação) da versão de impressão.
+
+---
+
+**Technical Constraints:**
+* O PDF deve ser gerado via servidor, não pelo `window.print()` do usuário.
+* Garanta que o layout não "quebre" em relatórios com mais de 2 páginas.

Modules/Blog/database/seeders/BlogPostPremiumSeeder.php

@@ -25,9 +25,9 @@ class BlogPostPremiumSeeder extends Seeder
      */
     public function run(): void
     {
-        $author = User::where('email', 'admin@vertexcontas.com')->first();
+        $author = User::role('admin')->first();
         if (! $author) {
-            $this->command->warn('Admin user not found. Run DatabaseSeeder first.');
+            $this->command->warn('Admin user not found. Run DatabaseSeeder (RolesAndPermissions + AdminUserSeeder) first.');
             return;
         }
 

Modules/Blog/database/seeders/BlogPostSeeder.php

@@ -23,9 +23,9 @@ class BlogPostSeeder extends Seeder
      */
     public function run(): void
     {
-        $author = User::where('email', 'admin@vertexcontas.com')->first();
+        $author = User::role('admin')->first();
         if (! $author) {
-            $this->command->warn('Admin user not found. Run DatabaseSeeder first.');
+            $this->command->warn('Admin user not found. Run DatabaseSeeder (RolesAndPermissions + AdminUserSeeder) first.');
             return;
         }
 

Modules/Blog/resources/views/show.blade.php

@@ -31,7 +31,7 @@
                                             <x-icon name="crown" class="w-8 h-8 text-white" />
                                         </div>
                                         <h2 class="text-2xl font-bold text-gray-900 dark:text-white mb-2">Conteúdo Exclusivo PRO</h2>
-                                        <p class="text-gray-600 dark:text-gray-300 mb-6">Este artigo contém estratégias avançadas reservadas para assinantes Vertex PRO.</p>
+                                        <p class="text-gray-600 dark:text-gray-300 mb-6">Este artigo contém estratégias avançadas reservadas para assinantes {{ plan_pro_name() }}.</p>
                                         <a href="{{ route('paneluser.subscription.index') }}" class="inline-block w-full bg-indigo-600 hover:bg-indigo-700 text-white font-bold py-3 px-6 rounded-lg transition-colors shadow-lg hover:shadow-xl transform hover:-translate-y-0.5">
                                             Desbloquear Acesso Agora
                                         </a>

Modules/Core/app/Http/Controllers/CategoryController.php

@@ -33,7 +33,7 @@ public function create()
         $user = auth()->user();
         if (! $this->limitService->canCreate($user, 'category')) {
             return redirect()->route('core.categories.index')
-                ->with('error', $this->limitService->getLimitReachedMessage('category'));
+                ->with('error', $this->limitService->getLimitReachedMessage($user, 'category'));
         }
 
         return view('core::categories.create');
@@ -44,7 +44,7 @@ public function store(StoreCategoryRequest $request)
         $user = auth()->user();
         if (! $this->limitService->canCreate($user, 'category')) {
             return redirect()->route('core.categories.index')
-                ->with('error', $this->limitService->getLimitReachedMessage('category'));
+                ->with('error', $this->limitService->getLimitReachedMessage($user, 'category'));
         }
 
         $typeGroup = $request->type === 'expense' ? ($request->type_group ?? 'lifestyle') : null;

Modules/Core/app/Http/Controllers/CoreController.php

@@ -18,19 +18,23 @@
 use Modules\Core\Services\FinancialHealthService;
 use Modules\Core\Services\InspectionGuard;
 use Modules\Core\Services\SubscriptionLimitService;
+use Modules\Core\Services\TemplateDocumentService;
 
 class CoreController extends Controller
 {
     protected SubscriptionLimitService $limitService;
 
     protected FinancialHealthService $financialHealthService;
 
-    public function __construct(SubscriptionLimitService $limitService, FinancialHealthService $financialHealthService)
+    protected TemplateDocumentService $templateService;
+
+    public function __construct(SubscriptionLimitService $limitService, FinancialHealthService $financialHealthService, TemplateDocumentService $templateService)
     {
         $this->middleware(['auth', 'verified']);
         $this->middleware('permission:core.view');
         $this->limitService = $limitService;
         $this->financialHealthService = $financialHealthService;
+        $this->templateService = $templateService;
     }
 
     /**
@@ -135,6 +139,7 @@ public function dashboard()
 
         // Projection data for Vertex AI card (PRO)
         $projectionData = $this->financialHealthService->getProjectionData($user);
+        $aiReportUsage = $user->isPro() ? $this->templateService->getAiReportUsage($user) : null;
 
         return view('core::dashboard', compact(
             'accounts',
@@ -152,7 +157,8 @@ public function dashboard()
             'recentTransactions',
             'monthlyCapacity',
             'incomeBreakdown',
-            'projectionData'
+            'projectionData',
+            'aiReportUsage'
         ));
     }