O HourTracker é uma ferramenta de interface de linha de comando (CLI) projetada para desenvolvedores e freelancers que necessitam de um método rápido e sem fricção para registrar horas trabalhadas.

Diferente de ferramentas web pesadas, este projeto foca na velocidade e na persistência local, utilizando Python para a lógica de aplicação e SQLite para armazenamento confiável de dados, permitindo a geração de relatórios precisos de produtividade.

• Zero Latency Logging: Inicie e pare contadores de tempo instantaneamente via terminal.
• Data Persistence: Todos os registros são salvos em um banco de dados relacional local (SQLite), garantindo integridade mesmo se o computador reiniciar.
• Detailed Reporting: Cálculo automático de duração de sessões com agregação por tarefas.
• Modular Architecture: Separação clara entre camada de apresentação (CLI), lógica de negócio e persistência de dados.

• Language: Python 3
• Database: SQLite3 (Embedded)
• Libraries: argparse (CLI parsing), datetime

O projeto segue uma arquitetura modular para facilitar manutenção e testes:

• cli.py: Ponto de entrada, gerencia argumentos e comandos do usuário.
• models.py: Camada de abstração de dados e regras de negócio.
• db.py: Gerenciamento de conexões e inicialização de schemas do SQLite.
• schema.sql: Definição DDL da estrutura do banco de dados.

1. Clone o repositório:

   git clone [https://github.com/BeiruthDEV/hour-tracker-cli.git](https://github.com/BeiruthDEV/hour-tracker-cli.git) cd hour-tracker-cli

2. Prepare o ambiente:

   python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt

A ferramenta expõe comandos intuitivos para o fluxo de trabalho diário:

Começa a contagem de tempo para uma tarefa específica.

python -m tracker.cli start --task "Refatoração API" # Output: ✅ Sessão iniciada para tarefa: Refatoração API

Encerra a tarefa atual e salva o timestamp final.

python -m tracker.cli stop # Output: 🛑 Sessão encerrada com sucesso.

Exibe o histórico de trabalho e duração calculada.

python -m tracker.cli report Exemplo de Saída: Plaintext

ID: 1 | Tarefa: Refatoração API | Início: 2023-10-27 10:00:00 | Fim: 2023-10-27 12:30:00 | Horas: 2.50 ID: 2 | Tarefa: Deploy AWS | Início: 2023-10-27 14:00:00 | Fim: 2023-10-27 15:00:00 | Horas: 1.00 🔮 Future Improvements [ ] Exportação de relatórios para CSV/JSON.

[ ] Suporte a múltiplas sessões simultâneas.

[ ] Visualização gráfica de produtividade no terminal (ASCII charts).

Desenvolvido por Matheus Beiruth.