Skip to content

About

brModelo NG: editor de modelos ER, lógicos e SQL para o ensino de banco de dados. Fork mantido do brModelo 3.3.2.

Topics

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Ícone do brModelo NG

brModelo NG

Modelagem de bancos de dados para aprender e ensinar.

O README do projeto original termina com um convite: "Copie, altere, publique."
O brModelo NG nasceu desse convite.

Versão Downloads Build e testes Estrelas Licença GPL-3.0

Linux Windows macOS Java 21

Baixar · Novidades · Ajuda · Compatibilidade · Segurança · Por dentro · Compilar e contribuir · English

O brModelo NG é uma continuação independente do brModelo 3.3.2, a ferramenta livre de Carlos Henrique Cândido para o ensino de modelagem de bancos de dados.

Você pode criar modelos conceituais e lógicos, converter do conceitual para o lógico, gerar SQL, exportar imagens e imprimir diagramas. Também estão disponíveis fluxogramas, diagramas de atividades, estruturas analíticas de projetos (EAP) e diagramas livres.

Preserva o programa e o seu propósito.
Melhora o uso em sistemas modernos.

Janela principal do brModelo NG com o modelo conceitual da Escola Aurora

Baixar o brModelo NG

Os pacotes para Linux, Windows e macOS já trazem o Java.

Além da interface renovada, o NG traz edição mais precisa, com encaixe na grade e o comando Organizar ligações, ajuda completa no F1, que funciona sem internet, impressão fiel ao diagrama e suporte a diagramas grandes.

O formato .brM3 continua sendo o padrão e abre no brModelo oficial, com testes que protegem essa compatibilidade. Opcionalmente, os diagramas também podem ser salvos em JSON (.brMj), fácil de revisar no Git.

O NG é um fork não oficial, mantido por Kristofer Pagnussat, que preserva os créditos e a licença do projeto original. Inclui correções de segurança, concorrência e desempenho, testes automatizados e pacotes para Linux, Windows e macOS. Foi desenvolvido com a assistência de ferramentas de inteligência artificial.

Das issues do brModelo original, o NG resolve as abertas #3, #4, #7, #11, #12, #13, #16, #17, #21, #25, #27, #28, #31 e #33, e atende aos pedidos das já fechadas #5 e #30. Ficam de fora a #8, que pede converter arquivos da versão 2, e a #18, sobre um arquivo específico que não abre.

No dia a dia

O NG parte do brModelo oficial 3.3.2 publicado no sis4.com. Para quem desenha diagramas, o que muda é:

  • Edição mais precisa. As formas encaixam na grade ao mover, criar e redimensionar (ligado por padrão; segure Alt para soltar; as setas movem um passo da grade). Organizar ligações escolhe o lado de cada linha, ordena os pontos para as linhas não se cruzarem e os distribui por igual, tudo desfeito com um único Desfazer.
  • Os controles não cobrem o diagrama. Os ícones de ação da forma selecionada vão para um lado livre, e eles e as chaves das tabelas são vetoriais, nítidos em qualquer zoom e na exportação.
  • Ajuda completa no F1, incluída em todos os pacotes e sem precisar de internet. Veja abaixo.
  • Impressão e exportação fiéis. A prévia de impressão e a exportação de imagens não alteram mais a geometria nem o texto do diagrama, e as barras da impressão não se sobrepõem.
  • Diagramas grandes. Abrir, salvar e desfazer funcionam com milhares de itens interligados, um caso em que o oficial falha com erro de pilha. Rolar e redimensionar continua fluido.
  • Abre em menos de um segundo. A janela aparece em 0,9 s, contra 3,1 s no oficial, na mesma máquina (como foi medido).
  • 18 temas claros e escuros. Por padrão, o NG segue o modo do sistema e alterna sozinho quando o desktop muda. Em Editar → Aparência…, com prévia de cada tema, você escolhe um preferido para cada modo ou fixa um tema. A troca é imediata, sem reiniciar.
  • Telas HiDPI e fontes maiores. Barras, campos e diálogos se ajustam ao conteúdo; o Inspector virou uma grade de propriedades com aparência própria para cada tipo de valor, e as abas ficam numa única linha rolável.
  • Barra de status que não deixa passar erros. Mensagens temporárias somem após cinco segundos, mas o contador de não lidas permanece até você abrir o log; erros têm símbolo próprio, além da cor.
  • Integrado ao sistema. O NG aparece no menu de aplicativos, e os arquivos .brM3 e .brMj ganham o ícone dele e abrem com dois cliques (veja).
  • Seletor de arquivos do sistema. No Linux, pelo XDG Desktop Portal, com os favoritos e locais do ambiente gráfico; no Windows e no macOS, pelo diálogo do próprio sistema, com a lista de tipos de arquivo. O NG lembra a última pasta.
  • Dicas em tudo. Passar o mouse descreve propriedades e ações, e valores cortados aparecem por inteiro.
  • Correções de uso diário. Salvar texto sobre um arquivo existente substitui o conteúdo; a roda do mouse rola na vertical e, com Shift, na horizontal; cores, separadores e textos foram corrigidos para temas escuros e fontes maiores.

