Tudo o que você precisa para instalar, configurar e usar o OpenConstructionERP para orçamentação profissional de custos de construção.
Integração → Novo projeto → BOQ → Vinculação BIM → DWG → Quantificação em PDF → Orçamento completo → Tarefas → Explorador de dados → Orçamento por IA → Portfólio.
Legendas, capítulos e reprodução em 1,5x estão integrados ao player acima. Prefere assistir diretamente no YouTube? ▶ Abrir no YouTube · inscreva-se no canal para acompanhar os tutoriais de novos lançamentos.
Cada bloco abaixo é um GIF curto recortado do tutorial completo acima, na mesma ordem do vídeo, para que você possa ir direto ao fluxo de trabalho mais importante para você. Quer um fluxo contínuo? ▶ Assista ao tutorial de 12 minutos no YouTube.
O OpenConstructionERP é uma plataforma completa de orçamentação de custos de construção e gestão de projetos que roda inteiramente na sua máquina. Ele substitui suítes comerciais de orçamentação caras por uma alternativa aberta e auto-hospedada. A plataforma cobre todo o ciclo de vida da construção - desde estudos iniciais de viabilidade e levantamento de quantidades até a preparação detalhada de BOQ, licitação, comparação de propostas, execução do projeto, gestão da qualidade e controle financeiro. Todos os seus dados ficam no seu servidor. Sem dependência de nuvem, sem assinaturas, sem taxas por usuário.
Destaques da v18.5.0: mais de 190 módulos que cobrem todo o ciclo de vida da construção: diretório de contactos, tarefas com Kanban, acompanhamento de RFI, finanças (faturas, orçamentos, EVM), compras, segurança, reuniões, inspeções de qualidade, NCR, submittals, correspondência, CDE (ISO 19650), transmittals, BIM Hub, registo de ativos com exportação COBie, relatórios & painel de KPI, markups (PDF↔DWG↔hub), visualizações dinâmicas & seletor de colunas de gráficos, serviço de e-mail modular, contactos multi-inquilino, relatórios agendados, Regional Packs e importação/exportação completa.


