Documentação
Como funciona o cadmark
Arquitetura e fluxo de trabalho da aplicação no browser: da peça carregada, passando pelas features reconhecidas e pelos identificadores estáveis, até ao assistente, às pré-visualizações e à exportação.
Última atualização: 11 de outubro de 2026 · descreve a versão web em beyware.com/app/
Visão geral
O quê: o cadmark é uma aplicação CAD que funciona no browser. Carregas uma peça (STEP, IGES, BREP ou STL) ou crias uma nova, o cadmark reconhece elementos funcionais como furos, escareados, rasgos, cavidades e nervuras, dá a cada um um identificador duradouro como H3 ou PK1 e mostra dimensões diretamente do kernel CAD. Alteras parâmetros, acrescentas esboços e operações, ou descreves a alteração ao assistente. Podes pré-visualizar alterações manuais e aplicá-las ou rejeitá-las. A IA pode aplicar alterações diretamente; verifica o resultado e anula quando for preciso. No fim exportas STEP, STL ou um desenho técnico em PDF.
Para quem é: projetistas, engenheiros e makers que querem compreender uma peça depressa e alterá-la sem ambiguidades, também em conjunto com uma IA. Preço, período de teste e conta estão na página do produto.
Onde funciona: no servidor da BEYWARE na Alemanha. O browser mostra apenas a interface; geometria, reconhecimento e exportação são calculados no servidor pelo kernel open source OpenCascade através do CadQuery. Cada conta recebe a sua própria sessão com os seus próprios projetos. Não se instala nada; basta um browser atual em Windows, macOS ou Linux.

