TrabalhoDeLP
/
Trabalho_de_LP
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Trabalho_de_LP/README.md

8.6 KiB
Raw Blame History

💰 Gestão de Despesas - Aplicação Android com SQLite

Uma aplicação Android moderna para gestão pessoal de despesas, desenvolvida com SQLite para armazenamento local de dados e interface Material Design.

🎯 Funcionalidades Implementadas

✅ Funcionalidades Principais

  • 💰 Adicionar Despesas: Registre novas despesas com descrição, valor, categoria, data e notas
  • 📋 Listar Despesas: Visualize todas as despesas em uma lista organizada e moderna
  • ✏️ Editar Despesas: Modifique informações de despesas existentes
  • 🗑️ Excluir Despesas: Remova despesas com confirmação de segurança
  • 📊 Estatísticas: Visualize o valor total gasto e número de despesas
  • 🏷️ Categorização: Organize despesas por categorias personalizadas
  • 🎨 Interface Moderna: Design Material Design com gradientes e animações

✅ Funcionalidades Avançadas

  • 📱 Dashboard Principal: Tela de boas-vindas com estatísticas em tempo real
  • 🔍 Filtros: Filtre despesas por categoria
  • 📈 Estatísticas Visuais: Cards com métricas importantes
  • 🎯 Navegação Intuitiva: Botões e ações bem organizados
  • 🛡️ Tratamento de Erros: Aplicação robusta que não fecha com erros

🏗️ Arquitetura do Projeto

📱 Activities (Telas)

  • MainActivity.java: Tela principal com dashboard e estatísticas
  • SimpleExpensesActivity.java: Lista simplificada de despesas
  • AddExpenseActivity.java: Formulário para adicionar/editar despesas

🗄️ Banco de Dados

  • DatabaseHelper.java: Gerenciador completo do SQLite
  • Expense.java: Modelo de dados para despesas

🎨 Interface

  • ExpenseAdapter.java: Adapter para RecyclerView
  • Layouts XML: Design moderno com Material Design

🗄️ Banco de Dados SQLite

📊 Tabela: expenses

Campo Tipo Descrição Obrigatório
id INTEGER Chave primária (auto incremento) ✅
description TEXT Descrição da despesa ✅
amount REAL Valor da despesa ✅
category TEXT Categoria da despesa ✅
date TEXT Data da despesa (DD/MM/AAAA) ✅
notes TEXT Notas adicionais ❌

🔧 Operações do DatabaseHelper

// Operações CRUD+wsqzxe
addExpense(Expense)           // Adiciona nova despesa
getAllExpenses()              // Retorna todas as despesas
getExpense(int id)            // Retorna despesa específica
updateExpense(Expense)        // Atualiza despesa existente
deleteExpense(int id)         // Remove despesa

// Consultas personalizadas
getTotalExpenses()            // Calcula total de despesas
getExpensesByCategory(String) // Filtra por categoria

🎨 Design e Interface

