Quando usar

• Operacoes de negocio com semantica clara de recurso.
• Integracoes externas e documentacao via OpenAPI.
• Cenarios em que cache HTTP traz ganho direto.

Pontos de atencao

• Contratos devem evoluir sem quebrar clientes.
• Timeouts e retries precisam respeitar idempotencia.
• Nao misturar leitura pesada com escrita critica no mesmo endpoint.

Vantagens praticas

• Contrato tipado por .proto e serializacao eficiente.
• Streaming client/server/bidirecional.
• Baixa latencia para servicos internos.

Aplicacao no modulo

• Servico de agregacao de metricas recebendo stream de eventos.
• Gateway HTTP para traduzir chamadas do frontend.
• MediatR no backend para desacoplar transporte da regra.

Implementação do servidor

public class PedidoGrpcService : PedidoService.PedidoServiceBase
{
    public override Task<CriarPedidoResponse> CriarPedido(
        CriarPedidoRequest request, ServerCallContext context)
    {
        // regra de negocio...
        return Task.FromResult(new CriarPedidoResponse
        {
            PedidoId = "P123",
            Status = "CRIADO"
        });
    }
}

Chamada do cliente gRPC

var channel = GrpcChannel.ForAddress("https://localhost:5001");
var client = new PedidoService.PedidoServiceClient(channel);

var resp = await client.CriarPedidoAsync(new CriarPedidoRequest
{
    ClienteId = "C1",
    Itens = { new Item { ProdutoId = "P10", Quantidade = 2 },
              new Item { ProdutoId = "P20", Quantidade = 1 } }
});

REST

• Voce chama endpoints diferentes.
• Ex.: /api/pedidos/{id}, /api/clientes/{id}.
• Resposta vem no formato definido pelo backend.

GraphQL

• Voce chama um endpoint so: /graphql.
• Escolhe os campos no corpo da query.
• Resposta vem no formato pedido pelo cliente.

REST (WebApplicationFactory)

• Teste endpoint, status code, headers e payload.
• Valide cenarios de erro (400/404/409).
• Inclua contrato com OpenAPI em CI.

var res = await client.PostAsJsonAsync("/api/pedidos", req);
res.StatusCode.Should().Be(HttpStatusCode.OK);
var body = await res.Content.ReadFromJsonAsync<PedidoResponse>();
body!.Status.Should().Be("CRIADO");

GraphQL (query + mutation)

• Teste schema e autorizacao por campo sensivel.
• Valide query permitida e query bloqueada.
• Meça performance para evitar N+1.

var payload = new {
  query = "query { pedidoPorId(id:\"P123\"){ pedidoId status } }"
};
var res = await client.PostAsJsonAsync("/graphql", payload);
res.EnsureSuccessStatusCode();

Request (simplificado)

POST /graphql
Content-Type: application/json

{
  "query": "query { usuario(id:\"U1\") { id nome salario } }"
}

Observacao: salario e um campo sensivel.

Resposta esperada

{
  "errors": [
    {
      "message": "Nao autorizado para acessar o campo 'salario'.",
      "path": ["usuario", "salario"]
    }
  ],
  "data": {
    "usuario": {
      "id": "U1",
      "nome": "Ana",
      "salario": null
    }
  }
}

Estrutura

• Commands: mudam estado (write model).
• Queries: leem estado (read model).
• Handlers: implementam regra sem acoplar ao controller.
• Pipeline behaviors: validacao, log, metricas, retry local.

Por que encaixa na aula de protocolos

• Controller REST/gRPC vira adaptador de protocolo.
• Regra de negocio permanece igual, independentemente do transporte.
• Facilita evoluir de chamada sincrona para evento em fila.

OpenTelemetry (OTel)

• Instrumenta traces, metrics e logs.
• Correlacao fim-a-fim via trace-id/correlation-id.
• Ajuda a localizar gargalo entre API, broker e worker.

Prometheus

• Scrape periodico no endpoint /metrics.
• Series temporais para dashboards e alertas.
• Ideal para acompanhar throughput e saude de consumidores.