So verwenden Sie Modej
Modej verwandelt Legacy-Datenbanken und Quellcode in lebendige Dokumentation, navigierbare Diagramme und professionelle Berichte. Dieser Leitfaden begleitet Sie vom ersten Import bis zu den fortgeschrittensten Funktionen.
Willkommen
Modej nimmt Ihre Datenbank (Firebird, MySQL, PostgreSQL, Oracle, SQL Server und andere) zusammen — optional — mit dem Quellcode, der sie verwendet, und liefert Ihnen:
- ein interaktives ER-Schema mit allen Tabellen, Spalten, Schlüsseln und Beziehungen;
- die Zuordnung, welche Codeteile welche Tabellen verwenden (und wie: Lesen, Schreiben, Ändern);
- die automatische Dokumentation, generiert durch künstliche Intelligenz;
- professionelle PDF-Berichte, bereit zur Übergabe an einen Kunden oder Kollegen.
Die ersten 5 Minuten
Importieren Sie Ihre Datenbank
Gehen Sie zu , wählen Sie "Neues Projekt", geben Sie einen Namen ein, wählen Sie den Datenbanktyp und laden Sie die DDL-Datei hoch (das SQL-Schema Ihrer Datenbank).
Erkunden Sie das ER-Schema
Direkt nach dem Import klicken Sie auf "Schema DB", um alle Ihre Tabellen als Diagramm dargestellt zu sehen, mit bereits automatisch verknüpften Beziehungen.
Testen Sie die KI-Analyse
Wenn Sie auch den Quellcode hochgeladen haben, gehen Sie zu und lassen Sie die KI erklären, was Ihr Code tut.
Erstellen Sie Ihren ersten Bericht
Gehen Sie zu und erstellen Sie ein vollständiges PDF in wenigen Klicks — perfekt, um es einem Kunden zu zeigen oder als Dokumentation aufzubewahren.
Eine Datenbank importieren
Modej liest das DDL - das SQL-Skript, das die Datenbankstruktur beschreibt (Tabellen, Spalten, Schluessel, Indizes, Trigger, Stored Procedures). Eine direkte Verbindung zu Ihrer Datenbank ist nie noetig: die Textdatei mit dem Schema genuegt.
1 Serverbasierte Datenbanken (Firebird, MySQL, PostgreSQL, SQL Server, Oracle, Sybase, DB2, SQLite)
Fuer diese Datenbanken haben Sie zwei Moeglichkeiten:
Wenn Sie bereits mit einem Client Zugriff auf Ihre Datenbank haben (z. B. DBeaver, pgAdmin, SQL Developer), exportieren Sie das Schema im SQL-Format ("nur Struktur", ohne Daten) und laden Sie diese Datei direkt bei hoch.
Modej stellt fertige .bat-Skripte bereit, die das DDL automatisch extrahieren,
indem sie sich mit den von Ihnen eingegebenen Zugangsdaten mit Ihrer Datenbank verbinden (nie gespeichert, nur
fuer die lokale Extraktion verwendet):
| Datenbank | Skript | Verwendetes Tool |
|---|---|---|
| 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 |
Doppelklicken Sie auf das passende Skript, geben Sie bei Aufforderung Server/Zugangsdaten ein,
und im selben Ordner finden Sie die hochladebereite .sql-Datei.
2 Hochladen zu Modej
Gehen Sie zu DB/Code importieren
Waehlen Sie "Neues Projekt" oder ein bestehendes Projekt, um eine neue Version hinzuzufuegen.
Waehlen Sie den DB-Typ
Waehlen Sie den richtigen Typ aus dem Dropdown - Modej normalisiert automatisch die spezifische Syntax jeder Datenbank.
Laden Sie die .sql-Datei hoch
Ziehen Sie die Datei in die Dropzone oder waehlen Sie sie aus. Modej erkennt automatisch Tabellen, Spalten, Primaerschluessel, Fremdschluessel, Trigger, Stored Procedures, Views und Indizes.
Skripte für Legacy-Datenbanken (Access, dBase, Paradox)
Access, dBase und Paradox haben kein direkt exportierbares Text-DDL — es sind dateibasierte, binäre Datenbanken. Dafür benötigen Sie ein Konvertierungsskript, das auf dem Computer läuft, auf dem sich die Datenbankdatei befindet, bevor Sie sie zu Modej hochladen.
Skript: Avvia_Access_Export.bat + Modej_Access_Export.ps1
Voraussetzung: Microsoft Access oder Access Runtime installiert (kostenlos, von Microsoft herunterladbar, falls Sie kein vollständiges Office haben).
- Doppelklick auf
Avvia_Access_Export.bat - Wählen Sie die
.mdb- oder.accdb-Datei, wenn Sie dazu aufgefordert werden - Das Skript liest die native Struktur über ADOX und erzeugt die SQL-Datei im selben Ordner
Skript: Avvia_DBase_Export.bat + Modej_DBase_Export.ps1
Voraussetzung: keine — der Parser ist im Skript integriert.
- Doppelklick auf
Avvia_DBase_Export.bat - Wählen Sie den Ordner mit den
.dbf-Dateien (jede Datei ist eine eigene Tabelle) - Das Skript liest den binären Header jeder Datei und erzeugt eine einzige SQL-Datei mit allen Tabellen
Skript: Avvia_Paradox_Export.bat + Modej_Paradox_Export.ps1
Voraussetzung: keine für Paradox 3-5. Für Paradox 7+ installieren Sie "Microsoft Access Database Engine 2010" (kostenlos).
- Doppelklick auf
Avvia_Paradox_Export.bat - Wählen Sie den Ordner mit den
.db-Dateien - Das Skript versucht es zuerst über ODBC, dann bei Bedarf mit einem binären Reserve-Parser
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned ein. Die mitgelieferten
.bat-Dateien umgehen diese Blockade in den meisten Fällen ohnehin.
Quellcode importieren
Wenn Sie auch den Quellcode hochladen (Delphi, C#, Java, PHP...), kann Modej verstehen, welche Teile der Anwendung welche Tabellen verwenden — die Grundlage für KI-Analyse, Code↔DB, Prozesslandkarte und vollständige technische Berichte.
1 So erzeugen Sie die Zuordnungsdatei
Die hochzuladende Datei ist eine .txt-Datei, die von einem Extraktionsskript
beim Kunden anhand des echten Quellcodes erzeugt wird. Das erwartete Format ist:
file.pas | UnitName | KlassenName | SQL_STRING:SELECT * FROM TABELLE WHERE...
Jede Zeile stellt eine Beziehung zwischen einer Code-Unit und einer Datenbankoperation dar.
2 Hochladen
Gehen Sie zu DB/Code importieren
Wenn Sie bereits ein Projekt haben, wählen Sie es aus; andernfalls erstellen Sie ein neues.
Laden Sie die .txt-Zuordnungsdatei hoch
Modej validiert die Datei automatisch: prüft, ob es sich um Text handelt (nicht binär/ZIP), korrigiert bei Bedarf die Kodierung, überprüft das Format.
Ergebnis überprüfen
Sie sehen die Anzahl der gefundenen Units, Methoden und Code↔DB-Beziehungen. Von hier aus können Sie direkt zu "Code ↔ DB" gehen.
ER-Schema
Jede Tabelle wird zu einer verschiebbaren Karte mit allen ihren Spalten, hervorgehobenen Primärschlüsseln (PK) und Fremdschlüsseln (FK). Beziehungen werden automatisch gezeichnet: Indigo-Linien für echte, in der Datenbank deklarierte FKs, orangefarbene Linien für die manuellen FKs, die Sie hinzufügen.
1 Navigation
- Ziehen Sie Karten, um das Layout neu anzuordnen — Positionen werden automatisch gespeichert;
- Doppelklick auf eine Tabelle öffnet das Panel "Functional Details" mit Spalten, Triggern, Stored Procedures, Views und Indizes;
- Nutzen Sie die Suche oben, um direkt zu einer Tabelle zu springen;
- Filter "Nur FK", um Tabellen ohne Beziehungen auszublenden und sich auf die Kernstruktur zu konzentrieren;
- Zoom mit den Schaltflächen
−/+unten rechts.
Farben und Bereiche
Gruppieren Sie Tabellen in farbige "Bereiche" (z. B. Lager, Verkauf, Buchhaltung), indem Sie jede Tabelle in der linken Seitenleiste auf ihren Bereich ziehen. Diese Farben erscheinen überall: ER-Schema, Glossar, Technischer Bericht.
- Erstellen Sie neue Bereiche mit benutzerdefiniertem Namen und Farbe;
- Filtern Sie nach "Zugewiesen" / "Nicht zugewiesen", um die Klassifizierung schnell abzuschließen;
- Übernehmen Sie Farben aus einer früheren Version derselben Datenbank, wenn Sie ein bereits klassifiziertes Schema aktualisieren.
Manuelle FKs
Viele Legacy-Datenbanken deklarieren nicht alle Beziehungen auf SQL-Ebene — die Beziehung existiert nur "in den Köpfen der Entwickler" oder im Anwendungscode. Manuelle FKs ermöglichen es Ihnen, sie explizit zu dokumentieren; sie erscheinen im ER-Schema als gestrichelte orange Linien.
Wählen Sie Quelltabelle und -spalte, dann Zieltabelle und -spalte, fügen Sie optional eine Notiz hinzu und speichern Sie.
KI-Analyse
Laden Sie ein ZIP des Quellcodes hoch: Modej analysiert es mit KI-Algorithmen und erstellt Berichte zu 4 verschiedenen Themen, die zu Beginn ausgewählt werden können:
Allgemeiner Überblick: Architektur, verwendete Patterns, Codequalität, allgemeine Verbesserungsvorschläge.
Professionelles Sicherheitsaudit: OWASP-Top-10-Schwachstellen, SQL-Injection, Schweregradeinstufung für jedes gefundene Problem, mit korrigiertem, kopierbereitem Code.
N+1-Abfragen, ineffiziente Schleifen, blockierende Operationen, fehlende Indizes — mit Auswirkungsabschätzung und optimierter Lösung.
Refactoring-Vorschläge zur Modernisierung von Legacy-Code durch Anwendung moderner Patterns.
Deep Analysis
Im Gegensatz zur KI-Analyse (die einen allgemeinen Überblick gibt) untersucht Deep Analysis jede einzelne Datei des Projekts, ermittelt, zu welchem Geschäftsprozess sie gehört (z. B. "Auftragsverwaltung", "Kundenstammdaten") und schlägt automatisch eine anwendungsbereite Prozesslandkarte vor.
Klicken Sie am Ende auf "Auf Prozesse anwenden", um die Klassifizierung direkt in die Prozesslandkarte zu übertragen und sich die manuelle Zuordnung per Drag-and-drop zu sparen.
AnalisiDB — Tiefendiagnose Plus
Im Gegensatz zur KI-Analyse (die sich den Code ansieht) ist AnalisiDB deterministisch — sie verwendet keine KI: Sie wendet feste Regeln auf Schlüssel, Fremdschlüssel, Datentypen, Benennung, Indizes und den Normalisierungsgrad des importierten Schemas an.
- Eine Gesamtnote und ein OK-/Normal-/Schlecht-Abzeichen für die gesamte Datenbank;
- jedes gefundene Problem wird nach Tabelle gruppiert, mit Schweregrad und Erklärung in einfacher Sprache;
- ein korrigierendes SQL-Skript, bereit zum Kopieren — prüfen und anpassen Sie es vor der Ausführung, führen Sie es nicht blind an einer Produktionsdatenbank aus.
Code ↔ DB
Für jede importierte Code-Unit sehen Sie die Liste der verwendeten Tabellen, mit dem Operationstyp (SELECT, INSERT, UPDATE, DELETE oder "gemischt", wenn mehrere vorkommen) und dem genauen Methodennamen. Die Statistiken oben fassen das Gesamtbild zusammen: Gesamtbeziehungen, Anzahl SELECT/INSERT/UPDATE/DELETE, beteiligte Tabellen und Units.
Mit dem Plus Query-Extraktion können Sie diese gesamte Matrix nach CSV, JSON oder SQL exportieren — nützlich für Dokumentation, Audits oder Migrationen.
Prozesslandkarte
Erstellen Sie Prozesse (z. B. "Rechnungsstellung") und Teilprozesse (z. B. "Rechnung ausstellen"), und ziehen Sie dann die noch nicht zugeordneten Code-Units aus der linken Spalte in den richtigen Teilprozess. Alternativ nutzen Sie "Mit KI analysieren", um sich die gesamte Struktur automatisch anhand der Unit-Namen vorschlagen zu lassen.
Denken Sie daran, nach jeder Änderung auf Speichern zu klicken — eine grüne Toast-Meldung bestätigt die erfolgreiche Speicherung.
Flussdiagramm
Sobald die Prozesslandkarte befüllt ist, erzeugt diese Seite automatisch ein SVG-Diagramm mit der vollständigen Hierarchie: Prozesse oben, darunter die Teilprozesse, und die zugeordneten Code-Units für jeden davon unten.
Nützlich für einen schnellen Überblick oder zum Export als Bild für die Dokumentation.
DB-Verwaltung Plus
Sehen Sie alle importierten Versionen jeder Datenbank mit Tabellenanzahl, Importdatum und Größe. Benennen Sie eine Datenbank per Doppelklick auf den Namen um, löschen Sie veraltete Versionen (falls mehrere existieren), oder springen Sie direkt zum ER-Schema oder Vergleich jeder Version.
Versionsvergleich Plus
Wählen Sie eine Basisversion und eine neue Version: Sie sehen hinzugefügte (grün), entfernte (rot) und geänderte (orange) Tabellen in einem Dual-View-Panel. Klicken Sie auf eine geänderte Tabelle, um genau zu sehen, welche Spalten sich geändert haben, mit Vorher-/Nachher-Typdetails.
Verlauf / Changelog Plus
Ähnlich dem Versionsvergleich, aber für die Dokumentation konzipiert: erstellt ein Changelog
im "Release-Notes"-Stil mit visueller Zeitleiste, exportierbar nach .md zum direkten
Einfügen in das Git-Repository des Projekts.
Ungenutzte Tabellen Plus
Vergleicht die Datenbanktabellen mit den tatsächlich im importierten Code referenzierten Tabellen. "Ungenutzte" Tabellen sind wahrscheinlich veraltet — ideale Kandidaten für eine Bereinigung vor einer Migration, gruppiert nach Bereich mit Prozentanteil an der Gesamtzahl.
Nutzungs-Heatmap Plus
Liste sortiert von der am häufigsten bis am seltensten verwendeten Tabelle, mit farbigen Balken (blau=selten, grün=mäßig, orange=häufig, rot=kritisch) und Abzeichen nach Operationstyp. Filtern Sie nach SELECT/INSERT/UPDATE/DELETE für gezielte Analysen (z. B. nur DELETE für ein Sicherheitsaudit).
Datenglossar Plus
Schreiben Sie für jede Tabelle (oder lassen Sie per KI generieren) eine Beschreibung in Geschäftssprache, nicht technisch — nützlich für alle, die die Datenbank verstehen müssen, ohne Entwickler zu sein. Die Schaltfläche "KI generiert alle" füllt automatisch alle Tabellen aus, denen noch eine Beschreibung fehlt. Exportierbar als PDF.
Query-Extraktion Plus
Laden Sie alle Unit↔Tabellen-Beziehungen als CSV (für Excel), JSON (für andere Tools) oder SQL (für direkte Abfragen) herunter. Perfekt für technische Dokumentation oder zur Speisung externer Analysetools.
Vollständiger technischer Bericht Plus
Ein 20-30-seitiges PDF, das vollständig in Ihrem Browser erzeugt wird (während der Erstellung verlassen keine Daten den Computer), bereit zur Übergabe an einen Kunden oder zur Archivierung:
| Abschnitt | Inhalt |
|---|---|
| Titelseite | Logo, Projekt-/Datenbankname, Kerninformationen |
| Executive Summary | Komplexitätswert, 6 KPIs, automatische Warnungen |
| ER-Schema | Tabellen nach Bereich, Indikator für verwaiste Tabellen |
| Datenglossar | Geschäftsbeschreibungen nach Bereich |
| Code→DB-Analyse | Top-20-Heatmap, Liste verwaister Tabellen |
| Prozesslandkarte | Hierarchie Prozess → Teilprozess → Unit |
| Manuelle FKs | Vollständige Beziehungstabelle |
| Technischer Anhang | Jede Tabelle mit allen Spalten und Typen |
Komplexitätsindex Plus
Wert von 0 bis 100, berechnet aus Tabellenanzahl, manuellen FKs, durchschnittlichen Spalten pro Tabelle und einem Abzug für verwaiste Tabellen über 20 %. Sie sehen auch den Trend im Zeitverlauf: Wenn Sie mehrere Versionen derselben Datenbank importiert haben, zeigt ein Diagramm, ob das System von Version zu Version komplexer oder einfacher wird.
Präsentationsmodus Plus
Verwandelt die Projektdaten in Vollbild-Folien: Titelseite, Übersicht mit 7 Kennzahlen (Tabellen, Spalten, FKs, Trigger, Stored Procedures, Views, Indizes), interaktives ER-Schema, eine Folie pro Geschäftsprozess mit seinen Teilprozessen und Units, Heatmap und eine Abschlussfolie.
Navigieren Sie mit den Pfeiltasten ← →, beenden Sie mit ESC. Perfekt für Kundentermine oder Live-Demos.
Plus-Marketplace
Jedes Plus wird separat gekauft und ist 12 Monate ab dem Kauf gültig. Der Katalog unten wird live aus dem Marketplace gelesen und stimmt daher immer mit dem überein, was Sie tatsächlich auf der Seite finden — Namen, Preise und Beschreibungen bleiben vorerst auf Italienisch, unabhängig von der Sprache dieses Leitfadens.
Analisi
Analisi AI
Codice DB
Compliance
Migrazione
Report
Schema DB
Storage
Team
Funktionen mit dem Abzeichen 🕐 Coming soon sind in Vorbereitung: erweitertes Sicherheitsaudit, Code-Versionsvergleich, automatische Dokumentation, Abhängigkeitsgraph und mehr — der Katalog wird regelmäßig erweitert.
Helles/Dunkles Design
Die Schaltfläche ☀/🌙 oben rechts im Hauptmenü wechselt zwischen dunklem und hellem Design. Die Einstellung wird automatisch gespeichert und gilt für alle Seiten, einschließlich des ER-Schemas, das in einem separaten Bereich läuft — keine doppelte Einstellung nötig.
Oberflächensprache
Italienisch, Englisch, Portugiesisch, Spanisch, Deutsch, Französisch und Kinyarwanda. Jeder Benutzer wählt seine eigene Sprache über den Selektor im Hauptmenü, unabhängig von den anderen Benutzern desselben Kontos — jeder sieht Modej in der von ihm bevorzugten Sprache.
KI-generierte Inhalte (Glossar, Berichte, Beschreibungen) werden direkt in der gewählten Sprache erstellt. Auch dieser Leitfaden folgt der im Menü eingestellten Sprache.
Datenschutz und Sicherheit
- Passwörter, API-Schlüssel und Zugangsdaten im Code werden automatisch maskiert, bevor sie an die KI gesendet werden;
- Der Quellcode wird nach der Analyse nicht auf den Servern gespeichert;
- DDL-Extraktionsskripte für Legacy-Datenbanken laufen lokal auf Ihrem Computer — es werden nie Zugangsdaten an Modej gesendet;
- Die vollständigen Details finden Sie in den Nutzungsbedingungen und der Datenschutzerklärung.
Teamrollen
Der Kontoinhaber kann andere Benutzer einladen und jedem eine der drei internen Rollen zuweisen. Die Berechtigungen werden auch serverseitig geprüft, nicht nur durch das Ausblenden von Schaltflächen in der Oberfläche.
| Rolle | Darf |
|---|---|
| Inhaber | Alles, einschließlich Benutzer einladen/entfernen und Plus kaufen |
| Bearbeiter | Importieren, erstellen und bearbeiten von Daten — kann keine Projekte oder Datenbanken löschen |
| Betrachter | Nur lesend: kann bereits erstellte Schemas, Berichte und Analysen durchsehen |
Unter sieht der Inhaber alle Benutzer, deren Status (aktiv/deaktiviert) und letzten Zugriff.
Rückerstattung anfordern
Das Basis-Abonnement (Monats- oder Jahresplan) ist innerhalb von 14 Tagen nach dem Kauf erstattungsfähig: Öffnen Sie einfach die Anfrage über Ihr Profil, geben Sie optional den Grund an, und das Modej-Team prüft sie — nach Genehmigung erfolgt die Rückerstattung über Stripe innerhalb von 5-10 Werktagen auf dieselbe Zahlungsmethode.
Projekte löschen
Löscht ein Projekt und alle verknüpften Daten dauerhaft — Datenbank, Code, Prozesse, manuelle FKs. Zur Sicherheit müssen Sie den genauen Projektnamen eingeben, um zu bestätigen. Der Vorgang ist unwiderruflich und transaktionsgeschützt: Geht auf halbem Weg etwas schief, wird nichts gelöscht.
Häufige Fragen
Support kontaktieren
Nicht gefunden, wonach Sie gesucht haben? Wir sind hier, um zu helfen.
support@modej.eu