Files
jellybit/internal/metadata/metadata.go
T
avandClaude Opus 4.8 02d4ecc2aa display_name: слоистое разрешение полей + сохранение режиссёра из контекста
Единый источник полей отображаемого имени и один рендер полного ярлыка на
всех путях (старт и «Обновить имя»/авто-перелив). Раньше старт давал полный
«Название (режиссёр, год). Сезон 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>
2026-07-11 11:50:08 +03:00

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)
}