# FluxiQ PIX 简介

一个完整的 PIX 即时支付处理平台，专为需要完全符合巴西中央银行 (BCB) 法规的金融机构和支付服务提供商设计。

## 什么是 FluxiQ PIX

FluxiQ PIX 是一套金融基础设施解决方案，实现了巴西中央银行定义的完整 PIX 即时支付生态系统。该平台处理实时交易，目标为持续 5,000 TPS 和突发 7,500 TPS，满足服务级别协议 (ANS) 要求的 1.6 秒内完成清算。

## FluxiQ PIX 解决的问题

- **监管复杂性**：完整实现 DICT v2.10.0、SPI (ISO 20022)、MED 2.0 和 ANS 协议，消除内部开发这些集成的需要
- **高可用性**：分布式架构，配备断路器、自适应背压和并行 NATS workers，支持 24/7/365 运营
- **安全性**：细粒度 RBAC、MFA (TOTP)、ICP-Brasil 证书的 mTLS、XMLDSig RSA-SHA256、Token 黑名单和速率限制
- **多云部署**：支持在 AWS、GCP、Azure、OCI 或本地部署，使用 Docker Compose 或 Kubernetes
- **集成会计**：COSIF 会计科目表 (BCB Circular 4010)，含 44 个账户和复式记账分录
- **实时监控**：WebSocket 仪表板、Prometheus 指标、健康检查和基础设施告警

## 核心能力

| 能力 | 描述 |
|------|------|
| **DICT** | 交易账户标识符目录 -- PIX 密钥的注册、查询、认领和携转 (CPF、CNPJ、电话、邮箱、EVP) |
| **SPI** | 即时支付系统 -- 处理 ISO 20022 消息 (pacs.008、pacs.002、pacs.004、pacs.028) |
| **MED 2.0** | 特殊退回机制 -- 开立、分析和关闭欺诈追回违规报告 |
| **清算** | 清算周期、净额计算、对账和参与者间余额管理 |
| **会计** | COSIF 会计科目表、复式记账分录、成本中心、会计事件 |
| **监控** | 6 个 WebSocket 频道的实时仪表板、Prometheus 指标、健康检查、基础设施告警 |
| **BACEN 模拟器** | 无需真实央行连接的集成测试模拟器 (8 个预配置场景) |

## 目标受众

- **金融机构** (银行、信用合作社、金融公司) 作为 SPI 直接参与者运营
- **支付服务提供商 (PSP)** 作为间接参与者处理 PIX
- **金融科技公司** 需要完整的 PIX 基础设施和监管合规
- **系统集成商** 为金融行业客户实施 PIX 解决方案

## 前提条件

使用本文档，您应具备以下基本知识：

- PIX 生态系统概念 (DICT、SPI、参与者)
- Docker 和容器编排 (Docker Compose 或 Kubernetes)
- PostgreSQL 数据库管理
- HTTP/REST 协议和消息传递 (NATS JetStream)

## 架构概览

FluxiQ PIX 由 4 个 Elixir/Phoenix umbrella 架构应用、一个 Vue 3 管理门户以及与中央银行、核心银行和 API 客户端的外部集成组成。

```mermaid
graph TB
    subgraph Clients
        WEB[管理门户<br/>Vue 3 + Tailwind]
        API_CLIENT[API 客户端<br/>REST / Webhook]
    end

    subgraph FluxiQ PIX
        GW[Settlement Service<br/>API 网关 :4003]
        DICT[Dict Service<br/>DICT v2.10 :4001]
        SPI[SPI Service<br/>ISO 20022 :4002]
        SHARED[Shared<br/>认证, 加密, 数据库, NATS]

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

    subgraph Infrastructure
        PG[(PostgreSQL 16<br/>8 个 schemas)]
        REDIS[(Redis 7<br/>缓存 + 速率限制)]
        NATS[NATS JetStream<br/>7 个流]
    end

    subgraph External Integrations
        BACEN[中央银行<br/>DICT API + SPI]
        CORE[核心银行<br/>NATS 事件]
    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 事件| CORE
```

## 预期结果

阅读本简介后，您将对 FluxiQ PIX 平台的功能有一个概览，并准备好探索以下主题：

- [系统架构](./architecture.md) -- 内部架构的技术细节
- [要求](./requirements.md) -- 硬件、软件和证书要求
- [快速开始](./quick-start.md) -- 使用 Docker Compose 在 15 分钟内部署
- [PIX 概念](./concepts.md) -- 术语表和 PIX 生态系统基本概念