av
42d5b73a04
- Раскладка docs/ приведена к канону 2: заведены passport/architecture/ database/security/review и research; docs/specs, drafts, backlog, review/ и BRIEF.md разобраны и удалены, беклог переехал в docs/tasks (34 задачи, 6 целей, слаги на английский). - Нарративы specs удалены как дубли openspec-спек после поимённой сверки; остаток заведён задачами (редактор маппинга ревью, крайние случаи именования), отказ от сущности title промоутнут в ADR. - Проектные копии агентов и скиллов ревью/пайплайна удалены в пользу плагинов av-dev-pm и av-dev-pipeline; в task gate добавлен шаг canon вместо er-schema.
63 lines
3.3 KiB
Go
63 lines
3.3 KiB
Go
// Package metadata — интерфейс баз метаданных и клиенты TMDB/TVDB.
|
|
//
|
|
// Базы опциональны (включаются конфигом). Их роль — подтвердить распознавание
|
|
// официальным id и каноническим именем: при единичном сильном матче по
|
|
// названию+году раскладка делается автоматически, иначе уходит в review
|
|
// (см. openspec/specs/recognition/spec.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 и каноническое имя.
|
|
//
|
|
// ID — нативный id провайдера (по нему запрашиваются SeasonEpisodeCounts).
|
|
// TagProvider/TagID — опц. внешний id для имени папки Jellyfin: напр. TVMaze
|
|
// ищет без ключа, но отдаёт TVDB/IMDb-id во внешних ссылках, и тег ставим
|
|
// привычный ([tvdbid-…]). Пусто → тег берётся из Provider/ID.
|
|
type Candidate struct {
|
|
Provider string // "tmdb" | "tvdb" | "tvmaze"
|
|
ID string
|
|
Title string
|
|
OriginalTitle string
|
|
Year int
|
|
URL string // ссылка на страницу элемента на сайте провайдера
|
|
TagProvider string // напр. "tvdb"/"imdb" (опц.)
|
|
TagID string
|
|
}
|
|
|
|
// 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)
|
|
}
|
|
|
|
// DirectorProvider — опциональная способность провайдера отдать режиссёра записи
|
|
// по её нативному id (TMDB/TVDB credits; TVMaze не поддерживает и интерфейс не
|
|
// реализует). Проверяется type assertion'ом. Режиссёр — недоверенное
|
|
// косметическое поле для вывода отображаемого имени; выборка best-effort, пустая
|
|
// строка — режиссёр неизвестен.
|
|
type DirectorProvider interface {
|
|
Director(ctx context.Context, mt MediaType, id string) (string, error)
|
|
}
|