Listas de Quantidades hierárquicas com seções, posições, recursos, composições e majorações automáticas.
Bases de custos de 9 fontes nacionais, publicadas em 48 edições de mercado com moeda e idioma locais, com 36 bases de dados regionais prontas para importar.
Gere BOQ a partir de texto, fotos, PDFs, Excel ou modelos CAD/BIM usando qualquer provedor de LLM.
Extraia quantidades de RVT, IFC, DWG e DGN via conversores DDC.
Cronograma de Gantt com CPM, Gestão do Valor Agregado, curva S e simulação de Monte Carlo.
Finanças, Segurança, Qualidade, CDE, BIM Hub, Compras, RFI, Tarefas, Reuniões e muito mais. Ative apenas o que você precisa.
Após instalar o OpenConstructionERP, siga estas etapas para configurar seu primeiro projeto e criar seu primeiro orçamento de custos. Todo o processo leva cerca de 10 minutos.
Abra o navegador e acesse http://localhost:5173 (desenvolvimento local) ou http://localhost:8080 (Docker). Você verá a página de login com um painel "Acesso de Demonstração". Clique em Admin para fazer login instantaneamente com a conta de demonstração, ou insira suas próprias credenciais se você registrou uma nova conta.
No primeiro login, o assistente de integração guia você pela configuração inicial:
Clique em Novo Projeto no Painel ou acesse Projetos. Preencha:
Após criar o projeto, você é redirecionado para a página de detalhes do projeto, onde pode começar a adicionar BOQs.
Na página do projeto, clique em Nova Estimativa. Dê um nome a ela (por exemplo, "Estimativa de Custos v1") e, opcionalmente, escolha um modelo. O editor de BOQ abre com uma grade vazia pronta para a sua primeira posição.
No editor de BOQ, clique em Adicionar Posição ou pressione Enter em uma linha vazia. Preencha:
A coluna Total é calculada automaticamente (Quantidade x Preço Unitário). Você também pode pesquisar o banco de dados de custos clicando no ícone do banco de dados ao lado de qualquer posição para encontrar e aplicar um preço dentre os mais de 120.000 itens do CWICR.
O OpenConstructionERP foi projetado para ser fácil de instalar, independentemente do seu nível técnico. Escolha o método que corresponde à sua configuração, todas as opções levam menos de 5 minutos. O aplicativo usa um PostgreSQL embutido por padrão (sem Docker, sem servidor de banco de dados separado, sem configuração), então tudo funciona imediatamente. Requer Python 3.12+ para os caminhos via pip e de linha única.
pip install --upgrade openconstructionerp
openconstructionerpInstala o backend + o frontend React pré-compilado em um único wheel. Abre em http://localhost:8080 com a interface completa. PostgreSQL embutido, zero configuração. Se algo parecer errado, execute openconstructionerp doctor.
No Ubuntu 23.04+ (incluindo o Ubuntu 26) e no Debian 12+, o pip install diretamente no Python do sistema falha com error: externally-managed-environment (PEP 668). Use um ambiente virtual em vez disso:
# Ubuntu 26 - install Python 3.12 explicitly if needed
sudo apt install -y python3.12 python3.12-venv
# Create and activate a venv, then install
python3.12 -m venv ~/ocerp-venv
source ~/ocerp-venv/bin/activate
pip install --upgrade openconstructionerp
openconstructionerpSe o pip recorrer a uma compilação a partir do código-fonte, instale os headers: sudo apt install -y build-essential libpq-dev libjpeg-dev zlib1g-dev libgeos-dev. Guia completo do Linux com solução de problemas: docs/INSTALL_LINUX.md.
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/datadrivenconstruction/OpenConstructionERP/main/scripts/install.ps1 | iexEscolhe o Docker se estiver instalado, caso contrário o uv, caso contrário o pip. Executa em http://localhost:8080.
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
make quickstartAbre em http://localhost:8080 (~2 min na primeira compilação).
git clone https://github.com/datadrivenconstruction/OpenConstructionERP.git
cd OpenConstructionERP
# Backend (embedded PostgreSQL, zero config)
cd backend && pip install -r requirements.txt
uvicorn app.main:create_app --factory --reload --port 8000
# Frontend (new terminal)
cd frontend && npm install && npm run devBackend: http://localhost:8000 / Frontend: http://localhost:5173
| Conta | Senha | Função | |
|---|---|---|---|
| Admin | demo@openconstructionerp.com | DemoPass1234! | Acesso total |
| Estimator | estimator@openconstructionerp.com | DemoPass1234! | Orçamentista |
| Manager | manager@openconstructionerp.com | DemoPass1234! | Gestor |
5 projetos de demonstração (Berlim, Londres, Nova York, Paris, Dubai) com BOQs, cronogramas e modelos de custo completos.
O editor da Lista de Quantidades é onde você passa a maior parte do tempo. Ele oferece uma interface profissional, semelhante a uma planilha, alimentada pelo AG Grid com recursos específicos para construção integrados - seções hierárquicas, vinculação de recursos, composições e cálculos automáticos de majoração. Cada alteração é rastreada com suporte completo de desfazer/refazer. 42 regras de validação rodam automaticamente em segundo plano, capturando erros como quantidades ausentes, preços zerados, posições duplicadas e problemas de conformidade de classificação antes que se tornem problemas.
🎬 Veja o editor de BOQ em ação no YouTube - edição com foco no teclado, mais de 120 mil itens com preço, pontuação de qualidade ao vivo.



As seções organizam seu BOQ em grupos lógicos (por exemplo, "300 Estrutura", "400 HVAC"). Para criar uma seção:
Você pode recolher/expandir seções para focar em ofícios específicos. Arraste as seções para reordenar toda a estrutura do BOQ.
Cada posição do BOQ pode ter recursos vinculados que decompõem o preço unitário em componentes:
Para adicionar recursos: expanda uma linha de posição, clique em "Adicionar recurso", pesquise no catálogo e defina o fator de quantidade (por exemplo, 120 kg de armadura por m3 de concreto). O preço unitário da posição é atualizado automaticamente a partir da soma de seus recursos.
As majorações são aplicadas após o total líquido (soma de todas as posições). Majorações comuns incluem:
Clique em Adicionar Markup na barra de ferramentas. Você pode definir padrões regionais ou personalizar por projeto. Os markups podem ser baseados em porcentagem ou em valores fixos, e são aplicados em sequência (primeiro os custos indiretos, depois o lucro sobre o valor com custos indiretos, depois o IVA sobre o total).
Pressione Ctrl+Shift+V ou clique no ícone de escudo na barra de ferramentas para executar a validação. O sistema verifica o seu BOQ em relação aos conjuntos de regras selecionados e mostra os resultados inline:
O editor de BOQ permite a importação de várias fontes:
| Atalho | Ação |
|---|---|
Ctrl+K | Paleta de comandos |
Ctrl+N | Novo projeto |
Ctrl+Shift+V | Executar validação |
Ctrl+Z / Y | Desfazer / Refazer |
Aceda à maior base de dados de custos de construção de código aberto do mundo: mais de 120 000 itens de custo em mais de 40 regiões. A base CWICR global contribui com mais de 55 000 itens com descrições em até 9 idiomas, organizados por especialidade (movimento de terras, betão, alvenaria, aço, coberturas, fachadas, AVAC, eletricidade, canalização, acabamentos, paisagismo). Cada item inclui uma unidade de medida, o preço base da região indicada, códigos de classificação (DIN 276, NRM, MasterFormat) e, quando existe, a decomposição em materiais, mão de obra e equipamento.


| Região | Moeda | Padrão | Itens |
|---|---|---|---|
| Alemanha (DACH) | EUR | DIN 276 | 55,719 |
| Reino Unido | GBP | NRM 1/2 | 55,719 |
| Estados Unidos | USD | MasterFormat | 55,719 |
| França | EUR | DPGF | 55,719 |
| Rússia | RUB | GESN | 55,719 |
| EAU | AED | Local | 55,719 |
| China | CNY | GB/T | 55,719 |
| Índia | INR | CPWD | 55,719 |
A base de dados de custos foi projetada para dois fluxos de trabalho principais:
Cada item de custo contém:
Ative a pesquisa semântica para encontrar itens de custo por significado, não apenas por correspondências exatas de palavras-chave. Quando você pesquisa por "parede de concreto", o sistema também encontra itens como "divisória armada C30/37, 24cm com fôrma" - mesmo que as palavras exatas não apareçam. Isso é viabilizado por embeddings de sentence-transformer que convertem descrições em vetores numéricos e encontram as correspondências mais próximas em um espaço multidimensional. Dois backends de base de dados vetorial são suportados: LanceDB (embarcado, roda em processo como o SQLite, embeddings de 384 dimensões) e Qdrant (servidor de produção com snapshots pré-construídos de 3072 dimensões baixáveis do GitHub).
Extraia quantidades diretamente dos desenhos e modelos do seu projeto - sem contagem manual. Envie arquivos RVT, IFC, DWG ou DGN e o sistema extrai cada elemento construtivo com volumes, áreas e comprimentos. Para desenhos em PDF, abra-os diretamente no navegador e use ferramentas de medição calibradas para quantificar distâncias, áreas e contagens de elementos. Todas as quantidades extraídas podem ser transferidas para um BOQ para precificação.





| Formato | Software | Conversor |
|---|---|---|
| .rvt / .rfa | BIM | DDC RvtExporter |
| .ifc | IFC (qualquer BIM) | DDC IfcExporter |
| .dwg / .dxf | CAD | DDC DwgExporter |
| .dgn | CAD | DDC DgnExporter |
Conecte qualquer provedor de LLM para gerar orçamentos de custos de construção a partir de descrições em texto simples, fotos de edificações, PDFs digitalizados, planilhas Excel ou modelos CAD/BIM. O sistema de IA cria posições completas de BOQ com quantidades e preços de mercado. Após a geração, você pode confrontar cada item com a base de dados de custos CWICR para substituir os preços estimados pela IA por preços de mercado regionais verificados. Os recursos de IA são totalmente opcionais - a plataforma funciona plenamente sem eles.
🎬 Veja "Estimativa por IA a partir de uma foto" no YouTube - envie uma foto da obra e obtenha um BOQ delimitado em segundos.


| Provedor | Modelos | Recursos |
|---|---|---|
| Anthropic | Claude Sonnet / Opus | Texto, visão, documentos |
| OpenAI | GPT-4o | Texto, visão, documentos |
| Gemini Pro | Texto, visão | |
| Mistral / Groq / DeepSeek | Vários | Texto |
Descreva seu projeto em texto simples e a IA gera de 15 a 30 itens de BOQ com quantidades e preços de mercado.
Confronte os orçamentos da IA com a base de dados CWICR para substituir os preços estimados por preços de mercado reais.
Converse com a IA sobre custos, materiais e preços usando sua base de dados de custos como contexto.

