Solução 02 - Arquitetura e Gateway 🏗️

- Os hóspedes (clientes) chegam na recepção (gateway) em vez de ir direto aos quartos (serviços)
- A recepção **verifica a identidade** (autenticação), distribui as chaves (autorização) e direciona para o setor correto
- Se há um problema no elevador (falha em um serviço), a recepção informa e oferece alternativas
- Centraliza o **controle de acesso** e **monitora** quem entra e sai

O Gateway gerencia **roteamento**, **segurança** e **monitoramento** de todas as chamadas para os microsserviços.

**Comunicação Assíncrona**: O cliente envia a solicitação e **continua** suas atividades, recebendo a resposta quando estiver pronta (como um WhatsApp).

```mermaid
graph TD
    A[Cliente Web] -->|1. Requisição| B[API Gateway]
    B -->|2. Timeout| C[Serviço Usuário]
    C -->|3. Query Lenta| D[Banco de Dados 🐌]

    B -->|4. Bloqueado| E[Outros Serviços]
    B -->|5. Fila de Requisições| F[Mais Clientes ⏰]

    style D fill:#ff6b6b
    style F fill:#ff9999
```

**Consequências:**
- **Timeouts** em cascata afetam todos os serviços
- **Thread pool** do servidor se esgota aguardando o banco
- **Usuários** experimentam lentidão crescente
- **Site pode ficar indisponível** mesmo com outros serviços funcionando

**Solução**: Circuit breaker, timeout configurado, cache, réplicas de leitura.

**❌ Sem Gateway (Descentralizado):**
- **20 implementações** diferentes de autenticação
- **20 pontos de falha** de segurança
- **Inconsistência** nas regras de negócio
- **Dificuldade** para auditoria e logs

**✅ Com Gateway (Centralizado):**
- **1 ponto de controle** para todas as chamadas
- **Padronização** das validações de token
- **Auditoria centralizada** de acessos
- **Facilita** rotação de chaves e políticas de segurança

**🔴 Abordagem Síncrona:**
```mermaid
sequenceDiagram
    Cliente->>+Checkout: Finalizar Compra
    Checkout->>+Pagamento: Processar
    Pagamento-->>-Checkout: ✅ Aprovado
    Checkout->>+Notificação: Enviar E-mail
    Note over Notificação: ❌ SERVIÇO FORA DO AR
    Notificação-->>-Checkout: ❌ ERRO 500
    Checkout-->>-Cliente: ❌ FALHA NA COMPRA
```

**Resultado**: ❌ **Compra falha completamente**, mesmo com pagamento aprovado!

**✅ Abordagem Assíncrona com Filas:**
```mermaid
sequenceDiagram
    Cliente->>+Checkout: Finalizar Compra
    Checkout->>+Pagamento: Processar
    Pagamento-->>-Checkout: ✅ Aprovado
    Checkout->>Fila: Publicar Evento
    Note over Fila: 📧 E-mail agendado
    Checkout-->>-Cliente: ✅ COMPRA CONFIRMADA

    Note over Notificação: ❌ Serviço fora do ar
    Note over Fila: Mensagens acumulando...

    Note over Notificação: ✅ Serviço voltou!
    Fila->>+Notificação: Processar E-mails
    Notificação-->>-Fila: ✅ E-mails enviados
```

**Benefícios**:
- ✅ **Compra é finalizada** independentemente da notificação
- ✅ **E-mails são enviados** quando o serviço voltar
- ✅ **Experiência do usuário** preservada
- ✅ **Resilência** automática do sistema

**🔄 Exemplo de Serviço que PRECISA ser Síncrono:**
- **Validação de CPF/Cartão** durante pagamento
- **Consulta de saldo** bancário
- **Autenticação/Login** de usuários
- **Verificação de estoque** para produtos limitados

Estes serviços **bloqueiam a operação** se falharem, pois são críticos para a decisão imediata.

    # 2. Salva pedido
    pedido = salvar_pedido(dados)

    # 3. Agenda notificação (assíncrono)
    queue.publish({
        "evento": "pedido_criado",
        "pedido_id": pedido.id,
        "email": dados.email
    })

    # 4. Resposta imediata para o cliente
    return {"sucesso": True, "pedido_id": pedido.id}, 201
```