Ядро: GET /graph (статистика и JSON узлов/рёбер), /timeline (тема по десятилетиям), /cross (книги с экранизацией и авторы), /persons (топ персон). Бот: команды «граф», «время <тема>», «кросс», «персоны режиссёры». Проверено: science fiction по десятилетиям с фильмами, Dune ↔ Dune (2021), Frank Herbert → Dune, Дени Вильнёв — 4 фильма. Панель: раздел «Медиа: граф контента» с числом карточек и связей, таблицей связей с диаграммами и списком книг-экранизаций. Панель выросла до 10.4 КБ. Ловушки: /person перехватывал /persons (уточнён маршрут); «персоны режиссёры» разбиралось как поиск человека по имени «режиссёры» — добавлено распознавание запросов-списков.
10 KiB
Граф контента
Связи между фильмами, книгами, франшизами, персонами, темами и эпохами.
Что связывается
| Связь | Источник |
|---|---|
| фильм → коллекция «входит в» | 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.