Files

236 lines
11 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.
# 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`. Статусы — источник истины,
этот план — карта.**