Skip to content

mobile-dev-ufes/2025-2-proj-final-FinAssistent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FinAssistent 💰📊

Android • Kotlin • XML • Room • MVVM • GitHub


📌 Sobre o Projeto

O FinAssistent é um aplicativo Android desenvolvido para auxiliar no controle financeiro pessoal, permitindo que o usuário registre, visualize e analise seus gastos e rendas mensais de forma simples e organizada.

A aplicação funciona offline, utilizando banco de dados local para armazenar todas as informações do usuário, garantindo simplicidade e independência de conexão com a internet.


🎯 Objetivos

  • ✅ Permitir o registro de gastos e rendas de forma prática
  • ✅ Diferenciar despesas fixas e variáveis
  • ✅ Organizar gastos por categorias
  • ✅ Controlar o pagamento de gastos fixos
  • ✅ Exibir relatórios mensais consolidados
  • ✅ Funcionar totalmente offline

🚀 Funcionalidades Principais

  • 🔹 Cadastro de Gastos (categoria, tipo, valor, data e observações)
  • 🔹 Diferenciação entre gastos Fixos e Variáveis
  • 🔹 Controle de pagamento de gastos fixos
  • 🔹 Registro de renda mensal fixa
  • 🔹 Registro de rendas extras
  • 🔹 Listagem de gastos pagos no mês
  • 🔹 Cálculo automático de totais mensais
  • 🔹 Indicador de comprometimento da renda
  • 🔹 Resumo mensal com saldo positivo ou negativo
  • 🔹 Suporte a internacionalização (Português 🇧🇷 / Inglês 🇺🇸)

🛠️ Tecnologias Utilizadas

  • Linguagem: Kotlin ☕
  • IDE: Android Studio 🛠️
  • Interface: XML 🎨
  • Arquitetura: MVVM
  • Banco de Dados Local: Room (SQLite) 🗄️
  • Persistência: DAO + Entities
  • Componentes: Navigation Component, RecyclerView
  • Gráficos: MPAndroidChart 📊
  • Versionamento: Git & GitHub 🖥️

📐 Arquitetura do Projeto

O FinAssistent segue o padrão arquitetural MVVM (Model-View-ViewModel), garantindo separação de responsabilidades e melhor organização do código.

📱 Camada de Interface (UI)

  • Activities / Fragments
  • RecyclerView + Adapters
  • XML Layouts

🧠 Camada de Lógica (ViewModel)

  • Regras de negócio
  • Processamento de dados mensais
  • Agrupamento de gastos por categoria
  • Cálculos de totais e saldo

🗄️ Camada de Dados (Model)

  • Room Database
  • Entities
  • DAOs
  • Repositories

🌎 Internacionalização

O aplicativo suporta múltiplos idiomas através do uso de:

  • res/values/strings.xml (Português)
  • res/values-en/strings.xml (Inglês)

Textos como:

  • Categoria / Category
  • Tipo / Type
  • Fixo / Fixed
  • Variável / Variable

São traduzidos automaticamente conforme o idioma do dispositivo.


📊 Estrutura de Funcionalidades Financeiras

O aplicativo permite:

  • Filtrar gastos por mês
  • Separar despesas fixas e variáveis
  • Controlar pagamento de despesas fixas
  • Exibir apenas gastos pagos no resumo
  • Agrupar despesas variáveis por categoria
  • Calcular automaticamente:
    • Total de rendas
    • Total de gastos pagos
    • Saldo mensal
    • Percentual de comprometimento

📱 Telas da Aplicação

  • 🏠 Dashboard Financeiro (Resumo Geral)
  • 📋 Lista de Gastos
  • ➕ Cadastro de Gasto
  • 📌 Controle de Gastos Fixos
  • 📊 Resumo Mensal
  • ⚙️ Configurações Financeiras

🎥 Vídeo de Demonstração

Para visualizar o funcionamento completo do aplicativo, assista ao vídeo de apresentação no link abaixo:

🔗 https://youtu.be/T9TYSdq0D3o

O vídeo demonstra as principais funcionalidades, navegação entre telas e o resumo financeiro mensal do FinAssistent.


📲 Como Executar o Projeto

  1. Clone o repositório:
git clone https://github.com/seu-usuario/finassistent.git
  1. Abra no Android Studio
  2. Execute em um emulador ou dispositivo físico

⚠ Não é necessário configurar Firebase ou conexão com internet. O aplicativo utiliza banco de dados local (Room).

📌 Implementações Futuras

🔹 Exportação de relatório em PDF

🔹 Metas financeiras personalizadas

🔹 Modo escuro

🔹 Backup opcional na nuvem

🔹 Comparação automática entre meses


📄 Licença

Este projeto é de código aberto e pode ser utilizado para fins acadêmicos e sociais.
Consulte os termos da licença para mais detalhes.


📧 Contato

Para dúvidas, sugestões ou melhorias relacionadas ao projeto, entre em contato com os desenvolvedores.


👩‍💻 Desenvolvido por

Marcus Louriçal Neves Filho

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages