Ir para a documentação

CLASSES DE MODELO E CONTRATOS

Diagrama de classes: guia

Crie classes visualmente. Defina membros e relações, revise verificações do modelo, organize pacotes e salve ou exporte seu diagrama.

Classes e relações → diagrama de classesAbrir diagrama de classes

Desenhar classes e as suas responsabilidades

O Diagrama de classes é um espaço de trabalho visual separado para classes, classes abstratas, interfaces e enumerações. Cada classificador tem um nome, um compartimento de atributos ou literais e um compartimento de operações. Os nomes abstratos aparecem em itálico; as interfaces e enumerações mostram o seu estereótipo. Selecione uma classe e utilize a Cor do cabeçalho para escolher uma predefinição, uma cor personalizada ou Neutro. As cores do cabeçalho são salvas, suportam Anular/Refazer e aparecem nas exportações de imagem; o texto dos membros permanece legível.

Os novos diagramas pedem que escolha o Diagrama em branco ou o modelo de sistema de Pedidos. Os novos diagramas permanecem na memória até serem salvos na nuvem ou descarregados como JSON. A sua barra de editor compacta contém o nome do diagrama, menu Ficheiro, Anular/Refazer, controlo de tema e exportação de imagem. Os ficheiros na nuvem do Diagrama de classes são separados dos documentos SQL, Prisma e Construtor ERD.

Construa o seu primeiro diagrama de classes

  1. Abra o Diagrama de classes e escolha Diagrama em branco ou o modelo de sistema de Pedidos. Ficheiro → Novo diagrama abre o seletor novamente; Ficheiro → Em branco substitui o diagrama atual com confirmação e Anular.
  2. Clique em Classe ou arraste-a da Biblioteca para a tela, depois renomeie-a para Customer no inspetor (utilize Editar detalhes num ecrã estreito) e adicione um atributo id com visibilidade Privada (-) e tipo UUID.
  3. Para um classificador personalizado, escolha Classificador personalizado ou edite o campo opcional Stereotype em qualquer classificador existente. Etiquetas como entity, service ou controller aparecem como «a sua etiqueta» acima do nome e são incluídas em ficheiros na nuvem, JSON e Exportações de imagem. Estas mantêm o comportamento do classificador base selecionado; a ferramenta não valida perfis UML.
  4. Adicione outra classe chamada Order. Adicione uma operação como calculateTotal com o tipo de retorno Decimal. Os campos guiados mostram uma pré-visualização antes de confirmar.
  5. Escolha Associação na Biblioteca de relações. O campo De começa com a classe selecionada quando uma está selecionada. Defina De para Customer e Para para Order, depois crie-a. Selecione o conector para adicionar uma etiqueta e multiplicidades.
  6. Para criar ambos os itens em conjunto, selecione uma classe e escolha Ligar novo. Adicionar classe ligada permite-lhe escolher o novo classificador, nome opcional, relação e direção. A herança e a realização apontam inicialmente o novo filho ou implementador para o pai ou contrato selecionado; outros tipos apontam inicialmente da classe selecionada para a nova. Criar classe ligada submete ambos num único passo de anulação; Cancelar ou Escape descarta o formulário.
  7. Utilize Organizar e Ajustar diagrama e, em seguida, transfira o JSON de Ficheiro para uma cópia de segurança editável ou Exportar diagrama para PNG, JPEG, WebP, SVG vetorial ou PDF.

Atributos, literais e visibilidade

Selecione um classificador e use Fields para adicionar um atributo com um nome, tipo obrigatório, visibilidade e valor predefinido opcional. As sugestões de tipo incluem tipos comuns e nomes de classificadores; tipos personalizados são permitidos. Add ou Salvar alterações confirma a pré-visualização numa única edição. Cancel ou Escape discarda o formulário pendente.

Utilize + para público, - para privado, # para protegido e ~ para visibilidade de pacote. O modo de texto aceita um membro por linha. A formatação organiza apenas assinaturas válidas e suportadas; a notação personalizada permanece como texto e é preservada quando outra linha é alterada.

As enumerações utilizam Literais em vez de Atributos. Introduza um nome literal e um valor opcional, por exemplo ACTIVE = "active". Os campos guiados rejeitam nomes de membros repetidos. O texto personalizado é preservado mesmo quando não pode ser representado em campos.

UML attributes / Assinaturas de atributos
- id: UUID
+ displayName: String
# active: Boolean = true
~ tags: List<String> = []
A sintaxe de membros é uma ajuda de edição conservadora, não um verificador de tipos completo de UML ou de linguagem de programação. Os nomes de tipos não criam nem ligam outros classificadores automaticamente.

