Revisão e Aprovação

UI: Revisão e Aprovação / Revisão e aprovação
Público: Iniciadores, revisores e aprovadores do projeto

Para que serve

Criar e executar revisões documentais com workflow (etapas, revisores, aprovar/rejeitar), alinhados aos Approval Flows.

Relevância

Governança: nada avança sem a etapa certa. Pode partir de arquivos, de um Transmittal ou de um Topic. Sem revisões claras, o CDE não distingue “em revisão” de “aprovado para uso”.

Exemplo de uso

O gestor cria uma revisão a partir de 3 plantas, escolhe o workflow Revisão técnica → Aprovação final, inicia o fluxo. Na etapa de Revisão, o revisor reivindica a etapa (modo Único) e submete a decisão do participante. Quando o fluxo chega à Aprovação final, o aprovador decide arquivo por arquivo. Se algum arquivo for REJEITADO, a aprovação final fecha rejeitada; se todos forem APROVADOS, a etapa é concluída e as ações de conclusão (atributos / pasta de destino) são aplicadas conforme o template.

Quem pode usar

Iniciadores, revisores e aprovadores com papel no fluxo (e permissões CDE / projeto correspondentes).

Anatomia da tela

• Listas Revisões ativas / Revisões arquivadas.
• Ribbon Gerenciar / Relatórios / Visualizar.
• Assistente Criar (Escopo → … → Resumo).
• Detalhe (ficha): abas Informações · Arquivos · Etapas · Decisões · Histórico.

Opções e campos

Ribbon

Grupo	Ações
Gerenciar	Criar Revisão · Iniciar · Fechar · Devolver · Enviar ao Iniciador · Pular Etapa · Arquivar · Excluir
Relatórios	Exportar CSV · Exportar Relatório PDF
Visualizar	Filtros · Colunas · Comparar Versões

Colunas / filtros da lista

Status · ID · Rodada · Nome da revisão · Prioridade · Iniciado por · Próxima ação até · Criado em · Arquivos · Progresso · Total de etapas · Etapa atual · Workflow · Próxima ação por · Finalizado em · Aprovado · Rejeitado · Ações.

Filtros: Pesquisar · Status · Prioridade · Iniciado por · Criado em · Próxima ação até · Finalizado em · Total de etapas · Etapa atual · Workflow.

Status: Rascunho · Ativo · Processando · Devolvido · Retornado · Fechado · Arquivado · Cancelado.
Prioridades: Baixa · Média · Alta · Crítica.

Assistente Criar

Etapas: Escopo · Arquivos · Workflow · Revisores · Detalhes · Resumo.

Campo	Função
Escopo	Documentos/arquivos · Transmittal · Topic
Approval workflow	Fluxo do projeto (template)
Nome da revisão / Título · Descrição · Prioridade · Data de vencimento	Identidade da revisão
Revisor(es) e Aprovador(es)	Quem decide em cada etapa
Nome da etapa · Tipo (Sequencial / Paralelo / Consolidação)	Estrutura
Modo do revisor (Único / Grupo)	Um revisor por vez vs grupo
Regra (Todos devem decidir / Qualquer um / Maioria)	Quórum em etapas de grupo
Ação ao concluir · Copiar arquivos aprovados para · Atualizar atributos quando aprovado	Pós-aprovação
Referências vinculadas · Pasta de destino da conclusão	Refs e destino
Salvar como rascunho · Criar e iniciar	Publicar

Detalhe / abas

Aba	Conteúdo
Informações	ID da Revisão · Criado por · Criado · Vencimento · Iniciado · Fechado · Progresso · Rodada · Pasta de destino da conclusão · Observadores
Arquivos	Lista de arquivos; decisões APROVAR/REJEITAR apenas na aprovação final; Transmitir… · Abrir · Download
Etapas	Etapas do workflow, participantes, status da etapa, Submeter decisão (etapas de revisão)
Decisões	Decisões do participante + decisões por arquivo (ver seção abaixo)
Histórico	Linha do tempo de ações (iniciar, reivindicar, decisões, pular, fechar…)

Badges de etapa: Não Iniciado · Aguardando · Em Revisão · Concluído · Pulado · Rejeitado.
Badges de arquivo: APROVAR · REJEITAR (e códigos de status do projeto, se mapeados).

Ações frequentes no cabeçalho do detalhe: Iniciar · Fechar · Reivindicar etapa / Reivindicar etapa · Download PDF · Criar transmittal · menu (Pular etapa · Chamar de volta · Cancelar…).

Transmitir… no detalhe do arquivo pode mostrar “Transmittal não está disponível ainda.” em alguns status — somente após a revisão ser elegível (tipicamente fechada/aprovada conforme as regras).

Como funciona o fluxo de execução

Esta seção descreve o comportamento esperado no aplicativo — útil para usuários e para QA.

Dois tipos de etapa

Tipo de etapa	O que o revisor faz	Onde na UI
Revisão (intermediário)	Decide na etapa como participante (aprovar / rejeitar a etapa)	Aba Etapas (e resumo em Decisões)
Aprovação final (Final approval)	Decide arquivo por arquivo (APROVAR / REJEITAR)	Aba Arquivos

A mesma revisão pode ter várias etapas de revisão e uma etapa de aprovação final no fim do template.

Reivindicar etapa (Reclamar passo)

• Só aparece quando a etapa ativa está em modo Único (um revisor por vez).
• Serve para reservar a etapa para você.
• Não “libera modelos/arquivos” em qualquer etapa: nas etapas de Revisão, a reivindicação não ativa APROVAR/REJEITAR na aba Arquivos.
• Na Aprovação final (Único), a reivindicação é normalmente necessária antes de você poder decidir os arquivos.

