Bienvenido a Módulo 1 del curso de aprendizaje del modelo C4 — el punto de partida esencial donde construimos una comprensión sólida de por qué existe este enfoque y cómo cambia fundamentalmente la forma en que los equipos visualizan y comunican la arquitectura de software.
El modelo C4, creado por Simon Brown entre 2006 y 2011, es un método ligero, amigable para desarrolladores y jerárquico para visualizar la arquitectura de software. Proporciona un conjunto sencillo pero potente de abstracciones y tipos de diagramas que te permiten crear diagramas claros, coherentes y adecuados para el público objetivo — sin la complejidad ni la rigidez del UML completo o bocetos ad hoc de “cajas y líneas”.
En su esencia, el modelo C4 aborda un problema común en los equipos de software: la documentación de arquitectura suele estar ausente, inconsistente, desactualizada, abrumadora o no comunica eficazmente con diferentes audiencias (desde ejecutivos y gestores de producto hasta desarrolladores y equipos de operaciones). Los enfoques tradicionales suelen sufrir el problema del “lienzo en blanco” — las personas empiezan a dibujar sin estructura, lo que lleva a diagramas ambiguos, difíciles de mantener o excesivamente llenos. El modelo C4 corrige esto ofreciendo:
- Una clara jerarquía de abstraccionesque te permite “acercar” desde la visión general hasta los detalles finos
- Solo un pequeño conjunto de elementos principales (Persona, Sistema de software, Contenedor, Componente y Relaciones)
- Independencia de notación — utiliza cualquier estilo de cajas/líneas (bocetos simples, PlantUML, Draw.io, Miro, etc.)
- Independencia de herramientas — desde pizarras hasta soluciones basadas en código como Structurizr o C4-PlantUML
- Énfasis en la comunicación y la comprensión sobre la documentación exhaustiva
Los cuatro niveles fundamentales (el «C4»)
El modelo se basa en cuatro niveles progresivos de detalle:
- Nivel 1: Contexto del sistema — La vista de nivel más alto, de conjunto. Su sistema de software completo se muestra como una sola caja, rodeada por sus usuarios (Personas) y los sistemas externos con los que interactúa. Ideal para partes interesadas no técnicas y para la incorporación.
- Nivel 2: Contenedores — Se acerca al interior del sistema de software para revelar los principales bloques constructivos desplegables/ejecutables (aplicaciones web, aplicaciones móviles, APIs, bases de datos, colas de mensajes, etc.). Destaca las tecnologías elegidas y las interacciones entre contenedores.
- Nivel 3: Componentes — Se acerca a un solo contenedor para mostrar sus módulos lógicos internos, servicios, bibliotecas o subsistemas — centrándose en responsabilidades e interfaces sin profundizar en el código.
- Nivel 4: Código — El nivel más granular, que muestra detalles de implementación (por ejemplo, diagramas de clases UML, diagramas ERD o la estructura real del código). Se utiliza de forma selectiva cuando se necesita claridad técnica profunda.
Vistas de apoyo
Además de la jerarquía principal, el modelo C4 define tres tipos de diagramas complementarios para perspectivas más amplias o especializadas:
- Mapa del sistema — Una vista ampliada a nivel empresarial que muestra múltiples sistemas de software y sus relaciones de alto nivel a través de la organización.
- Dinámico — Diagramas enfocados en el tiempo de ejecución que ilustran cómo interactúan los elementos en escenarios o casos de uso específicos (similares a diagramas de secuencia simplificados).
- Despliegue — Asigna contenedores a la infraestructura (servidores, regiones en la nube, redes, clústeres de Kubernetes, etc.), conectando la arquitectura lógica con el tiempo de ejecución físico.
Al final de este módulo, comprenderá por qué el modelo C4 ha sido ampliamente adoptado por miles de equipos en todo el mundo: porque es práctico, escalable, mantenible y se centra en contar la historia adecuada a la audiencia adecuada, al nivel de detalle adecuado.
Esta fundación te prepara perfectamente para los módulos prácticos que vienen, comenzando con la creación de tu primer Diagrama de contexto del sistema en el módulo 2.
Comencemos a construir tu conocimiento en C4 — una capa clara y ampliable a la vez!