feat: Add LGPD helpers for data normalization and enhance financial formatting across various components, improving data privacy and user experience.

Author: RabbitVisual

GloablsSystem.md

@@ -240,12 +240,75 @@ Basta adicionar a diretiva `x-mask` com o nome da máscara desejada. O sistema c
 | `'date'`    | DD/MM/AAAA                        | 25/12/2025         |
 
 ### Melhores Práticas (Backend)
-Lembre-se que as máscaras enviam os caracteres especiais (pontos, traços). Sempre **limpe os dados** no backend antes de salvar no banco ou validar.
+Lembre-se que as máscaras enviam os caracteres especiais (pontos, traços). Use os helpers `lgpd_clean_*` para normalizar dados antes de salvar no banco ou validar.
 
 **Exemplo no Laravel (Request ou Controller):**
 ```php
-// Remover tudo que não for dígito
-$cpfClean = preg_replace('/\D/', '', $request->cpf);
-// Salvar: 12345678900
+$request->merge([
+    'cpf' => lgpd_clean_cpf($request->cpf ?? null) ?: null,
+    'phone' => lgpd_clean_phone($request->phone ?? null) ?: null,
+]);
+// Salvar: 12345678900 (apenas dígitos)
+```
+
+---
+
+## 6. Helpers LGPD e Formatação
+
+O sistema possui helpers globais para proteção LGPD e formatação consistente de valores financeiros e dados sensíveis.
+
+### 6.1 LgpdHelper (Segurança LGPD)
+
+Protege dados pessoais conforme LGPD. Use em exibição, logs e contextos de suporte.
+
+| Função | Uso |
+|--------|-----|
+| `lgpd_mask_cpf($cpf)` | Exibe `***.***.***-00` em contextos de terceiros |
+| `lgpd_format_cpf($cpf)` | Formata `123.456.789-00` para perfil próprio |
+| `lgpd_mask_cnpj($cnpj)` | Mascara CNPJ em documentos de terceiros |
+| `lgpd_format_cnpj($cnpj)` | Formata CNPJ para exibição legível |
+| `lgpd_mask_phone($phone)` | Exibe `(11) *****-7777` |
+| `lgpd_format_phone($phone)` | Formata `(11) 98888-7777` |
+| `lgpd_clean_cpf($value)` | Remove não-dígitos (antes de salvar) |
+| `lgpd_clean_cnpj($value)` | Remove não-dígitos |
+| `lgpd_clean_phone($value)` | Remove não-dígitos |
+
+**Política:** Em suporte/inspeção visualizando usuário terceiro → **sempre mask**. Em perfil próprio ou documento da empresa → **format**.
+
+### 6.2 FormatHelper (Moeda, Porcentagem)
+
+| Função | Uso |
+|--------|-----|
+| `format_currency($value)` | `R$ 1.500,50` (respeita InspectionGuard) |
+| `format_percent($value, $decimals)` | `15,5%` |
+| `format_number($value, $decimals)` | `1.500,50` (padrão BRL) |
+
+### 6.3 Máscaras de Input (x-mask) - Autoformatação na Digitação
+
+Campos com `x-mask` formatam automaticamente enquanto o usuário digita:
+
+| Campo      | Máscara   | Onde está aplicado                                              |
+|-----------|-----------|------------------------------------------------------------------|
+| CPF       | `x-mask="'cpf'"`  | Login, Cadastro, Perfil Suporte (edição)                        |
+| CNPJ      | `x-mask="'cnpj'"` | Configurações Admin (documentos)                                |
+| Telefone  | `x-mask="'phone'"`| Cadastro, Perfis (PanelUser, Admin, Suporte), Usuários Suporte  |
+| Data      | `x-mask="'date'"` | Cadastro, Perfis, Usuários Suporte (DD/MM/AAAA)                 |
+| Moeda     | `x-mask="'money'"`| Minha Renda, Onboarding, Transações (formatCurrency)            |
+
+**Componente reutilizável:** `<x-masked-input mask="cpf" name="cpf" />` (em `resources/views/components/masked-input.blade.php`)
+
+### 6.4 Helpers de parsing (backend)
+
+```php
+parse_brl_money($request->amount);  // "R$ 1.500,50" -> 1500.50
+parse_brl_date($request->birth_date); // "25/12/2025" -> "2025-12-25"
+```
+
+### 6.5 Exemplos de exibição
+
+```blade
+{{ format_currency($invoice->amount) }}
+{{ format_percent($budget->usage_percentage, 1) }}
+{{ lgpd_mask_cpf($ticket->user->cpf) }}
+{{ lgpd_format_phone($user->phone) }}
 ```
-Isso garante integridade dos dados e facilita buscas futuras.

Modules/Core/app/Console/Commands/ProcessRecurringTransactions.php

@@ -54,7 +54,7 @@ public function handle(): int
                 $this->line(sprintf(
                     'Processed: %s - R$ %s for user %s',
                     $recurring->description,
-                    number_format($recurring->amount, 2, ',', '.'),
+                    format_number($recurring->amount, 2),
                     $recurring->user->name
                 ));
 

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