Etapa de Revisão ativa

1. Abre a revisão → aba Etapas.
2. Se o modo for Único → Reivindicar etapa.
3. Submeter decisão do participante nessa etapa.
4. Na aba Arquivos é normal ver a mensagem de que você não tem permissão para decidir sobre estes arquivos — as decisões por arquivo só existem na aprovação final.

Etapa de Aprovação final ativa

1. A etapa deve estar Em revisão (não “Não iniciado”).
2. Se Único → Reivindicar etapa.
3. Na aba Arquivos, decida cada arquivo (APROVAR / REJEITAR), um a um ou em massa quando a UI permitir.
4. Cada decisão de arquivo grava imediatamente — não há rascunho + botão “submeter o pacote no fim”.
5. Enquanto a etapa final ainda está ativa, você pode alterar a decisão de um arquivo (voltar a decidir o mesmo arquivo).
6. Quando o último arquivo recebe decisão, o sistema consolida automaticamente:
   • Todos APROVADOS → etapa final Concluída (e o fluxo segue / fecha conforme o template).
   • Qualquer REJEITADO → etapa final Rejeitada e a revisão passa para o status de retorno/fechamento correspondente (Devolvido / concluído rejeitado na UI). Não há tela extra “confirmar resultado do pacote”.

Depois do fechamento

• Você já não pode mudar decisões de arquivo.
• A mensagem de sem permissão na aba Arquivos é esperada.
• O botão Alterar na aba Decisões ainda pode aparecer e apenas navega para Arquivos — aí o sistema bloqueia. Isso não significa que a regra de negócio esteja errada.

Como ler a aba Decisões

Há dois tipos de decisão na mesma aba:

1. Decisões de participante — cards por pessoa/etapa (etapas tipo Revisão), com badge Aprovado/Rejeitado.
2. Decisões por arquivo — listadas por arquivo, com o nome de quem decidiu (aprovação final).

Importante:

• Na Aprovação final, o aprovador não cria um card de “participante Aprovado/Rejeitado” no mesmo estilo da etapa de revisão — só decide nos arquivos. Por isso pode parecer que “falta” a decisão do usuário final nos contadores de participante.
• Os contadores do topo (X aprovado(s) / Y rejeitado(s)) contam apenas decisões de participante, não os APROVAR/REJEITAR dos arquivos. Você pode ver 1 aprovado / 0 rejeitado no topo e mesmo assim ter um arquivo REJEITADO na lista — comportamento atual da UI, não prova que o REJEITADO foi ignorado.

Checklist rápido (esperado)

Situação	Resultado esperado
Aba Arquivos na etapa Revisão	Mensagem de sem permissão para decidir arquivos
Reivindicar na etapa Revisão	Reserva a etapa; não libera APROVAR/REJEITAR de arquivos
Entrar em Aprovação final + reivindicar (Único)	Passa a poder decidir arquivos
Alterar decisão de um arquivo antes de todos estarem decididos	Permitido
Último arquivo com 1 REJEITADO (mesmo com outros APROVADOS)	Etapa final Rejeitada; fluxo fecha sem confirmação manual extra
Todos os arquivos APROVADOS	Etapa final concluída / avança
Depois de fechado, tentar mudar arquivo	Bloqueado
Aba Decisões: aprovador final	Aparece nas decisões por arquivo, não como segundo card de participante da etapa 1

Como usar

Abrir

1. CDE → Review & Approval.
2. Abre um item em Revisões ativas (ou Revisões arquivadas).

Criar e iniciar

1. Criar Revisão.
2. Percorre o assistente (Escopo → Arquivos → Workflow → Revisores → Detalhes → Resumo).
3. Criar e iniciar (ou Salvar como rascunho e depois Iniciar).

Executar como revisor (etapa de Revisão)

1. Abre o detalhe da revisão ativa.
2. Aba Etapas → se Único, Reivindicar etapa.
3. Submeter decisão do participante.
4. Não espere decidir arquivos nesta etapa.

Executar como aprovador final

1. Confirma que a etapa atual é Aprovação final / Aprovação final e está Em revisão.
2. Se Único → Reivindicar etapa.
3. Aba Arquivos → APROVAR / REJEITAR por arquivo.
4. Ao completar o último arquivo, o resultado consolida sozinho (ver seção acima).

Fechar / arquivar / transmitir

1. Quando o fluxo terminar, usa Fechar / Arquivar conforme o status e suas permissões.
2. Criar transmittal pode ficar disponível em revisões fechadas elegíveis.
3. Notificações: Notificações do Projeto.

Ligações

• Approval Flows · Status de documentos · Configuração do CDE · Transmittals · Topics

Dicas / erros comuns

• “Não posso decidir arquivos” na etapa Revisão — esperado. Só na Aprovação final.
• Reivindicação não desbloqueou os arquivos — confirma se a etapa ativa é realmente a aprovação final (não uma etapa de revisão intermediária).
• Aprovei 2 e rejeitei 1 e o fluxo ficou rejeitado — esperado: qualquer REJEITADO na aprovação final rejeita a etapa. Não há confirmação manual do “pacote”.
• Queria mudar a decisão depois de fechar — só é possível enquanto a aprovação final ainda está ativa; depois do fechamento, não.
• Na aba Decisões só vejo o usuário da etapa 1 — o aprovador final conta nas decisões por arquivo; os contadores Aprovado/Rejeitado do topo ignoram arquivos.
• Sem workflow/template no projeto, Criar fica limitado — configure Approval Flows.
• Diferente de Design RFA — RFA.
• Pular Etapa / Devolver / Chamar de volta alteram o caminho — use com critério (Pular marca a etapa como ignorada e avança).