# Граф контента Связи между фильмами, книгами, франшизами, персонами, темами и эпохами. ## Что связывается | Связь | Источник | |---|---| | фильм → коллекция «входит в» | `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=` | прямые связи «похож» и фильмы с общими темами/жанрами | `/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`.