03 - Diagramas C4

El modelo C4 describe la arquitectura de un sistema en cuatro niveles: Contexto, Contenedores, Componentes y Código. Cada nivel responde a una pregunta distinta y tiene distinta audiencia.

Los tres primeros son los más usados; el nivel de código es esencialmente el diagrama de clases del tema anterior.

• Persona: usuario del sistema.
• Sistema de software: el conjunto completo; en el nivel de contexto es la caja mayor.
• Contenedor: unidad ejecutable o almacén de datos: aplicación web, API, base de datos, cola de mensajes.
• Componente: módulo con responsabilidad dentro de un contenedor.
• Relación: conecta elementos, normalmente con su tecnología y protocolo (HTTP, JDBC…).

@startuml
!include <C4/C4_Context>

Person(student, "Estudiante", "Consulta el catálogo")
System(biblioteca, "Sistema de biblioteca", "Gestiona libros y préstamos")

Rel(student, biblioteca, "Usa", "HTTPS")
@enduml

El nivel de contexto no entra en detalles internos: solo muestra el sistema, sus usuarios y los sistemas externos con los que habla.

@startuml
!include <C4/C4_Container>

Person(student, "Estudiante", "Consulta el catálogo")
System_Boundary(c1, "Sistema de biblioteca") {
  Container(spa, "Aplicación web", "TypeScript", "Interfaz del usuario")
  Container(api, "API REST", "Java, Spring Boot", "Expone la lógica")
  ContainerDb(db, "Base de datos", "MariaDB", "Guarda libros y préstamos")
}

Rel(student, spa, "Usa", "HTTPS")
Rel(spa, api, "Llama a", "HTTPS/JSON")
Rel(api, db, "Lee y escribe", "JDBC")
@enduml

Aquí aparecen las tecnologías y los protocolos. Para el monolito por capas que se construye en 1.º, el diagrama de contenedores muestra aplicación, API y base de datos.

@startuml
!include <C4/C4_Component>

Component(ctrl, "Controller", "Recibe peticiones HTTP")
Component(svc, "Service", "Reglas de negocio")
Component(repo, "Repository", "Acceso a datos")

Rel(ctrl, svc, "invoca")
Rel(svc, repo, "usa")
@enduml

El nivel de componentes muestra la organización interna de un contenedor, por ejemplo las capas del monolito.