# Referência Rápida de Jira

*Issues, JQL, fluxos de trabalho, boards, sprints, filtros*

> Source: Jira Documentation (support.atlassian.com) · MIT

## Issues

### Tipos de Issue

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `=` | 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

| Command | Description |
|---------|-------------|
| `To Do` | Não iniciado |
| `In Progress` | Em andamento |
| `Done` | Concluído |

### Fluxo Expandido

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `Scrum Board` | Baseado em sprints; backlog, planejamento, velocidade |
| `Kanban Board` | Fluxo contínuo; limites de WIP, sem sprints |

### Colunas do Board

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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

| Command | Description |
|---------|-------------|
| `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 |