Elementos y Estilo - Archyl Docs

Aprende sobre los diferentes tipos de elementos en cada nivel C4 y cómo estilizarlos

Elementos y Estilo

Cada nivel C4 soporta diferentes tipos de elementos. Entenderlos te ayuda a crear diagramas de arquitectura precisos y significativos.

Elementos por Nivel

Nivel 1: Contexto del Sistema

El nivel más alto muestra tu sistema en su entorno:

Elemento Descripción
Sistema de Software Tu sistema o producto principal
Persona Usuarios o personas que interactúan con el sistema
Sistema Externo Sistemas de terceros con los que tu sistema se integra

Nivel 2: Contenedor

Muestra los bloques de construcción técnicos dentro de un sistema:

Elemento Descripción
Servicio Servicios backend o microservicios
API APIs REST, GraphQL o gRPC
Aplicación Web Aplicaciones web frontend
Aplicación Móvil Aplicaciones iOS o Android
Base de Datos Bases de datos SQL o NoSQL
Caché Redis, Memcached, etc.
Cola de Mensajes Kafka, RabbitMQ, SQS, etc.
Almacenamiento de Archivos S3, blob storage, sistemas de archivos

Nivel 3: Componente

Muestra la estructura interna de un contenedor:

Elemento Descripción
Controlador Manejadores de solicitudes HTTP
Handler Manejadores de eventos o mensajes
Repositorio Capa de acceso a datos
Adaptador Adaptadores de sistemas externos
Middleware Procesadores de solicitud/respuesta
Utilidad Funciones auxiliares y utilidades
Modelo Modelos de dominio y entidades

Nivel 4: Código

Muestra detalles de implementación:

Elemento Descripción
Clase Clases orientadas a objetos
Interfaz Definiciones de interfaz
Struct Estructuras de datos
Función Funciones independientes
Método Métodos de clase
Enum Tipos de enumeración
Constante Valores constantes
Tipo Definiciones de tipo

Agregando Elementos

Usando el Botón Agregar

  1. Haz clic en Agregar en la barra de herramientas
  2. Selecciona el tipo de elemento
  3. Ingresa nombre y descripción
  4. Haz clic en Crear

Usando el Menú Contextual

  1. Haz clic derecho en el lienzo vacío
  2. Selecciona Agregar [Tipo de Elemento]
  3. Completa los detalles
  4. Haz clic en Crear

Arrastrar y Soltar

Para contenedores y componentes, puedes arrastrar elementos desde la barra lateral directamente al lienzo.

Estilizando Elementos

Accediendo a Opciones de Estilo

Haz clic derecho en cualquier elemento para acceder al estilo:

  • Color de fondo: Color de relleno del elemento
  • Color de borde: Color del contorno
  • Color de texto: Color de la etiqueta
  • Icono: Icono visual que representa el elemento

Paleta de Colores

Archyl proporciona una paleta de colores curada:

  • Tonos azules: Servicios, APIs
  • Tonos verdes: Bases de datos, almacenamiento
  • Tonos morados: Sistemas externos
  • Tonos naranjas: Colas de mensajes, asíncrono
  • Tonos grises: Utilidades, infraestructura

Consejos de Estilo Consistente

  • Usa el mismo color para tipos de elementos similares
  • Alinea los colores con las convenciones de tu organización
  • Considera paletas amigables para daltónicos
  • Documenta tu esquema de colores en las notas del proyecto

Overlays

Los overlays son agrupaciones visuales coloreadas que ayudan a organizar elementos en tu diagrama.

Creando un Overlay

  1. Haz clic en Agregar y selecciona Overlay
  2. Dale un nombre (ej: "Servicios Backend", "Apps Frontend")
  3. Elige un color de la paleta
  4. Haz clic en Crear

Usando Overlays

  • Arrastra elementos al área del overlay
  • El overlay proporciona agrupación visual
  • Los overlays son específicos del nivel
  • Diferentes agrupaciones en cada nivel C4

Casos de Uso de Overlays

  • Agrupar por responsabilidad del equipo
  • Agrupar por unidad de despliegue
  • Agrupar por dominio (contextos acotados DDD)
  • Resaltar componentes de ruta crítica
  • Mostrar límites de seguridad

Mejores Prácticas de Overlays

  1. Mantenlo simple: 3-5 overlays máximo por nivel
  2. Usa nombres significativos: "Dominio de Pagos" no "Grupo 1"
  3. Colores consistentes: Mismo color de overlay a través de niveles para agrupaciones relacionadas
  4. No superponer: Evita overlays superpuestos confusos

Estilizando Relaciones

Las relaciones también pueden estilizarse:

Propiedad Opciones
Color Coincidir con colores de elementos o usar neutral
Estilo de línea Sólida, punteada, guiones
Ancho de línea Delgada, media, gruesa
Estilo de flecha Estándar, hueca, ninguna

Consejos de Estilo de Relaciones

  • Usa líneas punteadas para comunicación asíncrona
  • Usa líneas más gruesas para flujos de datos principales
  • Codifica por color según protocolo (HTTP, gRPC, eventos)

Próximos Pasos