Добавил поиск метаданных по каталогам

internal/metadata/metadata.go

@@ -0,0 +1,45 @@
+// Package metadata — интерфейс баз метаданных и клиенты TMDB/TVDB.
+//
+// Базы опциональны (включаются конфигом). Их роль — подтвердить распознавание
+// официальным id и каноническим именем: при единичном сильном матче по
+// названию+году раскладка делается автоматически, иначе уходит в review
+// (см. docs/specs/recognition.md → «Модель уверенности»). Каждый клиент
+// ходит наружу через опциональный HTTP-прокси с таймаутом.
+package metadata
+
+import "context"
+
+// MediaType — вид контента в запросе к базе.
+type MediaType string
+
+const (
+	Movie  MediaType = "movie"
+	Series MediaType = "series"
+)
+
+// Query — запрос поиска в базе.
+type Query struct {
+	Type  MediaType
+	Title string // каноническое название или provider_hint
+	Year  int    // 0 — без ограничения по году
+}
+
+// Candidate — результат поиска: официальный id и каноническое имя.
+type Candidate struct {
+	Provider      string // "tmdb" | "tvdb"
+	ID            string
+	Title         string
+	OriginalTitle string
+	Year          int
+}
+
+// Provider — одна база метаданных.
+type Provider interface {
+	// Name — идентификатор провайдера ("tmdb"/"tvdb"), он же префикс тега.
+	Name() string
+	// Search ищет кандидатов по названию (и году, если задан).
+	Search(ctx context.Context, q Query) ([]Candidate, error)
+	// SeasonEpisodeCounts возвращает число серий по сезонам для сериала
+	// (ключ — номер сезона). Нужен для валидации полноты сезон-пака.
+	SeasonEpisodeCounts(ctx context.Context, id string) (map[int]int, error)
+}