Organizar ligações

O mesmo diagrama antes e depois de um clique em Organizar ligações. As formas não se movem; mudam só os pontos de ligação, os atributos acompanham os novos pontos e os ícones de ação passam para o lado livre:

Antes Depois
Entidade Pessoa com ligações cruzadas, todas saindo do mesmo canto A mesma entidade com cada ligação no lado voltado ao seu destino, sem cruzamentos

As duas imagens são geradas pelo teste do próprio algoritmo (OrganizarConexoesGuiTest), que também confere que um único Desfazer restaura o diagrama.

Ajuda completa no F1

A ajuda é um manual do estudante: primeiros passos, modelo conceitual, modelo lógico, geração de SQL, outros diagramas, impressão, atalhos e problemas comuns, com figuras tiradas do próprio programa. Ela vem dentro do jar e de todos os pacotes, abre no navegador pelo F1 e funciona sem internet. Os tópicos são escritos em Markdown em docs/ajuda/ e mantidos junto com o código.

Página Modelo conceitual da ajuda do brModelo NG, com a lista de tópicos à esquerda

Integrado ao sistema

Os pacotes registram o brModelo NG no sistema: ele aparece no menu de aplicativos, e os arquivos ganham o ícone do NG e os tipos Diagrama brModelo (.brM3) e Diagrama JSON brModelo (.brMj), que abrem com dois cliques.

Menu Iniciar e Explorador de Arquivos do Windows 11: o brModelo NG e os arquivos .brM3 e .brMj com o ícone do NG
Windows 11: o aplicativo e os diagramas no menu Iniciar e no Explorador de Arquivos.
Menu de aplicativos do KDE no Kubuntu com o brModelo NG recém-instalado
Kubuntu (KDE): o brModelo NG no menu de aplicativos, logo depois de instalar o .deb.

Temas e editores

Janela principal no tema claro A mesma janela no tema escuro; a folha do diagrama continua branca
Tema claro Tema escuro: a folha do diagrama continua branca

Editor de campos mostrando chave primária e campo único
Editor de campos de uma tabela, no tema escuro.

Barra de status com uma mensagem de erro e contador de uma mensagem não lida
Barra de status com um erro ainda não lido.

As capturas vêm dos exemplos de teste versionados, com dados inventados da Escola/Biblioteca Aurora, e são renderizadas pelo próprio programa (como regenerar).

Compatibilidade com o brModelo oficial

Note

O formato padrão continua sendo .brM3, e esses arquivos abrem no brModelo oficial: dá para trocar diagramas com colegas e professores que usam o oficial. O .brMj (JSON) é opcional e só o NG abre; para compartilhar, salve como .brM3.

Dois testes protegem essa garantia:

  • O teste de compatibilidade carrega o jar oficial 3.3.2 num ambiente de classes isolado e verifica leitura e gravação nos dois sentidos para os seis tipos de diagrama, inclusive depois de passar pelo JSON.
  • O teste da forma serializada compara mais de 200 classes com uma referência e detecta qualquer mudança em classes, identificadores ou campos salvos.

