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>
This commit is contained in:
av
2026-07-11 11:50:08 +03:00
co-authored by Claude Opus 4.8
parent 9472bfdd83
commit 02d4ecc2aa
40 changed files with 1536 additions and 311 deletions
+9
View File
@@ -51,3 +51,12 @@ type Provider interface {
// (ключ — номер сезона). Нужен для валидации полноты сезон-пака.
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)
}
+45
View File
@@ -141,6 +141,51 @@ func (t *TMDB) SeasonEpisodeCounts(ctx context.Context, id string) (map[int]int,
return out, nil
}
type tmdbCreditsResp struct {
Crew []struct {
Job string `json:"job"`
Name string `json:"name"`
} `json:"crew"`
}
type tmdbTVDetailsResp struct {
CreatedBy []struct {
Name string `json:"name"`
} `json:"created_by"`
}
// Director возвращает режиссёра: для фильма — из crew (job "Director"), для
// сериала — создателей (created_by). Пусто — режиссёр не указан. Best-effort:
// вызывающий гасит ошибку.
func (t *TMDB) Director(ctx context.Context, mt MediaType, id string) (string, error) {
params := url.Values{"api_key": {t.apiKey}, "language": {t.language}}
if mt == Series {
var resp tmdbTVDetailsResp
if err := getJSON(ctx, t.hc, t.log, logging.ServiceTMDB, "tv",
t.baseURL+"/tv/"+url.PathEscape(id)+"?"+params.Encode(), nil, &resp); err != nil {
return "", fmt.Errorf("tmdb tv %s: %w", id, err)
}
names := make([]string, 0, len(resp.CreatedBy))
for _, c := range resp.CreatedBy {
if strings.TrimSpace(c.Name) != "" {
names = append(names, c.Name)
}
}
return strings.Join(names, ", "), nil
}
var resp tmdbCreditsResp
if err := getJSON(ctx, t.hc, t.log, logging.ServiceTMDB, "movie/credits",
t.baseURL+"/movie/"+url.PathEscape(id)+"/credits?"+params.Encode(), nil, &resp); err != nil {
return "", fmt.Errorf("tmdb movie credits %s: %w", id, err)
}
for _, c := range resp.Crew {
if c.Job == "Director" && strings.TrimSpace(c.Name) != "" {
return c.Name, nil
}
}
return "", nil
}
// yearOf достаёт год из даты вида "1999-03-31".
func yearOf(date string) int {
if len(date) < 4 {
+60
View File
@@ -152,3 +152,63 @@ func TestNewTMDB_RequiresKey(t *testing.T) {
t.Fatal("want error without api_key")
}
}
func TestTMDB_DirectorMovie(t *testing.T) {
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if r.URL.Path != "/movie/603/credits" {
t.Errorf("path = %q", r.URL.Path)
}
_, _ = w.Write([]byte(`{"crew":[
{"job":"Producer","name":"Joel Silver"},
{"job":"Director","name":"Lana Wachowski"}
]}`))
}))
defer srv.Close()
got, err := newTMDB(t, srv.URL).Director(context.Background(), Movie, "603")
if err != nil {
t.Fatalf("Director: %v", err)
}
if got != "Lana Wachowski" {
t.Errorf("director = %q, want «Lana Wachowski»", got)
}
}
func TestTMDB_DirectorSeriesCreatedBy(t *testing.T) {
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if r.URL.Path != "/tv/60622" {
t.Errorf("path = %q", r.URL.Path)
}
_, _ = w.Write([]byte(`{"created_by":[{"name":"Noah Hawley"}]}`))
}))
defer srv.Close()
got, err := newTMDB(t, srv.URL).Director(context.Background(), Series, "60622")
if err != nil {
t.Fatalf("Director: %v", err)
}
if got != "Noah Hawley" {
t.Errorf("director = %q, want «Noah Hawley»", got)
}
}
// Нет режиссёра в crew → пустая строка (best-effort, не ошибка).
func TestTMDB_DirectorAbsent(t *testing.T) {
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {
_, _ = w.Write([]byte(`{"crew":[{"job":"Producer","name":"X"}]}`))
}))
defer srv.Close()
got, err := newTMDB(t, srv.URL).Director(context.Background(), Movie, "1")
if err != nil {
t.Fatalf("Director: %v", err)
}
if got != "" {
t.Errorf("director = %q, want пусто", got)
}
}
// TMDB реализует опциональный DirectorProvider.
func TestTMDB_ImplementsDirectorProvider(t *testing.T) {
var _ DirectorProvider = (*TMDB)(nil)
}
+29
View File
@@ -190,6 +190,35 @@ type tvdbExtendedResp struct {
} `json:"data"`
}
type tvdbCharactersResp struct {
Data struct {
Characters []struct {
PeopleType string `json:"peopleType"`
PersonName string `json:"personName"`
} `json:"characters"`
} `json:"data"`
}
// Director возвращает режиссёра из расширенных данных записи (characters с
// peopleType "Director"). Пусто — режиссёр не указан. Best-effort: вызывающий
// гасит ошибку.
func (t *TVDB) Director(ctx context.Context, mt MediaType, id string) (string, error) {
kind := "series"
if mt == Movie {
kind = "movies"
}
var resp tvdbCharactersResp
if err := t.get(ctx, kind+"/extended", "/"+kind+"/"+url.PathEscape(id)+"/extended", &resp); err != nil {
return "", fmt.Errorf("tvdb %s %s: %w", kind, id, err)
}
for _, c := range resp.Data.Characters {
if c.PeopleType == "Director" && strings.TrimSpace(c.PersonName) != "" {
return c.PersonName, nil
}
}
return "", nil
}
// SeasonEpisodeCounts считает число серий по сезонам из расширенных данных.
func (t *TVDB) SeasonEpisodeCounts(ctx context.Context, id string) (map[int]int, error) {
var resp tvdbExtendedResp