💰 Bolso Inteligente

Sistema de Gerenciamento Financeiro Pessoal

Um sistema web completo e moderno para controle de gastos pessoais, desenvolvido com foco na experiência do usuário e funcionalidades avançadas.

🚀 Demonstração

O Bolso Inteligente é uma aplicação web responsiva que permite o controle completo das suas finanças pessoais de forma intuitiva e eficiente.

📋 Funcionalidades Principais

• ✅ Dashboard Financeiro: Visão geral de receitas, despesas e saldo
• ✅ Gestão de Transações: Adicionar, editar e excluir receitas e despesas
• ✅ Categorização: Organização por categorias personalizáveis
• ✅ Relatórios Detalhados: Gráficos e análises financeiras
• ✅ Tipos de Pagamento: Suporte a múltiplas formas de pagamento
• ✅ Backup e Restauração: Exportação/importação de dados
• ✅ Modo Escuro/Claro: Interface adaptável
• ✅ Multilíngue: Português, Inglês e Espanhol
• ✅ Design Responsivo: Funciona em desktop, tablet e mobile

🛠️ Tecnologias Utilizadas

Frontend

• HTML5: Estrutura semântica moderna
• CSS3: Estilização avançada com CSS Grid e Flexbox
• JavaScript ES6+: Funcionalidades interativas e dinâmicas
• Local Storage: Persistência de dados no navegador

Arquitetura

• Modular: Código organizado em módulos especializados
• Responsivo: Design mobile-first
• PWA Ready: Preparado para Progressive Web App
• Cross-browser: Compatível com navegadores modernos

📁 Estrutura do Projeto

GERENCIAR GASTOS/
├── index.html                 # Página principal (Dashboard)
├── assets/                    # Recursos estáticos
│   ├── css/                   # Folhas de estilo
│   │   ├── index.css         # Estilos globais e temas
│   │   ├── dashboard.css     # Estilos do dashboard
│   │   ├── transacoes.css    # Estilos das transações
│   │   ├── categorias.css    # Estilos das categorias
│   │   ├── relatorios.css    # Estilos dos relatórios
│   │   ├── configuracoes.css # Estilos das configurações
│   │   └── contrate.css      # Estilos da página de contato
│   ├── js/                    # Scripts JavaScript
│   │   ├── utils.js          # Utilitários e helpers
│   │   ├── storage.js        # Gerenciamento de dados
│   │   ├── i18n.js           # Sistema de internacionalização
│   │   ├── navigation.js     # Navegação e menus
│   │   ├── dashboard.js      # Lógica do dashboard
│   │   ├── transacoes.js     # Gerenciamento de transações
│   │   ├── categorias.js     # Gerenciamento de categorias
│   │   ├── relatorios.js     # Geração de relatórios
│   │   ├── configuracoes.js  # Configurações do sistema
│   │   └── contrate.js       # Página de contato
│   └── img/                   # Imagens e ícones
│       ├── logo.svg          # Logo principal
│       ├── logo-header.svg   # Logo do cabeçalho
│       └── favicon/          # Favicons para diferentes dispositivos
├── templates/                 # Páginas HTML
│   ├── transacoes.html       # Gestão de transações
│   ├── categorias.html       # Gestão de categorias
│   ├── relatorios.html       # Relatórios e gráficos
│   ├── configuracoes.html    # Configurações do sistema
│   ├── contrate.html         # Página de contato/contratação
│   └── include/              # Componentes reutilizáveis
│       ├── header.html       # Cabeçalho com navegação
│       ├── footer.html       # Rodapé
│       └── sidebar.html      # Barra lateral (se aplicável)
└── data/                      # Dados e configurações
    └── (arquivos de dados)

🚀 Como Executar

Pré-requisitos

• Navegador web moderno (Chrome, Firefox, Safari, Edge)
• Servidor web local (opcional, mas recomendado)

Instalação

1. Clone ou baixe o projeto

   git clone [url-do-repositorio]
   cd GERENCIAR\ GASTOS