O teste com o oficial precisa do jar oficial, que não acompanha este repositório. A integração contínua não o executa: sem o jar, os seis casos aparecem como ignorados, e ele roda localmente antes de cada versão. Veja como executá-lo em BUILDING.md.

Instalação

Baixe o arquivo do seu sistema na página de Releases:

Sistema Arquivo Como executar
Linux .deb ou .rpm Instale pelo gerenciador de pacotes e abra brModelo NG no menu de aplicativos.
Linux portátil .tar.gz com o aplicativo e Java Extraia e execute brmodelo-ng/bin/brmodelo-ng.
Linux com Flatpak brmodelo-ng.flatpak flatpak install --user ./brmodelo-ng.flatpak
Windows .msi Execute o instalador e abra brModelo NG pelo menu Iniciar.
Windows portátil .zip com o aplicativo e Java Extraia e execute brModelo NG\brModelo NG.exe. Serve para laboratórios onde não se pode instalar programas.
macOS (Apple Silicon) .dmg Abra a imagem, copie brModelo NG para Aplicativos e inicie por essa pasta.
Qualquer sistema com Java 21 brModelo.jar java -jar brModelo.jar

Use Arquivo → Abrir para abrir seus diagramas e Salvar como para escolher o formato. Os detalhes do JSON estão em FORMATO-BRMJ.md.

Flatpak, jar e abertura de arquivos pela linha de comando

O aplicativo ainda não está no Flathub. Com Flatpak e os runtimes necessários disponíveis, instale o bundle baixado da página de Releases:

flatpak install --user ./brmodelo-ng.flatpak
flatpak run io.github.kpagnussat.brModeloNG

Para o jar portátil, instale Java 21 e execute na pasta do download. Você também pode passar um ou mais diagramas como argumentos, inclusive com espaços no nome:

java -jar brModelo.jar
java -jar brModelo.jar "modelo.brM3" "outro modelo.brMj"
Opções de tema

O botão Aparência (sol e lua), no fim da barra principal, abre um menu com Seguir o sistema, Claro, Escuro e Mais temas…. Em Editar → Aparência… estão os 18 temas (7 claros e 11 escuros), com prévia. Ao seguir o sistema, você escolhe um tema preferido para o modo claro e outro para o escuro, e o NG troca sozinho quando o desktop muda de modo. A escolha fica em config.chc.

Na inicialização, a opção da linha de comando tem prioridade sobre a escolha salva. As opções vão antes de -jar:

java -Dbrmodelo.tema=claro -jar brModelo.jar
java -Dbrmodelo.tema=escuro -jar brModelo.jar
java -Dbrmodelo.tema=sistema -jar brModelo.jar
java -Dbrmodelo.tema=nord -jar brModelo.jar

claro e escuro fixam o FlatLaf Light e o FlatLaf Dark; sistema (ou auto) segue o desktop; o identificador de outro tema, como nord ou dracula, fixa esse tema. Uma seleção feita dentro do aplicativo vale imediatamente; a opção de linha de comando volta a ter prioridade na próxima inicialização.

Para usar o visual nativo da plataforma em vez do FlatLaf, informe a classe com -Dswing.systemlaf, por exemplo -Dswing.systemlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel no Linux. Nesse modo, os seletores de tema ficam ocultos.

Limites conhecidos

Important

  • Os pacotes não têm assinatura digital. Na primeira execução, o Windows (SmartScreen) ou o macOS (Gatekeeper) pode avisar que o programa é de origem desconhecida.
  • macOS: o pacote é gerado e testado automaticamente, mas ainda não foi experimentado num Mac de verdade. Não há versão para Macs com processador Intel; nesses, use o brModelo.jar com Java 21.
  • Testado à mão no Linux (Fedora com GNOME e Kubuntu com KDE) e no Windows 11 (instalador e versão portátil).
  • JSON (.brMj): formato próprio do NG, que o oficial não abre. A versão 1 não representa cores com espaço de cor personalizado nem cursores customizados (detalhes).

