Files
buryan-infra/docs/MODEL-FORMULA.md

177 lines
9.4 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: формула, роли, план
Дата: 07.11.2026. Основано на полном аудите (65 сервисов, 30 CT + 1 VM после чистки).
---
## 1. ФОРМУЛА
```
ХАБ = (ИДЕНТИЧНОСТЬ × ДАННЫЕ × СОБЫТИЯ × ЛИЦО) + ИММУНИТЕТ
```
| Множитель | Что это | Кто реализует |
|---|---|---|
| **Идентичность** | кто ты и что тебе можно | Authentik |
| **Данные** | где что лежит, кто владелец | postgres CT151 + датасеты по сервисам |
| **События** | что произошло → кто узнал | n8n + Matrix + Hermes |
| **Лицо** | чем пользуется человек | «Моё» + секретарь + голос |
| **Иммунитет** | самопроверка и восстановление | selfheal + Kuma + бэкапы + restore-учения |
**Правило:** любой новый сервис обязан встать в эту формулу. Не встаёт — не добавляем.
---
## 2. КТО ЗА ЧТО ОТВЕЧАЕТ
| Домен | Владелец данных | Сервис | Интерфейс для человека |
|---|---|---|---|
| Вход и права | Authentik | Authentik | sso.buryans.ru |
| Файлы | Nextcloud | Nextcloud | files.buryans.ru |
| Документы + OCR | Paperless | Paperless 3.4.2 | docs.buryans.ru |
| Фото и видео | Immich | Immich (VM104) | immich.buryans.ru |
| Медиа | Jellyfin | Jellyfin | media.buryans.ru |
| Музыка | Navidrome | Navidrome | music.buryans.ru |
| Книги | Calibre | Calibre-Web | books.buryans.ru |
| Аудиокниги | Audiobookshelf | Audiobookshelf | в books-группе |
| RSS | FreshRSS | FreshRSS | rss.buryans.ru |
| Код и вики | Gitea | Gitea | git.buryans.ru |
| Дом | HomeAssistant | HA + Zigbee2MQTT + MQTT | home.buryans.ru |
| Камеры | Frigate | Frigate | LAN |
| Финансы | Firefly (**пуст**) | Firefly III | finance.buryans.ru |
| Задачи | Vikunja | Vikunja | vikunja.buryans.ru |
| Заметки | Memos / Docmost | Memos, Docmost | через прокси |
| Контакты | Monica | Monica | через прокси |
| Продукты | Grocy | Grocy | через прокси |
| Рецепты | Mealie | Mealie | meals.buryans.ru |
| Инвентарь | Homebox | Homebox | через прокси |
| Пароли | Vaultwarden | Vaultwarden | vault.buryans.ru |
| Проекты ВКС | Комбайн | combine-* (6 сервисов) | :8096 |
| Связь | Matrix | Synapse + Element | element.buryans.ru |
| Уведомления | Matrix | hub-core /notify | боты |
| Поиск | — (агрегатор) | hub-core /search | :9120/search |
| Метрики | Prometheus | Prometheus + Grafana | metrics/logs |
| Логи | Loki | Loki + promtail | logs.buryans.ru |
| Мониторинг | Uptime Kuma | Kuma | status.buryans.ru |
| Бэкапы | Duplicati + vzdump | Duplicati, hub-db-dumps | backup.buryans.ru |
| Модели ИИ | Локальный LLM | 192.168.1.229 (qwen2.5) | — |
| Агенты | hub-agents | рой + Hermes | через боты |
---
## 3. ГРАНИЦЫ (что где НЕ делаем)
| Не делаем | Почему |
|---|---|
| Фото в Nextcloud | теряем лица/места/мобильную выгрузку |
| OCR в Nextcloud | Paperless сильнее |
| Медиа в Nextcloud | индексация гигабайтов убивает сервер |
| Чат в Nextcloud (Talk) | у нас Matrix |
| Задачи в Nextcloud (Deck) | у нас Vikunja/Hermes |
| Секреты в файлах | только Vaultwarden |
| Прямые копии данных между сервисами | только ссылки/API |
---
## 4. ЧТО ДОБАВИТЬ (ранжировано)
| # | Что | Зачем | Сложность |
|---|---|---|---|
| 1 | **Единый вход до конца** (Immich, остальные) | «один логин» реально | средняя |
| 2 | **Карточка объекта** в комбайне | связать файлы+фото+документы+проект | высокая |
| 3 | **WebDAV для комбайна** | убрать копии даташитов | низкая |
| 4 | **2FA после выбора точки входа** | защита владельца | низкая |
| 5 | **Импорт Immich** | фото с телефона в систему | средняя |
| 6 | **n8n-сценарии** (документ→карточка, проект→уведомление) | автоматизация | средняя |
| 7 | **Restore-учения по расписанию** (раз в месяц) | проверенный бэкап | низкая |
| 8 | **Единый дайджест** (утро: события, финансы, медиа) | «одно лицо» | средняя |
| 9 | **Мобильный адаптив комбайна** | работа с телефона | средняя |
| 10 | **Голосовой ввод через Matrix** (без колонки) | команды голосом | средняя |
---
## 5. ЧТО УБРАТЬ / УПРОСТИТЬ
| Что | Действие |
|---|---|
| ~~Plex, Tautulli~~ | **удалены** (CT116/122) |
| ~~Paperless-стек CT110~~ | **остановлен**, данные сохранены |
| ~~Mosquitto CT106~~ | **остановлен**, брокер CT107 |
| ~~Kavita~~ | остановлена (0 прогресса) |
| ~~NetBox, Syncthing в CT105~~ | остановлены ранее |
| ~~CT160 llm~~ | **удалён** (LLM на 192.168.1.229) |
| 29 oauth2-proxy | упростить: один reverse-proxy с forward-auth (позже) |
| Beszel-агент на 20 CT | оставить (дёшево), но пересмотреть |
**Итого: 33 → 30 CT. Было 168 контейнеров, стало 156.**
---
## 6. МЕТОДИКА: как принимаем решения
### 6.1. Правило добавления сервиса
```
1. Есть ли уже сервис с этой ролью? → нет дублей
2. Встаёт ли в формулу (§1)? → идентичность+данные+события+лицо
3. Есть ли OIDC? → иначе не добавляем
4. Есть ли бэкап данных? → иначе не добавляем
5. Есть ли health-check? → иначе не добавляем
6. Кто владелец данных? → один сервис = один владелец
```
### 6.2. Правило удаления
```
1. Нет пользователей 30 дней? → кандидат
2. Дублирует роль другого? → удалить
3. Данные мигрированы? → удалить
4. Финальный vzdump в /mnt/archive/retired-<дата>/
5. Убрать из Kuma, selfheal, jobs.cfg, deploy/
```
### 6.3. Правило изменений
```
1. Бэкап → 2. Один шаг → 3. Проверка → 4. Откат при провале → 5. Запись в журнал
```
---
## 7. МОЙ СПИСОК ЗАДАЧ (выполняю по порядку)
### Уже закрыто в эту ночь
- [x] Бэкап 3.0 ГБ + проверка
- [x] Дубли: Plex, Tautulli, Paperless, Mosquitto, Kavita
- [x] Paperless 3.3.4 → 3.4.2
- [x] SSO: Nextcloud, Gitea, Jellyfin, Paperless, Vaultwarden (гейт)
- [x] «Моё»: фото + проекты
- [x] Поиск: комбайн, Gitea, Nextcloud
- [x] Restore: Paperless + Immich
- [x] Immich ML поднят
- [x] Удалены CT116/122/160 (архив 5.2 ГБ)
### Следующие задачи (мой план)
| # | Задача | Статус |
|---|---|---|
| 1 | Убрать ссылки на удалённые CT из автоматик | ✅ сделано (Kuma, jobs.cfg, deploy/) |
| 2 | Обновить инвентарь и документацию | в работе |
| 3 | Проверить, что бэкап-задания валидны после правки jobs.cfg | следующая |
| 4 | ~~NetBox~~/мусор: найти ещё остановленные сервисы | следующая |
| 5 | WebDAV для комбайна (убрать копии даташитов) | нужно решение |
| 6 | Immich: импорт фото (нужен админ-вход) | блокировано |
| 7 | 2FA после выбора точки входа | блокировано решением |
| 8 | Карточка объекта в комбайне | крупная задача |
| 9 | n8n-сценарии событий | средняя |
| 10 | Ежемесячные restore-учения (таймер) | следующая |
---
## 8. ЧТО ЗНАЧИТ «ХОРОШО» (критерии готовности)
| Критерий | Сейчас | Цель |
|---|---|---|
| Сервисов с SSO | 35 / 40 | 40 / 40 |
| Restore проверен | Paperless, Immich | все критичные |
| Дубли | 0 | 0 ✅ |
| Поиск по всем доменам | 7 источников | +карточка объекта |
| Бэкап покрытие | ~90 % | 100 % критичных |
| Человек не знает про 30 CT | частично | полностью («Моё» + секретарь) |