SEEN/backend/README.md

Seen Backend (Phase 2 Skeleton)

This is a runnable Go backend skeleton for /seen/ with:

• Gin HTTP API with versioned routes (/api/v1)
• PostgreSQL connectivity (pgx pool)
• Dragonfly/Redis connectivity
• Auth service scaffolding (register/login/refresh)
• Baseline workers/downloader/scanner interfaces
• Unified movie/show/game catalog model
• Metadata provider configuration for TMDB and IGDB
• Optional live IGDB game-search augmentation when credentials are present
• Migrations and sqlc query layout placeholders

Run locally

cp .env.example .env
go mod tidy
go run ./cmd/api

Populate these external metadata credentials in .env to enable provider-backed metadata lookups:

• SEEN_TMDB_API_KEY
• SEEN_IGDB_CLIENT_ID
• SEEN_IGDB_CLIENT_SECRET

IGDB should be accessed server-side only through the backend.

Health endpoints

• GET /api/v1/health/live
• GET /api/v1/health/ready

Auth endpoints (skeleton)

• POST /api/v1/auth/register
• POST /api/v1/auth/login
• POST /api/v1/auth/refresh

Placeholder endpoints

• GET /api/v1/movies
• GET /api/v1/shows
• GET /api/v1/watchlist
• GET /api/v1/downloads
• GET /api/v1/library
• GET /api/v1/recommendations

Live catalog slice endpoints

• GET /api/v1/dashboard
• GET /api/v1/progress/continue-watching
• GET /api/v1/discover
• GET /api/v1/games
• GET /api/v1/search
• GET /api/v1/watch-later
• POST /api/v1/watch-later
• DELETE /api/v1/watch-later/:mediaId
• POST /api/v1/progress

Migrations

SQL files are in migrations/ and currently include:

• auth/session baseline schema
• catalog schema + seeded discover dataset
• user watch later persistence table
• user progress persistence table