El Chatbot de IA de Visual Paradigm permite crear un Diagrama de Contexto de Sistema C4 a partir de una descripción en lenguaje natural de una aplicación, sus usuarios y los sistemas externos con los que interactúa. Sin embargo, un diagrama generado por IA es más útil cuando permanece editable y mantenible después de su generación.

Esta guía demuestra un flujo de trabajo de extremo a extremo para generar un diagrama de contexto de una Plataforma de Entrega de Comida utilizando C4-PlantUML. Aprenderá cómo pasar de un diagrama generado por IA a código PlantUML editable, refinar el modelo en VPasCode y continuar editándolo visualmente en Visual Paradigm Online. El enfoque combina la velocidad del modelado asistido por IA con la flexibilidad del diagrama como código y la comodidad de un editor de diagramas gráficos.

Visual Paradigm proporciona un flujo de trabajo práctico para convertir una descripción de arquitectura en lenguaje natural en un Diagrama de Contexto C4 editable:

1. Describa el sistema en el Chatbot de IA de Visual Paradigm.

   

2. Genere y revise el Diagrama de Contexto de Sistema C4.

3. Abra el resultado en VPasCode como C4-PlantUML.

   

4. Modifique el diagrama editando el código PlantUML.

   

5. Opcionalmente, envíe el resultado a Visual Paradigm Online.

   

6. Modifique el diagrama visualmente utilizando el editor de diagramas de arrastrar y soltar.

Esto le ofrece dos rutas de edición:

• Edición basada en código: VPasCode y C4-PlantUML

• Edición basada en interfaz gráfica: Editor de Diagramas de Visual Paradigm Online

El Chatbot de IA de Visual Paradigm admite diagramas de Contexto de Sistema, Contenedor, Componente y Despliegue C4. También puede refinar un diagrama generado mediante comandos en lenguaje natural, como agregar, eliminar, renombrar o reconectar elementos.

1. Comprender el Diagrama de Contexto C4

Un Diagrama de Contexto C4 es la vista de nivel más alto de un sistema de software. Muestra:

• Elsistema de interés

• Usuarios humanos y actores organizacionales

• Sistemas de software externos

• Relaciones importantes entre estos elementos

• Una breve descripción de cómo funciona cada relación

Normalmente no muestra servicios internos, bases de datos, clases, APIs o detalles de infraestructura. Estos pertenecen a diagramas C4 de niveles inferiores.

Por ejemplo, un diagrama de contexto para una plataforma de entrega de comida en línea podría contener:

• Cliente

• Gerente del Restaurante

• Repartidor

• Proveedor de Pagos

• Servicio de Mapas y Geolocalización

• Servicio de Notificaciones

• Plataforma de Entrega de Comida

El sistema central debe permanecer como el foco visual. Las personas y sistemas externos deben colocarse a su alrededor.

2. Prepare un buen prompt para IA

La calidad del diagrama generado depende en gran medida de la descripción de la arquitectura proporcionada al chatbot.

Un prompt útil especifica:

• El nombre del sistema

• El propósito del sistema

• Las personas que lo utilizan

• Los sistemas externos con los que se comunica

• Las relaciones entre ellos

• El nivel de diagrama C4 deseado

• El formato de salida deseado

• Lo que no debe incluirse

Ejemplo de prompt

Cree un Diagrama de Contexto de Sistema C4 para una plataforma de entrega de comida en línea.

Sistema de interés:
Plataforma de Entrega de Comida — permite a los clientes navegar por restaurantes, realizar pedidos, efectuar pagos y rastrear entregas.

Personas:
1. Cliente — navega por restaurantes, realiza pedidos, paga y rastrea la entrega.
2. Gerente de Restaurante — gestiona menús, acepta pedidos y actualiza el estado del pedido.
3. Repartidor — acepta trabajos de entrega y actualiza el progreso de la entrega.
4. Administrador de Operaciones — monitorea la actividad de la plataforma y resuelve problemas de soporte.

Sistemas externos:
1. Proveedor de Pagos — autoriza y captura los pagos de los clientes.
2. Servicio de Mapas y Geolocalización — proporciona direcciones, rutas y ubicaciones de entrega.
3. Servicio de Notificaciones — envía correos electrónicos, SMS y notificaciones push.

