💰 Fintrack - Controle Financeiro Pessoal

Um aplicativo moderno de controle financeiro pessoal que ajuda você a gerenciar despesas, categorizar transações e visualizar padrões de gastos com uma interface elegante e intuitiva.

📖 Resumo em Inglês

Fintrack is a modern personal finance tracking application built with React, Vite, and Supabase. It helps users manage expenses, categorize transactions, and visualize spending patterns through an elegant and intuitive dark-themed interface. Features include secure authentication, interactive dashboard, transaction management, category system, and responsive design.

✨ Funcionalidades

• 🔐 Autenticação Segura: Login e cadastro com Supabase Auth
• 📊 Dashboard Interativo: Visão geral das finanças com gráficos e estatísticas
• 💳 Gerenciamento de Transações: Adicione, edite e exclua transações facilmente
• 🏷️ Sistema de Categorias: Organize suas despesas e receitas por categoria
• 🎨 Interface Moderna: Design dark com Tailwind CSS e Lucide icons
• 📱 Responsivo: Funciona perfeitamente em desktop e mobile
• 🔒 Segurança: Row Level Security (RLS) no Supabase para proteção de dados

🛠️ Tecnologias Utilizadas

Frontend

• React 18 - Biblioteca JavaScript para interfaces
• Vite - Build tool rápido e moderno
• Tailwind CSS - Framework CSS utilitário
• Lucide React - Ícones modernos e consistentes
• React Router - Roteamento para SPA

Backend & Banco

• Supabase - Plataforma backend-as-a-service
• PostgreSQL - Banco de dados relacional
• Supabase Auth - Autenticação e autorização
• Row Level Security - Segurança a nível de linha

Ferramentas de Desenvolvimento

• ESLint - Linting e formatação de código
• Vite Plugin React - Integração React com Vite

📋 Pré-requisitos

Antes de começar, você vai precisar ter instalado em sua máquina:

• Node.js (versão 16 ou superior)
• npm ou yarn
• Uma conta no Supabase

🚀 Instalação e Configuração

1. Clone o repositório

git clone https://github.com/seu-usuario/fintrack.git
cd fintrack

2. Instale as dependências

npm install
# ou
yarn install

3. Configure as variáveis de ambiente

Crie um arquivo .env.local na raiz do projeto com suas credenciais do Supabase:

VITE_SUPABASE_URL=https://seu-projeto.supabase.co
VITE_SUPABASE_ANON_KEY=sua-chave-anonima-aqui

4. Configure o Supabase

1. Acesse seu painel do Supabase
2. Crie um novo projeto ou use um existente
3. Vá para o SQL Editor
4. Execute o script de políticas em SUPABASE_POLICY.md para configurar a segurança das tabelas

5. Execute o projeto

npm run dev
# ou
yarn dev

O aplicativo estará disponível em http://localhost:5173

📁 Estrutura do Projeto

fintrack/
├── public/                 # Arquivos estáticos
├── src/
│   ├── assets/            # Imagens e recursos
│   ├── components/        # Componentes reutilizáveis
│   │   └── ProtectedRoute.jsx
│   ├── contexts/          # Contextos React
│   │   └── AuthContext.jsx
│   ├── lib/               # Utilitários e configurações
│   │   └── supabase.js
│   ├── pages/             # Páginas da aplicação
│   │   ├── Categories.jsx
│   │   ├── Dashboard.jsx
│   │   ├── Login.jsx
│   │   └── Transactions.jsx
│   ├── App.css            # Estilos globais
│   ├── App.jsx            # Componente principal
│   └── main.jsx           # Ponto de entrada
├── SUPABASE_POLICY.md     # Políticas de segurança do Supabase
├── package.json           # Dependências e scripts
├── vite.config.js         # Configuração do Vite
└── README.md              # Este arquivo

📜 Scripts Disponíveis

• npm run dev - Inicia o servidor de desenvolvimento
• npm run build - Cria build de produção
• npm run preview - Visualiza o build de produção localmente
• npm run lint - Executa o linter ESLint

🔧 Configuração do Supabase

Para que o aplicativo funcione corretamente, é necessário configurar as políticas de segurança no Supabase. Consulte o arquivo SUPABASE_POLICY.md para obter as instruções detalhadas.

As tabelas principais do projeto são:

• categories - Categorias de despesas/receitas
• transactions - Transações financeiras

🤝 Contribuição

Contribuições são sempre bem-vindas! Para contribuir:

1. Fork o 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.

---