Relatos de outros sistemas são bem-vindos nas issues e nas discussões.

Segurança

Trocar diagramas em aula

Professores abrem os trabalhos de turmas inteiras; alunos trocam diagramas entre si e recebem modelos do professor. Quando você abre um diagrama recebido, o NG:

  • lê o arquivo num processo separado, que aceita só o que um diagrama do brModelo contém e recusa o resto, em vez de executá-lo; no Linux, esse processo não tem rede nem acesso às suas pastas;
  • não trava nem perde o que está aberto se o arquivo for grande demais, danificado ou feito para isso: a leitura tem prazo e um botão Cancelar;
  • não avisa ninguém pela internet que o arquivo foi aberto, porque não faz nenhuma chamada de rede;
  • gera SQL em que um nome de tabela não esconde comandos;
  • continua salvando .brM3 que abre no brModelo oficial.

Important

Nenhuma proteção substitui o cuidado de quem abre o arquivo. O NG protege só o que ele mesmo abre, e só contra os problemas que conhecemos. Alguns hábitos valem mais do que qualquer camada:

  • Confira se é mesmo um diagrama. Diagramas terminam em .brM3, .brMj ou .xml. trabalho.brM3.exe, .jar, .bat, .cmd, .lnk, .scr, .sh ou um .zip com um programa dentro não são diagramas: abri-los executa um programa, e nenhum editor protege disso. No Windows, ative Extensões de nomes de arquivos no Explorador de Arquivos para ver o nome inteiro.
  • Abra pelo NG, por Arquivo → Abrir ou pelo gerenciador de arquivos. No Linux, prefira o Flatpak; no Windows, o .msi, se quiser que o instalador aplique automaticamente as regras do firewall que bloqueiam a rede do programa.
  • Não abra no brModelo oficial um arquivo que o NG recusou. O oficial não tem nenhuma destas proteções. Peça a quem enviou que salve o diagrama de novo.
  • Receba pelos canais da disciplina, como o ambiente virtual ou o e-mail da instituição, e desconfie de arquivo inesperado, mesmo de um nome conhecido: contas também são invadidas.
  • Leia o SQL gerado de um diagrama recebido antes de executá-lo, num banco de testes, nunca num banco com dados que importam.
  • Salve o que está aberto antes de abrir arquivos de outras pessoas e mantenha o NG e o sistema atualizados.
  • No Linux, prefira a sessão Wayland (veja o aviso no fim desta seção).

Problemas encontrados e o que o NG faz

Em aula, professores abrem dezenas de diagramas enviados por alunos, muitas vezes no mesmo computador em que guardam notas, provas, o e-mail da instituição e senhas salvas no navegador. Um diagrama é um arquivo que o programa interpreta, e o brModelo oficial confia no que lê. Revisões de segurança do código herdado do oficial 3.3.2 encontraram os problemas abaixo. Para cada um, estão o risco e o que o NG faz. O primeiro já estava corrigido no NG 1.0.0; os demais, na 1.0.1.

1. Executar um programa ao abrir um .brM3. O .brM3 é serialização Java, e o oficial o lê com um ObjectInputStream comum, uma falha conhecida como desserialização insegura. Um arquivo preparado pode rodar um programa com as permissões de quem o abre, no instante da abertura e sem nenhum aviso: ler ou apagar provas, notas e trabalhos de outros alunos, copiar as sessões e senhas salvas no navegador, instalar algo que continue rodando depois ou criptografar a pasta pessoal para pedir resgate. O diagrama pode até aparecer normalmente na tela.

  • O NG lê por uma lista de classes permitidas: só os pacotes do brModelo e os tipos de valor do JDK que o modelo usa. O resto é recusado antes de a classe ser carregada ou de qualquer objeto ser construído, e proxies dinâmicos são sempre rejeitados. A regra vale para diagramas, modelos reutilizáveis, recuperação e área de transferência; o JSON (.brMj) segue a mesma lista e ainda valida campos, tipos e referências.
  • Além disso, o .brM3 ou .brMj aberto pelo menu, pelos recentes, pela linha de comando ou pelo gerenciador de arquivos é lido fora da janela, num processo Java separado e sem tela, que devolve o diagrama em JSON, conferido de novo pela janela. No Linux, esse processo roda no bubblewrap, sem rede, pasta pessoal, tela ou barramento da sessão; no Flatpak, num sandbox próprio; no Windows e no macOS, é um processo comum. Se o isolamento não puder iniciar, a leitura roda num processo comum e o motivo fica no log. A recuperação, o desfazer e as partes prontas, gravados pelo próprio programa, e os arquivos XML continuam sendo lidos na janela, com as mesmas regras e limites.

