How go-masterskaya/media-service works
Media Service stores owner-associated media, streams uploads, persists metadata, and serves downloads through gRPC or an embeddable Go client. The main service path validates and stages uploads, probes media, stores originals, then queues thumbnail/transcode work; callers retrieve metadata or stream/download variants. Postgres holds metadata and jobs while MinIO holds binaries. Reconciliation, expiration cleanup, and optional Kafka event handling are separate operational branches. Relationships are limited to calls or dependencies evidenced by excerpts, the source index, or README; several unsampled internals are therefore not linked in detail.
Main entry points: main.go Service Runtime · service.go Media Service · minio.go MinIO Adapter · media.go Postgres Repositories
Components 27
Access Interfaces
- Service Runtime
cmd/mediaservice/main.go - gRPC API
internal/api/media.go - Upload Stream
internal/api/upload.go - Health Probes
internal/api/health.go - Go Client
pkg/mediaservice/client.go - Client Media API
pkg/mediaservice/media.go - Media Contract
proto/media/v1/media.proto
Media Domain
- Media Service
internal/media/service.go - Upload Pipeline
internal/media/upload.go - Deletion
internal/media/delete.go - Expiration Reaper
internal/media/reaper.go - Storage Reconciler
internal/media/reconciler.go - Temporary Uploads
internal/upload/tempstore.go
Media Processing
- Job Engine
internal/processing/engine.go - Thumbnail Handler
internal/processing/handler_thumbnail.go - Transcode Handler
internal/processing/handler_transcode.go
Persistence
- Postgres
- Postgres Repositories
internal/repo/media.go - MinIO Adapter
internal/storage/minio.go
Operations and Events
- Kafka Consumer
internal/events/kafka_consumer.go - Event Handler
internal/events/handler.go - Configuration
internal/config/config.go
Other components
- gRPC Caller
- Embedding App
- MinIO
- FFmpeg
- Kafka
Connections 36
- gRPC Caller → gRPC API: calls RPCs
README.md - gRPC Caller → Upload Stream: streams upload
README.md - gRPC API → Media Contract: implements contract
internal/api/media.go - Upload Stream → Upload Pipeline: calls upload
internal/api/upload.go - gRPC API → Media Service: calls domain
internal/api/media.go - Service Runtime → gRPC API: registers server
cmd/mediaservice/main.go - Service Runtime → Health Probes: starts probes
- Service Runtime → Configuration: loads config
cmd/mediaservice/main.go - Service Runtime → Media Service: constructs service
- Service Runtime → Job Engine: starts engine
cmd/mediaservice/main.go - Service Runtime → Kafka Consumer: starts optionally
cmd/mediaservice/main.go - Service Runtime → Expiration Reaper: starts reaper
cmd/mediaservice/main.go - Service Runtime → Storage Reconciler: starts reconciler
cmd/mediaservice/main.go - Embedding App → Go Client: uses library
README.md - Go Client → Media Service: constructs core
pkg/mediaservice/client.go - Client Media API → Media Service: delegates media calls
pkg/mediaservice/media.go - Media Service → Postgres Repositories: reads and writes
internal/media/service.go - Media Service → MinIO Adapter: accesses objects
internal/media/service.go - Upload Pipeline → Temporary Uploads: stages chunks
internal/media/upload.go - Upload Pipeline → Job Engine: queues processing
- Job Engine → Thumbnail Handler: dispatches jobs
- Job Engine → Transcode Handler: dispatches jobs
- Thumbnail Handler → MinIO Adapter: reads source
internal/processing/handler_thumbnail.go - Thumbnail Handler → FFmpeg: generates thumbnail
internal/processing/handler_thumbnail.go - Transcode Handler → FFmpeg: transcodes media
internal/processing/handler_transcode.go - Transcode Handler → MinIO Adapter: stores derivative
internal/processing/handler_transcode.go - Kafka Consumer → Kafka: consumes events
- Kafka Consumer → Event Handler: dispatches records
- Event Handler → Postgres Repositories: tracks processing
internal/events/handler.go - Deletion → Postgres Repositories: updates records
internal/media/delete.go - Deletion → MinIO Adapter: deletes objects
internal/media/delete.go - Storage Reconciler → Postgres Repositories: checks records
internal/media/reconciler.go - Storage Reconciler → MinIO Adapter: checks objects
internal/media/reconciler.go - Expiration Reaper → Media Service: expires media
- Postgres Repositories → Postgres: persists metadata
README.md - MinIO Adapter → MinIO: stores binaries
README.md