Neste artigo, vou mostrar como funciona, na prática, um sistema real de cobrança construído em Laravel, integrando Boleto e Pix do Banco Inter, com webhooks, PDFs, crons, Docker, e-mails, WhatsApp, SMS e até ligações automáticas.

Todo o conteúdo é baseado em um projeto open source real, usado em produção, disponível no GitHub:

👉 Repositório:
https://github.com/leonardop21/boleto-inter-free

Importante: este não é um “tutorial de Hello World”. É um guia técnico completo, voltado para quem quer entender arquitetura, evitar erros comuns e colocar cobrança automática em produção com segurança.

Por que integrar diretamente com o Banco Inter?

O Banco Inter oferece uma API robusta para PJ, com suporte nativo a:

• Boletos registrados
• Pix com QR Code dinâmico
• Webhooks de status
• Consulta de cobranças
• Download de PDFs
• Extratos bancários

Ao integrar diretamente com o Inter, você elimina intermediários, reduz custos e ganha controle total sobre o fluxo financeiro.

Mas isso vem com desafios:

• Certificados mTLS
• OAuth2
• Regras rígidas de vencimento
• Webhooks que precisam ser idempotentes
• PDFs que precisam ser armazenados ou regenerados
• Conciliação automática

É exatamente isso que o projeto resolve.

Visão geral da arquitetura do sistema

Antes de entrar em código, é importante entender como o sistema foi pensado.

Componentes principais

• Laravel 8 como base
• MySQL para dados transacionais
• Redis para cache com tags
• Banco Inter API para cobranças
• Notifish para WhatsApp
• SMTP para e-mails
• SMS Dev para SMS
• King SMS (Voicer) para ligações
• Docker + Nginx + PHP-FPM em produção

Nada aqui é experimental. Tudo foi pensado para rodar 24/7, com falhas previsíveis e logs rastreáveis.

Por que Redis é obrigatório neste projeto?

Um erro comum em sistemas de cobrança é consultar a API do banco o tempo todo.

Esse projeto evita isso usando cache agressivo com tags, por exemplo:

• Cache de cobranças
• Cache de clientes
• Cache de serviços
• Cache de status de boletos e Pix

Quando um boleto muda de status (via webhook), o cache relacionado é invalidado.

👉 Sem Redis (ou Memcached), o sistema não funciona corretamente.

Instalação do projeto (ambiente local)

1. Clonando o repositório

git clone https://github.com/leonardop21/boleto-inter-free.git
cd boleto-inter-free
composer install

2. Configuração inicial

cp .env.example .env
php artisan key:generate

Configurando o banco de dados e cache

No .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=boleto_inter
DB_USERNAME=user
DB_PASSWORD=pass

CACHE_DRIVER=redis
SESSION_DRIVER=redis
TIME_CACHE_IN_SECONDS=604800

Depois:

php artisan migrate

Como funciona o modelo de cobrança

O sistema foi pensado para cobrança recorrente, mas funciona também para cobranças pontuais.

Entidades principais

• Cliente
• Serviço
• Cliente x Serviço
• Boleto
• Pix
• NF-e (opcional)

O fluxo é simples:

1. Você cadastra um cliente
2. Cadastra um serviço
3. Vincula o serviço ao cliente
4. O sistema gera boletos ou Pix automaticamente

Integração com o Banco Inter (parte crítica)

Certificados mTLS

O Inter exige:

• Um arquivo .crt
• Um arquivo .key

No .env:

INTER_PATH_CRT=/caminho/inter.crt
INTER_PATH_KEY=/caminho/inter.key

OAuth2

INTER_CLIENT_ID=seu_client_id
INTER_CLIENT_SECRET=seu_client_secret
INTER_CLIENT_SCOPE="extrato.read boleto-cobranca.read boleto-cobranca.write"
INTER_BASE_URL="https://cdpj.partners.bancointer.com.br/"

Sem isso, nenhuma requisição funciona.

Webhooks: o coração da automação

O sistema registra dois webhooks no Inter:

• Boleto
• Pix

INTER_WEBHOOK_URL=https://seusite.com/api/inter/webhook/boleto
INTER_WEBHOOK_URL_PIX=https://seusite.com/api/inter/webhook/pix

