Dev Statistics - Pomodoro com Coleta de Estatísticas

Extensão para VS Code que combina a técnica Pomodoro com coleta de estatísticas para análise de desempenho e identificação de pontos de atenção no desenvolvimento.

🍅 Recursos

1. Status na Barra Inferior

• Botão interativo que exibe o estado atual e cronômetro
• Clique para acessar menu com opções: Iniciar, Pausar/Retomar e Parar
• Emojis visuais para cada fase:
  • 🍅 Trabalho (Pomodoro)
  • ☕ Pausa Curta
  • 🏖️ Pausa Longa
  • ⏸️ Parado

2. Configurações Personalizáveis

Acesse as configurações do VS Code e personalize:

• devStatistics.pomodoroTime: Tempo de trabalho em minutos (padrão: 25)
• devStatistics.shortBreakTime: Tempo de pausa curta em minutos (padrão: 5)
• devStatistics.longBreakTime: Tempo de pausa longa em minutos (padrão: 15)
• devStatistics.pomodorosPerCycle: Quantidade de pomodoros antes da pausa longa (padrão: 4)
• devStatistics.dataPath: Caminho customizado para salvar os dados (deixe vazio para usar local padrão)
• devStatistics.enableQuestionnaire: Ativar/desativar questionário ao finalizar pomodoros (padrão: true)

3. Gerenciamento de Tarefas

Ao iniciar um ciclo Pomodoro:

• Escolha uma tarefa existente da lista
• Ou crie uma nova tarefa digitando o nome
• Todos os registros serão vinculados à tarefa selecionada

4. Questionário de Acompanhamento

Ao finalizar cada intervalo de trabalho (não aparece nas pausas), responda:

💡 Dica: Você pode desabilitar o questionário através da configuração devStatistics.enableQuestionnaire se preferir usar apenas o timer Pomodoro.

Nota do Trabalho:

• 📝 Campo de texto no topo: "O que você estava fazendo?"
• Ajuda a lembrar o contexto após a pausa
• Aparece no popup de volta ao trabalho

Perguntas com escala de 0 a 10:

• Qual seu nível de ansiedade? (0 = Nenhuma, 10 = Muito alta)
• Sentiu-se distraído ou focado? (0 = Muito distraído, 10 = Muito focado)
• Nível de dificuldade observado na tarefa (0 = Muito fácil, 10 = Muito difícil)

Perguntas Booleanas:

• ☑️ Houve alguma interrupção externa? (cliente, colega...)
• ☑️ Alguma dificuldade técnica? (hardware estragou, ferramenta crashou...)

Campo de Texto:

• Observações (texto livre para notas adicionais)

5. Armazenamento de Dados

Os dados são salvos automaticamente em formato JSON:

• Organizados por nome da tarefa
• Cada registro inclui timestamp de início e fim da fase
• Tipo de fase registrado (Trabalho, Pausa Curta, Pausa Longa)
• Estrutura preparada para análise futura de estatísticas
• Considera pausas do usuário no tempo real de execução

Localização dos dados:

• Por padrão, os arquivos são salvos no diretório de armazenamento global do VS Code
• Você pode customizar o local através da configuração devStatistics.dataPath
• Arquivos criados:
  • pomodoro-data.json: Registros de todos os questionários por tarefa
  • tasks.json: Lista de tarefas criadas

6. Controle de Fluxo com Popups Modais

• ⏸️ Popup modal ao finalizar cada fase do Pomodoro
• Usuário precisa clicar em "OK" para continuar
• Permite fazer uma pausa real entre as fases
• Controle total sobre quando iniciar a próxima etapa
• 🧠 Lembrete de contexto: Ao voltar do descanso, o popup mostra o que você estava fazendo
• 📊 Questionário ao parar: Se parar durante trabalho, oferece responder o questionário antes
• Evita que o ciclo continue automaticamente sem atenção

7. Visualizar Local dos Dados

