> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Como o Lerian Consignado — Dataprev funciona

> Os fluxos do gateway de ponta a ponta — configuração de credenciais, obtenção de margem, averbação, o leilão de empréstimos de 24 horas e a conciliação de registros de escrituração e de repasse D+2 da CEF — cada um acionado por um comando do motor de crédito ou por um poller agendado.

O Lerian Consignado — Dataprev conduz seu trabalho por cinco fluxos. Dois são **acionados por comando** — o motor de crédito pede uma margem ou uma averbação — e os demais são **acionados por poller**, que varrem a Dataprev com uma cadência em busca de leilões e liquidação. Antes que qualquer um deles possa executar, um tenant registra suas credenciais.

## Configuração de credenciais

***

Um tenant só transaciona depois de registrar duas credenciais pelo plano de controle do gateway:

* um **certificado de cliente ICP-Brasil A1** (certificado e chave em PEM), validado antes de ser guardado;
* um **segredo OAuth2 de client-credentials**.

Ambos ficam em um cofre de segredos gerenciado e **nunca são devolvidos** em nenhuma leitura. Uma leitura de status informa se há um certificado presente, seu fingerprint e seu vencimento, e se o segredo OAuth está configurado — devolvendo esses indicadores (todos em falso quando nada está guardado) em vez de um erro.

## Obtenção de margem

***

Quando o motor de crédito precisa da margem de folha de um trabalhador, ele emite um comando de **solicitação de margem**. O gateway consulta na Dataprev a margem disponível do trabalhador e sua remuneração disponível, e emite um fato que carrega essa margem, associado à solicitação de origem.

## Averbação

***

Para registrar um contrato assinado, o motor de crédito emite um comando de **solicitação de averbação**. O gateway registra o contrato na Dataprev e emite um de dois fatos:

* um fato de **averbação confirmada** que carrega o código de sucesso do próprio trilho — repassado, nunca fixado em código; ou
* um fato de **averbação rejeitada** que carrega o código de erro e a mensagem do trilho.

## Leilão de empréstimos

***

As solicitações de empréstimo dos trabalhadores (*solicitações*) abrem, cada uma, um **leilão de 24 horas**. Um poller de descoberta lista essas solicitações página a página. Para cada solicitação que ele ainda não viu, o gateway dispersa o leilão de forma concorrente a um conjunto configurado de gestores de lances externos, coleta seus lances e seleciona o lance de **menor CET anual** — empates são resolvidos pela menor parcela, e um lance cujo CET não pode ser parseado nunca pode vencer. Em seguida, ele envia o lance vencedor.

Um segundo poller, de detecção de vencedor, observa as propostas enviadas. Quando uma proposta atinge um estado de aceitação, o gateway emite um fato de **proposta aceita** para que o sistema de empréstimos a jusante possa originar o empréstimo.

## Conciliação

***

Com uma cadência configurável, um poller de conciliação varre uma janela deslizante de *competências* de folha. Para cada competência ele lê duas fontes independentes — os registros de **escrituração** por contrato e os registros de **repasse D+2 da CEF** que liquidam as parcelas pagas — normaliza-os e emite um fato de conciliação por registro. As duas pernas são independentes: uma falha ao ler uma nunca bloqueia a outra.