Guía de Inicio Rápido

Esta guía te ayudará a crear tu primer diagrama de arquitectura en Archyl en solo unos minutos.

Paso 1: Crear una Cuenta

1. Ve a app.archyl.com
2. Regístrate usando tu email o conéctate con GitHub, GitLab o Bitbucket
3. Verifica tu email si te registraste con email

Una vez que inicies sesión, llegarás al panel de control, tu centro de mando para todos tus proyectos:

Paso 2: Crear Tu Primer Proyecto

1. Haz clic en "Nuevo Proyecto" en tu panel de control
2. Ingresa un nombre para tu proyecto (ej: "Mi Plataforma E-commerce")
3. Opcionalmente agrega una descripción y etiquetas
4. Haz clic en "Crear Proyecto"

Paso 3: Agregar Tu Primer Sistema

1. En tu nuevo proyecto, comenzarás en el nivel de Contexto del Sistema
2. Haz clic en el botón "+" o haz clic derecho en el lienzo
3. Selecciona "Agregar Sistema"
4. Ingresa un nombre (ej: "Plataforma E-commerce")
5. Agrega una descripción de lo que hace el sistema

Paso 4: Agregar Sistemas Externos

Los sistemas reales no existen aislados. Agrega sistemas externos con los que tu software interactúa:

1. Haz clic en "+" y selecciona "Agregar Sistema Externo"
2. Agrega sistemas como "Pasarela de Pago", "Servicio de Email", "CDN"
3. Estos aparecerán con un estilo diferente para mostrar que son externos

Paso 5: Crear Relaciones

Muestra cómo se comunican los sistemas:

1. Haz clic en el sistema origen
2. Arrastra desde el punto de conexión al sistema destino
3. Agrega una etiqueta describiendo la relación (ej: "Procesa pagos vía API")

Esta es una vista completa de Contexto del Sistema: personas, sistemas y proveedores externos conectados mediante relaciones etiquetadas:

Haz clic en cualquier elemento para abrir sus detalles: descripción, responsables, decisiones vinculadas, documentación y contratos de API:

Paso 6: Profundizar en Contenedores

Haz doble clic en tu sistema principal para profundizar al nivel de Contenedor:

1. Agrega contenedores como "Aplicación Web", "Servidor API", "Base de Datos"
2. Muestra cómo se comunican entre sí
3. Conéctalos a sistemas externos

Próximos Pasos

¡Felicitaciones! Has creado tu primer diagrama de arquitectura. Esto es lo que puedes explorar a continuación:

• Conectar un Repositorio - Deja que la IA descubra tu arquitectura automáticamente
• Descubrimiento IA - Aprende cómo la IA analiza tu código
• Colaboración en Equipo - Invita a los miembros de tu equipo
• Exportar y Compartir - Comparte tus diagramas con las partes interesadas

Consejos para el Éxito

• Comienza alto nivel: Empieza con el Contexto del Sistema antes de profundizar en detalles
• Usa nombres claros: Nombra sistemas y contenedores descriptivamente
• Agrega descripciones: Tu yo futuro (y tu equipo) te lo agradecerá
• Itera: La documentación de arquitectura es algo vivo - actualízala a medida que tu sistema evoluciona