---
layout: home

hero:
  name: STA Connector
  text: Integracao BCB Simplificada
  tagline: Servico Elixir/Phoenix para troca bidirecional de arquivos com o WebService STA do Banco Central do Brasil
  image:
    src: /logo.svg
    alt: STA Connector
  actions:
    - theme: brand
      text: Primeiros Passos
      link: /pt/guide/installation
    - theme: alt
      text: Ver API
      link: /pt/api/
    - theme: alt
      text: Arquitetura
      link: /pt/architecture/

features:
  - icon: "\uD83D\uDE80"
    title: Alto Desempenho
    details: Construido com Elixir/Phoenix para baixa latencia e alto throughput. Modelo de concorrencia baseado em processos leves da BEAM processa arquivos de forma eficiente.
  - icon: "\uD83D\uDEE1\uFE0F"
    title: Tolerante a Falhas
    details: Supervisores OTP, circuit breakers, retry com backoff e shutdown gracioso garantem operacao confiavel. Recuperacao automatica de falhas transitorias.
  - icon: "\uD83D\uDCCA"
    title: Observabilidade Completa
    details: Endpoint de metricas integrado, health checks, logging estruturado com Logger e dashboard administrativo React completo.
  - icon: "\uD83D\uDD04"
    title: Troca Bidirecional
    details: Suporte completo para polling de entrada (download de arquivos do BCB) e uploads de saida (envio de arquivos para o BCB).
  - icon: "\uD83C\uDFAF"
    title: Compativel com BCB
    details: Respeita limites de taxa do BCB (10 conexoes simultaneas, 120 consultas/minuto) com throttling e enfileiramento integrados.
  - icon: "\uD83D\uDD0C"
    title: Integracao Facil
    details: APIs REST para operacoes de arquivo e administracao. Configuracao simples com arquivos de configuracao Elixir e variaveis de ambiente.
---

## Visao Geral Rapida

O STA Connector fornece uma ponte robusta entre seus sistemas e o WebService STA (Sistema de Transferencia de Arquivos) do Banco Central do Brasil.

```
+-------------------+         +-------------------+         +-------------------+
|  Seus Sistemas    |<------->|  STA Connector    |<------->|      BCB STA      |
|    (REST API)     |         | (Elixir/Phoenix)  |         |   (SOAP/HTTPS)    |
+-------------------+         +-------------------+         +-------------------+
                                      |
                              +-------v-------+
                              |  Portal Admin |
                              |    (React)    |
                              +---------------+
```

### Sistemas BCB Suportados

| Sistema | Descricao | Direcao |
|---------|-----------|---------|
| CCS | Sistema de Consulta ao Cliente | Entrada/Saida |
| CIR | Central de Informacoes de Credito | Entrada |
| CMP | Controle de Meios de Pagamento | Entrada |
| STR | Sistema de Transferencia de Reservas | Entrada/Saida |
| SPI | Sistema de Pagamentos Instantaneos (PIX) | Entrada/Saida |
| CAM | Sistema de Cambio | Entrada |
| LDL | Liquidacao Diferida | Entrada |
| DICT | Diretorio de Identificadores de Contas Transacionais (PIX) | Entrada/Saida |

## Primeiros Passos

```bash
# Clonar o repositorio
git clone https://github.com/MonetarieBR/sta
cd sta

# Instalar dependencias
mix deps.get

# Configurar ambiente
cp .env.example .env
nano .env  # Adicione suas credenciais

# Configurar banco de dados
mix ecto.setup

# Iniciar o servidor Phoenix
mix phx.server

# O backend estara disponivel em http://localhost:4000
# Acessar o portal administrativo em http://localhost:4000/admin
```

[Leia o guia completo de instalacao](/pt/guide/installation)

## Stack Tecnologico

| Componente | Tecnologia |
|------------|------------|
| Backend | Elixir 1.16+, Phoenix 1.7+, OTP |
| Banco de Dados | PostgreSQL / SQLite (Ecto) |
| Frontend | React 18, TypeScript, Tailwind |
| Implantacao | Docker, Kubernetes |

## Documentacao

- **[Instalacao](/pt/guide/installation)** - Guia de configuracao rapida
- **[Instalacao](/pt/guide/installation)** - Metodos de instalacao detalhados
- **[Configuracao](/pt/guide/configuration)** - Referencia de configuracao Elixir
- **[Pipeline de Entrada](/pt/guide/inbound)** - Recebendo arquivos do BCB
- **[Pipeline de Saida](/pt/guide/outbound)** - Enviando arquivos para o BCB
- **[Atualizacoes em Tempo Real](/pt/guide/realtime)** - Monitoramento em tempo real
- **[Arquitetura](/pt/architecture/)** - Design do sistema e componentes
- **[Esquema do Banco de Dados](/pt/architecture/database)** - Modelo de dados
- **[Referencia da API](/pt/api/)** - Documentacao da API REST
- **[API Admin](/pt/api/admin)** - Endpoints de administracao
- **[API de Saida](/pt/api/outbound)** - Endpoints de upload de arquivos
- **[Monitoramento](/pt/api/channels)** - Monitoramento baseado em polling
- **[Implantacao Kubernetes](/pt/deployment/kubernetes)** - Guia de implantacao Kubernetes
- **[Solucao de Problemas](/pt/troubleshooting)** - Problemas comuns e solucoes