Como usar o Modej

O Modej pega no seu banco de dados (Firebird, MySQL, PostgreSQL, Oracle, SQL Server, e outros) junto — opcionalmente — com o código-fonte que o utiliza, e devolve-lhe:

• um esquema ER interativo com todas as tabelas, colunas, chaves e relações;
• o mapa de quais partes do código usam quais tabelas (e como: leitura, escrita, modificação);
• a documentação automática gerada por inteligência artificial;
• relatórios PDF profissionais prontos para entregar a um cliente ou colega.

O Modej le o DDL - o script SQL que descreve a estrutura do banco de dados (tabelas, colunas, chaves, indices, triggers, stored procedures). Nunca e preciso uma ligacao direta ao seu banco de dados: basta o arquivo de texto com o esquema.

Access, dBase e Paradox não têm um DDL de texto exportável diretamente — são bancos de dados baseados em arquivos binários. Para estes é preciso um script de conversão que corre no computador onde está o arquivo do banco de dados, antes de carregá-lo no Modej.

Carregar também o código-fonte (Delphi, C#, Java, PHP...) permite ao Modej perceber quais partes da aplicação usam quais tabelas — a base para Análise de IA, Código↔BD, Mapa de Processos e Relatórios Técnicos completos.

file.pas | NomeUnit | NomeClasse | SQL_STRING:SELECT * FROM TABELA WHERE...

Cada tabela torna-se um cartão arrastável com todas as suas colunas, chaves primárias (PK) e chaves estrangeiras (FK) destacadas. As relações são desenhadas automaticamente: linhas índigo para as FKs reais declaradas no banco de dados, linhas laranja para as FKs manuais que você adiciona.

Agrupe as tabelas em "áreas" coloridas (ex. Armazém, Vendas, Contabilidade) arrastando cada tabela para a sua área na barra lateral esquerda. Estas cores refletem-se em todo o lado: Esquema ER, Glossário, Relatório Técnico.

• Crie novas áreas com nome e cor personalizados;
• Filtre por "Atribuídas" / "Não atribuídas" para completar rapidamente a classificação;
• Herde cores de uma versão anterior do mesmo banco de dados, se estiver a atualizar um esquema já classificado.

Muitos bancos de dados legados não declaram todas as relações ao nível SQL — a relação existe apenas "na cabeça dos programadores" ou no código da aplicação. As FKs manuais permitem-lhe documentá-las explicitamente, e aparecem no Esquema ER como linhas laranja tracejadas.

Selecione a tabela e coluna de origem, depois a tabela e coluna de destino, adicione uma nota opcional e guarde.

Carregue um ZIP do código-fonte: o Modej analisa-o com algoritmos de IA e gera relatórios em 4 frentes diferentes, selecionáveis no início:

Ao contrário da Análise de IA (que dá uma visão geral), o Deep Analysis examina cada ficheiro individualmente do projeto, identifica a que processo de negócio pertence (ex. "Gestão de Pedidos", "Ficha de Clientes") e propõe automaticamente um mapa de processos pronto a aplicar.

No final, clique em "Aplicar em Processos" para transferir a classificação diretamente para o Mapa de Processos, poupando o trabalho manual de arrastar.

Ao contrário da Análise de IA (que olha para o código), o AnalisiDB é determinístico, não usa IA: aplica regras fixas a chaves, chaves estrangeiras, tipos de dados, nomenclatura, índices e nível de normalização do esquema importado.

• Uma nota geral e um selo OK / Normal / Mau para todo o banco de dados;
• cada problema encontrado é agrupado por tabela, com gravidade e explicação em linguagem simples;
• um script SQL de correção pronto a copiar — reveja e adapte antes de o executar, não o lance às cegas num banco de dados de produção.

Para cada unit de código importada vê a lista das tabelas que usa, com o tipo de operação (SELECT, INSERT, UPDATE, DELETE, ou "misto" se fizer mais de uma) e o nome exato do método. As estatísticas no topo resumem o panorama geral: relações totais, quantos SELECT/INSERT/UPDATE/DELETE, tabelas e units envolvidas.

Com o Plus Extração de Consultas pode exportar toda esta matriz em CSV, JSON ou SQL — útil para documentação, auditorias ou migrações.

Crie processos (ex. "Faturação") e subprocessos (ex. "Emissão de Fatura"), depois arraste as units de código ainda não atribuídas da coluna esquerda para o subprocesso certo. Em alternativa, use "Analisar com IA" para que lhe seja proposta automaticamente toda a estrutura a partir dos nomes das units.

Lembre-se de clicar em Salvar após cada alteração — um toast verde confirma que o salvamento teve sucesso.

Uma vez preenchido o Mapa de Processos, esta página gera automaticamente um esquema SVG com a hierarquia completa: processos no topo, subprocessos abaixo deles, e as units de código atribuídas a cada um em baixo.

Útil para uma visão geral rápida, ou para exportar como imagem para a documentação.

Veja todas as versões importadas de cada banco de dados, com número de tabelas, data de importação e tamanho. Renomeie um BD com duplo clique no nome, elimine versões obsoletas (se existir mais de uma), ou salte diretamente para o Esquema ER ou a Comparação de cada versão.

Selecione a versão base e a nova versão: verá tabelas adicionadas (verde), removidas (vermelho) e modificadas (laranja) num painel de visualização dupla. Clique numa tabela modificada para ver exatamente que colunas mudaram, com o detalhe do tipo antes/depois.

Semelhante à Comparação de Versões, mas pensado para documentação: gera um changelog em estilo "release notes" com uma linha do tempo visual, exportável em .md para inserir diretamente no repositório Git do projeto.

Compara as tabelas do banco de dados com as efetivamente referenciadas no código importado. As tabelas "não utilizadas" são provavelmente legadas ou obsoletas — candidatas ideais a uma limpeza antes de uma migração, agrupadas por área com percentagem do total.

Lista ordenada da tabela mais usada à menos usada, com barras coloridas (azul=raro, verde=moderado, laranja=frequente, vermelho=crítico) e selo por tipo de operação. Filtre por SELECT/INSERT/UPDATE/DELETE para análises específicas (ex. só DELETE para uma auditoria de segurança).

Para cada tabela, escreva (ou gere com IA) uma descrição em linguagem de negócio, não técnica — útil para quem precisa entender o banco de dados sem ser programador. O botão "IA gera todas" preenche automaticamente todas as tabelas ainda sem descrição. Exportável em PDF.

Descarregue todas as relações unit↔tabela em CSV (para Excel), JSON (para outras ferramentas) ou SQL (para consultas diretas). Perfeito para documentação técnica ou para alimentar ferramentas externas de análise.

Um PDF de 20-30 páginas gerado inteiramente no seu navegador (nenhum dado sai do computador durante a geração), pronto para entregar a um cliente ou arquivar:

Pontuação de 0 a 100 calculada com base no número de tabelas, FKs manuais, colunas médias por tabela e penalização para tabelas órfãs acima de 20%. Veja também a tendência ao longo do tempo: se importou várias versões do mesmo banco de dados, um gráfico mostra se o sistema está a ficar mais ou menos complexo de versão para versão.

Transforma os dados do projeto em slides de ecrã inteiro: capa, visão geral com 7 métricas (tabelas, colunas, FKs, triggers, stored procedures, views, índices), esquema ER interativo, um slide por processo de negócio com os seus subprocessos e units, heatmap, e slide final.

Navegue com as setas ← → do teclado, saia com ESC. Perfeito para reuniões com o cliente ou demonstrações ao vivo.

Cada Plus é comprado separadamente e tem validade de 12 meses a partir da compra. O catálogo abaixo é lido em tempo real do marketplace, por isso está sempre alinhado com o que encontra realmente na página Plus — nomes, preços e descrições permanecem em italiano independentemente do idioma deste guia, por agora.

Analisi

Analisi AI

Codice DB

Compliance

Migrazione

Report

Schema DB

Storage

Team

As funcionalidades com o selo 🕐 Coming soon estão a caminho: auditoria de segurança avançada, comparação de versões de código, documentação automática, grafo de dependências e mais — o catálogo expande-se regularmente.

O botão ☀/🌙 no canto superior direito do menu principal alterna entre tema escuro e claro. A preferência guarda-se automaticamente e aplica-se a todas as páginas, incluindo o Esquema ER que vive num painel separado — não é preciso configurar duas vezes.

Italiano, inglês, português, espanhol, alemão, francês e kinyarwanda. Cada utilizador escolhe o seu próprio idioma no seletor do menu principal, independentemente dos outros utilizadores da mesma conta — cada um vê o Modej no idioma que preferir.

O conteúdo gerado pela IA (glossário, relatórios, descrições) é criado diretamente no idioma escolhido. Este guia também segue o mesmo idioma definido no menu.

• Senhas, chaves de API e credenciais no código são mascaradas automaticamente antes de qualquer envio à IA;
• O código-fonte não é guardado nos servidores após a análise;
• Os scripts de extração de DDL para bancos de dados legados correm localmente no seu computador — nenhuma credencial é enviada ao Modej;
• Consulte os Termos de Serviço e a Política de Privacidade para detalhes completos.

O Titular da conta pode convidar outros utilizadores e atribuir a cada um uma das três funções internas. As permissões são também verificadas no servidor, não apenas ocultando botões na interface.

Em Equipa o Titular vê todos os utilizadores, o seu estado (ativo/desativado) e o último acesso.

A assinatura base (plano Mensal ou Anual) é reembolsável no prazo de 14 dias após a compra: basta abrir o pedido a partir do seu perfil, indicar opcionalmente o motivo, e a equipa Modej analisa-o — uma vez aprovado, o reembolso chega via Stripe em 5-10 dias úteis ao mesmo método de pagamento.

Elimina permanentemente um projeto e todos os dados associados — banco de dados, código, processos, FKs manuais. Por segurança terá de digitar o nome exato do projeto para confirmar. A operação é irreversível e protegida por transação: se algo correr mal a meio, nada é apagado.