← Voltar aos projetos

Aplicação web

Blanco Finanças

Portal para clientes acompanharem planos de poupança e pagamentos, com uma área administrativa para gerenciar planos e fluxo de caixa.

Minha contribuiçãoDesenvolvimento full stack
TecnologiasNuxt · FastAPI · PostgreSQL · SQLAlchemy
Dashboard do cliente no Blanco Finanças com saldo, planos ativos, parcelas pendentes e histórico de pagamentos.

Duas rotinas na mesma aplicação

No Blanco Finanças, o cliente precisa consultar o saldo de seus planos de poupança, saber quais parcelas vencem a seguir e acompanhar pagamentos. A administração precisa de outra visão: clientes, catálogo de planos, entradas, saídas e saques pendentes. Desenvolvi as duas áreas com acesso aos dados pela mesma API e permissões específicas para cada perfil.

O que desenvolvi

Minha contribuição abrange o frontend em Nuxt e o backend em FastAPI, incluindo as regras financeiras e as integrações. No portal, o cliente acompanha o progresso dos planos, consulta parcelas e histórico de pagamentos e acessa a área de retiradas.

O fluxo de contratação apresenta uma recomendação de plano, detalha os custos e permite a ativação por Pix. A integração com o Mercado Pago fica no backend, que acompanha os estados das transações e recebe as confirmações de pagamento.

No painel administrativo, é possível consultar indicadores, filtrar movimentações por período e categoria, gerenciar o catálogo de planos e acessar relatórios de clientes, transações, fluxo de caixa e rendimentos.

Organização da aplicação

O frontend usa Nuxt, Vue e TypeScript, com componentes do Nuxt UI. As páginas organizam a navegação, enquanto os composables concentram o acesso à API para as telas de clientes e administradores.

No backend, o FastAPI recebe as requisições e os serviços de aplicação coordenam os casos de uso. As regras financeiras ficam em entidades e serviços de domínio, separadas dos adaptadores de serviços externos. Os dados são persistidos em PostgreSQL com SQLAlchemy assíncrono; as migrações usam Alembic.

Decisões técnicas

  • Cálculos monetários: uso centavos e Decimal no backend, com arredondamento definido no objeto de valor monetário. Isso explicita como os valores são representados e arredondados nas regras financeiras.
  • Permissões na API: a autenticação usa JWT, e as operações verificam o perfil de acesso no backend. A separação entre clientes e administradores não depende apenas das telas disponíveis.
  • Confirmações de pagamento: o backend mantém os estados das transações e trata confirmações Pix de forma idempotente, para que uma confirmação repetida não aplique a mesma operação novamente.
  • Limites das integrações: adaptadores concentram o acesso ao Mercado Pago, Banco Central, envio de email e exportação de relatórios, mantendo esses detalhes fora das regras de domínio.

O que a aplicação permite fazer

O cliente consegue acompanhar seus planos e pagamentos, enquanto a administração consulta movimentações e gerencia os planos no mesmo sistema. As duas áreas estão implementadas e são apresentadas nas telas desta página.

Em uso, a aplicação atendeu mais de 100 usuários, com três administradores simultâneos. A centralização das rotinas reduziu cerca de 30 horas de trabalho com planilhas por semana e permitiu ampliar a operação.

As capturas foram feitas na aplicação em execução local, com contas de teste e movimentações existentes. Os dados de identificação foram ocultados.

Tecnologias

Nuxt · Vue · TypeScript · Nuxt UI · FastAPI · Python · PostgreSQL · SQLAlchemy · Alembic

← Voltar aos projetos

PROJETOS E OPORTUNIDADES

Vamos conversar?

Estou disponível para projetos freelance e para integrar uma equipe de desenvolvimento.

Entre em contato