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