Operações e parâmetros tipados

Uma operação tem visibilidade, um nome, parâmetros tipados com predefinições opcionais e um tipo de retorno opcional. Adicionar parâmetro insere uma linha de entrada; o seu botão de remover elimina esse parâmetro pendente. Novas operações têm como predefinição o tipo de retorno void.

No modo Texto, escreva nome(parâmetro: Tipo): TipoRetorno, com um prefixo de visibilidade opcional. Tipos genéricos aninhados e valores padrão entre aspas são suportados. Cada parâmetro necessita de um nome distinto e de um tipo. As sobrecargas podem partilhar um nome de operação quando os seus tipos de parâmetros diferem.

UML operations / Assinaturas de operação
+ placeOrder(items: List<OrderItem>): Order
+ findOrders(status: String = "open"): List<Order>
- calculateTotal(): Decimal

Escolha a notação de relacionamento

Passe o rato ou foque com o teclado uma classe (toque para selecionar em ecrãs táteis) para revelar os seus pontos de ligação e, em seguida, arraste para outra classe para uma associação. Os pontos permanecem ocultos em repouso e em diagramas de apenas leitura. Também pode escolher uma relação da Biblioteca. O inspetor permite alterar o tipo, extremidades, etiqueta e multiplicidades das extremidades, tais como 1, 0..1 ou 0..*. As multiplicidades são texto editável; a ferramenta não infere regras de negócio.

Cada multiplicidade tem predefinições 1, 0..1, 0..* e 1..*. O texto personalizado permanece editável e é preservado. O significado da relação explica a direção real, pai/contrato ou todo/parte, e as contagens de associação: a multiplicidade 'Para' conta as instâncias 'Para' por cada 'De'; a multiplicidade 'De' conta o inverso. A orientação não adiciona validação semântica.

Os nomes dos relacionamentos situam-se diretamente no conetor, perto do seu ponto médio. As multiplicidades permanecem perto do limite da sua própria classe e afastadas das cabeças UML. As etiquetas seguem o arrastamento em tempo real e, em seguida, ajustam-se a outras etiquetas quando libertadas. O texto longo quebra a linha; rotas congestionadas podem necessitar de uma alternativa clara se a etiqueta não couber na linha.

Funções e navegação adicionam as funções opcionais De e Para ao lado da classe relevante. Diferentes funções ou etiquetas distinguem ligações estruturais paralelas, tais como billingAddress e shippingAddress. A navegação da associação pode apontar para De, Para ou ambos. Outros tipos de relacionamento mantêm as suas cabeças semânticas.

A ferramenta rejeita pontos finais em falta, duplicados exatos de mesma direção/tipo/etiqueta/papel estrutural, ciclos de herança e auto-herança ou realização. A multiplicidade, navegação e alterações de caminho por si só não criam uma ligação distinta. Associação, agregação, composição e dependência podem ligar uma classe a si própria. Estas verificações estruturais não estabelecem uma validade semântica UML completa.

Escolha a notação de relacionamento
RelaçãoDireção e símbolo
AssociaçãoLinha entre classificadores associados; setas de navegação opcionais apontam para uma classe acessível. Ligações recursivas são suportadas.
HerançaFrom é a subclasse. Uma linha sólida termina num triângulo vazio em To, o pai.
RealizaçãoDe implementa o contrato em Para. Uma linha tracejada termina num triângulo oco em Para.
AgregaçãoFrom é o todo e To é a parte. Um losango vazio pertence a From.
ComposiçãoFrom detém o tempo de vida de To. Um losango preenchido pertence a From.
DependênciaDe depende de Para. Uma seta aberta tracejada aponta para o fornecedor em Para.

Lados automáticos, cabeças fixas e caminhos

Curvo é o padrão para um novo diagrama. Ver → Caminhos de ligação na barra de ferramentas da tela oferece Curvo e Cotovelo para definir todos os caminhos e o padrão para novas ligações. Cotovelo utiliza segmentos horizontais e verticais com pequenos cantos arredondados. Selecione um conector para substituir o seu caminho de Linha individualmente.

As novas ligações escolhem os lados adequados automaticamente à medida que as classes se movem ou mudam de tamanho. As ligações à Esquerda e Direita anexam-se ao cabeçalho. Topo e Fundo anexam-se ao limite correspondente do cartão. Escolher Topo, Fundo, Esquerda ou Direita no inspetor fixa apenas esse ponto final; o seu parceiro pode continuar a seguir automaticamente.

