Quick Start

Crie seu primeiro diagrama de arquitetura validado em seis etapas. Cada etapa introduz um novo conceito Datro. No final, você terá um diagrama completo, estilizado e com restrições verificadas, pronto para exportar como SVG.

Cada arquivo .dtro começa com um cabeçalho mágico. Depois disso, declare nós (entidades) e arestas (relacionamentos). Cole isso no 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 }

O bloco attrs contém metadados de valores-chave arbitrários. Os valores podem ser strings, números, booleanos ou matrizes. Atributos comuns são tech, owner, deprecated e sla.

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

Os atributos passam para o JSON IR e aparecem como dicas de ferramentas no SVG renderizado – útil para metadados de plantão e SLA.

As bordas têm um tipo (tipo de relacionamento semântico), um rótulo opcional, um peso (tráfego relativo) e um sinalizador assíncrono. As arestas assíncronas são renderizadas como linhas tracejadas.

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

Use um bloco group para agrupar nós relacionados. Os grupos são renderizados como caixas de subgráficos rotuladas no SVG. Um nó pode pertencer a apenas um 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" }

As restrições são regras arquitetônicas verificadas por máquina. O validador os avalia em relação ao IR e retorna erros E501 quando uma regra é violada.

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

A regra database !-> external significa: nenhum nó do tipo database pode ter uma aresta direcionada para qualquer nó do tipo external. Isso bloqueia chamadas diretas acidentais de banco de dados → API de terceiros.

Controle como o diagrama é organizado com um bloco layout e defina uma paleta de cores com um bloco theme. A verificação de acessibilidade é acionada W602 se alguma cor ficar abaixo do 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 }
}

• Leia o Language Reference para obter a sintaxe completa de cada tipo de bloco.
• Use o CLI Reference para validar, formatar e exportar a partir da linha de comando.
• Aprenda como embed diagrams in Markdown documentos com o plugin remark ou markdown-it.