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.

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. Também sobe direto do Revit — ver Revit: projeto, IFC, apontamentos, links e clashes.
Nuvem de pontos	Levantamento (laser scanner / fotogrametria) convertido para COPC e sobreposto ao BIM no mesmo viewer.
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.

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.
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 a um projeto ou à organização, recebe um e-mail com um link para definir a senha. Esse link vale 7 dias. Se expirar, não é preciso recriar o cadastro: quem administra usa a ação Reenviar convite na lista de membros para gerar um link novo.

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.

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
Apontamentos (BCF) e comentários — apontamentos no modelo 3D e a partir do PDF (toolbar, print anotável), troca de arquivos BCF e recursos do visualizador
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
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;
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.