2. Travar o programa ou esgotar a memória. Um .brM3 de 1,6 KB com coleções aninhadas deixava o programa calculando sem fim, e vetores ou imagens que se declaram gigantes, como um PNG de 1×1 pixel que diz ter 20.000×20.000, esgotavam a memória. Em aula, isso congela o programa e faz perder o trabalho ainda não salvo.

  • O processo de leitura tem 768 MB de memória e 30 segundos de prazo: um arquivo assim encerra só esse processo e é recusado. A janela continua respondendo; se a leitura passa de meio segundo, aparece Abrindo diagrama, com Cancelar.
  • Os tamanhos são conferidos antes de ler: diagramas binários, partes e recuperação até 64 MiB; JSON até 128 MiB; XML e texto colado até 16 MiB; vetores e coleções nunca maiores que o próprio arquivo. Imagens até 64 megapixels, conferidas pelo cabeçalho; o mesmo teto vale para exportar, copiar e imprimir o diagrama. As potências nas expressões têm limite antes do cálculo. Acima disso, a operação é recusada e a mensagem fica no log.

3. Ler arquivos do computador e enviá-los pela internet. O XML era lido com entidades externas habilitadas (XXE). Um .xml preparado fazia o programa incluir o conteúdo de um arquivo do computador e mandá-lo a um servidor, só por ser aberto; isso foi reproduzido antes da correção.

  • O NG lê XML sem DTD e sem entidades externas.

4. Avisar a terceiros que o arquivo foi aberto. O Swing interpreta HTML em rótulos e botões. Um texto do diagrama com uma imagem da internet fazia o programa buscá-la ao abrir o diagrama, revelando o endereço IP, a hora e o fato de que o arquivo foi aberto, e abrindo um canal para outros ataques. Num arquivo de teste, foram 9 requisições ao abrir. O oficial também verifica atualizações no site por HTTP, sem criptografia.

  • No NG, os textos do diagrama nunca são interpretados como HTML, o processo recusa endereços http, https e ftp, e o programa não faz nenhuma chamada de rede: o mesmo arquivo de teste faz 0 requisições. O menu Ajuda → Releases do brModelo NG e a ajuda abrem no navegador.

  • Os pacotes acrescentam uma segunda camada, caso algo escape das anteriores:

    Pacote Segunda camada de rede
    Flatpak Sem permissão de rede nem de pastas: cada arquivo chega pelo seletor ou pelo gerenciador de arquivos.
    .deb, .rpm e .tar.gz O lançador inicia o programa no bubblewrap, numa rede só com a interface local. Sem o bubblewrap, ou onde o sistema restringe esse recurso, o programa abre normalmente e registra o motivo no log.
    .msi Regras do Firewall do Windows bloqueiam a saída do programa e do Java incluído; a desinstalação as remove.
    .zip, .dmg e brModelo.jar Nenhuma além da trava do próprio processo.

    No Linux, a rede isolada não fecha o barramento da sessão, que o programa usa para abrir o navegador; a leitura fora da janela não tem nenhum dos dois.

