Skip to main content
Lerian Consignado — Dataprev es event-first en su borde con la plataforma. Consume comandos del motor de crédito y emite hechos de negocio. No hace llamadas directas al ledger ni aloja consumidores de webhook. El flujo de eventos es su contrato autoritativo, no su superficie REST.

​
Comandos que consume

El motor de crédito envía al gateway cuatro comandos como eventos por el backbone de streaming de la plataforma:
  • una solicitud de margen pide el margen de nómina disponible de un trabajador
  • una solicitud de averbação pide registrar un contrato firmado con Dataprev
  • una solicitud de exclusão pide cancelar una averbação registrada
  • una solicitud de redirecionamento pide redirigir un contrato a otro acreedor
Los flujos de exclusão y redirecionamento siguen limitados a desarrollo. Ambos adaptadores se entregan como fakes y siguen deshabilitados por defecto hasta la homologación. Un comando que se decodifica pero carece de su clave identificadora — por ejemplo el CPF del trabajador — es terminal. El gateway lo envía a la cola de mensajes muertos y no lo relaya a Dataprev.

​
Hechos que emite

El gateway emite quince hechos de negocio:
  • una oferta de solicitud de préstamo descubierta (solicitação) — retransmitida para que el prestamista decida si oferta
  • el margen obtenido de un trabajador
  • una alerta de ausencia del trabajador (afastamento) — una por elemento de alerta en una lectura de margen
  • un testigo de propuesta aceptada — la lectura posterior a la averbação de lo que el riel registró
  • un resultado de averbação confirmada
  • un resultado de averbação rechazada
  • un traspaso de contrato registrado — el único hecho que registra un contrato aguas abajo
  • un hecho de desembolso confirmado — el cliente confirma que el trabajador ya recibió el pago
  • un resultado de exclusão confirmada
  • un resultado de exclusão rechazada
  • un registro de conciliación — uno por registro de escrituração o de liquidación
  • un informe de situación laboral de un trabajador
  • un resultado de redirecionamento confirmado
  • un resultado de redirecionamento rechazado
  • un hecho de throughput modificado — cambia la capacidad de solicitudes salientes del tenant
Los hechos comparten una versión de esquema para todo el paquete, con una excepción: el testigo de propuesta aceptada lleva su propia versión mayor y publica en un tópico con sufijo de versión. La clave de catálogo de un hecho no es su nombre de tópico. El tópico se deriva del segmento de aplicación del propio gateway más el recurso y el evento del hecho. Consulta la referencia de eventos de consignado para el mapeo completo.

​
Entrega agnóstica al destino

El gateway escribe cada hecho en un outbox transaccional y relaya desde allí —nunca directo al broker, por ninguna vía. Publica cada hecho en su propio tópico, pero no posee enrutamiento de consumidores: un hub de streaming aguas abajo decide qué sistema recibe cada hecho. El mismo hecho puede distribuirse a un ledger, a un almacén de conciliación o a un sistema de préstamos. El gateway no sabe ni le importa quién lo consume.

​
Sin acoplamiento directo con el ledger ni con webhooks

El gateway no hace llamadas directas a Midaz y no aloja consumidores de webhook. El contacto con el prestatario fuera de la plataforma está fuera de alcance. Los sistemas de préstamos aguas abajo son dueños de la originación y de cualquier comunicación con el prestatario.

​
En el transporte

  • El dinero y las tasas cruzan como cadenas decimales, nunca como coma flotante, lo que mantiene la precisión completa en el camino.
  • Las marcas de tiempo son UTC, RFC 3339.
  • La identidad del trabajador viaja dentro de los registros de conciliación, nunca en la referencia visible en los logs. El número de contrato es la clave de coincidencia, y cada registro puede llevar además el CPF y la matrícula del trabajador: un registro cuyo número de contrato no coincide con nada en el libro del consumidor es exactamente la excepción que el feed existe para levantar, así que el registro sigue nombrando al trabajador por el que movió dinero. El sujeto del evento queda como una referencia del riel y nunca lleva al trabajador.
  • El repasse de la CEF liquida por movimiento diario, no por contrato, así que la conciliación del lado bancario se basa en el identificador de la transferencia y no en el número de contrato.

​
Semántica de entrega

  • Idempotente por sujeto inmutable. Cada registro y cada liquidación lleva un identificador inmutable. Reprocesarlo es un no-op aguas abajo.
  • Al menos una vez. El gateway entrega cada evento al menos una vez. La reentrega y los reinicios se deduplican a un no-op.
  • Ramas independientes. En la conciliación, el gateway procesa las ramas de escrituração y de repasse de forma independiente. Un fallo en una nunca bloquea la otra.