Controle de Tempo
Registre tempo em tarefas diretamente do seu editor de código. Um cronômetro persistente na barra de status funciona junto com o seu código, e um painel dedicado exibe seu registro de tempo, gráficos e horas da equipe.
O Problema que Isso Resolve
Registrar tempo em uma aba separada do navegador depois do fato é impreciso. Você esquece no que trabalhou, estima em vez de medir e perde horas faturáveis. Quanto mais difícil é o controle de tempo, menos sua equipe o utiliza.
O GitScrum Studio torna o registro de tempo simples. O cronômetro está sempre visível na barra de status. Um clique para iniciar, um clique para parar. As entradas de tempo são vinculadas automaticamente à tarefa, projeto e usuário corretos.
O que Você Está Vendo
O Cronômetro na Barra de Status
Na parte inferior do seu editor, a barra de status exibe um ícone de relógio com o cronômetro. Esse cronômetro está sempre visível independentemente de qual arquivo ou painel você tenha aberto.
Quando inativo:
🕐 00:00:00Quando ativo:
🕐 01:23:45 | PROJ-123 (fundo amarelo)O estado ativo mostra o tempo decorrido e o código da tarefa. O fundo amarelo torna impossível não perceber.
Iniciando um Cronômetro
Clique no ícone de relógio na barra de status. Um menu QuickPick aparece:
Quando nenhum cronômetro está rodando:
| Opção | Descrição |
|---|---|
| ▶ Start Timer | Abre um seletor de tarefas para escolher qual tarefa rastrear |
| 📜 View Time Entries | Abre o painel de Controle de Tempo |
| 📊 Open Time Tracking Panel | Abre a visualização de análises |
Ao selecionar Start Timer, suas tarefas de todos os workspaces são carregadas. O seletor exibe:
PROJ-123 · In Progress · Implement login form
PROJ-124 · To Do · Design user profile page
PROJ-125 · In Review · Fix navigation bugCada item exibe o código da tarefa, o status atual do fluxo de trabalho e o título. Digite para buscar por qualquer um desses campos.
Selecione uma tarefa e o cronômetro inicia imediatamente. A barra de status é atualizada para mostrar o tempo decorrido com o fundo amarelo.
Parando um Cronômetro
Clique no cronômetro da barra de status quando ele estiver rodando. O menu QuickPick exibe:
| Opção | Descrição |
|---|---|
| ⏹ Stop Timer | Para e salva a entrada de tempo |
| 🔄 Switch Task | Para o cronômetro atual e inicia um novo em uma tarefa diferente |
| 🗑 Discard Timer | Cancela o cronômetro sem registrar nenhum tempo |
| 📜 View Time Entries | Abre o painel de Controle de Tempo |
| 📊 Open Time Tracking Panel | Abre a visualização de análises |
Ao selecionar Stop Timer, um campo de entrada aparece mostrando o código da tarefa e o tempo total decorrido. Adicione um comentário opcional descrevendo no que você trabalhou e pressione Enter para salvar.
A entrada de tempo é registrada e vinculada à tarefa, ao projeto e à sua conta de usuário.
Alternando Tarefas
Selecione 🔄 Switch Task no menu do cronômetro ativo. O cronômetro atual para automaticamente, a entrada de tempo é salva e um novo seletor de tarefas abre imediatamente. Isso permite alternar entre tarefas sem perder nenhum tempo registrado.
Descartando um Cronômetro
Selecione 🗑 Discard Timer para cancelar o cronômetro ativo sem salvar. Nenhuma entrada de tempo é criada. Use isso quando você iniciou o cronômetro na tarefa errada ou registrou tempo não produtivo acidentalmente.
Persistência do Cronômetro
O cronômetro salva seu estado no armazenamento do editor a cada 60 segundos. Isso significa:
- Fechar o editor → o cronômetro retoma quando você reabrir
- Reiniciar o computador → o cronômetro continua do último estado salvo
- Abrir em outra máquina → a extensão sincroniza com o cronômetro ativo do servidor na inicialização
Se o servidor tiver um cronômetro ativo diferente do estado local, a extensão sincroniza para corresponder ao servidor.
O Painel de Controle de Tempo
Clique em Time Tracking na árvore da barra lateral (sob o projeto ativo) para abrir o painel dedicado. Este painel possui três abas:
Aba Registro
A visualização padrão exibe uma lista de entradas de tempo do projeto atual.
Estatísticas do cabeçalho:
| Métrica | Descrição |
|---|---|
| Total de Horas | Soma de todas as horas registradas no período selecionado |
| Faturável | Horas marcadas como faturáveis |
| Não Faturável | Horas não marcadas como faturáveis |
| Trabalhado Hoje | Horas registradas hoje |
Filtro de período: Filtre entradas por Todo o Período, Esta Semana, Este Mês, Mês Passado ou intervalo de datas personalizado.
Lista de entradas: Cada entrada exibe:
- Código e título da tarefa
- Duração
- Data e hora
- Indicador de faturável
- Usuário que registrou a entrada
Clique na tarefa de qualquer entrada de tempo para abrir o drawer da tarefa com capacidades completas de edição.
Aba Gráficos
Análises visuais dos dados de controle de tempo. Visualize a distribuição de tempo entre tarefas, acompanhe padrões diários e semanais, e analise proporções de faturável vs. não faturável.
Aba Equipe
Visão geral do controle de tempo dos membros da equipe. Veja quem registrou tempo, total de horas por membro, e distribuição de tempo no projeto.
Controle de Tempo pela Paleta de Comandos
Todos os comandos do cronômetro estão disponíveis pela Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P):
| Comando | Ação |
|---|---|
GitScrum: Start Timer | Iniciar rastreamento de uma tarefa |
GitScrum: Stop Timer | Parar o cronômetro ativo |
GitScrum: Open Time Tracking | Abrir o painel de Controle de Tempo |
Dicas Avançadas (Quando Você Estiver Confortável)
- Inicie o cronômetro primeiro, codifique depois. Crie o hábito de iniciar o cronômetro antes de escrever qualquer código. O fluxo de um clique na barra de status torna isso praticamente sem atrito.
- Use Switch Task em vez de parar + iniciar. Economiza tempo e garante que não haja lacunas entre as entradas.
- Visualização dividida. Abra o painel de Controle de Tempo ao lado do seu código para monitorar as horas enquanto trabalha.
- Verifique a aba equipe antes do standup. Veja no que todos trabalharam e por quanto tempo sem precisar perguntar.
Permissões
A extensão respeita as permissões da sua conta GitScrum:
- Proprietários de Agência e Gerentes: Acesso total a todas as entradas de tempo, análises de equipe e relatórios
- Desenvolvedores: Podem iniciar e parar cronômetros, visualizar suas próprias entradas e ver análises do projeto
- Clientes: Não podem acessar o controle de tempo
Como Reportar um Problema ou Solicitar uma Funcionalidade
Se o cronômetro se comportar de forma inesperada ou as entradas de tempo não estiverem sendo registradas corretamente, abra um ticket de suporte na aplicação web do GitScrum. Navegue até Support Tickets na barra lateral e descreva o problema. Inclua a versão da extensão (visível na aba de Extensões) e o nome e versão do seu editor.