Skip to main content
Lerian STA es event-first en sus bordes. Una transición terminal puede crear de forma atómica registros separados de auditoría y de negocio mediante outboxes transaccionales, con un sink de log duradero adicional tras el commit. Un registro de outbox llega a los consumidores solo cuando se confirma el cambio de estado de la transferencia. Los consumidores son los servicios de producto de origen que son dueños de los archivos que entrega Lerian STA.

​
Canales de eventos

Lerian STA publica en dos canales:
  • Un canal de auditoría que lleva los hechos de éxito y fallo de las transferencias entrantes, para observabilidad y conciliación.
  • Un canal de negocio firmado, enrutado como sta.{direction}.{sanitized-source-product} con un fallback unrouted, para los consumidores de productos externos. Sus tipos de evento terminales son sta.transfer.accepted, sta.transfer.rejected, sta.transfer.inconsistent, sta.transfer.canceled, sta.transfer.download_finished y sta.transfer.download_not_authorized.
Los eventos de negocio llevan un código de error enumerado solo para los resultados que no son de éxito. Los eventos Accepted y DownloadFinished exitosos lo omiten. Los eventos de éxito entrante llevan el comprobante.

​
El comprobante

Al completarse una descarga entrante, Lerian STA emite su evento terminal download-finished, enrutado por el producto de origen del archivo. El evento lleva un comprobante (object_key, sha256, size_bytes y file_name), pero no los bytes en sí. Para los hechos terminales entrantes, document_code lleva el código observado de BACEN. Cuando el mnemónico persistido y el código se corroboran entre sí, document_type lleva el mnemónico. De lo contrario, conserva el código por compatibilidad. El producto de dominio consumidor se suscribe a su propia clave. Obtiene el artefacto duradero por su clave de objeto y vuelve a verificar el SHA-256. Luego concilia el resultado en el ledger del cliente. Lerian STA es el límite de transporte e integridad. El producto consumidor es dueño del asiento en el ledger.

​
Límite del ledger

Lerian STA no escribe en el ledger del cliente. Entrega el archivo y el comprobante. El producto consumidor hace la conciliación en el ledger, por ejemplo Lerian SISBAJUD para los archivos de órdenes judiciales de activos. Esto mantiene a Lerian STA como una capa pura de transporte e integridad, independiente del significado de negocio de cualquier archivo.

​
Convenciones de integración

  • Eventos acoplados al commit. Todo registro de outbox de auditoría o de negocio está disponible solo después de que se confirma el cambio de estado de su transferencia.
  • Comprobante, no payload. Los consumidores reciben una referencia al artefacto duradero, la obtienen y vuelven a verificar su SHA-256 antes de actuar sobre ella.
  • Suscripción por clave. Los clientes eligen sus suscripciones al broker. STA enruta los eventos de negocio firmados por dirección y producto de origen saneado, con un fallback unrouted. No exige que solo un suscriptor pueda recibir un archivo.