> ## 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.
# Core banking
> Opera cuentas, transacciones e informes regulatorios sobre un ledger que es tuyo, con los controles que espera tu regulador.
Un core legado te da esquemas rígidos, dependencia del proveedor y ciclos de lanzamiento lentos. Cada producto nuevo o regla nueva se convierte en meses de trabajo de integración. Necesitas un sistema de registro que sea tuyo, además de los controles y los informes que pide tu regulador. Un stack de core banking de Lerian es un ledger que es tuyo, con un servicio de decisión delante y un motor de informes al lado. Un solo inicio de sesión cubre cada pieza. Adoptas cada pieza por separado y las conectas en un paso de despliegue.
## Lo que obtienes
***
El ledger. Contiene organizaciones, ledgers, cuentas y transacciones con garantías de partida doble. El CRM y el Fees Engine se ejecutan dentro del mismo proceso.
Validación en tiempo real delante del ledger. Devuelve permitir, denegar o marcar para revisión antes de que tu aplicación envíe la transacción.
Informes repetibles a partir de plantillas de texto plano sobre las tablas del ledger. Genera archivos HTML, CSV, XML, PDF y TXT.
Una sola capa de control de acceso. Responde quién hace una solicitud y a qué puede acceder ese llamador.
La interfaz web del stack. Los operadores configuran los productos y hacen el trabajo diario en un solo lugar.
El borde de entrega para eventos. Envía hechos del ledger y de Tracer a un webhook, una cola o un cursor que consultas tú.
## Cómo encajan las piezas
***
```mermaid theme={null}
flowchart LR
App["Tu aplicación"]
Tracer["Tracer
permitir, denegar, revisión"]
Midaz["Ledger de Midaz
CRM y Fees Engine incluidos"]
Rep["Reporter
genera archivos de informe"]
AM["Access Manager
emite tokens"]
Hub["Streaming Hub
entrega eventos"]
Sink["Tu webhook o cola"]
Console["Console
opera el stack"]
App -->|"1. validar"| Tracer
App -->|"2. enviar si permite"| Midaz
Midaz -->|"punto de reserva opcional, Ledger v2"| Tracer
Rep -->|"lee las tablas del ledger"| Midaz
Midaz -.->|"hechos del ledger"| Hub
Tracer -.->|"hechos de tracer"| Hub
Hub -.->|"webhook, cola o pull"| Sink
AM -.->|"emite el token que presenta tu aplicación"| App
Console -->|"opera"| Midaz
Console -->|"opera"| Tracer
Console -->|"opera"| Rep
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 Tracer,Midaz,Rep,AM,Hub,Console lerian;
class App,Sink yours;
```
1. Tu aplicación envía el contexto completo de la transacción a Tracer. Tracer evalúa tus reglas y límites de gasto, y luego devuelve permitir, denegar o marcar para revisión.
2. Si permite, tu aplicación envía la transacción a Midaz. Tracer nunca llama al ledger.
3. Cuando aplica un paquete de comisiones, Midaz agrega los cálculos de comisiones a la transacción que envías. Tu aplicación puede llamar primero a los endpoints de comisiones para estimarlas.
4. Midaz registra las operaciones balanceadas. Con streaming habilitado, publica el hecho en `lerian.streaming.ledger` justo después del cambio de estado.
5. Streaming Hub compara ese hecho con tus suscripciones y lo entrega a tu webhook, cola o cursor de pull.
6. Reporter lee las tablas del ledger que registraste como fuente de datos, y genera los archivos que pide tu regulador.
Midaz también puede llamar a Tracer por ti, en una ruta que permanece desactivada hasta que la configuras. Define `TRACER_BASE_URL` y un `tracer.mode` por ledger de `advisory` o `enforce`. La ruta de transacción de Ledger HTTP v2 entonces reserva capacidad de límite con Tracer antes de confirmar. Ledger HTTP v1 nunca hace esta llamada. En esta ruta, Midaz llama a Tracer, y Tracer sigue sin llamar nunca a Midaz.
## Qué posee cada pieza
***
| Pieza | Fuente de verdad para | Se comunica con | Tú mantienes |
| ---------------------------- | ------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Midaz | saldos, cuentas, transacciones y operaciones | publica sus hechos en el stream | tus datos del ledger, en tu base de datos |
| CRM, dentro de Midaz | quién está detrás de una cuenta: titulares e instrumentos | Midaz lo sirve solo en `/v2` | los atributos del cliente. Midaz cifra los campos sensibles antes de almacenarlos |
| Fees Engine, dentro de Midaz | paquetes de comisiones y cálculos de comisiones | agrega cálculos a la transacción que envías | tus precios |
| Tracer | reglas, límites, decisiones y su propio registro de auditoría | recibe llamadas de tu aplicación, y nunca llama a Midaz | tus políticas. Tracer verifica políticas y límites, no saldos de cuentas |
| Reporter | plantillas, informes y plazos de entrega de informes | lee fuentes de PostgreSQL y MongoDB en una sola dirección | tus definiciones de informes, y los archivos generados en tu propio bucket |
| Access Manager | usuarios, tokens y permisos | cada producto que activa la aplicación de reglas en el nivel de ruta | tus personas y tus aplicaciones máquina a máquina |
| Console | las pantallas de operación | los módulos que habilitas | un solo inicio de sesión para los operadores. Console no conecta las piezas entre sí |
| Streaming Hub | suscripciones y estado de entrega | consume el stream, y nunca produce sobre él | tus destinos y tus secretos de firma |
## Adóptalo pieza por pieza
***
Midaz es la base del ledger, así que va primero. El CRM y el Fees Engine se ejecutan dentro del proceso del ledger, así que no despliegas ningún servicio adicional para ellos.
Access Manager emite los tokens en los que confía cada servicio. Agrégalo justo después de Midaz, antes de cualquier producto o interfaz.
Tu aplicación llama a Tracer antes de enviar, y solo envía a Midaz si Tracer permite. Tracer nunca inicia una llamada a Midaz ni lee saldos.
Agrega cada base de datos de Midaz como fuente de datos de PostgreSQL con credenciales de solo lectura. Apunta Reporter a una réplica de lectura donde tengas una, para que las consultas de informes no afecten la ruta de escritura del ledger.
Habilita los productos que ejecutas desde la página de configuración de Console. Activa el streaming en Midaz cuando necesites los hechos fuera de la plataforma, porque la publicación está desactivada de forma predeterminada.
## Trae lo tuyo
***
* **Tu nube.** Ejecuta la plataforma en Lerian Cloud, o trae tu propia nube y despliega tú mismo los Helm charts oficiales.
* **Tus consumidores de eventos.** Streaming Hub entrega a cinco tipos de destino: webhook, pull, SQS, RabbitMQ y EventBridge.
* **Tus otras bases de datos.** Un solo despliegue de Reporter genera informes sobre Midaz, sobre tus propias bases de datos, y sobre ambos en la misma plantilla.
* **Tu stack de aplicación.** Midaz expone una API REST, y Lerian publica SDKs para [Go](/es/products/midaz/midaz-sdk-go) y [TypeScript](/es/products/midaz/midaz-sdk-typescript).
* **Tu conciliación.** Agrega Matcher cuando compares el ledger contra bancos y proveedores de pago. Consulta la solución de [conciliación](/es/solutions/reconciliation).
## Un ejemplo práctico
***
Un cash-out de Pix mueve BRL de una cuenta de cliente hacia una cuenta externa.
1. La cuenta de cliente `customer_12345_brl` ya existe. Midaz creó por ti la cuenta de liquidación `@external/BRL`, junto con el activo `BRL`.
2. Tu aplicación envía el monto, las cuentas y el contexto a Tracer. Tracer devuelve permitir.
3. Tu aplicación envía 100.00 BRL contra la ruta de transacción `PIX_CASH_OUT`.
4. Midaz registra dos operaciones balanceadas, un débito en la cuenta del cliente y un crédito en `@external/BRL`. Ambas llevan el mismo `transactionId`.
5. Midaz publica `transaction.posted` en `lerian.streaming.ledger`.
6. Streaming Hub entrega ese hecho a tu webhook, firmado con un HMAC sobre la marca de tiempo y el cuerpo exacto de la solicitud.
7. Al cierre del día, Reporter genera tu archivo de conciliación a partir de las tablas del ledger.
El riel de Pix en sí es una composición aparte. Consulta la solución de [rieles de pago](/es/solutions/payment-rails).
## Empieza aquí
***
Evalúa la plataforma, elige un modelo de despliegue y ejecuta tu primera transacción de partida doble.
El diagrama completo del stack, y los pasos de conexión que ejecutas tú mismo.
Quién opera la infraestructura en cada modelo, y qué se queda de tu lado.
Ejecuta el entorno completo del ledger localmente con Docker Compose.
Dónde se ubica la llamada de validación en tu flujo, y cómo manejar cada decisión.
Sube una plantilla, genera tu primer informe y verifica el archivo descargado.