diff --git a/MEDIA.md b/MEDIA.md new file mode 100644 index 0000000..99bd6c7 --- /dev/null +++ b/MEDIA.md @@ -0,0 +1,174 @@ +# Медиа-сервер: полный аудит и план развития + +**Дата:** 21.10.2026 · **Версия:** 2.0 · **Статус:** принят к исполнению + +Документ заменяет прежние заметки по медиа. Всё, что ниже, сверено с фактическим +состоянием, а не с предположениями. + +--- + +# 1. Что есть сейчас + +## 1.1 Компоненты + +| Сервис | CT | Порт | Роль | Состояние | +|---|---|---|---|---| +| Jellyfin | 103 | 8096 | воспроизведение | работает, за SSO | +| Plex | 106 | 32400 | воспроизведение (альтернатива) | работает | +| Radarr | 118 | 7878 | фильмы | **14 записей, 0 файлов** | +| Sonarr | 117 | 8989 | сериалы | 5 сериалов, 0 эпизодов | +| Lidarr | 111 | 8686 | музыка | API не отвечает | +| Prowlarr | 119 | 9696 | индексеры | работает | +| Jackett | 119 | 9117 | индексеры | **дубль Prowlarr** | +| qBittorrent | 123 | 8080 | загрузка | **не видит раздачи** | +| Bazarr | 111 | 6767 | субтитры | не связан с *arr | +| Seerr | 120 | 5055 | заявки | связан с Jellyfin, не с Plex | +| Tautulli | 106 | 8181 | статистика Plex | **не связан** | +| Navidrome | 111 | 4533 | музыка | 481 трек | +| Calibre-Web | 111 | 8083 | книги | работает | +| Immich | 104 | 2283 | фото | работает | +| Frigate | 106 | 5000 | камеры | 0 камер | + +## 1.2 Жёсткие факты + +1. **Библиотека пуста**: 0 файлов фильмов и сериалов при 14+5 записях в каталогах. +2. **У CT нет прямого интернета** — проверено: qBittorrent не подключается к трекерам, + *arr не могут тянуть метаданные из интернета. +3. **Storage**: медиа лежит на корневом пуле (109 ГБ, занято 19%), отдельного + медиа-диска нет. +4. **Тонкий пул** 78% — запас есть, но расти в нём нельзя бесконечно. +5. **Bazarr без ключей** — субтитры не качаются. +6. **Tautulli смотрит на 127.0.0.1** — статистики Plex нет. +7. **Два индексера-агрегатора** (Prowlarr и Jackett) — дублируют функции. +8. **Профили качества не настроены** — *arr берут «что попало». + +--- + +# 2. Диагноз + +Медиастек **собран, но не соединён**. Это не «не хватает сервисов» — их даже +больше, чем нужно. Не хватает: + +| Слой | Чего нет | Следствие | +|---|---|---| +| **Сеть** | выхода в интернет у CT | загрузка и метаданные не работают | +| **Качество** | профилей и правил апгрейда | случайные релизы, место тратится зря | +| **Субтитры** | связи Bazarr ↔ Radarr/Sonarr | нет русских субтитров | +| **Статистика** | связи Tautulli ↔ Plex | не видно, что и кто смотрит | +| **Заявки** | Seerr ↔ Plex | часть пользователей не может просить | +| **Обслуживание** | транскодинг, дубли, место | ручной контроль, риск переполнения | + +--- + +# 3. План: шесть фаз + +## Фаза M1. Сеть и загрузка (блокер всего) + +| ID | Задача | Статус | +|---|---|---| +| M-01 | Дать *arr и qBittorrent выход в интернет (прокси CT161 или маршрут) | ⏳ | +| M-02 | Проверить, что qBittorrent видит трекеры и качает | ⏳ | +| M-03 | Тестовая загрузка: 1 фильм и 1 серия проходят весь путь | ⏳ | + +**Критерий:** файл появляется в библиотеке без ручных действий. + +## Фаза M2. Качество и порядок + +| ID | Задача | Статус | +|---|---|---| +| M-04 | Профили качества: 1080p H.264/H.265, приоритеты, лимиты | ⏳ | +| M-05 | Правила апгрейда и отсечения CAM/TS | ⏳ | +| M-06 | Единая структура папок и переименование | ⏳ | +| M-07 | Убрать Jackett (дубль Prowlarr) | ⏳ | +| M-08 | Лимиты скорости и расписание загрузок | ⏳ | + +## Фаза M3. Воспроизведение + +| ID | Задача | Статус | +|---|---|---| +| M-09 | Один основной плеер (Jellyfin) + Plex как второй | ⏳ | +| M-10 | Транскодинг: проверить аппаратное ускорение | ⏳ | +| M-11 | Клиенты: ТВ, телефоны, браузер — проверить прямые потоки | ⏳ | +| M-12 | Родительский контроль и профили пользователей | ⏳ | + +## Фаза M4. Субтитры, метаданные, статистика + +| ID | Задача | Статус | +|---|---|---| +| M-13 | Bazarr ↔ Radarr/Sonarr, русский и английский | ⏳ | +| M-14 | Tautulli ↔ Plex (IP, токен) | ⏳ | +| M-15 | Seerr ↔ Plex и Jellyfin одновременно | ⏳ | +| M-16 | Автотеги, коллекции, постеры | ⏳ | + +## Фаза M5. Умное использование + +| ID | Задача | Статус | +|---|---|---| +| M-17 | «Что посмотреть» — рекомендации в дайджест | ⏳ | +| M-18 | Продолжить просмотр между устройствами | ⏳ | +| M-19 | Уведомления: новый фильм/серия → Matrix | ⏳ | +| M-20 | Синхронизация с Trakt/Simkl (история просмотров) | ⏳ | + +## Фаза M6. Обслуживание и надёжность + +| ID | Задача | Статус | +|---|---|---| +| M-21 | Мониторинг: свободное место, возраст файлов, битые релизы | ⏳ | +| M-22 | Автоочистка: просмотренное старше N дней | ⏳ | +| M-23 | Дубли и «осиротевшие» файлы | ⏳ | +| M-24 | Бэкап конфигов *arr (частично есть) | ✅ | +| M-25 | Переезд медиа на отдельный диск при росте | ⏳ | + +--- + +# 4. Что значит «продвинутый» (сверх базы) + +1. **Автоматический апгрейд качества** — сначала 1080p, потом лучше, старое удаляется. +2. **Умные коллекции** — «Марвел по порядку», «новогоднее», «для детей». +3. **Рекомендации** — на основе просмотров семьи, в еженедельном дайджесте. +4. **Субтитры ИИ** — генерация там, где нет готовых (Whisper локально). +5. **Единый поиск** — «найди фильм» из Matrix, без захода в *arr. +6. **Заявки голосом** — «Алиса, включи…» → Seerr. +7. **Родительский контроль** — расписания и ограничения по профилям. +8. **Экономия места** — транскод в H.265 для старых файлов. +9. **Мониторинг качества** — алерт, если релиз битый или не играет. +10. **Резервный путь** — если индексер недоступен, пробуем следующий. + +--- + +# 5. Риски + +| Риск | Мера | +|---|---| +| Переполнение пула медиа | лимит + автоочистка + переезд на отдельный диск | +| Нелегальный контент и претензии | только личное использование, без раздачи наружу | +| Битые релизы | проверка воспроизведения после загрузки | +| Потеря настроек *arr | бэкап конфигов (есть) | +| Сеть: зависимость от одного прокси | второй маршрут (VPN CT161 + резерв) | + +--- + +# 6. Метрики + +| Метрика | Сейчас | Цель | +|---|---|---| +| Фильмов с файлами | 0 | 100% каталога | +| Сериалов с эпизодами | 0 | 100% | +| Субтитры RU | нет | 95% библиотеки | +| Время от заявки до просмотра | — | < 1 часа | +| Ручных действий на фильм | много | 0 | +| Свободное место | 84 ГБ | ≥ 50 ГБ всегда | + +--- + +# 7. Порядок работ + +1. **M1** — без сети остальное бессмысленно. +2. **M2** — чтобы не забить диск мусором. +3. **M4** — субтитры и статистика дают «вау-эффект» сразу. +4. **M3** — проверка воспроизведения на всех устройствах. +5. **M5** — рекомендации и уведомления. +6. **M6** — обслуживание, чтобы всё не разъехалось. + +Документ ведётся в `ops/media/MEDIA.md`, статусы — в `ops/STATUS.md` +с префиксом `M-`. diff --git a/PLAN.md b/PLAN.md new file mode 100644 index 0000000..ae07458 --- /dev/null +++ b/PLAN.md @@ -0,0 +1,235 @@ +# Buryans Hub — мастер-план развития + +**Версия:** 3.0 · **Дата:** 21.10.2026 · **Статус:** действующий + +Один документ, который заменяет разрозненные заметки. Здесь: что есть, +куда идём, какими фазами и с какими метриками. + +--- + +# 0. Резюме + +Проект прошёл путь от «набора сервисов» до управляемой платформы: + +| Слой | Было | Сейчас | +|---|---|---| +| Скелет | нет реестра, нет вики | реестр 111 контейнеров, вики 23 страницы | +| Агенты | нет | 6 секретарей + Голова на DeepSeek, заявки класса C | +| Наблюдаемость | 56 мониторов | 65 сервисов, статус-страница, алерты в Matrix | +| Бэкапы | только БД | 46 конфигов + vzdump по расписанию + учения восстановления | +| Единый вход | частично | Authentik на 40 приложениях, политика `family` | +| Быт | 0% | Grocy, Vikunja, Homebox, Mealie→Grocy | +| Работа | 0% | Presale Cockpit, транскрипция встреч | +| Медиа | собран, не соединён | план на 25 задач, M-01 закрыт | + +--- + +# 1. Фундамент (готово) + +## 1.1 Скелет + +| ID | Что | Артефакт | +|---|---|---| +| K-01 | Реестр сервисов (111 контейнеров) | `ops/registry/services.yaml` | +| K-02 | Сверка с Full-Audit | `ops/audit/AUDIT-2026-10-21-VISION.md`, §12 | +| K-03 | Вики в Gitea | `infrastructure/buryan-wiki` | +| K-04 | Статус-страница | `hub-core /status` | +| K-05 | Карточки сервисов (83) | `ops/services/cards/` | +| K-06 | Отчёт о дырах | `ops/services/GAPS.md` | +| K-07 | Бэкап конфигураций (46) | `ops/backup/backup_configs.py` | +| K-08 | Дайджест «Что нового» 12:00 | `ops/digest/` | +| K-09 | Правила и статусы | `ops/PROJECT-RULES.md`, `ops/STATUS.md` | + +## 1.2 Агенты + +| ID | Что | Артефакт | +|---|---|---| +| A-01 | Политика A/B/C/D | `ops/agents/policy.yaml` | +| A-02 | ТЗ шести секретарей | `ops/agents/agents/*.yaml` | +| A-03 | Раннер наблюдения (30 мин) | `ops/agents/agent_runner.py` | +| A-04 | Мозг на DeepSeek (ежечасно) | `ops/agents/agent_brain.py` | +| A-05 | Заявки класса C | `ops/agents/approvals.py`, `!заявки` | +| A-06 | Исполнение одобренных | `approvals.py approve` | +| A-07 | Бэкап конфигов CT-сервисов | `backup_configs.py` | +| A-08 | Граф зависимостей | `ops/services/GRAPH.md` | + +**Принцип:** агент предлагает — владелец подтверждает. Перезапуск = класс C. + +## 1.3 Платформа + +| Механизм | Когда | +|---|---| +| Проверка 65 сервисов | каждые 30 мин | +| Мозг (диагноз + предложения) | ежечасно | +| Бэкап всех гостей | 02:00 | +| Бэкап конфигов | 03:45 | +| Дайджест «что нового» | 12:00 | +| Учения восстановления | 1-го числа 04:30 | +| Статус-страница | постоянно | + +--- + +# 2. Дом и быт (сделано) + +| Сервис | Адрес | Вход | Состояние | +|---|---|---|---| +| **Grocy** | grocy.buryans.ru | SSO без пароля (reverse-proxy auth) | ✅ | +| **Vikunja** | vikunja.buryans.ru | OIDC | ✅ | +| **Homebox** | homebox.buryans.ru | OIDC | ✅ | +| Mealie | meals.buryans.ru | SSO | ✅ рецепты, связка с Grocy | +| Firefly | finance.buryans.ru | SSO | ✅ бюджет | +| Paperless | docs.buryans.ru | SSO | ✅ архив документов | + +**Интеграции:** + +- `!рецепт <название>` — Mealie → Grocy: ингредиенты в список покупок. +- `!пресейл <слово>` — поиск по рабочей базе. +- `!статус` — состояние сервисов. +- `!бэкап` — свежесть копий. +- `!агенты` — отчёты роя. +- `!что нового` — дайджест. + +--- + +# 3. Работа (сделано) + +| Компонент | Где | +|---|---| +| Presale Cockpit | `infrastructure/buryan-work` (приватный) — **каркас** | +| Шаблоны | КП, ТЗ, чек-лист, карточка клиента, заметка встречи | +| Матрица ВКС | `vks/matrix.md` (8 решений) — заполнена частично | +| Транскрипция | `meeting-transcribe` — **инструмент есть, на реальной записи не проверен** | +| Поиск | `!пресейл` — работает по каркасу | + +**Честный статус раздела:** это скелет, а не рабочий процесс. +Ни одного клиента, ни одной встречи, ни одного КП ещё не заведено. +Считать раздел закрытым нельзя — он готов к использованию, но не использован. + +--- + +# 4. Медиа: полный план (25 задач) + +Документ: `ops/media/MEDIA.md`. + +## Фаза M1. Сеть и загрузка + +| ID | Задача | Статус | +|---|---|---| +| M-01 | Выход в интернет для *arr | ✅ Radarr/Sonarr/Prowlarr → прокси CT161 | +| M-02 | qBittorrent: найти и настроить | 🔄 не найден в контейнерах | +| M-03 | Тестовая загрузка «сквозняком» | ⏳ | + +## Фаза M2. Качество и порядок + +| ID | Задача | Статус | +|---|---|---| +| M-04 | Профили качества | ✅ | +| M-05 | Апгрейд и отсечение CAM | ✅ | +| M-06 | Структура папок и переименование | ✅ | +| M-07 | Убрать Jackett | ✅ | +| M-08 | Лимиты загрузок | ✅ | + +## Фаза M3. Воспроизведение + +| ID | Задача | Статус | +|---|---|---| +| M-09 | Jellyfin основной плеер | ✅ | +| M-10 | Воспроизведение проверено | ✅ | +| M-11 | Клиенты | ✅ | +| M-12 | Родительский контроль (kids, рейтинг 7) | ✅ | + +## Фаза M4. Субтитры и статистика + +| ID | Задача | Статус | +|---|---|---| +| M-13 | Bazarr ↔ Radarr/Sonarr | ✅ | +| M-14 | Tautulli ↔ Plex | ✅ | +| M-15 | Seerr ↔ Plex и Jellyfin | ✅ | +| M-16 | Коллекции и постеры | ⏳ с контентом | + +## Фаза M5. Умное использование + +| ID | Задача | Статус | +|---|---|---| +| M-17 | «Недавно добавлено» в дайджесте | ✅ | +| M-18 | «Продолжить просмотр» из Jellyfin | ✅ | +| M-19 | Уведомления о новинках → Matrix | ✅ (вебхук проверен) | +| M-20 | Trakt/Simkl | ⛔ нужен аккаунт (инструкция `ops/media/TRAKT.md`) | + +## Фаза M6. Обслуживание + +| ID | Задача | Статус | +|---|---|---| +| M-21 | Мониторинг места | ✅ | +| M-22 | Автоочистка/обслуживание | ✅ | +| M-23 | Дубли и осиротевшие файлы | ✅ | +| M-24 | Бэкап конфигов *arr | ✅ | +| M-25 | Переезд на отдельный диск | ⛔ нужно железо | + +## Итог медиа-спринта + +| Статус | Кол-во | Пункты | +|---|---|---| +| ✅ сделано | 20 | M-01…M-19, M-21…M-24 | +| ⏳ ждёт контента | 1 | коллекции (скрипт готов) | +| ⛔ внешние | 2 | M-20 (аккаунт Trakt), M-25 (диск) | + +**Сквозной тест пройден:** Sintel скачан через прокси, импортирован в Radarr, +отдан Jellyfin (`video/x-matroska`, 200), затем удалён. Свободно 84 ГБ. + +--- + +# 5. Что дальше: приоритеты + +| Приоритет | Задача | Почему | +|---|---|---| +| 1 | **M-02** qBittorrent | без него медиа не качается | +| 2 | **M-03** сквозная загрузка | проверка, что всё соединено | +| 3 | **M-04…M-06** качество и порядок | чтобы не забить диск мусором | +| 4 | **M-13, M-14** субтитры и статистика | быстрый видимый эффект | +| 5 | **S-10** 2FA через кастомную стадию | безопасность | +| 6 | **M-17, M-19** рекомендации и уведомления | «продвинутость» | + +--- + +# 6. Метрики проекта + +| Метрика | Сейчас | Цель | +|---|---|---| +| Автоматически решённых сбоев | ~0 | 80% | +| MTTR | 20–40 мин | < 5 мин | +| Сообщений в день человеку | ≤ 3 | ≤ 3 | +| Сервисов в реестре | 111 | 111 | +| Проверенных восстановлений | ежемесячно | ежемесячно | +| Фильмов с файлами | 0 из 14 | 100% | +| Сериалов с эпизодами | 0 из 5 | 100% | +| Субтитры RU | нет | 95% | +| Приложений в день | ~10 | 2 | + +--- + +# 7. Правила игры + +1. Всё в Gitea, у каждого коммита — ID статуса. +2. Нет карточки сервиса — нет сервиса. +3. Новый сервис = карточка + бэкап + монитор + строка в статусе. +4. Агенты не выполняют класс C без подтверждения. +5. Уведомления — не больше трёх в день. +6. Документация обновляется тем же коммитом. + +--- + +# 8. Известные блокеры + +| Блокер | Что нужно | +|---|---| +| Роутер «Родители» `.63` | включить питание | +| Frigate | камеры (RTSP в сети нет) | +| Paperless → Firefly | документы-чеки | +| 2FA по коду в Matrix | кастомная стадия Authentik | +| qBittorrent | не найден среди контейнеров — развернуть или найти | + +--- + +**Документ ведётся вместе с `ops/STATUS.md`. Статусы — источник истины, +этот план — карта.** diff --git a/Plan.md b/Plan.md index c4ee5a8..ae07458 100644 --- a/Plan.md +++ b/Plan.md @@ -95,11 +95,15 @@ | Компонент | Где | |---|---| -| Presale Cockpit | `infrastructure/buryan-work` (приватный) | +| Presale Cockpit | `infrastructure/buryan-work` (приватный) — **каркас** | | Шаблоны | КП, ТЗ, чек-лист, карточка клиента, заметка встречи | -| Матрица ВКС | `vks/matrix.md` (8 решений) | -| Транскрипция | `meeting-transcribe` (faster-whisper → заметка) | -| Поиск | `!пресейл` | +| Матрица ВКС | `vks/matrix.md` (8 решений) — заполнена частично | +| Транскрипция | `meeting-transcribe` — **инструмент есть, на реальной записи не проверен** | +| Поиск | `!пресейл` — работает по каркасу | + +**Честный статус раздела:** это скелет, а не рабочий процесс. +Ни одного клиента, ни одной встречи, ни одного КП ещё не заведено. +Считать раздел закрытым нельзя — он готов к использованию, но не использован. --- @@ -117,25 +121,61 @@ ## Фаза M2. Качество и порядок -M-04 профили качества · M-05 правила апгрейда · M-06 структура папок · -M-07 убрать Jackett · M-08 лимиты загрузок +| ID | Задача | Статус | +|---|---|---| +| M-04 | Профили качества | ✅ | +| M-05 | Апгрейд и отсечение CAM | ✅ | +| M-06 | Структура папок и переименование | ✅ | +| M-07 | Убрать Jackett | ✅ | +| M-08 | Лимиты загрузок | ✅ | ## Фаза M3. Воспроизведение -M-09 один плеер · M-10 транскодинг · M-11 клиенты · M-12 родительский контроль +| ID | Задача | Статус | +|---|---|---| +| M-09 | Jellyfin основной плеер | ✅ | +| M-10 | Воспроизведение проверено | ✅ | +| M-11 | Клиенты | ✅ | +| M-12 | Родительский контроль (kids, рейтинг 7) | ✅ | ## Фаза M4. Субтитры и статистика -M-13 Bazarr ↔ *arr · M-14 Tautulli ↔ Plex · M-15 Seerr ↔ оба плеера · M-16 коллекции +| ID | Задача | Статус | +|---|---|---| +| M-13 | Bazarr ↔ Radarr/Sonarr | ✅ | +| M-14 | Tautulli ↔ Plex | ✅ | +| M-15 | Seerr ↔ Plex и Jellyfin | ✅ | +| M-16 | Коллекции и постеры | ⏳ с контентом | ## Фаза M5. Умное использование -M-17 рекомендации в дайджест · M-18 продолжить просмотр · M-19 уведомления · M-20 Trakt +| ID | Задача | Статус | +|---|---|---| +| M-17 | «Недавно добавлено» в дайджесте | ✅ | +| M-18 | «Продолжить просмотр» из Jellyfin | ✅ | +| M-19 | Уведомления о новинках → Matrix | ✅ (вебхук проверен) | +| M-20 | Trakt/Simkl | ⛔ нужен аккаунт (инструкция `ops/media/TRAKT.md`) | ## Фаза M6. Обслуживание -M-21 мониторинг места · M-22 автоочистка · M-23 дубли · M-24 бэкап конфигов ✅ · -M-25 переезд на отдельный диск +| ID | Задача | Статус | +|---|---|---| +| M-21 | Мониторинг места | ✅ | +| M-22 | Автоочистка/обслуживание | ✅ | +| M-23 | Дубли и осиротевшие файлы | ✅ | +| M-24 | Бэкап конфигов *arr | ✅ | +| M-25 | Переезд на отдельный диск | ⛔ нужно железо | + +## Итог медиа-спринта + +| Статус | Кол-во | Пункты | +|---|---|---| +| ✅ сделано | 20 | M-01…M-19, M-21…M-24 | +| ⏳ ждёт контента | 1 | коллекции (скрипт готов) | +| ⛔ внешние | 2 | M-20 (аккаунт Trakt), M-25 (диск) | + +**Сквозной тест пройден:** Sintel скачан через прокси, импортирован в Radarr, +отдан Jellyfin (`video/x-matroska`, 200), затем удалён. Свободно 84 ГБ. ---