simple-bank-web-app

---

📌 Sobre

Mag Bank é um sistema bancário fictício, modular e escalável, com autenticação JWT, gerenciamento de transações e uma interface responsiva construída com React e TailwindCSS. A aplicação simula operações financeiras como cadastro de usuários, login, e transações, utilizando o JSON Server para API local.

---

🚀 Começando

Siga os passos abaixo para rodar o projeto em sua máquina local.

Pré-requisitos

Certifique-se de ter instalado:

• Node.js (v16 ou superior)
• npm ou yarn

Configuração do aambiente

1. Clone o repositório:

   git clone https://github.com/washingtonjnr/simple-bank-web-app.git
   cd mag-bank
   

2. Instale as dependências do projeto:

   npm install
   

3. Inicie o ambiente de desenvolvimento completo (Frontend + API):

   npm run dev:full
   

4. Acesse a aplicação no navegador:

• Frontend: http://localhost:5173
• Fake API (JSON Server): http://localhost:3001

---

📂 Estrutura do projeto

A aplicação segue uma arquitetura modular, organizada em:

• Components: Componentes reutilizáveis.
• Pages: Telas principais da aplicação.
• Services: Conexão com a API (axios).
• Hooks: Lógica compartilhada (como formulários e estados).
• Utils: Funções auxiliares.
• Types: Tipos e interfaces para garantir tipagem estática.

---

🛡️ Autenticação e segurança

A autenticação é gerenciada com JSON Server Auth, oferecendo suporte a rotas protegidas com JWT. Para acessar áreas restritas, é necessário realizar login e obter um token de autenticação.