Issues

A issue é a unidade fundamental de trabalho no CloudTasks. Equivale ao ticket no Jira, ao card no Trello ou ao issue no Linear.

Criando uma issue

Via botão: No projeto aberto, clique em + Nova issue.

Via atalho: Pressione C em qualquer tela com um projeto aberto.

Via API: POST /api/v1/workspaces/{slug}/projects/{id}/issues

Campos no formulário de criação

• Título (obrigatório): descrição curta e clara do trabalho
• Tipo: Tarefa, Bug, História, Épico ou Subtarefa
• Status: status inicial (padrão: primeiro status todo do projeto)
• Prioridade: Urgente, Alta, Média, Baixa ou Nenhuma
• Responsável: membro do workspace
• Etiquetas: uma ou mais labels do workspace
• Data de início e Prazo
• Estimativa: pontos ou horas (configurável)
• Parent: issue pai (cria uma sub-issue)
• Descrição: corpo em Markdown

Chave da issue

Ao criar, a issue recebe automaticamente uma chave no formato PROJ-N, onde PROJ é o identificador do projeto e N é um contador sequencial por projeto. Exemplos: CT-1, CT-42, INFRA-7.

A chave é imutável e pode ser usada para:

• Referenciar a issue em comentários (CT-42)
• Buscar diretamente na paleta (Cmd+K → digitar CT-42)
• Linkar na URL: /issues/CT-42
• Referenciar em commits e PRs

Visualizando e editando

Clique em qualquer issue na lista ou no quadro para abrir o painel de detalhes. Todos os campos são editáveis inline — clique no campo para editar.

A descrição usa Markdown completo:

## Contexto

Usuários relatam que o login com Google falha em dispositivos iOS 17+.

## Passos para reproduzir

1. Abrir o app em iPhone com iOS 17
2. Clicar em "Entrar com Google"
3. Completar o fluxo OAuth
4. Observar erro 401 ao retornar

## Comportamento esperado

Usuário deve ser autenticado e redirecionado para o dashboard.

## Logs

[ERROR] oauth: state mismatch — expected abc123, got xyz789

Sub-issues

Para decompor uma issue em partes menores:

1. Na issue pai, clique em Adicionar sub-issue
2. Ou crie uma issue nova e defina o campo Parent

A issue pai exibe uma barra de progresso mostrando quantas sub-issues estão concluídas. Exemplo: 3/5 concluídas.

Sub-issues herdam o projeto da issue pai. Sub-issues de épicos são automaticamente do tipo "Subtarefa" se não especificado.

Relações entre issues

Na issue, clique em Adicionar relação:

Relação	Quando usar
Bloqueia	Esta issue precisa ser concluída antes que a outra comece
É bloqueada por	Esta issue só pode ser iniciada após a conclusão de outra
Relaciona com	Conexão genérica de contexto, sem dependência temporal
Duplica	Esta issue é a mesma que outra — a outra pode ser fechada

As relações são bidirecionais e aparecem em ambas as issues.

Mover entre projetos

Para mover uma issue para outro projeto dentro do mesmo workspace:

1. Abra a issue
2. Clique no nome do projeto no cabeçalho
3. Selecione o projeto destino

A issue recebe uma nova chave no projeto destino (ex: CT-42 vira BACK-15). A chave antiga não é mais válida. Sub-issues são movidas junto com a parent.

Deletar issue

Deletar uma issue remove permanentemente ela e todas as sub-issues filhas. URLs curtas associadas são desativadas.

Para deletar: abra a issue → menu (...) → Deletar issue.