Relaciones:
- El Cliente utiliza la Plataforma de Entrega de Comida para navegar por restaurantes, realizar pedidos, efectuar pagos y rastrear entregas.
- El Gerente de Restaurante utiliza la Plataforma de Entrega de Comida para gestionar menús y procesar pedidos.
- El Repartidor utiliza la Plataforma de Entrega de Comida para recibir trabajos de entrega y actualizar el estado de la entrega.
- El Administrador de Operaciones utiliza la Plataforma de Entrega de Comida para monitorear operaciones y resolver problemas.
- La Plataforma de Entrega de Comida utiliza el Proveedor de Pagos para autorizar y capturar pagos.
- La Plataforma de Entrega de Comida utiliza el Servicio de Mapas y Geolocalización para calcular rutas y rastrear ubicaciones.
- La Plataforma de Entrega de Comida utiliza el Servicio de Notificaciones para enviar notificaciones.

Genere un Diagrama de Contexto de Sistema C4 limpio. No muestre contenedores internos, componentes, bases de datos, clases ni infraestructura de implementación. Utilice etiquetas de relación concisas.

La instrucción explícita de excluir detalles internos es importante. Sin ella, un generador de IA podría producir un diagrama que mezcle información de nivel de contexto y de nivel de contenedor.

3. Genere el diagrama en el Chatbot de IA de Visual Paradigm

Abra el Chatbot de IA de Visual Paradigm e inicie una nueva conversación o sesión de generación de diagramas.

Dependiendo de la interfaz y la edición de suscripción, el chatbot puede proporcionar un selector de tipo de diagrama. Seleccione:

• Modelo C4

• Diagrama de Contexto de Sistema

Luego ingrese el prompt.

El flujo de trabajo general del chatbot de Visual Paradigm es:

1. Describa el diagrama.

2. Permita que la IA genere el modelo inicial.

3. Revise el resultado.

4. Refínelo con comandos en lenguaje natural.

5. Exporte o continúe editando en otra herramienta de Visual Paradigm.

Revise el primer resultado

Verifique si el diagrama contiene:

• Exactamente un sistema central

• Todas las personas requeridas

• Todos los sistemas externos relevantes

• Direcciones de relación correctas

• Descripciones de relación concisas

• Sin servicios internos ni bases de datos innecesarios

• Nomenclatura consistente

• Diseño legible

Un diagrama generado es un punto de partida, no un sustituto de la revisión de arquitectura.

4. Refine el diagrama mediante conversación

El chatbot puede modificar el diagrama utilizando lenguaje cotidiano.

Añada un elemento

Añada un Agente de Atención al Cliente que utilice la Plataforma de Entrega de Comida para investigar incidencias de los clientes y gestionar devoluciones.

Añada un sistema externo

Añada un Servicio Externo de Detección de Fraude utilizado por la Plataforma de Entrega de Comida para evaluar pagos sospechosos.

Renombrar un elemento

Renombrar "Servicio de Notificación" a "Servicio de Mensajería y Notificación".

Cambiar una relación

Cambie la relación entre el Repartidor y la Plataforma de Entrega de Comida a:
"Recibe asignaciones de entrega y envía actualizaciones del estado de la entrega".

Eliminar un elemento

Elimine al Administrador de Operaciones del diagrama.

Mejore el diseño

Reorganice el diagrama de modo que las personas aparezcan en la parte superior, los sistemas externos en la parte inferior y la Plataforma de Entrega de Comida permanezca centrada.

Simplifique el diagrama

Simplifique esto en un Diagrama de Contexto de Sistema C4 estricto. Elimine detalles de implementación, bases de datos, APIs, microservicios y componentes internos.

Solicite una revisión de consistencia

Revise el diagramo en busca de relaciones faltantes, etiquetas ambiguas, sistemas duplicados y elementos que no pertenecen a un Diagrama de Contexto C4.

La documentación del Chatbot de IA describe este enfoque iterativo, incluidos comandos para agregar pasarelas de pago, renombrar elementos, cambiar relaciones y refactorizar diagramas.

