Cómo usar Modej
Modej transforma bases de datos y código fuente heredado en documentación viva, diagramas navegables e informes profesionales. Esta guía te acompaña desde la primera importación hasta las funciones más avanzadas.
Bienvenido
Modej toma tu base de datos (Firebird, MySQL, PostgreSQL, Oracle, SQL Server, y otras) junto — opcionalmente — con el código fuente que la usa, y te devuelve:
- un esquema ER interactivo con todas las tablas, columnas, claves y relaciones;
- el mapa de qué partes del código usan qué tablas (y cómo: lectura, escritura, modificación);
- la documentación automática generada por inteligencia artificial;
- informes PDF profesionales listos para entregar a un cliente o colega.
Primeros 5 minutos
Importa tu base de datos
Ve a , elige "Nuevo proyecto", dale un nombre, selecciona el tipo de base de datos y sube el archivo DDL (el esquema SQL de tu base de datos).
Explora el Esquema ER
Justo después de la importación, haz clic en "Esquema BD" para ver todas tus tablas dibujadas como un diagrama, con las relaciones ya conectadas automáticamente.
Prueba el Análisis de IA
Si también subiste el código fuente, ve a y deja que la inteligencia artificial te explique qué hace tu código.
Genera tu primer informe
Ve a y genera un PDF completo en pocos clics — perfecto para mostrar a un cliente o guardar como documentación.
Importar una Base de Datos
Modej lee el DDL - el script SQL que describe la estructura de la base de datos (tablas, columnas, claves, indices, triggers, stored procedures). Nunca hace falta una conexion directa a tu base de datos: basta el archivo de texto con el esquema.
1 Bases de datos basadas en servidor (Firebird, MySQL, PostgreSQL, SQL Server, Oracle, Sybase, DB2, SQLite)
Para estas bases de datos tienes dos opciones:
Si ya tienes acceso a tu BD con un cliente (ej. DBeaver, pgAdmin, SQL Developer), exporta el esquema en formato SQL ("solo estructura", sin datos) y sube ese archivo directamente a .
Modej ofrece scripts .bat listos que extraen automaticamente el DDL
conectandose a tu base de datos con las credenciales que introduces tu (nunca guardadas, usadas
solo para la extraccion local):
| Base de datos | Script | Herramienta usada |
|---|---|---|
| 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 |
Doble clic en el script adecuado, introduce servidor/credenciales cuando se te pida,
y en la misma carpeta encontraras el archivo .sql listo para subir.
2 Subida a Modej
Ve a Importar BD/Codigo
Elige "Nuevo proyecto" o selecciona un proyecto existente para anadir una nueva version.
Selecciona el tipo de BD
Elige el tipo correcto en el menu desplegable - Modej normaliza automaticamente la sintaxis especifica de cada base de datos.
Sube el archivo .sql
Arrastra el archivo a la zona de carga o seleccionalo. Modej detecta automaticamente tablas, columnas, claves primarias, claves foraneas, triggers, stored procedures, vistas e indices.
Scripts para BD Heredadas (Access, dBase, Paradox)
Access, dBase y Paradox no tienen un DDL de texto exportable directamente — son bases de datos basadas en archivos binarios. Para estas se necesita un script de conversión que se ejecuta en el equipo donde está el archivo de la base de datos, antes de subirlo a Modej.
Script: Avvia_Access_Export.bat + Modej_Access_Export.ps1
Requisito: Microsoft Access o Access Runtime instalado (gratuito, descargable de Microsoft si no tienes Office completo).
- Doble clic en
Avvia_Access_Export.bat - Selecciona el archivo
.mdbo.accdbcuando se te pida - El script lee la estructura nativa vía ADOX y genera el archivo SQL en la misma carpeta
Script: Avvia_DBase_Export.bat + Modej_DBase_Export.ps1
Requisito: ninguno — el parser está integrado en el script.
- Doble clic en
Avvia_DBase_Export.bat - Selecciona la carpeta que contiene los archivos
.dbf(cada archivo es una tabla independiente) - El script lee la cabecera binaria de cada archivo y genera un único SQL con todas las tablas
Script: Avvia_Paradox_Export.bat + Modej_Paradox_Export.ps1
Requisito: ninguno para Paradox 3-5. Para Paradox 7+ instala "Microsoft Access Database Engine 2010" (gratuito).
- Doble clic en
Avvia_Paradox_Export.bat - Selecciona la carpeta con los archivos
.db - El script prueba primero vía ODBC, y luego con un parser binario de reserva si es necesario
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned. Los archivos .bat
proporcionados sortean este bloqueo en la mayoría de los casos de todos modos.
Importar el Código
Subir también el código fuente (Delphi, C#, Java, PHP...) permite a Modej entender qué partes de la aplicación usan qué tablas — la base para el Análisis de IA, Código↔BD, Mapa de Procesos e Informes Técnicos completos.
1 Cómo generar el archivo de mapa
El archivo a subir es un .txt generado por un script de extracción que
se ejecuta en el cliente, sobre el código fuente real. El formato esperado es:
file.pas | NombreUnit | NombreClase | SQL_STRING:SELECT * FROM TABLA WHERE...
Cada línea representa una relación entre una unidad de código y una operación en la base de datos.
2 Carga
Ve a Importar BD/Código
Si ya tienes un proyecto, selecciónalo; si no, crea uno nuevo.
Sube el archivo de mapa .txt
Modej valida automáticamente el archivo: comprueba que sea texto (no binario/ZIP), corrige la codificación si es necesario, verifica el formato.
Comprueba el resultado
Verás el recuento de unidades, métodos y relaciones código↔BD encontradas. Desde aquí puedes ir directamente a "Código ↔ BD".
Esquema ER
Cada tabla se convierte en una tarjeta arrastrable con todas sus columnas, claves primarias (PK) y claves foráneas (FK) resaltadas. Las relaciones se dibujan automáticamente: líneas índigo para las FK reales declaradas en la base de datos, líneas naranjas para las FK manuales que añades tú.
1 Navegación
- Arrastra las tarjetas para reorganizar el diseño — las posiciones se guardan automáticamente;
- Doble clic en una tabla para abrir el panel "Functional Details" con columnas, triggers, stored procedures, vistas e índices relacionados;
- Usa la búsqueda en la parte superior para ir directamente a una tabla;
- Filtro "Solo FK" para ocultar las tablas sin relaciones y centrarte en la estructura principal;
- Zoom con los botones
−/+abajo a la derecha.
Colores y Áreas
Agrupa las tablas en "áreas" de colores (ej. Almacén, Ventas, Contabilidad) arrastrando cada tabla a su área en la barra lateral izquierda. Estos colores se reflejan en todas partes: Esquema ER, Glosario, Informe Técnico.
- Crea nuevas áreas con nombre y color personalizados;
- Filtra por "Asignadas" / "Sin asignar" para completar rápidamente la clasificación;
- Hereda colores de una versión anterior de la misma base de datos, si estás actualizando un esquema ya clasificado.
FK Manuales
Muchas bases de datos heredadas no declaran todas las relaciones a nivel SQL — la relación existe solo "en la cabeza de los desarrolladores" o en el código de la aplicación. Las FK manuales te permiten documentarlas explícitamente, y aparecen en el Esquema ER como líneas naranjas discontinuas.
Selecciona la tabla y columna de origen, luego la tabla y columna de destino, añade una nota opcional y guarda.
Análisis de IA
Sube un ZIP del código fuente: Modej lo analiza con algoritmos de IA y genera informes en 4 frentes diferentes, seleccionables al inicio:
Visión general: arquitectura, patrones utilizados, calidad del código, sugerencias generales de mejora.
Auditoría de seguridad profesional: vulnerabilidades OWASP Top 10, inyección SQL, clasificación de gravedad para cada problema encontrado, con código corregido listo para copiar.
Consultas N+1, bucles ineficientes, operaciones bloqueantes, índices faltantes — con estimación de impacto y solución optimizada.
Sugerencias de refactorización para modernizar código heredado aplicando patrones más modernos.
Deep Analysis
A diferencia del Análisis de IA (que da una visión general), Deep Analysis examina cada archivo individualmente del proyecto, determina a qué proceso de negocio pertenece (ej. "Gestión de Pedidos", "Ficha de Clientes") y propone automáticamente un mapa de procesos listo para aplicar.
Al finalizar, haz clic en "Aplicar en Procesos" para transferir la clasificación directamente al Mapa de Procesos, ahorrando el trabajo manual de arrastrar.
AnalisiDB — Diagnóstico Profundo Plus
A diferencia del Análisis de IA (que mira el código), AnalisiDB es determinista, no usa IA: aplica reglas fijas a claves, claves foráneas, tipos de datos, nomenclatura, índices y nivel de normalización del esquema importado.
- Una calificación general y una insignia OK / Normal / Malo para toda la base de datos;
- cada problema encontrado se agrupa por tabla, con severidad y explicación en lenguaje sencillo;
- un script SQL de corrección listo para copiar — revísalo y adáptalo antes de ejecutarlo, no lo lances a ciegas en una base de datos de producción.
Código ↔ BD
Para cada unidad de código importada ves la lista de tablas que usa, con el tipo de operación (SELECT, INSERT, UPDATE, DELETE, o "mixto" si hace más de una) y el nombre exacto del método. Las estadísticas en la parte superior resumen el panorama general: relaciones totales, cuántos SELECT/INSERT/UPDATE/DELETE, tablas y unidades implicadas.
Con el Plus Extracción de Consultas puedes exportar toda esta matriz a CSV, JSON o SQL — útil para documentación, auditorías o migraciones.
Mapa de Procesos
Crea procesos (ej. "Facturación") y subprocesos (ej. "Emisión de Factura"), luego arrastra las unidades de código aún no asignadas desde la columna izquierda al subproceso correcto. Alternativamente, usa "Analizar con IA" para que te proponga automáticamente toda la estructura a partir de los nombres de las unidades.
Recuerda hacer clic en Guardar después de cada cambio — un aviso verde confirma que se guardó correctamente.
Diagrama de Flujo
Una vez poblado el Mapa de Procesos, esta página genera automáticamente un esquema SVG con la jerarquía completa: procesos arriba, subprocesos debajo de ellos, y las unidades de código asignadas a cada uno abajo.
Útil para una visión general rápida, o para exportar como imagen para la documentación.
Gestión de BD Plus
Ve todas las versiones importadas de cada base de datos, con número de tablas, fecha de importación y tamaño. Renombra una BD con doble clic en el nombre, elimina versiones obsoletas (si hay más de una), o salta directamente al Esquema ER o a la Comparación de cada versión.
Comparación de Versiones Plus
Selecciona la versión base y la nueva versión: verás tablas añadidas (verde), eliminadas (rojo) y modificadas (naranja) en un panel de vista dual. Haz clic en una tabla modificada para ver exactamente qué columnas cambiaron, con el detalle del tipo antes/después.
Historial / Changelog Plus
Similar a la Comparación de Versiones, pero pensado para documentación: genera un changelog
estilo "notas de versión" con línea de tiempo visual, exportable a .md para insertar
directamente en el repositorio Git del proyecto.
Tablas No Utilizadas Plus
Compara las tablas de la base de datos con las realmente referenciadas en el código importado. Las tablas "no utilizadas" son probablemente heredadas u obsoletas — candidatas ideales para una limpieza antes de una migración, agrupadas por área con porcentaje del total.
Heatmap de Uso Plus
Lista ordenada de la tabla más usada a la menos usada, con barras de colores (azul=raro, verde=moderado, naranja=frecuente, rojo=crítico) e insignias por tipo de operación. Filtra por SELECT/INSERT/UPDATE/DELETE para análisis específicos (ej. solo DELETE para una auditoría de seguridad).
Glosario de Datos Plus
Para cada tabla escribe (o genera con IA) una descripción en lenguaje de negocio, no técnico — útil para quien deba entender la base de datos sin ser desarrollador. El botón "IA genera todas" completa automáticamente todas las tablas que aún no tienen descripción. Exportable a PDF.
Extracción de Consultas Plus
Descarga todas las relaciones unidad↔tabla en CSV (para Excel), JSON (para otras herramientas) o SQL (para consultas directas). Perfecto para documentación técnica o para alimentar herramientas externas de análisis.
Informe Técnico Completo Plus
Un PDF de 20-30 páginas generado enteramente en tu navegador (ningún dato sale del equipo durante la generación), listo para entregar a un cliente o archivar:
| Sección | Contenido |
|---|---|
| Portada | Logo, nombre del proyecto/base de datos, información clave |
| Resumen Ejecutivo | Score de complejidad, 6 KPI, alertas automáticas |
| Esquema ER | Tablas por área, indicador de tablas huérfanas |
| Glosario de Datos | Descripciones de negocio por área |
| Análisis Código→BD | Top 20 heatmap, lista de huérfanas |
| Mapa de Procesos | Jerarquía proceso → subproceso → unidad |
| FK Manuales | Tabla completa de relaciones |
| Apéndice Técnico | Cada tabla con todas las columnas y tipos |
Índice de Complejidad Plus
Puntuación de 0 a 100 calculada según el número de tablas, FK manuales, columnas medias por tabla y penalización por tablas huérfanas superiores al 20%. También verás la tendencia en el tiempo: si has importado varias versiones de la misma base de datos, un gráfico muestra si el sistema se vuelve más o menos complejo versión tras versión.
Modo Presentación Plus
Convierte los datos del proyecto en diapositivas a pantalla completa: portada, resumen con 7 métricas (tablas, columnas, FK, triggers, stored procedures, vistas, índices), esquema ER interactivo, una diapositiva por proceso de negocio con sus subprocesos y unidades, heatmap, y diapositiva final.
Navega con las flechas ← → del teclado, sal con ESC. Perfecto para reuniones con clientes o demos en vivo.
Marketplace Plus
Cada Plus se compra por separado y tiene una validez de 12 meses desde la compra. El catálogo de abajo se lee en tiempo real del marketplace, por lo que siempre está alineado con lo que encuentras realmente en la página — nombres, precios y descripciones permanecen en italiano independientemente del idioma de esta guía, por ahora.
Analisi
Analisi AI
Codice DB
Compliance
Migrazione
Report
Schema DB
Storage
Team
Las funciones con la insignia 🕐 Coming soon están en camino: auditoría de seguridad avanzada, comparación de versiones de código, documentación automática, grafo de dependencias y más — el catálogo se amplía regularmente.
Tema Claro/Oscuro
El botón ☀/🌙 arriba a la derecha en el menú principal alterna entre tema oscuro y claro. La preferencia se guarda automáticamente y se aplica a todas las páginas, incluido el Esquema ER que vive en un panel separado — no hace falta configurarlo dos veces.
Idioma de la Interfaz
Italiano, inglés, portugués, español, alemán, francés y kinyarwanda. Cada usuario elige su propio idioma en el selector del menú principal, independientemente de los demás usuarios de la misma cuenta — cada uno ve Modej en el idioma que prefiera.
El contenido generado por la IA (glosario, informes, descripciones) se crea directamente en el idioma elegido. Esta guía también sigue el mismo idioma configurado en el menú.
Privacidad y Seguridad
- Las contraseñas, claves de API y credenciales en el código se enmascaran automáticamente antes de cualquier envío a la IA;
- El código fuente no se conserva en los servidores tras el análisis;
- Los scripts de extracción de DDL para bases de datos heredadas se ejecutan localmente en tu equipo — ninguna credencial se envía nunca a Modej;
- Consulta los Términos de Servicio y la Política de Privacidad para los detalles completos.
Roles del Equipo
El Titular de la cuenta puede invitar a otros usuarios y asignar a cada uno uno de los tres roles internos. Los permisos también se verifican en el servidor, no solo ocultando botones en la interfaz.
| Rol | Puede hacer |
|---|---|
| Titular | Todo, incluido invitar/eliminar usuarios y comprar Plus |
| Editor | Importa, crea y edita datos — no puede eliminar proyectos ni bases de datos |
| Visor | Solo lectura: puede explorar esquemas, informes y análisis ya hechos |
Desde el Titular ve todos los usuarios, su estado (activo/desactivado) y el último acceso.
Solicitar un Reembolso
La suscripción base (plan Mensual o Anual) es reembolsable dentro de 14 días desde la compra: solo tienes que abrir la solicitud desde tu perfil, indicar opcionalmente el motivo, y el equipo de Modej la revisa — una vez aprobada, el reembolso llega vía Stripe en 5-10 días hábiles al mismo método de pago.
Eliminar Proyectos
Elimina permanentemente un proyecto y todos los datos vinculados — base de datos, código, procesos, FK manuales. Por seguridad tendrás que escribir el nombre exacto del proyecto para confirmar. La operación es irreversible y está protegida por transacción: si algo sale mal a mitad de camino, no se elimina nada.
Preguntas Frecuentes
Contactar con Soporte
¿No encontraste lo que buscabas? Estamos aquí para ayudarte.
support@modej.eu