# Tarefas

## Rota

- `/adm/tarefas`

## O que e

Central operacional de tarefas em formato de quadro, com foco em execucao, checkpoints, tempo investido, comentarios e acompanhamento por status.

## Para que serve

- visualizar a fila propria ou do time por status;
- iniciar ou encerrar timers de execucao;
- concluir tarefas com registro de nota final e grau de dificuldade;
- vincular contexto de GitHub e transformar uma tarefa em ticket quando o fluxo precisar sair do quadro;
- abrir o detalhe completo para checklist, comentarios, anexos, atribuicoes e historico.

## Blocos principais

- faixa de filtros e indicadores do topo;
- quadro kanban por status;
- card de tarefa com tempo da equipe, tempo proprio, prazo, responsavel, checklist e acoes rapidas;
- modais auxiliares para checkpoint, GitHub e detalhe avancado.

## Acoes principais

- `Concluir tarefa`: aparece como primeira acao do card, abre confirmacao com nota de conclusao e dificuldade, grava o status e registra o fechamento nos comentarios da tarefa;
- `Iniciar timer` e `Parar timer`: controlam a execucao da tarefa com comentario obrigatorio ao encerrar;
- `Novo checkpoint`: registra um marco rapido da evolucao;
- `Vincular GitHub`: fica disponivel no menu de acoes do card;
- `Transformar em ticket`: cria um ticket interno a partir da tarefa e vincula esse ticket ao contexto da tarefa.

## Observacoes

- a conclusao guiada usa `TasksController` e `TasksService` para garantir que a nota final e a dificuldade fiquem registradas junto da mudanca de status;
- a transformacao em ticket reaproveita a API de tickets existente e registra o vinculo via `TaskContext`;
- o menu de acoes concentra operacoes menos frequentes para deixar o rodape do card mais objetivo.