Quick Start

Cree su primer diagrama de arquitectura validado en seis pasos. Cada paso introduce un nuevo concepto Datro. Al final, tendrá un diagrama completo, con estilo y con restricciones verificadas, listo para exportar como SVG.

Cada archivo .dtro comienza con un encabezado mágico. Después, declara nodos (entidades) y bordes (relaciones). Pega esto en el editor:

#!DATRO 1.0

node frontend { type: web      label: "React App" }
node backend  { type: service  label: "NestJS API" }
node db       { type: database label: "PostgreSQL" }

edge frontend -> backend { kind: http }
edge backend  -> db      { kind: query }

El bloque attrs contiene metadatos de valores-clave arbitrarios. Los valores pueden ser cadenas, números, booleanos o matrices. Los atributos comunes son tech, owner, deprecated y sla.

node backend {
  type:  service
  label: "NestJS API"
  attrs {
    tech:  "nestjs"
    owner: "platform-team"
  }
}

Los atributos pasan al JSON IR y aparecen como información sobre herramientas en el SVG renderizado, lo que resulta útil para metadatos de guardia y SLA.

Los bordes tienen un tipo (tipo de relación semántica), una etiqueta opcional, un peso (tráfico relativo) y un indicador async. Los bordes asíncronos se representan como líneas discontinuas.

edge backend -> stripe {
  kind:  http
  label: "charge API"
  async: false
}

Utilice un bloque group para agrupar nodos relacionados. Los grupos se representan como cuadros de subgrafos etiquetados en SVG. Un nodo sólo puede pertenecer a un grupo.

group data_tier {
  label:   "Data Layer"
  members: [db, redis_cache]
}

node redis_cache { type: cache label: "Redis" }

edge backend -> redis_cache { kind: read  label: "session" }

Las restricciones son reglas arquitectónicas verificadas por máquina. El validador los evalúa con respecto al IR y devuelve E501 errores cuando se viola una regla.

constraint {
  id:       "no-db-external"
  rule:     "database !-> external"
  message:  "Databases must not connect to external services"
  severity: error
}

La regla database !-> external significa: ningún nodo de tipo database puede tener un borde dirigido a cualquier nodo de tipo external. Esto bloquea llamadas directas accidentales a DB → API de terceros.

Controle cómo se organiza el diagrama con un bloque layout y defina una paleta de colores con un bloque theme. La verificación de accesibilidad activa W602 si algún color cae por debajo del contraste WCAG AA.

layout { direction: LR  algo: dagre  node_sep: 60  rank_sep: 120 }

theme {
  palette {
    service:    "#D0E8FF"
    database:   "#FFE8C0"
    web:        "#E8D0FF"
    cache:      "#C0FFE8"
    background: "#FFFFFF"
  }
  accessibility { min_contrast: AA }
}

• Lea el Language Reference para conocer la sintaxis completa de cada tipo de bloque.
• Utilice CLI Reference para validar, formatear y exportar desde la línea de comando.
• Aprenda a embed diagrams in Markdown documentos con el complemento comentario o markdown-it.