[M-01] Мастер-план v3

This commit is contained in:
buryan-agent committed 2026-10-21 17:57:38 +03:00
1 parent 8781ba3cb4
commit 05d5401d48
1 file changed
+195
+195
View File
@@ -0,0 +1,195 @@
# 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`. Статусы — источник истины,
этот план — карта.**