• 📁 Comando para ver onde os arquivos estão salvos
• Acessível através do menu do Pomodoro
• Opção de abrir a pasta ou copiar o caminho
• Console do VS Code também mostra o caminho ao iniciar

8. Visualização de Estatísticas

• � Interface visual com cards de tarefas
• Cada card mostra o nome da tarefa e contagem de pomodoros
• Gráficos interativos: clique em um card para ver a evolução temporal
• Três gráficos de linha para cada tarefa:
  • Ansiedade ao longo do tempo
  • Foco ao longo do tempo
  • Dificuldade ao longo do tempo
• Visualize tendências e padrões no seu desenvolvimento
• Apenas registros com questionário respondido aparecem nos gráficos

�📋 Como Usar

1. Clique no ícone do Pomodoro na barra de status
2. Selecione "Iniciar Pomodoro"
3. Escolha ou crie uma tarefa
4. Trabalhe durante o intervalo
5. Responda ao questionário ao final de cada pomodoro
6. Aproveite as pausas!
7. Repita o ciclo
8. Visualize suas estatísticas clicando no menu e selecionando "Ver estatísticas"

⌨️ Comandos

• Dev Statistics: Start Pomodoro - Iniciar um novo ciclo
• Dev Statistics: Pause Pomodoro - Pausar/Retomar o timer
• Dev Statistics: Stop Pomodoro - Parar completamente o ciclo
• Dev Statistics: Skip Current Phase - Pular fase atual e avançar
• Dev Statistics: Show Data Path - Mostrar onde os dados estão salvos
• Dev Statistics: Show Statistics - Visualizar estatísticas e gráficos

🎯 Objetivo

Esta extensão foi desenvolvida para:

• Melhorar o foco e produtividade através da técnica Pomodoro
• Coletar dados sobre ansiedade, foco e dificuldade durante o trabalho
• Identificar padrões e pontos de atenção no desenvolvimento
• Permitir análise futura de desempenho através dos dados coletados

📊 Dados Coletados

Os dados são estruturados para facilitar análises futuras:

Campos registrados:

• startTime / endTime: Timestamps de início e fim da fase
• task: Nome da tarefa executada
• phaseType: Tipo da fase (Trabalho, Pausa Curta, Pausa Longa)
• questionnaireEnabled: Indica se o questionário estava habilitado quando o registro foi feito
• Campos do questionário (quando questionnaireEnabled: true):
  • notaTrabalho: O que estava sendo desenvolvido
  • ansiedade, foco, dificuldade: Escalas de 0 a 10
  • interrupcaoExterna, dificuldadeTecnica: Booleanos
  • observacoes: Texto livre

Quando o questionário está desativado, os registros são salvos apenas com informações básicas (timestamps e tarefa), e os campos do questionário ficam vazios ou com valor 0.

[
  {
    "name": "Nome da Tarefa",
    "records": [
      {
        "startTime": "2025-12-31T10:00:00.000Z",
        "endTime": "2025-12-31T10:25:00.000Z",
        "task": "Nome da Tarefa",
        "phaseType": "Trabalho",
        "questionnaireEnabled": true,
        "notaTrabalho": "Implementando função de login com JWT",
        "ansiedade": 5,
        "foco": 8,
        "dificuldade": 6,
        "interrupcaoExterna": false,
        "dificuldadeTecnica": true,
        "observacoes": "Tive um problema com a configuração do ambiente"
      }
    ]
  }
]

📝 Release Notes

0.0.1

• ✅ Timer Pomodoro com pausas curtas e longas
• ✅ Barra de status interativa com cronômetro
• ✅ Sistema de gerenciamento de tarefas
• ✅ Questionário completo com escalas e campos booleanos
• ✅ Armazenamento estruturado de dados por tarefa
• ✅ Configurações personalizáveis

Desenvolvido com ❤️ para melhorar a produtividade e bem-estar no desenvolvimento