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
clientesAPIGatewayAPIGatewayAPIGatewayAPI GatewayPedidosPedidosPedidosPedidosRepartidoresRepartidoresRepartidoresRepartidoresPagosPagosPagosPagospedidosubicacionespagosControladorControladorControladorControladorServicioServicioServicioServicioRepositorioRepositorioRepositorioRepositorioCliente depagosCliente depagosCliente depagosCliente de pagosEl HLD decidequé servicios hay y de qué es dueño cada unollamada o evento entre ellosqué almacén para cada datocómo escala y cómo fallaPedidoCreadoclave-valorSQLDecisiones de este nivelPedidos → Repartidoresevento, no llamadapagosSQL: transaccionesubicacionesclave-valor: 40.000 escrituras/scada una descarta una alternativa · cifras de ejemplootro servicioentrada HTTPíndice (user_id, created_at)máquina de estadosEstados del pedidocreado → pagado → en cocina → en camino → entregadocancelar: solo si está creado o pagadoen cocina → cancelado: no permitidoun reintento repite la misma clave de idempotenciael contratoLo que Pedidos prometePOST /orders { items, address }Idempotency-Key: 9c1e…201 { order_id, status: "created" }evento PedidoCreado { order_id, items }inmersióninmersiónUna sesión de diseño1. requisitos¿qué debe hacer?2. estimaciones¿cuánto de cada cosa?3. API y modelo de datos4. diseño de alto nivel5. inmersionesLLD donde hay riesgo6. fallos y compromisosHLD frente a LLDHLDLLDzoomsistema enteroun componentepiezasservicios, almacenesclases, tablas, estadosdecidequién habla con quiéncómo funciona cada piezacambiapoco, con acuerdoa menudo, en un equipo
  • 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.

Aprenderás

  • Qué se decide en el diseño de alto nivel
  • Qué se decide en el diseño de bajo nivel
  • Contratos: la frontera entre los dos
  • Cómo pasar de un nivel a otro al diseñar