🎯 Trackly

Sistema completo para gerenciamento e acompanhamento de hábitos

Uma aplicação desktop moderna que ajuda você a criar, acompanhar e visualizar seus hábitos diários com um mapa de calor inspirado no GitHub.

✨ Funcionalidades

🏗️ Gerenciamento de Hábitos

• ➕ Criar novos hábitos com nome e descrição
• 📝 Listar todos os hábitos cadastrados
• 🔍 Buscar hábitos específicos
• ✏️ Atualizar informações dos hábitos
• 🗑️ Exclusão segura (soft delete)

📅 Controle Diário

• 📆 Selecionar data específica para registro
• ✅ Marcar hábitos como concluídos
• 🚫 Prevenção contra registros duplicados no mesmo dia
• 💾 Persistência automática dos dados

📊 Visualização e Estatísticas

• 🔥 Mapa de calor estilo GitHub para visualizar consistência
• 📈 Histórico completo por ano
• 🎯 Indicadores visuais de progresso
• 📱 Interface responsiva e intuitiva

🛠️ Stack Tecnológica

Frontend

• Electron - Framework para aplicações desktop
• React 19 - Biblioteca para interfaces
• TypeScript - Linguagem tipada
• Tailwind CSS - Framework de estilos
• React Router DOM - Roteamento

Backend & Dados

• Better SQLite3 - Banco de dados local
• Electron IPC - Comunicação entre processos

UI Components

• Radix UI - Componentes primitivos
• Phosphor Icons - Ícones modernos
• JetBrains Mono - Fonte tipográfica

Ferramentas

• Electron Vite - Build tool otimizada
• ESLint + Prettier - Code quality
• Electron Builder - Empacotamento
• GitHub Actions - CI/CD automatizado

🚀 Instalação e Uso

Pré-requisitos

• Node.js (v18+)
• npm ou yarn

Instalação

# Clone o repositório
git clone https://github.com/seu-usuario/trackly.git
cd trackly

# Instale as dependências
npm install

Desenvolvimento

# Inicia o modo de desenvolvimento com hot-reload
npm run dev

Build para Produção

# Build geral
npm run build

# Build específico por plataforma
npm run build:win     # Windows
npm run build:mac     # macOS
npm run build:linux   # Linux

Outras opções

# Linting e formatação
npm run lint
npm run format

# Preview da aplicação
npm run start

# Build sem empacotamento
npm run build:unpack

📁 Estrutura do Projeto

trackly/
├── src/
│   ├── main/                 # Processo principal do Electron
│   │   ├── database/         # Configuração e schemas do SQLite
│   │   ├── ipc/              # Handlers IPC
│   │   └── index.ts          # Entry point principal
│   ├── preload/              # Scripts de preload
│   │   └── index.ts          # APIs expostas ao renderer
│   └── renderer/             # Interface React
│       └── src/
│           ├── components/   # Componentes reutilizáveis
│           ├── pages/        # Páginas da aplicação
│           ├── styles/       # Estilos globais
│           └── utils/        # Utilitários
├── build/                    # Assets de build
├── .github/workflows/        # GitHub Actions
└── out/                      # Aplicação compilada

🗄️ Estrutura do Banco de Dados

Tabela habito

• id - Chave primária
• nome - Nome do hábito (obrigatório)
• descricao - Descrição opcional
• is_deleted - Flag para exclusão lógica

Tabela diario

• id - Chave primária
• data - Data no formato dd/mm/aaaa
• id_habito - Referência ao hábito
• is_feito - Status de conclusão

🔄 Fluxo de Funcionamento

1. Criação: Usuário cria hábitos na página de cadastro
2. Seleção: No dashboard, seleciona data e hábitos a serem feitos
3. Registro: Sistema salva no banco evitando duplicatas
4. Visualização: Mapa de calor mostra progresso ao longo do tempo
5. Análise: Usuário pode filtrar por ano e acompanhar consistência

🚀 Deploy e Distribuição

GitHub Actions

O projeto inclui workflow automatizado para:

• ✅ Build automático em macOS e Windows
• 📦 Geração de executáveis
• 🚀 Release automático com tags

Plataformas Suportadas

• 🪟 Windows - .exe com instalador NSIS
• 🍎 macOS - .dmg com assinatura
• 🐧 Linux - AppImage, Snap, DEB

🤝 Contribuição

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: amazing feature')
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 detalhes.

---

Feito com ❤️ para ajudar você a construir hábitos consistentes

⭐ Se este projeto te ajudou, considere dar uma estrela!