Catálogo de produtos
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
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.