Escolha Auto no seletor do lado de origem ou destino para que essa extremidade acompanhe a classe. Lados automáticos libera ambas as extremidades. Arraste uma extremidade selecionada para mudar de lado ou o ponto central para curvar o conector. Esc cancela; Home ou um clique duplo redefine a curva. Redefinir conexão restaura o traçado automático. Os ajustes permitem desfazer, salvar e exportar imagens.

Os caminhos evitam os seus cartões ligados; as ligações recursivas fazem um ciclo fora da classe e as ligações paralelas utilizam rotas separadas. A disposição e os lados automáticos melhoram a legibilidade, mas não garantem o evitamento de todos os cartões não relacionados ou outras ligações. Rascunhos JSON mais antigos sem modos de lado mantêm os seus lados guardados até escolher Auto.

Verifique o seu modelo e mude o nome com segurança

As verificações abrem Erros, Avisos e Sugestões para notação de membros, nomes, limites de multiplicidade e estrutura de herança. Selecione um problema para revelar a sua classe ou relação e o campo relevante. As verificações preservam o texto personalizado, nunca corrigem automaticamente e não funcionam como um compilador de linguagem de programação.

Renomear com referências… numa classe selecionada pré-visualiza referências de tipo exatas em atributos, parâmetros de operação e tipos de retorno. Escolha as referências a atualizar e, em seguida, aplique o nome e as referências como um único passo de anulação. Notação personalizada, predefinições, tipos externos qualificados e referências ambíguas a nomes de classificadores repetidos permanecem inalterados.

As substituições de tipo selecionadas devem caber no limite de 8.000 caracteres de cada compartimento de membro. Se uma atualização proposta o exceder, desmarque algumas referências ou limpe todas as seleções de referências para renomear apenas a classe. A ferramenta rejeita a atualização excessiva em vez de truncar o texto do membro.

Alinhar, distribuir e bloquear classes

O Layout oferece alinhamento de classes selecionadas, intervalos horizontais/verticais iguais, Organizar seleção, bloqueios de posição e um botão de alternância Ajustar às guias de alinhamento. Ctrl/Cmd-clique para selecionar classes. As classes bloqueadas permanecem fixas durante o arrastamento, movimento de pacotes e organização; os bloqueios sobrevivem a ações de Salvar. Intervalos iguais preservam as classes externas e deixam os intervalos congestionados inalterados. A organização da seleção deixa as outras classes fixas e coloca o seu bloco afastado delas, ou mantém o gráfico intacto se nenhum posicionamento couber. Arrastamentos de classe única ajustam-se num raio de seis píxeis do ecrã; as guias e o seu botão de alternância permanecem fora dos ficheiros salvos.

Organizar e navegar na tela

Clique em Organizar para uma organização Inteligente. Esta utiliza tamanhos de classes e a estrutura de relações, coloca pais e interfaces acima dos filhos e separa grupos desligados. O menu suspenso também oferece Da esquerda para a direita, De cima para baixo e Compacto.

A organização preserva o significado da relação e os lados fixos dos pontos terminais, atualiza os lados automáticos e ajusta o resultado. Desfazer reverte-o num único passo. Se o documento for alterado enquanto o motor de layout carrega, o resultado desatualizado é descartado; organize novamente para o novo documento.

Layouts grandes movem-se em conjunto dentro dos limites de posição salvos. Se uma disposição não couber, o seu diagrama permanece intacto; tente Apenas nomes ou outra direção e, em seguida, organize novamente.

Arraste as classes para as posicionar, arraste a tela vazia para deslocar e use o scroll para fazer zoom. Ajustar diagrama e os controlos de zoom ajudam a navegar; o minimapa mostra uma visão geral. Em larguras até 900px, o inspetor move-se para baixo da tela. Selecione uma classe ou ligação e escolha Editar detalhes (Ver detalhes para um ficheiro partilhado) para aceder; Voltar ao diagrama regressa à tela. Escolher uma relação abre o seu formulário em visualização. O guia do diagrama de classes abre num separador à parte para que o rascunho atual permaneça aberto.

Localizar ou Ctrl/Cmd+K pesquisa nomes, estereótipos, atributos, operações, nomes de pacotes e notas. Use Seta para Cima/Baixo e Enter para selecionar e centrar um resultado; os resultados de membros revelam os detalhes completos dessa classe e focam a secção correspondente do inspetor. Escape fecha a Localização. Focar ligações enfatiza a classe selecionada e os vizinhos imediatos enquanto obscurece elementos não relacionados; Mostrar tudo ou Escape sai do foco.

