Media service

Presigned uploads to R2, filter catalog, orphan reconciliation against feed, and music search, trending, and saved tracks across Apple Music, iTunes, Deezer, and Audius.

Bounded context	media
Listen port	8085
PostgreSQL schema	media
Source	splick-backend/services/media-service

Responsibilities

• Own its schema and Flyway migrations. Other services call HTTP or consume events. They do not join this schema.
• Expose public routes only through Kong. Internal routes use the internal API key.
• Publish integration facts through the transactional outbox when this service produces events. The outbox relay is the publisher.

Kong prefixes

• /api/v1/media including upload initiate and complete
• /api/v1/music including search and trending

Public clients use http://localhost:8080/api in dev and https://api.splick.app/api in production. Kong strips the /api prefix before the upstream.

Pages in this section

• Architecture
• API
• Data model
• Events
• Dependencies
• Configuration
• Observability
• Jobs
• Runbook
• Testing