# PDF Components > Componentes de UI para geração e visualização de PDFs seguindo o padrão de components do Easy Budget. - Skill: `majiayu000/pdf-components` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds add majiayu000/pdf-components` - Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/pdf-components/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: majiayu000 (https://skillmd.com/u/majiayu000) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/majiayu000/pdf-components --- # 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 …(truncated)

{{ $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