Единый источник полей отображаемого имени и один рендер полного ярлыка на всех путях (старт и «Обновить имя»/авто-перелив). Раньше старт давал полный «Название (режиссёр, год). Сезон N» но выбрасывал структуру, а перелив по распознаванию — усечённый «Title (Year)». - Слоистое разрешение скаляров имени: override → recognition(+match) → новый базовый слой «контекст» (download.parsed_context, JSON naming.Fields). - naming: публичные Fields/Label/Derive, вынесен единый рендер; удалён FormatTitleYear. Сводка сезонов вынесена в recognize.SeasonSummary. - Режиссёр из метабазы (решение A2): TMDB/TVDB credits через опциональный metadata.DirectorProvider; авто-матч кладёт в plan.Director, ручной выбор кандидата тянет credits и пиннит ovrDirector. Метабаза бьёт контекст. - refreshDisplayNameLocked строит полный ярлык из эффективных полей; инфо-панель ревью показывает загруженного режиссёра. - Миграция 0011_parsed_context + ER-схема. Всё косметика: на пути/раскладку не влияет, приём/вывод имени не валятся (best-effort). Закрывает беклог-задачу «Кнопка „Обновить имя“: полный формат ярлыка». OpenSpec: archive/2026-07-11-field-resolution-display-name (ingest, recognition, metadata-match, review). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
63 lines
3.3 KiB
Go
63 lines
3.3 KiB
Go
// 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 и каноническое имя.
|
|
//
|
|
// 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)
|
|
}
|