Skip to Content
📚 Guia do usuário da Catena Build agora tem site próprio.
Início

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

ConceitoO que significa
ProjetoO 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 / FaseMomento do projeto ao qual o arquivo pertence (ex.: Estudo Preliminar, Projeto Executivo).
DocumentoArquivo 2D (PDF, DWG, planilha, imagem etc.).
Modelo 3DArquivo 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 pontosLevantamento (laser scanner / fotogrametria) convertido para COPC e sobreposto ao BIM no mesmo viewer, com panorâmica, planicidade e recorte.
VersãoCada novo envio do mesmo documento ou modelo gera uma nova versão interna (v1, v2, v3…). O histórico completo é preservado.
RevisãoCó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çãoCó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.
WorkflowA sequência de etapas de revisão/aprovação que uma versão percorre até ser considerada válida.
StatusO estado atual de uma versão dentro do workflow (Rascunho, Revisão interna, Compartilhado, Publicado, etc.).
TransmissãoO 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)

PapelO que pode fazer
Owner (proprietário)Acesso total ao projeto: configura workflows, compartilha, publica, arquiva, gerencia a lixeira e o portal externo.
CoordenadorMesmas capacidades de gestão do dia a dia: compartilhar, publicar, arquivar, gerenciar a lixeira, criar/enviar transmissões.
MembroEnvia arquivos, participa das revisões quando designado como aprovador, cria transmissões, comenta em modelos 3D, publica vistas e SmartViews para o projeto.
ColaboradorEnvia e revisa como membro; publica vistas e SmartViews para o projeto.
VisualizadorSomente leitura no projeto; não publica vistas compartilhadas.
ExternoPapel 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

  1. Processo de upload — como enviar documentos e modelos 3D
  2. Revit: projeto, IFC, apontamentos, links e clashes — contexto do projeto, envio IFC, fila BCF, links e interferências no add-in studioBIM
  3. Validação de nomenclatura — como nomear arquivos corretamente
  4. Aprovações e reprovações — o fluxo de revisão de documentos e modelos, com a lista Assinam na D4Sign
  5. Apontamentos (BCF) e comentários — apontamentos no modelo 3D e a partir do PDF, listas de quantitativos, busca, sol, SmartViews, clash e Distante/Alinhar
  6. Nuvens de pontos — levantamento no CDE, alinhamento ao BIM e mapa de desvio
  7. Checagem de modelo (IDS) — validar propriedades do IFC; módulo opcional, gate no envio
  8. Script IFC com IA — pedir em português para editar o IFC, pintar a vista ou extrair uma tabela
  9. Modelar no visualizador — traçar parede, laje, coluna, viga, abertura e volume na sessão e baixar o IFC
  10. Transmissão — como entregar documentos compartilhados ou publicados a terceiros
  11. Arquivar, lixeira e exclusão — o que fazer com arquivos que não estão mais em uso

Colaboração e equipe

  1. Drive — PDF, CAD e IFC scratch, sem projeto nem workflow
  2. Wiki — base de conhecimento do escritório e dos projetos
  3. Tarefas — kanban administrativo da equipe, com ou sem vínculo a projeto
  4. Chat interno — conversa em tempo real por projeto, geral, direta e canal externo (WhatsApp)
  5. Cronograma e calendário — alocações, entregas e eventos no projeto e na home
  6. Ponto e apontamento de horas — batida na home, ajustes e horas por projeto

Gestão — comercial, contratos e financeiro

  1. Comercial — leads, pipeline e propostas
  2. Financeiro — caixa, cobranças e resultado
  3. 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.