GeezerVison

██████╗ ██████╗  ██████╗ ██████╗  █████╗ ██╗   ██╗
██╔══██╗██╔══██╗██╔═══██╗██╔══██╗██╔══██╗╚██╗ ██╔╝
██████╔╝██████╔╝██║   ██║██████╔╝███████║ ╚████╔╝
██╔═══╝ ██╔══██╗██║   ██║██╔═══╝ ██╔══██║  ╚██╔╝
██║     ██║  ██║╚██████╔╝██║     ██║  ██║   ██║
╚═╝     ╚═╝  ╚═╝ ╚═════╝ ╚═╝     ╚═╝  ╚═╝   ╚═╝

             **Gateway de Pagamentos - ProStaff Ecosystem**

╔══════════════════════════════════════════════════════════════════════════╗
║  PROPAY - Roda / Iodine (Ruby 3.4)                                       ║
╠══════════════════════════════════════════════════════════════════════════╣
║  Gateway de pagamentos proprietário do ecossistema ProStaff.             ║
║  PIX único · PIX recorrente · Carteira interna · Prize pool · p95 < 50ms ║
╚══════════════════════════════════════════════════════════════════════════╝

QUICK START

cp .env.example .env
# Edite .env → PROPAY_OPENPIX_APP_ID, PROPAY_OPENPIX_SECRET, PROPAY_PIX_KEY, INTERNAL_JWT_SECRET
docker compose up -d
curl http://localhost:5555/v1/health
# {"status":"ok","version":"1.0.0"}

cp .env.example .env
bundle install
bundle exec ruby -e "require_relative 'config/database'; Sequel::Migrator.run(DB, 'db/migrations')"
RUBYOPT="--yjit --yjit-exec-mem-size=8" bundle exec iodine -p 5555

TECHNOLOGY STACK

ARCHITECTURE

INTERNET
    |
  Traefik (TLS - Let's Encrypt)
    |
    +-- api.prostaff.gg       → prostaff-api   (Rails,  :3000)
    +-- events.prostaff.gg    → prostaff-events (Phoenix, :4000)
    +-- scraper.prostaff.gg   → ProStaff-Scraper (FastAPI, :8000)
    +-- propay.prostaff.gg    → ProPay           (Roda,   :5555)

REDE DOCKER: coolify
    |
    +-- prostaff-api    → PostgreSQL, Redis, Meilisearch, Sidekiq
    +-- prostaff-events → Redis (compartilhado)
    +-- riot-gateway    → interno
    +-- propay          → propay-db (PostgreSQL próprio), Redis DB 1

FRONTENDS (Cloudflare Pages)
    +-- ArenaBR
    +-- Scrims.lol
    +-- ProStaff Analytics Hub

[Frontend] → POST /v1/wallet/deposit
                ↓
             ProPay cria Charge + OpenPix API
                ↓
             ← {qr_code, qr_code_url, txid}
                ↓
          [Usuário paga no banco]
                ↓
          OpenPix → POST /v1/webhooks/openpix
                ↓
          PixWebhookJob (Sidekiq)
                ↓
          WalletService.credit! (SELECT FOR UPDATE)
                ↓
          propay_wallets.balance_cents += amount
          propay_wallet_transactions INSERT (imutável)

propay/
├── app/
│   ├── handlers/      # Roda route handlers
│   ├── services/      # Lógica de negócio
│   ├── jobs/          # Sidekiq workers
│   ├── models/        # Sequel models
│   ├── providers/     # OpenPix / Efi
│   ├── middleware/    # Auth, idempotência, rate limit
│   └── validators/    # dry-validation schemas
├── bin/
│   └── start          # entrypoint: roda migrations + inicia iodine
├── db/migrations/
├── config/
├── config.ru
├── Gemfile
├── Dockerfile
└── docker-compose.yml

SETUP

# 1. Dependências
bundle install

# 2. Banco
createdb propay_development
bundle exec ruby -e "require_relative 'config/database'; Sequel::Migrator.run(DB, 'db/migrations')"

# 3. Variáveis
cp .env.example .env

# 4. Rodar
bundle exec sidekiq -C config/sidekiq.yml -r ./config/sidekiq_boot.rb &  # Terminal 1
RUBYOPT="--yjit" bundle exec iodine -p 5555                                # Terminal 2

API ENDPOINTS

Saúde

Cobranças PIX

{
  "amount_cents": 10000,
  "description": "Inscrição Copa ArenaBR #1",
  "reference_type": "tournament_registration",
  "reference_id": 42,
  "expires_in_seconds": 3600
}

{
  "data": {
    "txid": "7978c0c97ea847e78e8849634473c1f9",
    "status": "active",
    "amount_cents": 10000,
    "qr_code": "00020126580014br.gov.bcb.brcode...",
    "qr_code_url": "https://propay.prostaff.gg/qr/7978c0c9",
    "expires_at": "2026-05-05T15:00:00Z"
  }
}

Assinaturas

Clientes

Carteira

Admin

Observabilidade

PROVIDERS PIX

BACKGROUND JOBS

WEBHOOKS

DEPLOYMENT

services:
  propay-db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: propay_development
      POSTGRES_USER: propay
      POSTGRES_PASSWORD: ${PROPAY_DB_PASSWORD}
    volumes:
      - propay_db_data:/var/lib/postgresql/data
    networks:
      - propay-internal

  redis:
    image: redis:7-alpine
    networks:
      - propay-internal

  propay:
    build: .
    environment: &propay-env
      DB_HOST: propay-db
      DB_PORT: "5432"
      DB_NAME: propay_development
      DB_USER: propay
      DB_PASSWORD: ${PROPAY_DB_PASSWORD}
      REDIS_URL: redis://redis:6379/1
      INTERNAL_JWT_SECRET: ${INTERNAL_JWT_SECRET}
      PROPAY_OPENPIX_APP_ID: ${PROPAY_OPENPIX_APP_ID}
      PROPAY_OPENPIX_SECRET: ${PROPAY_OPENPIX_SECRET}
      PROPAY_PIX_KEY: ${PROPAY_PIX_KEY}
      PROSTAFF_API_URL: ${PROSTAFF_API_URL:-https://api.prostaff.gg}
      MALLOC_ARENA_MAX: "2"
    networks:
      - propay-internal
      - coolify

  propay-worker:
    build: .
    command: bundle exec sidekiq -C config/sidekiq.yml -r ./config/sidekiq_boot.rb
    environment: *propay-env
    networks:
      - propay-internal

volumes:
  propay_db_data:

networks:
  propay-internal:
    driver: bridge
  coolify:
    external: true

ENVIRONMENT VARIABLES