REFERÊNCIA RÁPIDA DE JIRA
Issues, JQL, fluxos de trabalho, boards, sprints, filtros
Issues
Tipos de Issue
| Epic | Grande conjunto de trabalho; contém histórias |
| Story | Funcionalidade ou requisito voltado ao usuário |
| Task | Unidade de trabalho (técnica ou não técnica) |
| Bug | Defeito ou comportamento inesperado |
| Sub-task | Filho de história/tarefa; não pode existir sozinho |
Campos da Issue
| Summary | Título curto (obrigatório) |
| Description | Detalhes, critérios de aceitação |
| Assignee | Pessoa responsável |
| Priority | Highest / High / Medium / Low / Lowest |
| Labels | Tags livres para agrupamento |
| Components | Subseções do projeto (ex.: Backend, UI) |
| Fix Version | Release que esta issue mira |
| Story Points | Estimativa de esforço (Scrum) |
Links de Issue
| blocks / is blocked by | Relação de dependência |
| clones / is cloned by | Rastreamento de duplicatas |
| relates to | Associação geral |
| is caused by / causes | Relaçã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 EMPTY | Campo sem valor |
| is not EMPTY | Campo 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 Do | Não iniciado |
| In Progress | Em andamento |
| Done | Concluído |
Fluxo Expandido
| Open | Criado, aguardando triagem |
| In Progress | Em desenvolvimento ativo |
| In Review | Revisão de código ou QA |
| Done | Aceito e encerrado |
| Reopened | Retornado do estado Done |
Conceitos de Fluxo
| Status | Estado atual da issue |
| Transition | Movimento permitido entre status |
| Condition | Quem pode realizar uma transição |
| Validator | Verificações antes de executar a transição |
| Post Function | Ação após a transição (ex.: atribuir) |
| Resolution | Motivo do encerramento (Fixed, Won't Do) |
Boards
Tipos de Board
| Scrum Board | Baseado em sprints; backlog, planejamento, velocidade |
| Kanban Board | Fluxo contínuo; limites de WIP, sem sprints |
Colunas do Board
| Column | Mapeia para um ou mais status |
| WIP Limit | Máximo de issues na coluna (Kanban) |
| Swimlane | Agrupamento horizontal (por épico, responsável, etc.) |
| Quick Filter | Filtro de alternância baseado em JQL no board |
Configuração do Board
| Filter | Query JQL que define o escopo do board |
| Estimation | Story Points ou Estimativa Original |
| Card Layout | Campos exibidos nos cards de issue |
| Card Colors | Cor por prioridade, responsável ou query |
Sprints
Ciclo de Vida do Sprint
| Create | Nome + meta e datas opcionais |
| Plan | Arraste issues do backlog para o sprint |
| Start | Defina a duração (tipicamente 1-4 semanas) |
| Active | Time trabalha nas issues do sprint |
| Complete | Mova itens incompletos para o backlog ou próximo sprint |
Relatórios de Sprint
| Burndown Chart | Trabalho restante vs tempo |
| Sprint Report | Concluídos vs não concluídos |
| Velocity Chart | Story points por sprint ao longo do tempo |
| Cumulative Flow | Distribuiçã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
| Search | Escreva JQL na busca de issues |
| Save As | Salve JQL como filtro nomeado |
| Star | Marque um filtro para acesso rápido |
| Subscription | Envie resultados do filtro por email programado |
Compartilhamento e Permissões
| Private | Somente você pode ver o filtro |
| Group | Compartilhe com um grupo específico |
| Project | Compartilhe com membros do projeto |
| Public | Qualquer usuário autenticado |
| Edit Permissions | Controle quem pode modificar o filtro |
Dashboards
| Filter Results | Gadget exibindo issues de um filtro |
| Pie Chart | Distribuição por campo (prioridade, responsável) |
| Two Dimensional | Matriz X/Y (ex.: prioridade vs status) |
| Activity Stream | Atividade recente do projeto |
Atalhos
Navegação Global
| g then d | Ir para o dashboard |
| g then b | Ir para o board |
| g then i | Ir para a busca de issues |
| / | Busca rápida |
| c | Criar issue |
| ? | Mostrar atalhos de teclado |
Visualização de Issue
| a | Atribuir a mim |
| m | Comentar |
| l | Editar labels |
| e | Editar issue |
| j / k | Próxima / issue anterior na lista |
| o | Abrir issue selecionada |
Atalhos do Board
| 1-9 | Mover issue para coluna 1-9 |
| t | Alternar visão de detalhes |
| n | Próximo card |
| p | Card anterior |
Padrões Comuns
Modelo de Relatório de Bug
| Summary | [Componente] Descrição curta do bug |
| Steps to Reproduce | Passos numerados para reproduzir o problema |
| Expected | O que deveria acontecer |
| Actual | O que realmente acontece |
| Environment | SO, navegador, versão, etc. |
| Severity | Blocker / 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 All | Selecione issues dos resultados de busca |
| Bulk Change | Edite, transfira ou exclua em lote |
| CSV Export | Exporte resultados para relatórios |
| Board drag | Arraste issues entre colunas/sprints |