5. Apagar dados ao rodar o SQL gerado. Um nome de tabela ou de diagrama recebido podia levar um comando como DROP TABLE para o script, e quem rodasse o SQL no banco da disciplina o executaria junto.

  • O NG põe entre aspas os nomes que poderiam carregar comandos; nomes comuns saem como antes. ON DELETE, ON UPDATE e o separador aceitam só valores do próprio SQL. Tipos e complementos de campo continuam sendo SQL escrito no diagrama: revise o script de um diagrama recebido antes de executá-lo.

6. Perder o arquivo ao salvar. Sem ataque nenhum, um salvamento interrompido, por exemplo com o disco cheio, deixava o arquivo cortado pela metade.

  • Cada gravação vai para um arquivo temporário na mesma pasta, é sincronizada com o disco e só então substitui o original; se falhar no meio, o anterior fica intacto.

Distribuição. As bibliotecas são conferidas por checksum em todo build e verificadas na base OSV de vulnerabilidades a cada mudança, toda semana e antes de cada versão. Cada release publica SHA256SUMS e um atestado de procedência para cada arquivo, que pode ser conferido com gh attestation verify ARQUIVO -R kpagnussat/brModeloNG.

Warning

O que não está coberto: teclas "digitadas" em outras janelas. As camadas acima impedem que o conteúdo de um arquivo recebido execute código na janela do NG. Se um defeito ainda desconhecido permitisse isso, o código teria o que a janela tem. Fora do Flatpak, são as permissões do usuário, porque a janela precisa abrir e salvar os seus arquivos; nos pacotes, só a rede fica de fora. No Flatpak, a janela não vê as suas pastas nem a rede, mas desenha pelo X11, único caminho de tela do Java 21 no Linux. No X11, um programa com janela pode enviar teclas a outras janelas: o código poderia "digitar" comandos num terminal aberto, como um pendrive Rubber Ducky, e assim sair do sandbox. No Wayland, isso alcança só os programas que também desenham pelo X11. Por isso a leitura dos arquivos recebidos acontece num processo sem tela, e o NG avisa uma vez quando inicia numa sessão X11. A lacuna só fecha numa versão futura, com um Java que desenhe direto no Wayland; o Java 21 não faz isso.

Tip

Para abrir arquivos de outras pessoas, prefira o Flatpak no Linux. No Windows, prefira o .msi se quiser que o instalador aplique automaticamente as regras do firewall, a segunda camada de rede.

Encontrou uma falha de segurança? Avise em particular pelo relato privado de vulnerabilidades do GitHub, não por uma issue pública. Veja SECURITY.md.

Por dentro do código

