Aprovações e reprovações
Depois de enviado, cada versão de um documento ou modelo percorre um workflow de aprovação — uma sequência de etapas de revisão definida pela disciplina do arquivo. Este capítulo explica os estados possíveis, quem decide em cada etapa e como funciona a fila de revisões.
Versão ≠ revisão ≠ adequação. Cada upload gera uma versão interna
(v1, v2…). A revisão formal (R00, R01…) é atribuída ao
compartilhar (saída do trabalho em andamento) e não muda ao publicar.
O código de adequação (S2, A1…) identifica o propósito do container e
é escolhido nos diálogos de Compartilhar/Publicar. Enquanto a versão não
tiver sido compartilhada, a interface mostra vN · rascunho. Depois,
aparece no formato R03 · S2 ou R03 · A1.
Estados do ciclo de vida
| Estado | O que significa |
|---|---|
| Rascunho | Documento, modelo ou nuvem recém-enviado, ou devolvido para correção, ainda não submetido à revisão. |
| Revisão interna | Única etapa de revisão, dentro do container Trabalho em andamento (WIP) da ISO 19650: o revisor confere o arquivo antes de emitir. Continua sob responsabilidade da equipe de origem — só a disciplina, o autor e a coordenação enxergam o arquivo. |
| Compartilhado | Container Shared da ISO 19650: a versão está disponível às outras equipes para coordenação e informação, ainda sem valor contratual. Já pode entrar em uma transmissão. |
| Devolvido | A versão foi reprovada e precisa ser corrigida pelo autor, que deve enviar uma nova versão. |
| Publicado | Autorizado para uso (container Published) — liberado pelo coordenador/owner, por exemplo para obra ou portal externo. |
| Arquivado | A versão está fora do fluxo ativo (ver Arquivar, lixeira e exclusão). |
| Processando (modelos IFC) | O IFC ou IFCZIP está sendo preparado depois do upload, antes de entrar no workflow. O .rvt com conversão para IFC fica nesta espera até a Autodesk terminar. |
| Pronto (modelos nativos) | .rvt sem conversão e .pln nascem aqui. Não abrem no viewer. Saem de Pronto em Submeter para revisão — ou em Compartilhar, quando o fluxo da disciplina não tem revisão. |
O fluxo exato (quantas etapas, quem decide em cada uma) é configurado por disciplina e pode ser diferente entre projetos. O Plano BIM publicado mostra isso na seção Aprovação: cada disciplina com o fluxo de documentos e o de modelos, e os aprovadores de cada etapa. Disciplinas com o mesmo par de fluxos aparecem juntas.
Revisão e código de adequação
Dois metadados descrevem cada emissão, em eixos independentes:
| Eixo | Exemplos | Quando muda |
|---|---|---|
| Revisão | R00, R01, R03 | Atribuída ao compartilhar; identifica a emissão e permanece igual ao publicar. |
| Adequação | S0 (WIP); S1–S4, S6, S7 (Shared); A1, B1, CR, PR (Published) | Escolhida nos diálogos de Compartilhar e Publicar; identifica o propósito do container. |
Na interface, os dois aparecem juntos: R03 · S2 (compartilhado para
informação) e R03 · A1 (a mesma emissão, autorizada para uso).
A adequação não entra no nome do arquivo — só a revisão (RXX) pode
aparecer na nomenclatura, como auxílio de agrupamento. Veja
Validação de nomenclatura.
Cada projeto nasce com o catálogo de códigos da norma e pode editá-lo em Configurações do projeto → Workflows de Aprovação (adicionar, renomear ou remover códigos). Remover um código só tira a opção das próximas emissões; versões já emitidas mantêm o valor histórico.
Fluxos típicos
Documentos
Alguns projetos usam um fluxo mais simples, sem revisão interna, indo direto de Rascunho para Compartilhado (e, no preset sem revisão, seguindo até Publicado).
Modelos 3D e nuvens de pontos
O ciclo é o mesmo dos documentos: a verificação para compartilhar acontece dentro do WIP. Não há mais etapas formais intermediárias (revisão por par, por disciplina, de coordenação) — esses presets deixaram de existir.
Quem faz o quê
| Ação | Quem pode |
|---|---|
| Enviar para revisão | Qualquer membro ativo do projeto |
| Comentar/revisar em etapa de revisão interna | Revisor designado para a disciplina |
| Compartilhar (avançar para Compartilhado) / Devolver para correção | Aprovador/revisor designado para a etapa atual |
| Publicar | Aprovador designado da etapa Compartilhado (Owner e ADMIN do sistema passam sempre) |
| Compartilhar / aprovar em lote | Coordenador ou Owner |
| Compartilhar / publicar no próprio upload | Coordenador ou Owner, somente se a opção estiver habilitada nas configurações do projeto |
Toda etapa de revisão precisa de pelo menos um aprovador designado. Sem ele a transição trava e a régua mostra o aviso para completar a aba Workflows. O autor não avança a própria revisão interna; o coordenador só decide onde foi designado. Owner do projeto e ADMIN do sistema continuam passando em qualquer etapa.
Você não precisa decorar essa tabela: no documento ou modelo, a régua de status mostra, em cada transição, os aprovadores designados e, ao lado, os proprietários do projeto que ainda não estão naquela etapa — só para orientar quem pode decidir pelo bypass; no quórum todos, só os designados precisam assinar, e o proprietário também pode aprovar sozinho.
Compartilhar ou publicar já no upload
Quando o projeto tem a opção “Permitir avançar no workflow durante o upload” ligada (em Configurações do projeto → Comportamento no Upload), gestores podem, no assistente de envio, marcar o lote para ir direto a Compartilhado e, se quiserem, a Publicado — sem entrar na fila de revisões.
Isso é um atalho gerencial (equivalente a compartilhar/publicar depois), útil quando o coordenador já está enviando arquivos que ele próprio vai validar. O detalhe da tela e o comportamento em documentos versus modelos 3D estão no capítulo Processo de upload (seção Avançar no workflow no próprio upload).
A fila de revisões
Há duas entradas para a mesma ideia:
| Onde | O que mostra |
|---|---|
| Home → chip “N revisões” | Abre a página global /revisões, com documentos e modelos IFC em revisão em todos os seus projetos. |
| Projeto → Revisões | A mesma fila, filtrada àquele projeto. |
Em ambos os lugares você vê o que precisa da sua atenção:
- Itens em que você é o aprovador da etapa atual — para decidir compartilhar/aprovar ou devolver;
- Itens em revisão interna dos quais você é o autor — para acompanhar comentários pendentes.
O filtro Só o que depende de mim restringe a lista a esses dois casos. A lista é atualizada em tempo real conforme o andamento muda.
Itens em revisão interna só aparecem para quem pode abrir o arquivo (equipe da disciplina, autor ou coordenação) — a fila não lista o que responderia 404 ao clicar. O aprovador designado da etapa precisa estar alocado na disciplina (ou ser Owner/Coordenador).
Na página do projeto, uma seção Resolvidos recentemente mostra documentos já compartilhados, com a opção de selecionar vários e criar uma transmissão diretamente a partir dali.
Passo a passo — revisar um documento
- Abrir a página Revisões e selecionar o documento na lista.
- Se o documento estiver em revisão interna, é possível:
- Marcar o PDF com o conjunto completo de ferramentas de anotação (ver Ferramentas de anotação sobre o PDF);
- Enviar um arquivo revisado, substituindo o PDF sem criar uma nova versão formal;
- Comparar visualmente com a versão anterior;
- Devolver ao autor para tratar os comentários (sem alterar o status
formalmente), ou Compartilhar para avançar ao container Shared —
o diálogo pede o código de adequação (ex.: S1–S4) e atribui a
revisão formal (
R00,R01…).
- Em etapas formais de aprovação (quando o workflow as tiver):
- Aprovar — avança a versão para a próxima etapa do workflow;
- Devolver para correção — exige um comentário explicando o motivo; o documento volta ao estado de Rascunho para o autor corrigir.
Ao ser devolvido, o autor recebe uma notificação (e um e-mail) com link direto para a página de revisões, vê o motivo da devolução e pode enviar uma nova versão a partir do mesmo documento.
Vários envios ou devoluções seguidos no mesmo projeto saem num único e-mail (lista resumida), depois de cinco minutos sem novidade — com teto de quarenta e cinco minutos desde o primeiro item. Um evento isolado continua com o e-mail individual de sempre.
Publicação
Depois que uma versão está Compartilhada, ela pode ser Publicada — autorização para uso. A publicação é a liberação oficial da versão; a partir daqui ela pode, por exemplo, ficar visível no portal externo (conforme configuração do projeto).
Ao publicar, a plataforma mantém a mesma revisão (R03 continua R03) e
pede um novo código de adequação da série publicada (ex.: A1, B1).
PDF publicado recebe um carimbo QR com a emissão (R03 · A1). O QR
abre a página de checagem do portal: a folha impressa está vigente,
superada ou à frente. Se o portal mostra modelos, a mesma página oferece
abrir o 3D da disciplina na última etapa. Canto e margens vêm do projeto; no detalhe da folha
o carimbo se arrasta sobre a prancha, e posições nomeadas (presets) se
reaplicam na família de plantas com o mesmo bloco de título. Em PDF com
várias páginas dá para gravar o QR só na folha que você está vendo, em
vez de herdar o padrão do projeto. Na biblioteca
dá para recarimbar o lote selecionado e filtrar folhas sem QR ou com
posição própria. Publicar sem portal ainda carimba: o gesto cria o
link de verificação na hora.
Assinatura eletrônica (D4Sign)
Publicar autoriza o uso da folha no CDE. Assinar abre o envelope jurídico na D4Sign — outro gesto, outro lugar. O módulo Assinatura Digital nasce desligado: o interruptor fica em Configurações do projeto → Módulos. Desligado, o botão Assinar some da biblioteca e do detalhe; religar devolve o gesto, sem apagar envelopes já enviados.
Quem vê Assinar continua sendo o aprovador designado da disciplina
(os chips da aba Workflows). Dono e coordenador não entram só pelo
cargo. Quem recebe o convite são os membros da lista Assinam,
na mesma aba — independente de quem aprova. Vários signatários entram
no mesmo envelope, em paralelo. Sem ninguém nessa lista, a folha não
oferece Assinar e a publicação segue sem envelope. Publicado
sem QR é carimbado antes do envio. Envelope no cofre sem convite
continua assinável; só depois do e-mail o ícone pinta “aguardando” e
abre o detalhe dos signatários na coluna de status e copia o link
de assinatura enquanto o envelope está em curso. Quando a D4Sign
finaliza, a biblioteca importa o PDF assinado — mesmo se o webhook não
chegou — e o ícone oferece baixar o assinado. Na seleção da
biblioteca, Baixar assinados junta só as vias com assinatura digital
(_assinado no nome). Envelope cancelado no cofre volta a admitir
Assinar. Folha já assinada oferece Assinar novamente no detalhe
e na seleção: sobe de novo a folha publicada (não o PDF assinado), na
mesma revisão, com posição nova no diálogo. Até a assinatura voltar, o
download entrega a folha publicada. Prancha CAD (xref compactado) é
normalizada antes do upload — a D4Sign passa a ler o arquivo.
A D4Sign recebe um ponto âncora, não um desenho. Canto e margens do pin
são independentes do QR (default deslocado para não empilhar). No
diálogo Assinar dá para arrastar a caixa na prancha e gravar posição
própria; presets nomeados são outra lista, não a do carimbo. Com várias
páginas, a assinatura completa pode ir só na folha escolhida — as demais
seguem rubrica ou ficam de fora, conforme o projeto. Se o pin
falhar, o e-mail ainda sai. Envelope em curso não reposiciona — o pin
novo vale só no Assinar novamente, no envelope seguinte.
Enquanto o arquivo ainda está em rascunho ou em revisão interna, ele exibe
um indicador de rascunho (ex.: v3 · rascunho); na coluna Rev da
tabela a palavra vira WIP para caber. O código de revisão só
aparece após o primeiro compartilhamento. O formato do código de revisão
(prefixo e número de dígitos) é configurável por projeto.
Nas bibliotecas de documentos e de modelos, Última revisão (na faixa de disciplinas) deixa cada arquivo só na revisão mais alta da etapa em que você está. As revisões anteriores continuam no histórico do item.
A tinta se desenha só na revisão interna, e só o revisor designado escreve. Ao compartilhar, publicar ou devolver, essa tinta sai da folha. O que já estava gravado como marcação formal ou de coordenação continua visível, só para leitura. O apontamento na folha vale em Compartilhado, Publicado e Devolvido — ver A partir do PDF.
Aprovação em lote
Coordenadores e owners avançam em lote as versões mais recentes na biblioteca. Em documentos, a ação também existe na página de progresso do projeto, com confirmação explícita. Em modelos, a barra de seleção oferece compartilhar e publicar com um código de adequação para o ato — a revisão de cada modelo continua na série dele. A coordenação do 3D continua sendo o apontamento BCF, não a aprovação em lote dos documentos.
Ferramentas de anotação sobre o PDF
O revisor de PDF tem uma barra de ferramentas de marcação no estilo Snagit: você desenha sobre a prancha e depois pode mover, redimensionar e reestilizar cada marca. Todas as ferramentas funcionam também em pranchas escaneadas (só imagem) — a única exceção é o grifo de texto, que precisa de PDF com texto selecionável.
| Ferramenta | Atalho | Para que serve |
|---|---|---|
| Mão (pan) | V ou Espaço | Navegar pela prancha sem marcar nada |
| Grifar texto | T | Grifar trechos de texto selecionável |
| Realce por caixa | H | Retângulo translúcido — funciona em prancha só imagem |
| Retângulo livre | — | Delimitar uma área do desenho |
| Seta | A | Apontar para um detalhe |
| Chamada de detalhe | C | Balão de texto com linha até o ponto comentado |
| Caixa de texto | N | Texto solto, sem seta |
| Passo numerado | S | Marcar 1, 2, 3… em sequência num roteiro de correções |
| Lupa | L | Ampliar uma região ao lado, para detalhes pequenos |
| Nuvem de revisão | — | Marcação de revisão no padrão de projeto |
| Desenho livre | — | Traço à mão livre |
Com Shift pressionado, seta, retângulo e linha travam no múltiplo de 45° mais próximo.
Painel de propriedades
Ao selecionar uma marca, um painel lateral abre com as propriedades dela:
cor, preenchimento (sólido, hachura geométrica ou de material), opacidade,
cantos, ponta da seta, fonte e texto — e os
apontamentos da prancha. A barra
também tem seletor de espessura, e Desfazer (Ctrl+Z) / Refazer
(Ctrl+Shift+Z) para as últimas ações.
As marcações são salvas automaticamente na revisão interna vigente e ficam visíveis para quem abre essa versão — não é preciso salvar manualmente. Versão antiga e qualquer etapa fora da revisão interna abrem só para leitura.
Criar apontamento a partir do PDF
Com o módulo Apontamentos ligado no projeto, o clique na prancha (ou
o botão Novo apontamento da toolbar) cria um apontamento BCF no
ponto: bolha, thread, responsável e número AP-n. Não é mais um pin
à parte — a conversa sobre a folha é o mesmo apontamento da lista do
projeto. Isso vale depois da revisão interna: Compartilhado,
Publicado e Devolvido. No rascunho e na revisão interna o gesto
é a tinta, não o apontamento.
O apontamento nasce Ativo. A visibilidade no diálogo do PDF começa em Interno (dá para mudar para Rascunho ou Público). O detalhe está em Apontamentos (BCF) — a partir do PDF.
Exportar PDF
O botão Exportar PDF gera uma cópia do arquivo com todas as anotações embutidas (não como camada de comentário, mas desenhadas no PDF) e uma página de índice no início, numerando cada marcação com a página onde ela está e o comentário associado. É o formato indicado para enviar a revisão a quem não tem acesso à plataforma. O botão só aparece na revisão interna da versão vigente.
Revisão de modelos 3D
Para modelos, a revisão não usa anotações em PDF — ela é feita através de apontamentos BCF dentro do visualizador 3D. O botão Visualizar e Apontar, disponível na biblioteca de modelos, abre o modelo já filtrado para a versão em revisão. Veja o capítulo Apontamentos (BCF) e comentários para o detalhe completo desse processo.
Para coordenadores e administradores
Cada disciplina do projeto tem um workflow associado, escolhido entre os presets disponíveis (aprovação automática ou revisão interna simples). Os aprovadores de cada etapa são designados por disciplina nas configurações do projeto. Com a Assinatura Digital ligada, cada etapa de documento ganha também a lista Assinam — quem entra no envelope, sem avançar o workflow.
Algumas etapas podem exigir aprovação de vários aprovadores (quórum) antes de a versão avançar — nesse caso, aprovações individuais são registradas, mas o status só muda quando o quórum é atingido.
A publicação é tratada como uma ação gerencial da etapa Compartilhado — só coordenador/owner (ou o aprovador designado dessa etapa) pode publicar.
O catálogo de códigos de adequação do projeto (semeado com os códigos da ISO 19650) é editável em Configurações do projeto → Workflows de Aprovação e alimenta os seletores dos diálogos de Compartilhar e Publicar. No portal externo, além dos status visíveis, é possível filtrar quais códigos de adequação o cliente enxerga — veja Transmissão.