Invoice Totalizer - Dashboard de Totalizador de Faturas

Dashboard Inteligente para Análise de Faturas em Tempo Real

O módulo Invoice Totalizer - Dashboard de Totalizador de Faturas é a solução perfeita para empresas que precisam de visibilidade instantânea sobre o status financeiro de suas faturas. Com um dashboard visual e interativo, você terá acesso imediato a métricas essenciais de faturamento, valores em aberto, faturas vencidas e recebimentos confirmados.

Principais Funcionalidades

• Dashboard Visual em Cards: Interface moderna com 3 cards principais mostrando faturas pendentes, vencidas e pagas
• Filtro por Período Customizado: Selecione períodos predefinidos (hoje, esta semana, este mês, mês passado, este ano, ano passado) ou personalize com datas específicas
• Seleção de Intervalo de Datas: Calendários datepicker para escolher períodos customizados de análise
• Filtro por Moeda: Visualize totais específicos por moeda com dropdown inteligente que mostra símbolo e nome
• Filtro Multi-Ano: Selecione múltiplos anos simultaneamente para análises comparativas
• Valores em Tempo Real: Atualização instantânea dos totais ao alterar filtros
• Integração com Projetos: Visualize totais de faturas filtrados por projeto específico
• Integração com Clientes: Acesse totais de faturas por cliente no perfil do cliente
• Formatação Automática: Valores formatados automaticamente com a moeda selecionada usando app_format_money()
• Design Responsivo: Layout adaptável com TailwindCSS para desktop, tablet e mobile
• Interface TailwindCSS: Cards modernos com grid responsivo (1 coluna em mobile, 3 em desktop)
• Indicadores Visuais: Cores diferenciadas por status (warning para pendentes, muted para vencidos, success para pagos)
• Atualização AJAX: Carregamento dinâmico sem recarregar a página
• Sistema de Template: Template personalizado instalado automaticamente na pasta de views do admin
• Permissões Granulares: Controle de acesso com permissões view, view_own, create, edit, delete

Dashboard Intuitivo

O módulo apresenta três métricas essenciais em cards visuais:

1. Faturas Pendentes (Outstanding): Total de valores em aberto, marcado em amarelo/warning
2. Faturas Vencidas (Past Due): Valores com vencimento ultrapassado, destacado em cinza/muted
3. Faturas Pagas (Paid): Total de recebimentos confirmados, exibido em verde/success

Filtros Avançados

Sistema completo de filtragem para análise personalizada:

• Períodos Predefinidos: Todos, Hoje, Esta Semana, Este Mês, Mês Passado, Este Ano, Ano Passado
• Período Customizado: Selecione datas de início e fim específicas
• Multi-Moeda: Suporte a múltiplas moedas com conversão automática
• Multi-Ano: Análise comparativa entre diferentes anos
• Por Projeto: Filtro automático quando acessado de dentro de um projeto
• Por Cliente: Totalizador específico no perfil de cada cliente

Para Quem é Este Módulo?

• Gestores Financeiros: Acompanhamento em tempo real da saúde financeira da empresa
• Contadores: Análise rápida de recebíveis e valores em atraso
• Gerentes Comerciais: Visibilidade sobre faturamento e inadimplência
• Empresas de Serviços: Controle de faturas de projetos e clientes recorrentes
• Agências: Acompanhamento de pagamentos de múltiplos clientes
• Consultores: Visualização clara de honorários pendentes e recebidos
• PMEs: Ferramenta essencial para gestão de fluxo de caixa

Benefícios Práticos

• Identifique rapidamente valores em atraso que requerem ação de cobrança
• Tome decisões financeiras baseadas em dados atualizados
• Melhore o fluxo de caixa com visibilidade clara de recebíveis
• Reduza inadimplência com monitoramento constante de vencidos
• Economize tempo com análises que antes levavam horas
• Compare períodos diferentes para identificar tendências
• Analise faturamento por moeda em negócios internacionais
• Apresente relatórios visuais para diretoria e stakeholders

Recursos Técnicos

• Instalação Automática: Template copiado automaticamente para application/views/admin/invoices/
• AJAX Otimizado: Carregamento assíncrono via jQuery para performance máxima
• TailwindCSS: Interface moderna com classes utilitárias (tw-grid, tw-border, tw-rounded-md)
• Bootstrap Select: Dropdowns estilizados e responsivos
• Datepicker Integrado: Seletor de datas nativo do Perfex CRM
• Função Callback: my_init_invoices_total() e fetch_invoices_total() para atualizações dinâmicas
• Suporte a Contexto: Detecção automática de project_id e customer_id para filtros contextuais
• Formatação de Moeda: Uso da função app_format_money() do Perfex para consistência

Integração Perfeita

O módulo se integra nativamente com:

• Sistema de faturas (tbl_invoices)
• Sistema de moedas (currencies)
• Sistema de projetos (projects)
• Perfil de clientes (customer profile)
• Sistema de permissões de staff

Informações Técnicas

• Versão: 1.0.0
• Autor: Taffarel Xavier
• Compatibilidade: Perfex CRM 3.0.* ou superior
• Tecnologias: PHP, jQuery, TailwindCSS, Bootstrap Select, AJAX
• Instalação: Automática via hook de ativação

Este módulo está licenciado sob a Licença MIT.