--- name: pdf-components description: Componentes de UI para geração e visualização de PDFs seguindo o padrão de components do Easy Budget. --- # Componentes de UI para PDFs Esta skill define os componentes Blade específicos para a geração e visualização de PDFs no Easy Budget, seguindo o padrão de components estabelecido no sistema. ## Estrutura de Components ``` resources/views/components/ ├── pdf/ │ ├── pdf-header.blade.php # Cabeçalho padrão de PDFs │ ├── pdf-footer.blade.php # Rodapé padrão de PDFs │ ├── pdf-document.blade.php # Estrutura base de documentos PDF │ ├── pdf-budget.blade.php # Template de orçamento em PDF │ ├── pdf-invoice.blade.php # Template de fatura em PDF │ ├── pdf-report.blade.php # Template de relatório em PDF │ ├── pdf-customer.blade.php # Template de cliente em PDF │ ├── pdf-product.blade.php # Template de produto em PDF │ ├── pdf-watermark.blade.php # Marca d'água para PDFs │ └── pdf-styles.blade.php # Estilos CSS para PDFs └── ... ``` ## 1. PDF Header Component Componente para cabeçalho padrão de documentos PDF. ### Uso Básico ```blade ``` ### Parâmetros | Parâmetro | Tipo | Descrição | Padrão | |-----------|------|-----------|--------| | `title` | `string` | Título do documento | Obrigatório | | `company` | `array` | Dados da empresa | `[]` | | `date` | `string` | Data do documento | `now()` | | `showLogo` | `bool` | Exibir logo da empresa | `true` | ### Estrutura ```blade @props([ 'title', 'company' => [], 'date' => null, 'showLogo' => true ]) {{ $title }}

@if($showLogo && !empty($company['logo']))

@endif

@if(!empty($company['cnpj']))

CNPJ: {{ $company['cnpj'] }}

@endif @if(!empty($company['address']))

Endereço: {{ $company['address'] }}

@endif @if(!empty($company['phone']))

Telefone: {{ $company['phone'] }}

@endif @if(!empty($company['email']))

E-mail: {{ $company['email'] }}

@endif

Data: {{ $date ?? now()->format('d/m/Y') }}

@if(!empty($company['document_number']))

Número: {{ $company['document_number'] }}

@endif

``` ## 2. PDF Footer Component Componente para rodapé padrão de documentos PDF. ### Uso Básico ```blade ``` ### Parâmetros | Parâmetro | Tipo | Descrição | Padrão | |-----------|------|-----------|--------| | `page` | `int` | Número da página atual | `1` | | `totalPages` | `int` | Total de páginas | `1` | | `company` | `array` | Dados da empresa | `[]` | | `showPageNumbers` | `bool` | Exibir numeração de páginas | `true` | ### Estrutura ```blade @props([ 'page' => 1, 'totalPages' => 1, 'company' => [], 'showPageNumbers' => true ])

``` ## 3. PDF Document Component Componente para estrutura base de documentos PDF. ### Uso Básico ```blade ``` ### Parâmetros | Parâmetro | Tipo | Descrição | Padrão | |-----------|------|-----------|--------| | `title` | `string` | Título do documento | Obrigatório | | `company` | `array` | Dados da empresa | `[]` | | `content` | `string` | Conteúdo do documento | Obrigatório | | `date` | `string` | Data do documento | `now()` | ### Estrutura ```blade @props([ 'title', 'company' => [], 'content', 'date' => null ])

{!! $content !!}

``` ## 4. PDF Budget Component Componente para template de orçamento em PDF. ### Uso Básico ```blade ``` ### Parâmetros | Parâmetro | Tipo | Descrição | Padrão | |-----------|------|-----------|--------| | `budget` | `Budget` | Modelo do orçamento | Obrigatório | | `company` | `array` | Dados da empresa | `[]` | | `showLogo` | `bool` | Exibir logo da empresa | `true` | ### Estrutura ```blade @props([ 'budget', 'company' => [], 'showLogo' => true ])

