Documentación

Guía de uso

Aprende a modelar tus clases, atributos y relaciones en el editor UML para que Kraken Draw genere el proyecto correcto.

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

Usuario
nombre: string
edad: int
activo: boolean
+ Agregar atributo

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 (fechaNacimiento o fecha_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

Usuario
nombre: string
edad: int
fecha: date
+ Agregar 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

numberintegerintsmallintmediumintbigintlongshortbyte

Decimales

decimalnumericfloatdoublerealmoney

Cadenas

stringstrcharvarcharnvarcharnchartextuuidguid

Fechas y horas

datedatetimedatetime2datetimeoffsettimestamptimestamptztimestampzlocaldatelocaldatetimetimetimetzintervaltimespan

Booleanos

booleanboolbit

JSON

jsonjsonb

Binarios

byteablobbinaryvarbinary

Arreglos

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 tipo long como clave primaria.
  • created_at, updated_at y deleted_at: se agregan como tipo datetime para 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

Usuarioid: longnombre: stringProductoid: longprecio: decimal1*tiene

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

Personaid: longnombre: stringEmpleadoid: longsalario: decimalhereda

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

Facturaid: longtotal: decimalDetalleid: longcantidad: intparte de

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

Equipoid: longnombre: stringJugadorid: longposicion: stringtiene

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)

Empleadoid: longnombre: stringjefe: Empleadojefesubordinados

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..0 no 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)

Usuarioid: longnombre: stringMascotaid: longespecie: stringUsuario_Mascotaid: long1..**..1intermedia

Muchos a muchos

Hub con tres conexiones: las dos clases y la línea discontinua hacia el nodo intermedio.

Muchos a muchos recursiva

Usuarioid: longnombre: stringUsuario_Usuarioid: long1..**..1

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

Usuarioid: longnombre: stringUsuarioMascotaid: longfecha: datetimeusuario_id: longmascota_id: longMascotaid: longespecie: string1..*1..*

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

  1. Guarda el diagrama para conservar los cambios.
  2. Configura el tipo de artefacto, lenguaje, framework, arquitectura, ORM y base de datos destino.
  3. Genera el proyecto.
  4. 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.