{"id":2116,"date":"2026-05-26T07:53:11","date_gmt":"2026-05-26T07:53:11","guid":{"rendered":"https:\/\/www.vpascode.com\/pt\/docs\/uncategorized\/plantuml-c4-model-syntax-guide\/"},"modified":"2026-05-26T07:53:11","modified_gmt":"2026-05-26T07:53:11","slug":"plantuml-c4-model-syntax-guide","status":"publish","type":"ld_docs","link":"https:\/\/www.vpascode.com\/pt\/docs\/vpascode-docs\/plantuml-c4-model-syntax-guide\/","title":{"rendered":"Guia de Sintaxe do Modelo C4 do PlantUML"},"content":{"rendered":"

O que \u00e9 o Diagrama do Modelo C4?<\/h2>\n

O Diagrama do Modelo C4<\/strong>\u00e9 um framework arquitet\u00f4nico hier\u00e1rquico de quatro n\u00edveis projetado para documentar arquiteturas de software com diferentes graus de detalhe granular. Criado por Simon Brown, o C4 evita caixas e linhas vagas estruturando mapas de sistemas em quatro lentes de abstra\u00e7\u00e3o expl\u00edcitas: Contexto<\/strong> (alcance de n\u00edvel de sistema), Container<\/strong> (Aplica\u00e7\u00f5es e armazenamentos de dados), Componente<\/strong> (m\u00f3dulos internos), e C\u00f3digo<\/strong> (implementa\u00e7\u00f5es de n\u00edvel de classe).<\/p>\n

Para implementar este modelo de forma eficaz em texto, engenheiros usam a extens\u00e3o oficial C4-PlantUML<\/code>biblioteca padr\u00e3o de extens\u00e3o. Esta biblioteca substitui formas brutas de UML por macros especializadas que injetam automaticamente cores distintas, formas e campos de metadados para usu\u00e1rios, sistemas e bancos de dados. Com VPasCode<\/strong>, voc\u00ea pode definir esses ambientes aninhados de forma limpa no c\u00f3digo. O motor de layout roteia dinamicamente vetores de conex\u00e3o e dimensiona campos de texto sem comprometer a geometria do seu layout.<\/p>\n

Guia de Sintaxe Principal: Elementos e Constru\u00e7\u00f5es<\/h2>\n

Construir um modelo C4 v\u00e1lido usando PlantUML depende da importa\u00e7\u00e3o dos arquivos de biblioteca corretos, da sele\u00e7\u00e3o de macros estruturais, da defini\u00e7\u00e3o de limites e do uso de links de relacionamento especializados.<\/p>\n

1. Importa\u00e7\u00e3o dos Arquivos da Biblioteca Padr\u00e3o C4<\/h3>\n

O C4-PlantUML<\/code>a extens\u00e3o \u00e9 dividida em arquivos individuais que mapeiam diretamente para os n\u00edveis distintos do modelo de abstra\u00e7\u00e3o. Para evitar lentid\u00f5es de desempenho ou erros do compilador, voc\u00ea deve importar apenas a camada de arquivo espec\u00edfica que seu diagrama almeja:<\/p>\n

@startuml\r\n' Inclua o arquivo de camada C4 espec\u00edfico necess\u00e1rio\r\n!include <C4\/C4_Context>\r\n' Use C4_Container ou C4_Component para mapas arquitet\u00f4nicos mais profundos<\/code><\/pre>\n
2. Declarando Atores e Sistemas Principais (N\u00edvel de Contexto)<\/h3>\n
No n\u00edvel de contexto do sistema, voc\u00ea modela componentes internos, depend\u00eancias externas e usu\u00e1rios humanos. A biblioteca padr\u00e3o fornece macros espec\u00edficas que aceitam um ID, uma etiqueta visual e uma tag descritiva opcional:<\/p>\n