Dados do Cliente

Nome: {{ $budget->customer->display_name }}

CPF/CNPJ: @if($budget->customer->type === 'pf') {{ \App\Helpers\DocumentHelper::formatCpf($budget->customer->commonData->cpf) }} @else {{ \App\Helpers\DocumentHelper::formatCnpj($budget->customer->commonData->cnpj) }} @endif

Endereço: {{ $budget->customer->address->address }}, {{ $budget->customer->address->address_number }}

Bairro: {{ $budget->customer->address->neighborhood }}

Cidade: {{ $budget->customer->address->city }}/{{ $budget->customer->address->state }}

CEP: {{ $budget->customer->address->cep }}

E-mail: {{ $budget->customer->contact->email }}

Telefone: {{ $budget->customer->contact->phone }}

Dados do Orçamento

Número: {{ $budget->code }}

Data: {{ $budget->created_at->format('d/m/Y') }}

Validade: {{ $budget->due_date?->format('d/m/Y') ?? 'Indeterminado' }}

Status: {{ ucfirst($budget->status) }}

Desconto: R$ {{ number_format($budget->discount, 2, ',', '.') }}

Total: R$ {{ number_format($budget->total, 2, ',', '.') }}

@if($budget->services->isNotEmpty())

Serviços

@foreach($budget->services as $service) @endforeach

Código	Descrição	Valor Unitário	Desconto	Total
{{ $service->code }}	{{ $service->description }}	R$ {{ number_format($service->total, 2, ',', '.') }}	R$ {{ number_format($service->discount, 2, ',', '.') }}	R$ {{ number_format($service->total - $service->discount, 2, ',', '.') }}
Total dos Serviços:				R$ {{ number_format($budget->services->sum('total'), 2, ',', '.') }}

@endif @if($budget->description)

Observações

@endif

Termos e Condições

Este orçamento tem validade de 30 dias a partir da data de emissão. O pagamento deverá ser efetuado conforme as condições acordadas. Qualquer alteração neste orçamento deverá ser comunicada por escrito.

Para aceitar este orçamento, assine no campo abaixo e devolva uma cópia.

Assinaturas

Cliente

``` ## 5. PDF Invoice Component Componente para template de fatura em PDF. ### Uso Básico ```blade ``` ### Parâmetros | Parâmetro | Tipo | Descrição | Padrão | |-----------|------|-----------|--------| | `invoice` | `Invoice` | Modelo da fatura | Obrigatório | | `company` | `array` | Dados da empresa | `[]` | | `showLogo` | `bool` | Exibir logo da empresa | `true` | ### Estrutura ```blade @props([ 'invoice', 'company' => [], 'showLogo' => true ])

Dados do Cliente

Nome: {{ $invoice->customer->display_name }}

CPF/CNPJ: @if($invoice->customer->type === 'pf') {{ \App\Helpers\DocumentHelper::formatCpf($invoice->customer->commonData->cpf) }} @else {{ \App\Helpers\DocumentHelper::formatCnpj($invoice->customer->commonData->cnpj) }} @endif

Endereço: {{ $invoice->customer->address->address }}, {{ $invoice->customer->address->address_number }}

Bairro: {{ $invoice->customer->address->neighborhood }}

Cidade: {{ $invoice->customer->address->city }}/{{ $invoice->customer->address->state }}

CEP: {{ $invoice->customer->address->cep }}

Dados da Fatura

Número: {{ $invoice->code }}

Data de Emissão: {{ $invoice->created_at->format('d/m/Y') }}

Data de Vencimento: {{ $invoice->due_date?->format('d/m/Y') ?? 'N/A' }}

Status: {{ ucfirst($invoice->status) }}

Método de Pagamento: {{ $invoice->payment_method ?? 'N/A' }}

ID do Pagamento: {{ $invoice->payment_id ?? 'N/A' }}

Itens da Fatura

@foreach($invoice->items as $item) @endforeach @if($invoice->discount > 0) @endif

