Events

Este documento detalla los mecanismos de mensajería utilizados en el microservicio de Asignación de Ubicaciones, incluyendo el propósito de cada evento, el formato de los mensajes y cómo se manejan los errores o reintentos.

Visión General

El microservicio de Asignación de Ubicaciones utiliza una arquitectura basada en eventos para notificar a otros servicios sobre cambios en las asignaciones. La implementación actual registra eventos pero está diseñada para extenderse y utilizar AWS Simple Notification Service (SNS) para implementar un patrón de publicador/suscriptor.

SNS

Evento de Asignación Creada

Nombre: assignment-created-event

ARN en Producción:

arn:aws:sns:us-east-1:123456789012:assignment-created-event

ARN en Staging:

arn:aws:sns:us-east-2:123456789012:assignment-created-event

Propósito: Notificar a otros servicios cuando se crea una nueva asignación de ubicación.

Productores:

• Caso de uso Create a través del observador AssignmentCreatedEmitter y el despachador SnsAssignmentEventDispatcher

Formato del Mensaje:

interface AssignmentCreatedEvent {
  type: 'AssignmentCreated'
  data: {
    id: string
    productId: string
    locationId: string
    status: string
    createdAt: string
    updatedAt: string
  }
  context: {
    country: string
    warehouse: string
  }
}

Evento de Asignación Actualizada

Nombre: assignment-updated-event

ARN en Producción:

arn:aws:sns:us-east-1:123456789012:assignment-updated-event

ARN en Staging:

arn:aws:sns:us-east-2:123456789012:assignment-updated-event

Propósito: Notificar a otros servicios cuando se actualiza una asignación de ubicación existente.

Productores:

• Caso de uso UpdateState a través del observador AssignmentUpdatedEmitter y el despachador SnsAssignmentEventDispatcher

Formato del Mensaje:

interface AssignmentUpdatedEvent {
  type: 'AssignmentUpdated'
  data: {
    id: string
    productId: string
    locationId: string
    status: string
    createdAt: string
    updatedAt: string
  }
  context: {
    country: string
    warehouse: string
  }
}