How domenick1991/students works
This is a student-information service exposing gRPC and HTTP/JSON APIs, plus asynchronous Kafka upserts. API requests are translated to domain models, handled by the student service, and backed by PostgreSQL; Kafka messages pass through a consumer and processor into the same service. The graph includes the protobuf contract and the principal runtime components. Several wiring files were indexed but not excerpted, so edges based on those references are limited to visible construction or documented registration; uncertain internal calls are omitted.
Main entry points: main.go Application startup · student_service_api Student API handlers · studentsService Student service · server.go Server runtime
Components 14
Runtime entrypoints
- Application startup
cmd/app/main.go - Server runtime
internal/bootstrap/server.go
API surface
- Students API contract
api/students_api/students.proto - Student model contract
api/models/student_model.proto - HTTP gateway
internal/bootstrap/server.go - Student API handlers
internal/api/student_service_api
Kafka ingestion
- Upsert consumer
internal/consumer/students_Info_upsert_consumer/consume.go - Upsert processor
internal/services/processors/students_info_processor
Student domain
- Student service
internal/services/studentsService - Student domain model
internal/models/models.go
Persistence
- PostgreSQL storage
internal/storage/pgstorage
Other components
- API client
- Kafka broker
- PostgreSQL database
Connections 17
- Application startup → Server runtime: starts
cmd/app/main.go - Application startup → Student service: initializes
cmd/app/main.go - Application startup → Upsert consumer: initializes
cmd/app/main.go - Application startup → Upsert processor: initializes
cmd/app/main.go - Server runtime → Student API handlers: serves
internal/bootstrap/server.go - Server runtime → HTTP gateway: runs
internal/bootstrap/server.go - HTTP gateway → API client: serves HTTP
internal/bootstrap/server.go - HTTP gateway → Students API contract: registers routes
internal/bootstrap/server.go - API client → Student API handlers: calls gRPC
- Students API contract → Student model contract: uses model
api/students_api/students.proto - Student API handlers → Student service: calls
internal/api/student_service_api/get_student_info_by_ids.go - Student API handlers → Student domain model: maps data
internal/api/student_service_api/get_student_info_by_ids.go - Kafka broker → Upsert consumer: delivers messages
internal/consumer/students_Info_upsert_consumer/consume.go - Upsert consumer → Upsert processor: handles message
internal/consumer/students_Info_upsert_consumer/consume.go - Upsert processor → Student service: upserts
- Student service → PostgreSQL storage: uses storage
internal/bootstrap/student_service.go - PostgreSQL storage → PostgreSQL database: queries