Rastreador de tarefas — Guia do usuário | YoBench

Para que serve o módulo «Tracker»

O módulo agrega tarefas de todos os trackers corporativos em um só lugar. Em vez de alternar entre oito abas do navegador (Yandex Tracker, JIRA, GitHub, GitLab, Linear, Asana, Trello, Redmine), você vê uma lista ou um quadro kanban unificado com tarefas de todos os projetos e times — com filtros, busca, estimativa por IA e cache local.

O que você obtém:

• Uma fila a partir de 8 sistemas — cada integração armazena os dados no banco criptografado local, então você continua trabalhando offline.
• Visualizações Lista e Kanban — alterne com um clique entre lista plana e quadro por status.
• Estimativa de complexidade por IA — botão direto no detalhe da tarefa: a IA lê descrição, comentários e checklist e devolve uma estimativa em horas com justificativa.
• Ações ricas em tarefas nativas — para tarefas internas: troca de status, comentários (rich text), apontamento de horas, checklists, etiquetas, links entre tarefas e campos personalizados.
• Campos personalizados com full-text search — defina campos de texto, número, data ou seleção por projeto; busque entre eles com a mesma velocidade dos campos principais.
• Subtabs no detalhe da tarefa — Descrição, Checklists, Comentários, Atividade, Links e estimativa IA ficam em subtabs dedicadas, então o painel continua legível em tarefas longas.
• Scheduler por conexão — cada conexão de tracker tem seu próprio intervalo de consulta (poll_minutes), então um JIRA dinâmico pode atualizar a cada 2 minutos enquanto um Redmine mais calmo consulta a cada hora.
• Comentários paginados e infinite scroll — threads longas carregam em páginas, listas grandes de tarefas continuam rolando suavemente sem travar.
• Visualização somente leitura para tarefas externas — as tarefas dos trackers conectados aparecem dentro do YoBench; edições são feitas no sistema de origem.
• Sincronização em segundo plano — cada conexão é consultada no seu próprio intervalo, sem intervenção manual.

Provedores suportados e parâmetros de conexão

Oito adaptadores estão implementados no código e disponíveis no formulário «Adicionar conexão».

Yandex Tracker

• Tipo de organização (cloud ou 360)
• ID da organização
• Token OAuth
• Opcional: filtro de responsáveis, consulta personalizada

JIRA Cloud

• Host — por exemplo https://yourteam.atlassian.net
• E-mail
• Token de API
• Opcional: chaves de projeto (para filtrar)

GitHub Issues

• Personal access token
• Repositórios no formato owner/repo (obrigatório)
• Opcional: filtro de responsáveis

GitLab Issues

• Personal access token
• IDs ou caminhos de projetos (obrigatório)
• Opcional: URL do GitLab (para self-hosted)

Linear

• API key
• Opcional: chaves de time, e-mails de responsáveis

Asana

• Personal access token
• Project GIDs (obrigatório)
• Opcional: nomes de responsáveis

Trello

• API key
• API token
• Board IDs (obrigatório)

Redmine

• URL do Redmine
• API key
• Opcional: identificadores de projeto

Recursos da UI

Visualização Lista

Colunas da tabela:

Quadro Kanban

As colunas correspondem aos status do projeto selecionado ou ao mapeamento de status. Os cartões podem ser arrastados entre colunas — para tarefas nativas isso muda o status, para externas a alteração é sincronizada para o tracker de origem.

Filtros

• Por status, prioridade, responsável
• Por projeto, etiqueta, tipo de link (internal / external)
• Busca por título
• Filtros personalizados nos campos da tarefa
• Ordenação: atualização, prioridade, criação, prazo

Ações sobre tarefas

Tarefas nativas (criadas dentro do YoBench):

• Criar / editar / arquivar
• Mudança de status (drag-and-drop no quadro ou pelo painel de detalhe)
• Comentários em editor rich text (TipTap), paginados com infinite scroll em threads longas
• Apontamento de horas (estimate_hours, spent_hours)
• Checklists com itens
• Etiquetas (registro por projeto)
• Links entre tarefas: bloqueia / depende de / duplicado
• Campos personalizados: texto, número, data, seleção — indexados para full-text search junto com título e descrição
• Mover entre projetos

