Saltar al contenido
devjose↗FRONTEND ENGINEER · LIMA, PE
TrabajoSobre míExperienciaBlogHablemos
Inicio/Blog

DESARROLLO FRONTEND

Arquitectura por eventos en AWS: lo que aprendí armando un sistema de agendamiento

Cómo combiné SNS, SQS y EventBridge con Lambda y DynamoDB en un reto técnico de agendamiento por eventos, y el error de idempotencia que casi me cuesta caro.

Por José Manrique · 29 de julio de 2026

TL;DR
Armé un sistema de agendamiento de citas con NestJS sobre Lambda, DynamoDB como persistencia y SNS + SQS + EventBridge para desacoplar el flujo. La parte difícil no fue levantar cada servicio: fue decidir cuál mensajería usar en cada punto y no perder eventos cuando algo falla a la mitad.

El problema que tenía que resolver

El reto técnico simulaba el agendamiento de citas médicas de una aseguradora: el alumno pide una cita, el sistema la valida según el país, la guarda y notifica a otro proceso que la completa de forma asíncrona. Nada de eso necesitaba una respuesta inmediata al usuario más allá de "tu cita quedó en proceso", así que era un caso natural para arquitectura por eventos en vez de llamadas síncronas encadenadas.

Por qué tres servicios de mensajería y no uno solo

La tentación al inicio es meter todo en SQS porque es el más simple de entender. Terminé usando los tres, cada uno donde resolvía un problema distinto:

ServicioLo usé paraPor qué no los otros dos ahí
SNSPublicar "cita creada" hacia varios países (fan-out)SQS es un solo consumidor por mensaje; EventBridge era más de lo que necesitaba para un fan-out simple
SQSCola por país, para procesar la cita sin perderla si el consumidor caeSNS no retiene el mensaje si nadie está escuchando en ese instante
EventBridgeEnrutar "cita completada" hacia procesos que no conocía de antemano (auditoría, métricas)SNS obliga a conocer los suscriptores al momento de publicar; EventBridge permite reglas nuevas sin tocar el publisher

Idempotencia: el detalle que casi me costó caro

SQS garantiza entrega al menos una vez, no exactamente una vez. La primera versión de mi consumer guardaba la cita directo en DynamoDB sin verificar si ese appointmentId ya existía. Con una redelivery por timeout terminé con citas duplicadas en las pruebas de carga. La corrección fue simple pero fácil de olvidar:

export const handler = async (event: SQSEvent) => {
  for (const record of event.Records) {
    const appointment = JSON.parse(record.body)

    const existing = await dynamo.get({
      TableName: 'appointments',
      Key: { id: appointment.id },
    }).promise()

    if (existing.Item) {
      continue // ya procesado, evita duplicar por redelivery
    }

    await dynamo.put({
      TableName: 'appointments',
      Item: { ...appointment, status: 'processed' },
    }).promise()
  }
}

Dead-letter queue para no perder nada

Configuré una DLQ por cola con un máximo de tres reintentos. Sin eso, un mensaje mal formado (por ejemplo un país sin handler todavía) se reintentaba indefinidamente y ensuciaba las métricas de la cola principal, ocultando errores reales de otros mensajes.

functions:
  processAppointment:
    handler: src/handlers/process-appointment.handler
    events:
      - sqs:
          arn: !GetAtt AppointmentQueue.Arn
          batchSize: 5

resources:
  Resources:
    AppointmentQueue:
      Type: AWS::SQS::Queue
      Properties:
        RedrivePolicy:
          deadLetterTargetArn: !GetAtt AppointmentDLQ.Arn
          maxReceiveCount: 3
    AppointmentDLQ:
      Type: AWS::SQS::Queue

Lo que me llevo para un caso real

  • Diseña primero el contrato del evento (qué campos lleva, qué es obligatorio), antes de elegir el servicio de mensajería
  • Si un consumer puede recibir el mismo mensaje dos veces, la idempotencia no es opcional
  • DynamoDB con partition key por país me dio consultas rápidas sin necesidad de un índice secundario para el caso de uso principal

¿Cómo resolviste tú la idempotencia en un consumer de SQS? Siempre hay un caso borde que no vi.


Recursos que usé:

  • Arquitecturas basadas en eventos con Lambda
  • AWS Serverless Application Model

Sigue leyendo

Construir un asistente educativo con AWS Bedrock Agents: lo que aprendí con Unibot ↗NestJS en un producto fintech multi-tenant: arquitectura hexagonal, CQRS y CASL ↗Todos los artículos
devjose↗

© 2026 José Manrique

BlogGitHub LinkedIn PrivacidadTérminosArriba ↑