@@ -62,7 +62,7 @@ public function index()
         if ($activeSubscription && $activeSubscription->current_period_end) {
             $nextDue = $activeSubscription->current_period_end;
             $nextDueLabel = $nextDue->format('d/m/Y');
-            $amount = number_format((float) $activeSubscription->amount, 2, ',', '.');
+            $amount = format_number((float) $activeSubscription->amount, 2);
             $nextDueSubtext = "Próxima cobrança de R$ {$amount} será debitada nesta data. Assinatura mensal recorrente.";
         } else {
             // Fallback: último pagamento + 1 mês

Modules/Core/app/Models/LegalDocument.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Core\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+class LegalDocument extends Model
+{
+    protected $fillable = [
+        'slug',
+        'title',
+        'content',
+        'version',
+        'is_active',
+        'requires_acceptance',
+    ];
+
+    protected $casts = [
+        'is_active' => 'boolean',
+        'requires_acceptance' => 'boolean',
+    ];
+
+    public function acceptances()
+    {
+        return $this->hasMany(UserLegalAcceptance::class);
+    }
+
+    public function scopeActive($query)
+    {
+        return $query->where('is_active', true);
+    }
+
+    public function scopeRequiresAcceptance($query)
+    {
+        return $query->where('requires_acceptance', true);
+    }
+
+    public static function getBySlug(string $slug): ?self
+    {
+        return self::where('slug', $slug)->first();
+    }
+}

Modules/Core/app/Models/UserLegalAcceptance.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Core\Models;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Model;
+
+class UserLegalAcceptance extends Model
+{
+    protected $fillable = [
+        'user_id',
+        'legal_document_id',
+        'version',
+        'accepted_at',
+        'ip_address',
+    ];
+
+    protected $casts = [
+        'accepted_at' => 'datetime',
+    ];
+
+    public function user()
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    public function legalDocument()
+    {
+        return $this->belongsTo(LegalDocument::class);
+    }
+}

Modules/Core/app/Services/ReportService.php

@@ -377,7 +377,7 @@ public function exportCashFlowToCsv(Collection $cashFlow, string $filename, stri
             $totalIncome = $cashFlow->sum('income');
             $totalExpense = $cashFlow->sum('expense');
             $totalBalance = $cashFlow->sum('balance');
-            $totalsRow = ['TOTAL', 'R$ ' . number_format($totalIncome, 2, ',', '.'), 'R$ ' . number_format($totalExpense, 2, ',', '.'), 'R$ ' . number_format($totalBalance, 2, ',', '.')];
+            $totalsRow = ['TOTAL', format_currency($totalIncome, 'R$', false), format_currency($totalExpense, 'R$', false), format_currency($totalBalance, 'R$', false)];
         }
 
         return $this->exportToCsv($cashFlow, $filename, $headerBlock, $totalsRow);
@@ -561,13 +561,13 @@ public function exportCategoryRankingToCsv(Collection $ranking, string $filename
         $rows = $ranking->map(fn ($item) => [
             'Categoria' => $item['category'],
             'Transações' => $item['count'],
-            'Total' => 'R$ ' . number_format($item['total'], 2, ',', '.'),
+            'Total' => format_currency($item['total'], 'R$', false),
         ]);
 
         $totalsRow = null;
         if ($ranking->isNotEmpty()) {
             $total = $ranking->sum('total');
-            $totalsRow = ['TOTAL', $ranking->sum('count'), 'R$ ' . number_format($total, 2, ',', '.')];
+            $totalsRow = ['TOTAL', $ranking->sum('count'), format_currency($total, 'R$', false)];
         }
 
         return $this->exportToCsv($rows, $filename, $headerBlock, $totalsRow);
@@ -591,14 +591,14 @@ public function exportBankStatementToCsv(Collection $statement, string $filename
                 'Descrição' => $item['transaction']->description ?? '—',
                 'Categoria' => $item['transaction']->category?->name ?? '—',
                 'Conta' => $item['transaction']->account?->name ?? '—',
-                'Crédito' => 'R$ ' . number_format($item['credit'], 2, ',', '.'),
-                'Débito' => 'R$ ' . number_format($item['debit'], 2, ',', '.'),
-                'Saldo' => 'R$ ' . number_format($item['balance'], 2, ',', '.'),
+                'Crédito' => format_currency($item['credit'], 'R$', false),
+                'Débito' => format_currency($item['debit'], 'R$', false),
+                'Saldo' => format_currency($item['balance'], 'R$', false),
             ];
         });
 
         $totals = $this->getBankStatementTotals($statement);
-        $totalsRow = ['TOTAL', '', '', '', 'R$ ' . number_format($totals['total_credit'], 2, ',', '.'), 'R$ ' . number_format($totals['total_debit'], 2, ',', '.'), 'R$ ' . number_format($totals['final_balance'], 2, ',', '.')];
+        $totalsRow = ['TOTAL', '', '', '', format_currency($totals['total_credit'], 'R$', false), format_currency($totals['total_debit'], 'R$', false), format_currency($totals['final_balance'], 'R$', false)];
 
         return $this->exportToCsv($rows, $filename, $headerBlock, $totalsRow);
     }

