📚 Pré-requisitos Teóricos: este projeto aplica conceitos ensinados na Especialização em Backend com Go & Gin. Recomendado revisar antes de iniciar.

🐹 Microsserviço gRPC de Alta Performance com Protocol Buffers

v1.0 — Go gRPC, Protobuf v3, HTTP/2 Multiplexing, RPC Binário, Streaming Bidirecional

Série Prática Golang — Projeto Especializado

• ➡️ Projeto: 🐹 Microsserviço gRPC de Alta Performance com Protocol Buffers
• Subpasta Canônica: api-grpc/

🏛️ Visão Geral & Arquitetura Visual

O projeto Microsserviço gRPC de Alta Performance com Protocol Buffers desenvolve um subsistema de comunicação inter-serviços de altíssima velocidade para ambientes de microsserviços distribuídos. A solução baseia-se em contratos formais com Protocol Buffers v3, transporte multiplexado sobre HTTP/2 e serialização binária compacta, proporcionando latência substancialmente menor do que APIs REST baseadas em JSON.

📁 Estrutura de Pastas Anti-Colisão

Os artefatos em Go, manifests e arquivos de configuração estão organizados na subpasta canônica api-grpc/:

catalogo_projetos/backend_golang_03_grpc_microservices/
├── assets/
│   └── arquitetura_golang_03.svg
├── api-grpc/
│   ├── main.go
│   ├── README.md
│   └── ...
└── index.md

🧑‍💼 Engenharia de Software & Especificação Formal

1. Histórias de Usuário (User Stories)

2. Requisitos do Sistema

Requisitos Funcionais (RF)

• RF-01: Definir contrato de serviço em proto/usuario.proto com mensagens e métodos RPC.
• RF-02: Gerar código Go tipado a partir do contrato utilizando o compilador protoc.
• RF-03: Implementar servidor gRPC registrando o serviço implementado.
• RF-04: Implementar cliente de teste efetuando chamadas RPC unárias.
• RF-05: Tratar códigos de status canônicos gRPC (OK, NotFound, InvalidArgument).

Requisitos Não-Funcionais (RNF)

• RNF-01 (Baixa Sobrecarga de Rede): Payload binário até 70% menor em comparação a JSON.
• RNF-02 (Multiplexação HTTP/2): Múltiplas chamadas simultâneas sobre uma única conexão TCP.
• RNF-03 (Segurança de Tipos): Verificação rigorosa de tipos na compilação dos stubs.
• RNF-04 (Interoperabilidade Poliglota): Contrato consumível nativamente por clientes em Go, Python, Java ou C#.
• RNF-05 (Resiliência a Falhas): Deadlines e timeouts propagados pelo context.Context.

3. Diagrama de Casos de Uso

flowchart TD
    Client[(fa:fa-server Microsserviço Cliente)]
    Proto[(fa:fa-file-lines Contrato Protobuf)]
    Server[(fa:fa-gears Engine gRPC HTTP/2)]

    subgraph AppGRPCServer ["🐹 Servidor gRPC Go (api-grpc)"]
        UC01["Compilar Contrato .proto"]
        UC02["Implementar Interface de Serviço"]
        UC03["Atender Chamadas RPC Unárias"]
        UC04["Gerenciar Streams Bidirecionais"]
        UC05["Validar Payload Binário Tipado"]
    end

    Proto --> UC01
    UC01 --> UC02
    Client --> UC03
    UC03 --> Server
    Client --> UC04
    UC04 --> Server
    Server --> UC05

4. Matriz de Rastreabilidade (RTM)

🛠️ Implementação Guiada

ℹ️ O trecho de código que ficava aqui não correspondia ao código do projeto e foi retirado. Consulte os arquivos em api-grpc.

🚀 Como Executar no Laboratório

1. Navegue até a subpasta do projeto

cd catalogo_projetos/backend_golang_03_grpc_microservices/api-grpc

2. Execute via Go Toolchain

go run .

🏁 Matriz de Checkpoints de Conclusão