HLD y LLD
- Lección 37 de 40
- 8 min
- Inicial
- 8 pasos
Diseñar un sistema es mirar a dos distancias: el mapa completo de piezas y conexiones, y el código y las tablas de cada pieza. Saber en cuál estás te ahorra perder el tiempo en la equivocada.
- Nivel de zoom
- todo el sistema
- Piezas
- servicios y datos
- Entregable
- mapa del sistema
- petición
- respuesta
- evento
Paso 1 de 8
Concepto
Un sistema, dos distancias
Piensa en una app de comida a domicilio. Vista de lejos son tres servicios, Pedidos, Repartidores y Pagos, cada uno con sus propios datos, detrás de un API Gateway y avisándose con eventos.
Vista de cerca, cada uno de esos bloques es un programa entero, con clases, tablas y reglas. Al primer nivel se le llama diseño de alto nivel (HLD) y al segundo, diseño de bajo nivel (LLD).
Paso 2 de 8
Técnica
HLD: el mapa del sistema
El HLD responde qué piezas hay y cómo se conectan: qué servicios existen y de qué datos es dueño cada uno, si se hablan con una llamada o con un evento, en qué tipo de almacén vive cada dato y qué pasa cuando crece el tráfico o algo se cae.
Es el nivel en el que trabajaron todas las lecciones anteriores. Su resultado es un diagrama como este, acompañado de las razones de cada decisión.
Qué cambió
- La unidad de diseño es el sistema entero
Paso 3 de 8
Compromiso
Cada flecha es una decisión
Hacer un pedido no debería esperar a que aparezca un repartidor. Por eso Pedidos publica el evento PedidoCreado y Repartidores lo procesa a su ritmo, como viste en Pub/Sub y eventos.
Pagos necesita transacciones, así que usa una base de datos relacional. Las ubicaciones son otra historia: en el ejemplo, 200.000 repartidores activos mandan su posición cada 5 s, es decir 40.000 escrituras/s, y cada una reemplaza a la anterior. Para eso conviene un almacén clave-valor rápido. Las cifras son de ejemplo.
Qué cambió
- Pedidos → Repartidores: evento en vez de llamada
- Pagos en SQL, ubicaciones en clave-valor
Paso 4 de 8
Solución
LLD: lo que hay dentro de un bloque
Ahora abrimos el servicio de Pedidos. El LLD decide cómo está construido un componente: sus módulos o clases, las interfaces entre ellos, sus tablas e índices, sus algoritmos y cómo maneja los errores.
Aquí un controlador recibe las peticiones HTTP, el servicio de pedidos aplica las reglas de negocio, un repositorio habla con la base de datos y un cliente de pagos envuelve las llamadas al servicio de Pagos.
Qué cambió
- El resto del sistema
- Dentro de Pedidos: controlador, servicio, repositorio y cliente de pagos
Paso 5 de 8
Técnica
Estados, tablas y casos raros
Un pedido pasa por varios estados y el LLD fija qué cambios están permitidos: se puede cancelar mientras está creado o pagado, pero no cuando la cocina ya empezó.
También define la tabla (columnas, tipos y un índice sobre (user_id, created_at) para listar «mis pedidos» del más reciente al más antiguo) y los casos incómodos: ¿qué pasa si la llamada a Pagos se queda sin respuesta, o si el mismo pedido llega dos veces?
Qué cambió
- Máquina de estados del pedido
- Tabla e índice de pedidos
- Clave de idempotencia en POST /orders
Paso 6 de 8
Concepto
Donde se tocan: los contratos
Los dos niveles se encuentran en el borde de cada bloque. El HLD fija lo que un componente promete: su API y los eventos que publica. El LLD decide cómo cumple esa promesa.
Esa separación permite que los equipos avancen sin pisarse: Pedidos puede reescribir todo lo que tiene dentro mientras POST /orders y PedidoCreado sigan significando lo mismo.
Qué cambió
- El contrato en el borde del servicio
Paso 7 de 8
Compromiso
El error de diseñar en el nivel equivocado
En una entrevista te piden diseñar esta app. Una persona dedica veinte minutos a diagramas de clases y nunca menciona las 40.000 escrituras de ubicación por segundo. Otra dibuja un mapa impecable, pero no sabe explicar cómo se evita cobrar dos veces un pedido.
Trabaja de arriba abajo: requisitos, cálculos aproximados y el HLD; después baja al nivel de LLD solo en uno o dos puntos donde está lo difícil.
Qué cambió
- De vuelta al sistema completo
- Inmersiones: ubicaciones y cobros duplicados
Paso 8 de 8
Resumen
Resumen
HLD: el sistema entero. Decide qué servicios, almacenes y colas hay, quién habla con quién y dónde vive cada dato. Cambia poco y con acuerdo entre equipos.
LLD: un componente por dentro. Decide clases, tablas, índices, estados y manejo de errores. Cambia a menudo, dentro de un equipo.
Los contratos (API y eventos) son la frontera: el HLD los fija y el LLD los cumple.
Diseña de arriba abajo y baja al LLD solo donde una decisión lo exige. El diseño orientado a objetos y los patrones de diseño son un tema aparte.
← → paso · R repetir · Espacio pausa
Aprenderás
- Qué se decide en el diseño de alto nivel (visto)
- Qué se decide en el diseño de bajo nivel (visto)
- Contratos: la frontera entre los dos (visto)
- Cómo pasar de un nivel a otro al diseñar (visto)