# kemalkochekov/grpc-server architecture

> Architecture diagram of the GitHub repository kemalkochekov/grpc-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kemalkochekov/grpc-server
- Repository: https://github.com/kemalkochekov/grpc-server

## Overview

This Go service exposes student and class-information CRUD over gRPC, with an HTTP/JSON gateway translating REST requests into RPC calls. Those handlers validate and transform requests, persist records in PostgreSQL, and publish operation events to Kafka; a background consumer reads Kafka messages. Startup also configures logging and Jaeger tracing. The excerpts establish these principal paths, but do not show class-info’s proto contract or the detailed SQL implementations, so those relationships are limited to what the handlers and startup wiring demonstrate.

Main entry points: [`internal/server/studentHandler.go`](https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/studentHandler.go) (Student service), [`internal/server/classInfoHandler.go`](https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/classInfoHandler.go) (Class info service), [`internal/server/router.go`](https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/router.go) (gRPC server), [`internal/server/gatewayRouter.go`](https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/gatewayRouter.go) (HTTP gateway)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API access"]
  node_gateway["HTTP gateway<br/>[gatewayRouter.go]"]
  node_grpc["gRPC server<br/>[router.go]"]
  node_studentproto["Student RPC contract<br/>[student.proto]"]
  node_classproto["Class RPC contract<br/>[classInfo.proto]"]
end

subgraph group_domain["Domain operations"]
  node_student["Student service<br/>[studentHandler.go]"]
  node_classinfo["Class info service"]
  node_studentmodel["Student model<br/>[student.go]"]
  node_classmodel["Class info model<br/>[classInfo.go]"]
end

subgraph group_data["Persistence"]
  node_studentrepo["Student repository<br/>[studentPg.go]"]
  node_classrepo["Class repository<br/>[classInfoPg.go]"]
  node_dbaccess["Database access<br/>[connection.go]"]
  node_postgres[("PostgreSQL")]
end

subgraph group_messaging["Kafka messaging"]
  node_producer["Kafka producer<br/>[producer.go]"]
  node_consumer["Kafka consumer<br/>[consumer.go]"]
  node_kafka["Kafka broker"]
end

subgraph group_runtime["Runtime services"]
  node_config["DB configuration<br/>[dbConfig.go]"]
  node_logger["Structured logging<br/>[logger.go]"]
  node_tracing["Jaeger tracing"]
end

node_client(("API client"))

node_client -->|"sends HTTP"| node_gateway
node_gateway -->|"proxies RPC"| node_grpc
node_grpc -.->|"dispatches calls"| node_student
node_grpc -.->|"dispatches calls"| node_classinfo
node_studentproto -->|"defines HTTP routes"| node_gateway
node_classproto -.->|"defines HTTP routes"| node_gateway
node_student -->|"calls CRUD"| node_studentrepo
node_classinfo -->|"calls CRUD"| node_classrepo
node_student -->|"publishes events"| node_producer
node_classinfo -->|"publishes events"| node_producer
node_producer -.->|"writes messages"| node_kafka
node_kafka -.->|"delivers messages"| node_consumer
node_studentrepo -.->|"uses database"| node_dbaccess
node_classrepo -.->|"uses database"| node_dbaccess
node_dbaccess -->|"queries"| node_postgres
node_config -->|"configures connection"| node_dbaccess
node_student -->|"maps requests"| node_studentmodel
node_classinfo -->|"maps requests"| node_classmodel
node_student -->|"creates spans"| node_tracing
node_classinfo -->|"creates spans"| node_tracing
node_client -.->|"calls RPC"| node_grpc
node_grpc -.->|"serves contract"| node_studentproto
node_grpc -.->|"serves contract"| node_classproto
node_student -->|"logs operations"| node_logger
node_classinfo -->|"logs operations"| node_logger

click node_gateway "https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/gatewayRouter.go"
click node_grpc "https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/router.go"
click node_student "https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/studentHandler.go"
click node_classinfo "https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/classInfoHandler.go"
click node_studentmodel "https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/serviceEntities/student.go"
click node_classmodel "https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/serviceEntities/classInfo.go"
click node_studentrepo "https://github.com/kemalkochekov/grpc-server/blob/master/internal/repository/studentPg.go"
click node_classrepo "https://github.com/kemalkochekov/grpc-server/blob/master/internal/repository/classInfoPg.go"
click node_dbaccess "https://github.com/kemalkochekov/grpc-server/blob/master/pkg/connection/connection.go"
click node_producer "https://github.com/kemalkochekov/grpc-server/blob/master/internal/kafka/producer.go"
click node_consumer "https://github.com/kemalkochekov/grpc-server/blob/master/internal/kafka/consumer.go"
click node_config "https://github.com/kemalkochekov/grpc-server/blob/master/internal/configs/dbConfig.go"
click node_logger "https://github.com/kemalkochekov/grpc-server/blob/master/internal/logger/logger.go"
click node_studentproto "https://github.com/kemalkochekov/grpc-server/blob/master/proto/student.proto"
click node_classproto "https://github.com/kemalkochekov/grpc-server/blob/master/proto/classInfo.proto"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gateway,node_grpc,node_studentproto,node_classproto,node_client toneBlue
class node_student,node_classinfo,node_studentmodel,node_classmodel toneAmber
class node_studentrepo,node_classrepo,node_dbaccess,node_postgres toneMint
class node_producer,node_consumer,node_kafka toneRose
class node_config,node_logger,node_tracing toneIndigo
```

## Components

### API access

- [HTTP gateway](https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/gatewayRouter.go): `internal/server/gatewayRouter.go`
- [gRPC server](https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/router.go): `internal/server/router.go`
- [Student RPC contract](https://github.com/kemalkochekov/grpc-server/blob/master/proto/student.proto): `proto/student.proto`
- [Class RPC contract](https://github.com/kemalkochekov/grpc-server/blob/master/proto/classInfo.proto): `proto/classInfo.proto`

### Domain operations

- [Student service](https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/studentHandler.go): `internal/server/studentHandler.go`
- [Class info service](https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/classInfoHandler.go): `internal/server/classInfoHandler.go`
- [Student model](https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/serviceEntities/student.go): `internal/server/serviceEntities/student.go`
- [Class info model](https://github.com/kemalkochekov/grpc-server/blob/master/internal/server/serviceEntities/classInfo.go): `internal/server/serviceEntities/classInfo.go`

### Persistence

- [Student repository](https://github.com/kemalkochekov/grpc-server/blob/master/internal/repository/studentPg.go): `internal/repository/studentPg.go`
- [Class repository](https://github.com/kemalkochekov/grpc-server/blob/master/internal/repository/classInfoPg.go): `internal/repository/classInfoPg.go`
- [Database access](https://github.com/kemalkochekov/grpc-server/blob/master/pkg/connection/connection.go): `pkg/connection/connection.go`
- **PostgreSQL**

### Kafka messaging

- [Kafka producer](https://github.com/kemalkochekov/grpc-server/blob/master/internal/kafka/producer.go): `internal/kafka/producer.go`
- [Kafka consumer](https://github.com/kemalkochekov/grpc-server/blob/master/internal/kafka/consumer.go): `internal/kafka/consumer.go`
- **Kafka broker**

### Runtime services

- [DB configuration](https://github.com/kemalkochekov/grpc-server/blob/master/internal/configs/dbConfig.go): `internal/configs/dbConfig.go`
- [Structured logging](https://github.com/kemalkochekov/grpc-server/blob/master/internal/logger/logger.go): `internal/logger/logger.go`
- **Jaeger tracing**

### Other components

- **API client**

## Connections

- API client → HTTP gateway: sends HTTP (evidence: `README.md`)
- HTTP gateway → gRPC server: proxies RPC (evidence: `internal/server/gatewayRouter.go`)
- gRPC server → Student service: dispatches calls
- gRPC server → Class info service: dispatches calls
- Student RPC contract → HTTP gateway: defines HTTP routes (evidence: `proto/student.proto`)
- Class RPC contract → HTTP gateway: defines HTTP routes
- Student service → Student repository: calls CRUD (evidence: `internal/server/studentHandler.go`)
- Class info service → Class repository: calls CRUD (evidence: `internal/server/classInfoHandler.go`)
- Student service → Kafka producer: publishes events (evidence: `internal/server/studentHandler.go`)
- Class info service → Kafka producer: publishes events (evidence: `internal/server/classInfoHandler.go`)
- Kafka producer → Kafka broker: writes messages
- Kafka broker → Kafka consumer: delivers messages
- Student repository → Database access: uses database
- Class repository → Database access: uses database
- Database access → PostgreSQL: queries (evidence: `pkg/connection/connection.go`)
- DB configuration → Database access: configures connection (evidence: `pkg/connection/connection.go`)
- Student service → Student model: maps requests (evidence: `internal/server/studentHandler.go`)
- Class info service → Class info model: maps requests (evidence: `internal/server/classInfoHandler.go`)
- Student service → Jaeger tracing: creates spans (evidence: `internal/server/studentHandler.go`)
- Class info service → Jaeger tracing: creates spans (evidence: `internal/server/classInfoHandler.go`)
- API client → gRPC server: calls RPC
- gRPC server → Student RPC contract: serves contract
- gRPC server → Class RPC contract: serves contract
- Student service → Structured logging: logs operations (evidence: `internal/server/studentHandler.go`)
- Class info service → Structured logging: logs operations (evidence: `internal/server/classInfoHandler.go`)
