> ## 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 SPB funciona

> A sequência de onboarding, os fluxos de transferência e ciclo de vida, as operações de liquidez e as consultas assíncronas que compõem a superfície de mensagens STR.

O Lerian SPB expõe a superfície de mensagens STR como um conjunto de operações tipadas. Cada fluxo persiste o trabalho antes do envio, retorna um estado aceito mas ainda não liquidado, e concilia com a resposta assíncrona do BACEN.

## Onboarding

***

A rotação de certificados e a ativação do GEN0006 são orientações operacionais, assim como o eco de conectividade do GEN0001. Elas não são barreiras impostas pelo código para o envio de comandos.

Antes de gerar efeitos colaterais, um comando verifica a prontidão do trilho. `READY` e `DEGRADED` admitem comandos. `PENDING_CONFIGURATION` e `UNAVAILABLE` os bloqueiam. A prontidão avalia a configuração do canal e o estado do certificado. Ela não exige uma confirmação do GEN0006 nem um eco do GEN0001.

## Transferências bancárias

***

Você declara as partes remetente e destinatária tipadas. A plataforma deriva o código de transferência STR: STR0004, STR0005, STR0006, STR0007 ou STR0008. Ela persiste a operação e o trabalho de saída, e apenas então envia. O trilho retorna o status `ACCEPTED`. Ele aceitou a requisição, mas o BACEN ainda não a liquidou. O BACEN confirma a transferência de forma assíncrona, e a operação passa para `CONFIRMED` ou `REJECTED`.

## Devoluções e cancelamentos

***

Uma devolução e um cancelamento são ambos sub-recursos de uma operação pai. O id da operação pai no caminho da requisição vincula cada um a essa operação pai.

* Uma **devolução** exige uma operação pai em um estado de saída liquidado: `SENT`, `CONFIRMED` ou `DELIVERED` (pipeline STR0010).
* Um **cancelamento** exige uma operação pai que ainda admita um (pipeline STR0011).

O trilho recusa uma requisição contra o estado errado da operação pai.

## IBS repasse

***

Um **IBS repasse** (STR0053) transfere valores de liquidação do IBS da conta Reservas Bancárias para o comitê gestor. O trilho traduz a requisição para a mensagem STR0053, a persiste e a envia. O BACEN confirma de forma assíncrona.

## Liquidez da Conta PI

***

Duas operações movem liquidez entre a conta Reservas Bancárias/de liquidação de uma instituição e sua Conta PI:

* O **Aporte** (LPI0001) financia a Conta PI a partir da conta Reservas Bancárias.
* O **Resgate** (LPI0003) recolhe os fundos de volta para a conta Reservas Bancárias.

Ambas retornam `PENDING`. A resposta de liquidação recebida (LPI0001R1 / LPI0003R1) move a operação para `SETTLED` ou `REJECTED`. O Lerian SPB projeta o valor da resposta literalmente. As grades de janela operacional do GEN0021 são persistidas e consultáveis. Elas não impõem uma rejeição genérica de todo envio fora de uma janela operacional. A regra de admissão explícita ligada ao cronograma é a RLPI0007: durante a janela de aporte adicional, um aporte para a Conta PI de outra instituição é rejeitado. Aportes para a própria Conta PI da instituição e resgates continuam permitidos.

## Política de transferência automática

***

Você declara a regra de transferência automática STR para uma classe de conta com o LPI0005. O BACEN confirma o recebimento (LPI0005R1) e depois relata cada transferência automática que realiza (LPI0006). O Lerian SPB repassa os valores relatados literalmente e não realiza nenhum cálculo sobre eles.

## Fila de aprovação para emissões de alto valor

***

O trilho classifica cada valor declarado em relação a faixas configuradas semiabertas e pode aplicar uma substituição para um tipo de mensagem específico. A regra selecionada determina o estado: `requiredSignatures` igual a `0` envia a emissão para `SUBMITTED`. Um valor diferente de zero a envia para `PENDING_APPROVAL`. No teto de uma faixa, aplica-se a próxima faixa. Acima de todos os tetos, aplica-se o requisito do nível mais alto.

Um operador pode assinar ou negar uma emissão em fila. A configuração de governança passa por hot reload através do Systemplane.

## Composição curada de mensagens

***

Uma superfície de composição controlada por catálogo monta um tipo de mensagem STR presente na allowlist (STR0004, STR0005, STR0006, STR0007, STR0008 ou STR0053). O tipo escolhido deve ser resolvido no catálogo de capacidades e deve ser publicamente submetível. Caso contrário, o trilho recusa a requisição.

## Consultas assíncronas de parte única

***

Leituras de posição de reserva e de cronograma retornam um id de correlação com `PENDING`. A resposta do BACEN chega de forma assíncrona. Você a lê de volta por esse id de correlação. O Lerian SPB projeta o que o BACEN envia e não calcula nenhuma posição própria.

| Consulta                            | Código STR | Retorno                                                              |
| ----------------------------------- | ---------- | -------------------------------------------------------------------- |
| Saldo da conta Reservas Bancárias   | STR0013    | Id de correlação + `PENDING`, depois o saldo relatado pelo BACEN     |
| Extrato da conta Reservas Bancárias | STR0014    | Id de correlação + `PENDING`, depois o extrato no modo mensagem      |
| Cronograma operacional do STR       | STR0001    | Id de correlação + `PENDING`, depois as grades de janela operacional |

## Avisos recebidos e roster

***

* O trilho registra **avisos** (GEN0001, GEN0004, GEN0005) em um log de avisos consultável.
* **Transmissões de cronograma** (GEN0021) atualizam as grades de janela operacional. O último anúncio prevalece.
* Uma submissão de **responsável roster** (GEN0019) substitui completamente o roster do participante.

## Conciliação e recuperação

***

Discrepâncias de liquidação abrem casos de conciliação. Os operadores registram ações de `ACKNOWLEDGE`, `RESOLVE`, `DISMISS` ou `INVESTIGATE` em um caso. O trilho bloqueia um caso terminal. Uma visão entre trilhos de operações travadas lista os itens que precisam de atenção. Ela expõe apenas as ações que o trilho pode realizar.