Planeje o cronograma do seu projeto de construção e acompanhe os custos ao longo do tempo com ferramentas integradas de cronograma e modelagem financeira.
O módulo de cronograma oferece um gráfico de Gantt profissional para gerenciar a linha do tempo da sua construção. Crie atividades, defina durações e dependências, e o sistema calcula automaticamente o caminho crítico, mostrando quais atividades não podem ser atrasadas.
O modelo de custo conecta os dados do seu BOQ à linha do tempo do projeto, oferecendo uma visão dos custos de construção distribuída no tempo com métricas de Gestão do Valor Agregado.
Gerencie todo o fluxo de compras, desde a criação de pacotes de licitação até a comparação de propostas e a adjudicação de contratos a subempreiteiros.
Acesse Compras, selecione um projeto e clique em "Criar pacote". Especifique o nome do pacote, a descrição do escopo, o prazo de submissão e selecione quais posições do BOQ incluir. Você pode criar vários pacotes por projeto (por exemplo, obras estruturais, MEP, acabamentos).
Adicione propostas de subempreiteiros com nome da empresa, dados de contato e preços cotados para cada posição do BOQ. O sistema permite várias propostas por pacote para comparação lado a lado.
O espelho de preços mostra todas as propostas em uma tabela de comparação com preços unitários e totais por posição. Indicadores visuais destacam as propostas mais baixas e mais altas. Exporte a comparação como CSV para revisão das partes interessadas.
Marque a proposta vencedora com o botão Adjudicar e adicione notas de justificativa. O status do pacote é acompanhado por: Rascunho, Emitido, Em coleta, Em avaliação, Adjudicado, Encerrado.
Identifique, avalie e gerencie os riscos do projeto usando uma matriz de probabilidade e impacto. Quantifique a exposição ao risco e planeje estratégias de mitigação para cada risco identificado.
A matriz exibe todos os riscos em uma grade de probabilidade (0,1-0,9) vs impacto (baixo/médio/alto/crítico) com codificação por cores. Cada risco mostra sua pontuação de exposição calculada (probabilidade multiplicada pelo custo do impacto).
Para cada risco, documente: código único (R-001), título, categoria (técnico, financeiro, cronograma, regulatório, ambiental, segurança), estratégia de mitigação, plano de contingência, responsável pelo risco, impacto no custo e impacto no cronograma em dias. Acompanhe o status por: Identificado, Avaliado, Em mitigação, Encerrado ou Ocorrido.
Acompanhe mudanças de escopo e seu impacto no custo e no cronograma do projeto. As ordens de mudança fornecem uma trilha de auditoria de todas as modificações feitas após o orçamento inicial.
Crie uma ordem de mudança com código (CO-001), título e categoria de motivo (solicitação do cliente, alteração de projeto, condição imprevista, regulatório). Adicione itens de linha especificando as posições do BOQ afetadas com quantidades/preços originais e novos. O sistema calcula as variações de custo automaticamente. O status avança por: Rascunho, Submetido, Em análise, Aprovado/Rejeitado.

Execute verificações automáticas de qualidade em seus BOQs para capturar erros antes que se tornem problemas. O mecanismo de validação aplica 42 regras configuráveis aos dados do seu orçamento.
Cada validação produz uma pontuação de qualidade (0-100%) com achados codificados por cores: Erros (vermelho, devem ser corrigidos), Avisos (amarelo, devem ser revisados), Informações (azul, sugestões). Clique em qualquer achado para navegar diretamente até a posição do BOQ afetada.



Gere documentos profissionais a partir dos dados do seu projeto para partes interessadas, clientes e conformidade regulatória.

Centralize todos os documentos do projeto. Envie desenhos, contratos, especificações e fotos com categorização e pesquisa automáticas.


Visualize o desempenho orçamentário entre projetos. O painel agrega dados financeiros de todos os projetos para identificar tendências, variações e orçamentos em risco.
Gerencie todas as partes interessadas do projeto em um diretório centralizado. Acompanhe clientes, subempreiteiros, fornecedores, arquitetos e consultores com dados de contato completos, associações de empresas e categorização baseada em função. Vincule contatos a projetos, licitações, ordens de compra e correspondência para total rastreabilidade.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/contacts/ | Listar todos os contatos |
| POST | /api/v1/contacts/ | Criar contato |
| GET | /api/v1/contacts/{id} | Obter detalhes do contato |
| PUT | /api/v1/contacts/{id} | Atualizar contato |
| POST | /api/v1/contacts/import | Importar contatos em massa |
Organize o trabalho do projeto com uma taxonomia de 5 tipos de tarefas e um quadro Kanban visual. As tarefas podem ser atribuídas a membros da equipe, vinculadas a posições específicas do BOQ, documentos ou RFIs, e acompanhadas por estágios de fluxo de trabalho personalizáveis. Cada tipo de tarefa tem sua própria codificação de cor e campos padrão.

| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/tasks/ | Listar tarefas (filtráveis por projeto, responsável, status) |
| POST | /api/v1/tasks/ | Criar tarefa |
| PATCH | /api/v1/tasks/{id} | Atualizar tarefa (status, responsável, prioridade) |
| GET | /api/v1/tasks/board/{project_id} | Obter dados do quadro Kanban |
Acompanhe pedidos formais de informação entre as partes do projeto com atribuição de ball-in-court. Os RFIs percorrem um ciclo de vida estruturado, do rascunho ao encerramento, garantindo que cada pergunta receba uma resposta documentada. O rastreamento ball-in-court mostra quem detém a ação a qualquer momento.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/rfis/ | Listar RFIs |
| POST | /api/v1/rfis/ | Criar RFI |
| POST | /api/v1/rfis/{id}/respond | Enviar resposta |
| PATCH | /api/v1/rfis/{id}/status | Atualizar status / ball-in-court |
Gestão financeira completa do projeto, abrangendo faturas, orçamentos, pagamentos e Earned Value Management (EVM). Acompanhe custos planejados versus reais, gere medições de pagamento e monitore a saúde do orçamento com análise de desvios em tempo real. Integra-se com os dados de BOQ para a geração automática da linha de base de custos.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/finance/invoices/ | Listar faturas |
| POST | /api/v1/finance/invoices/ | Criar fatura |
| GET | /api/v1/finance/budgets/ | Listar orçamentos |
| POST | /api/v1/finance/budgets/import | Importar orçamento do Excel |
| GET | /api/v1/finance/evm/{project_id} | Obter métricas de EVM |
| GET | /api/v1/finance/payments/ | Listar pagamentos |
Gerencie pedidos de compra e recebimentos de mercadorias para materiais e serviços de construção. Crie pedidos de compra vinculados a posições do BOQ, acompanhe o status de entrega e registre recebimentos de mercadorias com verificação de quantidade. Integra-se com o módulo de Contatos para a gestão de fornecedores.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/procurement/orders/ | Listar pedidos de compra |
| POST | /api/v1/procurement/orders/ | Criar pedido de compra |
| POST | /api/v1/procurement/orders/{id}/receive | Registrar recebimento de mercadorias |
| GET | /api/v1/procurement/receipts/ | Listar recebimentos de mercadorias |
Registre incidentes de segurança, quase-acidentes e observações comportamentais com um sistema de pontuação de risco. Acompanhe os indicadores de desempenho de segurança entre projetos, identifique tendências e garanta a conformidade com as normas de saúde e segurança ocupacional.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/safety/incidents/ | Listar incidentes |
| POST | /api/v1/safety/incidents/ | Reportar incidente |
| GET | /api/v1/safety/observations/ | Listar observações |
| POST | /api/v1/safety/observations/ | Registrar observação |
| GET | /api/v1/safety/dashboard/{project_id} | Obter KPIs de segurança |
Gerencie atas de reunião com pautas estruturadas e itens de ação acompanhados. Crie séries de reuniões recorrentes (por exemplo, reuniões semanais de obra), registre os participantes, capture os pontos de discussão e gere automaticamente itens de ação que se integram ao módulo de Tarefas.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/meetings/ | Listar reuniões |
| POST | /api/v1/meetings/ | Criar reunião |
| GET | /api/v1/meetings/{id}/minutes | Obter ata da reunião |
| POST | /api/v1/meetings/{id}/actions | Adicionar item de ação |
Realize inspeções de qualidade usando checklists configuráveis. Defina modelos de inspeção por especialidade ou tipo de atividade, preencha-os em campo, anexe fotos e acompanhe a resolução de não conformidades. Os resultados das inspeções alimentam a pontuação de qualidade do projeto e o fluxo de trabalho de NCR.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/inspections/ | Listar inspeções |
| POST | /api/v1/inspections/ | Criar inspeção a partir de modelo |
| GET | /api/v1/inspections/templates/ | Listar modelos de checklist |
| PATCH | /api/v1/inspections/{id}/items | Atualizar resultados de itens do checklist |
Documente e acompanhe não conformidades de qualidade quando o trabalho não atende às especificações. Os NCRs seguem um ciclo de vida formal, desde a identificação até a análise de causa raiz e a verificação da ação corretiva, garantindo que todos os desvios de qualidade sejam devidamente resolvidos e documentados.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/ncr/ | Listar NCRs |
| POST | /api/v1/ncr/ | Criar NCR |
| PATCH | /api/v1/ncr/{id}/status | Atualizar status do NCR |
| POST | /api/v1/ncr/{id}/actions | Adicionar ação corretiva |
Gerencie o processo de revisão de submittals para materiais de construção, desenhos de fabricação e dados de produtos. Acompanhe fluxos de revisão em várias etapas, em que os submittals passam por vários revisores antes da aprovação final. Mantenha um histórico de auditoria completo de todos os ciclos de revisão e do histórico de revisões.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/submittals/ | Listar submittals |
| POST | /api/v1/submittals/ | Criar submittal |
| POST | /api/v1/submittals/{id}/review | Enviar decisão de revisão |
| POST | /api/v1/submittals/{id}/revise | Carregar nova revisão |
Mantenha um registro formal de comunicações para toda a correspondência do projeto. Acompanhe cartas, e-mails, avisos e instruções entre as partes do projeto com números de referência exclusivos, rastreamento de respostas e busca em texto completo. Garante que as comunicações contratuais sejam devidamente documentadas e rastreáveis.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/correspondence/ | Listar correspondência |
| POST | /api/v1/correspondence/ | Criar entrada de correspondência |
| GET | /api/v1/correspondence/{id} | Obter detalhes com anexos |
| GET | /api/v1/correspondence/{id}/thread | Obter cadeia de correspondência vinculada |
Ambiente Comum de Dados em conformidade com a ISO 19650 para gerenciar informações do projeto com transições de status controladas. Os documentos passam pelos estados Trabalho em Andamento (WIP), Compartilhado, Publicado e Arquivado com pontos de aprovação. Garante que a gestão da informação siga os padrões BIM para entrega colaborativa.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/cde/documents/ | Listar documentos do CDE (filtráveis por status, adequação) |
| POST | /api/v1/cde/documents/ | Carregar documento no CDE |
| PATCH | /api/v1/cde/documents/{id}/status | Transicionar status do documento |
| GET | /api/v1/cde/documents/{id}/history | Obter histórico de revisões |
Distribua documentos formalmente a partes externas com rastreamento de entrega e confirmação de recebimento. Crie pacotes de transmittal contendo vários documentos, especifique os destinatários e acompanhe se cada destinatário recebeu e confirmou o recebimento dos documentos. Fornece um registro contratual da troca de informações.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/transmittals/ | Listar transmittals |
| POST | /api/v1/transmittals/ | Criar transmittal |
| POST | /api/v1/transmittals/{id}/send | Enviar transmittal aos destinatários |
| PATCH | /api/v1/transmittals/{id}/acknowledge | Registrar confirmação do destinatário |
Hub central para a gestão de modelos BIM com acesso a dados em nível de elemento e vinculação direta ao BOQ. Carregue modelos IFC/RVT, navegue pelos elementos da edificação com suas propriedades e quantidades e vincule elementos a posições do BOQ para a integração de custos 5D. Fornece uma ponte entre os dados de projeto e a estimativa de custos.
🎬 Demonstração de vínculo em massa BIM no YouTube - 100 paredes do BIM → uma linha de BOQ com área, volume e comprimento agregados.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/bim/models/ | Listar modelos BIM |
| POST | /api/v1/bim/models/ | Carregar modelo BIM |
| GET | /api/v1/bim/models/{id}/elements | Listar elementos do modelo |
| POST | /api/v1/bim/elements/{id}/link-boq | Vincular elemento a posição do BOQ |
Mecanismo de relatórios abrangente com um painel de KPIs, modelos de relatórios personalizáveis e geração agendada de relatórios. Agregue dados entre projetos para obter insights em nível de portfólio. Crie modelos de relatórios personalizados combinando dados de qualquer módulo (BOQ, Financeiro, Cronograma, Segurança, Qualidade).
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/reporting/kpi/{project_id} | Obter KPIs do projeto |
| GET | /api/v1/reporting/templates/ | Listar modelos de relatório |
| POST | /api/v1/reporting/generate | Gerar relatório a partir de modelo |
| GET | /api/v1/reporting/portfolio/ | Obter dados do painel de portfólio |
Sistema de notificações no aplicativo que mantém os usuários informados sobre eventos relevantes para eles. As notificações são acionadas por ações em todos os módulos: atribuições de tarefas, respostas a RFIs, revisões de submittals, solicitações de aprovação, itens em atraso e muito mais. Os usuários controlam suas preferências de notificação por categoria.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/notifications/ | Listar notificações (não lidas primeiro) |
| PATCH | /api/v1/notifications/{id}/read | Marcar notificação como lida |
| POST | /api/v1/notifications/read-all | Marcar todas como lidas |
| GET | /api/v1/notifications/preferences | Obter preferências de notificação |
Gráfico de Gantt baseado em SVG puro para a visualização do cronograma de construção. Renderiza linhas do tempo, dependências, marcos e o caminho crítico diretamente no navegador, sem bibliotecas externas. Oferece suporte a zoom de visualizações em nível de dia até nível de ano e exporta para PDF/PNG para relatórios.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/schedule/gantt/{project_id} | Obter dados do gráfico de Gantt (atividades, dependências) |
| PATCH | /api/v1/schedule/activities/{id} | Atualizar datas/progresso da atividade |
| POST | /api/v1/schedule/dependencies/ | Criar dependência |
Configure as preferências de fuso horário, moeda, formato numérico e formato de data por usuário e por projeto. As configurações regionais cascateiam dos padrões do sistema para as substituições em nível de projeto e para as preferências em nível de usuário, garantindo que cada membro da equipe veja os dados formatados de acordo com o seu idioma.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/settings/regional/ | Obter configurações regionais atuais |
| PUT | /api/v1/settings/regional/ | Atualizar configurações regionais |
| GET | /api/v1/settings/regional/timezones | Listar fusos horários disponíveis |
| GET | /api/v1/settings/regional/currencies | Listar moedas suportadas |
Ative ou desative módulos da plataforma para personalizar o OpenConstructionERP para o seu fluxo de trabalho. Cada módulo pode ser ativado de forma independente sem afetar os demais. Os módulos desativados ficam ocultos na interface, seus endpoints da API retornam 404 e suas tabelas no banco de dados permanecem intactas para reativação.
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/modules/ | Listar todos os módulos com status |
| PATCH | /api/v1/modules/{name}/toggle | Ativar ou desativar um módulo |
| GET | /api/v1/modules/{name}/dependencies | Verificar dependências do módulo |
Pacotes regionais pré-configurados que definem padrões de classificação, regras tributárias, padrões do banco de dados de custos, modelos de relatórios e regras de conformidade regulatória para mercados específicos. Instale um pacote regional para configurar imediatamente a plataforma para o seu país ou região.
| Pacote | Região | Padrões | Moeda |
|---|---|---|---|
| US | Estados Unidos | MasterFormat, UniFormat, CSI | USD |
| DACH | Alemanha, Áustria, Suíça | DIN 276, GAEB, VOB, HOAI | EUR/CHF |
| UK | Reino Unido | NRM 1/2, RICS, JCT | GBP |
| Russia | Rússia, CEI | GESN, FER, TER, SNIP | RUB |
| Oriente Médio | Emirados Árabes Unidos, Arábia Saudita, Catar | RICS, CESMM, FIDIC | AED/SAR/QAR |
| Asia-Pacific | China, Japão, Austrália | GB/T, AS 4000, JASS | CNY/AUD/JPY |
| India | Índia | CPWD, IS standards, DSR | INR |
| LatAm | Brasil, México, Colômbia | SINAPI, CMIC, local norms | BRL/MXN/COP |
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /api/v1/regional-packs/ | Listar pacotes regionais disponíveis |
| POST | /api/v1/regional-packs/{name}/install | Instalar pacote regional |
| GET | /api/v1/regional-packs/{name}/details | Obter conteúdo e configuração do pacote |
Recursos abrangentes de importação e exportação de dados em todos os módulos. Importe contatos, orçamentos, BOQs e bancos de dados de custos a partir de arquivos Excel e CSV com mapeamento inteligente de colunas. Exporte dados do projeto para Excel, PDF e CSV com modelos personalizáveis. Todas as exportações preservam a formatação e incluem cabeçalhos de metadados.
| Método | Endpoint | Descrição |
|---|---|---|
| POST | /api/v1/import/contacts | Importar contatos de arquivo |
| POST | /api/v1/import/budget | Importar orçamento do Excel |
| POST | /api/v1/export/boq/{id} | Exportar BOQ (formato: excel, pdf, gaeb, csv) |
| POST | /api/v1/export/report | Gerar e exportar relatório |



