Technical Design Document (TDD) - Samba de Ouro

Projeto: 02 - Samba de Ouro Versão: 1.0 Data: 2026-04-03 Plataforma: VLT Cloud-based

1. Integração Pool Finito

Fluxo idêntico ao Jogo 01, mas otimizado para 243 Ways e Jackpot Pick.

2. Reel Strip Configuration (243 Ways)

Reel Mapping Exemplo (RTP 95%)

Rolo 1 (40 Paradas): 00-09: Cartas baixas (9-A) 10-13: Tartaruga 14-15: Páscoa 16-17: Gongo (Scatter) 18-39: Blanks

Rolos 2-4 (50 Paradas): 00-03: Pandeiro (Wild) - Zona de Ouro 04: Gongo 05-15: Símbolos Médios 16-49: Cartas baixas + Blanks

Rolo 5 (40 Paradas): Similar ao Rolo 1, com mais densidade de Páscoa

3. RTP Adjustment via Reel Density

Configuração 90% (Rua): - Wilds: 2 por rolo (em vez de 4) - Gongos: 1 apenas - Retrigger em Free Spins: 1/25 (mais difícil)

Configuração 97% (VIP): - Wilds: 6 por rolo (zona muito densa) - Gongos: 2 em rolos 2-4 - Retrigger: 1/12 (fácil), até 100 giros acumuláveis

4. Outcome Builder para 243 Ways

```csharp public int[] BuildOutcome243Ways(int targetPrize, VirtualReels reels) { for (int r1 = 0; r1 < reels[0].Count; r1++) { for (int r2 = 0; r2 < reels[1].Count; r2++) { for (int r3 = 0; r3 < reels[2].Count; r3++) { for (int r4 = 0; r4 < reels[3].Count; r4++) { for (int r5 = 0; r5 < reels[4].Count; r5++) { // Calcula todas as 243 combinações possíveis int prize = Calculate243WaysPay(r1, r2, r3, r4, r5); if (prize == targetPrize) { return new[] { r1, r2, r3, r4, r5 }; } } } } } } // Fallback para Jackpot Pick return FallbackJackpotPick(targetPrize); }

private int Calculate243WaysPay(int r1, int r2, int r3, int r4, int r5) { int totalWin = 0;

// 243 Ways = 1x1x3 x 1x1x3 x 1x1x3 x 1x1x3 x 1x1x3
// Cada combinação de posições verticais conta como um "caminho"
for (int p1 = 0; p1 < 3; p1++) {
    for (int p2 = 0; p2 < 3; p2++) {
        for (int p3 = 0; p3 < 3; p3++) {
            for (int p4 = 0; p4 < 3; p4++) {
                for (int p5 = 0; p5 < 3; p5++) {
                    Symbol s1 = reels[0][r1].Symbols[p1];
                    Symbol s2 = reels[1][r2].Symbols[p2];
                    Symbol s3 = reels[2][r3].Symbols[p3];
                    Symbol s4 = reels[3][r4].Symbols[p4];
                    Symbol s5 = reels[4][r5].Symbols[p5];

                    if (IsWinningCombination(s1, s2, s3, s4, s5)) {
                        totalWin += GetPayment(s1, s2, s3, s4, s5);
                    }
                }
            }
        }
    }
}
return totalWin;

} ```

5. Jackpot Pick Mechanics

```csharp public class JackpotPickEngine {

public JackpotResult GeneratePickTable(int serverDictatedPrize) {
    JackpotType targetJackpot = DeterminJackpotType(serverDictatedPrize);

    // Cria 12 máscaras, 3 de cada tipo
    List<Mask> masks = new List<Mask> {
        new Mask(JackpotType.Mini),
        new Mask(JackpotType.Mini),
        new Mask(JackpotType.Mini),
        new Mask(JackpotType.Minor),
        // ... até 12
    };

    // Embaralha
    ShuffleMasks(masks);

    // Garante que targetJackpot apareça (mas quando revelado?)
    // Estratégia: posições 1-2 são "iscos", posição 3 é o resultado

    return new JackpotResult {
        Masks = masks,
        CorrectSelection = FindMaskIndex(targetJackpot),
        WinAmount = CalculateJackpotValue(targetJackpot, originalWager)
    };
}

} ```

6. Free Spins State Machine

```csharp public class FreeSpinsEngine { private int spinsRemaining = 10; private bool scattersRemoved = true; // A/K/Q/J/9/10 removidos

public void OnFreeSpinOutcome(int[] reelStops) {
    int scatterCount = CountScatters(reelStops);

    if (scatterCount >= 3) {
        // Retrigger!
        spinsRemaining += 10;
        TriggerRetriggerAnimation();
    }

    spinsRemaining--;

    if (spinsRemaining == 0) {
        ExitFreeSpins();
    }
}

} ```

7. G2S Integration

Spin Request: json { "terminal_id": "000002", "game_id": "02_SAMBA_OURO", "wager": 8800, // 88 créditos em centavos "coins_active": 5, // Número de moedas de ouro "request_type": "spin" }

Spin Response: json { "spin_id": "SP2_20260403_000002", "prize": 8800, // 100x a aposta base (1.0x) "bonus_triggered": false, "jackpot_triggered": false, "crc": "0xABCDEF" }

8. Hardware/Software Stack

• VltCore.dll (base)
• PoolFiniteClient.dll (comunicação)
• OutcomeBuilder243Ways.dll (novo módulo)
• JackpotPickEngine.dll (bônus)
• ReelEngine.dll (renderização 243 ways)

9. Performance Metrics

10. Security & Audit

• Reel Strips: Encriptadas com AES-256
• RTP Mode: Locked após inicialização (requer Lottopar unlock)
• Jackpot Draws: Criptograficamente selados (HMAC-SHA256)
• Logs: Enviados para servidor a cada 100 spins

Status: Pronto para QA Versão: 1.0

Prompts de Geração de Arte IA

Clique em qualquer prompt para copiar. Os prompts abaixo são otimizados para Midjourney v6, DALL-E 3, e Stable Diffusion.