Tarefas externas (de trackers conectados): somente leitura mais estimativa por IA. As edições são feitas no sistema de origem — sincronizam na próxima consulta.

Campos personalizados e FTS

Por projeto você pode definir campos personalizados do tipo text, number, date ou select. Uma vez definidos, eles aparecem no editor de tarefa e como colunas filtráveis na visualização Lista. O índice de full-text cobre os campos principais (título, descrição, comentários) e todo campo personalizado de texto — então buscar por código de cliente, referência de ticket ou tag de release encontra a tarefa, não importa onde o valor esteja.

Subtabs no detalhe da tarefa

O painel direito mantém o cabeçalho (status, prioridade, responsável, prazo) sempre visível e divide o corpo em subtabs:

• Descrição — corpo da tarefa e metadados.
• Checklists — várias listas nomeadas com reordenação por arrastar.
• Comentários — thread paginada com texto rico e respostas.
• Atividade — feed cronológico de todas as mudanças.
• Links — bloqueia / depende de / duplica.
• Estimativa IA — execute, veja e reexecute estimativas de complexidade por IA.

Estimativa de tarefas por IA

O painel de detalhe da tarefa tem uma aba Estimativa IA. Ao clicar em Executar estimativa IA o módulo:

1. Coleta o título, a descrição, os comentários e os itens da checklist.
2. Envia ao provedor de IA escolhido (ver configurações globais).
3. Recebe uma estimativa em horas com justificativa.
4. Salva o resultado no banco local (tracker_ai_estimates) — é possível reexecutar a qualquer momento.

Configurações globais do módulo

Configuradas em Configurações → Tracker:

• Provedor IA para estimativas (trackerAiProviderId) — qual provedor do registro AI Chat alimenta a estimativa por IA.
• Prompt de estimativa IA (trackerAiEstimatePrompt) — modelo da requisição. Adapte à sua metodologia (story points / horas / T-shirt sizing).

O intervalo de consulta (poll_minutes) é por conexão, não global.

Fluxo de uso

1. Conecte um tracker

1. Abra o módulo Tracker no menu lateral esquerdo.
2. Na barra lateral clique em Adicionar conexão.
3. Escolha o tipo de adaptador (Yandex Tracker / JIRA / GitHub / GitLab / Linear / Asana / Trello / Redmine).
4. Preencha os campos obrigatórios (host, token, projetos — depende do adaptador).
5. Opcionalmente configure o mapeamento de status — quais status de origem correspondem aos internos.
6. Salve. A primeira sincronização inicia automaticamente.

2. Dispare uma sincronização manual

Cada conexão na barra lateral tem um botão Sincronizar. Sem ele a consulta segue o intervalo configurado (tipicamente 5–15 minutos, por conexão).

3. Trabalhe com as tarefas

• Lista — visualização padrão para varrer a fila.
• Quadro — arraste cartões entre colunas de status.
• Filtro — compor suas próprias condições (por exemplo, «minhas tarefas, em andamento, prioridade crítica»).
• Detalhe da tarefa — clique em uma linha para abrir o painel direito: descrição, comentários, checklists, log de atividade, links, estimativa IA.

4. Execute a estimativa por IA

No detalhe da tarefa mude para Estimativa IA → Executar estimativa IA. O resultado é salvo e fica visível como métrica adicional na lista.

5. Gerencie conexões

• Editar — altere parâmetros ou mapeamento de status.
• Excluir — desconecte e remova o cache local das tarefas associadas.

Próximos passos

• Configure os provedores de IA — sem eles a estimativa por IA não funciona.
• Use o Calendário para ver tarefas com prazos em uma linha do tempo.
• Para analítica centralizada de projetos de código, rode em paralelo o Git Analytics.

Ajuda e feedback

Encontrou um bug ou quer pedir um novo adaptador? Escreva para nós pelo formulário de contato.