Requisitos previos

Lender necesita un conjunto pequeño de cosas listas antes de su primera llamada de API. Esta página las lista en el orden en que las configuras. Cuando cada ítem de aquí se cumple, sigue el Inicio rápido para originar un préstamo.

​

Servicios de los que depende Lender

---

PostgreSQL, Valkey y RedPanda son obligatorios: Lender no arranca sin el backbone de eventos. Un proveedor de identidad es obligatorio cuando la autorización por ruta está habilitada, que es el valor predeterminado. Producción lo requiere. Un primer préstamo no necesita Midaz. Lee Asientos en el ledger más abajo para saber qué queda esperando.

​

Ejecutar Lender localmente

---

Lender es un solo servicio en Go. Una ejecución local necesita el toolchain de Go 1.26 o posterior, Docker con Compose y Make.

​

Aplicar las migraciones

---

Lender no migra la base de datos cuando arranca. Las migraciones las aplicas por fuera, desde un conjunto en el directorio migrations. La imagen del contenedor lleva un binario /migrate que lo aplica. El conjunto también siembra el registro de jurisdicciones: dos jurisdicciones activas, BR para Brasil y XX, la base genérica. Ninguna API crea una jurisdicción. El binario desplegado lleva el comportamiento de cada perfil, y la tabla registra qué códigos conoce ese binario. Lee Jurisdicciones para saber qué decide un perfil.

​

Configuración obligatoria

---

El outbox de PostgreSQL es obligatorio y se inicializa de forma automática. Configura la autenticación cuando tu despliegue habilita la autorización por ruta.

​

Un sujeto autenticado: PLUGIN_AUTH_ENABLED=true, el valor predeterminado

Lender registra quién actuó sobre cada solicitud de préstamo. Lee el oficial asignado desde el sujeto del Bearer token, no desde el body de la solicitud. Por eso cada llamada de solicitud de préstamo necesita una identidad autenticada. PLUGIN_AUTH_ENABLED es true de forma predeterminada. Define PLUGIN_AUTH_HOST con la dirección de tu proveedor de identidad. Luego envía un Bearer token en cada llamada. El token necesita un claim de sujeto no vacío, y el mismo sujeto debe crear, aprobar y desembolsar la solicitud. Lender define sus roles y permisos en un archivo de semilla. Carga esa semilla en tu proveedor de identidad. El rol del oficial necesita estos permisos:

​

Un sumidero de asientos durable: siempre presente

Un préstamo desembolsado registra su intención de asiento de forma durable. Lender inicializa su outbox transaccional de PostgreSQL en cada despliegue, dentro de la misma transacción de base de datos que mueve la solicitud a disbursed. OUTBOX_ENABLED no existe. El despachador transmite cada intención después, con la cadencia que define OUTBOX_DISPATCH_INTERVAL_SEC. Lee Contabilidad y ejecuciones de devengo para saber qué recibe el ledger.

​

Asientos en el ledger

---

Apunta Lender a Midaz cuando quieras que los asientos aterricen en el ledger: El préstamo se origina con o sin estas. Hasta que configures un endpoint de ledger, las intenciones de asiento permanecen durables en el outbox y el asiento del ledger espera. Configura el ledger antes de esperar contabilizaciones.

​

Valores predeterminados del tenant

---

DEFAULT_TENANT_ID identifica al tenant, y debe ser un UUID válido. Las migraciones vinculan el tenant predeterminado, 11111111-1111-1111-1111-111111111111, a BR. Si defines otro DEFAULT_TENANT_ID, agrega su fila en public.tenant_jurisdictions, o Lender rechaza sus solicitudes con 403.

​

Streaming de eventos

---

Lender no arranca sin el backbone de eventos. Define STREAMING_ENABLED=true, apunta STREAMING_BROKERS a RedPanda y define STREAMING_CLOUDEVENTS_SOURCE=lender. Lender valida esos valores cuando arranca.

​

Lista de verificación

---

• PostgreSQL 17, Valkey 8 y RedPanda accesibles.
• Migraciones aplicadas.
• STREAMING_ENABLED=true y STREAMING_BROKERS definidos.
• Cuando la autorización por ruta está habilitada, confirma que el proveedor de identidad es accesible y usa un Bearer token con un sujeto y cada permiso de la tabla de arriba.
• DEFAULT_TENANT_ID un UUID válido.

​

Próximos pasos

---