Ferramenta gratuita
Do Structurizr DSL ao diagrama de modelo C4
Cole um workspace Structurizr DSL ou um export JSON do workspace e veja as visões do seu modelo C4 como diagramas editáveis: pessoas, sistemas de software, contêineres, componentes e nós de implantação, com as relações rotuladas pela sua descrição. Escolha uma visão ou abra todas como diagramas separados.
Resultado de exemplo
Como funciona
Cole ou solte seu workspace
Um arquivo workspace.dsl, DSL copiado do playground do Structurizr ou o JSON que o Structurizr exporta. Os blocos model e views são lidos; os styles podem ficar no texto.
Veja cada visão C4
Todas as visões do workspace são listadas, da paisagem de sistemas até componentes e implantação. Escolha uma e a pré-visualização a redesenha com cartões C4, fronteiras e setas rotuladas.
Abra no Archboard
Salve a visão como um novo diagrama para reorganizar, anotar, compartilhar um link ou exportar em SVG e PNG. Para se cadastrar, basta uma conta Google ou GitHub.
O que é desenhado a partir de um workspace do Structurizr
A visão escolhida é montada com estas partes do modelo:
personPessoas, como cartões de pessoa C4 com a descrição. Uma pessoa com o tag External, ou com location External em um export JSON, vira uma pessoa externa.
softwareSystemSistemas de software, como cartões de sistema C4 com a descrição. Sistemas com o tag External viram cartões de sistema externo, que mostram só o nome.
containerContêineres, como cartões com tecnologia e descrição. Um contêiner com o tag Database vira um cartão de banco de dados, que mostra só o nome. Um contêiner com o tag Queue, contêineres e components com o tag External e um bloco enterprise são desenhados com seus próprios tipos C4: contêiner queue, cartões external container e component, e um limite enterprise.
componentComponentes, como cartões com a tecnologia, dentro do contêiner ao qual pertencem.
->Relações, como setas rotuladas com a descrição e, em seguida, a tecnologia entre colchetes. Quando uma visão mostra só os pais, uma relação entre os filhos é desenhada uma única vez entre os pais.
container bankingcomponent banking.apiO escopo de uma visão de contêineres ou de componentes, como moldura: o sistema de software na visão de contêineres, o contêiner na visão de componentes.
groupGrupos, como molduras em volta das pessoas, sistemas ou contêineres que contêm. Um grupo vazio fica de fora.
deploymentNodeinfrastructureNodecontainerInstanceVisões de implantação com nós de implantação aninhados como molduras, instâncias de contêineres e de sistemas de software como os cartões que representam, e nós de infraestrutura como cartões de nó de implantação.
systemLandscapesystemContextdeploymentVisões de paisagem, de contexto de sistema, de contêineres, de componentes e de implantação, cada uma como um diagrama separado. Um workspace sem visões recebe uma paisagem, uma visão de contexto por sistema e uma de contêineres para cada sistema que os tenha.
autoLayout lrinclude *include * com o sentido que tem em cada tipo de visão, listas de identificadores em include e exclude, e a direção de autoLayout, de cima para baixo quando não há uma.
Um workspace, várias visões
Um workspace costuma ter várias visões do mesmo modelo. A primeira visão do arquivo é desenhada primeiro, e um seletor de visões acima da pré-visualização troca para qualquer outra visão do mesmo texto. Para manter todas, Abrir todas as visões cria um diagrama por visão no seu espaço de trabalho, começando pela visão selecionada. No plano Free, as visões que não cabem no seu limite de diagramas não somem sem aviso: a ferramenta informa quantas foram abertas e quantas faltam.
O que uma importação do Structurizr deixa de fora
- Arquivos e scripts para os quais o workspace aponta: !include, !docs, !adrs, !script, !plugin e workspace extends não são seguidos nem executados. Eles são contados em um aviso, e tudo o que está escrito no texto colado é desenhado mesmo assim.
- Estilos de elementos e relações, temas e branding. Formas, cores e ícones vêm dos cartões C4, e você pode mudá-los quando o diagrama estiver aberto no Archboard.
- Visões dynamic, filtered, custom e image, e regras include ou exclude escritas como expressões. Elas são ignoradas e contadas, e as demais visões continuam na lista.
- Posições de elementos salvas em um export JSON. Cada visão é organizada de novo automaticamente, porque os tamanhos do Structurizr não batem com os cartões C4.
- Seções de documentação, registros de decisão, properties, perspectives e URLs. Só o modelo e suas visões são lidos.
Perguntas sobre o Structurizr
Quais níveis do C4 posso desenhar a partir do Structurizr DSL?
Todos os que o Structurizr modela: visões de contexto de sistema e de paisagem para o nível 1, visões de contêineres para o nível 2 e visões de componentes para o nível 3, além das visões de implantação. Diagramas de nível de código não fazem parte de um workspace do Structurizr, então não há o que desenhar para eles.
Posso colar um export JSON do workspace em vez do DSL?
Sim. O JSON que o Structurizr salva ou exporta é lido do mesmo jeito: os elementos e relações listados em cada visão são desenhados, incluindo pessoas, sistemas, contêineres e nós de implantação. As posições salvas são ignoradas e cada visão ganha um novo layout automático.
Posso abrir todas as visões de uma vez?
Sim. Quando um workspace tem duas ou mais visões, Abrir todas as visões cria um diagrama separado para cada uma, começando pela que você escolheu. Se o limite de diagramas do seu plano interromper antes, as visões já abertas ficam e as restantes são contadas, para que nada se perca sem aviso.
Meu workspace usa !include. O que faço?
Cole os arquivos incluídos na mesma caixa de texto, no lugar das linhas !include. A diretiva é contada em um aviso em vez de ser seguida, porque a ferramenta só lê o texto que você fornece.
O que é salvo quando abro o diagrama no Archboard?
A pré-visualização não é salva. Quando você escolhe Abrir no Archboard, a visão exibida, com seus cartões C4, fronteiras, molduras e setas rotuladas, é salva como um novo diagrama no seu espaço de trabalho. Mudanças posteriores no DSL ou no JSON não o atualizam.
A ferramenta de Structurizr para diagrama é gratuita?
Sim. Colar um workspace e ver seus diagramas não exige conta. Abrir uma visão, ou todas, no Archboard exige uma conta gratuita.
Abra um canvas em um minuto
Entre com Google ou GitHub. Grátis para um assento. Faça upgrade quando a equipe entrar.