Ler os diagramas publicados

O leitor é a mesma página nos dois mundos: o que o cfour serve abre na sua máquina e o que a plataforma serve são o mesmo programa, lendo os mesmos dados.

O endereço

https://app.cfourdev.com.br/<organizacao>/<repositorio>/

Isso abre a ref padrão do repositório. Um preview é escolhido por parâmetro de busca:

https://app.cfourdev.com.br/<organizacao>/<repositorio>/?ref=pr-42

E um desenho específico fica no hash:

/reservas/reservas/containers

#/<modelagem>/<projeto>/<visao>

Copiar a URL da barra de endereços e colar no chat é o suficiente para mandar alguém exatamente ao desenho que você está vendo. Num fluxo, ?p=<caminho> carrega o caminho alternativo e ?n=<nível> o nível de leitura.

A navegação

A árvore, à esquerda. Os projetos, os diagramas e os fluxos, na ordem que order definiu e agrupados pelas pastas em que os arquivos estão.

Descer para dentro de uma caixa. Uma caixa que tem um diagrama detalhando-a abre por ali. Quando há mais de um diagrama candidato, o leitor pergunta qual.

A trilha, no topo. Mostra onde você está e volta um nível.

O seletor de nível. Num fluxo, ele sobe ou desce a leitura da sequência: as mensagens entre duas caixas que, no nível escolhido, viraram a mesma caixa, desaparecem.

Filtrar e buscar

A busca encontra por identificador, nome, descrição, tecnologia, etiqueta, metadado e texto de nota.

Os filtros são construídos a partir do modelo: toda etiqueta e toda chave de metadado viram um filtro, com os valores encontrados e a contagem de cada um. Não há nada a configurar — escrever um metadado já cria o filtro.

Colorir por repinta o desenho segundo uma chave de metadado, quando aquela chave foi liberada para isso em workspace.yaml.

O que aparece numa caixa

Ao selecionar uma caixa, o painel de detalhes mostra o que ela declara, o que o motor derivou (o nível, o pai, os filhos), as relações que entram e saem, as notas presas a ela, e os links — todo metadado cujo valor é uma URL.

Arrumar o desenho

Arrastar caixas, dobrar arestas, recolher grupos e trocar o estilo das linhas funciona nos dois mundos. A diferença é onde a arrumação é gravada:

cfour serve	em arquivos JSON dentro de .layout/, no seu repositório
plataforma	na sua conta, como uma preferência sua sobre aquele repositório

Ou seja: no leitor hospedado, mexer no desenho não altera o que os outros veem. O arranjo que todo mundo vê é o que foi publicado a partir de .layout/.

Exportar

O leitor exporta o desenho como imagem, para colar numa apresentação ou num documento.

Ler duas modelagens juntas

Quando duas modelagens declaram a mesma federação, o leitor oferece abri-las ao mesmo tempo. Nessa leitura, um espelho — a caixa externa com bind — se dissolve no elemento real da outra modelagem, e você pode descer para dentro dele.

Quem consegue abrir

Depende da visibilidade do repositório:

org	qualquer membro da organização, com qualquer papel
private	apenas quem é admin ou dono

Não existe leitura anônima: todo acesso passa por login. Veja Repositórios e visibilidade.