Diagramas¶

El módulo Diagramas permite crear diagramas visuales de arquitectura usando un editor DrawIO integrado -- totalmente conectado a su inventario de tarjetas. Arrastre tarjetas al lienzo, conéctelas con relaciones, navegue por jerarquías y recoloréelas según cualquier atributo -- el diagrama permanece sincronizado con sus datos EA.

Galería de diagramas

Galería de diagramas¶

La galería lista cada diagrama con una miniatura, su nombre, su tipo y las tarjetas a las que hace referencia. Desde aquí puede Crear, Abrir, Editar detalles o Eliminar cualquier diagrama.

El editor de diagramas¶

Abrir un diagrama lanza el editor DrawIO a pantalla completa en un iframe del mismo origen. La barra de herramientas nativa de DrawIO está disponible para formas, conectores, texto y diseño -- cada acción propia de Turbo EA está expuesta vía el menú contextual del clic derecho, el botón Sync de la barra de herramientas y el chevrón que aparece encima de cada tarjeta.

Insertar tarjetas¶

Use el diálogo Insertar tarjetas (desde la barra de herramientas o el menú contextual) para añadir tarjetas al lienzo:

Las fichas de tipo con contadores en directo en la columna izquierda filtran los resultados.
Busque por nombre en la columna derecha; cada fila lleva una casilla.
Insertar seleccionadas añade las tarjetas elegidas en una cuadrícula; Insertar todas añade cada tarjeta que coincida con el filtro actual (con confirmación si supera 50 resultados).

El mismo diálogo se abre en modo de selección única para Cambiar tarjeta vinculada y Vincular a tarjeta existente.

Acciones del clic derecho¶

Tarjetas sincronizadas: Abrir tarjeta, Cambiar tarjeta vinculada, Desvincular tarjeta, Quitar del diagrama.
Formas simples / celdas no vinculadas: Vincular a tarjeta existente, Convertir en tarjeta (conserva la geometría y convierte la forma en una tarjeta pendiente con su etiqueta), Convertir en contenedor (transforma la forma en un swimlane para anidar otras tarjetas).

Cada tarjeta sincronizada lleva un pequeño chevrón. Un clic abre un menú con tres secciones, cada una cargada en un único viaje de ida y vuelta:

Mostrar dependencias -- vecinos vía relaciones salientes o entrantes, agrupados por tipo de relación con contadores. Cada fila es una casilla; confirme con Insertar (N).
Drill-Down -- convierte la tarjeta actual en un contenedor swimlane con sus hijos por parent_id anidados. Elija qué hijos incluir o Profundizar en todos.
Roll-Up -- envuelve la tarjeta actual y los hermanos seleccionados (tarjetas que comparten el mismo parent_id) en un nuevo contenedor padre.

Las filas con contador a cero aparecen en gris, y los vecinos / hijos ya presentes en el lienzo se omiten automáticamente.

La jerarquía en el lienzo¶

Los contenedores corresponden al parent_id de una tarjeta:

Arrastrar una tarjeta dentro de un contenedor del mismo tipo abre «¿Añadir «hijo» como hijo de «padre»?». Sí pone en cola un cambio jerárquico; No devuelve la tarjeta a su posición.
Arrastrar una tarjeta fuera de un contenedor solicita la separación (poner parent_id = null).
Arrastres entre tipos vuelven en silencio a su posición -- la jerarquía está restringida a tarjetas del mismo tipo.
Todos los movimientos confirmados aterrizan en el cubo Cambios de jerarquía del panel de Sync con acciones Aplicar y Descartar.

Quitar tarjetas del diagrama¶

Eliminar una tarjeta del lienzo se trata como un gesto puramente visual -- «No quiero verla aquí». La tarjeta permanece en el inventario; sus aristas de relación conectadas desaparecen en silencio con ella. Las flechas dibujadas a mano que no sean relaciones EA registradas nunca se eliminan automáticamente. El archivado es tarea de la página Inventario, no del diagrama.

Borrado de aristas¶

Eliminar una arista que lleva una relación real abre «¿Eliminar la relación entre ORIGEN y DESTINO?»:

Sí pone la eliminación en cola en el panel de Sync; Sincronizar todo emite el DELETE /relations/{id} del backend.
No restaura la arista en su sitio (estilo y extremos preservados).

Perspectivas de vista¶

El desplegable Vista de la barra de herramientas recolorea cada tarjeta del lienzo según un atributo:

Colores de tarjetas (predeterminado) -- cada tarjeta usa el color de su tipo.
Estado de aprobación -- recolorea por aprobada / pendiente / rota.
Valores de campo -- elija cualquier campo de selección única en los tipos de tarjeta presentes en el lienzo (p. ej. Ciclo de vida, Estado). Las celdas sin valor caen a un gris neutro.

Una leyenda flotante en la esquina inferior izquierda del lienzo muestra la asignación activa. La vista elegida se guarda con el diagrama.

Panel de Sync¶

El botón Sync de la barra de herramientas abre el panel lateral con todo lo que está en cola para la próxima sincronización:

Nuevas tarjetas -- formas convertidas en tarjetas pendientes, listas para enviarse al inventario.
Nuevas relaciones -- aristas dibujadas entre tarjetas, listas para crearse en el inventario.
Relaciones eliminadas -- aristas de relación borradas del lienzo, en cola para DELETE /relations/{id}. Mantener en inventario reinserta la arista.
Cambios de jerarquía -- movimientos arrastrar-dentro / arrastrar-fuera de contenedores confirmados, en cola como actualizaciones de parent_id.
Inventario cambiado -- tarjetas actualizadas en el inventario desde la apertura del diagrama, listas para volver al lienzo.

El botón Sync de la barra de herramientas muestra una pastilla pulsante «N sin sincronizar» mientras haya trabajo pendiente. Salir de la pestaña con cambios sin sincronizar dispara un aviso del navegador, y el lienzo se autoguarda en almacenamiento local cada cinco segundos para poder restaurarse tras un refresco accidental.

Vincular diagramas a tarjetas¶

Los diagramas pueden vincularse a cualquier tarjeta desde la pestaña Recursos de la tarjeta (ver Detalle de tarjetas). Cuando un diagrama está vinculado a una tarjeta Iniciativa, también aparece en el módulo EA Delivery junto a los documentos SoAW.