Files
buryan-infra/ops/media/CONTENT-GRAPH.md
buryan-agent d9ec1d25a3 Аналитика графа: шкала времени, кросс-формат, топ персон, блок на панели
Ядро: GET /graph (статистика и JSON узлов/рёбер), /timeline (тема по
десятилетиям), /cross (книги с экранизацией и авторы), /persons (топ персон).

Бот: команды «граф», «время <тема>», «кросс», «персоны режиссёры».
Проверено: science fiction по десятилетиям с фильмами, Dune ↔ Dune (2021),
Frank Herbert → Dune, Дени Вильнёв — 4 фильма.

Панель: раздел «Медиа: граф контента» с числом карточек и связей, таблицей
связей с диаграммами и списком книг-экранизаций. Панель выросла до 10.4 КБ.

Ловушки: /person перехватывал /persons (уточнён маршрут); «персоны режиссёры»
разбиралось как поиск человека по имени «режиссёры» — добавлено распознавание
запросов-списков.
2026-10-20 11:32:23 +03:00

10 KiB
Raw Permalink Blame History

Граф контента

Связи между фильмами, книгами, франшизами, персонами, темами и эпохами.

Что связывается

Связь Источник
фильм → коллекция «входит в» collection Radarr (TMDB)
фильм → жанр «жанр» genres Radarr
фильм → студия «снят студией» studio Radarr
фильм → тема «тема» keywords Radarr
фильм → эпоха «снят в» год → десятилетие
фильм → режиссёр «снял» Credits.Crew (Job=Director) из SkyHook
фильм → актёр «снялся» Credits.Cast (до 5) из SkyHook
фильм → оценка «оценка» MovieRatings.Imdb → 8+/7–8/<7
фильм → рейтинг «возрастной рейтинг» Certifications (US)
фильм → язык «язык» OriginalLanguage
фильм → кандидат «рекомендует» Recommendations TMDB
фильм → фильм «продолжение» коллекция по годам
фильм ↔ фильм «похож» ≥2 общих жанра
книга → автор «написал» авторы Calibre
книга → серия «входит в серию» серия Calibre
книга → жанр «жанр» теги Calibre
книга ↔ фильм «экранизация» совпадение названия
коллекция ↔ книжная серия «общая вселенная» название коллекции = серия

Как получаются детали

Radarr — это SkyHook-прокси: https://api.radarr.video/v1/movie/{tmdb} отдаёт Credits (30 человек), Recommendations (10), MovieRatings, Certifications, AlternativeTitles, OriginalLanguage.

