# Registro de atuacao PIX/SPB pos-validacao 2026-06-27

Este registro fixa o escopo decidido apos a leitura dos documentos 00-08, codigo
Monetarie atual, LegadoPIX, LegadoSPB e AWS homolog no profile `vulcimonetarie`.
Nao substitui issue tracker; serve como trilha objetiva para evitar reclassificacao
errada de dominio.

## Taxonomia fixada

- `trck.002` e PIX/SPI, nao SPB.
- `SGCT/PIX Automatico` fica fora da atuacao imediata por decisao de escopo do
  cliente neste ciclo.
- `RDC` e Redesconto do Banco Central, nao Registro de Duplicatas/Cheques e nao
  clearing `CMP`.

## Itens atuados neste ciclo

1. SPB Reforma Tributaria v5.12:
   - Validar `CodDocFis` obrigatorio no grupo Split.
   - Mapear `RSTR0039/RSTR0040` para `ESTR0151/ESTR0152` em STR e
     `EPAG0068/EPAG0069` em PAG.
2. SPB RDC:
   - Corrigir seed do grupo `RDC` para Redesconto.
   - Remover `RDC0011` e `RDC0017` do catalogo seed v5.12.
   - Corrigir descricoes internas de `RDC`.
3. PIX/SPI TRCK002:
   - Trocar builder MED antigo (`urn:bcb:pix:trck.002.001.01` / `TrckReq`) pelo
     builder SPI oficial `trck.002.spi.1.1`.
   - Falhar fechado quando os campos obrigatorios do XSD nao forem fornecidos.
4. PIX catalogo de mensagens:
   - Print de homolog `pix-09-messages.png` mostrou 21 tipos, mas o catalogo SPI
     5.12 de negocio tem 27 tipos (`xmldsig` fica fora).
   - Smoke API homolog confirmou o mesmo em `/api/v1/messages/types`: 21/27,
     faltando `camt.014`, `pain.014`, `reda.016`, `reda.017`, `reda.041` e
     `trck.002`.
   - API corrigida para incluir `camt.014`, `pain.014`, `reda.016`, `reda.017`,
     `reda.041` e `trck.002`.
   - Frontend deixou de usar atalhos fixos e passa a mostrar categorias vindas da
     API, incluindo `TRCK`.
   - Pos-deploy `monetarie-pix-api-homolog:76`: smoke homolog retornou 27/27,
     faltantes `[]`, extras `[]`, categorias `ADMI=2`, `CAMT=8`, `PACS=3`,
     `PAIN=5`, `PIBR=2`, `REDA=6`, `TRCK=1`.
5. SPB UI operacional:
   - Prints `spb-06-admin-entities.png` e `spb-10-operator-payments.png`
     mostraram ingles operacional e contador `Payments ()`.
   - Telas de Entidades e Pagamentos traduzidas para PT-BR e contador corrigido.
   - Tela de saldos SPB deixou de inventar Conta PI: sem saldo BACEN real em
     `/api/balances`, a UI mostra `--`/`Sem dado`.
6. PIX homolog smoke autorizado:
   - Login, sessao, health, estatisticas, transacoes, saldo, echo e seis acoes
     CAMT.060 responderam OK.
   - CAMT.060 retornou `bacen.sent=true` nas seis acoes testadas.
   - Pos-deploy v76: catalogo vivo responde 27/27. Isso prova o catalogo e as
     chamadas testadas, nao todos os fluxos SPI possiveis.
7. PIX saldo dashboard:
   - Print pre-correcao mostrava `R$ 9.160.772.444,16`.
   - Balance truth probe provou `raw_total_centavos=9160772444.16`, ou seja
     `R$ 91.607.724,44`.
   - Dashboard e tela de saldos PIX foram corrigidos para tratar centavos e nao
     inventar RB quando nao ha posicao materializada.
8. Core/IB PIX/TED:
   - Probe pre-correcao mostrou PIX aceito, mas resposta `amount=100` para
     payload `amount=1`; TED direto retornava `amount=1` para payload `amount=100`;
     UI TED mandava payload sem campos STR obrigatorios.
   - Backend Core passou a usar `MoneyUnit.from_cents` na entrada e
     `MoneyUnit.to_cents` na saida.
   - Banking UI passou a exigir/enviar nome, CPF/CNPJ, ISPB, agencia e conta.
   - Pos-deploy `core-api:48` e `core-banking-ui:12`: PIX `amount=1` retornou
     `1`; TED UI corrigido `amount=100` retornou `100`; TED direto `amount=100`
     retornou `100`.
   - Status-poll do PIX Core/IB ainda retorna 404 para `PIXOUT-*`; fica como gap
     real de timeline/rastreio.

## Proximos itens em execucao

1. PIX Batch/Multiliquidacao:
   - Evidencia Monetarie: apenas `shared/schemas/settlement_batch.ex`; router SPI
     removeu `pain.001/002` por nao estarem no raw XSD 5.12.
   - Evidencia LegadoPIX: `LegadoPIX/Multiliquidacao/src` contem dominio
     `ArquivoPagamento`, `ArquivoPagamentoDetalhe`, `Operacao`, `InicPagto`,
     `SolicitacaoPagamento`, workers e DTOs.
   - Proxima acao segura: implementar primeiro API interna de lote no
     `settlement_service` baseada em modelo proprio, sem declarar `pain.001/002`
     como SPI oficial.
2. PIX Composite QR:
   - Evidencia Monetarie: rota existe em `/api/v1/qr-codes/composite`, mas
     `CompositeQRCodeController` retornava `501`.
   - Evidencia LegadoPIX: `GerarQRCodeComposto`, `AlterarQRCodeComposto` e
     `CancelarQRCodeComposto` existem no `EntradaController`; `GerarEMVComposto`
     usa URL dinamica + URL recorrente no payload EMV.
   - Proxima acao segura: portar o contrato composto com validacoes do DTO legado,
     retornando `emv`, `urlLinkPagto`, `idTransacao`, `accessToken`,
     `idRecorrencia`, sem misturar com SGCT.
3. SPB Piloto/Reserva/Desdobro:
   - Evidencia LegadoSPB: `PilotoController` expoe `ConsisteSaldoReserva`,
     `EnviarOperacoes`, `CancelarOperacoes`, `ConverterOperacoes`, consultas de
     saldo, reprocessamento, timeout e geracao de desdobro SLC/CSD.
   - Evidencia Monetarie: ha CRUD de auto-split e `MessageSplitter`, mas nao esta
     provada a paridade operacional completa do Piloto legado.
   - Proxima acao segura: criar uma fachada `PilotController` autenticada que
     reaproveite `ReconciliationEngine`, `MessageSplitter`, `MessagePipeline` e
     consultas existentes antes de portar regras especificas SLC/CSD.

## Backlog deliberadamente posterior

- SGCT/PIX Automatico APIs 9.9-9.13 e controllers dedicados de recorrencia ficam
  anotados para a proxima frente, por orientacao do cliente em 2026-06-27.