Skip to content

elielroberto/ControleFinanceiro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

Controle Financeiro

Aplicação web completa para controle financeiro pessoal, desenvolvida com foco em organização de gastos, entendimento de fluxo de dinheiro e aprendizado prático de desenvolvimento fullstack.


Sobre o projeto

Este projeto nasceu de uma necessidade real:

Eu precisava organizar melhor minhas contas pessoais.

Ao mesmo tempo, eu estava em um momento intenso de estudos em desenvolvimento, então decidi unir o útil ao necessário:

  • Criar uma solução para minha vida financeira
  • E ao mesmo tempo evoluir tecnicamente na prática

Ou seja: não é um projeto genérico, é algo construído com base em um problema real.


Tecnologias utilizadas

Backend

  • ASP.NET Core
  • Entity Framework Core
  • SQL Server
  • JWT Authentication

Frontend

  • React (Vite)
  • Axios
  • CSS customizado (tema dark)
  • Tailwind

Conceito principal do sistema

O sistema não trabalha apenas com "valores", mas com tempo e fluxo financeiro.

Regra central:

Transação = intenção
Parcela = realidade

Exemplo

Entrada:

Salário: 3000

→ vira:

1 parcela de 3000

Despesa parcelada:

10x de 150

→ vira:

10 parcelas de 150 (uma por mês)

Isso permite:

  • Balancete real por mês
  • Controle de fluxo futuro
  • Simulação de faturas
  • Entendimento financeiro real

Funcionalidades

Entradas

  • Cadastro de salário
  • Cadastro de entradas diversas
  • Suporte a valores extras (hora extra)

Despesas

  • Cadastro de despesas

  • Parcelamento

  • Suporte a pagamento:

    • Dinheiro
    • Cartão

Cartões

  • Cadastro de cartões
  • Controle de fechamento
  • Controle de vencimento

Balancete

  • Entradas do mês
  • Saídas do mês
  • Saldo acumulado
  • Histórico detalhado

Estrutura do projeto

ControleFinanceiro/
│
├── Backend/
│   ├── Controllers/
│   ├── Services/
│   ├── Repositories/
│   ├── Models/
│   ├── DTOs/
│   └── Program.cs
│
├── Frontend/
│   ├── pages/
│   ├── services/
│   ├── styles/
│   └── components/

Arquitetura

O projeto segue uma separação clara de responsabilidades:

Controller

Responsável por receber as requisições

Service

Contém a regra de negócio

Repository

Acesso ao banco de dados

DTO

Controle do que entra e sai da API


Fluxo de funcionamento

Frontend → Controller → Service → Repository → Banco

Decisões importantes

Uso de parcelas

Permite representar o dinheiro ao longo do tempo

DTO

Evita exposição direta das entidades

Service Layer

Centraliza regras de negócio

JWT

Autenticação segura


Aprendizados com o projeto

Durante o desenvolvimento, foram explorados conceitos importantes como:

  • Arquitetura em camadas
  • Relacionamento 1:N no EF Core
  • Manipulação de datas financeiras
  • Separação de responsabilidades
  • Debug de fluxo real (frontend + backend)
  • Construção de API REST completa

Objetivo do projeto

Mais do que um sistema, esse projeto representa:

Evolução técnica Aplicação prática de conhecimento Resolução de um problema pessoal real


Próximos passos

  • Dashboard com gráficos
  • Controle de limite do cartão
  • Calendário financeiro
  • Melhorias de UX/UI

Autor

Desenvolvido por Eliel Roberto

Projeto criado com propósito real + aprendizado prático


About

Este projeto foi desenvolvido a partir de uma necessidade pessoal de organizar minhas finanças, aliado ao meu momento de estudos em desenvolvimento de software.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages