Saltar al contenido principal
Lerian STA es orientado a eventos en sus bordes. Publica un evento terminal por transferencia a través de un outbox transaccional, de modo que un evento llega a los consumidores si y solo si el cambio de estado de la transferencia se ha confirmado. Los consumidores son los servicios de producto fuente que poseen los archivos que Lerian STA entrega.

​
Canales de eventos

Lerian STA publica en dos canales:
  • Un canal de auditoría, indexado por el producto fuente del archivo, que lleva los hechos de éxito entrante y de falla entrante para observabilidad y reconciliación.
  • Un canal de negocio firmado, indexado por sentido y producto fuente, para consumidores de producto externos. Sus tipos de evento terminales son sta.transfer.accepted, sta.transfer.rejected, sta.transfer.inconsistent, sta.transfer.canceled y sta.transfer.download_finished.
Cada evento lleva un código de error enumerado y, en el éxito entrante, el claim-check.

​
El claim-check

Al completarse una descarga entrante, Lerian STA emite su evento terminal de descarga finalizada, indexado por el producto fuente del archivo. El evento lleva un claim-check — el object key, el SHA-256, el tamaño, el nombre del archivo y el tipo de documento — pero no los bytes mismos. El producto de dominio consumidor se suscribe a su propia clave, recupera el artefacto duradero por su object key, vuelve a verificar el SHA-256 y reconcilia el resultado en el ledger de Midaz. Lerian STA es el límite de transporte e integridad; el producto consumidor posee la contabilización en el ledger.

​
Límite con Midaz

Lerian STA no escribe en Midaz por sí mismo. Entrega el archivo y el claim-check; el producto consumidor — por ejemplo, Lerian SISBAJUD para archivos de órdenes judiciales de activos — realiza la reconciliación en el ledger. 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. Cada evento fluye por el outbox transaccional, de modo que se publica solo cuando el cambio de estado de su transferencia se ha confirmado.
  • Claim-check, no payload. Los consumidores reciben una referencia al artefacto duradero, lo recuperan y vuelven a verificar su SHA-256 antes de actuar sobre él.
  • Suscripción por clave. Cada consumidor de producto fuente se suscribe solo a su propia clave, de modo que un archivo descubierto llega exactamente al producto que lo posee.