# Introducao ao FluxiQ PIX

Plataforma completa para processamento de pagamentos instantaneos PIX, projetada para instituicoes financeiras e prestadores de servicos de pagamento que necessitam de conformidade total com as regulamentacoes do Banco Central do Brasil (BCB).

## O Que e o FluxiQ PIX

O FluxiQ PIX e uma solucao de infraestrutura financeira que implementa o ecossistema completo de pagamentos instantaneos PIX conforme definido pelo Banco Central do Brasil. A plataforma processa transacoes em tempo real com meta de desempenho de 5.000 TPS sustentado e 7.500 TPS em pico, atendendo aos requisitos do Acordo de Nivel de Servico (ANS) de liquidacao em ate 1,6 segundos.

## Problemas que o FluxiQ PIX Resolve

- **Complexidade regulatoria**: Implementacao completa dos protocolos DICT v2.10.0, SPI (ISO 20022), MED 2.0 e ANS, eliminando a necessidade de desenvolvimento interno dessas integracoes
- **Alta disponibilidade**: Arquitetura distribuida com circuit breaker, backpressure adaptativo e workers NATS paralelos para operacao 24/7/365
- **Seguranca**: RBAC granular, MFA (TOTP), mTLS com certificados ICP-Brasil, XMLDSig RSA-SHA256, token blacklist e rate limiting
- **Multi-cloud**: Deploy em AWS, GCP, Azure, OCI ou on-premises com Docker Compose ou Kubernetes
- **Contabilidade integrada**: Plano de contas COSIF (Circular BCB 4010) com 44 contas e lancamentos de dupla entrada
- **Monitoramento real-time**: Dashboard via WebSocket, metricas Prometheus, health checks e alertas de infraestrutura

## Capacidades Principais

| Capacidade | Descricao |
|------------|-----------|
| **DICT** | Diretorio de Identificadores de Contas Transacionais — cadastro, consulta, reivindicacao e portabilidade de chaves PIX (CPF, CNPJ, telefone, e-mail, EVP) |
| **SPI** | Sistema de Pagamentos Instantaneos — processamento de mensagens ISO 20022 (pacs.008, pacs.002, pacs.004, pacs.028) |
| **MED 2.0** | Mecanismo Especial de Devolucao — abertura, analise e fechamento de relatorios de infracao para recuperacao de fraude |
| **Liquidacao** | Ciclos de liquidacao, netting, reconciliacao e gestao de saldos entre participantes |
| **Contabilidade** | Plano de contas COSIF, lancamentos contabeis de dupla entrada, centros de custo, eventos contabeis |
| **Monitoramento** | Dashboard real-time com 6 canais WebSocket, metricas Prometheus, health checks, alertas de infraestrutura |
| **Simulador BACEN** | Simulador integrado para testes sem conexao real com o Banco Central (8 cenarios pre-configurados) |

## Publico-Alvo

- **Instituicoes financeiras** (bancos, cooperativas, financeiras) que operam como participantes diretos no SPI
- **Prestadores de servicos de pagamento (PSP)** que processam PIX como participantes indiretos
- **Fintechs** que necessitam de infraestrutura PIX completa e conformidade regulatoria
- **Integradores de sistemas** que implementam solucoes PIX para clientes do setor financeiro

## Pre-requisitos

Para utilizar esta documentacao, voce deve ter conhecimento basico de:

- Conceitos do ecossistema PIX (DICT, SPI, participantes)
- Docker e orquestracao de containers (Docker Compose ou Kubernetes)
- Administracao de bancos de dados PostgreSQL
- Protocolos HTTP/REST e mensageria (NATS JetStream)

## Visao Geral da Arquitetura

O FluxiQ PIX e composto por 4 aplicacoes Elixir/Phoenix em arquitetura umbrella, um portal administrativo Vue 3 e integracoes externas com o Banco Central, Core Banking e clientes.

```mermaid
graph TB
    subgraph Clientes
        WEB[Portal Admin<br/>Vue 3 + Tailwind]
        API_CLIENT[Clientes API<br/>REST / Webhook]
    end

    subgraph FluxiQ PIX
        GW[Settlement Service<br/>API Gateway :4003]
        DICT[Dict Service<br/>DICT v2.10 :4001]
        SPI[SPI Service<br/>ISO 20022 :4002]
        SHARED[Shared<br/>Auth, Crypto, DB, NATS]

        GW --> DICT
        GW --> SPI
        DICT --> SHARED
        SPI --> SHARED
        GW --> SHARED
    end

    subgraph Infraestrutura
        PG[(PostgreSQL 16<br/>8 schemas)]
        REDIS[(Redis 7<br/>Cache + Rate Limit)]
        NATS[NATS JetStream<br/>7 streams]
    end

    subgraph Integracoes Externas
        BACEN[Banco Central<br/>DICT API + SPI]
        CORE[Core Banking<br/>NATS Events]
    end

    WEB -->|HTTPS + WSS| GW
    API_CLIENT -->|HTTPS + Webhook| GW

    GW --> PG
    GW --> REDIS
    GW --> NATS

    DICT --> PG
    SPI --> PG
    SPI --> NATS

    DICT -.->|mTLS + XMLDSig| BACEN
    SPI -.->|mTLS + XMLDSig| BACEN
    NATS <-.->|JetStream Events| CORE
```

## Resultado Esperado

Ao final da leitura desta introducao, voce tera uma visao geral das capacidades da plataforma FluxiQ PIX e estara preparado para aprofundar-se nos seguintes topicos:

- [Arquitetura do Sistema](./architecture.md) — detalhes tecnicos da arquitetura interna
- [Requisitos](./requirements.md) — hardware, software e certificados necessarios
- [Inicio Rapido](./quick-start.md) — deploy em 15 minutos com Docker Compose
- [Conceitos PIX](./concepts.md) — glossario e conceitos fundamentais do ecossistema PIX