💰 FinCLI - Controle Financeiro Pessoal

Versão: 1.0.0

🎯 Sobre o Projeto

O Problema (Dor Real): A falta de previsibilidade e organização financeira do dia a dia leva muitas pessoas a perderem o controle de seus gastos, dificultando o planejamento e causando estresse.

A Solução: O FinCLI é uma aplicação de linha de comando (CLI) simples e direta que permite registrar receitas e despesas rapidamente, gerando um extrato e calculando o saldo atual.

Público-alvo: Jovens adultos, estudantes e profissionais que buscam um controle financeiro rápido e sem a complexidade de planilhas pesadas ou aplicativos cheios de anúncios.

🛠 Tecnologias Utilizadas

| Categoria | Tecnologia | |------------------|---------------------| | Linguagem | JavaScript (Node.js) | | Interface | CLI (readline-sync) | | Testes | Jest | | Qualidade | ESLint | | CI/CD | GitHub Actions |

⚙️ Como Executar

1. Instalação

Certifique-se de ter o Node.js instalado. Clone o repositório e instale as dependências:

git clone https://github.com/Trindaddy/controle-financeiro-cli.git
cd controle-financeiro-cli
npm install

2. Execução

Para iniciar o sistema e acessar o menu interativo:

npm start

3. Testes e Lint

# Executa os testes automatizados (caminho feliz, fluxos alternativos e erros)
npm test

# Executa a verificação estática do código
npm run lint

🚀 Aplicação Publicada (Deploy)

Acesse e rode o projeto diretamente na nuvem: Clique aqui para rodar no CodeSandBox

👨‍💻 Autor

Desenvolvido por Abner Trindade para o Bootcamp.

🔗 github.com/Trindaddy/controle-financeiro-cli