Organizando com Grupos e Notas

Por que organizar?

Schemas com 20 ou mais tabelas podem ficar visualmente sobrecarregados. Grupos e notas ajudam a criar seções lógicas, documentar decisões de design e tornar o diagrama legível tanto para desenvolvedores quanto para stakeholders.

Passo 1: Crie um grupo no canvas

Na barra de ferramentas, clique no ícone de Camadas (Grupo). Seu cursor muda para o modo "adicionar grupo". Clique e arraste no canvas para desenhar um retângulo — este se torna seu grupo.

Dê ao grupo um nome como "Auth e Usuários", "Pedidos e Pagamentos" ou "Gestão de Conteúdo". O grupo aparece como um contêiner rotulado no canvas.

Passo 2: Adicione tabelas a um grupo

Arraste tabelas para dentro da área do grupo. Quando uma tabela está dentro de um grupo, ela fica visualmente associada a ele. Você também pode:

• Arrastar tabelas para fora do grupo para removê-las
• Mover o grupo — todas as tabelas dentro se movem juntas
• Redimensionar o grupo arrastando suas bordas

Passo 3: Personalize cores e rótulos do grupo

Clique em um grupo para selecioná-lo e abrir suas propriedades. Você pode:

• Alterar a cor — escolha de uma paleta de cores para distinguir visualmente as diferentes áreas lógicas do seu schema
• Renomear o grupo — clique duas vezes no cabeçalho do grupo para renomeá-lo
• Ajustar o tamanho — arraste as bordas para redimensionar
• Excluir o grupo — remove o contêiner mas mantém as tabelas no lugar

O código de cores facilita a leitura rápida de um diagrama grande. Por exemplo, use azul para tabelas relacionadas a usuários, verde para produtos/estoque, âmbar para finanças/pagamentos e roxo para tabelas de sistema/auditoria.

Passo 4: Adicione notas ao canvas

Na barra de ferramentas, clique no ícone de Quadrado (Nota). Clique em qualquer lugar do canvas para posicionar uma nota. Digite seu conteúdo — as notas suportam texto simples e são ótimas para:

• Decisões de design: "Optamos por desnormalizar os totais de pedidos para melhorar a performance das queries"
• Pendências: "Precisa adicionar suporte a soft delete nesta tabela"
• Restrições: "Esta tabela não deve ultrapassar 10M de linhas — adicionar particionamento"
• Contexto: "Esta tabela mapeia para o payload do webhook da API externa do Stripe"

As notas podem ser posicionadas em qualquer lugar do canvas e movidas livremente. Elas são salvas com o diagrama e visíveis para todos os colaboradores.

Passo 5: Use múltiplos diagramas para diferentes visões

Para schemas muito grandes, você pode criar múltiplos diagramas dentro do mesmo modelo de dados. Cada diagrama mostra um subconjunto ou arranjo diferente das suas tabelas:

• Schema completo — todas as tabelas, para documentação
• Módulo de usuários — apenas tabelas relacionadas a autenticação
• Superfície de API — tabelas que mapeiam para endpoints da API
• Foco em migração — tabelas nas quais você está trabalhando atualmente

Clique na aba "+" no topo para criar um novo diagrama. Cada diagrama tem seu próprio canvas com posições de tabela, grupos e notas independentes. O schema subjacente é compartilhado — se você adicionar uma coluna em um diagrama, ela aparece em todos os diagramas que exibem aquela tabela.

Você pode alternar entre diagramas usando as abas no topo do editor. Isso é especialmente útil durante discussões de equipe — alterne para uma visão focada para falar sobre um módulo específico sem o ruído do schema completo.