Plantilla C4 para documentar arquitecturas de empresa
Plantilla práctica para representar contexto y contenedores con C4, acordar límites, interfaces y responsables y mantener diagramas útiles para el equipo.
Un diagrama debe responder una pregunta concreta
Los diagramas de arquitectura pierden utilidad cuando mezclan niveles de detalle, no identifican sus relaciones o quedan sin propietario. El modelo C4 ayuda a comunicar un sistema con distintos niveles de aproximación: contexto, contenedores, componentes y código. No es necesario producir los cuatro para cada solución: el contexto y los contenedores suelen bastar para alinear a negocio, arquitectura y operaciones.
El modelo es independiente de la herramienta y de la notación gráfica. Lo importante es que las personas, sistemas, límites y relaciones puedan interpretarse sin que quien dibujó el esquema tenga que explicarlo en directo. Consulta la descripción oficial de los diagramas C4 y sus abstracciones.
Ficha reutilizable por diagrama
Completa estos campos antes de abrir la herramienta de dibujo:
| Campo | Contenido que debe quedar claro |
|---|---|
| Propósito | Decisión, conversación o revisión que apoya el diagrama |
| Audiencia | Dirección, producto, desarrollo, seguridad u operaciones |
| Alcance | Sistema incluido, límites y elementos deliberadamente excluidos |
| Nivel C4 | Contexto, contenedores, componentes o código |
| Elementos | Nombre, tipo, responsabilidad y tecnología cuando proceda |
| Relaciones | Dirección, protocolo o mecanismo y finalidad del intercambio |
| Supuestos | Límites de confianza, dependencias externas y cuestiones abiertas |
| Mantenimiento | Persona propietaria, repositorio y evento que obliga a revisarlo |
Secuencia de elaboración
- Contexto: identifica usuarios y sistemas externos que interactúan con el producto. Explica qué problema resuelve y quién utiliza cada relación.
- Contenedores: separa aplicaciones, servicios y almacenes de datos que se despliegan o ejecutan de forma diferenciada. Etiqueta tecnología y comunicación.
- Componentes, si aportan valor: descompón un contenedor cuando la conversación requiera entender responsabilidades internas. Evita crear diagramas que repitan código sin ayudar a decidir.
- Vistas complementarias: usa diagramas de despliegue para infraestructura y de dinámica para una interacción relevante, manteniendo cada vista acotada.
- Revisión: pide a alguien que no participó en el dibujo que explique el flujo y los límites usando solo el esquema y su leyenda.
Ejemplo ilustrativo
Para un portal de proveedores, el contexto puede mostrar a la persona usuaria, el portal, el proveedor de identidad y el ERP. El diagrama de contenedores puede detallar la interfaz web, la API, el almacén de documentos y la integración ERP. Es un ejemplo genérico, no una arquitectura de cliente de FORGENEX SOLUTIONS S.L.U.
Control antes de publicar
- El título indica el tipo de vista y el sistema que cubre.
- Cada caja tiene nombre y responsabilidad comprensibles.
- Las flechas muestran dirección y una relación explícita, no solo “usa”.
- Los acrónimos, colores y límites de confianza tienen una leyenda.
- La fecha, el propietario y el repositorio de la fuente editable están visibles.
- El equipo sabe qué cambio de arquitectura requiere actualizar el esquema.
Puedes complementar esta plantilla con la plantilla ADR para decisiones de arquitectura y el mapa de dependencias de servicios TI.