> ## 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 gestión de préstamos
> Opera el recorrido completo de crédito, desde la definición del producto hasta la originación y la administración de cartera, con conectividad de crédito consignado para Brasil.
Una operación de crédito se ejecuta durante meses o años. Toca producto, riesgo, operaciones y contabilidad en cada etapa. La mayoría de las instituciones la arman con un catálogo de productos aquí, una herramienta de originación allá y la administración de cartera en el core.
Lerian la compone a partir de piezas separadas, cada una responsable de un límite. Lender ejecuta el recorrido de crédito, Midaz mantiene los saldos y el riel Consignado CLT (Dataprev) posee el límite frente a Dataprev. Cada pieza entrega a la siguiente un hecho registrado, nunca una suposición.
## Lo que obtienes
***
El motor del recorrido de crédito. Posee los productos de préstamo, la originación, la administración de cartera, las reglas de contabilización y las corridas de devengo, y el registro de auditoría, para crédito al consumidor (CDC). El ledger sigue siendo la fuente de verdad para los saldos.
El riel nativo hacia el programa Crédito do Trabalhador de Dataprev, para créditos consignados del sector privado.
La fuente de verdad para los saldos. Recibe cada desembolso y cada devengo de intereses como una transacción balanceada de partida doble.
Emite las credenciales máquina a máquina y el JWT de corta duración que el relay del ledger transporta, por tenant.
Convierte un veredicto de conciliación en una acción de administración de cartera. Lender consume la corrida de coincidencias completada.
Entrega hechos de Lender y de Consignado a un webhook, una cola en la nube o un cursor que consultas tú.
## Cómo encajan las piezas
***
```mermaid theme={null}
flowchart LR
Channel["Tu canal
web, app o socio"]
Lender["Lender
el recorrido de crédito"]
GW["Consignado CLT (Dataprev)
riel nativo"]
Dataprev["Dataprev"]
Midaz["Ledger de Midaz
saldos"]
AM["Access Manager
emite tokens"]
Matcher["Matcher
veredictos de conciliación"]
Hub["Streaming Hub
entrega eventos"]
Sink["Tus sistemas"]
Channel -->|"REST /api/v1"| Lender
Lender -.->|"comandos en lerian.streaming.lender.commands"| GW
GW -->|"credenciales y certificado por tenant"| Dataprev
GW -.->|"hechos en lerian.streaming.consignado-gw"| Lender
Lender -->|"intención de contabilización, outbox, relay"| Midaz
AM -.->|"credenciales M2M, JWT de corta duración"| Lender
Matcher -.->|"match_run.completed"| Lender
Lender -.->|"hechos en lerian.streaming.lender"| Hub
Hub -.->|"webhook, cola o 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. Tu canal llama a Lender por HTTP. Los productos de préstamo, las solicitudes, las cuentas de préstamo, las corridas de devengo y los registros regulatorios brasileños están todos bajo `/api/v1`. No hay ninguna biblioteca cliente que instalar.
2. Para un crédito consignado, Lender emite un comando en su tema de comandos. El riel lee ese comando y llama a Dataprev con el código de solicitante del tenant, las credenciales OAuth y el certificado ICP-Brasil.
3. El riel publica hechos de negocio de vuelta en su propio tema. Lender consume esos hechos y avanza la solicitud de préstamo a través de sus etapas.
4. Un desembolso o un devengo de intereses escribe una intención de contabilización durable. La intención llega en la misma transacción de base de datos que cambia el estado del dominio.
5. El relay del ledger contabiliza la transacción balanceada de partida doble en Midaz a través del SDK oficial. Cada contabilización lleva una clave de idempotencia determinística, de modo que un reintento de contabilización se reduce a una sola transacción de Midaz.
6. El relay llega a Midaz a través de Access Manager. Se autentica con credenciales máquina a máquina y un JWT de corta duración, por tenant.
7. Lender publica sus propios hechos en su propio tema de eventos. Streaming Hub sigue ese tema y entrega cada evento coincidente a un destino que tú controlas.
El enrutamiento falla de forma cerrada. El perfil contable resuelve la organización y el ledger que reciben cada contabilización. Cuando el enrutamiento no resuelve ningún destino, Lender se niega a contabilizar en lugar de registrar en un ledger vacío o incorrecto.
Una entrada opcional cierra el ciclo. Cuando concilias con Matcher, Lender consume la corrida de coincidencias completada y traduce el veredicto en una transición de etapa de administración de cartera y en la intención de contabilización correspondiente. Esa integración está controlada por configuración, y ambos lados deben acordar la fuente de CloudEvents antes de habilitarla.
## Qué posee cada pieza
***
| Pieza | Fuente de verdad para | Se comunica con | Tú mantienes |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Lender | el recorrido de crédito: productos de préstamo, solicitudes, cuentas de préstamo, corridas de devengo y registros regulatorios brasileños | Midaz a través del relay del ledger, el riel Consignado a través de comandos y hechos, y los hechos de Matcher | la evaluación crediticia, los precios, la política de aprobación, el producto de préstamo y la comunicación con el cliente |
| Midaz | los saldos | recibe las contabilizaciones que envía el relay | tus datos del ledger, en tu base de datos |
| Consignado CLT (Dataprev) | el límite frente a Dataprev | Dataprev, y Lender a través del stream | el código de solicitante, las credenciales OAuth y el certificado ICP-Brasil de cada tenant |
| Access Manager | las identidades y los tokens en los que confía cada servicio | Lender, camino a Midaz | tus personas y tus aplicaciones máquina a máquina |
| Matcher | las reglas, corridas y veredictos de coincidencia | Lender, que consume la corrida de coincidencias completada | tus fuentes de conciliación |
| Streaming Hub | qué hechos de Lender y de Consignado llegan a qué destino | los temas de hechos, y los destinos que registras | tus destinos y tus secretos de firma |
## Adóptalo pieza por pieza
***
PostgreSQL y Valkey son los servicios que necesita la originación. Producción también requiere un proveedor de identidad para la autorización de rutas. Un primer préstamo no necesita Midaz ni RedPanda. La intención de contabilización permanece durable en el outbox hasta que configuras un ledger.
Apunta Lender hacia Midaz y hacia Access Manager. Lender entonces contabiliza cada desembolso y cada devengo como una transacción balanceada. Antes de que el relay contabilice, Lender verifica que cada alias de cuenta en el perfil contable exista. Omite las cuentas externas, y nunca crea activos.
Los créditos consignados del sector privado llegan al programa Crédito do Trabalhador de Dataprev a través del riel nativo. Registra el certificado ICP-Brasil del tenant, las credenciales OAuth y el código de solicitante de tres dígitos antes de la primera llamada.
Activa el streaming y suscríbete a los hechos de Lender en Streaming Hub. Cuando concilies con Matcher, primero acuerda el contrato de eventos en ambos lados. Luego activa el listener de Matcher en Lender.
## Trae lo tuyo
***
* **Tus canales.** La API REST es toda la superficie de cliente, así que llamas a Lender desde el stack que ya ejecutas.
* **Tu custodia de secretos.** El relay lee sus credenciales máquina a máquina desde AWS Secrets Manager, o desde HashiCorp Vault KV v2 cuando lo seleccionas.
* **Tus protocolos de identidad.** El proveedor de identidad de Access Manager admite OAuth 2.0 y OIDC, SAML 2.0, aprovisionamiento SCIM 2.0, y LDAP contra un directorio externo.
* **Tus consumidores de eventos.** Una suscripción de Streaming Hub entrega a un webhook, un cursor de pull, Amazon SQS, RabbitMQ o Amazon EventBridge.
* **Tus fuentes de conciliación**, a través de Matcher. Consulta [Conciliación](/es/solutions/reconciliation).
## Un ejemplo práctico
***
Este ejemplo sigue un crédito consignado del sector privado desde la primera llamada hasta el asiento en el ledger.
1. Tu canal crea la solicitud de préstamo en Lender contra una versión de producto de préstamo.
2. Lender emite el comando de solicitud de margen. El riel hace la consulta de margen del trabajador contra Dataprev y devuelve la respuesta del riel, sin convertirla en una decisión de evaluación crediticia.
3. Tú defines el precio del préstamo y lo apruebas bajo tu propia política de crédito. Lender registra la tasa contratada, el CET, el IOF y el plan de cuotas como hechos, y los vincula a la versión del producto.
4. La originación brasileña agrega pasos regulados. Lender registra la divulgación del CET. También registra el consentimiento de capitalización, con el texto de la cláusula y el hash que recalcula.
5. El riel registra el contrato con Dataprev, adjunta el documento CCB y publica los hechos de registro y pago. Lender consume el registro del contrato y la confirmación del desembolso.
6. Lender confirma el evento de desembolso, el cronograma de originación y la intención de contabilización en una sola transacción de base de datos. El relay contabiliza la transacción balanceada en Midaz poco después de la respuesta.
7. Cada corrida de devengo se contabiliza de la misma forma, con la misma garantía de idempotencia. Si concilias, una corrida de coincidencias completada mueve la etapa de administración de cartera y crea la intención de contabilización correspondiente.
## Empieza aquí
***
Los cinco dominios del recorrido de crédito, y qué posee cada uno.
Seis llamadas desde una base de datos vacía hasta un préstamo desembolsado.
Qué cubre el riel de crédito consignado, y dónde termina su responsabilidad.