Medir diretamente no PDF
Defina a escala, trace a área, e cada medição fica registada numa folha que transporta a sua peça desenhada e a sua revisão para o mapa de quantidades.
Mapa de quantidades
Comece com mais de 190 módulos integrados e depois crie ou instale os seus. Da estimativa ao BIM e à obra, com API aberta, webhooks e um construtor de módulos, para que a plataforma seja exatamente o software em que a sua empresa funciona.
A funcionar em um comando
pip install openconstructionerp
docker compose up -d
+
mais módulos
Ver o sistema de módulos
Toda a cadeia numa só tomada: do desenho ao levantamento, ao mapa de quantidades com as suas margens e à inspeção no local, sobre um único modelo de dados.
Meça, orce, planeie, compre, construa e liquide numa só aplicação, sem reintroduzir nada. Código aberto (AGPL-3.0), alojamento próprio, exportação aberta.
Defina a escala, trace a área, e cada medição fica registada numa folha que transporta a sua peça desenhada e a sua revisão para o mapa de quantidades.
Mapa de quantidades
As camadas mantêm-se separadas, pelo que uma cortina de estacas secantes é medida como tal, e não como parte da peça desenhada em que foi traçada.
Medições
Cada elemento é contável, filtrável por piso e por especialidade, e liga-se diretamente a um artigo do mapa de quantidades.
Medições
02
Um artigo do mapa abre-se aos recursos com que foi orçamentado, cada um com a sua própria classe e a sua própria moeda. O fornecimento turco fica em liras, o adjuvante em euros, o total em dólares.
Cronograma 4D · Custo 5D
Cada preço traz um mínimo, uma média e um máximo, e indica quantos artigos do mapa o citam.
Mapa de quantidades
Consulte preços unitários e preços compostos por região e catálogo, ou mantenha os seus próprios, e traga um preço com a mão de obra, o material e o equipamento por trás diretamente para o mapa.
Mapa de quantidades
Orçamento, comprometido, real e previsto num único ecrã, com o valor agregado lido diretamente dos mesmos dados em vez de digitado numa folha separada. Vai dizer-lhe o índice de desempenho de que precisa a partir daqui para fechar dentro do orçamento.
Reconciliação custo-valor
O cronograma é gerado a partir dos artigos do mapa e mantém-se ligado a eles, pelo que uma quantidade que se altera leva as datas consigo.
Modelo 4D · Valor agregado
Cada risco é orçamentado e classificado no mesmo projeto, pelo que a contingência que se mantém é uma soma de exposições identificadas, e não uma percentagem no final da folha.
Trabalhos a mais
04
Cada pedido de esclarecimento traz a sua especialidade, o seu prazo e de quem é a vez de responder, e uma resposta que chega com um custo transforma-se diretamente numa variante.
Variantes · Submissões · Visualizador BIM
Cada inspeção traz a sua checklist, o seu resultado e a sua data, pelo que uma falha se torna uma tarefa com um responsável, e não uma nota no telemóvel de alguém.
Lista de deficiências · NCR · Entrega
Custo face ao valor por rubrica de custo, com previsão e margem em cada linha, ao longo de uma curva de tesouraria que vai até à conclusão. Uma rubrica mostra uma margem negativa, que é precisamente o objetivo de fazer a reconciliação.
Tesouraria · Autos de medição
De volta ao 01. Chega uma revisão e as mesmas quatro etapas correm de novo, sobre os mesmos dados.
Quatro perfis conduzem o ciclo acima. Mais 19 conduzem a sua própria parte, e cada um recebe um conjunto diferente de módulos.
Orçamento, licitação, BIM, quantitativos, prazos, qualidade, segurança, caixa, obra. Ative o necessário ou escreva o seu.
Baixar
Uma versão desktop nativa para Windows, macOS e Linux. Um único instalador traz a plataforma inteira com seu próprio banco de dados embutido, não há mais nada para configurar. Gratuito, código aberto, e seus dados nunca saem do seu disco.
Windows 10/11 - instalador de 64 bits
macOS 10.15+ - Apple Silicon
AppImage, deb e rpm
curl -fsSL https://openconstructionerp.com/install.sh | shUm comando e já está rodando
Instale e depois execute
pip install openconstructionerpUma linha, app mais banco de dados
docker compose upInterface, preços e relatórios mudam de idioma juntos: um projetista em Varsóvia e um diretor de obra em Lyon leem o mesmo projeto na sua língua. Experimente aqui.
Orçamentação, medições, planeamento, documentos, qualidade e importação CAD/BIM, tudo na transferência. Vêm incluídos dados de custos de mais de 40 mercados e 44 idiomas de interface. Sem nível pago, sem limite de utilizadores.
Sem conta e sem nuvem no meio. Os projetos ficam numa pasta no seu próprio disco, e tudo continua a funcionar com a rede desligada.
Base de dados, servidor e interface vêm como um único programa. Atualizar é executar o instalador seguinte, e ao remover só fica a sua pasta de dados.
Ajuda de instalação Ver todas as builds e checksums no GitHub
I love how OpenConstructionERP goes beyond my expectations and is as complete as it gets for open-source apps. [...] The most valuable aspect for me is the cost data feature, which is typically hard to find. Additionally, the initial setup was very easy.
Open-source, customizable software, built by professionals in the field
“Free, local, and has PDF measurement with a large cost-item database. [...] For small contractors and freelance estimators, it's a solid free option for simple jobs.”
“Not just another BIM tool. It is an attempt to build an open-source ERP for construction. [...] It is open source and can be self-hosted.”
“This isn't AI replacing estimators or planners. It's AI handing them better-structured data, faster reviews, and fewer soul-crushing manual steps.”
Uma equipa de TI forte e orçamento para desenvolvimento.
Um portátil que já tem e cerca de dez minutos.
A mesma versão corre num portátil, num servidor alugado ou no seu próprio bastidor. Comece pequeno, cresça depois, sem reescrever nada.
pip install openconstructionerp3 GB de memória é o mínimo. O escritório e a obra abrem o mesmo projeto num navegador.
A equipa toda, de qualquer sítiodocker compose up -dCorre dentro da sua própria rede. Desenhos, custos e contratos ficam em hardware que você controla.
A empresa, nada sai do edifícioterraform applyOs ERP fechados impõem a sua forma de trabalhar e cobram cada alteração. Com código aberto adapta o software à empresa, e o que constrói é seu.
Altere o próprio software
Trabalhe como a sua empresa trabalha
Ligue-o às ferramentas que já usa
Demonstrações curtas sobre um projeto real na aplicação, da instalação à entrega da obra.
4:41
How to Install OpenConstructionERP | Windows Setup & First Project
Instale no Windows, abra o projeto de exemplo, defina idioma e região, escolha módulos, convide a equipa.
12:00
Quantidades, BOQ e orçamentação com IA. No seu próprio laptop.
Uma visita rápida a todo o fluxo: desenho à entrada, proposta à saída.
4:48
Build a Construction Estimate Step by Step
Builder's Playbook: Getting Started
5:55
Mengen aus PDF und DWG ermitteln
Lernprojekt Landshut
5:34
GAEB-Dateien kontrolliert austauschen
Lernprojekt Landshut
4:23
Tender Work to Subcontractors
Builder's Playbook Canada: Ontario
4:45
Manage Construction Change Orders
Builder's Playbook Canada: Ontario
5:23
Chantier : suivre les heures et le matériel
Builder's Playbook : gestion de chantier
3:44
Réception des travaux et déficiences
Builder's Playbook Québec
OpenConstruction Academy
Séries completas em inglês, alemão e francês
Todos os vídeos no YouTube
Um projeto por país, no seu idioma, do primeiro orçamento à entrega.
10vídeos
USAENBuilder's Playbook USA: Construction Management with OpenConstructionERP
6vídeos
6vídeos
CanadaENBuilder's Playbook: Canada
12vídeos
8vídeos
4vídeos
5vídeos
QuébecFRBuilder's Playbook: Québec
8vídeos
7vídeos
9vídeos
5vídeos
8vídeos
Cada guia percorre um fluxo real de obra passo a passo, com o que fazer e por quê em cada etapa.
293 guias em 8 disciplinas
Escrito para um mercadoGermany13Australia10Brazil10Canada10China10Spain10United Kingdom10Hungary10India10Mexico10New Zealand10Russia10Saudi Arabia10United States10South Africa10
Números da versão atual. Alguns já estarão desatualizados quando ler isto - o repositório evolui depressa.
itens de custo prontos a usar, em várias especialidades e composições.
IFC, DWG/DGN, Excel/CSV, PDF e 20+ outros formatos de entrada - e 40+ formatos de saída a partir de um único modelo canónico.
módulos plug-in que cobrem todo o fluxo de obra - projetos, BOQ, levantamento, concursos e mais.
núcleo open-source sob AGPL-3.0. Sem aprisionamento a fornecedores. Os seus dados continuam seus.
Por trás de cada preço unitário está a receita: horas de mão de obra, materiais e tempo de equipamento exigidos, prontos a reprecificar para o seu mercado.
Exemplos resolvidos a partir das bases acima
Cada base tem seus próprios itens e códigos de item. As bases precificadas são mostradas em euros para uma comparação equivalente; as bases de coeficientes mostram quantidades de recursos da norma nacional. Cada descrição permanece no idioma que você escolheu.
Escolha o tipo de empresa que gere e a plataforma ativa os módulos dessa função, ligados numa base. Passe o rato num perfil para acender o seu favo de módulos.
Cada perfil mantém o núcleo da plataforma sempre ativo: projetos, a base de dados de custos, o catálogo de recursos, as composições, os painéis e a administração. Os perfis nunca bloqueiam nada, apenas destacam os módulos mais relevantes para esse trabalho, e pode adicionar ou remover qualquer módulo mais tarde.
Tekhne
ATMIID
Optimum Technology
Elevait
MAD Engineers
Construccions 360 Plus
Tekhne
ATMIID
Optimum Technology
Elevait
MAD Engineers
Construccions 360 Plus
LMH
Niven Builders
Colas
Basil Read
C&C Consulting
LMH
Niven Builders
Colas
Basil Read
C&C Consulting
Tegrity Contractors
PW Pole Barns
Digitarh
Overzicht
CSTB
Forida
Yutopias
Virtuza
Tegrity Contractors
PW Pole Barns
Digitarh
Overzicht
CSTB
Forida
Yutopias
Virtuza
IC İçtaş
L&QL&Q
Rhomberg Sersa Rail Group
The Beck Group
Woolpert
Stecol
Tucrail
IC İçtaş
L&QL&Q
Rhomberg Sersa Rail Group
The Beck Group
Woolpert
Stecol
Tucrail
AGPL-3.0 no GitHub. As issues e o roadmap estão lá, o que vem a seguir e o que avariou na semana passada está no registo de commits.
Cada issue e item do roadmap é público no GitHub. Abra uma issue com uma descrição precisa, nós implementamos e damos-lhe o crédito.
Factos simples que você mesmo pode verificar: uma licença aberta, formatos abertos e os seus dados no seu próprio servidor.
Uma comparação franca. As suítes comerciais lideram em poucas integrações pagas há anos, no resto o OpenConstructionERP iguala ou supera, sem custo de licença.
| Capacidade | OpenConstructionERP | Suíte enterprise de orçamentação | Ferramenta de propostas para obras pesadas | ERP de construção legado |
|---|---|---|---|---|
| Núcleo open-source (AGPL-3.0) | ✓ | ✕ | ✕ | ✕ |
| Auto-hospedar na sua infraestrutura | ✓ | ~ | ✕ | ~ |
| Levantamento com IA a partir de PDF / foto | ✓ | ~ | ✕ | ✕ |
| Ingestão multi-CAD (DWG / RVT / IFC / DGN) | ✓ | ✓ | ✕ | ✕ |
| Mais de 120.000 itens de custo prontos para uso | ✓ | ~ | ✓ | ~ |
| Multijogador em tempo real (CRDT) | ✓ | ✕ | ✕ | ✕ |
| 44 idiomas na i18n do núcleo | ✓ | ~ | ✕ | ~ |
| Arquitetura modular de plugins | ✓ | ✕ | ✕ | ✕ |
| Custo típico / utilizador / ano | € 0 · auto-hospedado | Licença por utilizador | Licença por utilizador | Licença por utilizador |
| Implementação / onboarding | € 0 · documentação + comunidade | Projeto de implementação pago | Projeto de implementação pago | Projeto de implementação pago |
| Duração do contrato | Nenhuma · cancele quando quiser | Fidelização de 1 a 3 anos | Fidelização de 1 a 3 anos | Fidelização de 3 a 5 anos |
Cada funcionalidade é um pacote autónomo. Coloque-o, retire-o - a instalação em execução deteta-o em segundos, sem downtime.
Cada funcionalidade é um pacote Python com manifesto, sem reconstruir. APIs tipadas, OpenAPI gerada.
make module-new# Sign in and keep the access token $ TOKEN=$(curl -s -X POST http://localhost:8080/api/v1/users/auth/login \ -H "Content-Type: application/json" \ -d '{"email": "you@example.com", "password": "..."}' \ | jq -r .access_token) # Create a project $ curl -X POST http://localhost:8080/api/v1/projects/ \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"name": "Logistics Hub", "region": "DACH", "classification_standard": "din276", "currency": "EUR"}' # → HTTP 201 Created, the new project as JSON # Every route: http://localhost:8080/api/docs
# backend/app/modules/punchlist/manifest.py from app.core.module_loader import ModuleManifest manifest = ModuleManifest( name="oe_punchlist", version="0.1.0", display_name="Punch List", description="Track deficiencies and snag items with photo evidence", category="core", depends=["oe_projects"], auto_install=True, enabled=True, ) # The loader finds the package and mounts its router # at /api/v1/punchlist.
Escolhas deliberadamente aborrecidas. Todas open-source.
A plataforma fica no centro aberto do seu software. Formatos abertos, API documentada e webhooks sincronizam orçamento, modelo e finanças, sem nada preso.
Dados e API prontos para IA
No Revit. No AutoCAD.
RVT, DWG and IFC as data, fully standalone
Our converters read Revit 2019 to 2027, AutoCAD DWG and IFC files on your own Windows computer, offline, nothing uploaded. Professional-grade readers, and the Community version is free for everyone.
Faturas, decomposições de custos e reclamações seguem direto para as finanças, sem reintrodução.
Modelos e desenhos chegam das suas ferramentas de projeto e as observações de revisão voltam.
Desenhos, contratos e relatórios ficam sincronizados com o seu gestor documental.
Os números do projeto alimentam os seus painéis em tempo real, sem copiar e colar.
Atividades e dependências circulam nos dois sentidos entre cronograma e orçamento.
Os eventos do projeto iniciam os seus fluxos e estes chamam a API de volta.
As marcas pertencem aos respetivos proprietários; são mostradas para indicar compatibilidade.
Sem aprisionamento a fornecedor, por design.
Cada número é exportável, os formatos são abertos e a mesma API documentada da aplicação está aberta para si. Os seus dados são seus e pode levá-los quando quiser.
Ler a documentação de integração e APIO OpenConstructionERP nasce de uma década de investigação aberta em tecnologia para a construção.
Durante a última década, a nossa equipa trabalhou na gestão de recursos de projetos de construção. Pelo caminho ficámos curiosos sobre como surgiram as ferramentas do setor, das primeiras tentativas de automatizar o projeto às plataformas ERP de hoje, e isso deu origem a dois textos mais longos («The Lobbyists’ Wars and the Development of BIM» e «The History of the BIM Map»). É difícil perceber para onde vamos sem saber como chegámos aqui.
Escrevemos bastante sobre estes temas ao longo dos anos, e parte disso teve muitos leitores. Além de escrever, prestámos consultoria a construtoras, consultoras, promotores e fornecedores de software sobre como tratam os dados do projeto: como base das decisões e não como um subproduto. Esse trabalho permitiu-nos ver o setor dos dois lados: quem constrói as ferramentas e quem as usa todos os dias. Muitas dessas observações acabaram no livro Data-Driven Construction, agora disponível em 16 idiomas (datadrivenconstruction.io/books).
Dois outros problemas mantiveram-nos ocupados. Um era ajudar quem não é programador a aceder a formatos de ficheiro proprietários que nunca foram pensados para ser abertos. O outro era encontrar uma forma mais limpa de descrever o trabalho de construção através de um modelo de recursos. Ambos deram origem a ferramentas gratuitas: os conversores CAD/BIM da DDC (IFC, DWG, DGN → dados estruturados) no GitHub, e o CWICR, uma base de dados multilingue de trabalhos e recursos de construção, com mais de 120 000 itens em 11 idiomas, publicada como OpenConstructionEstimate-DDC-CWICR.
Tudo isto foi o trabalho de base para algo que queríamos construir há muito tempo: um ERP aberto e modular para a construção. A última geração de ferramentas permitiu finalmente reunir numa única plataforma a metodologia, os modelos de dados e as implementações anteriores. Agora é público e de código aberto.
O progresso nasce do diálogo - do confronto de perspetivas e da abertura a novas abordagens. Ficaria grato pela sua participação nesta conversa sobre a inevitável «uberização» do setor da construção e a transparência dos processos de estimativa de custos e prazos em projetos de obra.
DataDrivenConstruction Team
fundador, datadrivenconstruction.io
AECOM
VINCI Energies
Artelia
Merck
RBS wave
AECOM
VINCI Energies
Artelia
Merck
RBS wave
Shapemaker
Scholze-Thost
VRAME
AXIA Energia
AFRY
Hofschröer
TDF
Renaissance Construction
Shapemaker
Scholze-Thost
VRAME
AXIA Energia
AFRY
Hofschröer
TDF
Renaissance Construction
Sintagma
Trafikverket
TMM Group
Dar Al Riyadh
pbs Ingenieure
SCON GmbH
Sintagma
Trafikverket
TMM Group
Dar Al Riyadh
pbs Ingenieure
SCON GmbH
A maioria dos arquivos de projeto de obras civis são basicamente prisões de dados. Muita informação útil, alinhamentos, superfícies, quantitativos, simplesmente ali, trancada em formatos que nunca foram feitos para funcionar bem com nada fora do software original. Já perdi tempo demais tentando responder perguntas simples como 'quantos poços de visita há nesta obra?' ou 'qual é o volume por fase?', só para descobrir que os dados estão enterrados cinco camadas dentro de um DWG ou DGN. A Data Driven Construction resolve isso. Os conversores deles abrem esses formatos fechados e entregam dados estruturados que você realmente pode usar, no Power BI, no Excel, ou até mesmo em um prompt de LLM se você estiver fazendo algo mais sofisticado. Não é chamativo, mas é extremamente útil. Se você está tentando ir além de capturas de tela e PDFs e realmente usar seus dados de projeto, esse é o tipo de ferramenta que torna isso possível. É a diferença entre adivinhar e saber. E, sinceramente, já me salvou mais de um sábado de manhã.
Faça parte do movimento com a DataDrivenConstruction! Vamos tornar realidade a verdadeira liberdade nos formatos de dados e catalisar uma nova era de produtividade e inovação na construção. A jornada real e necessária dos formatos fechados para os 'abertos' ainda nem começou: a verdadeira liberdade nos formatos de dados, livre de amarras proprietárias e acessível a todos, é o que precisamos para desbloquear inovação e colaboração em toda a indústria da construção, beneficiando em particular os 99% do setor, ou seja, as PMEs, e libertando o setor para um crescimento acelerado.
A plataforma inteira é gratuita, e nada nela está escondido.
Leve a plataforma a empresas que já conhece e cobre pelo que acrescenta.
Sem taxas, sem exclusividade, sem obrigações para nenhuma das partes.
Use-o por conta própria, gratuitamente, sob AGPL-3.0, escolha um plano comercial quando precisar de suporte ou de uma licença para os conversores, ou torne-se parceiro.
A plataforma open-source completa. Corra-a na sua infraestrutura, sem compromissos.
Discovery → workshop → seleção de módulos → desenvolvimento → implementação no seu hardware. Código-fonte entregue.
Sessões práticas: orçamentação, BIM para BOQ, medições com IA, pipelines GAEB. Gravadas para a biblioteca da equipa.
Mapeamento de normas, estratégia de base de preços, arquitetura da pipeline, revisão de código.
Apenas workshops públicos selecionados são listados. Muitos contratos enterprise importantes mantêm-se sob NDA.










Workshop incrível, Artem! Os preparativos estão a todo o vapor! Já estou ansioso pelo hackathon do ano novo! 💪🏻
O que acontece quando não apenas organizamos os processos de construção, mas também os analisamos de forma inteligente? Este foi o tema do nosso workshop com Artem Boiko sobre «Data-Driven Construction». O foco esteve na questão: como podemos aproveitar melhor os dados existentes para tornar os projetos de construção mais eficientes, mais transparentes e menos sujeitos a erros. Com exemplos concretos, Artem mostrou como dados estruturados ajudam a manter a visão geral, identificar aditivos cedo e melhorar a comunicação entre projeto e execução. Particularmente interessante: como ferramentas e modelos digitais já podem hoje automatizar processos. A construção orientada por dados já não é um tema do futuro - estamos no meio dela. O workshop mostrou o quanto há potencial quando trabalhamos juntos e fazemos os dados realmente trabalhar por nós.
Artem Boiko fez uma apresentação excelente para toda a equipa da Shapemaker, oferecendo conhecimentos profundos sobre migração de dados de software de engenharia e temas relacionados. A sua experiência e comunicação clara tornaram conceitos complexos fáceis de entender, equipando a nossa equipa com conhecimentos práticos que podemos aplicar imediatamente. Recomendo vivamente os seus serviços a quem procura clareza e estratégias acionáveis nesta área!
Achei o workshop DataDrivenConstruction muito interessante. Na minha opinião, todos conseguiram acompanhar. Dá para ver pelos teus slides quanto tempo, perseverça e esforço investiste. As apresentações ao vivo também foram ótimas. A única coisa que criticaria seria a quantidade de slides - foram realmente demais. Mas isso é reclamar no mais alto nível. No conjunto, foi o melhor workshop em que estive. E além disso és uma pessoa muito agradável.
Ich fande DataDrivenConstruction Workshop sehr interessant. Meiner Meinung nach konnten alle folgen. Man merkt auch anhand deiner Folien wieviel Zeit, Ausdauer und Mühe du hineingesteckt hast. Auch die Live Präsentationen waren super. Das einzige was ich bemängeln würde, wäre die Anzahl der Folien, dadurch kamen zu viele slides zustande. Aber das ist meckern auf dem höchsten Niveau. Rundum war es der beste Workshop bei dem ich war. Außerdem bist du auch eine sehr angenehme Person.
No geral, achei a formação DataDrivenConstruction realmente fascinante e muito enriquecedora. Gostei particularmente: do contexto «histórico» sobre os vários softwares CAD (foi fascinante de ouvir e tinha algo de jornalismo investigativo); da interessante abordagem à automação via DataFrames; dos teus exemplos práticos de automação de processos na construção; e do olhar sobre tendências atuais como Claude Code e OpenClaw - deste vida ao tema. Única desvantagem: foi mesmo muita informação em apenas dois dias. Ao mesmo tempo, mostraste muito bem como podemos continuar a orientar-nos - por exemplo, registando os nossos processos de forma estruturada no quadro Miro. Muito obrigado pela formação e pela troca de ideias.
Die DataDrivenConstruction Schulung fand ich insgesamt wirklich spannend und sehr bereichernd. Besonders gut gefallen haben mir: der „historische“ Hintergrund zu den verschiedenen CAD-Softwares (das war spannend zu hören und hatte etwas von Investigativjournalismus); der interessante Ansatz zur Automatisierung über DataFrames; deine eigenen praxisnahen Beispiele zur Prozessautomatisierung im Bauwesen; und der Einblick in aktuelle Trends wie Claude Code und OpenClaw, du hast das Thema mit Leben gefüllt. Einziger Nachteil: Es war wirklich viel Input in nur zwei Tagen. Gleichzeitig hast du sehr gut aufgezeigt, wie wir uns selbst weiter orientieren können, zum Beispiel über das strukturierte Aufzeichnen unserer Prozesse im Miro-Board. Vielen Dank nochmal für die Schulung und den Austausch.
Foi um workshop fantástico com conteúdos emocionantes com os quais nós, e eu pessoalmente, aprendemos muito. Obrigado por dedicares tanto tempo a nós. Mal podemos esperar para experimentar o que aprendemos o quanto antes e integrá-lo nos nossos projetos! #bleedingedge
Envie-nos um breve briefing com o seu orçamento e prazo e responderemos.
make module-new, ou descreva-o no construtor de módulos integrado e reveja cada ficheiro antes de o instalar. Um módulo é uma pasta, por isso pode copiá-lo para outra instalação e também funciona lá. Bons candidatos: bases de dados de custos regionais, conectores ERP, conjuntos de regras de validação personalizados.A aplicação de secretária gratuita para Windows, macOS e Linux, ou um comando no seu próprio servidor. Código aberto sob a licença AGPL-3.0.
Cada funcionalidade é um módulo: uma pasta com um manifest, um componente de página com carregamento tardio e uma entrada no registro. Coloque, recarregue, e ele aparece na página de Módulos pronto para ser ativado.
frontend/src/modules/
├── _registry.ts ← adicione seu import aqui
├── your-module/
│ ├── manifest.ts ← metadados, rotas, navegação, i18n
│ ├── YourModule.tsx ← página principal (carregada com React.lazy)
│ └── index.ts ← exportação barrel
Crie frontend/src/modules/your-module/.
manifest.ts
Um id único, name, ícone de lucide-react, categoria, dependências opcionais, rotas e itens de navegação. Inclua traduções se precisar de textos específicos do módulo.
export default function YourModule() { ... }. Mantenha a lógica de dados pura em data/ e teste-a com vitest.
Adicione o import e o manifest ao _registry.ts, e uma chave nav.* em i18n.ts para cada idioma (a barra lateral é renderizada antes de as traduções assíncronas chegarem).
Execute npm run dev. Ative na página de Módulos → aparece na barra lateral → navega via React.lazy. A busca (/) captura seus searchEntries.
import { lazy } from 'react';
import { Sparkles } from 'lucide-react';
import type { ModuleManifest } from '../_types';
const MyModule = lazy(() => import('./MyModule'));
export const manifest: ModuleManifest = {
id: 'my-feature',
name: 'My Feature',
version: '1.0.0',
icon: Sparkles,
category: 'tools',
defaultEnabled: false,
routes: [{ path: '/my-feature', title: 'My Feature', component: MyModule }],
navItems: [{ labelKey: 'nav.my_feature', to: '/my-feature', icon: Sparkles, group: 'tools' }],
};
id único em kebab-caseexport default (necessário para React.lazy)_registry.tsnav.* em todos os 4 blocos de idioma de i18n.tsdefaultEnabled: false (opt-in)