| Variável | Padrão | Descrição |
|---|---|---|
DATABASE_URL | (por definir = PostgreSQL integrado) | Base de dados (PostgreSQL integrado por predefinição; defina para usar um PostgreSQL externo). Deixe por definir para usar o PostgreSQL integrado, ou indique uma base de dados externa, por exemplo postgresql+asyncpg://oe:oe@localhost:5432/openestimate. |
JWT_SECRET | dev-key | Segredo JWT (altere em produção!) |
SEED_DEMO | true | Criar contas de demonstração |
VECTOR_BACKEND | lancedb | Backend de busca vetorial |
O OpenConstructionERP expõe uma API REST abrangente que alimenta o frontend e pode ser usada para integrações, automação e fluxos de trabalho personalizados. Toda ação disponível na interface - criar projetos, editar BOQs, executar estimativas por IA, pesquisar custos - está disponível como um endpoint de API. A documentação interativa Swagger com botões de teste está disponível em /api/docs ao executar o backend.
| Método | Endpoint | Descrição |
|---|---|---|
| POST | /api/v1/users/auth/login | Login |
| GET | /api/v1/projects/ | Listar projetos |
| GET | /api/v1/boq/boqs/?project_id=... | Listar BOQs |
| GET | /api/v1/costs/?q=concrete | Pesquisar custos |
| POST | /api/v1/ai/quick-estimate | Estimativa por AI |
| POST | /api/v1/takeoff/cad-extract | Extração CAD |
| GET | /api/health | Verificação de saúde |
| Módulo | Prefixo | Descrição |
|---|---|---|
| Contacts | /api/v1/contacts/ | CRUD do diretório de contatos, importação |
| Tasks | /api/v1/tasks/ | Gestão de tarefas, quadro Kanban |
| RFI | /api/v1/rfis/ | Pedidos de Informação |
| Finance | /api/v1/finance/ | Faturas, orçamentos, pagamentos, EVM |
| Procurement | /api/v1/procurement/ | Pedidos de compra, recebimentos de mercadorias |
| Safety | /api/v1/safety/ | Incidentes, observações, pontuação de risco |
| Meetings | /api/v1/meetings/ | Atas, pauta, itens de ação |
| Inspections | /api/v1/inspections/ | Inspeções de qualidade, checklists |
| NCR | /api/v1/ncr/ | Relatórios de não conformidade |
| Submittals | /api/v1/submittals/ | Revisão de submittals em várias etapas |
| Correspondence | /api/v1/correspondence/ | Registro de comunicações |
| CDE | /api/v1/cde/ | Ambiente de documentos ISO 19650 |
| Transmittals | /api/v1/transmittals/ | Distribuição de documentos |
| BIM Hub | /api/v1/bim/ | Modelos BIM, elementos, vinculação ao BOQ |
| Reporting | /api/v1/reporting/ | Painel de KPIs, modelos de relatórios |
| Notifications | /api/v1/notifications/ | Sistema de notificações no aplicativo |
| Comments | /api/v1/comments/ | Comentários em thread em qualquer entidade |
| Gantt | /api/v1/schedule/gantt/ | Visualização de cronograma em SVG |
| Regional | /api/v1/settings/regional/ | Preferências de fuso horário, moeda, formato |
| Modules | /api/v1/modules/ | Ativar/desativar módulos |
| Regional Packs | /api/v1/regional-packs/ | Instalar configurações regionais |
| Import/Export | /api/v1/import/ / /api/v1/export/ | Importação e exportação de dados em massa |
Consulte cada seção de módulo acima para a documentação detalhada dos endpoints com parâmetros e descrições.
Análise de projeto com IA que pontua seu projeto em 9 domínios ponderados e gera um índice de completude de 0 a 100 (notas de A a F).
API: GET /api/v1/project_intelligence/score/?project_id=X - retorna o índice geral, índices por domínio, lacunas críticas e conquistas.
Gerencie membros da equipe, papéis e controle de acesso por módulo.
Os administradores podem configurar a visibilidade dos módulos e os níveis de acesso por usuário (Nenhum, Visualizar, Editar, Total) na página /users. Nomes de função personalizados podem ser atribuídos (ex.: "Engenheiro de Campo", "Gerente de Custos").
Dê uma estrela ao repositório para ajudar outras pessoas a descobrir o projeto.
Inscreva-se para acompanhar apresentações de versões e tutoriais. Comece pela apresentação do produto de 12 min.
Abra uma issue no GitHub.
Junte-se à comunidade no Telegram para tirar dúvidas.
Fale conosco para implantação e treinamento.
Licença: AGPL-3.0. Licenciamento comercial: info@datadrivenconstruction.io
OpenConstructionERP
Desenvolvido pela equipe DataDrivenConstruction
2026 Data Driven Construction. AGPL-3.0
Comentários
Sistema de comentários em thread que pode ser anexado a qualquer entidade da plataforma: posições do BOQ, tarefas, RFIs, submittals, documentos, inspeções e muito mais. Oferece suporte a @menções para notificar membros da equipe, anexos de arquivos e rastreamento de resolução para discussões orientadas à ação.
Principais recursos
Endpoints da API
/api/v1/comments/?entity_type=task&entity_id=.../api/v1/comments//api/v1/comments/{id}/reply/api/v1/comments/{id}/resolve