O que acontece quando um pagamento é feito?

1. O Inter chama o webhook
2. O sistema valida a assinatura
3. Atualiza o status da cobrança
4. Invalida caches relacionados
5. Registra logs
6. (Opcional) dispara notificações internas

Isso evita:

• Jobs de polling
• Consultas desnecessárias
• Status desatualizado

Geração automática de boletos

Este é um dos pontos mais sofisticados do projeto.

Comando:

php artisan ln:auto_generate_boleto

Regras implementadas

• Se o dia de vencimento já passou → gera para o mês seguinte
• Se o cliente escolheu dia 31 → ajusta para último dia do mês
• Respeita meses com 28, 29, 30 ou 31 dias
• Evita boletos duplicados
• Gera PDF automaticamente
• Salva logs detalhados

Tudo isso roda sem intervenção humana.

Geração automática de Pix

Comando:

php artisan ln:auto_generate_pix

• Gera QR Code
• Gera payload Pix
• Cria cobrança no Inter
• Registra vencimento
• Gera imagem do QR Code (GD)

Envio de cobranças por e-mail

O sistema envia:

• Boleto em PDF
• Pix com QR Code
• NF-e (se configurado)

Configuração SMTP no .env:

MAIL_HOST=
MAIL_PORT=587
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_ENCRYPTION=tls

Além disso, o layout do e-mail é personalizável:

• Logo
• Cor de fundo
• Links de suporte

Envio por WhatsApp (Notifish)

Integração direta com a API do Notifish.

NOTIFISH_BASE_URL=https://seu.notifish.com/api/v2/
NOTIFISH_API_KEY=sua_key
NOTIFISH_UUID=sua_instancia

O sistema gera uma URL assinada temporária para o PDF do boleto, válida por poucos minutos — sem expor IDs internos.

SMS e ligações automáticas para inadimplentes

SMS

php artisan ln:send-boleto-sms
php artisan ln:send-pix-sms

Ligação (voz robótica)

php artisan ln:send-boleto-voicer
php artisan ln:send-pix-voicer

Isso é usado somente após o vencimento, como camada extra de cobrança.

Crons: como tudo roda sozinho

Você não agenda cada comando individualmente.

Apenas:

* * * * * php artisan schedule:run

O Laravel Scheduler cuida do resto.

Exemplo:

• Dia 1 → gera boletos
• Antes do vencimento → envia lembrete
• Após vencimento → cobrança progressiva

Docker em produção

O projeto já vem com:

• Dockerfile
• docker-compose.prod.yml
• Nginx configurado
• PHP-FPM otimizado
• Redis
• MySQL

Subir produção:

docker compose -f docker-compose.prod.yml up -d --build

Logs, rastreabilidade e auditoria

Cada processo tem seu próprio log:

• Boletos
• Pix
• NF-e
• Webhooks
• Erros de API

Isso é fundamental para:

• Suporte
• Auditoria
• Contabilidade
• Diagnóstico rápido

Para quem este projeto é indicado?

• Desenvolvedores PHP/Laravel
• SaaS com cobrança recorrente
• Sistemas internos de empresas
• Agências que querem padronizar cobrança
• Projetos que precisam de autonomia financeira

Conclusão

Automatizar cobranças não é só “gerar boleto”.
É lidar com:

• Datas
• Erros bancários
• Comunicação
• Inadimplência
• Escala
• Observabilidade

Este projeto resolve isso de forma pragmática, realista e testada em produção.

👉 Repositório completo:
https://github.com/leonardop21/boleto-inter-free

The post Sistema completo de cobranças via WhatsApp: boleto, Pix e NF-e na prática appeared first on Leonardo Nascimento | Engenheiro de Software.

Este artigo detalha a arquitetura de uma API REST desenvolvida em Laravel para gerenciamento de tarefas, criada como parte de um teste técnico, mas estruturada como um projeto pronto para produção, seguindo boas práticas amplamente utilizadas em ambientes corporativos.

Visão geral da solução

A aplicação consiste em uma API RESTful para gerenciamento de tarefas, com suporte a:

