Hands-on Sandbox

Simule a execução de um Nó Raiz (Root Node) de liquidação nacional no seu ambiente de desenvolvimento. Uma topologia completa conteinerizada com Docker Compose pronta para testes conectando IFs simuladas.

1. Pré-requisitos

O Numo orquestra serviços pesados como Kafka, PostgreSQL (múltiplas instâncias) e bases na memória. Necessita de Docker e Docker Compose V2. Recomendado 16GB de RAM na máquina host.

2. Executando o Stack Base (Core + Ledger + Stream)

~ / developer bash
$ git clone https://github.com/inbox-ong/numoCore
$ cd numoCore
$ docker-compose up -d

[+] Running 5/5
✔ Container numocore-zookeeper-1 Started
✔ Container numocore-kafka-1 Started
✔ Container numocore-postgres-1 Started
✔ Container numocore-redis-1 Started
✔ Container numocore-api-1 Started
$ docker ps --format "table {{.Names}}\t{{.Ports}}"

3. APIs Operacionais

Com o núcleo executando, a API de liquidação (`numoCore`) estará disponível em localhost:8080. Você pode submeter lotes de mensagens ISO JSON.

curl - HTTP POST pacs.008
$ curl -X POST http://localhost:8080/v1/settle \
   -H "Content-Type: application/json" \
   -d '{"msg_id":"MSG123","sender":"BANK_A","receiver":"BANK_B","amount":1500.00}'

{"status":"processing", "tx_id":"NX-A91B-2026"}

4. Explorando a Interface (Em Breve)

O repositório `numoAdmin-next` contém a interface gráfica administrativa onde você visualiza o barramento na prática. Rode-o paralelamente.