Abra Ver na barra de ferramentas da tela para escolher Detalhes completos, Apenas atributos ou Apenas nomes. Apenas atributos mantém atributos ou literais de enumeração e resume operações; Apenas nomes mostra a contagem de membros. Passe o rato, foque ou selecione uma classe para substituir o seu nível de detalhe, ou escolha Predefinição do diagrama para herdar. Alterar o nível global limpa as substituições. O foco e os detalhes também funcionam em ficheiros partilhados, permanecem fora dos documentos salvos e do Desfazer/Refazer, e não alteram o texto dos membros. As imagens seguem o nível de detalhe selecionado; os ficheiros JSON e na nuvem retêm todos os membros.

Mantenha premido Ctrl/Cmd enquanto clica para selecionar um grupo. A barra de ferramentas de seleção compacta expõe Focar, Duplicar e Ligar novo quando aplicável; Mais ações de seleção contém Copiar seleção, Criar pacote e Eliminar seleção. Em dispositivos móveis, Editar detalhes ou Ver detalhes continua a abrir o inspetor. Duplicar seleção cria uma cópia deslocada; Copiar seleção e Colar podem transferir classes ou notas entre diagramas de classes quando o acesso à área de transferência do navegador está disponível. Uma cópia em memória suporta Colar dentro do espaço de trabalho. As cópias recebem novos IDs e nomes não utilizados, preservam os deslocamentos de grupo e as relações internas, e incluem um pacote apenas quando todas as suas classes são copiadas. Selecionar um pacote copia todos os seus membros. Um duplicado ou colar é um passo de anulação; os campos de texto mantêm o comportamento nativo de copiar/colar.

Adicionar notas e agrupar classes em pacotes

Nota — Adicionar um comentário cria uma nota e foca o texto da Nota no inspetor; uma nota de tela vazia diz Escreva uma nota…. Anexar nota a liga-a a uma classe ou relação com uma linha tracejada; a nota permanece onde foi colocada enquanto a linha segue o alvo. Eliminar o alvo desanexa a nota e mantém o seu texto. Notas longas são ajustadas numa pré-visualização delimitada; o texto completo permanece editável.

Pacote — Agrupar classes agrupa as classes selecionadas imediatamente. Sem nenhuma selecionada, escolha os membros e um nome de Pacote opcional e, em seguida, Criar pacote. Cada classe pertence no máximo a um pacote. Arraste o seu cabeçalho para mover os membros em conjunto, a menos que um membro esteja com a posição bloqueada. Desagrupar classes remove apenas a moldura. Utilize o chevron do cabeçalho ou o inspetor para colapsar um pacote numa contagem de classes com ligações externas. Localizar e Verificações expandem os pacotes para revelar os membros. Os pacotes continuam a ser grupos visuais, não espaços de nomes ou pontos de extremidade de relações semânticas. Colapsar é apenas para visualização: JSON/nuvem retêm todos os membros e ligações; as imagens correspondem à vista apresentada.

Ficheiros na nuvem, JSON portátil e imagens

Ficheiro → Exportar PlantUML pré-visualiza o código-fonte editável e oferece Copiar texto ou Transferir .puml. Exporta membros completos, tipos, estereótipos, cores, funções/navegação/multiplicidades, pacotes e notas localmente. O PlantUML escolhe o seu próprio esquema, pelo que as posições na tela, lados fixos, bloqueios de posição e vistas colapsadas não são exportados. Utilize JSON para preservar o diagrama editável completo. A importação de PlantUML não está disponível.

O Diagrama de classes não salva diagramas no armazenamento do navegador. Os novos diagramas permanecem na memória. Salvar (Ctrl/Cmd+S) inicia sessão quando necessário e cria ou atualiza um ficheiro na nuvem independente do diagrama de classes. Ficheiro → Abrir diagramas de classes abre a sua própria lista de ficheiros pesquisável. Ficheiro → Partilhar diagrama de classes controla o acesso público; os visualizadores podem inspecionar e exportar, mas não podem editar. Os diagramas não salvos emitem um aviso antes de sair ou recarregar. Transfira o JSON a partir de Ficheiro para manter uma cópia editável e utilize Importar JSON para reabrir um ficheiro de diagrama de classes Erd Go versão 1 exportado. As importações são validadas antes da substituição.

Vazio, Exemplo e Importar perguntam antes de substituir um diagrama não vazio e suportam Anular. Exportar diagrama oferece PNG, JPEG, WebP, SVG vetorial autónomo e PDF com imagem em fundo branco. Capture o diagrama completo (predefinição), incluindo classes fora do ecrã, ou a vista atual. As predefinições HD, 2K e 4K preservam as proporções até 8192px por lado e 16 megapíxeis; o SVG vetorial escala livremente. Guarde o JSON ou um ficheiro na nuvem para edição posterior do diagrama.