• Autenticação via Bearer Token (Laravel Sanctum)
• CRUD completo de tarefas
• Marcação de tarefas como concluídas
• Cache de consultas com Redis
• Banco de dados PostgreSQL
• Documentação interativa via Swagger
• Ambiente Dockerizado (dev, test e prod)
• Testes automatizados
• Pipeline de CI/CD com GitHub Actions

O foco não foi apenas “fazer funcionar”, mas pensar a aplicação como um produto escalável e previsível.

Decisão arquitetural: API stateless e autenticação

A API foi construída como stateless, utilizando Bearer Token via Laravel Sanctum.

Benefícios dessa abordagem:

• Facilidade de integração com frontends (SPA, mobile, terceiros)
• Independência de sessão
• Escalabilidade horizontal
• Compatibilidade com gateways, load balancers e proxies

A autenticação é desacoplada do fluxo de negócio, o que facilita manutenção e evolução futura.

PostgreSQL como banco principal

A escolha do PostgreSQL não foi aleatória. Ele é amplamente utilizado em ambientes corporativos por oferecer:

• Confiabilidade transacional
• Suporte avançado a índices
• Tipos de dados ricos
• Excelente desempenho em cenários complexos

Isso torna a aplicação preparada para crescer sem precisar trocar a base de dados no curto ou médio prazo.

Redis como camada de cache

Para reduzir carga no banco e melhorar tempo de resposta, foi implementado cache com Redis, com TTL de 120 segundos nas consultas mais comuns.

Benefícios diretos:

• Redução de queries repetitivas
• Menor latência
• Melhor desempenho sob carga
• Escalabilidade em leitura

Essa abordagem demonstra preocupação com performance real, não apenas com lógica funcional.

Arquitetura limpa: Repository Pattern + Service Layer

A aplicação segue princípios de Clean Architecture, separando responsabilidades de forma clara:

• Controllers: recebem requisições e retornam respostas
• Services: concentram regras de negócio
• Repositories: isolam o acesso a dados
• Models: representam as entidades

Vantagens dessa separação:

• Código mais legível
• Facilidade de testes
• Menor acoplamento
• Evolução segura do domínio

Essa estrutura é comum em times maduros e projetos de longo prazo.

Docker como base do ambiente

Toda a aplicação roda em Docker, com ambientes bem definidos:

Desenvolvimento

• Código em volume
• Hot reload
• PostgreSQL + Redis + Nginx
• Testes executados automaticamente

Produção

• Build otimizado
• Código embutido na imagem
• Assets compilados no build
• Sem dependência de volume

Essa separação reduz o clássico problema de “funciona na minha máquina” e aproxima o ambiente local da produção.

Testes automatizados como parte do fluxo

A aplicação conta com testes unitários e de feature, executados de três formas:

• Localmente no ambiente dev
• Isoladamente via Docker
• Automaticamente no CI/CD

Isso garante:

• Segurança para refatorações
• Detecção precoce de bugs
• Confiança na entrega contínua

Testes não são tratados como opcional, mas como parte da arquitetura.

CI/CD com GitHub Actions

Cada push ou pull request dispara um workflow que:

1. Sobe toda a stack Docker (app, banco, cache)
2. Executa migrations
3. Roda a suíte completa de testes
4. Bloqueia o merge em caso de falha

Esse processo simula um pipeline real de empresas que operam com entrega contínua e qualidade de código como requisito.

Documentação com Swagger

A API possui documentação interativa via Swagger, acessível após subir a aplicação.

Isso permite:

• Testes manuais rápidos
• Onboarding mais fácil
• Comunicação clara entre backend e frontend
• Uso por terceiros sem dependência de documentação externa

Documentação é tratada como parte do produto, não como etapa posterior.

Benefícios dessa arquitetura em um contexto profissional

Essa abordagem entrega vantagens claras em ambientes reais:

• Código organizado e previsível
• Facilidade de manutenção
• Escalabilidade técnica
• Padronização de ambientes
• Menor risco em deploys
• Base sólida para crescimento

Não se trata apenas de uma API de tarefas, mas de um modelo replicável para aplicações reais.

