Arquitectura

Plantilla: Diagrama de contenedores C4

Personas, apps web y móvil, API, base de datos y sistemas externos

Usar esta plantilla Todas las plantillas

Vista previa de la plantilla Diagrama de contenedores C4

Qué incluye

Nodos: 10
Packs: Modelo C4
Categoría: Arquitectura

Funciona en el plan Free: 15 nodos de diagrama + 150 notas, textos, pegatinas y temas de mapa mental por diagrama.

El modelo C4 describe el software en cuatro niveles: contexto, contenedores, componentes y código. Esta plantilla es el nivel 2, el diagrama de contenedores: un cliente usa una aplicación web y una app móvil, ambas llaman a una aplicación API, y la API lee y escribe una base de datos de pedidos y publica eventos en un broker de mensajes.

Un worker de pedidos consume esos eventos y envía confirmaciones a través de un servicio de correo externo, mientras la API cobra con tarjeta mediante un proveedor de pagos externo. Cada contenedor muestra su tecnología y una frase sobre su función, las relaciones dicen qué ocurre y por qué protocolo, y el límite del sistema separa lo que construyes de lo que usas.

Cuándo usarla

Explicar las piezas de un sistema a nuevos desarrolladores, product managers o revisores de seguridad.
Decidir dónde va una funcionalidad nueva antes de dividir o unir servicios.
Documentar una decisión de arquitectura con un dibujo que coincida con la estructura del código.
Preparar la vista de contenedores que va entre el diagrama de contexto y los diagramas de componentes.

Cómo usarla

Renombra el límite del sistema y los contenedores, y escribe una frase sobre la responsabilidad de cada contenedor.
Indica la tecnología de cada contenedor y el protocolo de cada relación, por ejemplo JSON sobre HTTPS o SQL.
Añade las personas y los sistemas externos de los que dependen tus usuarios e integraciones, y quita lo que no tengas.
Comparte un enlace con el equipo o exporta el diagrama para el documento de arquitectura, y guarda una versión cuando cambien los contenedores.

Preguntas

¿Qué es un contenedor en el modelo C4?

Un contenedor es algo que ejecuta código o guarda datos por sí mismo: una aplicación web, una app móvil, una API, una base de datos, un broker de mensajes o un worker en segundo plano. No es lo mismo que un contenedor de Docker, aunque un contenedor C4 a menudo se despliega como uno.

¿Puedo dibujar también los demás niveles de C4?

Sí. El pack C4 incluye personas, sistemas de software, contenedores, componentes, bases de datos, límites de sistema y de contenedor y nodos de despliegue, así que puedes dibujar diagramas de contexto, contenedores, componentes y despliegue en el mismo lienzo.

¿Puedo generar un diagrama C4 a partir de texto?

No desde Structurizr DSL ni desde la sintaxis C4 de Mermaid. Empieza con esta plantilla, o conecta tu agente de IA a Archboard por MCP y describe los contenedores: el agente los dibuja en tu lienzo y tú editas el resultado.