Helpers

Helpers devem concentrar transformações pequenas, determinísticas e reutilizáveis. Não devem consultar banco, disparar Jobs ou decidir autorização.

Inventário

• CurrencyHelper — moeda com locale configurado.
• NumberToWordsHelper — números e valores em reais por extenso (implementado).
• DateHelper — datas, horários e datas relativas.
• DigitsHelper — normalização para dígitos.
• BrazilianDocumentHelper — CPF e CNPJ.
• BrazilianContactHelper — telefone brasileiro.
• BrazilianAddressHelper — CEP.
• app/helpers.php — fachada de funções globais.

Checklist comum

• Definir entradas aceitas e retorno para null, vazio e inválido.
• Manter formatação de apresentação separada do valor persistido.
• Usar locale/timezone configurados, sem valores mágicos espalhados.
• Não duplicar função global e implementação de classe: a global deve delegar.
• Criar teste unitário para cada método público e casos-limite.
• Documentar exemplos que possam ser copiados para Blade/Livewire.
• Atualizar esta página quando um helper for criado, renomeado ou removido.

Navegação

• Componentes técnicos
• Casts
• Checklist de funcionalidade