Files
buryan-infra/ops/media/PERSONAL.md
buryan-agent 9989994c0c Пересборка графа больше не стирает «хочу посмотреть»
content_graph.py передаёт статус «в медиатеке» при обновлении карточки, и он
затирал личный статус. В upsert ядра добавлено правило: если стоит «хочу
посмотреть» или «смотрю», а приходит нейтральный статус, личный сохраняется.

Проверено: пометил фильм, пересобрал граф — статус остался.
2026-10-20 12:48:56 +03:00

99 lines
4.3 KiB
Markdown
Raw Permalink 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.
# Личное в медиатеке: «хочу посмотреть» и свои оценки
Граф знает, что есть в медиатеке. Теперь он знает ещё и что вы хотите
посмотреть и как оцениваете увиденное.
## Список желаемого
* `!хочу Дюна` — помечает карточку статусом «хочу посмотреть»;
* `!хочу` — список желаемого;
* `GET /watchlist`, `GET /watchlist?mark=<название>`.
Статус хранится в самой карточке графа, поэтому «хочу» видно везде: в
`!связи`, в поиске, в `/graph`.
## Свои оценки
* `!оценка Дюна 9` — личная оценка 1–10;
* `!оценка` — список с средней;
* `GET /rate?title=<название>&score=<1-10>`, `GET /rated`.
Оценки лежат в отдельной таблице `user_ratings` (entity_id, score), а не в
графе: это личные данные, их не надо смешивать с рейтингами IMDb.
```
!оценка Дюна 9 → Оценил Dune (2021) на 9/10
!оценка → Мои оценки — средняя 8.5
9/10 — Dune (2021)
8/10 — The Matrix Reloaded (2003)
```
## Уборка после теста загрузки
Тест конвейера оставил в графе два мусорных узла с именами релизов
(«Night Of The Living Dead 1968 720p_sujaidr» и «…2160p BRRip …YTS»).
Удалены. Заодно убрана устаревшая карточка удалённого фильма.
Состояние графа после уборки:
```
фильм 14 · сериал 5 · сезон 19 · книга 10
актёр 58 · режиссёр 8 · композитор 8
тема 46 · жанр 14 · студия 10 · сеть 4
связей 536
```
## Ловушка
Маршрут `/rate` перехватывал `/rated` (префиксное совпадение), поэтому
`!оценка` без аргументов отвечала `400`. Исправлено: `/rate` срабатывает
только на точный путь или с `?`.
---
## Рекомендации «Для вас»
`GET /for-me` собирает подборку из ваших высоких оценок (8+):
1. берёт темы и жанры любимых фильмов и сериалов;
2. находит карточки с теми же темами, которых вы ещё не оценивали;
3. если не хватает — добивает кандидатами из рекомендаций TMDB.
Команда `!для меня`, блок «Личное» на панели.
```
!для меня
_по мотивам: Dune (2021), The Matrix Reloaded (2003)_
• The Matrix Revolutions (2003)
• Terminator 2: Judgment Day (1991)
• Terminator Salvation (2009)
• The Matrix (1999)
• Dune: Part Two (2024)
• Blade Runner (1982) …
```
Оценённое исключается: то, что уже посмотрели и оценили, повторно не
советуется.
## Ловушка: пересборка графа стирала список
`content_graph.py` при обновлении карточки передаёт статус «в медиатеке»,
и он затирал «хочу посмотреть». Заметил по пустому `!хочу` после пересборки.
Исправлено в upsert ядра: если у карточки уже стоит «хочу посмотреть» или
«смотрю», а приходит нейтральный статус («в медиатеке», «не в медиатеке»,
пусто), личный статус сохраняется.
```sql
status = case
when entities.status in ('хочу посмотреть', 'смотрю')
and coalesce(excluded.status, '') in ('', 'в медиатеке', 'не в медиатеке')
then entities.status
else coalesce(excluded.status, entities.status)
end
```
Проверено: пометил фильм, пересобрал граф — статус на месте.