Descrição	Quantidade	Valor Unitário	Total
{{ $item->description }}	{{ $item->quantity }}	R$ {{ number_format($item->unit_price, 2, ',', '.') }}	R$ {{ number_format($item->total, 2, ',', '.') }}
Subtotal:			R$ {{ number_format($invoice->subtotal, 2, ',', '.') }}
Desconto:			- R$ {{ number_format($invoice->discount, 2, ',', '.') }}
Total:			R$ {{ number_format($invoice->total, 2, ',', '.') }}

@if($invoice->payment_method)

Informações de Pagamento

Método: {{ $invoice->payment_method }}

Valor Pago: R$ {{ number_format($invoice->transaction_amount ?? $invoice->total, 2, ',', '.') }}

Data do Pagamento: {{ $invoice->transaction_date?->format('d/m/Y H:i') ?? 'N/A' }}

Status: {{ ucfirst($invoice->status) }}

@endif @if($invoice->notes)

Observações

@endif ``` ## 6. PDF Report Component Componente para template de relatório em PDF. ### Uso Básico ```blade ``` ### Parâmetros | Parâmetro | Tipo | Descrição | Padrão | |-----------|------|-----------|--------| | `report` | `Report` | Modelo do relatório | Obrigatório | | `data` | `array` | Dados do relatório | `[]` | | `company` | `array` | Dados da empresa | `[]` | | `showLogo` | `bool` | Exibir logo da empresa | `true` | ### Estrutura ```blade @props([ 'report', 'data' => [], 'company' => [], 'showLogo' => true ])

Resumo Executivo

@foreach($data['summary'] ?? [] as $key => $value)

@endforeach

@if(!empty($data['details']))

Dados Detalhados

@foreach(array_keys($data['details'][0] ?? []) as $header) @endforeach @foreach($data['details'] as $row) @foreach($row as $value) @endforeach @endforeach

{{ ucfirst(str_replace('_', ' ', $header)) }}
{{ $value }}

@endif @if(!empty($data['charts']))

Análise Gráfica

@foreach($data['charts'] as $chart)

Gráfico: {{ $chart['type'] }}

@endforeach

@endif @if(!empty($data['conclusions']))

Conclusões

@foreach($data['conclusions'] as $conclusion)

{{ $conclusion['title'] }}: {{ $conclusion['description'] }}

@endforeach

@endif @if(!empty($data['recommendations']))

Recomendações

@foreach($data['recommendations'] as $recommendation)

{{ $recommendation['title'] }}: {{ $recommendation['description'] }}

@endforeach

@endif ``` ## 7. PDF Customer Component Componente para template de cliente em PDF. ### Uso Básico ```blade ``` ### Parâmetros | Parâmetro | Tipo | Descrição | Padrão | |-----------|------|-----------|--------| | `customer` | `Customer` | Modelo do cliente | Obrigatório | | `company` | `array` | Dados da empresa | `[]` | | `showLogo` | `bool` | Exibir logo da empresa | `true` | ### Estrutura ```blade @props([ 'customer', 'company' => [], 'showLogo' => true ])

Dados Básicos

Nome/Razão Social: {{ $customer->display_name }}

Tipo: {{ $customer->type === 'pf' ? 'Pessoa Física' : 'Pessoa Jurídica' }}

Status:

Data de Cadastro: {{ $customer->created_at->format('d/m/Y') }}

@if($customer->commonData)

{{ $customer->type === 'pf' ? 'Dados Pessoais' : 'Dados Empresariais' }}

@if($customer->type === 'pf')

Nome Completo: {{ $customer->commonData->first_name }} {{ $customer->commonData->last_name }}

CPF: {{ \App\Helpers\DocumentHelper::formatCpf($customer->commonData->cpf) }}

Data de Nascimento: {{ $customer->commonData->birth_date?->format('d/m/Y') ?? 'N/A' }}

Profissão: {{ $customer->commonData->profession?->name ?? 'N/A' }}

