RobsonMaciel / modeloC4

📏Modelo C4 para documentação de arquiteturas

Modelo C4 para documentação de arquiteturas

Update: Uma atualização foi feita no repositório e os modelos foram reescritos utilizando a ferramenta Structurizr Lite.

Este repositório contém todos os diagramas contidos na apresentação do modelo C4.

PlantUML foi utilizado em conjunto com C4-PlantUML para gerar os diagramas.

Gerando os diagramas

Structurizr lite

Escrevi uma função para facilitar a utilização do comando:

# structurizr
function structurizr() {
    readonly file=${1:?"The workspace filename must be specified."}
    if [[ "$file" == *.* ]]; then
        echo "The workspace filename should not contains a file extension."
        return 1
    fi
    if [[ !  -f "./structurizr.properties" ]]; then
        echo "structurizr.autoRefreshInterval=2000" > structurizr.properties
    fi
    docker run --rm -it \
        -p 8080:8080 \
        -u $(id -u ${USER}):$(id -g ${USER}) \
        -v "$PWD":/usr/local/structurizr/ \
        -e STRUCTURIZR_WORKSPACE_FILENAME=$file \
            structurizr/lite
}

Ela será invocada da seguinte maneira:

structurizr nome_do_arquivo_sem_extensão

PlantUML

O VS Code possui um plugin para PlantUML que pode ser encontrado na marketplace: PlantUML for Visual Studio Code.

Caso queira rodar localmente será necessário instalar o Graphviz. No sistema operacional ubuntu o comando é:

sudo apt-get install graphviz openjdk-17-jre

Os diagramas também podem ser gerados utilizando o servidor remoto: http://www.plantuml.com/plantuml/uml/.

Abra os arquivos de extensão .puml ou copie seu conteúdo para o editor ou navegador.

Caso esteja utilizando a versão online, clique no botão Render para gerar a imagem.

Se estiver rodando localmente, aperte ALT + D para ter uma pré visualização, ou CTRL + SHIFT + P e selecione a opção de exportar a imagem ou pré visualização.