Запросы идут через прокси узла (http://192.168.1.10:8888), потому что домашний IP для SkyHook заблокирован Cloudflare.

Русские названия

Из AlternativeTitles берутся варианты с Language: ru и сохраняются как алиасы карточки (поле search_text). Поэтому !связи Дюна находит Dune (2021) и Dune: Part Two (2024).

Результат

фильмов: 12, книг: 10
персон связано: 75
карточек: 359, связей: 376

По типам:
  рекомендует: 72        тема: 60         снялся: 60
  жанр: 49               похож: 22        снял: 15
  снят в: 12             оценка: 12       язык: 12
  снят студией: 12       возрастной: 12   написал: 10
  входит в: 9            серия: 8         продолжение: 4
  общая вселенная: 1     экранизация: 1

Карточки: 48 актёров, 42 темы, 41 кандидат, 12 фильмов, 11 жанров, 10 книг, 8 студий, 6 режиссёров, 6 эпох, 5 авторов, 5 коллекций, 4 книжные серии.

Команды бота Медиа

тема artificial intelligence   → 6 фильмов про ИИ
связи Дюна                    → вся карточка: актёры, язык, оценка, темы,
                                 жанры, похожие, студия, эпоха, рекомендации
рекомендации                  → 15 кандидатов, которых нет в медиатеке
хаб                           → полный обзор медиатеки

Пример связи Дюна:

Dune: Part Two (2024) (фильм)
• снялся: Rebecca Ferguson, Timothée Chalamet, Zendaya, Javier Bardem
• язык: английский · оценка: высокая (8+) · снят в: 2020-е
• тема: based on novel or book, chosen one, ambiguous
• жанр: science fiction, Adventure
• похож: The Fifth Element, Dune (2021), Interstellar
• снят студией: Legendary Pictures
• рекомендует: Dune (2021), Avatar: Fire and Ash, …

Ловушки

  • Кириллица в query-строке должна быть закодирована: curl -G --data-urlencode. Без кодирования сервер видит мусор и возвращает пустой список.
  • /entities по умолчанию отдавал всё — добавлен фильтр kind и limit.
  • Псевдоним «связи» в базовом классе указывал на команду link, которой у Медиа-бота нет. Пришлось переопределить ALIASES в классе MediaBot.

Подборки по персонам и «похожее»

Новые эндпоинты ядра

Эндпоинт Что отдаёт
GET /person?q=<имя> персона (актёр или режиссёр) и её фильмы
GET /similar?id=<id> прямые связи «похож» и фильмы с общими темами/жанрами

/similar работает в два шага: карточка → её темы и жанры → другие карточки с теми же темами. Поэтому в «похожее» попадают и книги: Dune (2021) связан с книгой Dune через общий жанр science fiction.

Команды бота

персона Keanu Reeves   → 3 фильма Matrix
персона Zendaya        → Dune: Part Two
похоже Дюна            → прямо связаны: The Fifth Element, Dune (2021),
                          Interstellar; общие темы: Dune (2021) — 4
                          совпадения, Interstellar и The Fifth Element — по 2

Ловушка

Первый вариант /similar возвращал сами темы вместо фильмов: запрос соединял карточку с её же темами. Правильно — сначала собрать темы, потом найти другие карточки, ссылающиеся на эти темы, и отсортировать по числу совпадений.


Композиторы, авторы и подбор из медиатеки

Новые связи

Связь Что означает
фильм → композитор «музыка» Credits.Crew с должностью Original Music Composer
автор → фильм «экранирован» у автора есть книга, по которой снят фильм из медиатеки

В графе 10 связей «музыка» (у Blade Runner 2049 — два композитора) и связь Frank Herbert → Dune (2021).

Подбор из имеющегося: GET /pick

Фильтры: genre, theme, decade, kind, limit. Возвращает карточки с оценкой и списком жанров.

GET /pick?genre=science%20fiction        → 5 фильмов
GET /pick?theme=artificial%20intelligence → 6 фильмов
GET /pick?decade=1980-е                  → Blade Runner (1982)

Команда бота !посмотреть

Разбирает запрос: понимает эпоху в любом виде (80-е, 1999, 2020-е), остальное считает жанром или темой. Пробует комбинации по очереди: жанр+эпоха → тема+эпоха → жанр → тема → только эпоха.

посмотреть 80-е    → Blade Runner (1982) — высокая (8+)
посмотреть 1999    → The Fifth Element (1997), The Matrix (1999)
посмотреть 2020-е  → Dune (2021), Dune: Part Two (2024)
посмотреть science fiction → 5 фильмов с оценками и жанрами

Ловушка

Двузначный год нельзя превращать в 80-е напрямую: получалось 800-е. Правило: 30–99 → 19xx, 00–29 → 20xx, дальше десятилетие.


Аналитика графа

Эндпоинты

Эндпоинт Что отдаёт
GET /graph статистика: карточки по видам, связи по типам
GET /graph?json узлы (с числом связей) и рёбра для визуализации
GET /timeline?q=&kind= тема или жанр по десятилетиям
GET /cross книги с экранизацией и авторы, чьи книги экранизированы
GET /persons?kind= персоны с наибольшим числом фильмов

Команды бота

граф                  → 285 карточек, 382 связи; топ связей
время science fiction → по десятилетиям:
                        1970-е — Alien, 1980-е — Blade Runner,
                        1990-е — Fifth Element и Matrix, 2000-е — Matrix 2-3,
                        2010-е — Arrival, BR2049, Interstellar, Prometheus,
                        2020-е — оба Dune
кросс                 → Dune ↔ Dune (2021); Frank Herbert → Dune (2021)
персоны режиссёры     → Denis Villeneuve 4, Wachowskis по 3, Ridley Scott 3

Панель

Новый раздел «Медиа: граф контента»: число карточек и связей, таблица связей с полосками-диаграммами, список книг и их экранизаций.

Ловушки

  • Маршрут /person (поиск персоны) перехватывал /persons (список). Исправлено: /person срабатывает только на точный путь или с ?.
  • Слово «персоны» разбиралось как команда персона, поэтому «персоны режиссёры» шло в поиск человека по имени «режиссёры». Теперь _person_cmd распознаёт запросы-списки и передаёт их в _persons_cmd.