O NG não é uma reescrita. O brModelo funciona, é usado em aulas e tem anos de diagramas salvos no seu formato; reescrevê-lo trocaria um programa provado por um novo cheio de defeitos inéditos. Por isso o NG evolui o código herdado em passos pequenos, cada um protegido por testes, e não muda o formato .brM3: um arquivo salvo no NG abre no oficial, e vice-versa. O JSON entrou como opção, não como substituto, para quem quer versionar diagramas no Git sem abrir mão da compatibilidade.

  • Segurança. Lista de classes permitidas, leitura fora da janela, limites de entrada, gravação atômica e nenhuma chamada de rede, descritos em Segurança.
  • Build moderno. O build Ant/NetBeans deu lugar ao Gradle com Java 21. As dependências vêm do Maven Central com verificação de checksum, e a integração contínua compila e testa no Linux, no Windows e no macOS.
  • Classes grandes divididas. Editor (2.093 → 1.659 linhas), Diagrama (2.541 → 1.996) e Forma (1.187 → 933) tiveram persistência, pintura, seleção, área de transferência, salvamento automático, configurações e ligações extraídas para classes auxiliares. Os métodos originais continuam existindo e delegam a elas, então subclasses e o formato salvo não mudam.
  • Código morto removido. Cerca de 1.830 linhas de código comentado, imports e variáveis sem uso saíram, sem tocar em campos persistidos nem em membros usados por reflexão.
  • Threads corrigidas. O salvamento automático serializava o diagrama numa thread de timer enquanto você editava; agora captura um snapshot na thread da interface e grava por uma fila única. Cada mensagem de status criava uma thread que nunca terminava (mais de 200 após 100 mensagens); hoje são temporizadores do Swing. A barra de status deixou de ser atualizada fora da thread da interface.
  • Inicialização e pintura mais rápidas. A descoberta de impressoras ficou para o primeiro uso do diálogo de impressão, a tela redesenha só as linhas visíveis da grade e os ícones SVG são renderizados uma vez por escala e tema, em vez de a cada pintura. A janela principal aparece em 0,9 s no NG contra 3,1 s no oficial 3.3.2 (mediana de 7 inicializações a frio, tempo até a janela ficar visível, mesma máquina: Intel Core i7-1360P, Fedora Linux, OpenJDK 21). O método, o script e as medições de pintura estão em BUILDING.md.
  • Diagramas grandes. A serialização Java percorre o diagrama de forma recursiva, e com cerca de 2.000 itens interligados estourava a pilha da thread da interface. Abrir, salvar e cada passo de desfazer agora rodam numa thread com pilha maior, sem mudar o formato do arquivo.
  • Pastas próprias. Configurações, recuperação e modelos reutilizáveis ficam em pastas do NG: XDG no Linux, Application Support no macOS e LocalAppData no Windows, em vez de arquivos soltos na pasta de execução. Arquivos antigos encontrados lá são copiados na primeira utilização, sem apagar os originais.
  • Testes. A suíte automatizada cobre persistência, segurança, interface e utilitários e roda na integração contínua a cada mudança: no Linux, completa, com os testes de interface numa tela virtual; no Windows e no macOS, sem os testes de interface. Os seis casos com o jar oficial rodam localmente (veja acima).

Código-fonte e contribuições

BUILDING.md explica a compilação com JDK 21 e Gradle, os testes, as capturas de tela, as medições e a geração dos pacotes. Para começar:

./gradlew run
./gradlew build

Relate problemas e envie contribuições pelo repositório do brModelo NG (como as contribuições entram); para dúvidas e ideias, use as discussões. Inclua passos para reproduzir o problema, sistema operacional e, quando necessário, um diagrama pequeno com dados inventados.

Ao alterar o código, execute ./gradlew test; para mudanças de interface, confira as capturas de snapDialogs nos temas claro e escuro e com fontes maiores. Mudanças de persistência também exigem testar com o jar oficial usando -PoficialJar="/caminho/para/brModelo.jar". As tarefas snapshotFixtures e snapshotSerializedForm atualizam as referências dos testes somente quando isso é intencional: revise as diferenças e a compatibilidade antes de aceitá-las.

Como este repositório é publicado

O desenvolvimento acontece num repositório local, que funciona como laboratório: lá ficam os commits do dia a dia, os experimentos, as revisões e os testes em máquinas virtuais. Este repositório público recebe um único commit por snapshot funcional: cada commit reúne uma etapa já testada, normalmente uma release. Por isso o histórico aqui é curto, e qualquer commit é uma versão completa e funcional do programa. O que mudou em cada versão está no CHANGELOG.

Contribuições continuam bem-vindas, só seguem outro caminho. Um pull request não é mesclado direto aqui: ele é revisado, levado para o laboratório, testado junto com o resto e publicado no próximo snapshot. Depois disso, o pull request é fechado com um link para o commit que o incorporou, e o autor recebe o crédito no CHANGELOG. Ao contribuir, você concorda em licenciar a sua mudança sob a mesma GPL-3.0-or-later do projeto.

Outras versões do brModelo

O brModelo tem outros ramos, mantidos por outras equipes. O NG não tem relação com eles:

Versão O que é
brModelo 3 O original de Carlos Henrique Cândido, em Java, base do NG.
brModelo Next Versão desktop do Grupo de Banco de Dados da UFSC, com esquema agregado para bancos NoSQL.
brModelo Web Aplicação no navegador, de código aberto (brmodelo-app), com formato próprio.

O NG é para quem quer o programa no computador, sem internet, trabalhando com os mesmos arquivos .brM3 do brModelo 3.

