Integre a API de jogos (agregador de cassino) no meu projeto. Implemente backend + frontend conforme as especificacoes abaixo.

## Contexto
Sou um parceiro/operador que precisa:
1. Listar provedores e jogos disponiveis
2. Lançar sessoes de jogo para meus usuarios
3. Ativar/desativar modo demo por jogador direto do meu painel
4. Receber webhooks de saldo e transacoes na minha callback_url
5. Atualizar o saldo do jogador no meu sistema com idempotencia

## Base URL
https://betcodebr.com/api/v1

## Autenticacao
- GET /providers e GET /games sao publicos (sem autenticacao).
- POST /game-launch e POST /set-player-demo exigem credenciais do agente no body JSON:
  - agent_code (string, obrigatorio)
  - agent_token (string, obrigatorio)
  - agent_secret (string, obrigatorio)
- NUNCA exponha agent_token e agent_secret no frontend. O launch deve ser feito pelo backend.

## Endpoints da API (consumir)

### 1. Listar provedores
GET https://betcodebr.com/api/v1/providers

Resposta exemplo:
{
    "status": 1,
    "msg": "Lista de provedores",
    "providers": [
        {
            "id": "1",
            "code": "BG",
            "name": "BG",
            "type": "slot",
            "status": "1"
        },
        {
            "id": "2",
            "code": "CP",
            "name": "CP",
            "type": "slot",
            "status": "1"
        },
        {
            "id": "3",
            "code": "FC",
            "name": "FC",
            "type": "slot",
            "status": "1"
        }
    ]
}

### 2. Listar jogos
GET https://betcodebr.com/api/v1/games

Retorna apenas jogos ativos. Use provider + game_code retornados para o launch.

Resposta exemplo:
{
    "status": 1,
    "msg": "SUCCESS",
    "games": [
        {
            "game_name": "Alien Fruits",
            "game_code": "AG_BG_AlienFruits",
            "provider": "BG",
            "img_url": "https://betcodebr.com/storage/games/playfiver/GPKBG_AlienFruits.webp",
            "game_type": "slot",
            "status": "1",
            "original": "1",
            "distribution": "ag"
        },
        {
            "game_name": "Alien Fruits 2",
            "game_code": "AG_BG_AlienFruits2",
            "provider": "BG",
            "img_url": "https://game-assets-swst1-prd.ssapi.tech/cdn-cgi/image/f=webp,w=250,h=250/tm/bgaming/alien-fruits-2-600x600?cacheBust=2",
            "game_type": "slot",
            "status": "1",
            "original": "1",
            "distribution": "ag"
        }
    ]
}

### 3. Game launch (criar sessao)
POST https://betcodebr.com/api/v1/game-launch
Content-Type: application/json

Body obrigatorio:
- method: "game_launch" (exatamente este valor)
- agent_code, agent_token, agent_secret
- user_code: identificador unico do jogador no MEU sistema
- user_balance: saldo atual do jogador (number, deve ser > 0)
- provider_code: codigo do provedor (de /providers)
- game_code: codigo do jogo (de /games)
- lang: idioma opcional, padrao "pt"

Request exemplo:
{
    "method": "game_launch",
    "agent_code": "AGT001",
    "agent_token": "xxxxxxxx",
    "agent_secret": "yyyyyyyy",
    "user_code": "player_123",
    "user_balance": 100.5,
    "provider_code": "BG",
    "game_code": "AG_BG_AlienFruits",
    "lang": "pt"
}

Resposta sucesso (200):
{
    "status": 1,
    "msg": "SUCCESS",
    "launch_url": "https://betcodebr.com/play/AG_BG_AlienFruits/eyJ0b2tlbiI6..."
}

Use launch_url retornada para abrir o jogo em iframe ou nova aba:
<iframe src="{launch_url}" width="100%" height="720" frameborder="0" allowfullscreen></iframe>

A launch_url e protegida por token e expira por sessao — gere novamente via game-launch quando necessario.

### Erros comuns no game-launch
- 400: falha do provedor na criacao da launch_url
- 403: credenciais invalidas, jogo indisponivel ou saldo operacional insuficiente
- 404: jogo nao encontrado para o provider_code informado
- 422: validacao falhou (campos obrigatorios ausentes ou formato invalido)

### 4. Modo demo por jogador
POST https://betcodebr.com/api/v1/set-player-demo
Content-Type: application/json

Permite ativar ou desativar o modo demo de um jogador especifico direto do painel do cassino, sem acessar o painel da API.

Body obrigatorio:
- agent_code, agent_token, agent_secret
- user_code: identificador do jogador no MEU sistema
- is_demo: true para ativar, false para desativar

