Histórico de alterações e planejamento
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
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.