Files
buryan-infra/ops/PLAN.md
T

196 lines
8.7 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.
# 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` (faster-whisper → заметка) |
| Поиск | `!пресейл` |
---
# 4. Медиа: полный план (25 задач)
Документ: `ops/media/MEDIA.md`.
## Фаза M1. Сеть и загрузка
| ID | Задача | Статус |
|---|---|---|
| M-01 | Выход в интернет для *arr | ✅ Radarr/Sonarr/Prowlarr → прокси CT161 |
| M-02 | qBittorrent: найти и настроить | 🔄 не найден в контейнерах |
| M-03 | Тестовая загрузка «сквозняком» | ⏳ |
## Фаза M2. Качество и порядок
M-04 профили качества · M-05 правила апгрейда · M-06 структура папок ·
M-07 убрать Jackett · M-08 лимиты загрузок
## Фаза M3. Воспроизведение
M-09 один плеер · M-10 транскодинг · M-11 клиенты · M-12 родительский контроль
## Фаза M4. Субтитры и статистика
M-13 Bazarr ↔ *arr · M-14 Tautulli ↔ Plex · M-15 Seerr ↔ оба плеера · M-16 коллекции
## Фаза M5. Умное использование
M-17 рекомендации в дайджест · M-18 продолжить просмотр · M-19 уведомления · M-20 Trakt
## Фаза M6. Обслуживание
M-21 мониторинг места · M-22 автоочистка · M-23 дубли · M-24 бэкап конфигов ✅ ·
M-25 переезд на отдельный диск
---
# 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`. Статусы — источник истины,
этот план — карта.**