Configuración y despliegue

Cómo corre Lender: la forma del contenedor, sus dependencias, la licencia, una vista seleccionada de la configuración y la ruta de asientos en el ledger.

Lender es un servicio único, empaquetado como contenedor y configurado mediante variables de entorno. Esta página es la visión general del operador: cómo corre, de qué depende, los ajustes que importan y cómo se comportan la tenancy y el enrutamiento del ledger. La página Variables de entorno lista cada clave.

​

El contenedor

---

Lender se entrega como una imagen de contenedor que escucha en el puerto 8080. La despliegas en tu clúster Kubernetes con las herramientas de ciclo de vida estándar de la plataforma. Esta página no asume ningún empaquetado particular más allá de la imagen.

Lender sirve estas sondas operativas en el puerto principal:

Endpoint	Propósito
GET /health	Liveness. Una respuesta constante.
GET /version	Metadatos de build y de versión.

HEALTH_PORT define el puerto de salud. Cuando HEALTH_PORT no está definido, Lender no inicia un listener de salud. El puerto de salud sirve estas sondas:

Endpoint	Propósito
GET /health	Liveness.
GET /readyz	Readiness de las dependencias.
GET /readyz/tenant/:id	Readiness de un tenant, en modo multi-tenant.
GET /metrics	Métricas de salud.

PostgreSQL, Valkey y la licencia condicionan la primera respuesta de listo, y también Tenant Manager en modo multi-tenant. RabbitMQ, el backbone de eventos y el consumidor de exclusión del Consignado se reportan y no cambian el estado. Un riel de exclusión o un listener de webhook detenido hace fallar el liveness. El /readyz también reporta una licencia revocada. Los listeners de webhook de cobranza y del hub no sirven ninguna sonda. La referencia de salud y preparación describe el contrato compartido.

​

Dependencias

---

Dependencia	Rol
PostgreSQL 17	Almacén de datos principal, con capacidad primario/réplica.
Valkey 8 (compatible con Redis)	Cache y rate limiting.
RabbitMQ	Opcional y desactivado de forma predeterminada. No es el transporte del catálogo de eventos de Lender.
RedPanda	Backbone de eventos compatible con Kafka para los hechos de ciclo de vida, publicados a través de la biblioteca de streaming y el outbox transaccional de Lerian. Obligatorio: el servicio no arranca sin él.
Midaz	El ledger de doble entrada y su CRM, accedidos mediante el SDK oficial. La originación lo necesita: Lender busca o registra a cada prestatario como titular del CRM y contabiliza cada asiento. Lender se autentica mediante Access Manager con credenciales machine-to-machine (M2M). Las guardas en tu bóveda de secretos (consulta Custodia M2M del ledger más abajo).
Caradhras	Backend de identidad detrás de Access Manager. La autorización de rutas corre a través de la biblioteca de auth de Lerian.
Systemplane	Plano de configuración en tiempo de ejecución, montado en /api/v1/systemplane. Guarda los vínculos de jurisdicción de los tenants.
Servicio de licencias de Lerian	Valida la licencia al iniciar y durante la ejecución.
Reporter	Opcional. Genera el archivo de oferta de una cesión.
Matcher	Opcional. Su hecho match_run.completed alimenta la conciliación del Consignado.

​

Superficie de configuración

---

La configuración se guía por variables de entorno. Las claves de abajo moldean el comportamiento. La página Variables de entorno lista cada clave.

