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

# Operação do Lerian SPB

> Operação do Lerian SPB: janelas de funcionamento do STR do BACEN (GEN0021), rotação do certificado de assinatura ICP-Brasil, contingência e conciliação de liquidação caso a caso.

O Lerian SPB opera dentro de duas realidades operacionais do STR. O STR abre apenas dentro das janelas de funcionamento do BACEN. A liquidação é sempre assíncrona. O trilho persiste cada mensagem antes de despachá-la, então nunca envia uma mensagem não registrada.

## Janelas de funcionamento

***

O BACEN anuncia as grades de janela de funcionamento do STR pelo GEN0021. O trilho as persiste, e você consulta as grades atuais com o STR0001. Uma visão de agenda ao vivo lista os horários de abertura e de fechamento por data de referência. O último anúncio para uma data de referência prevalece.

O trilho não impõe uma rejeição genérica de cada envio fora de uma janela de funcionamento. A sua regra explícita de admissão ligada à agenda é a RLPI0007: durante a janela de aporte adicional, ele rejeita um aporte para uma Conta PI de terceiros. Aportes para a Conta PI da própria instituição e resgates continuam permitidos.

## Rotação de certificados

***

O trilho faz hot reload do par de certificados de assinatura ICP-Brasil sem reiniciar. Uma rotação troca o ponteiro de assinatura em memória e grava evidência de auditoria. Uma ativação anuncia o novo certificado ao BACEN pelo GEN0006. As respostas nunca expõem o caminho da chave privada nem qualquer material de chave. Avisos de certificado aparecem nas visões de readiness e de resumo antes de o certificado expirar.

## Contingência e durabilidade

***

* **Persistir antes de enviar** garante que o trilho não despacha nenhuma mensagem não registrada.
* Uma **varredura de despacho** repete o trabalho de saída travado.
* Um operador repete manualmente uma **entrega de evento que falhou**. Uma entrega que esgota as novas tentativas passa ao estado `EXHAUSTED`.

## Conciliação

***

A conciliação abre um caso por divergência de liquidação no nível da operação. Um operador resolve um caso registrando uma ação sobre ele. O trilho tranca um caso terminal. Ninguém pode reabri-lo nem registrar uma nova ação sobre ele.

## Invariantes de liquidação

***

Dois invariantes valem o tempo todo:

* **Um envio é despacho, não confirmação.** `SUBMITTED` ou `PENDING` significa que o trilho aceitou o despacho. Apenas a perna R de entrada produz `CONFIRMED` ou `REJECTED`. Essa perna R carrega os campos de liquidação do BACEN, por exemplo `numCtrlSTR` e `sitLancSTR`, projetados literalmente.
* **O trilho é neutro em relação ao dinheiro.** Ele encaminha os valores declarados exatamente e não calcula posição nem saldo. O seu consumidor de ledger registra qualquer posição contábil.