Diagramas de Diseño
Crea diagramas que salvan incidentes, no que decoran paredes
Guía práctica para crear diagramas de sistemas que se consultan, se mantienen y salvan incidentes. Niveles de zoom, diagram as code y checklist.
Lo que Descubrirás Dentro
No es teoría abstracta, son soluciones directas a problemas que seguro has enfrentado.
Valor vs decoración
Señales de alerta
La mayoria de diagramas no estan diseñados para ser utiles. Señales: nadie lo abre en un mes, solo lo entiende quien lo creó, esta desactualizado.
Que incluir
Actores, componentes, flujos
Actores y puntos de entrada, componentes con nombres de dominio (no tecnología), flujos con dirección y protocolo, persistencia con rol, boundaries de equipo/red/dominio.
Niveles de zoom
Un diagrama, una pregunta
Nivel 1: Contexto (vista de pajaro). Nivel 2: Contenedores (componentes principales). Nivel 3: Internos (zoom a un servicio). Nivel 4: Flujo (secuencia o actividad).
Más que un PDF: Herramientas para la Acción
He incluido estos recursos extra para que pases del conocimiento a la implementación hoy mismo.
Diagram as code
Mermaid en el repo:
Para incidentes
Lo que salva a las 3 AM:
Why do I share this for free?
Elevate the industry
The more engineers build better software, the better the industry is for everyone.
Share knowledge
I've learned a lot from the community. This is my way of giving back what I've received.
Real impact
I'm more motivated by contributing to many teams than focusing on just one.
"The best code I've ever written is the code that helped other engineers write better code."
— Emilio Carrión