Origem e licença

O brModelo nasceu em 2005 como trabalho de especialização em banco de dados na UFSC e na UNIVAG, sob orientação do Prof. Dr. Ronaldo dos Santos Mello. Seu foco é o ensino técnico e acadêmico da modelagem relacional, com base na metodologia apresentada por Carlos A. Heuser em Projeto de Banco de Dados. O projeto oficial está em chcandido/brModelo e sis4.com.

O brModelo NG preserva os créditos de Carlos Henrique Cândido e dos colaboradores do projeto original. É software livre sob a GNU GPL versão 3 ou posterior: você pode usar, estudar, modificar e redistribuir conforme a licença. As licenças e informações das dependências e dos ícones estão em THIRD-PARTY.md.

English

brModelo NG is an unofficial fork of brModelo, maintained by Kristofer Pagnussat. Carlos Henrique Cândido created the original tool for teaching relational database modeling; its README closes with an invitation, "Copy, change, publish", and this fork answers it. It was developed with assistance from AI tools. It is not related to brModelo Next (UFSC) or brModelo Web; it is for people who want a desktop app that works offline on the same .brM3 files as brModelo 3.

For everyday use it adds snap to grid, an Organize links command that picks each line's side, orders and spreads the connection points in one undo step, selection controls that move to a free side of the shape, a complete offline help opened with F1, faithful print preview and export, support for large interlinked diagrams, a main window that appears in 0.9 s (3.1 s for the official 3.3.2 on the same machine), 18 light and dark themes that can follow the desktop, HiDPI layouts, the desktop file chooser and an optional JSON format.

Received files are treated as untrusted. Java deserialization goes through a class allowlist, closing the insecure-deserialization hole of the official reader; .brM3 and .brMj files are decoded in a separate process with memory and time limits, sandboxed with bubblewrap on Linux and in the Flatpak, while the window stays responsive and offers Cancel. Inputs are size-checked before reading, saves are atomic, and the app makes no network calls, with a second network barrier in the Flatpak, the Linux packages and the Windows installer. The Segurança section above lists each issue found, its risk for a teacher opening students' files and the fix. One gap remains: should an unknown defect let a file run code in the window, under X11 that code could type keystrokes into other windows, such as a terminal, which would also leave the Flatpak sandbox. Received files are therefore read in a process without a display, the app warns once when started in an X11 session, and the gap closes only in a future version built on a Java with native Wayland support. No protection replaces a careful user: check that a received file really is a diagram (.brM3, .brMj or .xml, not work.brM3.exe, .jar, .lnk or a .zip with a program inside), never open a file NG refused in official brModelo, which has none of these protections, and read the SQL generated from a received diagram before running it on a test database. Please report vulnerabilities privately through GitHub (see SECURITY.md). Under the hood, the build moved to Gradle and Java 21, the largest classes were split into helpers, and dead code and thread leaks were removed. .brM3 remains the default and compatible with official brModelo, guarded by serialized-form and isolated official-jar compatibility tests; the latter need the official jar and run locally, not in CI. Official brModelo does not read .brMj JSON files.

Development happens in a local repository that works as a lab; this public repository receives a single commit per working snapshot, each one a tested stage, usually a release. See the CHANGELOG for what changed. Contributions are welcome: a pull request is not merged directly; it is reviewed, brought into the lab, tested and published in the next snapshot, then closed with a link to that commit, and its author is credited in the CHANGELOG. Contributions are accepted under GPL-3.0-or-later.

Download packages from the Releases page, or see BUILDING.md to build, test and run from source. Portable Linux (.tar.gz) and Windows (.zip) builds include Java and need no installation. The app is not on Flathub yet. The portable jar requires Java 21. Licensed under GPL-3.0-or-later; see LICENSE and THIRD-PARTY.md.


Copie, altere, publique.

About

brModelo NG: editor de modelos ER, lógicos e SQL para o ensino de banco de dados. Fork mantido do brModelo 3.3.2.

Topics

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages