Skip to content

DocCaio/BancoSim

Repository files navigation

🏦 BancoSim

Simulador bancário desenvolvido com Next.js, TypeScript e Tailwind CSS, permitindo depósitos, saques, simulação/contratação de empréstimos e acompanhamento de histórico financeiro — tudo em uma interface moderna com tema escuro.

Next.js TypeScript TailwindCSS Zustand


✨ Funcionalidades

  • Dashboard — Visão geral do saldo, estatísticas e acesso rápido às demais telas
  • Depósito / Saque — Movimentação de conta com validação de formulário
  • Empréstimo — Simulação com valor, parcelas e taxa de juros, com opção de contratação
  • Histórico — Listagem de todas as transações e empréstimos, com filtros por categoria
  • NavBar persistente — Presente em todas as rotas via layout.tsx, exibindo o saldo em tempo real

🛠️ Tecnologias

Categoria Stack
Framework Next.js (App Router)
Linguagem TypeScript
Estilização Tailwind CSS
Componentes UI shadcn/ui
Gerenciamento de estado Zustand
Formulários React Hook Form + Zod
Ícones Lucide React
Datas date-fns (locale pt-BR)

📂 Estrutura do projeto

app/
├── layout.tsx          # Layout raiz com NavBar global
├── page.tsx             # Dashboard (Home)
├── transacao/
│   └── page.tsx          # Depósito e saque
├── emprestimo/
│   └── page.tsx          # Simulação e contratação de empréstimo
└── historico/
    └── page.tsx          # Histórico de transações

components/
└── NavBar.tsx           # Barra de navegação fixa

store/
└── bancoStore.ts        # Estado global (Zustand): saldo, transações, empréstimos

🚀 Como rodar o projeto

# Clonar o repositório
git clone https://github.com/seu-usuario/bancosim.git
cd bancosim

# Instalar dependências
npm install

# Rodar em modo desenvolvimento
npm run dev

Acesse http://localhost:3000 no navegador.


🧮 Como funciona a simulação de empréstimo

O cálculo da parcela utiliza o sistema de amortização Price, com a fórmula:

PMT = (VP × i × (1 + i)^n) / ((1 + i)^n - 1)

Onde:

  • VP = valor solicitado
  • i = taxa de juros mensal (decimal)
  • n = número de parcelas

📌 Roadmap

  • Autenticação de usuário
  • Persistência dos dados (atualmente em memória via Zustand)
  • Exportação do histórico em PDF/CSV
  • Gráficos de evolução do saldo
  • Modo responsivo completo (menu mobile)

📄 Licença

Este projeto é livre para fins de estudo e portfólio.


Desenvolvido por Caio 🚀

About

BancoSim é uma aplicação web que simula operações bancárias básicas: depósito, saque, consulta de saldo e simulação de empréstimos com cálculo de parcelas. Desenvolvido com Next.js, TypeScript, Zustand para gerenciamento de estado e shadcn/ui para interface.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors