Configuração da aparência

model/workspace.yaml é opcional. O que estiver nele é somado chave a chave sobre os padrões do motor.

Para o guia, veja Aparência da modelagem.

cfour config show      # a configuração efetiva desta modelagem

Os blocos

Campo	Tipo	O que faz
version	número	a versão do formato
title	texto	o título no alto da barra lateral. Padrão: C4
relationKinds	mapa	os tipos de seta
shapes	mapa	as formas de caixa
palette	mapa	as cores, por vaga
noteKinds	mapa	os tipos de nota
flowOutcomes	mapa	os desfechos de caminho de fluxo
metadata	mapa	rótulo e coloração por chave de metadado

Todos os mapas são abertos: acrescentar uma chave faz aquele valor passar a valer, sem mudança de código.

relationKinds

Campo	Tipo	O que faz
label	texto	o nome legível, exibido na legenda
dash	texto	stroke-dasharray do SVG. Ausente: linha cheia
color	texto	a cor da linha
width	número	a espessura
markerStart	texto	a ponta na origem
markerEnd	texto	a ponta no destino
animated	booleano	anima a linha

Pontas: none, arrow-open, arrow-closed, arrow-half, circle, diamond.

De fábrica

Chave	Rótulo	Traço	Ponta final
sync	Síncrono	cheio	fechada
async	Assíncrono	6 4	aberta
event	Evento	2 5, roxo	aberta
batch	Batch	10 6	fechada
dep	Dependência	3 3, cinza	aberta
peer	Bidirecional	cheio	aberta nos dois lados

Um tipo desconhecido renderiza como linha cheia com ponta fechada, e gera aviso.

shapes

Campo	Tipo	O que faz
primitive	texto	o desenho base
stereotype	texto	o texto entre guilemetes. Só apresentação
palette	texto	a vaga de cor
outline	texto	solid ou dashed
size	texto	standard, narrow, compact, wide

Primitivas: box, person, robot, browser, cylinder, queue, topic, component, class.

De fábrica

Chave	Primitiva	Estereótipo	Vaga
system	box	System	system
external	box, tracejada	System_Ext	external
actor	person	Person	person
bot	robot	Person	person
container	box	Container	container
api	box	Container	container
browser	browser	Container	container
database	cylinder	ContainerDb	container
queue	queue	ContainerQueue	container
topic	topic	ContainerTopic	container
component	component	Component	component
class	class	Class	code

Uma forma desconhecida renderiza como caixa neutra, e gera aviso.

palette

Cada entrada tem fill, stroke e text, em hexadecimal.

Vagas de fábrica: person, system, container, component, code, external, neutral — a escada azul convencional do C4.

A cor é uma vaga, e não um estereótipo: trocar container recolore todas as formas que apontam para ela.

noteKinds

Campo	Tipo	O que faz
label	texto	o nome legível
color	texto	a cor do distintivo
char	texto	um caractere único no distintivo
icon	texto	uma marca desenhada, por nome. Vence char

De fábrica

Chave	Rótulo	Marca
risk	Risco	R
blocker	Bloqueio	!
warning	Atenção	!
question	Dúvida	?
info	Informação	i
tip	Nota	estrela

flowOutcomes

Campo	Tipo	O que faz
label	texto	o nome legível
color	texto	a cor do seletor de caminho

De fábrica: success (verde), failure (vermelho), alternate (âmbar).

A cor fica no seletor que escolhe o caminho, e nunca nas mensagens.

metadata

Campo	Tipo	O que faz
label	texto	o nome legível do filtro daquela chave
color	booleano	libera a chave na opção “colorir por”

Vazio de fábrica, de propósito: os eixos que uma modelagem quer são dela.

Uma chave não precisa estar aqui para virar filtro. Toda chave de metadado escrita no modelo já vira filtro sozinha, com a chave crua como rótulo. Este bloco só melhora o rótulo e libera a coloração.