Finora
Sistema full stack para gestão financeira
Plataforma de gestão financeira para controle de contas a pagar e receber, contatos e indicadores, com processamento assíncrono, automações e ambiente Docker.

Visão geral
O projeto em perspectiva.
O Finora é uma aplicação full stack de gestão financeira desenvolvida para organizar contas a pagar e receber, contatos, vencimentos, liquidações e fechamentos financeiros em uma experiência integrada entre frontend, backend, banco de dados e processamento assíncrono.
- Objetivo
- Construir uma solução financeira organizada e confiável para registrar movimentações, acompanhar vencimentos, consolidar indicadores e automatizar tarefas que não devem bloquear as requisições da aplicação.
- Contexto
- O projeto foi estruturado como uma aplicação completa, com frontend em React, API em Laravel, persistência PostgreSQL, Redis para filas e locks, autenticação com Sanctum e ambiente Docker reproduzível.
- Tipo de projeto
- Sistema full stack
- Papel
- Arquitetura e desenvolvimento full stack
- Status
- Concluído
- Ano
- 2026
01
O que este projeto demonstra
Arquitetura full stack
Separação clara entre frontend, API, banco de dados e infraestrutura para manter responsabilidades bem definidas.
Processamento assíncrono
Uso de Jobs e filas para executar tarefas como lembretes e fechamentos financeiros sem bloquear as requisições HTTP.
Automação de tarefas
Scheduler responsável por identificar lançamentos elegíveis, disparar lembretes e reconciliar processos financeiros interrompidos.
Consistência e idempotência
Proteções para reduzir duplicidade em lembretes, fechamentos, retries e execuções concorrentes.
Persistência e infraestrutura
PostgreSQL como fonte principal de dados e Redis apoiando filas, cache e mecanismos de sincronização.
Qualidade automatizada
Cobertura dos fluxos principais com testes automatizados, lint e validações de build.
02
Meu papel
Arquitetura da solução
Definição da integração entre React, Laravel, PostgreSQL, Redis e os serviços auxiliares.
Frontend
Construção das telas de autenticação, dashboard, contatos, lançamentos e visão financeira por período.
Backend e regras de negócio
Implementação das APIs, autenticação, validações, liquidações, filtros, Jobs, Scheduler e fluxos financeiros.
Infraestrutura e qualidade
Configuração de Docker Compose, filas, Redis, Mailpit, testes automatizados e validação dos principais fluxos.
03
Funcionalidades
Autenticação de usuários
Acesso protegido à SPA utilizando Laravel Sanctum, sessão e proteção CSRF.
Gestão de contatos
Cadastro, edição e exclusão de contatos utilizados nas movimentações financeiras.
Contas a pagar e receber
Criação e acompanhamento de lançamentos com valores, vencimentos, tipo, contato e situação.
Liquidação de lançamentos
Fluxo para registrar pagamentos e recebimentos preservando o histórico financeiro.
Dashboard e visão por período
Indicadores, próximos vencimentos e consolidação financeira por intervalo de datas.
Lembretes e fechamento financeiro
Processamento assíncrono de alertas e fechamentos, com geração de CSV e envio por e-mail.
04
Galeria
Interfaces e registros visuais que ajudam a entender a experiência e os fluxos principais do projeto.

01
Dashboard financeiro
Visão consolidada com valores a receber, valores a pagar, pendências e próximos lançamentos.
Objetivo: Demonstrar como o sistema organiza indicadores financeiros e vencimentos em uma visão operacional única.

02
Gestão de lançamentos
Tela para cadastrar, consultar, editar, liquidar e excluir contas a pagar e receber.
Objetivo: Demonstrar o fluxo principal de gestão financeira, incluindo status, valores, vencimentos e vínculos com contatos.

03
Visão do período
Consulta financeira por intervalo de datas, com totais de contas abertas, liquidadas e vencidas.
Objetivo: Demonstrar filtros temporais, consolidação de valores e o fluxo de fechamento financeiro do período.

04
Gestão de contatos
Cadastro e manutenção dos contatos utilizados nos lançamentos financeiros.
Objetivo: Demonstrar a organização de clientes e fornecedores relacionados às movimentações do sistema.

05
Autenticação
Fluxo de acesso à aplicação utilizando autenticação protegida.
Objetivo: Demonstrar a entrada segura na SPA antes do acesso aos recursos financeiros.
05
Arquitetura
React
Interface, navegação e experiência de uso do sistema.
Laravel
API REST, autenticação, regras de negócio, Jobs, Scheduler e integração com dados.
PostgreSQL
Persistência relacional de usuários, contatos, lançamentos e fechamentos.
Elementos complementares
- Redis
- Laravel Sanctum
- Queues
- Scheduler
- Mailpit
- Docker
06
Stack técnica
Frontend
- React
- TypeScript
- Vite
- Axios
Backend
- PHP
- Laravel
- Laravel Sanctum
- API REST
Banco de dados
- PostgreSQL
- SQLite para testes
Infraestrutura
- Docker
- Docker Compose
- Redis
- Laravel Queues
- Laravel Scheduler
- Mailpit
Qualidade
- PHPUnit
- Laravel Pint
- Oxlint
- TypeScript
- Testes de integração
07
Decisões técnicas
Processamento assíncrono com filas
Operações potencialmente demoradas são enviadas para filas para não bloquear as requisições HTTP.
PostgreSQL como fonte de verdade
Os estados dos processos financeiros permanecem persistidos no banco, enquanto Redis atua como infraestrutura auxiliar.
Atraso como estado derivado
Uma conta é considerada vencida a partir do status pendente e da data de vencimento, evitando duplicação desnecessária de estado.
Idempotência e retries
Jobs e registros persistentes ajudam a evitar reprocessamentos duplicados e permitem recuperação de falhas temporárias.
Docker como ambiente oficial
Os serviços da aplicação são executados de forma reproduzível por Docker Compose.
08
Aprendizados
- Construção de uma aplicação financeira full stack com frontend e backend desacoplados.
- Uso de filas, Jobs, Scheduler e Redis em fluxos reais de processamento assíncrono.
- Aplicação de idempotência, retries e reconciliação em processos financeiros.
- Integração entre autenticação SPA, PostgreSQL, Redis, e-mail e infraestrutura Docker.
- Criação de testes automatizados para fluxos críticos de negócio.
09
Resultado
O resultado é uma aplicação financeira full stack funcional e testada, com autenticação, gestão de contatos, contas a pagar e receber, liquidação, indicadores, automações e processamento assíncrono em um ambiente Docker reproduzível.
- Frontend React integrado à API Laravel
- Persistência relacional com PostgreSQL
- Redis, filas e Scheduler para automações
- Fechamentos com CSV e envio por e-mail
- 66 testes automatizados com 232 assertions
- Ambiente Docker reproduzível
10
Links
Acesse os recursos públicos disponíveis para conhecer melhor o projeto.
Próximo passo
Vamos construir algo juntos?
Estou disponível para oportunidades profissionais, projetos e conversas sobre desenvolvimento de software.
Entrar em contato