O que esse projeto demonstra tecnicamente

Esse projeto evidencia competências como:

• Domínio de Laravel além do básico
• Conhecimento de arquitetura backend
• Uso consciente de cache e banco
• Experiência com Docker e ambientes reais
• Cultura de testes
• Automação de CI/CD
• Pensamento orientado a produto e escala

São exatamente esses pontos que diferenciam um desenvolvedor pleno/sênior em processos seletivos.

Conclusão

Mais do que cumprir um teste técnico, o objetivo deste projeto foi demonstrar capacidade de pensar sistemas como um todo, indo além do CRUD simples.

Arquitetura, automação, testes e previsibilidade são o que tornam uma aplicação sustentável — e é isso que empresas buscam quando contratam profissionais para projetos de longo prazo.

Link do teste prático

The post Arquitetura de uma API REST em Laravel preparada para produção appeared first on Leonardo Nascimento | Engenheiro de Software.

Com a aprovação no diretório oficial, o plugin passa a atender padrões rígidos de segurança, qualidade de código e boas práticas exigidas pela equipe do WordPress, o que garante mais confiabilidade para quem busca soluções profissionais de distribuição de conteúdo.

👉 Repositório oficial do plugin:
https://wordpress.org/plugins/notifish/

O que é o plugin Notifish

O Notifish é um plugin que conecta o WordPress à plataforma Notifish, permitindo que publicações sejam enviadas automaticamente para grupos, listas ou contatos no WhatsApp a partir do momento em que um post é publicado ou atualizado.

Na prática, ele elimina processos manuais comuns em portais, blogs e sites de conteúdo, como copiar links, formatar mensagens e disparar envios individualmente, centralizando tudo dentro do próprio fluxo editorial.

Para quem o Notifish é indicado

O plugin foi desenvolvido para cenários reais de uso, como:

• Portais de notícias e sites jornalísticos
• Blogs com publicação frequente
• Produtores de conteúdo e infoprodutores
• Empresas que usam WhatsApp como canal de comunicação
• Projetos WordPress que dependem de distribuição rápida de conteúdo

Em todos esses casos, o WhatsApp deixa de ser apenas um canal complementar e passa a fazer parte da estratégia de publicação.

Como funciona a integração com o WordPress

Após a instalação do plugin e a configuração da chave de API, o funcionamento é simples:

1. O conteúdo é publicado normalmente no WordPress
2. O plugin identifica a publicação
3. O Notifish envia a mensagem para os grupos ou listas configuradas
4. O envio fica registrado para controle e auditoria

Todo o processo acontece de forma transparente para o editor, sem necessidade de ferramentas externas ou fluxos paralelos.

Principais vantagens do Notifish

Automação real no fluxo editorial

O envio das mensagens acontece no momento certo, integrado ao ciclo de publicação, sem depender de ações manuais.

Distribuição imediata do conteúdo

Assim que a matéria vai ao ar, ela já pode ser entregue ao público em um canal com alta taxa de abertura e leitura.

Centralização de operações

O WordPress deixa de ser apenas um CMS e passa a ser também um ponto central de distribuição de conteúdo.

Mais controle sobre comunicação via WhatsApp

O uso de automação reduz falhas humanas, duplicidade de envios e inconsistências na comunicação.

Aprovação no repositório oficial do WordPress

A presença do Notifish no repositório oficial do WordPress é um ponto relevante, pois indica que o plugin:

• Segue as diretrizes de segurança do WordPress
• Utiliza boas práticas de desenvolvimento
• Passou por revisão manual da equipe do WordPress
• Pode ser instalado e atualizado diretamente pelo painel administrativo

Isso reduz riscos técnicos e aumenta a confiabilidade do projeto para uso em produção.

Impacto em SEO e engajamento

Embora o WhatsApp não seja um fator direto de ranqueamento, a automação de distribuição impacta positivamente métricas importantes para SEO, como:

• Aumento de tráfego recorrente
• Maior taxa de retorno ao site
• Crescimento de engajamento com o conteúdo
• Ampliação do alcance orgânico das publicações

