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

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