@else

Razão Social: {{ $customer->commonData->company_name }}

CNPJ: {{ \App\Helpers\DocumentHelper::formatCnpj($customer->commonData->cnpj) }}

CPF do Responsável: {{ \App\Helpers\DocumentHelper::formatCpf($customer->commonData->cpf) }}

Área de Atuação: {{ $customer->commonData->areaOfActivity?->name ?? 'N/A' }}

@endif @if($customer->commonData->description)

Descrição: {{ $customer->commonData->description }}

@endif

@endif @if($customer->contact)

Contato

E-mail Principal: {{ $customer->contact->email }}

Telefone: {{ $customer->contact->phone ?? 'N/A' }}

E-mail Comercial: {{ $customer->contact->email_business ?? 'N/A' }}

Telefone Comercial: {{ $customer->contact->phone_business ?? 'N/A' }}

@if($customer->contact->website)

Website: {{ $customer->contact->website }}

@endif

@endif @if($customer->address)

Endereço

Logradouro: {{ $customer->address->address }}, {{ $customer->address->address_number }} @if($customer->address->address_complement) - {{ $customer->address->address_complement }} @endif

Bairro: {{ $customer->address->neighborhood }}

Cidade: {{ $customer->address->city }}/{{ $customer->address->state }}

CEP: {{ $customer->address->cep }}

@if($customer->address->country && $customer->address->country !== 'Brasil')

País: {{ $customer->address->country }}

@endif

Histórico de Transações

Total de Orçamentos: {{ $customer->budgets->count() }}

Total de Faturas: {{ $customer->invoices->count() }}

Valor Total Faturado: R$ {{ number_format($customer->invoices->sum('total'), 2, ',', '.') }}

Valor Médio por Fatura: R$ {{ $customer->invoices->count() > 0 ? number_format($customer->invoices->avg('total'), 2, ',', '.') : '0,00' }}

``` ## 8. PDF Product Component Componente para template de produto em PDF. ### Uso Básico ```blade ``` ### Parâmetros | Parâmetro | Tipo | Descrição | Padrão | |-----------|------|-----------|--------| | `product` | `Product` | Modelo do produto | Obrigatório | | `company` | `array` | Dados da empresa | `[]` | | `showLogo` | `bool` | Exibir logo da empresa | `true` | ### Estrutura ```blade @props([ 'product', 'company' => [], 'showLogo' => true ])

Informações Básicas

Nome: {{ $product->name }}

Código: {{ $product->code ?? 'N/A' }}

Status:

Categoria: {{ $product->category?->name ?? 'N/A' }}

Descrição: {{ $product->description ?? 'N/A' }}

Preço

Preço de Venda: R$ {{ number_format($product->price, 2, ',', '.') }}

Preço de Custo: R$ {{ number_format($product->cost ?? 0, 2, ',', '.') }}

@if($product->cost)

Lucro por Unidade: R$ {{ number_format($product->price - $product->cost, 2, ',', '.') }}

Margem de Lucro: {{ number_format((($product->price - $product->cost) / $product->cost) * 100, 2) }}%

@endif

@if($product->inventory)

Estoque

Quantidade Atual: {{ $product->inventory->quantity }}

Estoque Mínimo: {{ $product->inventory->min_quantity }}

Estoque Máximo: {{ $product->inventory->max_quantity ?? 'Ilimitado' }}

Valor Total em Estoque: R$ {{ number_format($product->inventory->quantity * $product->price, 2, ',', '.') }}

@endif @if($product->inventoryMovements->isNotEmpty())

Movimentações de Estoque

@foreach($product->inventoryMovements->take(10) as $movement) @endforeach

Data	Tipo	Quantidade	Motivo
{{ $movement->created_at->format('d/m/Y H:i') }}	{{ $movement->type === 'in' ? 'Entrada' : 'Saída' }}	{{ $movement->type === 'in' ? '+' : '-' }}{{ $movement->quantity }}	{{ $movement->reason ?? 'Sem motivo' }}

