Flujos de Usuario - Archyl Docs

Documenta flujos de usuario y datos a través de tu arquitectura para visualizar secuencias de interacciones

Flujos de Usuario

Los Flujos de Usuario en Archyl te permiten documentar secuencias de interacciones a través de tu arquitectura. Visualiza cómo usuarios, datos o solicitudes se mueven a través de tu sistema.

¿Qué Son los Flujos?

Un Flujo representa una secuencia de pasos a través de tu arquitectura:

  • Viajes de usuario: Inicio de sesión, checkout, registro
  • Flujos de datos: Procesamiento de pedidos, sincronización de datos
  • Interacciones del sistema: Llamadas API, cadenas de eventos
  • Manejo de errores: Escenarios de fallo, reintentos

Cada paso en un flujo referencia relaciones en tu arquitectura, creando una vista conectada de cómo funcionan las cosas.

Creando un Flujo

Desde la Pestaña Flujos

  1. Ve a la pestaña Flujos en tu proyecto
  2. Haz clic en Crear Flujo
  3. Ingresa un nombre y descripción
  4. Agrega pasos seleccionando relaciones
  5. Haz clic en Guardar

Estructura del Flujo

Cada flujo contiene:

Campo Descripción
Nombre Nombre corto y descriptivo (ej: "Flujo de Inicio de Sesión")
Descripción Qué representa este flujo
Pasos Lista ordenada de referencias a relaciones

Agregando Pasos

Para cada paso:

  1. Selecciona una relación de tu arquitectura
  2. El paso muestra origen, destino y etiqueta de la relación
  3. Arrastra para reordenar pasos
  4. Agrega notas para contexto adicional

Generar Flujos con IA

Archyl puede escribir el flujo por ti. Describe el recorrido que quieres documentar — la IA lee los proyectos de tu organización, escoge los implicados y produce los pasos.

Cómo funciona

El generador se ejecuta en dos pasadas:

  1. Preselección de proyectos — la IA escanea cada proyecto de tu organización y selecciona hasta 5 que coincidan con tu prompt.
  2. Pasos del flujo — la IA carga el modelo C4 fusionado de esos proyectos (incluidas las relaciones entre proyectos) y escribe la lista ordenada de pasos.

Cada paso se valida contra el modelo C4 antes de persistirse. Los pasos que referencian elementos inexistentes o relaciones inconsistentes se descartan automáticamente.

Generar un flujo

  1. Abre Flows en la barra lateral
  2. Haz clic en Generate with AI
  3. Describe el flujo que quieres — el prompt es obligatorio
  4. Haz clic en Generate →

El resultado se abre automáticamente. Los flujos que abarcan varios proyectos se marcan con una etiqueta Cross-project en la lista.

Requisitos

  • Al menos un proyecto de tu organización necesita un modelo C4 (ejecuta primero una AI Discovery)
  • El prompt es obligatorio — guía la preselección de proyectos
  • La funcionalidad está disponible en el plan Business

Consejos para buenos prompts

Cuanto más específico el prompt, más ajustado el resultado.

Menos específico Más específico
"login" "el recorrido de autenticación"
"emails" "cómo se envía el email de confirmación del pedido tras el checkout"
"datos" "el pipeline de datos desde la ingesta hasta el dashboard"

La especificidad reduce el número de proyectos seleccionados y produce pasos listos para enviar.

Viendo Flujos

Navegación Paso a Paso

Al ver un flujo:

  • Los pasos se muestran en orden
  • El paso actual se resalta en el diagrama
  • Navega con botones Siguiente/Anterior
  • Ve el contexto completo en cada paso

Reproducción Animada

Haz clic en Reproducir para animar el flujo:

  • Progresión automática de pasos
  • Ruta resaltada en el diagrama
  • Velocidad de reproducción ajustable

Compartiendo Flujos

Enlaces Públicos de Flujos

Los Flujos de Usuario tienen compartición pública integrada:

  1. Abre un Flujo
  2. Haz clic en el icono Compartir
  3. Copia la URL pública
  4. Comparte con cualquiera

La vista pública incluye:

  • Navegación paso a paso
  • Visualización de arquitectura
  • Descripción del flujo
  • Sin autenticación requerida

Integrando Flujos

Integra flujos en herramientas externas:

  • Confluence
  • Notion
  • Sitios de documentación
  • Wikis

Mejores Prácticas

Nombra los Flujos Claramente

Usa nombres orientados a la acción:

  • "Registro de Usuario"
  • "Proceso de Checkout"
  • "Flujo de Reembolso de Pago"
  • "Pipeline de Sincronización de Datos"

Mantén los Flujos Enfocados

  • Un flujo por viaje de usuario
  • 5-15 pasos es ideal
  • Divide flujos complejos en sub-flujos
  • Referencia otros flujos cuando sea necesario

Agrega Contexto

Usa descripciones para explicar:

  • Por qué existe este flujo
  • Quién lo usa
  • Cuándo se activa
  • Cuál es el resultado esperado

Enlaza a Documentación

Referencia docs relacionados:

  • Especificaciones de API
  • Documentos de requisitos
  • ADRs explicando decisiones de diseño

Ejemplos de Flujos

Checkout E-commerce

  1. Usuario → Servicio de Carrito: "Ver carrito"
  2. Servicio de Carrito → Inventario: "Verificar disponibilidad"
  3. Usuario → Servicio de Checkout: "Iniciar checkout"
  4. Servicio de Checkout → Pago: "Procesar pago"
  5. Pago → Servicio de Pedidos: "Crear pedido"
  6. Servicio de Pedidos → Notificación: "Enviar confirmación"

Autenticación API

  1. Cliente → API Gateway: "Solicitud con credenciales"
  2. API Gateway → Servicio Auth: "Validar token"
  3. Servicio Auth → DB Usuario: "Buscar usuario"
  4. Servicio Auth → API Gateway: "Retornar claims"
  5. API Gateway → Backend: "Reenviar con contexto de usuario"

Próximos Pasos