🎯 Paleta de Cores

  • Primária: Azul moderno (#6366F1)
  • Secundária: Azul claro (#A5B4FC)
  • Acento: Laranja (#F59E0B)
  • Sucesso: Verde (#10B981)
  • Erro: Vermelho (#EF4444)GREA

🎨 Elementos Visuais

  • Gradientes: Fundos com transições suaves
  • Cards: Design Material com sombras e bordas arredondadas
  • Ícones: SVG otimizados para cada função
  • Animações: Transições suaves entre telas

📱 Como Usar a Aplicação

🚀 Primeiro Uso

  1. Abrir a aplicação → Vê a tela de boas-vindas
  2. Ver estatísticas → Total gasto e número de despesas
  3. Clicar "Começar Agora" → Vai para adicionar primeira despesa

💰 Gerenciar Despesas

  1. Adicionar: Botão "+" ou "Adicionar" → Formulário completo
  2. Preencher: Descrição, valor, categoria, data, notas
  3. Salvar: Confirma e retorna à tela anterior
  4. Ver Lista: Botão "Ver Despesas" → Lista completa

✏️ Editar/Excluir

  1. Na Lista: Cada despesa tem botões "Editar" e "Excluir"
  2. Editar: Abre o formulário com dados preenchidos
  3. Excluir: Confirmação de segurança antes de remover

🛠️ Tecnologias Utilizadas

  • 📱 Android SDK: Desenvolvimento nativo Android
  • 🗄️ SQLite: Banco de dados local persistente
  • 🎨 Material Design: Interface moderna e responsiva
  • 📋 RecyclerView: Lista otimizada para performance
  • ☕ Java: Linguagem de programação
  • 🎨 Gradientes: Design visual atrativo

📋 Requisitos do Sistema

  • Android: API 24+ (Android 7.0 Nougat)
  • Android Studio: Última versão estável
  • Gradle: 8.13+
  • Java: JDK 11+

🚀 Instalação e Execução

📥 Instalação

# 1. Clone o repositório
git clone [url-do-repositorio]

# 2. Abra no Android Studio
# 3. Sincronize o Gradle
# 4. Execute no emulador ou dispositivo

🔧 Compilação

# Compilar APK de debug
./gradlew assembleDebug

# Executar testes
./gradlew test

📁 Estrutura de Arquivos

app/src/main/
├── java/pt/epvc/gestodedespesas/
│   ├── MainActivity.java              # Tela principal com dashboard
│   ├── SimpleExpensesActivity.java    # Lista simplificada de despesas
│   ├── AddExpenseActivity.java        # Formulário de adicionar/editar
│   ├── Expense.java                   # Modelo de dados
│   ├── DatabaseHelper.java            # Gerenciador SQLite
│   └── ExpenseAdapter.java            # Adapter do RecyclerView
│
├── res/layout/
│   ├── activity_main.xml              # Layout da tela principal
│   ├── activity_simple_expenses.xml   # Layout da lista de despesas
│   ├── activity_add_expense.xml       # Layout do formulário
│   └── item_expense.xml               # Layout do item da lista
│
├── res/drawable/                      # Ícones e recursos visuais
├── res/values/
│   ├── colors.xml                     # Paleta de cores
│   └── strings.xml                    # Textos da aplicação
└── AndroidManifest.xml                # Configuração da aplicação

🔧 Funcionalidades Técnicas

🛡️ Tratamento de Erros

  • Try-Catch: Em todas as operações críticas
  • Verificações de Null: Para evitar crashes
  • Mensagens Informativas: Toast para feedback do usuário
  • Fallback Seguro: Aplicação continua funcionando mesmo com erros

📊 Performance

  • RecyclerView: Lista otimizada para grandes quantidades de dados
  • SQLite: Consultas eficientes com índices
  • Lazy Loading: Carregamento sob demanda
  • Memory Management: Gerenciamento eficiente de memória

🎨 Design Responsivo

  • Material Design: Seguindo guidelines do Google
  • Adaptação: Funciona em diferentes tamanhos de tela
  • Acessibilidade: Elementos grandes e bem contrastados
  • Navegação: Fluxo intuitivo entre telas

🚀 Próximas Funcionalidades

📊 Análises e Relatórios

  • Gráficos de gastos por categoria
  • Relatórios mensais/anuais
  • Comparativos entre períodos
  • Exportação para PDF/Excel

🔍 Filtros Avançados

  • Filtro por período de datas
  • Busca por texto na descrição
  • Ordenação por valor, data, categoria
  • Filtros salvos

💾 Backup e Sincronização

  • Backup automático na nuvem
  • Sincronização entre dispositivos
  • Restauração de dados
  • Exportação/importação

🎨 Personalização

  • Modo escuro/claro
  • Temas personalizados
  • Categorias customizáveis
  • Widget para tela inicial

📝 Notas de Desenvolvimento

🎯 Decisões de Design

  • Interface Simplificada: Foco na usabilidade
  • Material Design: Consistência visual
  • SQLite Local: Privacidade e performance
  • Tratamento de Erros: Robustez da aplicação

🔧 Implementações Técnicas

  • DatabaseHelper: Padrão Singleton para acesso ao banco
  • Serializable: Passagem de objetos entre Activities
  • RecyclerView: Performance otimizada para listas
  • Material Components: Interface moderna e acessível

📱 Compatibilidade

  • Android 7.0+: Suporte amplo de dispositivos
  • Edge-to-Edge: Design moderno
  • Responsive: Adapta-se a diferentes telas
  • Acessibilidade: Suporte a leitores de tela

👨‍💻 Desenvolvido com ❤️

Esta aplicação foi desenvolvida como um exemplo completo de aplicação Android com SQLite, demonstrando:

  • Arquitetura limpa e organizada
  • Interface moderna e responsiva
  • Tratamento robusto de erros
  • Documentação completa em português
  • Código bem comentado e explicado

Tecnologias: Android SDK, SQLite, Material Design, Java Design: Interface moderna com gradientes e animações Funcionalidades: CRUD completo, estatísticas, filtros, navegação intuitiva