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

# Arquitetura do TED Lerian

> Como o TED Lerian conecta a sua instituição ao Midaz e ao Lerian SPB, onde guarda os seus dados e os componentes dentro do serviço.

## Sistemas conectados

***

* **Os sistemas da sua instituição** enviam e consultam TEDs por HTTPS e recebem os eventos.
* **Operadores e administradores** cuidam da fila, dos prazos e das políticas pela API.
* **O Access Manager** valida o token e a permissão de cada chamada.
* **O Midaz** reserva, liquida e libera os valores, calcula as tarifas e responde às consultas de conta e de titular.
* **O Lerian SPB** carrega as mensagens de e para o STR pela RSFN.
* **O Streaming Hub** entrega os eventos à subscription da sua instituição.

## Serviço e dados

***

O que roda dentro do TED Lerian e onde fica cada dado. A API e os workers em segundo plano são um único serviço.

* **Serviço de TED.** Responde à API `/v1` e roda os workers em segundo plano: conciliação, TEDs recebidas, o ciclo diário e o relay de eventos. Os dados de cada instituição ficam isolados.
* **PostgreSQL** guarda transferências, TEDs recebidas, devoluções, políticas, o outbox de eventos e o inbox de fatos do STR.
* **MongoDB** guarda a trilha de auditoria.
* **Valkey** guarda os registros de idempotência, os contadores de rate limit e os contadores de limites de uso.
* **Eventos.** Cada mudança de status grava o seu evento na mesma transação do banco de dados (outbox), e um relay o publica no barramento de eventos da plataforma. O Streaming Hub o entrega a partir dali.
* **Fatos do STR.** O Lerian SPB publica no barramento de eventos o que o STR informou (liquidação, rejeição, TED recebida, mudanças de grade, saldo de fechamento). O serviço de TED lê esses fatos por um inbox que nunca aplica o mesmo fato duas vezes.

## Componentes do serviço de TED

***

O serviço tem quatro domínios, cada um com as suas regras, dados e endpoints.

| Componente | O que faz | API e eventos |
| - | - | - |
| Envio | Cota, envia TEDs e transferências internas, cancela, consulta, concilia e destrava. | `/v1/transfers`, `/v1/reconciliation`, `transfer.*` |
| Recebimento | Credita TEDs recebidas depois de conferir o titular, devolve com o motivo oficial e trata as revisões manuais. | `/v1/incoming-transfers`, `incoming_transfer.*`, `incoming_return.*` |
| Política | A janela efetiva, o cut-off, os feriados, os limites de uso, os vínculos de ISPB e a lista de participantes do STR. Acompanha as mudanças de grade que o STR anuncia. | `/v1/policy`, `/v1/participants` |
| Operações | O dashboard diário, os prazos regulatórios, a fila de operações, as inconsistências e o saldo de fechamento que o STR informa. | `/v1/operations`, `/v1/reconciliation/queue`, `/v1/reconciliation/inconsistencies` |


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