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). |
| Pronto / Processando (exclusivo de modelos 3D) | O modelo está sendo convertido/preparado após o upload, antes de entrar no workflow. |
O fluxo exato (quantas etapas, quem decide em cada uma) é configurado por disciplina e pode ser diferente entre projetos.
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, quem são os responsáveis por liberá-la.
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.
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. Na biblioteca
dá para recarimbar o lote selecionado e filtrar folhas sem QR ou com
posição própria.
Enquanto o arquivo ainda está em rascunho ou em revisão interna, ele exibe
um indicador de rascunho (ex.: v3 · rascunho); 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.
Publicado congela o markup da prancha — não dá para desenhar anotação
nova no PDF. Dá para criar apontamento clicando na folha ou pelo
botão da toolbar: nasce um AP-n com bolha no ponto, thread e
responsável. Útil quando um projeto de terceiro implica mudança e nova
revisão — 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, espessura do traço, texto (quando aplicável) e a
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 versão em revisão e ficam visíveis para os outros revisores — não é preciso salvar manualmente.
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. No Publicado o markup da revisão continua congelado; o
apontamento na folha continua disponível.
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.
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.
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.