1. Antes de empezar
Kraken Draw transforma un diagrama de clases UML en un proyecto de software funcional. Cuanto más claro sea tu modelo, mejor será el resultado. Esta guía resume las reglas que aplica el generador.
- Crea un proyecto y abre su editor UML.
- Arrastra las clases desde la caja de herramientas al lienzo.
- Agrega atributos con la sintaxis
nombre: tipo. - Conecta las clases con el tipo de relación correcto.
- Configura el stack y genera el proyecto.
2. Clases
Arrastra una clase desde la caja de herramientas al lienzo y define su nombre. Cada clase se convierte en una entidad del proyecto generado.
Reglas de nombres de clase
- Empiezan con mayúscula (por ejemplo,
Usuario,FacturaDetalle). - No se aceptan nombres de clases repetidos: cada clase debe tener un nombre único.
- Usa solo letras, números y guion bajo; no empieces con números.
Anatomía de una clase
Encabezado, atributos y el botón para agregar. Los puntos de conexión aparecen al pasar el cursor sobre la clase.
3. Atributos
Agrega atributos dentro de la clase con la sintaxis nombre: tipo. Por ejemplo:
nombre: string
fechaNacimiento: date
salario: decimal
activo: boolean
Reglas de atributos
- Puedes usar camelCase o snake_case: el sistema acepta ambos. Elige el que prefieras (
fechaNacimientoofecha_nacimiento); lo importante es ser consistente y no repetir nombres. - No se aceptan atributos repetidos dentro de la misma clase.
- Opcionalmente puedes usar los modificadores de acceso
+,-y#. - Un atributo sin tipo o con un tipo no soportado se ignora y no aparece en el proyecto generado.
Agregar y eliminar un atributo
Se agrega con «+ Agregar atributo». Para eliminarlo, vacía el texto del atributo y pulsa Backspace.
4. Tipos de datos soportados
Los tipos se escriben en minúsculas después de los dos puntos. Estos son los tipos aceptados por el generador:
Enteros
numberintegerintsmallintmediumintbigintlongshortbyteDecimales
decimalnumericfloatdoublerealmoneyCadenas
stringstrcharvarcharnvarcharnchartextuuidguidFechas y horas
datedatetimedatetime2datetimeoffsettimestamptimestamptztimestampzlocaldatelocaldatetimetimetimetzintervaltimespanBooleanos
booleanboolbitJSON
jsonjsonbBinarios
byteablobbinaryvarbinaryArreglos
Las formas de arreglo se reconocen con el sufijo [] (por ejemplo, etiquetas: string[]) o con el prefijo array<...>.
5. Campos que agrega el sistema
No necesitas declarar estos campos; Kraken Draw los agrega de forma automática:
id: si no existe, se crea uno de tipolongcomo clave primaria.created_at,updated_atydeleted_at: se agregan como tipodatetimepara la auditoría de registros.
Campos reservados
Si defines un atributo con estos nombres, el sistema ajusta su tipo automáticamente. Evita usarlos para otros fines.
6. Relaciones
Selecciona el tipo de relación en la caja de herramientas y conecta las clases. Esta es la lista de relaciones soportadas:
Asociación · uno a muchos
Asociación
Línea simple entre dos clases. Representa una referencia entre entidades.
La clave foránea se coloca automáticamente en el lado «muchos» de la relación.
Herencia
Herencia
Flecha con triángulo hueco. La clase hija hereda de la clase padre.
El generador aplica la herencia según el lenguaje y el ORM configurados.
Composición
Composición
Línea con rombo relleno. Relación todo-parte fuerte: la parte no existe sin el todo.
Se modela como una asociación con dependencia fuerte y clave foránea en la parte.
Agregación
Agregación
Línea con rombo vacío. Relación todo-parte débil: las partes pueden existir por separado.
Se modela como una asociación con clave foránea en la parte, sin dependencia de ciclo de vida.
Recursiva (hub de 2 aristas)
Recursiva
Una clase se relaciona consigo misma. Se dibuja mediante un nodo hub con dos aristas.
Una referencia a la propia entidad (por ejemplo, un empleado que tiene un jefe).
7. Reglas de modelado
No escribas las claves foráneas a mano
La clave foránea la deduce el sistema a partir de la relación. En una relación de uno a muchos entre Usuario y Producto, el campo usuario_id se agregará automáticamente a Producto. No lo declares como atributo.
Relaciones inválidas
- Las relaciones o campos que no cumplen las reglas se ignoran y no se incluyen en la generación.
- En una asociación, ambos lados no pueden ser «muchos» a la vez (usa una relación de muchos a muchos).
- Las cardinalidades como
0..0no son válidas. - Las clases sin conexiones válidas se generan igualmente como entidades independientes.
8. Nodos hub (muchos a muchos y recursivas)
Las relaciones de muchos a muchos y las recursivas se dibujan con un nodo hub: un nodo pequeño que concentra las conexiones.
- Recursiva: el hub tiene 2 conexiones (cabeza y cola) hacia la misma clase.
- Muchos a muchos: el hub tiene 3 conexiones (M, N y una línea discontinua hacia el nodo intermedio).
- Un hub no puede tener más de 3 conexiones.
Si borras una conexión
La relación deja de considerarse. Un hub de muchos a muchos con menos de 3 aristas, o uno recursivo con menos de 2, se descarta junto con sus conexiones.
Muchos a muchos (hub de 3 aristas)
Muchos a muchos
Hub con tres conexiones: las dos clases y la línea discontinua hacia el nodo intermedio.
Muchos a muchos recursiva
Muchos a muchos recursiva
Ambos extremos apuntan a la misma clase; la intermedia tiene dos claves foráneas hacia ella.
9. La tabla intermedia
Por defecto, una relación de muchos a muchos genera una tabla de unión (intermedia) con las claves foráneas de ambas clases.
Esa intermedia puede convertirse en una clase independiente:
- Si le agregas atributos propios, o
- si la relacionas con otra clase,
entonces recibe su propio id y la relación de muchos a muchos pasa a ser dos relaciones de uno a muchos.
La intermedia se vuelve clase independiente
Al agregarle atributos propios (o relaciones), la intermedia recibe su propio id y el muchos a muchos se convierte en dos relaciones de uno a muchos.
Ejemplo: Usuario y Mascota
Si modelas Usuario y Mascota como muchos a muchos y agregas un atributo fecha a la intermedia, el sistema crea la entidad UsuarioMascota con su id y las claves foráneas usuario_id y mascota_id. La relación deja de ser muchos a muchos y se convierte en dos relaciones de uno a muchos.
10. Generar el proyecto
- Guarda el diagrama para conservar los cambios.
- Configura el tipo de artefacto, lenguaje, framework, arquitectura, ORM y base de datos destino.
- Genera el proyecto.
- Descarga el ZIP con el proyecto listo para abrir en tu entorno de desarrollo.
El código generado pasa por las mismas reglas de esta guía: los elementos inválidos se ignoran en lugar de romper la generación.
11. Errores comunes
- Declarar la clave foránea como atributo: el sistema ya la crea.
- Repetir nombres de clases o atributos: solo se conserva la primera definición válida.
- Escribir el tipo con mayúsculas o con espacios: usa minúsculas y la sintaxis exacta.
- Dejar un hub incompleto: revisa que tenga todas sus conexiones.
- Usar una relación de muchos a muchos cuando solo necesitas uno a muchos.
12. Buenas prácticas
- Modela primero las entidades y luego sus relaciones.
- Usa nombres claros y en singular para las clases.
- Agrupa los atributos de auditoría y deja que el sistema los cree.
- Verifica el diagrama antes de generar y guarda tu proyecto.
- Descarga y prueba el código generado antes de publicarlo.