Introducción

Los diagramas de clases de PlantUML describen la estructura estática de un sistema: sus clases, atributos, operaciones y relaciones. Escribes una especificación en texto y la renderizas como un diagrama, lo que hace que la fuente sea fácil de editar y mantener bajo control de versiones.
1. Un diagrama mínimo
Un diagrama de clases comienza con @startuml y termina con @enduml:

@startuml
class User
class Order
User --> Order : places
@enduml
PlantUML puede inferir clases a partir de declaraciones de relaciones, pero declararlas explícitamente hace que los diagramas más grandes sean más fáciles de escanear y mantener.
2. Clases, atributos y métodos
Coloca los atributos y operaciones entre llaves. Dos puntos separan el nombre de un miembro de su tipo; los paréntesis marcan una operación.

@startuml
class User {
-id: int
-email: String
+login(password: String): boolean
+logout(): void
}
@enduml
Los marcadores de visibilidad son:
-
+público -
-privado -
#protegido -
~package-private
También puedes escribir el tipo antes del nombre del miembro, por ejemplo, +String email o +void logout(). PlantUML admite tanto la notación de miembros similar al código familiar como estos marcadores de visibilidad.
Miembros estáticos y abstractos
Usa {static} o {classifier} para miembros estáticos y {abstract} para miembros abstractos:

@startuml
class abstract PaymentMethod {
{abstract} +authorize(amount: Decimal): boolean
{static} +supportedCurrencies: String[]
}
class CardPayment {
+authorize(amount: Decimal): boolean
}
PaymentMethod <|-- CardPayment
@enduml
Una clase abstracta también puede declararse con clase abstracta.
3. Relaciones
La forma de la flecha indica el tipo de relación. La dirección de la línea se elige según el orden de los nombres; utilice etiquetas para aclarar su significado.
| Relación | Notación de PlantUML | Significado típico |
|---|---|---|
| Herencia / generalización | `Parent < | — Child` |
| Realización de interfaz | `Interface < | .. Class` |
| Composición | Todo *-- Parte |
El ciclo de vida de la parte es propiedad del todo |
| Agregación | Todo o-- Parte |
El todo agrupa o se refiere a partes que pueden existir de forma independiente |
| Asociación dirigida | A --> B |
A tiene una relación navegable hacia B |
| Dependencia | A ..> B |
A utiliza o depende de B |
Estas son las notaciones estándar de relaciones de PlantUML.

@startuml
interface Repository
class SqlRepository
class OrderService
class Order
class OrderLine
Repository <|.. SqlRepository
OrderService ..> Repository : usa
Order *-- "1..*" OrderLine : contiene
@enduml
Elija con cuidado: La composición y la agregación expresan diferentes semánticas de ciclo de vida. Use la composición solo cuando la parte sea significativamente poseída por el todo; use una asociación simple cuando ninguna interpretación de propiedad encaje.
4. Multiplicidad, nombres de rol y etiquetas
La multiplicidad especifica cuántos objetos pueden participar en cada extremo de una asociación. Las formas comunes incluyen "1", "0..1", "*", y "1..*".

@startuml
class Cliente
class Pedido
Cliente "1" --> "0..*" Pedido : realiza
@enduml
Aquí, cada Pedido está asociado con un Cliente, mientras que un Cliente puede realizar cero o más pedidos. Lea las multiplicidades desde el extremo opuesto: el número cerca de “Pedido describe cuántos pedidos pueden asociarse con un cliente.
Para mayor precisión, agregue nombres de roles o restricciones:

@startuml
class Equipo
class Jugador
Equipo "1" o-- "0..*" Jugador : miembros
nota en el enlace
Un jugador puede transferirse entre equipos.
end note
@enduml
5. Interfaces, enumeraciones, estereotipos y paquetes
PlantUML soporta declaraciones como interfaz, enumeración, clase abstracta, y estereotipos escritos entre << y >>.

@startuml
paquete "Pedidos" {
interface PasarelaDePago {
+cobrar(monto: Decimal): ResultadoDePago
}
enum EstadoPedido {
NUEVO
PAGADO
CANCELADO
}
class Pedido <<Entidad>> {
+id: UUID
+estado: EstadoPedido
}
class ServicioDeCobro <<Servicio>> {
+cobrar(pedido: Pedido): ResultadoDePago
}
ServicioDeCobro ..> PasarelaDePago : llama
Pedido --> EstadoPedido
}
@enduml
Los paquetes agrupan visualmente tipos relacionados. Utilicen estereotipos como “<<Entidad>> o “<<Servicio>>cuando aportan contexto útil; eviten añadir etiquetas que simplemente repitan lo que el nombre de la clase ya indica.
6. Notas, alias y diseño
Las notas pueden explicar decisiones de diseño o aclarar una restricción sin sobrecargar los nombres de las clases. Los alias son útiles cuando un nombre mostrado contiene espacios o puntuación.