Parte 1: Abrir el diagrama en VPasCode para la edición de código

5. Use “Abrir en VPasCode” o “Editar en VPasCode”

Después de generar y refinar el diagrama, use la acción etiquetada de manera similar a:

• Abrir en VPasCode

• Editar en VPasCode

• Abrir código

• Generar código para edición

La etiqueta exacta del botón puede variar según la interfaz actual.

Esto transfiere el código del diagrama a VPasCode, donde puede editar el diagrama como texto mientras visualiza una vista previa renderizada en vivo. Visual Paradigm describe VPasCode como un editor de diagramas como código basado en navegador que admite PlantUML, modelos C4, Mermaid, Graphviz y otros formatos de sintaxis.

El código generado debe usar C4-PlantUML, típicamente con:

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
...
@enduml

El script generado puede usar una URL de inclusión diferente o una versión de biblioteca compatible internamente. Preserve la inclusión que genera VPasCode a menos que tenga una razón específica para cambiarla.

6. Comprender la estructura de C4-PlantUML

Un diagrama de contexto C4-PlantUML típico contiene estas partes:

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml

LAYOUT_LEFT_RIGHT()

Person(customer, "Cliente", "Realiza pedidos de comida y rastrea entregas.")
System(platform, "Plataforma de entrega de comida", "Permite a los clientes pedir comida y rastrear entregas.")
System_Ext(payment, "Proveedor de pagos", "Autoriza y captura pagos.")

Rel(customer, platform, "Realiza pedidos y rastrea entregas")
Rel(platform, payment, "Autoriza y captura pagos")

@enduml

Tipos principales de elementos

El primer argumento es el identificador interno. El segundo es el nombre de visualización. El tercero es la descripción.

7. Editar el diagrama en VPasCode

VPasCode normalmente muestra:

• El código fuente en un panel de editor

• El diagrama renderizado en un panel de vista previa

• Acciones para exportar, compartir, copiar o abrir el resultado en otro producto de Visual Paradigm

VPasCode proporciona renderizado en vivo y admite la edición directa de código. También puede detectar formatos de diagrama compatibles cuando se pega código en el editor.

Ejemplo: código C4-PlantUML mejorado

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml

title Plataforma de Entrega de Comida — Contexto del Sistema

LAYOUT_LEFT_RIGHT()
SHOW_LEGEND()

Person(customer, "Cliente",
  "Navega por restaurantes, realiza pedidos, paga y rastrea entregas.")

Person(restaurantManager, "Gerente de Restaurante",
  "Gestiona menús, acepta pedidos y actualiza el estado de los pedidos.")

Person(deliveryDriver, "Repartidor",
  "Recibe asignaciones de entrega y actualiza el progreso de la entrega.")

Person(operationsAdmin, "Administrador de Operaciones",
  "Supervisa las operaciones de la plataforma y resuelve problemas de soporte.")

System(platform, "Plataforma de Entrega de Comida",
  "Permite pedidos de comida, pagos, gestión de restaurantes y seguimiento de entregas.")

System_Ext(paymentProvider, "Proveedor de Pagos",
  "Autoriza y captura los pagos de los clientes.")

System_Ext(mapService, "Servicio de Mapas y Geolocalización",
  "Proporciona direcciones, rutas y datos de ubicación.")

System_Ext(notificationService, "Servicio de Notificaciones",
  "Envía correos electrónicos, SMS y notificaciones push.")

Rel(customer, platform,
  "Navega por restaurantes, realiza pedidos, paga y rastrea entregas")

Rel(restaurantManager, platform,
  "Gestiona menús y procesa pedidos de restaurantes")

Rel(deliveryDriver, platform,
  "Recibe trabajos de entrega y envía el estado de la entrega")

Rel(operationsAdmin, platform,
  "Supervisa operaciones y resuelve problemas de soporte")

Rel(platform, paymentProvider,
  "Autoriza y captura pagos")

Rel(platform, mapService,
  "Calcula rutas y rastrea ubicaciones de entrega")

Rel(platform, notificationService,
  "Envía notificaciones de pedidos, pagos y entregas")