Request exemplo (ativar):
{
    "agent_code": "AGT001",
    "agent_token": "xxxxxxxx",
    "agent_secret": "yyyyyyyy",
    "user_code": "player_123",
    "is_demo": true
}

Resposta sucesso (200):
{
    "status": 1,
    "msg": "SUCCESS",
    "user_code": "player_123",
    "is_demo": true
}

Comportamento:
- Jogador em demo usa ambiente de testes nos provedores (ex: Open Platform pre-api)
- O saldo operacional da API AG nao e debitado em modo demo
- O saldo do jogador no jogo continua normal
- Sincroniza automaticamente com PG Soft e Spribe quando aplicavel
- Chame antes ou depois do primeiro launch — o jogador e criado automaticamente se nao existir

Implemente no meu painel um botao/toggle "Modo Demo" que chama este endpoint.

## Webhooks (minha callback_url — eu recebo)

Cada agente possui uma callback_url unica (HTTPS publica) cadastrada no painel.
A MESMA URL recebe dois tipos de evento, identificados pelo campo "method".

### Evento user_balance
Consulta/sincronizacao de saldo do jogador.

Payload recebido:
{
    "method": "user_balance",
    "user_code": "player_123",
    "user_balance": 100.5
}

Responda HTTP 200 com JSON:
{"status": 1, "user_balance": <saldo_atual_do_jogador>}

### Evento transaction
Rodada processada. O objeto interno muda conforme game_type.

Payload slot:
{
    "method": "transaction",
    "user_code": "player_123",
    "user_balance": 97.3,
    "game_type": "slot",
    "slot": {
        "provider_code": "BG",
        "game_code": "AG_BG_AlienFruits",
        "type": "BASE",
        "bet_money": 1,
        "win_money": 0.3,
        "txn_id": "txn_20260101_00001",
        "txn_type": "debit_credit"
    }
}

Payload pool:
{
    "method": "transaction",
    "user_code": "player_123",
    "user_balance": 96.8,
    "game_type": "pool",
    "pool": {
        "provider_code": "BG",
        "game_code": "pool_fish_hunter",
        "bet_money": 2,
        "win_money": 1.5,
        "txn_id": "txn_20260101_00002",
        "txn_type": "debit_credit"
    }
}

Regras:
- Responda HTTP 200 sempre
- Aplique idempotencia por txn_id no meu ledger (nao processar a mesma txn_id duas vezes)
- bet_money = valor apostado, win_money = valor ganho
- user_balance = saldo apos a transacao
- Registre logs de todos os callbacks para auditoria

## O que implementar no meu projeto

### Backend
1. Servico/classe GameApiClient com metodos: listProviders(), listGames(), launchGame(...), setPlayerDemo(userCode, isDemo)
2. Endpoint interno POST /api/games/launch (ou similar) que:
   - Autentica meu usuario logado
   - Busca saldo do jogador no meu banco
   - Chama POST /game-launch com credenciais do agente (via env/config)
   - Retorna launch_url para o frontend
3. Endpoint POST /api/games/demo (ou similar) que:
   - Autentica meu usuario logado (admin/operador)
   - Chama POST /set-player-demo com credenciais do agente
   - Retorna status atual do modo demo do jogador
4. Endpoint POST /webhooks/games (minha callback_url) que:
   - Recebe user_balance e transaction
   - Valida payload
   - Atualiza saldo do jogador
   - Registra transacao com idempotencia por txn_id
   - Retorna {"status": 1, "user_balance": <saldo>}

### Frontend
1. Pagina de catalogo consumindo meu endpoint que espelha /games (ou cache local)
2. Botao "Jogar" que chama meu backend de launch e abre launch_url em iframe/modal ou nova aba
3. Toggle/botao "Modo Demo" por jogador no painel administrativo do cassino
4. Tratamento de erros (403, 404, 422, 502) com mensagens amigaveis

### Configuracao (.env)
GAME_API_BASE_URL=https://betcodebr.com/api/v1
GAME_AGENT_CODE=seu_agent_code
GAME_AGENT_TOKEN=seu_agent_token
GAME_AGENT_SECRET=seu_agent_secret
GAME_CALLBACK_URL=https://meudominio.com/webhooks/games

### Boas praticas
- Credenciais do agente somente no backend
- callback_url em HTTPS publico
- Idempotencia por txn_id
- Cache/sync periodico de /providers e /games
- Logs de callbacks e launches

## Entregaveis
Implemente codigo completo e funcional adaptado ao stack do meu projeto.
Inclua: models/migrations se necessario, servico de integracao, rotas, controllers, tratamento de erros e exemplo de uso no frontend.
Pergunte apenas se faltar informacao critica (stack, ORM, estrutura de pastas).