Guia do Usuário — CDE
Bem-vindo ao guia de uso da plataforma. Este material explica, em linguagem simples, como usar o dia a dia da plataforma em duas frentes:
- o CDE (Ambiente Comum de Dados): enviar arquivos, seguir o fluxo de aprovação, comentar em modelos 3D, transmitir documentos a terceiros e organizar o que não é mais necessário;
- os módulos de gestão: acompanhar oportunidades no Comercial, controlar honorários em Contratos e gerir o caixa no Financeiro.
Este guia é versionado junto com o sistema: sempre que uma funcionalidade mudar, os capítulos correspondentes devem ser atualizados na mesma alteração.
O escritório novo nasce em signup.catena.build : endereço, conta de administrador e um passo a passo (perfil, identidade e catálogos). Quem já tem organização entra pelo subdomínio — e-mail e senha ou Entrar com Google (só se a conta ou o convite já existirem). Esqueceu a senha? Use Esqueci a senha na tela de login; o link do e-mail vale 1 hora e, depois de redefinir, as sessões antigas caem.
O que é um CDE
CDE significa Common Data Environment (Ambiente Comum de Dados). É o lugar único onde todos os documentos e modelos 3D de um projeto de construção/engenharia são armazenados, revisados, aprovados e distribuídos.
A ideia central é simples: em vez de cada pessoa guardar sua própria cópia de arquivos (por e-mail, pendrive, pasta compartilhada), todo mundo trabalha sobre a mesma fonte de verdade, com regras claras sobre:
- quem pode enviar um arquivo novo;
- como o arquivo deve ser nomeado, para ser identificado sem ambiguidade;
- quem precisa revisar e aprovar antes de ele valer oficialmente;
- quem pode publicá-lo para uso em obra ou para envio a terceiros;
- o que acontece com versões antigas ou desatualizadas.
Isso garante rastreabilidade completa: a qualquer momento é possível saber qual é a versão vigente de um documento, quem a aprovou, quando foi transmitida e para quem.
Conceitos-base
| Conceito | O que significa |
|---|---|
| Projeto | O empreendimento/obra dentro do qual todos os documentos e modelos existem. |
| Disciplina | Área técnica do arquivo (Arquitetura, Estrutura, MEP, etc.). Cada disciplina pode ter seu próprio fluxo de aprovação. |
| Etapa / Fase | Momento do projeto ao qual o arquivo pertence (ex.: Estudo Preliminar, Projeto Executivo). |
| Documento | Arquivo 2D (PDF, DWG, planilha, imagem etc.). |
| Modelo 3D | Arquivo IFC (modelo BIM), processado e visualizado no viewer 3D da plataforma. A geometria abre primeiro; se um federado estiver longe, o selo Distante oferece alinhar aos demais. Também sobe direto do Revit — ver Revit: projeto, IFC, apontamentos, links e clashes. .rvt sem conversão e .pln ficam em Pronto até submeter. Peças traçadas na sessão saem em Modelar no visualizador. |
| Nuvem de pontos | Levantamento (laser scanner / fotogrametria) convertido para COPC e sobreposto ao BIM no mesmo viewer, com panorâmica, planicidade e recorte. |
| Versão | Cada novo envio do mesmo documento ou modelo gera uma nova versão interna (v1, v2, v3…). O histórico completo é preservado. |
| Revisão | Código formal público (ex.: R00, R01), atribuído automaticamente quando a versão é compartilhada. Não muda ao publicar. Enquanto estiver em rascunho ou em revisão interna, a interface mostra vN · rascunho. O RXX no nome do arquivo não define a revisão no sistema. |
| Adequação | Código de propósito da emissão (ex.: S2, A1), independente da revisão. Escolhido ao compartilhar ou publicar; aparece junto da revisão (R03 · S2). Não entra no nome do arquivo. |
| Workflow | A sequência de etapas de revisão/aprovação que uma versão percorre até ser considerada válida. |
| Status | O estado atual de uma versão dentro do workflow (Rascunho, Revisão interna, Compartilhado, Publicado, etc.). |
| Transmissão | O registro formal de entrega de documentos compartilhados ou publicados a alguém (equipe interna ou terceiros). |
| Portal | Área de acesso externo, sem necessidade de login, usada para destinatários de fora da organização acessarem os arquivos transmitidos. |
| Plano de execução BIM (BEP) | Documento do projeto com usos BIM, LOD, software, coordenadas e federação. Montado em Configurações → Plano BIM, publicado em revisões (R01, R02…) e, se ligado, exibido no portal. |
Papéis e permissões (visão geral)
| Papel | O que pode fazer |
|---|---|
| Owner (proprietário) | Acesso total ao projeto: configura workflows, compartilha, publica, arquiva, gerencia a lixeira e o portal externo. |
| Coordenador | Mesmas capacidades de gestão do dia a dia: compartilhar, publicar, arquivar, gerenciar a lixeira, criar/enviar transmissões. |
| Membro | Envia arquivos, participa das revisões quando designado como aprovador, cria transmissões, comenta em modelos 3D, publica vistas e SmartViews para o projeto. |
| Colaborador | Envia e revisa como membro; publica vistas e SmartViews para o projeto. |
| Visualizador | Somente leitura no projeto; não publica vistas compartilhadas. |
| Externo | Papel para participantes de fora da organização (ex.: cliente, consultor) com acesso mais restrito, geralmente via portal. |
Cada capítulo deste guia detalha, quando relevante, quais papéis podem executar cada ação.
Organização e acesso
Cada escritório é uma organização dentro da plataforma, com seus próprios projetos, pessoas e cadastros. O que você vê depende da organização a que pertence.
Convites
Quando alguém é adicionado à organização (Configurações → Usuários), recebe um e-mail com link para definir a senha (7 dias). Quem entra só em um projeto (convite com login, sem conta ainda) cria uma conta mínima: após a senha, abre direto o projeto — sem Início, Drive, Chat nem demais módulos do escritório; na lista de projetos ficam só os projetos em que participa.
Se o link expirar, quem administra usa Reenviar convite na lista de membros. Com convite ainda válido, o convidado também pode Entrar com Google no login do tenant — o Google não cria conta sozinho.
Projetos de outra organização (convidado)
Você pode ser membro de um projeto que pertence a outro escritório — por exemplo, quando atua como consultor. Esses projetos aparecem na sua lista com o selo Convidado e o nome da organização dona do projeto.
Nesses projetos, o que vale é apenas o papel que você recebeu ali. Ser administrador ou ter papéis de sistema (Comercial, Financeiro) na sua própria organização não amplia seu acesso no projeto do outro escritório — e você não passa a ver os demais projetos, pessoas ou dados financeiros daquela organização.
Identidade visual
A organização pode aplicar sua própria marca: logo e cor primária são definidos em Configurações → Integrações e marca. A marca aparece na interface, no portal externo e nos e-mails enviados pela plataforma.
País, moeda e impostos
Em Configurações → País e moeda a organização define o país, a moeda (única — sem conversão cambial) e o locale usados na formatação de valores e datas, além do regime tributário (hoje com provider para o Brasil). Esse regime alimenta o cálculo de impostos nas propostas e nos contratos — veja Comercial e Financeiro.
Novo projeto
O assistente Novo projeto percorre dados básicos, disciplinas, etapas, nomenclatura e aprovação. No passo Membros & Aprovadores a equipe já entra: Adicionar membro pelo e-mail, ou Selecionar do catálogo a partir dos contatos. Papel e disciplinas podem ser ajustados ali. Com aprovação ligada, só quem está vinculado à disciplina — ou é coordenador — aparece como aprovador.
Jornada e alocações
A organização define o horário de trabalho e, opcionalmente, um intervalo de almoço. Quando uma alocação de projeto tem horário definido que atravessa esse intervalo, as horas planejadas descontam automaticamente a sobreposição — para que o planejamento reflita horas produtivas reais. É possível desligar o desconto em uma alocação específica (ex.: plantão ou turno que não para para almoço). O desconto vale só para o planejado; horas apontadas não são alteradas.
Ciclo de vida de um arquivo (visão geral)
Do envio até a entrega final, um documento ou modelo passa por este caminho:
Cada uma dessas etapas é explicada em detalhe nos capítulos a seguir.
Capítulos deste guia
CDE — documentos e modelos
- Processo de upload — como enviar documentos e modelos 3D
- Revit: projeto, IFC, apontamentos, links e clashes — contexto do projeto, envio IFC, fila BCF, links e interferências no add-in studioBIM
- Validação de nomenclatura — como nomear arquivos corretamente
- Aprovações e reprovações — o fluxo de revisão de documentos e modelos, com a lista Assinam na D4Sign
- Apontamentos (BCF) e comentários — apontamentos no modelo 3D e a partir do PDF, listas de quantitativos, busca, sol, SmartViews, clash e Distante/Alinhar
- Nuvens de pontos — levantamento no CDE, alinhamento ao BIM e mapa de desvio
- Checagem de modelo (IDS) — validar propriedades do IFC; módulo opcional, gate no envio
- Script IFC com IA — pedir em português para editar o IFC, pintar a vista ou extrair uma tabela
- Modelar no visualizador — traçar parede, laje, coluna, viga, abertura e volume na sessão e baixar o IFC
- Transmissão — como entregar documentos compartilhados ou publicados a terceiros
- Arquivar, lixeira e exclusão — o que fazer com arquivos que não estão mais em uso
Colaboração e equipe
- Drive — PDF, CAD e IFC scratch, sem projeto nem workflow
- Wiki — base de conhecimento do escritório e dos projetos
- Tarefas — kanban administrativo da equipe, com ou sem vínculo a projeto
- Chat interno — conversa em tempo real por projeto, geral, direta e canal externo (WhatsApp)
- Cronograma e calendário — alocações, entregas e eventos no projeto e na home
- Ponto e apontamento de horas — batida na home, ajustes e horas por projeto
Gestão — comercial, contratos e financeiro
- Comercial — leads, pipeline e propostas
- Financeiro — caixa, cobranças e resultado
- Contratos e honorários — honorários por projeto e parcelas de cobrança
Como os módulos de gestão se relacionam
Comercial, Contratos e Financeiro formam uma esteira única, do primeiro contato com o cliente até o recebimento do pagamento. Entender essa sequência ajuda a saber onde cada informação nasce e para onde ela vai.
- Cada passo é acionado manualmente — nada avança sozinho. Aceitar uma proposta não cria contrato; gerar contrato não fatura sozinho; faturar não marca como recebido automaticamente.
- Gerar contrato exige que o projeto já exista e copia valor, parcelas e condições da proposta.
- Os contratos e a maior parte das telas de gestão dependem de papéis de sistema (Comercial, Financeiro) ou do perfil Administrador — e não dos papéis de projeto (Owner, Coordenador etc.) usados no CDE.
Os detalhes de cada etapa, com estados e configurações, estão nos capítulos Comercial, Financeiro e Contratos.
Manutenção deste guia
Este guia deve ser atualizado sempre que:
- um passo do wizard de upload for adicionado, removido ou alterado;
- as regras de nomenclatura, os estados de workflow ou os papéis mudarem;
- novas ações forem adicionadas às telas de aprovação, BCF, transmissão ou lixeira;
- o envio de IFC ou o painel de apontamentos do add-in do Revit mudarem;
- o painel Script IFC com IA ganhar ou perder uma operação;
- o modelar do viewer ganhar ou perder uma ferramenta;
- os valores padrão de configuração (ex.: prazo de retenção da lixeira) mudarem.
Ao revisar uma funcionalidade documentada aqui, atualize o capítulo correspondente na mesma alteração de código, para que o guia nunca fique defasado em relação ao sistema.