@enduml

8. Realizar cambios comunes a nivel de código

Cambiar el nombre del sistema

System(platform, "Plataforma de Entrega de Comidas",
  "Coordina los pedidos de comida y las entregas.")

Agregar una nueva persona

Person(customerSupport, "Agente de Soporte al Cliente",
  "Investiga problemas de los clientes y procesa devoluciones de dinero.")

Rel(customerSupport, platform,
  "Investiga problemas y gestiona devoluciones")

Agregar un nuevo sistema externo

System_Ext(fraudService, "Servicio de Detección de Fraude",
  "Evalúa actividades de pago sospechosas.")

Rel(platform, fraudService,
  "Verifica transacciones de pago en busca de riesgos de fraude")

Cambiar la dirección de la relación

Rel(paymentProvider, platform,
  "Devuelve resultados de autorización y liquidación de pagos")

Utilice la dirección de la relación para representar la dependencia o interacción principal. Si la dirección no es arquitectónicamente importante, elija una convención consistente y aplíquela en todo el diagrama.

Cambiar diseño

C4-PlantUML admite sugerencias de diseño como:

LAYOUT_LEFT_RIGHT()

o:

LAYOUT_TOP_DOWN()

También puede influir en la colocación con sugerencias de dirección:

Lay_R(customer, platform)
Lay_D(platform, paymentProvider)

Use las pistas de diseño con moderación. Demasiadas restricciones manuales pueden hacer que el diagrama sea más difícil de mantener.

9. Utilice la asistencia con IA de VPasCode

Algunas ediciones de VPasCode ofrecen modificación de diagramas asistida por IA y corrección de errores de código. La herramienta puede aceptar instrucciones como:

Añada un servicio externo de detección de fraudes entre la plataforma y el proveedor de pagos.

o:

Corrija el error de sintaxis de PlantUML y conserve la estructura actual del diagrama.

VPasCode también está documentado como compatible con funciones de modificación de diagramas con IA, diagnóstico de errores y traducción, aunque la disponibilidad puede depender de la edición o suscripción.

10. Valide el diagrama PlantUML

Antes de enviar el diagrama a Visual Paradigm Online, valide tanto la sintaxis como la arquitectura.

Lista de verificación de sintaxis

• El script comienza con @startuml.

• El script termina con @enduml.

• La biblioteca C4-PlantUML está incluida.

• Cada relación hace referencia a identificadores existentes.

• Los identificadores no contienen espacios ni puntuación que puedan romper la sintaxis.

• Las comillas están equilibradas.

• Las descripciones no son excesivamente largas.

• La vista previa se renderiza sin errores.

Lista de verificación de modelado C4

• Existe un único sistema de interés claramente identificado.

• Los usuarios se modelan como personas, no como sistemas de software.

• Las aplicaciones externas se modelan como sistemas externos.

• Los contenedores internos no se incluyen en un diagrama de contexto.

• Las relaciones describen interacciones significativas.

• El diagrama es comprensible sin leer el código fuente.

• La terminología coincide con la documentación de arquitectura del proyecto.

Ejemplo de un elemento de diagrama de contexto no deseado

Container(api, "API de pedidos", "Java", "Procesa pedidos")
ContainerDb(database, "Base de datos de pedidos", "PostgreSQL", "Almacena pedidos")

Estos son elementos a nivel de contenedor. Pertenecen a un Diagrama de Contenedores C4, no normalmente a un Diagrama de Contexto del Sistema.

Parte 2: Enviar el diagrama a Visual Paradigm Online

11. Use “Editar en VP Online” o “Editar en VP Online Diagrama”

Una vez que la versión del código sea correcta, seleccione la acción etiquetada de manera similar a:

• Editar en VP Online

• Editar en VP Online Diagrama

• Abrir en línea

• Exportar a VP Online

La etiqueta exacta puede variar según la versión de la interfaz.

El ecosistema de Visual Paradigm está diseñado para mover los diagramas generados desde el Chatbot de IA a VPasCode para un refinamiento a nivel de código y luego a Visual Paradigm Online para la edición tradicional de diagramas.

