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 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. |
| Versão / Revisão | Cada novo envio do mesmo arquivo gera uma nova versão, identificada por uma revisão (ex.: R00, R01, R02). O histórico completo é preservado. |
| 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, Em revisão, Aprovado, Publicado, etc.). |
| Transmissão | O registro formal de entrega de documentos aprovados 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, aprova, publica, arquiva, gerencia a lixeira e o portal externo. |
| Coordenador | Mesmas capacidades de gestão do dia a dia: aprovar, 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.
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
- Validação de nomenclatura — como nomear arquivos corretamente
- Aprovações e reprovações — o fluxo de revisão de documentos e modelos
- BCF e comentários — apontamentos colaborativos no modelo 3D
- Transmissão — como entregar documentos aprovados a terceiros
- Arquivar, lixeira e exclusão — o que fazer com arquivos que não estão mais em uso
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;
- 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.