Files
buryan-infra/ops/media/CONTENT-GRAPH.md
T
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

208 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Граф контента
Связи между фильмами, книгами, франшизами, персонами, темами и эпохами.
## Что связывается
| Связь | Источник |
|---|---|
| фильм → коллекция «входит в» | `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`.