How marcisebestyen/relay works
Relay is an early-stage background-job orchestration platform. The evidenced runtime workflow is starting the API command: the CLI loads and validates configuration, opens PostgreSQL, builds the HTTP router, and serves health/readiness endpoints. The README also documents database migration operations. Although configuration includes worker settings, the supplied tree shows no worker runtime or job-submission/execution implementation, so those stages are not represented. Unsampled implementation details are omitted.
Main entry points: api.go API command · cli.go Command setup · migrate.go Migration commands · router.go Route registration
Components 16
Process entry
- Relay CLI
relay-backend/cmd/relay/main.go - Command setup
relay-backend/internal/cli/cli.go - Configuration
relay-backend/internal/config/config.go - Role validation
relay-backend/internal/config/validate.go - Logging
relay-backend/internal/observability/logging/logging.go
HTTP service
- API command
relay-backend/internal/cli/api.go - HTTP server
relay-backend/internal/api/serve.go - Route registration
relay-backend/internal/api/router.go - Request middleware
relay-backend/internal/api/middleware.go - Error responses
relay-backend/internal/api/errors.go
Persistence
- PostgreSQL pool
relay-backend/internal/persistence/db/db.go - Migration commands
relay-backend/internal/cli/migrate.go - Migration runner
relay-backend/internal/persistence/migrate/migrate.go - Migration files
relay-backend/migrations/migrations.go - PostgreSQL
Other components
- Operator
Connections 20
- Operator → Relay CLI: runs command
README.md - Relay CLI → Command setup: executes
relay-backend/cmd/relay/main.go - Command setup → Configuration: loads settings
relay-backend/internal/cli/cli.go - Command setup → Role validation: validates role
relay-backend/internal/cli/cli.go - Command setup → Logging: creates logger
relay-backend/internal/cli/cli.go - Command setup → API command: registers
relay-backend/internal/cli/cli.go - Operator → API command: runs API
README.md - API command → PostgreSQL pool: opens pool
relay-backend/internal/cli/api.go - API command → Route registration: builds routes
relay-backend/internal/cli/api.go - API command → HTTP server: serves handler
relay-backend/internal/cli/api.go - Route registration → Request middleware: registers
relay-backend/internal/api/router.go - Route registration → PostgreSQL pool: pings readiness
relay-backend/internal/api/router.go - Route registration → Error responses: writes envelopes
relay-backend/internal/api/router.go - API command → Migration commands: registers
- Operator → Migration commands: runs migration
README.md - Migration commands → PostgreSQL pool: opens pool
relay-backend/internal/cli/migrate.go - Migration commands → Migration runner: creates runner
relay-backend/internal/cli/migrate.go - Migration commands → Migration files: loads embedded files
relay-backend/internal/cli/migrate.go - Migration runner → PostgreSQL: applies SQL
relay-backend/internal/persistence/migrate/migrate.go - PostgreSQL pool → PostgreSQL: connects
relay-backend/internal/persistence/db/db.go