Issues
Tipos de Issue
EpicGrande conjunto de trabalho; contém histórias
StoryFuncionalidade ou requisito voltado ao usuário
TaskUnidade de trabalho (técnica ou não técnica)
BugDefeito ou comportamento inesperado
Sub-taskFilho de história/tarefa; não pode existir sozinho
Campos da Issue
SummaryTítulo curto (obrigatório)
DescriptionDetalhes, critérios de aceitação
AssigneePessoa responsável
PriorityHighest / High / Medium / Low / Lowest
LabelsTags livres para agrupamento
ComponentsSubseções do projeto (ex.: Backend, UI)
Fix VersionRelease que esta issue mira
Story PointsEstimativa de esforço (Scrum)
Links de Issue
blocks / is blocked byRelação de dependência
clones / is cloned byRastreamento de duplicatas
relates toAssociação geral
is caused by / causesRelação de causa raiz
Busca JQL
Sintaxe Básica
project = MYPROJ AND status = "In Progress" assignee = currentUser() AND resolution = Unresolved priority in (High, Highest) ORDER BY created DESC
Operadores
=Correspondência exata
!=Diferente de
in (a, b)Corresponde a qualquer da lista
not in (a, b)Exclui lista
~ "text"Contém (busca textual)
!~ "text"Não contém
is EMPTYCampo sem valor
is not EMPTYCampo com valor
> < >= <=Comparação (datas, números)
Funções de Data
created >= -7d # last 7 days due <= endOfWeek() # due this week updated >= startOfMonth() # updated this month created >= "2025-01-01" # since specific date
Padrões JQL Úteis
# Stale issues status != Done AND updated <= -30d # My open bugs assignee = currentUser() AND type = Bug AND resolution = Unresolved # Sprint scope sprint in openSprints() AND project = MYPROJ
Fluxos de Trabalho
Fluxo Padrão
To DoNão iniciado
In ProgressEm andamento
DoneConcluído
Fluxo Expandido
OpenCriado, aguardando triagem
In ProgressEm desenvolvimento ativo
In ReviewRevisão de código ou QA
DoneAceito e encerrado
ReopenedRetornado do estado Done
Conceitos de Fluxo
StatusEstado atual da issue
TransitionMovimento permitido entre status
ConditionQuem pode realizar uma transição
ValidatorVerificações antes de executar a transição
Post FunctionAção após a transição (ex.: atribuir)
ResolutionMotivo do encerramento (Fixed, Won't Do)
Boards
Tipos de Board
Scrum BoardBaseado em sprints; backlog, planejamento, velocidade
Kanban BoardFluxo contínuo; limites de WIP, sem sprints
Colunas do Board
ColumnMapeia para um ou mais status
WIP LimitMáximo de issues na coluna (Kanban)
SwimlaneAgrupamento horizontal (por épico, responsável, etc.)
Quick FilterFiltro de alternância baseado em JQL no board
Configuração do Board
FilterQuery JQL que define o escopo do board
EstimationStory Points ou Estimativa Original
Card LayoutCampos exibidos nos cards de issue
Card ColorsCor por prioridade, responsável ou query
Sprints
Ciclo de Vida do Sprint
CreateNome + meta e datas opcionais
PlanArraste issues do backlog para o sprint
StartDefina a duração (tipicamente 1-4 semanas)
ActiveTime trabalha nas issues do sprint
CompleteMova itens incompletos para o backlog ou próximo sprint
Relatórios de Sprint
Burndown ChartTrabalho restante vs tempo
Sprint ReportConcluídos vs não concluídos
Velocity ChartStory points por sprint ao longo do tempo
Cumulative FlowDistribuição de status ao longo do tempo
JQL de Sprint
sprint in openSprints() # current sprint sprint in futureSprints() # upcoming sprints sprint = "Sprint 12" # specific sprint sprint in closedSprints() AND resolution = Unresolved
Filtros
Criando Filtros
SearchEscreva JQL na busca de issues
Save AsSalve JQL como filtro nomeado
StarMarque um filtro para acesso rápido
SubscriptionEnvie resultados do filtro por email programado
Compartilhamento e Permissões
PrivateSomente você pode ver o filtro
GroupCompartilhe com um grupo específico
ProjectCompartilhe com membros do projeto
PublicQualquer usuário autenticado
Edit PermissionsControle quem pode modificar o filtro
Dashboards
Filter ResultsGadget exibindo issues de um filtro
Pie ChartDistribuição por campo (prioridade, responsável)
Two DimensionalMatriz X/Y (ex.: prioridade vs status)
Activity StreamAtividade recente do projeto
Atalhos
Navegação Global
g then dIr para o dashboard
g then bIr para o board
g then iIr para a busca de issues
/Busca rápida
cCriar issue
?Mostrar atalhos de teclado
Visualização de Issue
aAtribuir a mim
mComentar
lEditar labels
eEditar issue
j / kPróxima / issue anterior na lista
oAbrir issue selecionada
Atalhos do Board
1-9Mover issue para coluna 1-9
tAlternar visão de detalhes
nPróximo card
pCard anterior
Padrões Comuns
Modelo de Relatório de Bug
Summary[Componente] Descrição curta do bug
Steps to ReproducePassos numerados para reproduzir o problema
ExpectedO que deveria acontecer
ActualO que realmente acontece
EnvironmentSO, navegador, versão, etc.
SeverityBlocker / Critical / Major / Minor / Trivial
Formato de História
As a [role], I want [action], so that [benefit]. --- Acceptance Criteria: - [ ] Criterion 1 - [ ] Criterion 2
Operações em Lote
Search → Select AllSelecione issues dos resultados de busca
Bulk ChangeEdite, transfira ou exclua em lote
CSV ExportExporte resultados para relatórios
Board dragArraste issues entre colunas/sprints