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:
¿Por qué comparto esto gratis?
Elevar la industria
Cuantos más ingenieros construyan mejor software, mejor será la industria para todos.
Compartir conocimiento
He aprendido mucho de la comunidad. Es mi forma de devolver lo que he recibido.
Impacto real
Me motiva más aportar mi granito de arena a muchos equipos que centrarme solo en uno.
"El mejor código que he escrito es el que ha ayudado a otros ingenieros a escribir mejor código."
— Emilio Carrión