Grupo	Clave	Qué controla
App	ENV_NAME, LOG_LEVEL, DEPLOYMENT_MODE, SERVER_ADDRESS, HEALTH_PORT	Nombre del entorno, verbosidad de los logs, modo de despliegue, dirección de escucha y puerto de salud.
Tenancy	DEFAULT_TENANT_ID	El tenant que atiende el despliegue.
Postgres	POSTGRES_HOST, POSTGRES_PORT, POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_NAME, POSTGRES_SSLMODE	Conexión a la base de datos principal. Los directorios de migración están fijos en la imagen del servicio, no son configurables.
Cache	REDIS_HOST, REDIS_PASSWORD	Conexión a Valkey.
Mensajería	RABBITMQ_ENABLED, RABBITMQ_HOST, OUTBOX_DISPATCH_INTERVAL_SEC	Vía de mensajería separada de RabbitMQ y cadencia del dispatcher. Estas variables no configuran los temas de eventos de ciclo de vida. El outbox de PostgreSQL siempre se inicializa; no tiene bandera de habilitación.
Streaming	STREAMING_ENABLED, STREAMING_BROKERS, STREAMING_TLS_ENABLED, STREAMING_TLS_CA_CERT	El backbone de eventos, direcciones de brokers compatibles con Kafka, TLS y un certificado CA PEM opcional codificado en base64 para confiar en brokers privados. El arranque exige STREAMING_ENABLED=true y al menos un broker, salvo en modo multi-tenant con STREAMING_TENANT_KAFKA=true. Un base64 inválido o un contenido decodificado que no es PEM impide el arranque.
Auth	PLUGIN_AUTH_ENABLED, AUTH_M2M_INVERSION_ENABLED	Autorización de rutas, activada de forma predeterminada, y la compuerta de inversión M2M. Con DEPLOYMENT_MODE en byoc, saas o production, Lender no inicia si los dos no son true.
Seguridad del proxy	TLS_TERMINATED_UPSTREAM, TRUST_PROXY_ENABLED, TRUSTED_PROXIES	Terminación TLS upstream y la lista restrictiva de proxies de confianza que exige en despliegues endurecidos.
Consignado	CONSIGNADO_ENABLED	El valor predeterminado es true. Activa la rail de exclusión de nómina y controla el tratamiento de la averbación rechazada entrante. Cuando lo deshabilitas, Lender rechaza la liquidación, la liquidación por recuperación de garantía y la liquidación final de nómina de un contrato consignado, y mantienes CONSUMER_CONSIGNADO_AVERBACAO_REJECTED_ENABLED desactivado; el arranque rechaza esa configuración contradictoria. Los caminos de registro y de pago se configuran de forma independiente. Consulta Consignado privado.
Custodia M2M del ledger	M2M_SECRETS_BACKEND, M2M_VAULT_MOUNT, AWS_REGION	Dónde se guardan las credenciales M2M del ledger en tu propio despliegue. En Lerian Cloud, Lerian las gestiona.
Cuentas del ledger	MIDAZ_LEDGER_ACCOUNT_PROVISIONING_ENABLED	El valor por defecto es true. Antes de que un relay contabilice, Lender adopta el activo del ledger por código o lo crea, asegura el tipo de cuenta de la naturaleza de cada pierna y asegura las cuentas que nombra el perfil contable. Desactívalo solo cuando aprovisionas el ledger antes.
Licencia	LICENSE_KEY, LICENSE_FILE_PATH	Una licencia es obligatoria en todo modo de despliegue: la clave, o un archivo de licencia firmado montado. La clave es válida para todo el despliegue. No hay bypass de desarrollo.
Fecha de negocio	BUSINESS_DATE_ENABLED	Permite que un tenant avance su propia fecha de negocio por la API. Inicia solo en sandbox o en homologación.
Observabilidad	ENABLE_TELEMETRY, OTEL_EXPORTER_OTLP_ENDPOINT	Toggle de telemetría y endpoint del colector OTLP.
Límites	RATE_LIMIT_ENABLED	Rate limiting de las solicitudes. Siempre activo cuando ENV_NAME=production.
Docs	SWAGGER_ENABLED	Sirve el documento OpenAPI y la interfaz de la referencia de API. Siempre desactivado cuando ENV_NAME=production.

​

Tenant y valores predeterminados del ledger

---

Por defecto, Lender atiende a un tenant (DEFAULT_TENANT_ID) con un esquema de base de datos. Las jurisdicciones que un tenant puede operar viven en la clave de configuración en tiempo de ejecución lender.jurisdictions/tenant_bindings. Un tenant sin vínculo recibe 403 en toda ruta de Brasil. En un despliegue BYOC, tu administrador define los vínculos con PUT /api/v1/systemplane/lender.jurisdictions/tenant_bindings y el cuerpo {"value": {"<tenant id>": ["BR"]}}. La escritura reemplaza el documento completo y exige systemplane/write. El tenant id es un UUID en minúsculas. En Lerian Cloud, la operación de Lerian define los vínculos de jurisdicción.

​

Asiento en el ledger y enrutamiento que falla cerrado

---

Una contabilización llega al ledger a través de una intención de asiento durable y un relay asíncrono. La vía completa está en Lender en la plataforma. El enrutamiento falla cerrado.

Un asiento se contabiliza en la organización del ledger y el ledger que se resuelven desde el perfil contable. Un asiento que no resuelve ningún destino de perfil recurre al predeterminado del entorno. Si ninguno de los dos resuelve un destino no vacío, Lender rechaza contabilizar en lugar de asentar en un ledger vacío o equivocado.

​

Próximos pasos

---

Lender en la plataforma

La vía de los asientos, el catálogo de eventos y el aislamiento por tenant en detalle.