Modules/Core/database/migrations/2026_02_15_140000_create_legal_documents_table.php

@@ -0,0 +1,34 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('legal_documents', function (Blueprint $table) {
+            $table->id();
+            $table->string('slug')->unique();
+            $table->string('title');
+            $table->longText('content');
+            $table->string('version');
+            $table->boolean('is_active')->default(true);
+            $table->boolean('requires_acceptance')->default(false);
+            $table->timestamps();
+            $table->index('is_active');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('legal_documents');
+    }
+};

Modules/Core/database/migrations/2026_02_15_140001_create_user_legal_acceptances_table.php

@@ -0,0 +1,36 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('user_legal_acceptances', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('user_id')->constrained()->onDelete('cascade');
+            $table->foreignId('legal_document_id')->constrained('legal_documents')->onDelete('cascade');
+            $table->string('version');
+            $table->timestamp('accepted_at');
+            $table->string('ip_address', 45)->nullable();
+            $table->timestamps();
+        });
+
+        Schema::table('user_legal_acceptances', function (Blueprint $table) {
+            $table->unique(['user_id', 'legal_document_id']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('user_legal_acceptances');
+    }
+};

Modules/Core/database/seeders/CoreDatabaseSeeder.php

@@ -17,6 +17,9 @@ class CoreDatabaseSeeder extends Seeder
      */
     public function run(): void
     {
-        $this->call([SettingSeeder::class]);
+        $this->call([
+            SettingSeeder::class,
+            LegalDocumentSeeder::class,
+        ]);
     }
 }

Modules/Core/database/seeders/LegalDocumentSeeder.php

@@ -0,0 +1,59 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Modules\Core\Database\Seeders;
+
+use Illuminate\Database\Seeder;
+use Modules\Core\Models\LegalDocument;
+
+class LegalDocumentSeeder extends Seeder
+{
+    /**
+     * Run the database seeds.
+     */
+    public function run(): void
+    {
+        $documents = [
+            [
+                'slug' => 'termos-de-uso',
+                'title' => 'Termos de Uso',
+                'content' => '<h1>Termos de Uso - Vertex Contas</h1><p>Estes Termos de Uso regem o uso do serviço Vertex Contas, operado pela <strong>Vertex Solutions LTDA</strong>, pessoa jurídica de direito privado, inscrita sob CNPJ, com sede no Brasil.</p><p>Ao utilizar nossos serviços, o usuário declara ter lido, compreendido e concordado integralmente com estes termos, em conformidade com a legislação brasileira vigente.</p>',
+                'version' => '1.0.0',
+                'is_active' => true,
+                'requires_acceptance' => true,
+            ],
+            [
+                'slug' => 'privacidade',
+                'title' => 'Política de Privacidade (LGPD)',
+                'content' => '<h1>Política de Privacidade - LGPD</h1><p>A <strong>Vertex Solutions LTDA</strong> está comprometida com a proteção dos dados pessoais de seus usuários, em conformidade com a Lei Geral de Proteção de Dados (Lei nº 13.709/2018).</p><p>Esta política descreve como coletamos, armazenamos, utilizamos e protegemos suas informações pessoais, garantindo transparência e o exercício dos direitos previstos na LGPD.</p>',
+                'version' => '1.0.0',
+                'is_active' => true,
+                'requires_acceptance' => true,
+            ],
+            [
+                'slug' => 'termos-assinatura',
+                'title' => 'Termos de Assinatura',
+                'content' => '<h1>Termos de Assinatura - Vertex Contas</h1><p>Os presentes Termos de Assinatura celebrados entre o usuário e a <strong>Vertex Solutions LTDA</strong> estabelecem as condições da prestação do serviço de controle financeiro mediante assinatura.</p><p>O contrato é celebrado em conformidade com o Código de Defesa do Consumidor e demais normas aplicáveis no território nacional.</p>',
+                'version' => '1.0.0',
+                'is_active' => true,
+                'requires_acceptance' => false,
+            ],
+            [
+                'slug' => 'politica-cookies',
+                'title' => 'Política de Cookies',
+                'content' => '<h1>Política de Cookies - Vertex Contas</h1><p>A <strong>Vertex Solutions LTDA</strong> utiliza cookies e tecnologias similares para melhorar a experiência do usuário em nossa plataforma Vertex Contas.</p><p>Esta política descreve os tipos de cookies utilizados, suas finalidades e como o usuário pode gerenciar suas preferências, em conformidade com a LGPD e as melhores práticas de privacidade.</p>',
+                'version' => '1.0.0',
+                'is_active' => true,
+                'requires_acceptance' => false,
+            ],
+        ];
+
+        foreach ($documents as $document) {
+            LegalDocument::updateOrCreate(
+                ['slug' => $document['slug']],
+                $document
+            );
+        }
+    }
+}