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.
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:
| Servicio | Lo usé para | Por qué no los otros dos ahí |
|---|---|---|
| SNS | Publicar "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 |
| SQS | Cola por país, para procesar la cita sin perderla si el consumidor cae | SNS no retiene el mensaje si nadie está escuchando en ese instante |
| EventBridge | Enrutar "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é: