280 lines
13 KiB
Markdown
280 lines
13 KiB
Markdown
# 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: найти и настроить | ✅ клиент настроен в Radarr, качает |
|
||
| M-03 | Тестовая загрузка «сквозняком» | ✅ Interstellar, Two Towers скачаны |
|
||
|
||
## Фаза 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 | ⚠️ Tautulli не отвечает, Plex без библиотеки |
|
||
| M-15 | Seerr ↔ Plex и Jellyfin | ✅ |
|
||
| M-16 | Коллекции и постеры | ⏳ 2 фильма с файлами, коллекций 0 |
|
||
|
||
## Фаза M5. Умное использование
|
||
|
||
| ID | Задача | Статус |
|
||
|---|---|---|
|
||
| M-17 | «Недавно добавлено» в дайджесте | ✅ |
|
||
| M-18 | «Продолжить просмотр» из Jellyfin | ✅ |
|
||
| M-19 | Уведомления о новинках → Matrix | ✅ (вебхук проверен) |
|
||
| M-20 | Trakt/Simkl | ✅ подключён через PIN, Scrobble=true |
|
||
|
||
## Фаза 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 |
|
||
| Проверенных восстановлений | ежемесячно | ежемесячно |
|
||
| Фильмов с файлами | 2 из 15 | 100% |
|
||
| Сериалов с эпизодами | 1 из 6 | 100% |
|
||
| Субтитры RU | нет | 95% |
|
||
| Приложений в день | ~10 | 2 |
|
||
|
||
---
|
||
|
||
# 7. Правила игры
|
||
|
||
1. Всё в Gitea, у каждого коммита — ID статуса.
|
||
2. Нет карточки сервиса — нет сервиса.
|
||
3. Новый сервис = карточка + бэкап + монитор + строка в статусе.
|
||
4. Агенты не выполняют класс C без подтверждения.
|
||
5. Уведомления — не больше трёх в день.
|
||
6. Документация обновляется тем же коммитом.
|
||
|
||
---
|
||
|
||
# 8. Известные блокеры
|
||
|
||
| Блокер | Что нужно |
|
||
|---|---|
|
||
| ~~Роутер «Родители» `.63`~~ | ✅ отвечает (23.10) |
|
||
| Frigate | камеры (RTSP в сети нет) |
|
||
| Paperless → Firefly | документы-чеки |
|
||
| 2FA по коду в Matrix | кастомная стадия Authentik |
|
||
| ~~qBittorrent~~ | ✅ настроен и работает |
|
||
|
||
---
|
||
|
||
**Документ ведётся вместе с `ops/STATUS.md`. Статусы — источник истины,
|
||
этот план — карта.**
|
||
|
||
---
|
||
|
||
# 9. Сверка от 23.10.2026
|
||
|
||
Проверено фактически (не по памяти).
|
||
|
||
## Закрыто после версии 3.0
|
||
|
||
| ID | Что | Проверка |
|
||
|---|---|---|
|
||
| M-02 | qBittorrent | клиент `qBittorrent` в Radarr, `enable: true` |
|
||
| M-03 | Сквозная загрузка | Interstellar, The Two Towers — файлы на диске |
|
||
| M-20 | Trakt | `Trakt.xml`: токены есть, `Scrobble: true` |
|
||
|
||
## Осталось открытым
|
||
|
||
| ID | Что | Состояние |
|
||
|---|---|---|
|
||
| M-16 | Коллекции | 2 фильма с файлами, коллекций 0 — ждёт второй фильм франшизы |
|
||
| M-14 | Tautulli ↔ Plex | Tautulli не отвечает (000), библиотека Plex пуста |
|
||
| M-25 | Отдельный диск | железо |
|
||
| S-10 | 2FA | стадия TOTP удалена, нужна ваша команда |
|
||
|
||
## Блокеры
|
||
|
||
| Блокер | Статус |
|
||
|---|---|
|
||
| Роутер `.63` | ✅ снят — отвечает |
|
||
| qBittorrent | ✅ снят — работает |
|
||
| Frigate | ⛔ нет RTSP-камер |
|
||
| Paperless → Firefly | ⛔ нет чеков |
|
||
| 2FA | ⛔ решение владельца |
|
||
|
||
## Что появилось вне плана (23.10)
|
||
|
||
* **Спринт 3**: каталог медиа, разбор намерений, роли, пожелания, оркестрирование;
|
||
* **Спринт 6**: тест восстановления, второй контур бэкапа на VPS, ротация логов;
|
||
* **Kuma → Prometheus**: свой экспортёр, 62 монитора, 0 недоступных;
|
||
* **AdGuard в HA**: 14 сущностей восстановлены;
|
||
* **Мост Яндекс.Умный дом → MQTT**: 23 устройства, состояния в HA;
|
||
* **Навык Алисы**: вебхук `https://hub.buryans.ru/alice`;
|
||
* **Запуск фильма по команде**: Chromecast на Smart TV Pro;
|
||
* **Агенты**: класс A/B исполняется, класс C — заявки с TTL.
|