> ## 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.
# Sistema de gestão de empréstimos
> Rode toda a jornada de crédito, da definição do produto até a originação e a gestão da carteira, com conectividade para crédito consignado no Brasil.
Uma operação de crédito roda por meses ou anos. Ela toca produto, risco, operações e contabilidade em cada etapa. A maioria das instituições monta isso a partir de um catálogo de produtos aqui, uma ferramenta de originação ali, e a gestão da carteira no core.
A Lerian compõe isso a partir de peças separadas, cada uma responsável por uma fronteira. O Lender roda a jornada de crédito, o Midaz guarda os saldos, e o trilho Consignado CLT (Dataprev) possui a fronteira com o Dataprev. Cada peça entrega à próxima um fato registrado, nunca um palpite.
## O que você recebe
***
O motor da jornada de crédito. Ele possui os produtos de empréstimo, a originação, a gestão da carteira, as regras de lançamento e as execuções de acréscimo, e a trilha de auditoria, para crédito ao consumidor (CDC). O ledger continua sendo a fonte de verdade dos saldos.
O trilho nativo para o programa Crédito do Trabalhador do Dataprev, para crédito consignado do setor privado.
A fonte de verdade dos saldos. Ele recebe cada desembolso e cada acréscimo de juros como uma transação balanceada de partidas dobradas.
Emite as credenciais machine-to-machine e o JWT de curta duração que o relay do ledger carrega, por tenant.
Transforma um veredito de conciliação em uma ação de gestão da carteira. O Lender consome a execução de match concluída.
Entrega fatos do Lender e do Consignado para um webhook, uma fila na nuvem, ou um cursor que você consulta.
## Como as peças se encaixam
***
```mermaid theme={null}
flowchart LR
Channel["Seu canal
web, app, ou parceiro"]
Lender["Lender
a jornada de crédito"]
GW["Consignado CLT (Dataprev)
trilho nativo"]
Dataprev["Dataprev"]
Midaz["Ledger Midaz
saldos"]
AM["Access Manager
emite tokens"]
Matcher["Matcher
vereditos de conciliação"]
Hub["Streaming Hub
entrega eventos"]
Sink["Seus sistemas"]
Channel -->|"REST /api/v1"| Lender
Lender -.->|"comandos em lerian.streaming.lender.commands"| GW
GW -->|"credenciais e certificado por tenant"| Dataprev
GW -.->|"fatos em lerian.streaming.consignado-gw"| Lender
Lender -->|"intenção de lançamento, outbox, relay"| Midaz
AM -.->|"credenciais M2M, JWT de curta duração"| Lender
Matcher -.->|"match_run.completed"| Lender
Lender -.->|"fatos em lerian.streaming.lender"| Hub
Hub -.->|"webhook, fila, ou pull"| Sink
classDef lerian fill:#fff8e1,stroke:#f4b400,color:#333;
classDef yours fill:#e8f0fe,stroke:#4285f4,color:#333;
classDef ext fill:#f1f3f4,stroke:#9aa0a6,color:#333;
class Lender,GW,Midaz,AM,Matcher,Hub lerian;
class Channel,Sink yours;
class Dataprev ext;
```
1. Seu canal chama o Lender por HTTP. Produtos de empréstimo, solicitações, contas de empréstimo, execuções de acréscimo, e os registros regulatórios brasileiros ficam todos sob `/api/v1`. Não existe biblioteca cliente para instalar.
2. Para um crédito consignado, o Lender emite um comando no seu tópico de comandos. O trilho lê esse comando e chama o Dataprev com o código de solicitante do tenant, as credenciais OAuth e o certificado ICP-Brasil.
3. O trilho publica fatos de negócio de volta no seu próprio tópico. O Lender consome esses fatos e move a solicitação de empréstimo pelas suas etapas.
4. Um desembolso ou um acréscimo de juros grava uma intenção de lançamento durável. A intenção fica na mesma transação de banco de dados que muda o estado do domínio.
5. O relay do ledger lança a transação balanceada de partidas dobradas no Midaz através do SDK oficial. Cada lançamento carrega uma chave de idempotência determinística, então um lançamento repetido colapsa em uma única transação no Midaz.
6. O relay alcança o Midaz através do Access Manager. Ele se autentica com credenciais machine-to-machine e um JWT de curta duração, por tenant.
7. O Lender publica os próprios fatos no seu próprio tópico de eventos. O Streaming Hub acompanha esse tópico e entrega cada evento correspondido para um destino que você possui.
O roteamento falha fechado. O perfil contábil resolve a organização e o ledger que recebem cada lançamento. Quando o roteamento não resolve nenhum destino, o Lender recusa o lançamento em vez de registrar em um ledger vazio ou errado.
Uma entrada opcional fecha o loop. Quando você concilia com o Matcher, o Lender consome a execução de match concluída e traduz o veredito em uma transição de estágio de gestão da carteira e na intenção de lançamento correspondente. Essa integração é controlada por configuração, e os dois lados devem concordar sobre a fonte de CloudEvents antes de você habilitá-la.
## O que cada peça possui
***
| Peça | Fonte de verdade para | Fala com | Você mantém |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Lender | a jornada de crédito: produtos de empréstimo, solicitações, contas de empréstimo, execuções de acréscimo, e os registros regulatórios brasileiros | o Midaz através do relay do ledger, o trilho Consignado através de comandos e fatos, e fatos do Matcher | a análise de crédito, a precificação, a política de aprovação, o produto de empréstimo, e a comunicação com o cliente |
| Midaz | saldos | recebe os lançamentos que o relay envia | os dados do seu ledger, no seu banco de dados |
| Consignado CLT (Dataprev) | a fronteira com o Dataprev | o Dataprev, e o Lender através do stream | o código de solicitante, as credenciais OAuth e o certificado ICP-Brasil de cada tenant |
| Access Manager | as identidades e os tokens em que cada serviço confia | o Lender, a caminho do Midaz | as suas pessoas e as suas aplicações machine-to-machine |
| Matcher | regras, execuções e vereditos de match | o Lender, que consome a execução de match concluída | as suas fontes de conciliação |
| Streaming Hub | quais fatos do Lender e do Consignado chegam a qual destino | os tópicos de fatos, e os sinks que você registra | os seus sinks e os seus segredos de assinatura |
## Adote uma peça de cada vez
***
PostgreSQL e Valkey são os serviços que a originação precisa. A produção também exige um provedor de identidade para autorização de rota. Um primeiro empréstimo não precisa de Midaz nem de RedPanda. A intenção de lançamento fica durável no outbox até você configurar um ledger.
Aponte o Lender para o Midaz e para o Access Manager. O Lender então lança cada desembolso e cada acréscimo como uma transação balanceada. Antes de o relay lançar, o Lender garante que cada alias de conta no perfil contábil existe. Ele pula as contas externas, e nunca cria ativos.
O crédito consignado do setor privado alcança o programa Crédito do Trabalhador do Dataprev através do trilho nativo. Registre o certificado ICP-Brasil do tenant, as credenciais OAuth, e o código de solicitante de três dígitos antes da primeira chamada.
Ative o streaming e assine os fatos do Lender no Streaming Hub. Quando você conciliar com o Matcher, primeiro alinhe o contrato de evento nos dois lados. Depois ative o listener do Matcher no Lender.
## Traga o seu
***
* **Os seus canais.** A API REST é toda a superfície de cliente, então você chama o Lender a partir da stack que você já roda.
* **A sua custódia de segredos.** O relay lê as credenciais machine-to-machine dele a partir do AWS Secrets Manager, ou do HashiCorp Vault KV v2 quando você o seleciona.
* **Os seus protocolos de identidade.** O provedor de identidade do Access Manager aceita OAuth 2.0 e OIDC, SAML 2.0, provisionamento SCIM 2.0, e LDAP contra um diretório externo.
* **Os seus consumidores de eventos.** Uma subscription do Streaming Hub entrega para um webhook, um cursor de pull, Amazon SQS, RabbitMQ, ou Amazon EventBridge.
* **As suas fontes de conciliação**, através do Matcher. Veja [Conciliação](/pt/solutions/reconciliation).
## Um exemplo prático
***
Este exemplo acompanha um crédito consignado do setor privado desde a primeira chamada até o lançamento no ledger.
1. Seu canal cria a solicitação de empréstimo no Lender contra uma versão de produto de empréstimo.
2. O Lender emite o comando de solicitação de margem. O trilho executa a leitura de margem do trabalhador contra o Dataprev e retorna a resposta do trilho, sem transformá-la em uma decisão de análise de crédito.
3. Você precifica o empréstimo e o aprova sob a sua própria política de crédito. O Lender registra a taxa contratada, o CET, o IOF, e o plano de parcelas como fatos, e os vincula à versão do produto.
4. A originação brasileira adiciona etapas regulamentadas. O Lender registra a divulgação do CET. Ele também registra o consentimento de capitalização, com o texto da cláusula e o hash que recalcula.
5. O trilho registra o contrato com o Dataprev, anexa o documento CCB, e publica os fatos de registro e pagamento. O Lender consome o registro do contrato e a confirmação do desembolso.
6. O Lender confirma o evento de desembolso, o cronograma de originação, e a intenção de lançamento em uma única transação de banco de dados. O relay lança a transação balanceada no Midaz logo após a resposta.
7. Cada execução de acréscimo lança da mesma forma, com a mesma garantia de idempotência. Se você concilia, uma execução de match concluída move o estágio de gestão da carteira e cria a intenção de lançamento correspondente.
## Comece aqui
***
Os cinco domínios da jornada de crédito, e o que cada um possui.
Seis chamadas de um banco de dados vazio até um empréstimo desembolsado.
O que o trilho de consignado cobre, e onde a responsabilidade dele termina.