Tags

Uma biblioteca de tags

As tags ficam no nível do projeto. Abra Configurações → Tags para ver a biblioteca: cada tag é uma linha com nome, uma amostra de cor e quantos itens a usam hoje.

As tags são por projeto; não há reaproveitamento entre projetos. Cada roadmap tem seu próprio vocabulário, e mantê-los separados evita que tags antigas de um produto vazem para outro.

Vale para tudo

O modelo de tags é polimórfico: a mesma tag pode ficar em qualquer um destes lugares sem um esquema para cada tipo:

• Itens do roadmap: aparecem como etiquetas nos cartões do quadro e na janela do item.
• Comentários: marque comentários como spam, suporte, pedido-de-recurso durante a moderação.
• Lançamentos: marque segurança, breaking, beta para que leitores filtrem por tipo.
• Feedback (triagem): marque duplicado, falta-info antes de promover a mensagem.
• Perguntas de acompanhamento: tags operacionais como urgente, enviado-pelo-fundador.

Apagar uma tag a remove de todos os lugares onde estava. Apagar um item desfaz a ligação com as tags, mas elas continuam na biblioteca.

Crie enquanto digita

O seletor de tags começa pelo autocompletar. Comece a digitar e as tags existentes vão sendo filtradas. Aperte Enter num nome que ainda não existe e uma etiqueta será criada fica preparada. Ao salvar, as tags existentes são anexadas e as novas criadas de uma vez.

Cancelar o seletor descarta as criações preparadas: nada entra na biblioteca até você salvar.

Nomes normalizados

"Frontend", "frontend" e " Frontend " viram a mesma tag. O seletor não oferece "Criar 'frontend'" quando Frontend já existe.

O nome exibido é o que foi digitado primeiro; buscas posteriores não o reescrevem. Para renomear, faça isso na biblioteca de tags.

Na API pública do roadmap

As tags dos itens do roadmap vão no conteúdo da API pública, para que você mostre etiquetas nas suas próprias páginas de roadmap: bug, melhoria, area/auth. A visibilidade da tag segue a do item: se o item é público, suas tags também são.

Tags em comentários, mensagens da triagem e perguntas de acompanhamento são só para admins e não aparecem em nenhuma página pública.

Tags vindas do seu app

O feedback pode chegar já com tags. O widget, seu backend ou um app enviam nomes de tags junto com a mensagem, e uma chave live só aceita as tags que você permitir nela (Configurações do projeto → Chaves de API → Editar → Tags que esta chave pode definir). Uma chave privada pode definir qualquer tag. Enviar uma tag nunca a cria, e uma tag não permitida recusa a mensagem inteira com um 422, para que erros apareçam enquanto você desenvolve.

Permitir uma tag não a torna pública: tags em feedback continuam só para admins. O guia da API mostra a configuração passo a passo.

Filtrar feedback

O filtro Tag na lista de Feedback mostra mensagens com qualquer uma das tags escolhidas. Ele se combina com os outros filtros, e a API aceita o mesmo como ?tag=bug,crash.

API de tags

Um único endpoint cuida de anexar e substituir tags em todo tipo de item:

PUT /api/v1/projects/{project_id}/{entity_kind}/{entity_id}/tags

{
  "tag_ids": ["01HX...", "01HX..."],
  "names":   ["frontend", "needs-design"]
}

entity_kind é um entre umbrella, comment, release, feedback e follow_up. O corpo substitui todo o conjunto de tags do item. Os names são normalizados, deduplicados e resolvidos com garantir-ou-criar.

Para autocompletar, chame GET /api/v1/projects/{project_id}/tags?q=fro, primeiro os que começam com o texto, depois os que o contêm, no máximo 50.