> ## 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.

# Arquitectura de TED Lerian

> Cómo TED Lerian conecta tu institución con Midaz y Lerian SPB, dónde guarda sus datos y los componentes dentro del servicio.

## Sistemas conectados

***

* **Los sistemas de tu institución** envían y leen TEDs por HTTPS y reciben los eventos.
* **Operadores y administradores** gestionan la cola, los plazos y las políticas a través de la API.
* **Access Manager** valida el token y el permiso de cada llamada.
* **Midaz** retiene, liquida y libera los montos, calcula comisiones y responde las consultas de cuentas y titulares.
* **Lerian SPB** transporta los mensajes hacia y desde el STR por la RSFN.
* **Streaming Hub** entrega los eventos a la suscripción de tu institución.

## Servicio y datos

***

Qué se ejecuta dentro de TED Lerian y dónde vive cada dato. La API y los workers en segundo plano son un solo servicio.

* **Servicio de TED.** Responde la API `/v1` y ejecuta los workers en segundo plano: conciliación, TEDs entrantes, el ciclo diario y el relay de eventos. Los datos de cada institución están aislados.
* **PostgreSQL** guarda transferencias, TEDs entrantes, devoluciones, políticas, el outbox de eventos y el inbox de hechos del STR.
* **MongoDB** guarda el registro de auditoría.
* **Valkey** guarda los registros de idempotencia, los contadores de rate limit y los contadores de límites de uso.
* **Eventos.** Cada cambio de estado escribe su evento en la misma transacción de base de datos (outbox), y un relay lo publica en el backbone de eventos de la plataforma. Streaming Hub lo entrega desde ahí.
* **Hechos del STR.** Lerian SPB publica lo que informó el STR (liquidación, rechazo, TED entrante, cambios de horario, saldo de cierre) en el backbone de eventos. El servicio de TED los lee a través de un inbox que nunca aplica el mismo hecho dos veces.

## Componentes del servicio de TED

***

El servicio tiene cuatro dominios, cada uno con sus propias reglas, datos y endpoints.

| Componente | Qué hace | API y eventos |
| - | - | - |
| Envío | Cotiza, envía TEDs y transferencias internas, cancela, lee, concilia y desbloquea. | `/v1/transfers`, `/v1/reconciliation`, `transfer.*` |
| Recepción | Acredita TEDs entrantes después de verificar el titular, las devuelve con el motivo oficial y atiende las revisiones manuales. | `/v1/incoming-transfers`, `incoming_transfer.*`, `incoming_return.*` |
| Políticas | La ventana efectiva, el horario de corte, los feriados, los límites de uso, las vinculaciones de ISPB y la lista de participantes del STR. Sigue los cambios de horario que anuncia el STR. | `/v1/policy`, `/v1/participants` |
| Operaciones | El dashboard diario, los plazos regulatorios, la cola de operaciones, las inconsistencias y el saldo de cierre que informa el STR. | `/v1/operations`, `/v1/reconciliation/queue`, `/v1/reconciliation/inconsistencies` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.