# Complemento de arquitetura - Monetarie Core, PIX e SPB
Data: 2026-06-21
Uso previsto: anexo ao relatório de validação do cliente
Ambiente: homologação AWS
Escopo: Core Bancário SCD, PIX Administrativo, SPB Administrativo e serviços de apoio
Última conferência: 2026-06-21 16:08 BRT
## 1. Objetivo
Este documento complementa o relatório de validação do ambiente Monetarie, apresentando uma visão clara da arquitetura aplicada para Core, PIX e SPB em homologação.
O foco é demonstrar como os sistemas se organizam em camadas, como são acessados, quais componentes sustentam a operação e quais capacidades foram validadas visualmente e funcionalmente.
## 2. Visão executiva
O ecossistema Monetarie em homologação foi estruturado em AWS com acesso interno controlado, domínios privados, serviços conteinerizados, banco relacional gerenciado, cache operacional, mensageria interna e ledger dedicado.
As aplicações principais estão separadas por domínio de negócio:
- Core Bancário SCD: administração, contas, crédito, tarifas, tesouraria e relatórios.
- PIX Administrativo: painel operacional, monitor de operações, participantes, DICT, MED, mensagens e relatórios.
- SPB Administrativo: operação administrativa e acompanhamento de mensageria financeira.
O ambiente foi validado por navegação automatizada em navegador, com login administrativo, carregamento das telas e captura de evidências visuais.
Na conferência operacional mais recente, o ambiente apresentou 15 serviços de aplicação em execução, 15 balanceamentos internos saudáveis, 23 hosts internos respondendo HTTP 200 e 36 screenshots validados para Core, PIX e SPB.
## 3. Diagrama do ecossistema
Arquivo fonte do diagrama:
`docs/architecture/diagrams/client-ecosystem-architecture.mmd`
Imagem renderizada:
`docs/architecture/diagrams/client-ecosystem-architecture.svg`
```mermaid
flowchart TB
user["Equipe Monetarie"] --> vpn["Acesso seguro
VPN corporativa"]
vpn --> portal["Domínios internos
monetarie.internal"]
portal --> core["Core Bancário SCD
gestão administrativa, contas, tarifas e crédito"]
portal --> pix["PIX Administrativo
monitor operacional, DICT, SPI, MED e mensagens"]
portal --> spb["SPB Administrativo
mensageria, operação e acompanhamento"]
portal --> docs["Portal de Documentação
apoio operacional"]
core --> data["Camada de dados
Aurora PostgreSQL"]
pix --> data
spb --> data
core --> ledger["Ledger
TigerBeetle"]
core --> events["Eventos internos
NATS"]
pix --> events
spb --> events
core --> cache["Cache operacional
Redis"]
pix --> cache
spb --> cache
pix --> integrations["Integrações financeiras
PIX, RSFN, HSM RTM"]
spb --> integrations
classDef primary fill:#dff4eb,stroke:#0a7c5b,color:#0b342d;
classDef support fill:#eef4ff,stroke:#395eaa,color:#152b55;
classDef access fill:#f7f7f7,stroke:#8c969a,color:#172226;
class core,pix,spb primary;
class data,ledger,events,cache,docs,integrations support;
class user,vpn,portal access;
```
## 4. Camadas da arquitetura
### 4.1 Acesso
O acesso ao ambiente de homologação é feito por canal seguro e domínios internos. As telas administrativas ficam disponíveis somente dentro da rede autorizada.
Principais entradas:
- Core Admin
- PIX Admin
- SPB Admin
- Portal de documentação
### 4.2 Aplicações
As aplicações estão publicadas como serviços isolados, com separação por domínio. Essa organização reduz acoplamento, facilita validações por módulo e permite evolução progressiva do ambiente.
Domínios principais:
- Core
- PIX
- SPB
- NPC
- STA
- CLST
- Backoffice
- Documentação
### 4.3 Dados
A camada relacional utiliza Aurora PostgreSQL, centralizando as bases lógicas do ambiente de homologação em um cluster gerenciado. Esse modelo reduz custo operacional no ambiente de homologação e preserva capacidade de escalabilidade quando necessário.
### 4.4 Cache e mensageria
O Redis sustenta cache operacional e suporte a sessões ou dados transientes quando necessário. O NATS atua como camada de eventos internos entre domínios.
### 4.5 Ledger
O TigerBeetle sustenta a função de ledger no ecossistema, com versão fixada e validada para a homologação atual.
### 4.6 Integrações financeiras
O desenho contempla integrações financeiras do PIX e SPB com componentes externos de infraestrutura financeira, incluindo HSM RTM e conectividade RSFN quando aplicável ao fluxo.
O Core Bancário não assina mensagens TED, PIX, SPB, DICT, ICOM-SPI ou mensagens operacionais BACEN. O Core publica eventos internos via NATS, enquanto as cabines PIX e SPB executam assinatura, decifragem e validação das mensagens financeiras dos seus respectivos domínios.
## 5. Capacidades validadas
Foram validadas as seguintes capacidades no ambiente de homologação:
- Autenticação administrativa no Core, PIX e SPB.
- Navegação por telas principais dos três sistemas.
- Identidade visual Monetarie aplicada nas telas capturadas.
- Painel do Core e páginas administrativas.
- Painel PIX, monitor operacional, participantes, mensagens, MED e relatórios.
- Painel SPB administrativo e operacional.
- Serviços internos respondendo com saúde operacional.
- Monitor PIX com comunicação em tempo real.
- Camadas de dados e serviços de apoio ativas.
## 6. Evidências relacionadas
Relatório cliente:
`/Users/luizpenha/Desktop/Relatorio_Cliente_Monetarie_AWS_Homolog_Core_PIX_SPB_2026-06-21.pdf`
Diretório de evidências:
`/Users/luizpenha/Desktop/monetarie-evidencias-aws-homolog-2026-06-21`
Quantidade de screenshots validados:
- Total: 36
- Core: 12
- PIX: 11
- SPB: 13
## 7. Observações de governança
O ambiente foi estruturado para homologação, com recursos dimensionados para custo controlado e capacidade suficiente para validação funcional.
As credenciais administrativas e segredos operacionais são tratados fora da documentação, por mecanismos seguros de gerenciamento de segredos.
Existe um documento operacional restrito de acessos de homologação mantido fora do repositório e fora do pacote do cliente. Ele não compõe este anexo e não deve ser distribuído externamente.
Este complemento acompanha o relatório de validação do cliente como visão arquitetural de alto nível, com foco em governança, escopo funcional e organização dos componentes principais.