Ver os diagramas na sua máquina

cfour serve

cfour serve · http://127.0.0.1:5173
  1 modelagem(ns) · arrastar salva em .layout/ da modelagem aberta
  Ctrl+C para parar

É o mesmo leitor da plataforma, servido da sua máquina, lendo os arquivos direto do disco. Salvar um .yaml e recarregar a página mostra o resultado.

Nada é enviado para lugar nenhum, e nenhuma conta é necessária.

As opções

Opção	O que faz
--port <n>	a porta. Padrão: 5173
--host <endereço>	escuta fora do laço local. Padrão: 127.0.0.1
--modelagem <id>	qual modelagem abre primeiro

Ele escuta só na sua máquina

Por padrão o servidor se vincula a 127.0.0.1, ou seja, ninguém na rede o alcança. Além disso ele confere dois cabeçalhos em toda requisição de dados:

• Host, contra reassociação de DNS — uma página hostil que faça um nome dela resolver para 127.0.0.1 seria recusada, porque o Host enviado não é um dos permitidos;
• Origin, contra requisição forjada de outro site.

Qualquer um dos dois fora do esperado responde 403.

--host 0.0.0.0 é uma decisão explícita de expor: use apenas numa rede em que você confia. O endereço que você passa em --host passa a ser aceito na conferência acima — senão a flag pediria uma coisa e o servidor recusaria exatamente ela.

Arrastar caixas, e o que isso grava

O leitor deixa você arrastar caixas, dobrar arestas, recolher grupos e trocar o estilo das linhas. Isso é gravado em arquivos JSON dentro de .layout/, no projeto correspondente:

model/reservas/.layout/containers.json

Duas coisas importantes:

A arrumação não é o modelo. Apagar .layout/ inteiro não perde informação de arquitetura nenhuma — só a arrumação. O desenho volta a ser calculado automaticamente.

A arrumação vale a pena versionar. Ela é a metade comunicativa do trabalho: é o que faz o desenho ficar legível em vez de apenas correto. E é ela que viaja junto quando você publica, para quem lê no navegador ver o mesmo arranjo.

Um fluxo não tem arquivo de arrumação: toda coordenada de uma sequência vem da ordem das colunas e da ordem das mensagens.

O endereço de um diagrama

A visão fica no hash da URL:

http://127.0.0.1:5173/#/<modelagem>/<projeto>/<visão>
http://127.0.0.1:5173/#/reservas/reservas/containers

Um fluxo aceita dois parâmetros a mais: ?p=<caminho> escolhe o caminho alternativo e ?n=<nível> o nível de leitura.

É a mesma forma de endereço da plataforma — então um link que você copiou do cfour serve abre o mesmo desenho no site depois de publicar.

Se ele reclamar que não achou o leitor

o viewer não foi encontrado em ...

Isso acontece quando a ferramenta está sendo executada a partir do repositório de desenvolvimento sem o leitor construído. Instalada pelo npm, ela traz o leitor dentro do pacote.

O que dá para fazer no leitor

Está em Ler os diagramas publicados — a interface é a mesma, tirando o que depende de conta.