Notas e pacotes opcionais estendem o formato da versão 1 existente; os ficheiros mais antigos continuam a abrir sem eles. Os limites são de 200 classificadores, 600 relações, 100 notas de até 2000 carateres, 50 pacotes, 8000 carateres por compartimento de membro e um ficheiro JSON importado de 32 MB. Os nomes dos ficheiros na nuvem devem conter entre 3 e 255 carateres. Guarde na nuvem ou transfira o JSON antes de sair para reter um diagrama não guardado. Os rascunhos antigos locais do navegador permanecem inalterados e deixam de ser abertos automaticamente.

A geração de código-fonte, conversão de SQL e importação de texto para diagrama não estão disponíveis nesta ferramenta.

Atalhos de teclado

Atalhos de teclado
AçãoAtalho
Salvar na nuvemCtrl/Cmd+S. Inicie sessão se solicitado.
Encontrar uma classe, membro, pacote ou notaCtrl/Cmd+K, depois Seta para Cima/Baixo e Enter.
Copiar / Colar seleçãoCtrl/Cmd+C / Ctrl/Cmd+V a partir da tela. Colar requer um diagrama editável.
Duplicar seleçãoCtrl/Cmd+D a partir da tela.
Desfazer / RefazerCtrl/Cmd+Z / Ctrl/Cmd+Shift+Z ou Ctrl/Cmd+Y a partir da tela.
Eliminar seleçãoEliminar ou Backspace a partir da tela. Eliminar uma classe também remove as suas relações incidentes.
Escolha o lado do conectorFoque a cabeça de um conector selecionado e use uma tecla de seta.
Cancelar ou fecharEscape cancela um membro, formulário de classe ligada ou de pacote ou a pré-visualização da cabeça do conetor, fecha a Procura ou um menu, ou sai das ligações de Foco da tela.
Desfazer/Refazer mantém até 80 alterações do documento. Uma edição de texto focada ou o arrastar de um nó são agrupados; as alterações de câmara ficam fora do histórico. Os atalhos do canvas não eliminam elementos do diagrama enquanto edita um campo, usa um formulário ou abre um menu.

Resolver problemas no seu diagrama

Resolver problemas no seu diagrama
SintomaO que experimentar
Uma cabeça permanece num lado inesperadoVerifique se essa extremidade está Fixa. Escolha o seu controlo Automático para retomar o posicionamento automático.
Uma relação é rejeitadaVerifique os endpoints, duplicados exatos, auto-herança/realização e ciclos de herança. Atribua funções ou etiquetas diferentes a ligações estruturais distintas.
Um membro não pode ser salvarForneça os nomes/tipos necessários, remova nomes de parâmetros ou assinaturas de membros duplicados e reveja a mensagem de validação. Utilize Texto para notação personalizada não suportada.
Um formulário indica que os membros mudaramCancele e reabra após Anular ou outra edição de texto para utilizar a versão atual do membro.
Uma classe ou membro está fora de vistaUtilize Encontrar ou Ctrl/Cmd+K. Os resultados dos membros revelam detalhes completos e focam a secção correspondente do inspetor; Ajustar diagrama e o minimapa também ajudam.
Um ficheiro não pode ser importadoEscolha um ficheiro JSON de diagrama de classes Erd Go exportado, não SQL, um ficheiro do Construtor, SVG ou um plano de modelação. O seu diagrama atual é mantido em caso de erro.
Falha ao salvar na nuvemMantenha o diagrama aberto, verifique o seu início de sessão e ligação, e depois tente novamente. Descarregue o JSON antes de sair da página para manter uma cópia de segurança editável.

Planeie um modelo de classes com IA

Utilize o Copy AI Prompt para partilhar este guia com o seu assistente e, em seguida, descreva responsabilidades, propriedade, herança e multiplicidades. Peça esclarecimentos sempre que os requisitos deixem um relacionamento ambíguo.

Solicite nomes de classificadores, assinaturas de membros e uma lista de relacionamentos com funções De e Para explícitas. Construa o resultado utilizando a Biblioteca visual e o inspetor. O plano seguinte é descritivo, não uma linguagem de importação.

Modeling plan / Plano de modelação UML
Class Customer
  Attribute: - id: UUID
  Operation: + placeOrder(items: List<OrderItem>): Order

Class Order
  Operation: + calculateTotal(): Decimal

Association: Customer → Order
  Label: places
  Customer end: 1
  Order end: 0..*