El editor de diagramas en línea es útil cuando necesita:

• Mover formas manualmente

• Redimensionar elementos

• Ajustar conectores

• Cambiar colores y fuentes

• Agregar notas o anotaciones

• Agregar un título o leyenda

• Aplicar formato de presentación

• Alinear elementos del diagrama con precisión

• Prepara el diagrama para compartir o exportar

12. Modifica el diagrama utilizando la interfaz gráfica de usuario de Visual Paradigm Online

Una vez que el diagrama se abre en Visual Paradigm Online:

Mover elementos

Arrastra las personas y los sistemas externos a una disposición clara alrededor del sistema central.

Una disposición común es:

• Personas a la izquierda o en la parte superior

• Sistema principal en el centro

• Sistemas externos a la derecha o en la parte inferior

Editar texto

Haz doble clic en un elemento o selecciona su panel de especificación para modificar:

• Nombre

• Descripción

• Estereotipo

• Etiqueta de relación

Mantén los nombres cortos y las descripciones informativas.

Editar relaciones

Selecciona un conector para:

• Cambiar su dirección

• Editar la etiqueta de relación

• Volver a conectarlo a otro elemento

• Ajustar su enrutamiento

• Cambiar el estilo o la apariencia de la línea

Agregar elementos

Usa la paleta del diagrama para agregar:

• Persona

• Persona externa

• Sistema

• Sistema externo

• Relación

• Nota

• Límite

Añada solo elementos que pertenezcan al nivel de contexto.

Aplicar formato

Puede mejorar la legibilidad ajustando:

• Tamaño de fuente

• Color de relleno

• Color del borde

• Grosor de línea

• Tamaño de forma

• Alineación

• Espaciado

• Ruteo de conectores

Evite usar el color como la única forma de comunicar significado. Utilice también etiquetas claras.

13. Diseño de presentación recomendado

Un diagrama de contexto limpio podría usar esta disposición:

Para diagramas más grandes:

• Mantenga el sistema principal centrado.

• Agrupar a las personas en un lado.

• Agrupar los sistemas de software externos en otro lado.

• Evite que las líneas de relación se crucen.

• Mantenga las etiquetas de relación horizontales siempre que sea posible.

• Utilice etiquetas cortas en lugar de párrafos.

• Deje suficiente espacio en blanco alrededor del sistema central.

Parte 3: Elegir entre edición de código y edición de interfaz gráfica

VPasCode admite modelos C4 a través de PlantUML y ofrece una vista previa en vivo, mientras que Visual Paradigm Online ofrece un flujo de trabajo tradicional de edición de diagramas visuales.

Parte 4: Flujo de trabajo integral recomendado

Flujo de trabajo rápido

1. Abra el chatbot de IA de Visual Paradigm.

2. Elija el diagrama de contexto del sistema C4.

3. Describa el sistema, los usuarios y los sistemas externos.

4. Genere el diagrama.

5. Pida al chatbot que elimine los detalles internos de implementación.

6. Revise los nombres, las relaciones y el alcance.

7. Seleccione Abrir en VPasCode.

8. Edite el código fuente C4-PlantUML.

9. Renderice y valide el resultado.

10. Seleccione Editar en VP Online.

11. Refinar el diseño y la apariencia utilizando la interfaz gráfica de usuario.

12. Exportar o compartir el diagrama final.

División recomendada de responsabilidades

Utilice elChatbot de IA para:

• Crear el primer borrador

• Explorar alternativas de arquitectura

• Agregar o eliminar participantes

• Reformular las descripciones de las relaciones

• Revisar el diagrama en busca de omisiones

UtiliceVPasCode para:

• Renombrar muchos elementos

• Reutilizar el código del diagrama

• Aplicar una sintaxis coherente

• Gestionar el código en el control de versiones

• Realizar cambios estructurales repetibles

• Corregir las directrices de diseño

• Generar una fuente de verdad basada en texto

UtiliceVisual Paradigm Online para:

• Posicionamiento visual final

• Formato de presentación

• Ajuste manual de conectores

• Agregar notas y anotaciones

• Preparación de un diagrama para las partes interesadas

