Come si usa Modej

Modej prende il tuo database (Firebird, MySQL, PostgreSQL, Oracle, SQL Server, e altri) insieme — opzionalmente — al codice sorgente che lo usa, e ti restituisce:

• uno schema ER interattivo con tutte le tabelle, colonne, chiavi e relazioni;
• la mappa di quali parti del codice usano quali tabelle (e come: lettura, scrittura, modifica);
• la documentazione automatica generata da intelligenza artificiale;
• report PDF professionali pronti da consegnare a un cliente o un collega.

Modej legge il DDL — lo script SQL che descrive la struttura del database (tabelle, colonne, chiavi, indici, trigger, stored procedure). Non serve mai una connessione diretta al tuo database: basta il file di testo con lo schema.

Access, dBase e Paradox non hanno un DDL testuale esportabile direttamente — sono database basati su file binari. Per questi serve uno script di conversione che gira sul computer dove si trova il file del database, prima di caricarlo su Modej.

Caricare anche il codice sorgente (Delphi, C#, Java, PHP...) permette a Modej di capire quali parti dell'applicazione usano quali tabelle — la base per Analisi AI, Codice↔DB, Mappa Processi e Report Tecnico completi.

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

Ogni tabella diventa una card trascinabile con tutte le sue colonne, chiavi primarie (PK) e chiavi esterne (FK) evidenziate. Le relazioni vengono disegnate automaticamente: linee indaco per le FK reali dichiarate nel database, linee arancioni per le FK manuali che aggiungi tu.

Raggruppa le tabelle in "aree" colorate (es. Magazzino, Vendite, Contabilità) trascinando ogni tabella sulla sua area nella sidebar sinistra. Questi colori si riflettono ovunque: Schema ER, Glossario, Report Tecnico.

• Crea nuove aree con nome e colore personalizzato;
• Filtra per "Assegnate" / "Non assegnate" per completare rapidamente la classificazione;
• Eredita colori da una versione precedente dello stesso database, se stai aggiornando uno schema già classificato.

Molti database legacy non dichiarano tutte le relazioni a livello SQL — la relazione esiste solo "nella testa degli sviluppatori" o nel codice applicativo. Le FK manuali ti permettono di documentarle esplicitamente, e compaiono nello Schema ER come linee arancioni tratteggiate.

Seleziona tabella e colonna di origine, poi tabella e colonna di destinazione, aggiungi una nota opzionale e salva.

Carica uno ZIP del codice sorgente: Modej lo analizza con algoritmi AI e genera report in italiano su 4 fronti diversi, selezionabili all'inizio:

A differenza dell'Analisi AI (che dà una panoramica generale), Deep Analysis esamina ogni singolo file del progetto, individua a quale processo aziendale appartiene (es. "Gestione Ordini", "Anagrafica Clienti") e propone automaticamente una mappa dei processi pronta da applicare.

Al termine, clicca "Applica in Processi" per trasferire la classificazione direttamente nella Mappa Processi, risparmiando il lavoro manuale di trascinamento.

A differenza dell'Analisi AI (che guarda il codice), AnalisiDB è deterministica, non usa l'AI: applica regole fisse a chiavi, foreign key, tipi di dato, naming, indici e livello di normalizzazione dello schema importato.

• Un voto complessivo e un badge OK / Normale / Male per l'intero database;
• ogni problema trovato è raggruppato per tabella, con severità e spiegazione in linguaggio semplice;
• uno script SQL di correzione pronto da copiare, da rivedere e adattare prima di eseguirlo — non va lanciato alla cieca su un database di produzione.

Per ogni unit di codice importata vedi l'elenco delle tabelle che usa, con il tipo di operazione (SELECT, INSERT, UPDATE, DELETE, o "misto" se ne fa più di una) e il nome del metodo esatto. Le statistiche in alto riassumono il quadro generale: relazioni totali, quante SELECT/INSERT/UPDATE/DELETE, tabelle e unit coinvolte.

Con il Plus Estrazione Query puoi esportare tutta questa matrice in CSV, JSON o SQL — utile per documentazione, audit o migrazioni.

Crea processi (es. "Fatturazione") e sotto-processi (es. "Emissione Fattura"), poi trascina le unit di codice non ancora assegnate dalla colonna sinistra dentro il sotto-processo giusto. In alternativa usa "Analizza con AI" per farti proporre automaticamente l'intera struttura partendo dai nomi delle unit.

Ricordati di cliccare Salva dopo ogni modifica — un toast verde conferma il salvataggio riuscito.

Una volta popolata la Mappa Processi, questa pagina genera automaticamente uno schema SVG con la gerarchia completa: processi in alto, sotto-processi sotto di loro, e le unit di codice assegnate a ciascuno in basso.

Utile per una visione d'insieme rapida, o da esportare come immagine per la documentazione.

Vedi tutte le versioni importate per ogni database, con numero tabelle, data import e dimensione. Rinomina un DB con doppio click sul nome, elimina versioni obsolete (se ne esiste più di una), o salta direttamente allo Schema ER o al Confronto di ogni versione.

Seleziona versione base e versione nuova: vedrai tabelle aggiunte (verde), rimosse (rosso) e modificate (arancione) in un pannello dual-view. Clicca su una tabella modificata per vedere esattamente quali colonne sono cambiate, con il dettaglio del tipo prima/dopo.

Simile al Confronto Versioni, ma pensato per la documentazione: genera un changelog in stile "release notes" con timeline visiva, esportabile in .md da inserire direttamente nel repository Git del progetto.

Confronta le tabelle del database con quelle effettivamente referenziate nel codice importato. Le tabelle "inutilizzate" sono probabilmente legacy o obsolete — candidate ideali per una pulizia prima di una migrazione, raggruppate per area con percentuale sul totale.

Lista ordinata dalla tabella più usata alla meno usata, con barre colorate (blu=raro, verde=moderato, arancione=frequente, rosso=critico) e badge per tipo di operazione. Filtra per SELECT/INSERT/UPDATE/DELETE per analisi mirate (es. solo DELETE per un audit di sicurezza).

Per ogni tabella scrivi (o genera con AI) una descrizione in linguaggio business, non tecnico — utile per chi deve capire il database senza essere uno sviluppatore. Il bottone "AI genera tutte" compila in automatico tutte le tabelle ancora senza descrizione. Esportabile in PDF.

Scarica tutte le relazioni unit↔tabella in CSV (per Excel), JSON (per altri tool) o SQL (per query dirette). Perfetto per documentazione tecnica o per alimentare strumenti esterni di analisi.

Un PDF di 20-30 pagine generato interamente nel tuo browser (nessun dato lascia il computer durante la generazione), pronto da consegnare a un cliente o archiviare:

Score da 0 a 100 calcolato su numero di tabelle, FK manuali, colonne medie per tabella e penalità per tabelle orfane oltre il 20%. Vedi anche il trend nel tempo: se hai importato più versioni dello stesso database, un grafico mostra se il sistema sta diventando più o meno complesso versione dopo versione.

Trasforma i dati del progetto in slide fullscreen: copertina, overview con 7 metriche (tabelle, colonne, FK, trigger, stored procedure, view, indici), schema ER interattivo, una slide per ogni processo aziendale con i suoi sotto-processi e unit, heatmap, e slide finale.

Naviga con le frecce ← → della tastiera, esci con ESC. Perfetto per riunioni col cliente o demo dal vivo.

Ogni Plus si acquista separatamente con validità di 12 mesi dall'acquisto. Il catalogo qui sotto è letto in tempo reale dal marketplace, quindi è sempre allineato a quello che trovi davvero nella pagina Plus — nomi, prezzi e descrizioni restano in italiano indipendentemente dalla lingua di questa guida, per ora.

Analisi

Analisi AI

Codice DB

Compliance

Migrazione

Report

Schema DB

Storage

Team

Le funzionalità con badge 🕐 Coming soon sono in arrivo: audit sicurezza avanzato, confronto versioni codice, documentazione automatica, grafo dipendenze e altre — il catalogo si espande regolarmente.

Il bottone ☀/🌙 in alto a destra nel menu principale alterna tra tema scuro e chiaro. La preferenza si salva automaticamente e si applica a tutte le pagine, incluso lo Schema ER che vive in un riquadro separato — non serve impostarlo due volte.

Italiano, inglese, portoghese, spagnolo, tedesco, francese e kinyarwanda. Ogni utente sceglie la propria lingua dal selettore nel menu principale, indipendentemente dagli altri utenti dello stesso account — ognuno vede Modej nella lingua che preferisce.

I contenuti generati dall'AI (glossario, report, descrizioni) vengono creati direttamente nella lingua scelta. Anche questa guida segue la stessa lingua impostata nel menu.

• Password, chiavi API e credenziali nel codice vengono mascherate automaticamente prima di qualsiasi invio all'AI;
• Il codice sorgente non viene conservato sui server dopo l'analisi;
• Gli script di estrazione DDL per database legacy girano localmente sul tuo computer — nessuna credenziale viene mai inviata a Modej;
• Consulta i Termini di Servizio e la Privacy Policy per i dettagli completi.

Il Titolare dell'account può invitare altri utenti e assegnare a ciascuno uno dei tre ruoli interni. I permessi sono verificati anche lato server, non solo nascondendo i bottoni nell'interfaccia.

Da Team il Titolare vede tutti gli utenti, il loro stato (attivo/disattivo) e l'ultimo accesso.

L'abbonamento base (piano Mensile o Annuale) è rimborsabile entro 14 giorni dall'acquisto: basta aprire la richiesta dal proprio profilo, indicare facoltativamente il motivo, e il team Modej la esamina — una volta approvata, il rimborso arriva tramite Stripe entro 5-10 giorni lavorativi sullo stesso metodo di pagamento.

Elimina definitivamente un progetto e tutti i dati collegati — database, codice, processi, FK manuali. Per sicurezza dovrai digitare il nome esatto del progetto per confermare. L'operazione è irreversibile e protetta da transazione: se qualcosa va storto a metà, nulla viene cancellato.