Do modelo à feature
Um modelo CAD é composto por faces. O cadmark agrupa essas faces em elementos com nome numa cascata de reconhecimento: duas passagens, nove etapas. A primeira passagem reclama faces, a segunda apenas refina. Cada face tem exatamente um proprietário; cada elemento transporta a sua fundamentação e uma pontuação de qualidade, para que uma decomposição nunca seja uma caixa negra.
Elementos reconhecidos
- Furos (passantes e cegos): grupos de cilindros coaxiais, cones de ponta de broca e fundos centrados formam um só furo, mesmo quando o STEP os divide em metades. Nos furos cegos é lido o ângulo de ponta.
- Rebaixos e escareados como cabeça de um furo; o diâmetro do escareado vem dos círculos de contorno exatos.
- Rasgos (passantes ou cegos) a partir de pares de cilindros parciais com flancos planos.
- Cavidades, ranhuras, aberturas, degraus.
- Nervuras, ressaltos, pinos, elevações.
- Chanfros, boleados, concavidades e planos funcionais (faces planas grandes).
As dimensões são lidas da geometria B-rep, não estimadas a partir da malha de visualização: diâmetro e profundidade de um furo, comprimento × largura de um rasgo a partir da distância entre eixos dos seus cilindros parciais, extensão e normal de um plano, área da face. Medir entre dois elementos (tecla I) também corre no kernel: distância entre eixos de dois furos, distância normal entre planos paralelos, distância mais curta, ângulo.
Comparação com normas para furos
Cada diâmetro de furo é comparado com valores de tabela exatos: furos de passagem fino, médio e grosso segundo a ISO 273, furos para rosca de passo normal segundo a ISO 2306/DIN 336, rebaixos para parafusos de cabeça cilíndrica ISO 4762 segundo a DIN 974-1 e escareados a 90 graus segundo a ISO 10642/DIN 74, de M1,6 a M30. A tolerância é de 0,005 mm, para que uma peça em polegadas não seja lida como métrica. Uma correspondência lê-se então, por exemplo, «M6 passagem médio (ISO 273), cabeça cilíndrica ISO 4762» ou «furo para rosca M5, provavelmente rosca M5x0,8». Um diâmetro por si só não prova intenção, por isso o cadmark designa sempre a correspondência como leitura e conta as alternativas.
Padrões
Vários elementos do mesmo tipo, tamanho e orientação são agrupados em padrões: filas lineares, grelhas retangulares e círculos de furos. Conjuntos irregulares são decompostos em filas com espaçamento igual. A base é o centróide de cada elemento, que fica sobre o eixo em todas as features de revolução, pelo que um padrão não depende da ordem das faces nem da divisão do STEP. Um padrão é o que queres dizer com «4× M6 em 90 × 50» e o que o assistente precisa para alterar os quatro de uma só vez.
Identificadores estáveis
Internamente, cada feature reconhecida transporta um hash de conteúdo como id. Uma alteração de 0,01 mm já produz um novo hash; comentários, cotas de inspeção e as próprias notas do assistente perderiam o seu alvo a cada alteração de parâmetro. Por isso, cada feature recebe adicionalmente um identificador legível composto por um prefixo de classe e um número:
| Prefixo | Elemento | Prefixo | Elemento |
|---|---|---|---|
| H | furo, furo cego | RB | nervura |
| CB · CS | rebaixo · escareado | BS · PN | ressalto · pino |
| SL | rasgo | CH · RD · FL | chanfro · boleado · concavidade |
| PK · GR | cavidade · ranhura | ST · OP | degrau · abertura |
| PL | plano funcional | RF | elevação |
Porque H3 continua a ser H3
Cada modelo mantém um registo de todos os identificadores que alguma vez atribuiu. Após uma reconstrução, o cadmark faz corresponder as features recém-reconhecidas a esse registo:
- Continuidade exata. Se uma feature tem o mesmo hash de conteúdo de antes, o caso é claro; não é preciso geometria.
- Atribuição ótima. Para o resto, o cadmark resolve um problema de atribuição por classe de feature (método húngaro). O custo de um emparelhamento é o deslocamento relativo ao tamanho da peça mais a alteração de dimensões e de eixo. Um furo deslocado ou ampliado mantém o seu nome; um furo do outro lado da peça não.
- Sem adivinhar. Uma atribuição só conta se ficar abaixo de um limiar e for claramente melhor do que a segunda classificada. Gémeos simétricos ficam por resolver: a feature recebe um novo número e uma indicação de que é provavelmente o antigo H2.
Os números atribuídos nunca são reutilizados. Se H2 desaparecer, a sua entrada fica no registo como «desaparecida» e o próximo furo novo é H5, não H2. Os hashes antigos tornam-se aliases do identificador atual, pelo que um comentário num furo sobrevive a um redimensionamento. Na primeira construção, o cadmark numera na ordem de leitura, como faria um desenho: H1, H2, H3 de cima para baixo.
Abaixo do identificador, as faces individuais recebem referências semânticas como H3.wand0 (parede) ou PK1.boden0 (fundo): identificador, função e um índice determinístico. Os padrões transportam os identificadores dos seus membros. Identificadores, referências de face e aliases antigos podem ser usados em todo o lado onde tu ou o assistente se referem a um elemento: em comentários, medições, cotas de inspeção e chamadas de ferramentas.
O assistente
O assistente é um segundo operador com as mesmas ferramentas que tu. Trabalha sempre através da tua própria conta. Em Assistant settings escolhes uma de três opções:
- ChatGPT: a tua própria subscrição ChatGPT. Inicias sessão com um código de utilização única; o cadmark executa a Codex CLI dentro da tua própria sessão. Os dados vão para a OpenAI.
- Claude: a tua própria subscrição Claude (Pro ou Max). Inicias sessão através de uma ligação e de um código dentro da app; o cadmark executa o Claude Code dentro da tua própria sessão. Os dados vão para a Anthropic.
- Ollama: o teu próprio servidor Ollama, acessível por https a partir da internet, ou Ollama Cloud (ollama.com) com a tua própria chave de API. A chave é guardada nas definições da tua conta no servidor da BEYWARE e nunca mais é mostrada. Os dados vão para o servidor que indicares, ou para a Ollama no caso do Ollama Cloud.
Escolhes o modelo e o esforço de raciocínio por projeto; /model e /effort no chat permitem alternar rapidamente. A BEYWARE não tem contrato de IA próprio e não fatura custos de IA; não existe alternativa paga. O servidor da BEYWARE não executa nenhum modelo de IA. As funcionalidades CAD também funcionam sem IA.
O que o assistente vê e pode fazer
O assistente não vê píxeis. Recebe o relatório da peça: parâmetros com os seus limites, todas as features com identificador, dimensões, padrão e leitura de normas, operações, corpos, esboços e cotas de inspeção. Se selecionares faces ou arestas antes de perguntar, a seleção segue com os seus identificadores. As suas ferramentas, por grupos:
- Ler e consultar: relatório da peça, detalhes de features, listas de faces e arestas, consultas de geometria por tipo, diâmetro, profundidade, tamanho de rosca, direção ou proximidade (
geometrie_abfragen), ler o código-fonte. - Alterar: definir parâmetros; criar, editar e remover operações (furo, puxar, boleado, chanfro, padrão linear e circular, espelhar); criar e editar esboços; extrudir, revolucionar, loft e sweep de perfis; executar código CadQuery personalizado sobre o corpo acabado; substituir o código-fonte; criar uma nova peça a partir de código.
- Nomear: propor, criar e remover features; criar e remover zonas («de onde até onde»).
- Verificar: medir com exatidão; criar, editar e avaliar cotas de inspeção; verificar a estabilidade dos identificadores sob variação de parâmetros; verificar a validade B-rep (
modell_pruefen); renderizar vistas do modelo como imagens (modell_ansicht); inspecionar passos de construção anteriores só em leitura. - Canal de retorno: ler, responder e criar comentários no modelo; exportar o desenho.
As imagens do modelo são renderizadas pelo cadmark a partir da geometria CAD real; servem ao assistente como verificação, nunca como base de medição. Se anexares um esboço (PNG, JPEG ou WebP até 5 MB), a imagem vai para o modelo como entrada; o cadmark guarda a referência original no projeto e identifica-a como imagem de referência, não como esboço dimensionalmente exato.
Pré-visualizar, aplicar, rejeitar
Nas alterações manuais, inspecionas a pré-visualização antes de a aplicar. A IA também pode usar as suas ferramentas para guardar alterações diretamente. Não é exigida aprovação humana antes de cada alteração da IA. Verifica o resultado e o comprovativo de alteração; anular permite reverter alterações aplicadas.
Antes de cada alteração, o assistente lê a versão do modelo e a revisão e envia ambas. Se entretanto o estado tiver ficado desatualizado, o cadmark rejeita a chamada e o assistente tem de ler de novo. As ferramentas de parâmetros e operações devolvem um comprovativo: se foi aplicado, revisão e versão do modelo antes e depois, parâmetros ou operações alterados, features afetadas e a caixa envolvente e o volume medidos. O painel mostra este comprovativo também após recarregar e após anular. Uma resposta de texto do assistente não é um comprovativo; só uma ferramenta pode aplicar algo.
As alterações ao código-fonte têm proteção adicional: o assistente lê o código e um token de origem, verifica a proposta como pré-visualização (geometria, volume, perdas de features, extensão da alteração) e só uma segunda chamada explícita com o mesmo código e token a aplica. Cada pré-visualização de código transporta um id e um hash SHA-256 do código; aplicar e rejeitar têm de indicar ambos, caso contrário a pré-visualização conta como substituída.
Anular e refazer
Parâmetros, operações, esboços, código-fonte, nomes de features e zonas partilham um histórico de até 50 instantâneos e a mesma revisão (Ctrl+Z / Ctrl+Y). Anular restaura a topologia guardada anteriormente, incluindo o desaparecimento intencional do fundo de um furo cego ao mudar para um furo passante. Um anular ao nível do código-fonte é verificado geometricamente de novo. Construções falhadas e features perdidas nunca são aplicadas.
Limites do assistente
O assistente pode errar: compreender mal, escolher uma ferramenta inadequada ou deixar passar uma verificação. O cadmark obriga-o a produzir comprovativos, não correção. Não deve contornar os limites de parâmetros definidos no modelo; perante faces, arestas ou corpos ambíguos deve perguntar em vez de adivinhar. Verifica cada pré-visualização e, em particular, as dimensões, as cotas de inspeção e o desenho, antes de algo seguir para fabrico.
Construção
A árvore do modelo é o histórico de construção. Tu e o assistente usam os mesmos ids de operação, revisões, validação geométrica e o mesmo histórico.
Ferramentas na seleção
Clica numa face ou aresta e a barra correspondente aparece ao lado: Puxar (E), Furo (H), Boleado (F), Chanfro (C). Escreve um valor, prime Enter: a operação entra no histórico (alterar valor, desativar, eliminar, entregar ao assistente). Isto também funciona com peças STEP importadas. Se uma operação não encontrar o seu alvo após uma reconstrução, é ignorada e assinalada a vermelho.
Parâmetros
As dimensões condutoras de uma peça paramétrica estão na árvore do modelo em Parameters, com os limites definidos pelo autor da peça. Escreve um valor (opcionalmente com unidade, como 2 in); Enter mostra a pré-visualização. Os valores das operações podem ser expressões sobre parâmetros, para que um furo siga loch_d. Só são avaliados números, nomes de parâmetros, aritmética básica e min, max, abs, round; código estranho é rejeitado.
Esboços e perfis
- Esboço num plano: retângulo, círculo, anel, perfil em L, secção de casquilho com flange ou polígono fechado com dimensões condutoras. As dimensões de um esboço anterior ficam acessíveis como aliases, por exemplo
O1_width. - Extrudir como novo corpo, adicionar ou cortar, com um comprimento, simétrico ou «através de tudo» em ambas as direções.
- Revolucionar um perfil fechado por um ângulo.
- Loft como superfície regrada entre dois ou mais perfis em planos paralelos (círculos ou polígonos convexos, sem interpolação suave).
- Sweep de um círculo ou anel ao longo de uma linha ou de um arco até 180° com linhas tangentes opcionais.
- Padrões de corpos lineares ou circulares com ids de cópia persistentes; a contagem inclui o original,
360/Ndá um anel completo. As cópias têm de permanecer disjuntas. - Espelhar um corpo em XY, XZ ou YZ com um desvio, ou a peça inteira.
O sistema de esboços é um grafo de construção dirigido, não um resolvedor de restrições; não reclama graus de liberdade que não calculou. As identidades dos corpos seguem a proveniência exata da construção, nunca um índice ou uma face próxima. Uma alteração que perdesse um elemento com nome é rejeitada em vez de redirecionada em silêncio.
Verificação
As cotas de inspeção nascem de uma medição («Manter como cota de inspeção») com um valor nominal como número ou expressão e uma tolerância (por defeito ±0,1 mm ou ±0,5°). Aparecem na árvore do modelo e como cadeias de cotas no palco: verde quando a dimensão está certa, vermelho em caso de desvio, cinzento quando apenas observada. São medidas de novo após cada reconstrução. Inspect step mostra um passo de construção anterior só em leitura com as dimensões atuais; Check geometry reconstrói a B-rep guardada de forma independente e reporta validade, topologia e diagnósticos do kernel. A verificação de estabilidade varia parâmetros e dimensões de esboço e reporta quais os identificadores que perdem as suas faces.
Projetos
Cada projeto é uma pasta própria com nome, unidade (mm ou in), definição de reconhecimento e escolha do assistente. Modelos ao criar: peça vazia, placa de furos, caixa, casquilho, ou uma descrição e uma imagem de referência para o assistente. Duplicar cria uma variante a partir do estado guardado com o seu próprio histórico. Eliminar remove um projeto permanentemente com todos os ficheiros, comentários e exportações.
Importação e exportação
O browser não tem acesso ao sistema de ficheiros do servidor, por isso envia o próprio ficheiro (até 50 MB). Este fica na pasta do projeto Imports; os formatos que o importador não lê diretamente são convertidos para STEP no carregamento, e o original é mantido ao lado.
| Formato | Abrir | Exportar | Nota |
|---|---|---|---|
| STEP | .step, .stp | sim | lido diretamente; formato de intercâmbio recomendado |
| BREP | .brep, .brp | – | formato nativo do OpenCascade, lido diretamente |
| IGES | .iges, .igs | – | convertido para STEP no carregamento |
| STL | .stl | sim | a malha torna-se faces; até 60 000 triângulos; exportação, por exemplo, para impressão 3D |
| – | sim | desenho técnico com vistas, dimensões, tabela de furos |
STL: o que se torna exato e o que não
Uma malha STL é cosida, fechada num sólido e os triângulos coplanares são fundidos em faces planas reais. As faces planas e as dimensões entre elas são, portanto, exatas. As faces curvas continuam facetadas e não são reconhecidas como furos. Malhas com mais de 60 000 triângulos são rejeitadas com um pedido de STEP. Ficheiros de peça em Python não são aceites na versão web.
Desenho técnico (PDF)
O desenho é derivado da B-rep exata através da remoção de linhas ocultas (HLR) do OpenCascade, não da malha de visualização: os círculos continuam círculos, as arestas ocultas são verdadeiras arestas ocultas. A folha segue as convenções ISO habituais de um desenho de oficina europeu:
- Projeção segundo o método europeu (ISO 128 / ISO 5456-2, método E): vista de cima abaixo da vista de frente, vista da esquerda à sua direita, vista isométrica no quadrante livre, símbolo na legenda.
- Escala da série ISO 5455 e a folha mais pequena, de A4 a A0 ao baixo, que mantém as vistas legíveis; a vista isométrica usa a escala seguinte mais pequena que caiba.
- Linhas segundo a ISO 128, grupo 0,5: visíveis 0,5 mm, ocultas, de cota e de eixo 0,25 mm; altura do texto 2,5 mm segundo a ISO 3098; marcas de centragem segundo a ISO 5457.
- Dimensões: dimensões gerais uma vez cada (ISO 129-1), indicações de furos como «4× Ø5.2» na vista ao longo do eixo do furo, marcas de centro, numeradas até 60 furos.
- Tabela de furos na folha 2 com posições relativas ao canto frontal inferior esquerdo da caixa envolvente.
- Legenda segundo a ISO 7200 com título, número, material, revisão, data, unidade e tolerância geral ISO 2768-m por defeito.
A saída é PDF vetorial. Defines a unidade (mm ou in), o título e o material na exportação; o assistente também pode acionar o desenho.
No browser
Inicias sessão em beyware.com/konto/ (em alemão) e abres beyware.com/app/. Antes de cada pedido à app, o servidor verifica a sessão junto do serviço de contas; só passam contas em período de teste ou com subscrição ativa.
- O teu próprio espaço de trabalho por conta. Cada conta recebe o seu próprio processo de servidor cadmark com os seus próprios projetos, saídas e o seu próprio início de sessão do assistente. Ninguém vê o trabalho dos outros. O processo arranca no primeiro pedido e termina após 20 minutos sem pedidos; os teus projetos ficam guardados.
- A tua própria sessão. Cada conta recebe a sua própria sessão CAD, sem fila de espera nem limite de lugares. Após 20 minutos sem pedidos é terminada; os teus projetos ficam guardados.
- Dados na Alemanha. Projetos e carregamentos são guardados no servidor gerido pela BEYWARE na Alemanha, separados por conta. Se eliminares a tua conta, o espaço de trabalho com todos os ficheiros é removido. Detalhes na política de privacidade e nos termos de utilização (em alemão).
- Sem instalação. Basta um browser atual em Windows, macOS ou Linux. Até 760 píxeis de largura, a interface muda para um layout compacto com navegação inferior e painéis de ferramentas; recomenda-se um ecrã de desktop ou portátil.
- Conta. Os primeiros 30 dias de uma conta são grátis; depois a subscrição é mensal (preço de lançamento CHF 20 em vez de CHF 50). Na tua conta podes saltar uma cobrança, pausar a subscrição e exportar todos os teus dados. Podes cancelar na tua conta, com efeito no fim do período em curso, ou através do formulário de cancelamento sem iniciar sessão.
Limites e responsabilidade
- A chave de face baseia-se na geometria: sobrevive a nova malhagem e reordenação, mas não a uma alteração de geometria. É para isso que servem os identificadores e as âncoras de recurso dos comentários (chave de face → identificador → ponto).
- As peças STEP e BREP importadas não têm histórico de construção reconstruído nem intenção de projeto. Os seus identificadores estão ligados à geometria existente. Os esboços e as operações acrescentados depois são paramétricos.
- Se um furo é passante ou cego não se pode saber apenas pela face cilíndrica; a «profundidade» é medida ao longo do eixo. A extensão de um plano é o seu retângulo envolvente; faces fundidas deixam de fornecer as dimensões nominais da feature original.
- A verificação de estabilidade usa amostras finitas. Revela referências frágeis, mas não garante estabilidade sob todas as alterações possíveis.
- Validade no kernel não significa dimensões corretas, ausência de sobreposição entre corpos ou fabricabilidade. Uma imagem não prova dimensões nem geometria oculta.
- Loft e sweep cobrem deliberadamente um envelope pequeno (ver Construção). Dimensões ocultas não podem ser inferidas de uma única fotografia.
- O assistente pode errar. Não é garantida a disponibilidade do serviço; exporta os estados importantes como STEP.
O cadmark é uma ferramenta. Tu és responsável pela verificação profissional das peças, dimensões e desenhos que produz, por exemplo antes do fabrico.
FAQ
H3 continua mesmo a ser H3 quando altero a peça?
Para alterações suportadas, sim. Após cada reconstrução, o cadmark faz corresponder as features reconhecidas ao registo de identificadores atribuídos: primeiro por continuidade exata, depois por uma atribuição ótima sobre posição, tamanho e eixo. Se H3 se mover ou crescer, continua a ser H3. Só quando dois candidatos simétricos encaixam igualmente bem é que o cadmark prefere um número novo e diz isso. Os números atribuídos nunca são reutilizados.
O assistente pode alterar o meu modelo sem perguntar?
Sim. A IA pode aplicar alterações diretamente através das suas ferramentas sem te pedir aprovação a cada passo. As ferramentas de pré-visualização e medição ajudam na inspeção. Verifica o resultado guardado e o comprovativo de alteração; as alterações aplicadas podem ser anuladas. Nas alterações manuais, podes inspecionar a pré-visualização antes de a aplicar ou rejeitá-la.
O que vai para o fornecedor de IA quando uso o assistente?
Os teus pedidos, as respostas das ferramentas do cadmark (relatórios com identificadores e dimensões, medições, resultados de verificação), imagens do modelo que o cadmark renderiza a partir da geometria exata quando pedido, e imagens de esboços que tu próprio anexas. Tudo isto vai apenas para o fornecedor que escolheste: OpenAI para o ChatGPT, Anthropic para o Claude e, para o Ollama, o servidor que indicares (Ollama no caso do Ollama Cloud). Aplicam-se os termos desse fornecedor; o cadmark não tem contrato de IA próprio nem alternativa paga.
Porque é que o cadmark não reconhece furos no meu ficheiro STL?
Uma malha STL contém apenas triângulos. O cadmark cose-a num sólido, funde triângulos coplanares em faces planas reais e escreve um ficheiro STEP. As faces planas e as dimensões entre elas são exatas; as faces curvas continuam facetadas e não são reconhecidas como furos. Se tiveres o original em STEP, carrega antes esse.
Porque não posso editar diretamente as dimensões de um ficheiro STEP importado?
Um ficheiro STEP contém apenas o resultado, não o histórico de construção. O cadmark não reconstrói parâmetros de origem e, por isso, não mostra dimensões aparentemente editáveis. Podes acrescentar operações à peça importada (furo, puxar, boleado, chanfro) e criar novos esboços com os seus próprios condutores; esses são paramétricos e cobertos pela verificação de estabilidade.
Com que normas é que o cadmark compara os furos?
Furos de passagem fino, médio e grosso segundo a ISO 273, furos para rosca de passo normal segundo a ISO 2306/DIN 336, rebaixos para parafusos de cabeça cilíndrica ISO 4762 segundo a DIN 974-1 e escareados a 90 graus segundo a ISO 10642/DIN 74, de M1,6 a M30. A tolerância é de 0,005 mm, para que peças em polegadas não sejam lidas como métricas. Uma correspondência é uma leitura, não uma prova de intenção, e é designada exatamente assim.
Tenho de esperar por um lugar livre?
Não. Cada conta recebe a sua própria sessão CAD na primeira utilização, sem fila de espera. Após 20 minutos sem pedidos é terminada e arranca de novo na tua próxima visita. Os teus projetos ficam guardados.
O cadmark funciona sem IA?
Sim. Carregamento, reconhecimento, identificadores, medição, cotas de inspeção, esboços, operações, parâmetros, pré-visualizações, anulação e exportação funcionam todos sem o assistente. O assistente é um operador adicional que usa as mesmas ferramentas.
Falta alguma pergunta? Escreve para kontakt@beyware.com. Preço e período de teste: página do produto cadmark.