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

# Como o Lerian STA funciona

> Os dois sentidos de transferência — envio de saída e descoberta e download de entrada — a máquina de estados do protocolo do BACEN, a verificação de integridade por SHA-256, os orçamentos de retentativa e o TTL do protocolo, e as ações do operador sobre uma transferência.

O Lerian STA move arquivos em dois sentidos. Cada troca é uma **transferência** — um único arquivo que se move entre a instituição e o BACEN — rastreada pelo seu **número de protocolo** ao longo do ciclo de vida do protocolo do BACEN, com o **SHA-256** verificado nas duas pontas.

## Envio de saída

***

A instituição, ou um produto da Lerian rio acima, entrega ao Lerian STA um arquivo para o BACEN. O Lerian STA então obtém um **número de protocolo** do BACEN, envia os bytes do arquivo e faz o BACEN validá-los contra o **SHA-256** declarado.

A transferência avança pelo ciclo de vida do BACEN:

| Estado                         | Significado                                      |
| ------------------------------ | ------------------------------------------------ |
| **Protocolo gerado**           | O BACEN atribuiu o número de protocolo.          |
| **Transmitindo**               | O Lerian STA está enviando os bytes.             |
| **Verificação de integridade** | O BACEN está validando o SHA-256 declarado.      |
| **Recebido**                   | O BACEN recebeu o arquivo.                       |
| **Entregue**                   | O BACEN entregou o arquivo ao seu destino.       |
| **Em processamento**           | O BACEN está processando o arquivo.              |
| **Aceito**                     | O BACEN aceitou o arquivo — um sucesso terminal. |
| **Rejeitado / Inconsistente**  | O BACEN recusou o arquivo — uma falha terminal.  |

O envio faz retentativas dentro de um **orçamento limitado**; uma vez esgotado o orçamento, a transferência é cancelada. Cada protocolo carrega também um **TTL** limitado de relógio de parede — 44 horas por padrão — para concluir o envio antes de o BACEN expirá-lo.

## Descoberta e download de entrada

***

O Lerian STA sonda o BACEN por tenant ativo em uma cadência configurada em busca de arquivos disponíveis. Para cada arquivo, ele confere o **código de sistema do BACEN** do arquivo contra as **configurações de origem de entrada** do tenant, depois baixa os bytes, verifica-os contra o **SHA-256** que o BACEN reporta e armazena o artefato de forma durável em object storage.

Uma divergência de hash ou uma falha de download faz retentativas dentro de um orçamento limitado. Uma vez esgotado o orçamento, a transferência é **posta em quarentena** rumo a uma falha terminal — inconsistente ou cancelada — em vez de ser entregue ao seu produto de origem.

## Ações do operador

***

Um operador pode agir sobre uma transferência que não alcançou um estado terminal:

* **Cancelar** uma transferência não terminal.
* **Repetir** uma transferência de saída que falhou.
* **Marcar como urgente** para priorizar o tratamento.

O cancelamento também é **iniciado pelo BACEN** quando um protocolo expira.