Comment utiliser Modej
Modej transforme les bases de données et le code source hérités en documentation vivante, diagrammes navigables et rapports professionnels. Ce guide vous accompagne du premier import jusqu’aux fonctionnalités les plus avancées.
Bienvenue
Modej prend votre base de données (Firebird, MySQL, PostgreSQL, Oracle, SQL Server, et autres) avec — en option — le code source qui l’utilise, et vous fournit :
- un schéma ER interactif avec toutes les tables, colonnes, clés et relations ;
- la carte de quelles parties du code utilisent quelles tables (et comment : lecture, écriture, modification) ;
- la documentation automatique générée par intelligence artificielle ;
- des rapports PDF professionnels prêts à remettre à un client ou un collègue.
Les 5 premières minutes
Importez votre base de données
Allez dans , choisissez "Nouveau projet", donnez-lui un nom, sélectionnez le type de base de données et chargez le fichier DDL (le schéma SQL de votre base de données).
Explorez le schéma ER
Juste après l’import, cliquez sur "Schéma BD" pour voir toutes vos tables dessinées sous forme de diagramme, avec les relations déjà connectées automatiquement.
Essayez l’analyse IA
Si vous avez aussi chargé le code source, allez dans et laissez l’IA vous expliquer ce que fait votre code.
Générez votre premier rapport
Allez dans et générez un PDF complet en quelques clics — parfait à montrer à un client ou à conserver comme documentation.
Importer une base de donnees
Modej lit le DDL - le script SQL decrivant la structure de la base de donnees (tables, colonnes, cles, index, declencheurs, procedures stockees). Aucune connexion directe a votre base de donnees n'est jamais necessaire : le fichier texte avec le schema suffit.
1 Bases de donnees serveur (Firebird, MySQL, PostgreSQL, SQL Server, Oracle, Sybase, DB2, SQLite)
Pour ces bases de donnees, vous avez deux options :
Si vous avez deja acces a votre BD avec un client (ex. DBeaver, pgAdmin, SQL Developer), exportez le schema au format SQL ("structure seulement", sans donnees) et chargez ce fichier directement sur .
Modej fournit des scripts .bat prets a l'emploi qui extraient automatiquement le DDL
en se connectant a votre base de donnees avec les identifiants que vous saisissez (jamais enregistres, utilises
uniquement pour l'extraction locale) :
| Base de donnees | Script | Outil utilise |
|---|---|---|
| Firebird / InterBase | extract_ddl_firebird.bat | isql -x |
| MySQL / MariaDB | extract_ddl_mysql.bat | mysqldump --no-data |
| PostgreSQL | extract_ddl_postgres.bat | pg_dump --schema-only |
| SQL Server | extract_ddl_mssql.bat | sqlcmd |
| Oracle | extract_ddl_oracle.bat | expdp / sqlplus |
| Sybase / SAP ASE | extract_ddl_sybase.bat | ddlgen |
| IBM DB2 | extract_ddl_db2.bat | db2look -e -a |
| SQLite | extract_ddl_sqlite.bat | sqlite3 .schema |
Double-cliquez sur le bon script, saisissez le serveur/les identifiants lorsque demande,
et vous trouverez le fichier .sql pret a charger dans le meme dossier.
2 Chargement sur Modej
Allez dans Importer BD/Code
Choisissez "Nouveau projet" ou selectionnez un projet existant pour ajouter une nouvelle version.
Selectionnez le type de BD
Choisissez le bon type dans le menu deroulant - Modej normalise automatiquement la syntaxe specifique a chaque base de donnees.
Chargez le fichier .sql
Faites glisser le fichier dans la zone de depot ou selectionnez-le. Modej detecte automatiquement les tables, colonnes, cles primaires, cles etrangeres, declencheurs, procedures stockees, vues et index.
Scripts pour BD historiques (Access, dBase, Paradox)
Access, dBase et Paradox n’ont pas de DDL texte exportable directement — ce sont des bases de données basées sur des fichiers binaires. Pour celles-ci, il faut un script de conversion qui s’exécute sur l’ordinateur où se trouve le fichier de la base de données, avant de le charger sur Modej.
Script : Avvia_Access_Export.bat + Modej_Access_Export.ps1
Prérequis : Microsoft Access ou Access Runtime installé (gratuit, téléchargeable depuis Microsoft si vous n’avez pas Office complet).
- Double-cliquez sur
Avvia_Access_Export.bat - Sélectionnez le fichier
.mdbou.accdblorsque demandé - Le script lit la structure native via ADOX et génère le fichier SQL dans le même dossier
Script : Avvia_DBase_Export.bat + Modej_DBase_Export.ps1
Prérequis : aucun — le parseur est intégré au script.
- Double-cliquez sur
Avvia_DBase_Export.bat - Sélectionnez le dossier contenant les fichiers
.dbf(chaque fichier est une table distincte) - Le script lit l’en-tête binaire de chaque fichier et génère un seul SQL avec toutes les tables
Script : Avvia_Paradox_Export.bat + Modej_Paradox_Export.ps1
Prérequis : aucun pour Paradox 3-5. Pour Paradox 7+, installez "Microsoft Access Database Engine 2010" (gratuit).
- Double-cliquez sur
Avvia_Paradox_Export.bat - Sélectionnez le dossier contenant les fichiers
.db - Le script essaie d’abord via ODBC, puis avec un parseur binaire de secours si nécessaire
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned. Les fichiers .bat
fournis contournent quand même ce blocage dans la plupart des cas.
Importer le code
Charger également le code source (Delphi, C#, Java, PHP...) permet à Modej de comprendre quelles parties de l’application utilisent quelles tables — la base pour l’analyse IA, Code↔BD, la carte des processus et les rapports techniques complets.
1 Comment générer le fichier de correspondance
Le fichier à charger est un .txt généré par un script d’extraction qui
s’exécute chez le client, sur le code source réel. Le format attendu est :
file.pas | NomUnit | NomClasse | SQL_STRING:SELECT * FROM TABLE WHERE...
Chaque ligne représente une relation entre une unité de code et une opération sur la base de données.
2 Chargement
Allez dans Importer BD/Code
Si vous avez déjà un projet, sélectionnez-le ; sinon, créez-en un nouveau.
Chargez le fichier de correspondance .txt
Modej valide automatiquement le fichier : vérifie qu’il s’agit de texte (pas binaire/ZIP), corrige l’encodage si nécessaire, vérifie le format.
Vérifiez le résultat
Vous verrez le nombre d’unités, de méthodes et de relations code↔BD trouvées. De là, vous pouvez aller directement à "Code ↔ BD".
Schéma ER
Chaque table devient une carte déplaçable avec toutes ses colonnes, clés primaires (PK) et clés étrangères (FK) mises en évidence. Les relations sont dessinées automatiquement : lignes indigo pour les FK réelles déclarées dans la base de données, lignes orange pour les FK manuelles que vous ajoutez.
1 Navigation
- Faites glisser les cartes pour réorganiser la disposition — les positions sont enregistrées automatiquement ;
- Double-cliquez sur une table pour ouvrir le panneau "Functional Details" avec colonnes, déclencheurs, procédures stockées, vues et index liés ;
- Utilisez la recherche en haut pour aller directement à une table ;
- Filtre "FK uniquement" pour masquer les tables sans relations et vous concentrer sur la structure principale ;
- Zoom avec les boutons
−/+en bas à droite.
Couleurs et zones
Regroupez les tables en "zones" colorées (ex. Entrepôt, Ventes, Comptabilité) en faisant glisser chaque table sur sa zone dans la barre latérale gauche. Ces couleurs apparaissent partout : schéma ER, glossaire, rapport technique.
- Créez de nouvelles zones avec un nom et une couleur personnalisés ;
- Filtrez par "Attribuées" / "Non attribuées" pour compléter rapidement la classification ;
- Héritez des couleurs d’une version précédente de la même base de données, si vous mettez à jour un schéma déjà classé.
FK manuelles
De nombreuses bases de données historiques ne déclarent pas toutes les relations au niveau SQL — la relation existe seulement "dans la tête des développeurs" ou dans le code applicatif. Les FK manuelles vous permettent de les documenter explicitement, et elles apparaissent dans le schéma ER sous forme de lignes orange en pointillés.
Sélectionnez la table et la colonne source, puis la table et la colonne cible, ajoutez une note facultative et enregistrez.
Analyse IA
Chargez un ZIP du code source : Modej l’analyse avec des algorithmes d’IA et génère des rapports sur 4 fronts différents, sélectionnables au départ :
Vue d’ensemble générale : architecture, patterns utilisés, qualité du code, suggestions générales d’amélioration.
Audit de sécurité professionnel : vulnérabilités OWASP Top 10, injection SQL, classification de gravité pour chaque problème trouvé, avec code corrigé prêt à copier.
Requêtes N+1, boucles inefficaces, opérations bloquantes, index manquants — avec estimation de l’impact et solution optimisée.
Suggestions de refactoring pour moderniser le code hérité en appliquant des patterns plus modernes.
Deep Analysis
Contrairement à l’analyse IA (qui donne une vue d’ensemble générale), Deep Analysis examine chaque fichier individuellement du projet, détermine à quel processus métier il appartient (ex. "Gestion des commandes", "Fiche client") et propose automatiquement une carte des processus prête à appliquer.
À la fin, cliquez sur "Appliquer aux processus" pour transférer la classification directement dans la carte des processus, en évitant le travail manuel de glisser-déposer.
AnalisiDB — Diagnostic approfondi Plus
Contrairement à l’analyse IA (qui examine le code), AnalisiDB est déterministe, elle n’utilise pas l’IA : elle applique des règles fixes aux clés, clés étrangères, types de données, nommage, index et niveau de normalisation du schéma importé.
- Une note globale et un badge OK / Normal / Mauvais pour toute la base de données ;
- chaque problème trouvé est regroupé par table, avec sévérité et explication en langage simple ;
- un script SQL correctif prêt à copier — à relire et adapter avant de l’exécuter, ne pas le lancer aveuglément sur une base de données de production.
Code ↔ BD
Pour chaque unité de code importée, vous voyez la liste des tables qu’elle utilise, avec le type d’opération (SELECT, INSERT, UPDATE, DELETE, ou "mixte" si elle en fait plusieurs) et le nom exact de la méthode. Les statistiques en haut résument la vue d’ensemble : relations totales, nombre de SELECT/INSERT/UPDATE/DELETE, tables et unités concernées.
Avec le Plus Extraction de requêtes, vous pouvez exporter toute cette matrice en CSV, JSON ou SQL — utile pour la documentation, les audits ou les migrations.
Carte des processus
Créez des processus (ex. "Facturation") et des sous-processus (ex. "Émission de facture"), puis faites glisser les unités de code encore non attribuées de la colonne de gauche dans le bon sous-processus. Vous pouvez aussi utiliser "Analyser avec l’IA" pour vous faire proposer automatiquement toute la structure à partir des noms des unités.
N’oubliez pas de cliquer sur Enregistrer après chaque modification — un toast vert confirme l’enregistrement réussi.
Diagramme de flux
Une fois la carte des processus renseignée, cette page génère automatiquement un schéma SVG avec la hiérarchie complète : processus en haut, sous-processus en dessous, et les unités de code attribuées à chacun en bas.
Utile pour une vue d’ensemble rapide, ou à exporter comme image pour la documentation.
Gestion des BD Plus
Consultez toutes les versions importées de chaque base de données, avec le nombre de tables, la date d’import et la taille. Renommez une BD par double-clic sur le nom, supprimez les versions obsolètes (s’il y en a plus d’une), ou accédez directement au schéma ER ou à la comparaison de chaque version.
Comparaison des versions Plus
Sélectionnez une version de base et une nouvelle version : vous verrez les tables ajoutées (vert), supprimées (rouge) et modifiées (orange) dans un panneau à double vue. Cliquez sur une table modifiée pour voir exactement quelles colonnes ont changé, avec le détail du type avant/après.
Historique / Changelog Plus
Similaire à la comparaison des versions, mais conçu pour la documentation : génère un changelog
façon "notes de version" avec une chronologie visuelle, exportable en .md pour insérer
directement dans le dépôt Git du projet.
Tables inutilisées Plus
Compare les tables de la base de données à celles réellement référencées dans le code importé. Les tables "inutilisées" sont probablement historiques ou obsolètes — des candidates idéales pour un nettoyage avant une migration, regroupées par zone avec un pourcentage du total.
Heatmap d’utilisation Plus
Liste classée de la table la plus utilisée à la moins utilisée, avec des barres colorées (bleu=rare, vert=modéré, orange=fréquent, rouge=critique) et des badges par type d’opération. Filtrez par SELECT/INSERT/UPDATE/DELETE pour des analyses ciblées (ex. DELETE uniquement pour un audit de sécurité).
Glossaire des données Plus
Pour chaque table, rédigez (ou générez avec l’IA) une description en langage métier, non technique — utile pour toute personne devant comprendre la base de données sans être développeur. Le bouton "L’IA génère tout" remplit automatiquement toutes les tables encore sans description. Exportable en PDF.
Extraction de requêtes Plus
Téléchargez toutes les relations unité↔table en CSV (pour Excel), JSON (pour d’autres outils) ou SQL (pour des requêtes directes). Parfait pour la documentation technique ou pour alimenter des outils d’analyse externes.
Rapport technique complet Plus
Un PDF de 20 à 30 pages généré entièrement dans votre navigateur (aucune donnée ne quitte l’ordinateur pendant la génération), prêt à remettre à un client ou à archiver :
| Section | Contenu |
|---|---|
| Couverture | Logo, nom du projet/de la base de données, infos clés |
| Résumé exécutif | Score de complexité, 6 KPI, alertes automatiques |
| Schéma ER | Tables par zone, indicateur de tables orphelines |
| Glossaire des données | Descriptions métier par zone |
| Analyse Code→BD | Top 20 heatmap, liste des orphelines |
| Carte des processus | Hiérarchie processus → sous-processus → unité |
| FK manuelles | Tableau complet des relations |
| Annexe technique | Chaque table avec toutes ses colonnes et types |
Indice de complexité Plus
Score de 0 à 100 calculé à partir du nombre de tables, des FK manuelles, des colonnes moyennes par table et d’une pénalité pour les tables orphelines au-delà de 20 %. Vous voyez aussi la tendance dans le temps : si vous avez importé plusieurs versions de la même base de données, un graphique montre si le système devient plus ou moins complexe version après version.
Mode présentation Plus
Transforme les données du projet en diapositives plein écran : couverture, aperçu avec 7 indicateurs (tables, colonnes, FK, déclencheurs, procédures stockées, vues, index), schéma ER interactif, une diapositive par processus métier avec ses sous-processus et unités, heatmap, et diapositive finale.
Naviguez avec les flèches ← → du clavier, quittez avec ÉCHAP. Parfait pour les réunions clients ou les démos en direct.
Marketplace Plus
Chaque Plus s’achète séparément et est valable 12 mois à compter de l’achat. Le catalogue ci-dessous est lu en temps réel depuis la marketplace, il est donc toujours aligné avec ce que vous trouvez réellement sur la page — noms, prix et descriptions restent en italien quelle que soit la langue de ce guide, pour l’instant.
Analisi
Analisi AI
Codice DB
Compliance
Migrazione
Report
Schema DB
Storage
Team
Les fonctionnalités avec le badge 🕐 Coming soon arrivent bientôt : audit de sécurité avancé, comparaison de versions de code, documentation automatique, graphe de dépendances et plus encore — le catalogue s’étoffe régulièrement.
Thème clair/sombre
Le bouton ☀/🌙 en haut à droite du menu principal bascule entre thème sombre et clair. La préférence est enregistrée automatiquement et s’applique à toutes les pages, y compris le schéma ER qui vit dans un panneau séparé — pas besoin de la régler deux fois.
Langue de l’interface
Italien, anglais, portugais, espagnol, allemand, français et kinyarwanda. Chaque utilisateur choisit sa propre langue dans le sélecteur du menu principal, indépendamment des autres utilisateurs du même compte — chacun voit Modej dans la langue qu’il préfère.
Le contenu généré par l’IA (glossaire, rapports, descriptions) est créé directement dans la langue choisie. Ce guide suit également la même langue définie dans le menu.
Confidentialité et sécurité
- Mots de passe, clés API et identifiants dans le code sont masqués automatiquement avant tout envoi à l’IA ;
- Le code source n’est pas conservé sur les serveurs après l’analyse ;
- Les scripts d’extraction DDL pour les bases de données historiques s’exécutent localement sur votre ordinateur — aucun identifiant n’est jamais envoyé à Modej ;
- Consultez les Conditions d’utilisation et la Politique de confidentialité pour tous les détails.
Rôles de l’équipe
Le Titulaire du compte peut inviter d’autres utilisateurs et attribuer à chacun l’un des trois rôles internes. Les permissions sont également vérifiées côté serveur, pas seulement en masquant les boutons dans l’interface.
| Rôle | Peut faire |
|---|---|
| Titulaire | Tout, y compris inviter/retirer des utilisateurs et acheter des Plus |
| Éditeur | Importe, crée et modifie des données — ne peut pas supprimer de projets ou bases de données |
| Lecteur | Lecture seule : peut consulter les schémas, rapports et analyses déjà réalisés |
Depuis , le Titulaire voit tous les utilisateurs, leur statut (actif/désactivé) et leur dernier accès.
Demander un remboursement
L’abonnement de base (forfait mensuel ou annuel) est remboursable sous 14 jours après l’achat : il suffit d’ouvrir la demande depuis votre profil, d’indiquer éventuellement le motif, et l’équipe Modej l’examine — une fois approuvée, le remboursement arrive via Stripe sous 5 à 10 jours ouvrés sur le même moyen de paiement.
Supprimer des projets
Supprime définitivement un projet et toutes les données liées — base de données, code, processus, FK manuelles. Par sécurité, vous devrez taper le nom exact du projet pour confirmer. L’opération est irréversible et protégée par transaction : si quelque chose tourne mal en cours de route, rien n’est supprimé.
Questions fréquentes
Contacter le support
Vous n’avez pas trouvé ce que vous cherchiez ? Nous sommes là pour vous aider.
support@modej.eu