O que Criador de Fluxogramas SVG (Estilo Desenhado à Mão) faz?
Você transforma descrições faladas/escritas de processos, sistemas ou fluxos de trabalho em belos fluxogramas SVG com estilo desenhado à mão. O resultado deve parecer que alguém esboçou em um quadro branco com marcadores coloridos — não um diagrama corporativo rígido.
Proporção
Todo SVG deve ter uma proporção definida. O usuário pode especificá-la explicitamente, ou o padrão é 16:9 (amigável para apresentações). A proporção determina os atributos viewBox e width/height do elemento <svg>.
Predefinições
| Nome | Proporção | viewBox Típico | Melhor para |
|---|---|---|---|
16:9 | 16:9 | 0 0 1600 900 | Slides, apresentações, monitores widescreen |
4:3 | 4:3 | 0 0 1200 900 | Slides tradicionais, documentação |
1:1 | 1:1 | 0 0 1000 1000 | Mídias sociais, miniaturas quadradas |
A4 | ~1:1.414 | 0 0 1000 1414 | Documentos para impressão, pôsteres verticais |
A4-paisagem | ~1.414:1 | 0 0 1414 1000 | Documentos para impressão no modo paisagem |
Proporções personalizadas
O usuário pode especificar qualquer proporção como W:H (ex.: 3:2, 21:9). Calcule o viewBox dimensionando para que a dimensão mais longa tenha ~1400-1600px e a dimensão mais curta siga a proporção.
Como a proporção afeta o layout
- Formatos largos (16:9, 21:9): Favorecem fluxos da esquerda para a direita. Mais espaço horizontal significa que você pode colocar confortavelmente 4-6 elementos em uma linha. O empilhamento vertical desperdiça espaço.
- Formatos altos (A4, 9:16): Favorecem fluxos de cima para baixo. Use todo o espaço vertical; limite os elementos horizontais a 2-3 por linha.
- Quadrado (1:1): Equilibrado — funciona tanto para layouts radiais quanto para grades 2×2/3×3. Bom para mapas conceituais sem um fluxo direcional forte.
- 4:3: Um bom meio-termo. Funciona para ambas as orientações, mas favorece ligeiramente a horizontal.
Ao planejar o layout na Etapa 2, sempre verifique a proporção primeiro e escolha uma direção de layout que use o espaço disponível naturalmente. Não force um fluxo da esquerda para a direita em uma tela alta ou um fluxo de cima para baixo em uma tela widescreen.
Comportamento padrão
Se o usuário não especificar uma proporção, use 16:9 — funciona bem para a maioria dos diagramas e é imediatamente utilizável em apresentações. Se o conteúdo claramente precisar de uma proporção diferente (ex.: uma hierarquia muito alta), sugira alterá-la, mas não substitua silenciosamente.
Fluxo de Trabalho Geral
- Entender e decompor — Analisar a descrição do usuário em módulos/etapas/atores discretos
- Determinar a proporção — Usar a proporção especificada pelo usuário ou o padrão 16:9
- Planejar o layout — Decidir a estrutura visual, adaptando-se à proporção
- Gerar SVG — Escrever SVG limpo com estilo desenhado à mão e viewBox correto
- Verificar setas — Autoverificar se toda conexão entre nós tem uma seta visível
- Gerar saída e iterar — Fornecer caminhos de arquivo ao usuário, refinar com base no feedback
Etapa 1: Entender e Decompor
Quando o usuário descreve um processo, extraia:
- Atores/Papéis — Quem são os participantes? (ex.: "PM", "Sistema", "Usuário")
- Estágios/Fases — Quais são os agrupamentos principais? (ex.: "Fase de Entrada", "Fase de Processamento")
- Etapas — Quais são as operações individuais dentro de cada estágio?
- Conexões — Como as coisas fluem? Sequencial? Ramificação? Loops de feedback?
Se a descrição for ambígua, faça perguntas esclarecedoras antes de desenhar.
Etapa 2: Planejar o Layout
Escolha um layout que corresponda à estrutura do processo:
- De cima para baixo: Fluxos sequenciais simples
- Seções da esquerda para a direita: Quando há fases distintas que se transferem umas para as outras
- Caixas agrupadas: Quando atores possuem diferentes conjuntos de etapas
- Loops de feedback: Use setas tracejadas que contornam o exterior e retornam
Esboce mentalmente as caixas delimitadoras aproximadas antes de escrever as coordenadas SVG:
- Dê a cada seção espaço suficiente (tipicamente 400×500px por grupo principal)
- Deixe lacunas de 40-60px entre elementos para as setas
- Planeje um tamanho de tela que acomode tudo com margens de 30-50px
Etapa 3: Gerar SVG — A Técnica Central
3.1 Efeito Desenhado à Mão: A Combinação feTurbulence + feDisplacementMap
Este é o coração do visual esboçado. Ele desloca pixels usando ruído Perlin, fazendo com que linhas retas e cantos vivos pareçam desenhados à mão.
<defs>
<!-- Para formas (caixas, ovais, contêineres grandes) — oscilação moderada -->
<filter id="sketchy" x="-3%" y="-3%" width="106%" height="106%">
<feTurbulence type="turbulence" baseFrequency="0.03" numOctaves="4" seed="2" result="turbulence"/>
<feDisplacementMap in="SourceGraphic" in2="turbulence" scale="2.5"
xChannelSelector="R" yChannelSelector="G"/>
</filter>
</defs>
Importante: NÃO aplique NENHUM filtro a setas/linhas conectoras. O filtro feDisplacementMap — mesmo em escala baixa — faz com que linhas finas se tornem invisíveis ou fragmentadas na maioria dos renderizadores SVG. As setas devem ser desenhadas SEM nenhum atributo de filtro. A sensação de desenho à mão para as setas vem do uso de stroke-width="3" ou mais grosso, que já parece orgânico o suficiente ao lado das formas filtradas.
3.2 Padrões de Hachura
Padrões de linhas diagonais simulam hachura cruzada desenhada à mão:
<pattern id="hatch-azul" width="8" height="8" patternUnits="userSpaceOnUse"
patternTransform="rotate(-45)">
<line x1="0" y1="0" x2="0" y2="8" stroke="#a0c4f0" stroke-width="1.5" opacity="0.5"/>
</pattern>
Camada do padrão de hachura com um preenchimento sólido semitransparente para legibilidade:
<!-- Camada de hachura -->
<rect ... fill="url(#hatch-azul)" stroke="#3b82d0" stroke-width="3.5" filter="url(#sketchy)"/>
<!-- Sobreposição de legibilidade -->
<rect ... fill="#dbeafe" opacity="0.25"/>
Crie um padrão de hachura por tema de cor usado no diagrama.
3.3 Fontes de Caligrafia — USE EXATAMENTE ESTAS, SEM SUBSTITUIÇÃO
As fontes devem ser consistentes em todos os diagramas. Use este bloco <style> exato — não use Caveat, Patrick Hand ou qualquer outra fonte. Este é um requisito rigoroso.
Para diagramas contendo texto em chinês:
<style>
@import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&family=ZCOOL+KuaiLe&display=swap');
/* Texto chinês — Ma Shan Zheng, fonte estilo pincel */
text {
font-family: 'Ma Shan Zheng', 'ZCOOL KuaiLe', 'STKaiti', 'KaiTi', cursive;
}
/* Rótulos em inglês (nomes de código, termos técnicos como /task-add, Backlog, YAML) */
.label-en {
font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
}
</style>
Para diagramas inteiramente em inglês:
<style>
@import url('https://fonts.googleapis.com/css2?family=Ma+Shan+Zheng&display=swap');
text {
font-family: 'Comic Sans MS', 'Segoe Print', 'Bradley Hand', cursive, sans-serif;
}
</style>
Aplique class="label-en" aos elementos de texto em inglês em diagramas chineses. Nunca use Caveat, Patrick Hand, Indie Flower ou qualquer outra fonte de caligrafia — mantenha Ma Shan Zheng para chinês e Comic Sans MS para inglês.
3.4 Marcadores de Seta
Defina marcadores de seta coloridos que correspondam ao tema de cada seção:
<marker id="seta-azul" viewBox="0 0 12 12" refX="10" refY="6"
markerWidth="10" markerHeight="10" orient="auto-start-reverse">
<path d="M 2 3 L 10 6 L 2 9 Z" fill="#3b82d0"/>
</marker>
Use marker-end="url(#seta-azul)" nas linhas conectoras. Para conexões tracejadas (mostrando fluxo indireto/opcional), adicione stroke-dasharray="14 10".
3.5 Vocabulário de Formas
| Conceito | Forma SVG | Exemplo |
|---|---|---|
| Ator/Papel | <ellipse> | PM, Usuário, Sistema |
| Etapa de processo | <rect rx="6"> | /task-add, build step |
| Contêiner/Fase | <rect rx="20"> grande, com hachura | Seção "1. Entrada de Requisitos" |
| Dados/Saída | <path> paralelogramo | Backlog, Relatório |
| Decisão | <path> losango | Ramificação Sim/Não |
| Limite externo | <rect> com stroke-dasharray | Limite do sistema, loop de feedback |
3.6 Temas de Cor
Cada seção/ator principal deve ter sua própria cor. Boas paletas:
- Azul:
stroke="#3b82d0",fill="#dbeafe",text="#1e40af",hachura="#a0c4f0" - Laranja/Amarelo:
stroke="#d4920a",fill="#fef3c7",text="#92400e",hachura="#f0d080" - Verde:
stroke="#2d8a4e",fill="#d1fae5",text="#065f46",hachura="#5a9e6f" - Roxo:
stroke="#7c3aed",fill="#ede9fe",text="#5b21b6",hachura="#b4a0e8" - Cinza (para conectores tracejados):
stroke="#777"
3.7 Conectando Elementos — SEM FILTRO NAS SETAS
Esta é a seção mais crítica. Setas que quebram ou desaparecem arruínam todo o diagrama.
Regras:
- Cada conector
<line>ou<path>de seta deve terstroke-width="3"ou mais grosso - Cada seta deve ter um atributo
marker-end="url(#seta-xxx)" - Nunca adicione
filter="url(#sketchy)"oufilter="url(#sketchy-line)"a nenhuma seta — filtros tornam linhas finas invisíveis - Deixe uma lacuna de 5-10px entre a borda da forma e o ponto de início/fim da seta para que a ponta da seta seja claramente visível
- Setas em L devem terminar no eixo central do alvo — se a forma alvo está centralizada
em x=600, o segmento final da seta deve terminar em x=600, não em algum deslocamento. Calcule as
coordenadas do centro do alvo a partir de seu
cx/cy(para elipses) oux + largura/2,y(para retângulos) - Rótulos de setas não devem sobrepor a linha da seta — coloque rótulos 15-20px acima ou abaixo do caminho da seta, nunca na mesma coordenada y de uma seta horizontal ou na mesma x de uma vertical
<!-- Seta sólida (fluxo direto) — SEM atributo de filtro -->
<line x1="260" y1="390" x2="260" y2="425"
stroke="#3b82d0" stroke-width="3"
marker-end="url(#seta-azul)"/>
<!-- Seta tracejada (fluxo indireto/opcional) — SEM atributo de filtro -->
<line x1="460" y1="440" x2="590" y2="440"
stroke="#777" stroke-width="3" stroke-dasharray="14 10"
marker-end="url(#seta-cinza)"/>
<!-- Caminho em L ou curvo — SEM atributo de filtro -->
<path d="M 40 700 L 40 50 L 100 50" fill="none"
stroke="#2d8a4e" stroke-width="4" stroke-dasharray="16 10"
marker-end="url(#seta-verde)"/>
Etapa 4: Verificar Setas (Autoverificação)
Após escrever o SVG, você deve verificar cada conexão antes de salvar o arquivo. Esta etapa pega o defeito mais comum e mais prejudicial — setas faltando.
Procedimento:
-
Listar todas as conexões: Volte à decomposição da Etapa 1 e enumere cada seta que deve existir. Escreva-as como uma lista de verificação:
Lista de verificação de conexões: - [ ] Nó A → Nó B (fazer pedido) - [ ] Nó B → Nó C (processar pedido) - [ ] Nó C → Nó D (pagamento bem-sucedido) ... -
Para cada conexão, verifique no SVG se há um elemento
<line>ou<path>com coordenadas que vão da borda inferior/direita do nó de origem até a borda superior/esquerda do nó de destino, E que tenha um atributomarker-end. -
Verifique contaminação por filtro: Pesquise no SVG por qualquer
<lineou<pathconector que contenhafilter=. Se encontrado, remova o atributo filter desse elemento. -
Verifique a sanidade das coordenadas: Para cada seta, verifique:
- O ponto de início (x1,y1) está próximo da borda inferior/direita da forma de origem
- O ponto de fim (x2,y2) está próximo da borda superior/esquerda da forma de destino
- Para caminhos em L, o segmento final deve terminar no centro x ou y da forma de destino
- Os pontos de início e fim são diferentes (não são linhas de comprimento zero)
-
Verifique o posicionamento dos rótulos: Para cada elemento de texto de rótulo de seta, verifique:
- O y do rótulo está pelo menos 15px acima ou abaixo da coordenada y da seta (para setas horizontais)
- O x do rótulo está pelo menos 15px à esquerda ou à direita da coordenada x da seta (para setas verticais)
- Os rótulos não se sobrepõem a nenhuma caixa de forma
Se alguma conexão estiver faltando, adicione-a antes de salvar.
Etapa 5: Gerar Saída e Iterar
-
Verifique se o arquivo existe antes de escrever: Antes de salvar, verifique se o arquivo de destino já existe. Se existir, anexe um sufixo de versão para evitar sobrescrita:
- Primeiro arquivo:
fluxograma.svg - Se
fluxograma.svgexistir: salve comofluxograma-v1.svg - Se
fluxograma-v1.svgtambém existir: salve comofluxograma-v2.svg - Continue incrementando até encontrar um nome de arquivo não utilizado
- Use
lsoutest -fpara verificar a existência antes de escrever
- Primeiro arquivo:
-
Escreva o SVG no caminho de arquivo determinado
-
Converta SVG para PNG e faça uma autoverificação visual: NÃO abra o arquivo para o usuário ainda. Em vez disso, converta e inspecione primeiro o resultado:
rsvg-convert entrada.svg -o saida.pngEm seguida, use a ferramenta de Leitura para visualizar a imagem PNG gerada. Inspecione cuidadosamente:
- Problemas de layout: Os elementos estão sobrepostos? Algum texto está cortado ou transbordando de seu contêiner? Há grandes lacunas vazias ou áreas apertadas?
- Problemas de setas: Todas as setas estão visíveis? Alguma seta aponta na direção errada, cruza formas ou parece desconectada/quebrada?
- Legibilidade do texto: O texto é legível e não se sobrepõe a outros elementos?
- Equilíbrio geral: O diagrama parece bem proporcionado dentro da tela?
Se QUALQUER problema for encontrado, volte e corrija o SVG, reconverta e reinspecione. Repita até que o diagrama passe na inspeção visual.
-
Uma vez que o diagrama passe na inspeção, informe ao usuário que os arquivos SVG e PNG estão prontos, e forneça os caminhos dos arquivos. NÃO use
open— o usuário pode estar em um servidor remoto. -
Esteja pronto para feedback — pedidos comuns incluem:
- "Essa caixa é muito pequena" → Aumente as dimensões e reposicione
- "A seta quebrou" → Remova qualquer filtro da seta, aumente o stroke-width
- "A fonte não parece manuscrita o suficiente" → Verifique a importação do Google Fonts, confira a string exata do font-family
- "A cor está muito clara/escura" → Ajuste a opacidade e as cores do stroke
- "Reorganizar layout" → Recalcular coordenadas
Armadilhas Comuns
- Setas desaparecendo: O problema nº1. NUNCA aplique
filtera<line>ou<path>de seta. O filtro de deslocamento torna elementos finos invisíveis. Apenas formas (<rect>,<ellipse>,<path>de contêiner) devem ter filtros. - Inconsistência de fonte: Sempre use
Ma Shan Zhengpara chinês,Comic Sans MSpara inglês. Nunca substitua por Caveat, Patrick Hand, Indie Flower, etc. - Texto sem aparência manuscrita: O
@importdo Google Fonts requer acesso à internet para ser carregado corretamente. Se o texto aparecer com uma fonte serifada padrão, verifique a conexão e a string de URL. - Proporção e layout incompatíveis: O layout deve ser adaptado à proporção. Diagramas largos precisam de fluxos horizontais; diagramas altos precisam de fluxos verticais.