{"id":29181967,"url":"https://github.com/jeffinp/gestao_financeira","last_synced_at":"2026-04-09T17:54:28.825Z","repository":{"id":301592132,"uuid":"995074916","full_name":"Jeffinp/gestao_financeira","owner":"Jeffinp","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-27T16:43:44.000Z","size":524,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-27T17:41:28.579Z","etag":null,"topics":["dashboard","data-visualization","expense-tracker","finance","fintech","frontend","personal-finance","react","responsive-design","tailwindcss","vite","zustand"],"latest_commit_sha":null,"homepage":"https://gestao-financeira-three.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jeffinp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-02T23:44:43.000Z","updated_at":"2025-06-27T16:43:47.000Z","dependencies_parsed_at":"2025-06-27T17:41:30.385Z","dependency_job_id":"09d0973b-dd3d-4c48-b3cc-164b32811bb3","html_url":"https://github.com/Jeffinp/gestao_financeira","commit_stats":null,"previous_names":["jeffinp/gestao_financeira"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Jeffinp/gestao_financeira","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeffinp%2Fgestao_financeira","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeffinp%2Fgestao_financeira/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeffinp%2Fgestao_financeira/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeffinp%2Fgestao_financeira/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jeffinp","download_url":"https://codeload.github.com/Jeffinp/gestao_financeira/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeffinp%2Fgestao_financeira/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263029215,"owners_count":23402354,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dashboard","data-visualization","expense-tracker","finance","fintech","frontend","personal-finance","react","responsive-design","tailwindcss","vite","zustand"],"created_at":"2025-07-01T20:02:03.476Z","updated_at":"2025-12-30T22:19:09.638Z","avatar_url":"https://github.com/Jeffinp.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MeuCofre – Sistema de Gestão Financeira Pessoal\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"public/images/icons/apple-icon-180x180.png\" width=\"120\" alt=\"MeuCofre logo\" /\u003e\n  \n  \u003ch3 align=\"center\"\u003eOrganize suas finanças, transforme seu futuro 💰\u003c/h3\u003e\n  \n  \u003cp align=\"center\"\u003e\n    \u003cstrong\u003eUm sistema moderno e intuitivo para controle financeiro pessoal\u003c/strong\u003e\n  \u003c/p\u003e\n  \n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/Jeffinp/MeuCofre/issues\"\u003eReportar Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/Jeffinp/MeuCofre/issues\"\u003eSugerir Feature\u003c/a\u003e\n    ·\n    \u003ca href=\"#-demo\"\u003eVer Demo\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \n  ![React](https://img.shields.io/badge/React-19-61DAFB?style=for-the-badge\u0026logo=react\u0026logoColor=white)\n  ![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)\n  ![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3.0+-38BDF8?style=for-the-badge\u0026logo=tailwindcss\u0026logoColor=white)\n  ![Vite](https://img.shields.io/badge/Vite-5.0+-646CFF?style=for-the-badge\u0026logo=vite\u0026logoColor=white)\n  \n  ![GitHub Stars](https://img.shields.io/github/stars/Jeffinp/MeuCofre?style=for-the-badge)\n  ![GitHub Issues](https://img.shields.io/github/issues/Jeffinp/MeuCofre?style=for-the-badge)\n  ![License](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)\n  \n\u003c/div\u003e\n\n---\n\n## 📋 Índice\n\n- [Sobre o Projeto](#-sobre-o-projeto)\n- [Demo](#-demo)\n- [Features](#-features)\n- [Screenshots](#-screenshots)\n- [Tecnologias](#-tecnologias)\n- [Arquitetura](#-arquitetura)\n- [Instalação](#-instalação)\n- [Como Usar](#-como-usar)\n- [Roadmap](#-roadmap)\n- [Contribuindo](#-contribuindo)\n- [Autores](#-autores)\n- [Licença](#-licença)\n- [Agradecimentos](#-agradecimentos)\n\n---\n\n## 🎯 Sobre o Projeto\n\nO **MeuCofre** nasceu da necessidade de transformar a maneira como gerenciamos nossas finanças pessoais. Em um mundo onde o controle financeiro é essencial, criamos uma ferramenta que não apenas registra transações, mas proporciona insights valiosos sobre seus hábitos financeiros.\n\n### Por que o MeuCofre?\n\n- **🎨 Interface Intuitiva**: Design moderno e amigável que torna o controle financeiro uma experiência agradável\n- **📊 Insights Poderosos**: Visualizações e análises que ajudam na tomada de decisões financeiras\n- **🚀 Performance**: Construído com tecnologias de ponta para garantir rapidez e eficiência\n- **📱 Acesso Universal**: Funciona perfeitamente em qualquer dispositivo\n\n---\n\n## 🌐 Demo\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://via.placeholder.com/800x400.png?text=Demo+Screenshot\" alt=\"Demo Screenshot\" /\u003e\n  \n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://meucofre-demo.vercel.app\" target=\"_blank\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/Demo_Online-Acessar-4CAF50?style=for-the-badge\" alt=\"Demo Online\"\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\n## ✨ Features\n\n### 🎯 Principais Funcionalidades\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\" width=\"33%\"\u003e\n      \u003cimg src=\"https://img.icons8.com/fluency/96/000000/dashboard.png\" width=\"60\" /\u003e\n      \u003ch4\u003eDashboard Inteligente\u003c/h4\u003e\n      \u003cp\u003eVisão geral completa de suas finanças com gráficos interativos e KPIs em tempo real\u003c/p\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\" width=\"33%\"\u003e\n      \u003cimg src=\"https://img.icons8.com/fluency/96/000000/money-transfer.png\" width=\"60\" /\u003e\n      \u003ch4\u003eGestão de Transações\u003c/h4\u003e\n      \u003cp\u003eCadastre e categorize suas receitas e despesas com poucos cliques\u003c/p\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\" width=\"33%\"\u003e\n      \u003cimg src=\"https://img.icons8.com/fluency/96/000000/shopping-cart.png\" width=\"60\" /\u003e\n      \u003ch4\u003eSimulador de Compras\u003c/h4\u003e\n      \u003cp\u003eTeste o impacto de futuras compras no seu orçamento\u003c/p\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n### 🔧 Funcionalidades Técnicas\n\n- **🌓 Tema Adaptável**: Alterne entre modo claro e escuro\n- **💾 Persistência Local**: Seus dados salvos automaticamente no navegador\n- **📈 Análises Avançadas**: Gráficos e relatórios detalhados\n- **🔍 Busca e Filtros**: Encontre rapidamente qualquer transação\n- **📅 Agenda Financeira**: Programe lembretes e pagamentos recorrentes\n- **🔐 Privacidade**: Seus dados permanecem apenas no seu dispositivo\n\n---\n\n## 📸 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003cimg src=\"https://via.placeholder.com/400x300.png?text=Dashboard\" width=\"400\" alt=\"Dashboard\" /\u003e\n        \u003cp\u003e\u003cstrong\u003eDashboard Principal\u003c/strong\u003e\u003c/p\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003cimg src=\"https://via.placeholder.com/400x300.png?text=Transacoes\" width=\"400\" alt=\"Transações\" /\u003e\n        \u003cp\u003e\u003cstrong\u003eGestão de Transações\u003c/strong\u003e\u003c/p\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003cimg src=\"https://via.placeholder.com/400x300.png?text=Graficos\" width=\"400\" alt=\"Gráficos\" /\u003e\n        \u003cp\u003e\u003cstrong\u003eAnálises e Gráficos\u003c/strong\u003e\u003c/p\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003cimg src=\"https://via.placeholder.com/400x300.png?text=Dark+Mode\" width=\"400\" alt=\"Dark Mode\" /\u003e\n        \u003cp\u003e\u003cstrong\u003eModo Escuro\u003c/strong\u003e\u003c/p\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n---\n\n## 🛠 Tecnologias\n\n### Frontend\n- **[React 19](https://react.dev/)** - Biblioteca UI de última geração\n- **[TypeScript 5](https://www.typescriptlang.org/)** - Superset JavaScript com tipagem estática\n- **[Vite 5](https://vitejs.dev/)** - Build tool extremamente rápido\n- **[Tailwind CSS 3](https://tailwindcss.com/)** - Framework CSS utility-first\n\n### Gerenciamento de Estado e Roteamento\n- **[Zustand](https://zustand-demo.pmnd.rs/)** - Estado global simples e poderoso\n- **[React Router DOM](https://reactrouter.com/)** - Roteamento declarativo\n\n### Visualização de Dados\n- **[Recharts](https://recharts.org/)** - Gráficos construídos com React\n\n### Ferramentas de Desenvolvimento\n- **ESLint** - Linting de código\n- **Prettier** - Formatação de código\n- **Git Hooks** - Husky + lint-staged\n\n---\n\n## 🏗 Arquitetura\n\nO projeto segue uma arquitetura modular e escalável, inspirada em padrões modernos de desenvolvimento React:\n\n```\nsrc/\n├── 📁 assets/          # Recursos estáticos\n├── 📁 components/      # Componentes reutilizáveis\n│   ├── 📊 charts/      # Componentes de visualização\n│   ├── 🎯 dashboard/   # Componentes do dashboard\n│   ├── 📝 forms/       # Formulários reutilizáveis\n│   ├── 🏗 layout/      # Componentes de layout\n│   ├── 🛒 shop/        # Loja de simulação\n│   ├── 💸 transactions/# Componentes de transações\n│   └── 🎨 ui/          # Componentes de UI base\n├── 📁 context/         # Contextos React (tema, etc)\n├── 📁 hooks/           # Custom hooks\n├── 📁 pages/           # Páginas/Rotas da aplicação\n├── 📁 store/           # Estado global (Zustand)\n├── 📁 types/           # Definições TypeScript\n├── 📁 utils/           # Funções utilitárias\n├── 📄 App.tsx          # Componente raiz\n└── 📄 main.tsx         # Entry point\n```\n\n### Padrões e Convenções\n\n- **Componentes**: Functional components com TypeScript\n- **Estado**: Zustand para estado global, useState/useReducer para estado local\n- **Estilização**: Tailwind CSS com classes utilitárias\n- **Nomeação**: PascalCase para componentes, camelCase para funções/variáveis\n\n---\n\n## 🚀 Instalação\n\n### Pré-requisitos\n\n- Node.js 18+ \n- npm ou yarn\n- Git\n\n### Passo a Passo\n\n1. **Clone o repositório**\n   ```bash\n   git clone https://github.com/Jeffinp/MeuCofre.git\n   cd MeuCofre\n   ```\n\n2. **Instale as dependências**\n   ```bash\n   npm install\n   # ou\n   yarn install\n   ```\n\n3. **Configure as variáveis de ambiente (opcional)**\n   ```bash\n   cp .env.example .env.local\n   ```\n\n4. **Inicie o servidor de desenvolvimento**\n   ```bash\n   npm run dev\n   # ou\n   yarn dev\n   ```\n\n5. **Acesse a aplicação**\n   \n   Abra [http://localhost:5173](http://localhost:5173) no seu navegador\n\n### Comandos Disponíveis\n\n```bash\nnpm run dev          # Inicia o servidor de desenvolvimento\nnpm run build        # Gera a build de produção\nnpm run preview      # Visualiza a build de produção\nnpm run lint         # Executa o linter\nnpm run format       # Formata o código com Prettier\n```\n\n---\n\n## 💡 Como Usar\n\n### Primeiros Passos\n\n1. **Adicione sua primeira transação**\n   - Clique no botão \"Nova Transação\"\n   - Escolha entre Receita ou Despesa\n   - Preencha os detalhes e salve\n\n2. **Visualize seus dados**\n   - Acesse o Dashboard para ver o resumo\n   - Explore os gráficos interativos\n   - Use os filtros para análises específicas\n\n3. **Simule compras futuras**\n   - Acesse a Loja de Simulação\n   - Adicione produtos ao carrinho\n   - Veja o impacto no seu orçamento\n\n### Dicas de Uso\n\n- 💡 Use categorias consistentes para melhor organização\n- 📊 Revise o dashboard semanalmente para acompanhar suas metas\n- 🎯 Defina limites de gastos por categoria\n- 📱 Adicione o app à tela inicial do seu celular\n\n---\n\n## 📅 Roadmap\n\n### Versão 1.0 (Atual)\n- ✅ Dashboard interativo\n- ✅ CRUD de transações\n- ✅ Temas claro/escuro\n- ✅ Design responsivo\n\n### Versão 2.0 (Em Desenvolvimento)\n- [ ] Sistema de autenticação\n- [ ] Backend com Node.js/Express\n- [ ] Banco de dados PostgreSQL\n- [ ] Sincronização em nuvem\n\n### Versão 3.0 (Planejado)\n- [ ] App mobile (React Native)\n- [ ] Importação de extratos bancários\n- [ ] Metas financeiras com acompanhamento\n- [ ] Relatórios PDF/Excel\n- [ ] Notificações push\n\n### Features Futuras\n- [ ] Integração com APIs bancárias\n- [ ] Carteira de investimentos\n- [ ] Planejamento de aposentadoria\n- [ ] Modo família (contas compartilhadas)\n- [ ] IA para insights financeiros\n\n---\n\n## 🤝 Contribuindo\n\nContribuições são sempre bem-vindas! Veja como você pode ajudar:\n\n### Como Contribuir\n\n1. **Fork o projeto**\n2. **Crie sua Feature Branch**\n   ```bash\n   git checkout -b feature/MinhaFeature\n   ```\n3. **Commit suas mudanças**\n   ```bash\n   git commit -m 'feat: Adiciona MinhaFeature'\n   ```\n4. **Push para a Branch**\n   ```bash\n   git push origin feature/MinhaFeature\n   ```\n5. **Abra um Pull Request**\n\n### Diretrizes de Contribuição\n\n- Siga o padrão de commits convencionais\n- Mantenha o código limpo e bem documentado\n- Adicione testes quando aplicável\n- Atualize a documentação conforme necessário\n\n### Tipos de Contribuição\n\n- 🐛 Reportar bugs\n- 💡 Sugerir novas features\n- 📝 Melhorar documentação\n- 🌐 Traduções\n- 🎨 Melhorias de UI/UX\n\n---\n\n## 👨‍💻 Autores\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/Jeffinp\"\u003e\n          \u003cimg src=\"https://github.com/Jeffinp.png\" width=\"100px;\" alt=\"Jeferson Reis\"/\u003e\n          \u003cbr /\u003e\n          \u003csub\u003e\u003cb\u003eJeferson Reis\u003c/b\u003e\u003c/sub\u003e\n        \u003c/a\u003e\n        \u003cbr /\u003e\n        \u003ca href=\"https://github.com/Jeffinp\" title=\"Code\"\u003e💻\u003c/a\u003e\n        \u003ca href=\"https://github.com/Jeffinp\" title=\"Design\"\u003e🎨\u003c/a\u003e\n        \u003ca href=\"https://github.com/Jeffinp\" title=\"Documentation\"\u003e📖\u003c/a\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n---\n\n## 📄 Licença\n\nEste projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.\n\n---\n\n## 🙏 Agradecimentos\n\n- [React Icons](https://react-icons.github.io/react-icons/) pelos ícones\n- [Tailwind UI](https://tailwindui.com/) pela inspiração de design\n- [Vercel](https://vercel.com/) pelo hosting gratuito\n- Comunidade open source pelos feedbacks e contribuições\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\n    \u003cstrong\u003eFeito com ❤️ por Jeferson Reis\u003c/strong\u003e\n  \u003c/p\u003e\n  \n  \u003cp\u003e\n    \u003ca href=\"https://github.com/Jeffinp\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/GitHub-100000?style=for-the-badge\u0026logo=github\u0026logoColor=white\" alt=\"GitHub\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://linkedin.com/in/jefersonreis\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge\u0026logo=linkedin\u0026logoColor=white\" alt=\"LinkedIn\"\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n  \n  \u003cp\u003e\n    ⭐ Se este projeto te ajudou, considere dar uma estrela!\n  \u003c/p\u003e\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeffinp%2Fgestao_financeira","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeffinp%2Fgestao_financeira","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeffinp%2Fgestao_financeira/lists"}