Em projetos editoriais, isso significa conteúdo sendo consumido mais rápido e com mais frequência.

Onde instalar o plugin Notifish

O plugin está disponível no repositório oficial do WordPress e pode ser instalado diretamente pelo painel administrativo ou acessado pelo link abaixo:

https://wordpress.org/plugins/notifish

Considerações finais

O Notifish não é apenas um plugin de envio de mensagens, mas uma ferramenta de integração entre conteúdo e distribuição, pensada para quem publica com frequência e precisa de escala sem perder controle.

Para sites WordPress que utilizam o WhatsApp como canal estratégico, a automação deixa de ser um diferencial e passa a ser uma necessidade operacional.

The post Automação de WhatsApp para WordPress: uma solução escalável para empresas e portais appeared first on Leonardo Nascimento | Engenheiro de Software.

Hoje, publicar notícias diariamente já não é suficiente para sustentar audiência no médio e longo prazo.

O Google deixou de avaliar páginas isoladas

Durante muito tempo, portais competiam matéria por matéria. Um bom título, uma palavra-chave bem escolhida e uma publicação rápida bastavam para garantir visibilidade. Esse cenário mudou.

O Google passou a avaliar o conjunto do site, e não apenas conteúdos individuais. Estrutura editorial, coerência temática, histórico de publicação e profundidade do conteúdo passaram a pesar mais do que volume.

Portais que continuaram apostando apenas em quantidade começaram a perder espaço.

O problema da fragmentação editorial

Uma característica comum em portais que entraram em declínio é a fragmentação. Publica-se de tudo um pouco: política, polícia, entretenimento, esportes, curiosidades, tecnologia, sem um eixo claro de autoridade.

Para o leitor humano isso já gera confusão. Para o Google, o efeito é ainda mais forte: o site deixa de ser reconhecido como referência em qualquer tema específico.

Sem domínio temático, o portal passa a competir em desvantagem.

Velocidade sem contexto deixou de ser vantagem

A corrida por publicar primeiro ainda existe, mas perdeu força como fator decisivo. O Google passou a privilegiar conteúdos que demonstram contexto, aprofundamento e ligação com outros materiais relevantes do próprio site.

Portais que apenas replicam releases ou reescrevem notícias de forma superficial conseguem até picos momentâneos, mas não constroem tráfego sustentável.

Quando o problema não é técnico, é estratégico

Muitos portais tentaram resolver a queda investindo apenas em ajustes técnicos: plugins de SEO, mudança de layout, otimização pontual de títulos. Esses ajustes ajudam, mas não resolvem o problema central.

O que está em jogo é posicionamento editorial. Sem uma estratégia clara de domínio, qualquer melhoria técnica vira paliativo.

Um modelo diferente de pensar crescimento orgânico

Algumas iniciativas recentes têm trabalhado o SEO a partir de uma lógica mais estrutural, focada em domínio e autoridade editorial. O material Domínio Total é um exemplo dessa abordagem, ao tratar crescimento orgânico como construção de território temático, e não como disputa pontual por palavras-chave.

A proposta é simples na teoria, mas exige mudança de mentalidade: menos dispersão e mais profundidade.

O que portais em recuperação precisam repensar

Para voltar a crescer de forma consistente, portais de notícias precisam rever alguns pontos-chave:

• clareza sobre quais temas realmente dominam
• interligação entre conteúdos antigos e novos
• produção de materiais que sustentem autoridade, não apenas cliques
• visão de SEO como estratégia editorial, não apenas técnica

Sem isso, a tendência é continuar dependente de picos ocasionais e tráfego instável.

Um cenário que tende a se intensificar

Tudo indica que o Google continuará reforçando critérios ligados a autoridade, especialização e confiabilidade. Portais que não se adaptarem a essa lógica tendem a perder ainda mais espaço, independentemente da frequência de publicação.

A disputa deixou de ser apenas por audiência diária e passou a ser por relevância acumulada.

A queda de muitos portais de notícias não é resultado de um erro isolado, mas de um modelo que deixou de funcionar. Entender como o Google enxerga domínio e autoridade se tornou essencial para quem quer recuperar tráfego e sustentabilidade editorial.

