Desenvolvi um Modulo que calcula estimativa de lucros futuros (e passados)

Olá pessoal, tudo bem?

Estava a procura de um módulo para WHMCS que pudesse me dar uma previsão de lucros com base nos custos mensais com a manutenção do servidor (Locação de Servidor, Licença de cPanel, Módulos, Plugins de Backup, etc). Achei um chamado Expense Tracker, mas é caro e com muitos recursos que não via necessidade. A ideia era apenas lançar uma previsão mensal de custos que o servidor possui e ele criar uma previsão de lucro.

Consegui desenvolver meu próprio modulo, gostei do resultado e compartilho com o pessoal aqui. A ideia é criar uma previsão mensal de custos para cada coisa (ex: se pagou R$ 2.000 num servidor por 24 meses, lance R$ 83,33 lá, o que corresponde ao valor de custo mensal). O próprio sistema pega todas estimativas futuras de entradas e cria uma tabela, e gera um gráfico. Também inclui um campo para exclusões: você seleciona produtos que não devem ser levados em conta na hora de considerar as entradas. A ideia é que às vezes faturamos no WHMCS alguns serviços que não tem a ver com a hospedagem em sí (ex: serviços avulsos, ou qualquer outra coisa que você esteja faturando no WHMCS mas não tenha a ver com a sua hospedagem). Então basta selecionar todas as categorias que não devem entrar no relatório e salvar. Gerei umas faturas de teste e testei tudo, funcionou muito bem, devo colocar em produção agora. Vou mandar uns prints de como ficou:

Aí aproveitei e resolvi usar a mesma lógica para entradas passadas. Neste caso, já estava cansado de lançar receitas e, coloquei só uma passada para testar, porém, nesse caso é importante lançar as despesas com data de início passada também (no formato YYYY-MM), e ele vai gerar esses gráficos em outra tela (De Despesas Passadas) com as receitas consolidadas nos últimos 12 meses. Vou mandar o print, mas nesse caso não tem muita coisa, porque só lancei 1 receita passada pra testar mesmo:

Para quem quiser testar, estou anexando os módulos aqui.

Segue link de download: https://id7.com.br/files/receitas_e_despesas_whmcs.zip

UPDATE: Mandei versão nova com TOTAL no final da tabela.

As instruções de instalação:

Receitas e Despesas (Consolidadas e Futuras) para WHMCS.
Autor: Antonio Ayres - antonio@id7.com.br

COMO INSTALAR:
1 - Suba os arquivos para as respectivas pastas no servidor (modules/addons). A estrutura deve ficar assim:

/modules
  /addons
     /receitas_despesas_consolidadas
        logo.png
        receitas_despesas_consolidadas.php
        whmcs.json
     /receitas_despesas_futuras
        logo.png
        receitas_despesas_futuras.php
        whmcs.json

2 - No WHMCS, vá nas configurações em Aplicativos e Integrações
3 - Na categoria FINANÇA, você encontrará 2 módulos: "Receitas e Despesas Consolidadas" e "Receitas e Despesas Futuras" Ou se preferir use a busca e pesquise por "Receitas e Despesas"
4 - Ative primeiro o módulo Receitas e Despesas Futuras.
5 - Na tela de Configurações do Módulo (deve aparecer automaticamente após ativar, mas caso não apareça, vá em Configurações > Opções > Módulos Addon) e no módulo de Receitas e Despesas Futuras ativo, clique em Configurar. Escolha os grupos que terão permissão para acessar o módulo. Escolha pelo menos o Full Administrator e, se desejar, outros, e salve.
6 - Refaça os passos 2 a 5 com o segundo Módulo (Receitas e Despesas Consolidadas).
7 - Se tiver feito tudo corretamente, você verá 2 submenus novos no menu "Complementos"

Editado Novembro 12, 2025 em 20:28 Nov 12, 2025 por AntonioA