@endif @if($product->image)

Imagem do Produto

@endif ``` ## 9. PDF Watermark Component Componente para marca d'água em PDFs. ### Uso Básico ```blade ``` ### Parâmetros | Parâmetro | Tipo | Descrição | Padrão | |-----------|------|-----------|--------| | `text` | `string` | Texto da marca d'água | Obrigatório | | `opacity` | `float` | Opacidade da marca d'água | `0.1` | | `color` | `string` | Cor da marca d'água | `#000000` | ### Estrutura ```blade @props([ 'text', 'opacity' => 0.1, 'color' => '#000000' ])

``` ## 10. PDF Styles Component Componente para estilos CSS padrão de PDFs. ### Uso Básico ```blade ``` ### Estrutura ```blade ``` ## 11. Integração com Padrões Existentes ### Uso em Controllers ```php // BudgetController.php public function pdf(Budget $budget) { $company = [ 'name' => tenant('name'), 'logo' => tenant('logo'), 'cnpj' => tenant('cnpj'), 'address' => tenant('address'), 'phone' => tenant('phone'), 'email' => tenant('email'), 'document_number' => $budget->code ]; $pdf = PDF::loadView('components.pdf.pdf-budget', [ 'budget' => $budget, 'company' => $company ]); return $pdf->stream('budget-' . $budget->code . '.pdf'); } ``` ### Uso em Views ```blade {{-- Visualização de PDF --}} {{-- Geração de PDF --}} ``` ### Estilos CSS ```css /* PDF Components Styles */ .pdf-container { width: 210mm; margin: 0 auto; padding: 20mm; } .pdf-table { width: 100%; border-collapse: collapse; } .pdf-table th, .pdf-table td { border: 1px solid #ddd; padding: 6px 8px; } .status-badge { padding: 2px 8px; border-radius: 4px; font-size: 11px; font-weight: bold; } ``` ## 12. JavaScript Interatividade ### Visualização de PDF ```javascript // pdf-viewer.js document.addEventListener('DOMContentLoaded', function() { // Botões de download de PDF const pdfButtons = document.querySelectorAll('.btn-pdf'); pdfButtons.forEach(button => { button.addEventListener('click', function() { const url = this.getAttribute('data-url'); if (url) { window.open(url, '_blank'); } }); }); // Impressão de PDF const printButtons = document.querySelectorAll('.btn-print'); printButtons.forEach(button => { button.addEventListener('click', function() { window.print(); }); }); }); ``` ## 13. Validação e Segurança ### Autorização ```php // PdfPolicy.php public function viewBudget(User $user, Budget $budget) { return $user->tenant_id === $budget->tenant_id; } public function viewInvoice(User $user, Invoice $invoice) { return $user->tenant_id === $invoice->tenant_id; } public function viewReport(User $user, Report $report) { return $user->tenant_id === $report->tenant_id; } ``` ### Validations ```blade {{-- PDF Budget com validação de permissões --}} @can('viewBudget', $budget) @endcan {{-- PDF Invoice com validação de status --}} @can('viewInvoice', $invoice) @endcan ``` Este padrão de components para PDFs garante consistência visual, reutilização de código e manutenibilidade, seguindo os mesmos princípios estabelecidos nos outros components do sistema.

{{ $company['name'] ?? 'Easy Budget' }}

{{ $title }}

Dados do Cliente

Dados do Orçamento

Serviços

Observações

Termos e Condições

Assinaturas

Dados do Cliente

Dados da Fatura

Itens da Fatura

Informações de Pagamento

Observações

Resumo Executivo

Dados Detalhados

Análise Gráfica

{{ $chart['title'] }}

Conclusões

Recomendações

Dados Básicos

{{ $customer->type === 'pf' ? 'Dados Pessoais' : 'Dados Empresariais' }}

Contato

Endereço

Histórico de Transações

Informações Básicas

Preço

Estoque

Movimentações de Estoque

Imagem do Produto