Mais do que publicar mais, o desafio agora é publicar melhor e com propósito claro.

The post appeared first on Leonardo Nascimento | Engenheiro de Software.

O Loom é uma ferramenta popular entre equipes de trabalho, pois permite a colaboração em tempo real, além de ser uma maneira fácil de compartilhar ideias e feedback. Os vídeos gravados com o Loom são armazenados na nuvem, o que significa que você pode acessá-los a qualquer momento e de qualquer lugar.

O Loom também é uma ferramenta útil para professores e instrutores, pois permite que eles criem vídeos de aulas rápidos e eficientes para seus alunos. Além disso, o Loom é uma ótima opção para empresas que querem criar treinamentos internos para funcionários ou para criar demonstrações de produtos e serviços para clientes.

O Loom é grátis para usuários pessoais, mas também oferece planos pagos para equipes e empresas, que incluem recursos adicionais, como armazenamento ilimitado e integrações com outras ferramentas de colaboração.

Em resumo, o Loom é uma ferramenta de vídeo colaborativa poderosa e fácil de usar, que oferece uma solução eficiente para compartilhar ideias, feedback e treinamentos com outras pessoas. Se você estiver procurando uma maneira simples e eficiente de criar e compartilhar vídeos, o Loom é uma ótima opção.

The post Conheça o Loom: a ferramenta de vídeo colaborativa perfeita para uso individual ou em equipe” appeared first on Leonardo Nascimento | Engenheiro de Software.

Aprender inglês é importante para programadores por diversas razões. Em primeiro lugar, a maioria das documentações de programação são escritas em inglês. Portanto, é importante que os programadores sejam capazes de ler e entender essas documentações para que possam trabalhar com eficiência e precisão. Se um programador não entender a documentação, poderá perder tempo tentando descobrir o que significa cada termo técnico, o que pode afetar o prazo de entrega do projeto.

Em segundo lugar, a comunicação com colegas de trabalho e clientes também é fundamental para o sucesso de um projeto. Se os programadores não conseguirem se comunicar em inglês, isso pode afetar a qualidade do trabalho e a satisfação do cliente. Além disso, muitas vezes os programadores precisam colaborar com colegas de outros países, e o inglês é a língua que une todas essas pessoas.

Outra razão pela qual os programadores devem aprender inglês é que muitos dos principais recursos on-line de programação estão disponíveis apenas em inglês. Existem muitos fóruns de programação, tutoriais e documentações que são escritos exclusivamente em inglês. Se um programador não fala inglês, ele pode perder acesso a uma grande quantidade de informações e recursos importantes.

Por fim, a maioria das empresas de tecnologia que oferecem oportunidades de trabalho para programadores exigem conhecimentos em inglês. Se um programador não fala inglês, isso pode limitar suas opções de carreira. Muitas empresas exigem que seus funcionários falem inglês para que possam se comunicar com clientes e colegas em todo o mundo. Se um programador não fala inglês, ele pode perder oportunidades de trabalho em empresas multinacionais e grandes projetos internacionais.

Em resumo, aprender inglês é fundamental para os programadores que desejam ter sucesso em suas carreiras. Comunicação efetiva em inglês é essencial para trabalhar em equipes internacionais, colaborar com colegas de outros países, entender documentações técnicas e ter acesso a recursos on-line importantes. Além disso, a maioria das empresas de tecnologia exigem conhecimentos em inglês para contratação de funcionários. Por estas razões, é essencial para os programadores investir tempo e esforço no aprendizado da língua inglesa.

Onde aprender?

Preply é uma plataforma de educação on-line que oferece aulas particulares para todos os bolsos, em uma variedade de disciplinas, incluindo línguas, música, negócios, ciências e programação. A plataforma conecta estudantes com tutores qualificados em todo o mundo e oferece aulas sob demanda e personalizadas de acordo com as necessidades de cada aluno. A Preply é uma opção conveniente e acessível para quem busca aprimorar suas habilidades e conhecimentos em diferentes áreas.

The post Por que aprender inglês é fundamental para o sucesso em todas as carreiras appeared first on Leonardo Nascimento | Engenheiro de Software.