feat(enrich): обогащение треков через Discogs + самохостинг обложек (WebP)

При первом появлении трека подтягиваем жанр/стиль/лейбл/год из Discogs
и сохраняем обложку в едином формате WebP 500x500 у себя (/covers). Дальше
пользователю отдаём только из своей БД — внешние сервисы в рантайме не дёргаем.

- Track: +genre/styles/label/year/discogsId/enrichStatus (миграция)
- EnrichModule: DiscogsService (поиск), CoverStorageService (sharp->webp),
  EnrichmentService (очередь с троттлингом + бэкафилл-крон каждые 10 мин)
- charts: фильтр чартов по жанру (?genre=), GET /charts/genres,
  жанр/стиль/лейбл/год в выдаче чарта и детальной странице
- main: раздача /covers статикой; docker: volume covers_data + env
  DISCOGS_TOKEN/PUBLIC_BASE_URL/COVERS_DIR
- убран MusicBrainz-фолбэк (заменён Discogs)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
nk
2026-06-03 13:28:08 +03:00
parent 24ed44e8ab
commit 0efba7c691
14 changed files with 863 additions and 67 deletions

View File

@@ -0,0 +1,12 @@
-- Обогащение треков (Discogs): жанр/стили/лейбл/год + состояние обогащения
ALTER TABLE "tracks" ADD COLUMN "genre" TEXT;
ALTER TABLE "tracks" ADD COLUMN "styles" TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[];
ALTER TABLE "tracks" ADD COLUMN "label" TEXT;
ALTER TABLE "tracks" ADD COLUMN "year" INTEGER;
ALTER TABLE "tracks" ADD COLUMN "discogs_id" INTEGER;
-- Все треки стартуют как pending: бэкафилл добавит жанр/стиль/лейбл из Discogs
-- и сохранит обложку в WebP (в т.ч. накопленным ранее трекам)
ALTER TABLE "tracks" ADD COLUMN "enrich_status" TEXT NOT NULL DEFAULT 'pending';
-- CreateIndex
CREATE INDEX "tracks_genre_idx" ON "tracks"("genre");

View File

@@ -124,12 +124,21 @@ model Track {
coverUrl String? @map("cover_url")
album String?
releaseDate DateTime? @map("release_date")
// Обогащение через Discogs (своя БД — в рантайме к Discogs не ходим)
genre String?
styles String[] @default([])
label String?
year Int?
discogsId Int? @map("discogs_id")
// Состояние обогащения: pending | done | failed
enrichStatus String @default("pending") @map("enrich_status")
firstSeenAt DateTime @default(now()) @map("first_seen_at")
enrichedAt DateTime? @map("enriched_at")
plays TrackPlay[]
likes TrackLike[]
@@index([genre])
@@map("tracks")
}