--- title: Catálogo de produtos slug: catalogo-de-produtos docTags: createdAt: 2026-08-15T03:05:41.470Z --- :::BlockQuote Cadastre os produtos de software que organizam versões, releases, features e objetivos de negócio do Workspace. ::: :::hint{type="info"} **Pré-requisito: ** Você precisa estar dentro de um Workspace. Um ART pode ser associado ao produto, mas o vínculo com programa é opcional. ::: *** O catálogo de Produtos é a âncora do ciclo de entrega do Agility. Cada produto representa uma solução de software que pode receber releases versionadas, features e riscos. A página também mostra quantos produtos existem, quantos estão associados a um ART/programa e quantas releases antigas ainda estão sem produto. O cadastro mantém o contexto do produto separado de seus objetivos de negócio. Depois de salvar o produto, use Gerenciar na seção Objetivos de negócio para registrar resultados esperados e seus valores planejado e atual. Releases são vinculadas ao produto no próprio formulário de release; features podem ser criadas ou vinculadas dentro do detalhe da release. *** Passo a passo ::::WorkflowBlock :::WorkflowBlockItem **Abrir o catálogo** Na barra lateral do Workspace, abra Produtos. Antes da tabela, confira os indicadores Produtos de software, Vinculados a programa e Releases sem produto. O último é um atalho para a fila de Pendências de vínculo e ajuda a identificar dados legados que ainda precisam de classificação. ::: :::WorkflowBlockItem **Conferir a tabela e localizar um produto** A tabela exibe Produto, Programa, Releases, Riscos e Situação. No nome aparecem também o código e o slug gerados pelo sistema. Use o campo de busca para filtrar por nome, código, slug, descrição ou programa; os filtros Programa e Situação permitem restringir a lista por ART/programa ou por Ativo/Inativo. Clique na linha ou no nome do produto para editar seus dados. ::: :::WorkflowBlockItem **Iniciar um cadastro** Clique em Novo produto. O formulário solicita Nome do produto, ART/Programa, Situação e Descrição. O nome é obrigatório; a API recusa o envio quando ele está vazio. O produto pode ser avulso: em ART/Programa, deixe Sem programa quando não houver um trem ou programa responsável. ::: :::WorkflowBlockItem **Preencher identidade e contexto** Informe um nome que seja reconhecível pelo time, como Portal do Cidadão - Web, e descreva o escopo no campo Descrição. A descrição aceita o contexto funcional e técnico do produto, por exemplo, canal web de serviços digitais com autenticação. Não há seletor de tipo de produto nesta tela: value stream e kind não fazem parte deste cadastro. ::: :::WorkflowBlockItem **Escolher programa e situação** Se o produto pertencer a um ART, selecione-o em ART/Programa; os programas disponíveis são carregados a partir dos ARTs do Workspace. Selecione Ativo para disponibilizá-lo nos cadastros de release ou Inativo para preservar o histórico sem usá-lo em novas entregas. Ao editar, trocar o programa não altera releases já publicadas. ::: :::WorkflowBlockItem **Salvar o produto** Revise nome, programa, situação e descrição e clique em Criar produto. O botão fica desabilitado enquanto o nome estiver vazio. Depois da gravação, o diálogo fecha e a tabela é recarregada; o novo produto passa a ter contagens de releases, riscos e objetivos calculadas pelo servidor. ::: :::WorkflowBlockItem **Abrir os objetivos de negócio** Para um produto já criado, abra-o na tabela e clique em Gerenciar, na seção Objetivos de negócio. Na janela, o campo Produto é somente leitura e confirma o contexto. O seletor Objetivo em edição começa em Novo objetivo e também permite escolher um objetivo existente para atualizá-lo. ::: :::WorkflowBlockItem **Registrar um objetivo próprio** Em Descrição do objetivo, escreva o resultado que o produto deve produzir, por exemplo, aumentar a autonomia do cidadão nos serviços digitais. Escolha Valor planejado na escala 1, 2, 3, 5, 8, 13 ou 21; esse valor representa a importância definida com o objetivo. Em Valor atual, use 0 quando ainda não há progresso ou uma das mesmas opções quando o resultado já evoluiu. ::: :::WorkflowBlockItem **Acompanhar e editar objetivos** Clique em Salvar objetivo. O objetivo aparece em Objetivos deste produto com seus valores planejado e atual, e o painel Valor de negócio somado é recalculado automaticamente a partir da coleção — ele não é um campo digitável. Para atualizar um objetivo, selecione-o em Objetivo em edição, ajuste descrição ou valores e salve novamente; para iniciar outro, escolha Novo objetivo. ::: :::WorkflowBlockItem **Relacionar produto, release e feature** Ao criar uma release, o Produto de software é obrigatório e a versão é única dentro desse produto. No detalhe da release, a aba Features permite usar Nova feature, já com a release selecionada, ou Vincular feature para escolher uma feature existente que ainda não tenha release. Assim, o produto organiza as versões, a release representa uma entrega e a feature descreve uma capacidade incluída nela. ::: :::: :::hint{type="success"} :FontAwesome[]{icon="fa-solid fa-check"} **Verificação** - O produto aparece na tabela com nome, código/slug, situação e contagens derivadas de releases e riscos. - O objetivo salvo aparece em Objetivos deste produto e o Valor de negócio somado reflete a soma dos valores planejados. - O produto pode ser selecionado no campo Produto de software ao criar uma release. - Uma release criada para o produto mostra o nome do produto no catálogo e no cabeçalho do seu detalhe. ::: :::hint{type="warning"} :FontAwesome[]{icon="fa-solid fa-triangle-exclamation"} **Erros comuns** **Nome do produto não informado** O formulário exibe Informe o nome do produto e não permite salvar enquanto o campo estiver vazio. Preencha o nome e tente novamente. **Objetivo sem descrição** A janela de objetivos exige Descrição do objetivo. Se o botão Salvar objetivo estiver desabilitado ou a mensagem de validação aparecer, informe uma descrição antes de escolher os valores. **Tentar criar objetivo antes do produto** No formulário Novo produto, Adicionar fica desabilitado porque ainda não existe um id para o objetivo. Salve o produto primeiro e use Gerenciar na edição. **Alterar o programa esperando mover releases** O programa é apenas o vínculo organizacional do produto; a ajuda do formulário informa que trocá-lo não altera releases já publicadas. Faça a alteração sabendo que o histórico das releases permanece no produto. :::