--- title: Histórico de alterações e planejamento slug: historico-de-alteracoes-e-planejamento docTags: createdAt: 2026-08-15T01:20:31.588Z --- :::BlockQuote Acompanhe a trilha de auditoria do projeto e use a tela de Planejamento para governar requisitos, aprovações, entregas e conclusão. ::: :::hint{type="info"} **Pré-requisito:** O projeto precisa ter as capacidades efetivas Histórico e Requisitos. O histórico é somente leitura; alterações são registradas automaticamente no momento em que o servidor grava uma entidade. ::: *** Histórico é a trilha de versões do projeto, dos requisitos e das tarefas provisionadas no Board principal. Cada registro identifica a ação, o tipo de entidade, o código e o rótulo no momento da alteração, a versão, o autor, a data e a comparação dos campos de antes para depois. A tela não oferece editar, restaurar ou apagar uma versão: ela documenta o que realmente foi gravado. Planejamento é a superfície de governança dos requisitos do projeto. Além de criar requisitos e exibir prioridade, origem e critério de aceite, ela permite aprovar, vincular entregas, desvincular relações e concluir quando a cadeia de entrega estiver completa. A filtragem e a trilha ajudam a explicar quando e por que uma decisão de planejamento foi tomada. *** ### Passo a passo ::::WorkflowBlock :::WorkflowBlockItem **Abrir o Histórico** No projeto, selecione Histórico. Aguarde o carregamento da trilha; se o projeto não tiver a capacidade efetiva, a rota mostra Histórico indisponível e a explicação da permissão, sem fingir que não existem alterações. Em uma trilha populada, a versão mais recente aparece primeiro. ::: :::WorkflowBlockItem **Interpretar uma linha de versão** Leia os marcadores de ação, como Cadastrou, Alterou ou Vinculou entrega, seguidos do tipo (Projeto, Requisito ou Tarefa). O código e o rótulo identificam a entidade, v4 por exemplo identifica a quarta versão, e a linha seguinte informa o ator projetado e o instante formatado. Se o diretório não resolver o nome, a tela usa Usuário indisponível em vez de expor um UUID. ::: :::WorkflowBlockItem **Ler a comparação de→para** Em cada alteração, o nome do campo aparece com o valor anterior, uma seta e o novo valor. Cadastros mostram apenas o valor que passou a valer; remoções exibem o destino como um traço. Rótulos e enums são traduzidos para a linguagem da interface, como Situação, Rascunho e Aprovado, tornando a leitura útil para auditoria sem consultar o banco. ::: :::WorkflowBlockItem **Filtrar o escopo da trilha** Use o seletor no canto do cartão para escolher Todas, Projeto, Requisito ou Tarefa. A seleção é enviada ao servidor como entityKind, e não apenas filtrada no navegador; desse modo, versões antigas daquela espécie não desaparecem por terem ficado fora do limite geral. Troque novamente para Todas para reconstruir a visão completa. ::: :::WorkflowBlockItem **Entender o limite de leitura** Se a quantidade devolvida alcançar o limite, a mensagem Mostrando as alterações mais recentes informa que a lista é parcial. Isso é uma proteção de leitura, não uma indicação de que o histórico terminou. Use o filtro por espécie para concentrar a investigação, ou consulte a política de retenção da sua instalação quando precisar de uma auditoria mais antiga. ::: :::WorkflowBlockItem **Abrir o Planejamento** Volte à navegação do projeto e selecione Planejamento. A tela carrega requisitos e, quando o projeto tem escopo SAFe, os épicos, features e histórias disponíveis para vínculo. Um projeto sem esse escopo continua podendo registrar requisito; nesse caso, os alvos da hierarquia ficam vazios e o vínculo com tarefa continua sendo feito no detalhe da tarefa. ::: :::WorkflowBlockItem **Registrar e priorizar uma necessidade** Clique em Novo requisito e preencha Título, Descrição opcional, Origem, Prioridade (Alta, Média ou Baixa) e Critério de aceite. Após salvar, confira a linha RQ com situação Rascunho. Use a prioridade para ordenar a conversa de planejamento, sem substituir a justificativa da origem nem o critério verificável. ::: :::WorkflowBlockItem **Aprovar e acompanhar o estado** Enquanto o requisito estiver em Rascunho, clique em Aprovar para marcá-lo como Aprovado. A linha oferece Concluir até chegar a Concluído, mas o servidor verifica a regra de negócio: sem entrega vinculada, a ação retorna uma mensagem explicando o que falta. Use o erro como orientação, vincule a entrega e tente novamente. ::: :::WorkflowBlockItem **Manter entregas e vínculos atualizados** Clique em Vincular na linha e selecione um épico, feature ou história que ainda não esteja ligado. Para tarefas, vá ao cartão Requisitos atendidos na própria tarefa. Remova uma relação pelo ícone de desvincular e confirme que o histórico registra a ação de vínculo ou desvínculo, com a comparação do campo Entregas vinculadas. ::: :::WorkflowBlockItem **Usar as duas telas em uma auditoria** Comece no Histórico filtrando Requisito para descobrir quando uma prioridade, situação ou entrega mudou. Abra Planejamento para conferir o estado atual, o critério de aceite e os destinos clicáveis. Se a mudança envolveu execução, filtre Tarefa e abra o detalhe da tarefa pelo caminho do requisito; assim a investigação conecta decisão, entrega e trabalho realizado. ::: :::: :::hint{type="success"} :FontAwesome[]{icon="fa-solid fa-check"} **Verificação** - O Histórico mostra autor, instante, versão, ação e mudanças em ordem da mais recente para a mais antiga. - O filtro de escopo muda a consulta e exibe somente Projeto, Requisito ou Tarefa quando selecionado. - A comparação apresenta valores traduzidos de antes e depois, inclusive alterações de situação e entregas vinculadas. - No Planejamento, um requisito aprovado mantém prioridade, origem e critério de aceite e só é concluído depois que uma entrega foi vinculada. - Um vínculo ou desvínculo realizado no Planejamento ou no detalhe da tarefa aparece como evento rastreável no Histórico. ::: :::hint{type="warning"} ****:FontAwesome[****]{icon="fa-solid fa-triangle-exclamation"}** Erros comuns** **O Histórico aparece indisponível** Confirme que a capacidade Histórico está habilitada para o projeto e que sua permissão efetiva permite leitura. A tela bloqueia o acesso quando essa capacidade não está disponível; não há botão local para editar essa configuração. **A trilha não mostra uma alteração esperada** Confira o escopo selecionado e o limite indicado no rodapé. O servidor pode ter devolvido apenas as alterações mais recentes. Troque para Todas ou para a espécie correta e verifique se a operação realmente foi confirmada pela tela de origem. **O planejamento fica sem alvos para vínculo** É normal em projetos sem escopo SAFe: épicos, features e histórias são carregados como listas vazias. Crie ou associe a hierarquia SAFe quando fizer sentido; para uma tarefa existente, faça a ligação no detalhe da tarefa. **A conclusão do requisito é recusada** Leia o alerta devolvido pelo servidor e verifique a lista de entregas na linha. Vincule pelo menos uma entrega válida e confirme que ela permanece ligada antes de clicar em Concluir novamente. :::