 |
Resumo | Permite o registro de tempo no Discourse |
 |
Link do Repositório | \u003chttps://github.com/communiteq/discourse-time-registration\u003e |
 |
Guia de Instalação | Como instalar plugins no Discourse |
Registro de Tempo do Discourse
Discourse Time Registration é uma solução leve e integrada de rastreamento de tempo para o Discourse. Ele permite que os usuários rastreiem o tempo gasto em tópicos específicos, tornando-o ideal para equipes de suporte, freelancers ou gerenciamento de projetos internos onde a cobrança ou a contabilidade de tempo é necessária diretamente no contexto da discussão.
Principais Recursos
- Dois Modos de Rastreamento:
- Cronômetro (Stopwatch): Inicie um cronômetro ao começar a trabalhar em um tópico e pare-o quando terminar.
- Entrada Manual: Registre uma duração específica (ex: “1 hora” ou “15 minutos”) instantaneamente se o trabalho já estiver concluído.
- Integração com Tópicos: Os registros de tempo aparecem como publicações de “pequena ação” no fluxo do tópico (ex: “Usuário trabalhou em Correção de Bug por 01:30”), mantendo o histórico de trabalho visível ao lado da conversa.
- Cronômetro Global: Um indicador de cronômetro ativo aparece no cabeçalho do site, permitindo que os usuários naveguem pelo fórum enquanto o relógio está correndo e parem o cronômetro de qualquer lugar.
- Arredondamento Inteligente: Regras de arredondamento configuráveis (ex: arredondar para o quarto de hora mais próximo) para automatizar os cálculos de faturamento.
- Painel de Relatórios: Uma interface dedicada para consultar dados de tempo.
Como Funciona
Rastreando o Tempo
Um registro de tempo está sempre vinculado a um tópico.
Ao visualizar um tópico, os usuários com permissão verão um botão Registro de Tempo (ícone de relógio) no cabeçalho superior direito. Clicar nele abre uma janela modal onde eles podem:
- Iniciar Cronômetro: Inicia um contador em tempo real.
- Registrar Tempo: Permite inserir uma duração manual (ex: “30” para minutos ou “1:30” para horas/minutos) e uma descrição imediatamente.
Quando um cronômetro é parado, o usuário é solicitado a inserir uma descrição do trabalho realizado.
Isso cria uma pequena publicação de ação no tópico registrando o usuário, a descrição e a duração final.
Editando Registros
Erros acontecem. Usuários (ou Administradores) podem editar as publicações de registro de tempo existentes para corrigir a descrição ou a duração. Basta passar o mouse sobre a publicação de pequena ação e um lápis aparecerá. O sistema atualiza o registro e os dados do relatório automaticamente.
Relatórios
O plugin inclui um abrangente Relatório de Registro de Tempo (acessível através da Barra Lateral).
- Filtros: Filtre por Intervalo de Datas, Categoria e Usuário específico.
- Dados: Exibe uma tabela com o Tópico, Categoria (ou “Mensagem Pessoal”), Usuário, Descrição, Duração e Data.
- Totais: Calcula automaticamente o tempo total gasto com base nos filtros atuais.
Configurações
| Nome | Descrição |
|---|---|
time registration groups |
os grupos que podem realizar o registro de tempo |
time registration rounding interval |
arredondar o tempo registrado para X minutos |
time registration round up at |
arredondar para cima a partir de onde |
Exemplo:
- intervalo de arredondamento: 10, arredondar para cima a partir de: 1 –\u003e 12 se torna 20
- intervalo de arredondamento: 15, arredondar para cima a partir de: 7.5 –\u003e 22 se torna 15, 23 se torna 30