@startuml
class "API de Pago Externa" as PaymentApi
class CheckoutService
CheckoutService ..> PaymentApi : envía el pago
note right of CheckoutService
Reintenta fallos transitorios.
No reintenta pagos rechazados.
end note
dirección de izquierda a derecha
@enduml
dirección de izquierda a derecha cambia la dirección general del diseño; el valor predeterminado es de arriba a abajo. También puede utilizar direcciones de relación como “-left-> o “-up-|> para guiar la colocación local.
7. Un ejemplo más completo
Este ejemplo combina visibilidad, tipos, métodos, enumeraciones, multiplicidades, composición y dependencia:

@startuml
dirección de izquierda a derecha
paquete "Ventas" {
class Cliente {
-id: UUID
+nombre: String
+realizarPedido(): Pedido
}
class Pedido {
-id: UUID
-estado: EstadoPedido
+agregarLinea(producto: Producto, cantidad: int): void
+total(): Decimal
}
class LineaPedido {
-cantidad: int
+totalLinea(): Decimal
}
class Producto {
+sku: String
+precio: Decimal
}
enum EstadoPedido {
NUEVO
PAGADO
CANCELADO
}
interface PasarelaPago {
+cobrar(monto: Decimal): ResultadoPago
}
class ServicioCobro {
+cobrar(pedido: Pedido): ResultadoPago
}
Cliente "1" --> "0..*" Pedido : realiza
Pedido *-- "1..*" LineaPedido : contiene
LineaPedido "*" --> "1" Producto : refiere a
Pedido --> EstadoPedido
ServicioCobro ..> PasarelaPago : utiliza
}
@enduml
8. Herramientas: Visual Paradigm VPasCode
VPasCode es un editor de texto a diagramas basado en navegador de Visual Paradigm. Soporta diagramas de clases PlantUML y proporciona un editor de código con vista previa en vivo, para que puedas escribir o pegar PlantUML e inspeccionar el resultado renderizado mientras trabajas.

Un flujo de trabajo típico:
-
Abre VPasCode y selecciona el editor PlantUML o un ejemplo de PlantUML.
-
Reemplaza el texto inicial con tu diagrama, incluyendo
@startumly@enduml. -
Revisa la vista previa en vivo; si el renderizado falla, inspecciona el error de sintaxis resaltado y su línea.
-
Refina el diagrama y, luego, expórtalo o compártelo según sea necesario. VPasCode describe las opciones de exportación en SVG, PNG y PDF.
VPasCode también ofrece una interfaz de selección de temas para PlantUML, incluidos los temas Visual Paradigm y Rose. Para obtener resultados consistentes en un equipo, mantén la fuente de PlantUML junto con tu documentación o código en lugar de depender únicamente de una imagen exportada.
9. Errores comunes y buenas prácticas

-
No confundas una asociación con una dependencia.Una dependencia generalmente significa “usa”; una asociación a menudo representa una relación estructural más persistente.
-
Evita el uso excesivo de composición.Establece una afirmación más fuerte sobre el ciclo de vida que una simple conexión.
-
Etiqueta las multiplicidades desde el extremo opuesto.El número junto a una clase indica cuántas instancias de esa clase pueden relacionarse con una instancia en el otro extremo.
-
Mantén los diagramas enfocados.Divide un modelo muy grande en paquetes o diagramas separados para preocupaciones distintas.
-
Muestra los detalles que sirven a la audiencia.Una visión general conceptual puede necesitar solo nombres de clases y relaciones; un diagrama a nivel de diseño puede necesitar tipos, visibilidad y operaciones.
-
Trata la fuente como el artefacto mantenido.Revisa los cambios en el texto, renderiza después de las ediciones y regenera las exportaciones cuando la fuente cambie.
Referencia rápida

@startuml
class A {
+publicField: String
-privateField: int
#protectedMethod(): void
~packageMember(): boolean
}
interface I
abstract class Base
enum State { READY; DONE }
Base <|-- A
I <|.. A
A *-- B : composición
A o-- C : agregación
A --> D : asociación
A ..> I : dependencia
@enduml
PlantUML admite características adicionales de diagramas de clases, incluida la agrupación de miembros, notas, colores y más, cuando un diagrama requiere un refinamiento adicional.