2. Opção 1: Servidor local (recomendado)

   # Python 3
   python -m http.server 8000
   
   # Node.js (se tiver live-server instalado)
   npx live-server
   
   # PHP
   php -S localhost:8000

3. Opção 2: Abrir diretamente

   • Abra o arquivo index.html no navegador
   • ⚠️ Algumas funcionalidades podem ter limitações

4. Acesse a aplicação

   http://localhost:8000
   

📖 Guia de Uso

1. Dashboard

• Visão Geral: Resumo financeiro com receitas, despesas e saldo atual
• Ações Rápidas: Botões para adicionar nova receita ou despesa
• Transações Recentes: Lista das últimas movimentações

2. Transações

• Adicionar: Registre receitas e despesas com descrição, valor, categoria e tipo de pagamento
• Filtrar: Use filtros por tipo, categoria, período e forma de pagamento
• Editar/Excluir: Gerencie transações existentes

3. Categorias

• Personalizar: Crie categorias específicas para suas necessidades
• Organizar: Mantenha suas finanças organizadas por tipo de gasto

4. Relatórios

• Análises: Visualize gráficos de receitas vs despesas
• Tendências: Acompanhe a evolução financeira ao longo do tempo
• Exportar: Gere relatórios para análise externa

5. Configurações

• Tema: Alterne entre modo claro e escuro
• Idioma: Escolha entre Português, Inglês e Espanhol
• Backup: Exporte/importe seus dados

🌐 Funcionalidades Avançadas

Sistema de Temas

• Modo Claro: Interface clara e limpa
• Modo Escuro: Redução do cansaço visual
• Adaptação Automática: Respeita preferências do sistema

Internacionalização (i18n)

• Português (BR): Idioma padrão
• English (US): Tradução completa
• Español (ES): Tradução completa
• Dinâmico: Mudança instantânea sem recarregar

Design Responsivo

• Mobile First: Otimizado para dispositivos móveis
• Breakpoints: Adaptação para tablet e desktop
• Touch Friendly: Interface amigável ao toque

💾 Persistência de Dados

O sistema utiliza Local Storage para armazenar dados localmente no navegador:

• ✅ Transações: Histórico completo de movimentações
• ✅ Categorias: Configurações personalizadas
• ✅ Preferências: Tema, idioma e configurações
• ✅ Backup: Exportação em formato JSON

🎨 Paleta de Cores

Modo Claro

• Primária: #2563eb (Azul)
• Sucesso: #16a34a (Verde)
• Perigo: #dc2626 (Vermelho)
• Fundo: #ffffff (Branco)
• Texto: #1f2937 (Cinza escuro)

Modo Escuro

• Primária: #3b82f6 (Azul claro)
• Sucesso: #34d399 (Verde claro)
• Perigo: #f87171 (Vermelho claro)
• Fundo: #0f172a (Azul escuro)
• Texto: #f8fafc (Branco)

🤝 Contribuição

Este projeto foi desenvolvido como uma solução completa de gerenciamento financeiro. Para sugestões ou melhorias:

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

👨‍💻 Desenvolvedor

FG DEVS

• 📧 Email: fabianogz.dev@gmail.com
• 🌐 Portfolio: fabianogz.github.io/portfolio
• 💼 LinkedIn: linkedin.com/in/fgdevs
• 🐙 GitHub: @fabianogz

📋 Changelog

v1.0.0 (Atual)

• ✅ Sistema completo de gerenciamento financeiro
• ✅ Interface responsiva e moderna
• ✅ Suporte a múltiplos idiomas
• ✅ Modo claro/escuro
• ✅ Sistema de backup e restauração
• ✅ Relatórios e análises
• ✅ Categorização avançada
• ✅ Tipos de pagamento

🔮 Próximas Funcionalidades

• 📊 Mais tipos de gráficos e relatórios
• 🔔 Sistema de notificações e lembretes
• 💱 Suporte a múltiplas moedas
• 📱 Progressive Web App (PWA)
• ☁️ Sincronização em nuvem
• 🎯 Metas e objetivos financeiros

---

⭐ Se este projeto foi útil para você, considere dar uma estrela!

💡 Sugestões e feedback são sempre bem-vindos!