Parte 5: Ejemplo de conversación de refinamiento

Solicitud inicial

Crear un diagrama de contexto de sistema C4 para una plataforma de entrega de comida.

Refinamiento 1

Agregar Cliente, Gerente de Restaurante, Repartidor y Administrador de Operaciones como personas.

Refinamiento 2

Agregar Proveedor de Pagos, Servicio de Mapas y Geolocalización, y Servicio de Notificaciones como sistemas externos.

Refinamiento 3

Eliminar todas las bases de datos, APIs, microservicios, contenedores y detalles de implementación. Esto debe permanecer como un Diagrama de Contexto de Sistema C4 de Nivel 1.

Refinamiento 4

Reescribir todas las etiquetas de relación como frases verbales concisas y mantenerlas por debajo de 10 palabras cuando sea posible.

Refinamiento 5

Revisar el diagrama en busca de relaciones faltantes y terminología inconsistente. Mantener "Plataforma de Entrega de Comida" como el único sistema de interés.

Refinamiento 6

Generar el diagrama como C4-PlantUML y hacerlo disponible para edición en VPasCode.

Parte 6: Solución de problemas

El diagrama contiene demasiado detalle

Preguntar:

Simplificar esto a un estricto Diagrama de Contexto de Sistema C4. Eliminar contenedores, componentes, bases de datos, APIs y nombres de tecnologías.

El diagrama tiene demasiadas líneas que se cruzan

En VPasCode:

• Intentar LAYOUT_LEFT_RIGHT() o LAYOUT_TOP_DOWN().

• Agregar limitadas Lay_ directivas.

• Acortar las etiquetas de las relaciones.

• Reducir el número de relaciones mostradas.

• Mover la versión final a VP Online para el posicionamiento manual.

La vista previa de PlantUML muestra un error

Verificar:

• La biblioteca C4 incluye

• Comas faltantes

• Paréntesis sin cerrar

• Identificadores mal escritos

• Relaciones que hacen referencia a elementos no definidos

• Comillas desequilibradas

• Nombres de elementos incorrectos

Una relación debe hacer referencia a identificadores que ya han sido declarados, por ejemplo:

Person(customer, "Cliente", "Realiza pedidos")
System(platform, "Plataforma de entrega de comida", "Procesa pedidos")

Rel(customer, platform, "Realiza pedidos")

La versión de la interfaz gráfica difiere de la versión de código

Tratar las dos versiones como representaciones de edición separadas después de la conversión. Tome una decisión deliberada sobre cuál es la fuente de la verdad:

• Usar VPasCode como la fuente de la verdad si el diagrama se mantendrá como código.

• Usar Visual Paradigm Online como la fuente de la verdad si los interesados ajustarán su aspecto visual con frecuencia.

Evite realizar cambios no relacionados en ambos lugares sin sincronizarlos.

El diagrama generado utiliza el nivel C4 incorrecto

Pregúntale al chatbot:

Regenera esto únicamente como un Diagrama de Contexto de Sistema C4. Muestra personas, el sistema de interés y sistemas de software externos. No muestres contenedores ni componentes.

Lista de verificación final de calidad

Antes de publicar el diagrama, confirma que:

• El diagrama tiene un título claro.

• El sistema de interés es evidente.

• Las personas y los sistemas externos están correctamente clasificados.

• Las relaciones tienen etiquetas significativas.

• Ningún detalle de implementación interna ha filtrado a la vista de contexto.

• Los nombres utilizan terminología coherente.

• El diagrama es legible con el zoom normal.

• Las líneas de relación no ocultan formas ni etiquetas.

• El código fuente de PlantUML se renderiza correctamente.

• La versión de VP Online coincide con la arquitectura aprobada.

• El diagrama final ha sido revisado por alguien familiarizado con el sistema.

El flujo de trabajo más efectivo es utilizar el Chatbot de IA para un modelado rápido, VPasCode para una edición precisa y repetible de C4-PlantUML, y Visual Paradigm Online para el refinamiento visual final. Esto combina la generación conversacional, la mantenibilidad de diagramas como código y la edición de presentaciones basada en GUI en un solo proceso.