From b71dcbbf8b416e76ea408ef837f9bdf48df48a38 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Wed, 21 Oct 2026 12:46:07 +0300 Subject: [PATCH] =?UTF-8?q?=D0=91=D0=B0=D0=B7=D0=B0=20=D0=B7=D0=BD=D0=B0?= =?UTF-8?q?=D0=BD=D0=B8=D0=B9:=20=D0=B0=D1=80=D1=85=D0=B8=D1=82=D0=B5?= =?UTF-8?q?=D0=BA=D1=82=D1=83=D1=80=D0=B0,=20=D1=81=D0=B5=D1=80=D0=B2?= =?UTF-8?q?=D0=B8=D1=81=D1=8B,=20=D0=B0=D0=B3=D0=B5=D0=BD=D1=82=D1=8B,=20?= =?UTF-8?q?=D1=80=D0=B5=D0=B3=D0=BB=D0=B0=D0=BC=D0=B5=D0=BD=D1=82=D1=8B,?= =?UTF-8?q?=20=D1=80=D0=B0=D0=B1=D0=BE=D1=82=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ADR.md | 21 +++++++ Agents.md | 34 ++++++++++ Architecture.md | 31 +++++++++ Home.md | 43 +++++++++++++ Onboarding.md | 26 ++++++++ Roadmap.md | 15 +++++ Runbooks.md | 28 +++++++++ Services.md | 162 ++++++++++++++++++++++++++++++++++++++++++++++++ Work.md | 29 +++++++++ 9 files changed, 389 insertions(+) create mode 100644 ADR.md create mode 100644 Agents.md create mode 100644 Architecture.md create mode 100644 Home.md create mode 100644 Onboarding.md create mode 100644 Roadmap.md create mode 100644 Runbooks.md create mode 100644 Services.md create mode 100644 Work.md diff --git a/ADR.md b/ADR.md new file mode 100644 index 0000000..bbbba36 --- /dev/null +++ b/ADR.md @@ -0,0 +1,21 @@ +# Решения (ADR) + +## ADR-001. Gitea — центральная истина +Вся документация, реестр и решения живут в Gitea. Wiki — точка входа. +Причина: знания не должны зависеть от памяти одного человека. + +## ADR-002. Authentik как единый вход +Все сервисы за SSO, 2FA обязателен. +Причина: один пароль, один контур безопасности. + +## ADR-003. Matrix как единый канал +Уведомления, боты, отчёты — в Matrix. Резерв — Telegram. +Причина: не десять приложений, а один канал. + +## ADR-004. Реестр сервисов как код +`services.yaml` генерируется из факта и правится вручную только осознанно. +Причина: «что у нас есть» должно быть проверяемым. + +## ADR-005. Агенты начинают с наблюдения +Сначала только читают и предлагают, права добавляются постепенно. +Причина: автономия без доверия опасна. diff --git a/Agents.md b/Agents.md new file mode 100644 index 0000000..d9a17dd --- /dev/null +++ b/Agents.md @@ -0,0 +1,34 @@ +# Агенты + +## Рой + +| Агент | Группа | Отвечает | +|---|---|---| +| Хранитель | Ядро | вход, TLS, DNS, бэкапы, восстановление | +| Домовой | Дом | устройства, сценарии, Zigbee, HA | +| Медиатор | Медиа | библиотеки, каталог, метаданные | +| Библиотекарь | Знания | документы, книги, закладки, git | +| Автомат | Автоматизация | n8n, боты, сценарии | +| Страж | Наблюдаемость | метрики, алерты, SLO | +| Голова | все | сводка, приоритеты, эскалация | + +## Классы действий + +| Класс | Что | Кто решает | +|---|---|---| +| A | перезапуск упавшего, чистка логов, health | агент сам | +| B | обновление, ротация, переиндексация | агент + журнал | +| C | конфиг, миграция, удаление | владелец в Matrix | +| D | бэкапы, DNS, секреты | запрещено автоматизировать | + +## Режимы + +1. **Наблюдатель** — только читает и предлагает (первая неделя). +2. **Класс A** — безопасные действия сам. +3. **Класс B** — с записью в журнал. +4. **Класс C** — только с подтверждением. + +## Журнал + +`/var/lib/hub-agents/journal/` — по файлу на агента в день. +Голова агрегирует и присылает сводку только при проблемах. diff --git a/Architecture.md b/Architecture.md new file mode 100644 index 0000000..a716afc --- /dev/null +++ b/Architecture.md @@ -0,0 +1,31 @@ +# Архитектура + +## Шесть групп + +| Группа | Назначение | Агент | +|---|---|---| +| Ядро | вход, сеть, БД, бэкапы | Хранитель | +| Дом | устройства, сценарии | Домовой | +| Медиа | фильмы, музыка, книги, фото | Медиатор | +| Знания | документы, код, файлы, закладки | Библиотекарь | +| Автоматизация | n8n, боты, hub-core | Автомат | +| Наблюдаемость | метрики, алерты, логи | Страж | + +Над ними — **Голова**: сводка, приоритеты, эскалация. + +## Потоки + +``` +Пользователь → Authentik (SSO + TOTP) → сервис +Событие → hub-core / MQTT → агент → действие или журнал +Контент → библиотека → дайджест 12:00 → Matrix +Инцидент → Страж → Голова → Matrix (с приоритетом) +``` + +## Принципы + +1. **Один вход** — Authentik. +2. **Один канал** — Matrix, с резервом в Telegram. +3. **Один реестр** — `services.yaml`. +4. **Один журнал** — действия агентов. +5. **Одна истина** — эта Wiki. diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..3296687 --- /dev/null +++ b/Home.md @@ -0,0 +1,43 @@ +# Buryans Hub — база знаний + +Центральная истина проекта. Всё, что здесь описано, работает на домашнем +сервере Proxmox VE. + +## Что такое Hub + +Дом, который сам себя обслуживает: единый вход, единый канал уведомлений, +единый реестр сервисов, рой агентов-секретарей. + +## Цифры + +| Параметр | Значение | +|---|---| +| Гостей | 33 CT + 1 ВМ | +| Контейнеров | 111 | +| Доменов | 40 | +| Баз данных | 43 | + +## Разделы + +- [Архитектура](Architecture) — группы сервисов, потоки +- [Сервисы](Services) — карточки всех сервисов +- [Агенты](Agents) — рой и правила +- [Дорожная карта](Roadmap) — что и когда +- [Регламенты](Runbooks) — что делать при сбое +- [Решения (ADR)](ADR) — почему сделано так +- [Онбординг](Onboarding) — как добавить человека или сервис +- [Работа: ВКС/Presale](Work) — отдельный контур + +## Главные документы + +- `ops/audit/FULL-AUDIT-2026-10-20.md` — состояние системы +- `ops/audit/AUDIT-2026-10-21-VISION.md` — аудит развития +- `ops/registry/services.yaml` — реестр +- `ops/product/WHATS-NEW.md` — что нового для людей + +## Правила + +1. Нет карточки в Wiki — сервиса не существует. +2. Нет ADR — изменение не начинается. +3. У каждого сервиса есть бэкап, SSO и владелец. +4. Уведомления — не больше трёх в день человеку. diff --git a/Onboarding.md b/Onboarding.md new file mode 100644 index 0000000..dfb1b09 --- /dev/null +++ b/Onboarding.md @@ -0,0 +1,26 @@ +# Онбординг + +## Добавить человека + +1. Authentik → Directory → Users → создать. +2. Добавить в группы (family, медиа, книги). +3. Выдать доступы к сервисам (SSO автоматически). +4. Пользователь при первом входе настраивает TOTP. +5. Добавить в нужные Matrix-комнаты. + +## Добавить сервис + +1. Развернуть в отдельном CT. +2. Завести oauth2-proxy и домен. +3. Добавить в `services.yaml` (или перегенерировать). +4. Настроить бэкап (данные + конфиг). +5. Добавить монитор в Kuma/Strap. +6. Записать карточку в Wiki. +7. Анонс в `ops/product/WHATS-NEW.md`. + +## Добавить агента + +1. Описать ТЗ в `/opt/hub-agents/agents/<имя>.yaml`. +2. Указать группу, классы действий, расписание. +3. Запустить в режиме «наблюдатель». +4. Через неделю — включить класс A. diff --git a/Roadmap.md b/Roadmap.md new file mode 100644 index 0000000..884f299 --- /dev/null +++ b/Roadmap.md @@ -0,0 +1,15 @@ +# Дорожная карта + +| Фаза | Статус | Результат | +|---|---|---| +| 0. Скелет | ✅ сделано | реестр, Wiki, статус-страница, сверка с аудитом | +| 1. Агенты-наблюдатели | 🔄 в работе | 6 агентов «читать и предлагать», журнал | +| 2. Автономия A | ⏳ | перезапуск, чистка, health | +| 3. Автономия B | ⏳ | обновления, ротация | +| 4. Класс C + Голова | ⏳ | подтверждения, сводки | +| 5. Быт | ⏳ | Grocy, Vikunja, Actual, Mealie | +| 6. Работа | ⏳ | Presale Cockpit | +| 7. Интеллект | ⏳ | RAG, CLIP, MCP | +| 8. Устойчивость | ⏳ | учения, резервный канал, UPS | + +Подробно — `ops/audit/AUDIT-2026-10-21-VISION.md`. diff --git a/Runbooks.md b/Runbooks.md new file mode 100644 index 0000000..ad03adf --- /dev/null +++ b/Runbooks.md @@ -0,0 +1,28 @@ +# Регламенты + +## Сервис не отвечает + +1. `!статус` или статус-страница — что именно упало. +2. Проверить контейнер: `docker ps -a | grep <имя>`. +3. Логи: `docker logs --tail 50 <имя>`. +4. Перезапуск: `docker restart <имя>` (класс A). +5. Если не помогло — смотреть зависимости (БД, SSO, сеть). +6. Записать в журнал. + +## Matrix недоступен + +1. `pct exec 155 -- docker ps` — Synapse. +2. Логи Synapse. +3. Резервный канал — Telegram (userbot). + +## Диск заполнен + +1. `df -h`, `lvs` — что растёт. +2. Логи: journald, nginx, docker json. +3. Чистка безопасна (класс A), удаление данных — только с подтверждением. + +## Бэкап не создался + +1. Проверить cron и `/mnt/backups`. +2. Проверить место. +3. Запустить вручную и убедиться. diff --git a/Services.md b/Services.md new file mode 100644 index 0000000..aa0ae8a --- /dev/null +++ b/Services.md @@ -0,0 +1,162 @@ +# Сервисы + +Всего контейнеров: **111**. + + +## Ядро (10) + +| Сервис | CT | Образ | Критичность | +|---|---|---|---| +| `authentik-security-postgresql-1` | 114 | postgres:16-alpine | high | +| `authentik-security-redis-1` | 114 | redis:7-alpine | high | +| `authentik-security-server-1` | 114 | ghcr.io/goauthentik/server:2026.8.4 | high | +| `authentik-security-worker-1` | 114 | ghcr.io/goauthentik/server:2026.8.4 | high | +| `element-web` | 155 | vectorim/element-web:latest | normal | +| `livekit` | 155 | livekit/livekit-server:latest | normal | +| `matrix-coturn` | 155 | coturn/coturn:latest | normal | +| `matrix-synapse` | 155 | matrixdotorg/synapse:latest | high | +| `mautrix-telegram` | 155 | dock.mau.dev/mautrix/telegram:latest | normal | +| `vaultwarden` | 109 | vaultwarden/server:latest | normal | + +## Дом (5) + +| Сервис | CT | Образ | Критичность | +|---|---|---|---| +| `adguard` | 107 | adguard/adguardhome:latest | normal | +| `frigate` | 126 | ghcr.io/blakeblackshear/frigate:stable | normal | +| `homeassistant` | 106 | ghcr.io/home-assistant/home-assistant:stable | high | +| `mosquitto` | 107 | eclipse-mosquitto:2 | high | +| `zigbee2mqtt` | 0 | ghcr.nju.edu.cn/koenkk/zigbee2mqtt:latest | normal | + +## Медиа (16) + +| Сервис | CT | Образ | Критичность | +|---|---|---|---| +| `bazarr` | 120 | lscr.io/linuxserver/bazarr:latest | normal | +| `book-bot` | 111 | buryan/book-bot:latest | normal | +| `calibre-web` | 111 | crocodilestick/calibre-web-automated:latest | normal | +| `catalog` | 111 | buryan/catalog:latest | normal | +| `immich_database` | 0 | tensorchord/pgvecto-rs:pg14-v0.2.0 | normal | +| `immich_machine_learning` | 0 | ghcr.io/immich-app/immich-machine-learning:v2.4. | normal | +| `jackett` | 124 | lscr.io/linuxserver/jackett:latest | normal | +| `jellyfin` | 103 | jellyfin/jellyfin:latest | normal | +| `lidarr` | 111 | ghcr.nju.edu.cn/linuxserver/lidarr:latest | normal | +| `navidrome` | 125 | deluan/navidrome:latest | normal | +| `plex` | 116 | linuxserver/plex:latest | normal | +| `prowlarr` | 119 | lscr.io/linuxserver/prowlarr:latest | normal | +| `radarr` | 118 | lscr.io/linuxserver/radarr:latest | normal | +| `seerr` | 121 | ghcr.io/seerr-team/seerr:latest | normal | +| `sonarr` | 117 | lscr.io/linuxserver/sonarr:latest | normal | +| `tautulli` | 122 | tautulli/tautulli:latest | normal | + +## Знания (12) + +| Сервис | CT | Образ | Критичность | +|---|---|---|---| +| `duplicati` | 111 | duplicati/duplicati:latest | normal | +| `firefly` | 110 | fireflyiii/core:latest | normal | +| `freshrss` | 0 | freshrss/freshrss:latest | normal | +| `freshrss` | 111 | freshrss/freshrss:latest | normal | +| `gitea` | 140 | gitea/gitea:latest | high | +| `linkding` | 127 | sissbruecker/linkding:latest | normal | +| `mealie` | 110 | ghcr.io/mealie-recipes/mealie:latest | normal | +| `nextcloud` | 109 | nextcloud:latest | normal | +| `paperless` | 105 | ghcr.io/paperless-ngx/paperless-ngx:latest | normal | +| `paperless_redis` | 105 | redis:7-alpine | normal | +| `syncthing` | 105 | lscr.io/linuxserver/syncthing:latest | normal | +| `syncthing` | 139 | syncthing/syncthing:latest | normal | + +## Автоматизация (6) + +| Сервис | CT | Образ | Критичность | +|---|---|---|---| +| `dashy` | 102 | lissy93/dashy:latest | normal | +| `n8n` | 0 | n8nio/n8n:latest | normal | +| `n8n` | 108 | n8nio/n8n:latest | normal | +| `node_red` | 108 | nodered/node-red:latest | normal | +| `openclaw` | 115 | 3814fb1f62f9 | normal | +| `tg-admin-bot` | 108 | telegram-admin-bot-tg-admin-bot | normal | + +## Наблюдаемость (5) + +| Сервис | CT | Образ | Критичность | +|---|---|---|---| +| `alertmanager` | 134 | prom/alertmanager:v0.27.0 | normal | +| `grafana` | 113 | grafana/grafana:latest | normal | +| `loki` | 113 | grafana/loki:3.2.1 | normal | +| `prometheus` | 134 | prom/prometheus:latest | high | +| `uptime_kuma` | 107 | louislam/uptime-kuma:latest | normal | + +## Служебные (51) + +| Сервис | CT | Образ | Критичность | +|---|---|---|---| +| `buryan-alert-webhook` | 134 | python:3.12-alpine | normal | +| `exportarr-bazarr` | 134 | ghcr.io/onedr0p/exportarr:latest | normal | +| `exportarr-prowlarr` | 134 | ghcr.io/onedr0p/exportarr:latest | normal | +| `exportarr-radarr` | 134 | ghcr.io/onedr0p/exportarr:latest | normal | +| `exportarr-sonarr` | 134 | ghcr.io/onedr0p/exportarr:latest | normal | +| `oauth2-proxy-backup` | 113 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-bazarr` | 120 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-calibre` | 111 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-catalog` | 111 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-dashy` | 102 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-element` | 155 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-finance` | 110 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-freshrss` | 111 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-home` | 106 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-linkding` | 127 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-n8n` | 108 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-navidrome` | 125 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-nodered` | 108 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-openclaw` | 115 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-paperless` | 110 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-prowlarr` | 119 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-radarr` | 118 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-sonarr` | 117 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-status` | 107 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `oauth2-proxy-tautulli` | 122 | quay.io/oauth2-proxy/oauth2-proxy:latest | normal | +| `promtail` | 101 | grafana/promtail:3.2.1 | normal | +| `promtail` | 102 | grafana/promtail:3.2.1 | normal | +| `promtail` | 103 | grafana/promtail:3.2.1 | normal | +| `promtail` | 105 | grafana/promtail:3.2.1 | normal | +| `promtail` | 106 | grafana/promtail:3.2.1 | normal | +| `promtail` | 107 | grafana/promtail:3.2.1 | normal | +| `promtail` | 108 | grafana/promtail:3.2.1 | normal | +| `promtail` | 109 | grafana/promtail:3.2.1 | normal | +| `promtail` | 110 | grafana/promtail:3.2.1 | normal | +| `promtail` | 111 | grafana/promtail:3.2.1 | normal | +| `promtail` | 113 | grafana/promtail:3.2.1 | normal | +| `promtail` | 114 | grafana/promtail:3.2.1 | normal | +| `promtail` | 115 | grafana/promtail:3.2.1 | normal | +| `promtail` | 116 | grafana/promtail:3.2.1 | normal | +| `promtail` | 117 | grafana/promtail:3.2.1 | normal | +| `promtail` | 118 | grafana/promtail:3.2.1 | normal | +| `promtail` | 119 | grafana/promtail:3.2.1 | normal | +| `promtail` | 120 | grafana/promtail:3.2.1 | normal | +| `promtail` | 121 | grafana/promtail:3.2.1 | normal | +| `promtail` | 122 | grafana/promtail:3.2.1 | normal | +| `promtail` | 125 | grafana/promtail:3.2.1 | normal | +| `promtail` | 127 | grafana/promtail:3.2.1 | normal | +| `promtail` | 134 | grafana/promtail:3.2.1 | normal | +| `promtail` | 139 | grafana/promtail:3.2.1 | normal | +| `promtail` | 140 | grafana/promtail:3.2.1 | normal | +| `promtail` | 155 | grafana/promtail:3.2.1 | normal | + +## Прочее (6) + +| Сервис | CT | Образ | Критичность | +|---|---|---|---| +| `files_db` | 109 | mariadb:10.6 | normal | +| `ha-strip` | 106 | nginx:alpine | normal | +| `heimdall` | 0 | lscr.io/linuxserver/heimdall:latest | normal | +| `nats` | 115 | nats:2.10.17-alpine | normal | +| `portainer` | 0 | portainer/portainer-ce:latest | normal | +| `swarm-redis` | 115 | redis:7-alpine | normal | + +## Как добавить сервис + +1. Добавить в `services.yaml` (или перегенерировать реестр). +2. Создать карточку: домен, порт, SSO, бэкап, владелец. +3. Настроить мониторинг и бэкап. +4. Записать анонс в `ops/product/WHATS-NEW.md`. \ No newline at end of file diff --git a/Work.md b/Work.md new file mode 100644 index 0000000..7354056 --- /dev/null +++ b/Work.md @@ -0,0 +1,29 @@ +# Работа: ВКС/Presale + +Отдельный контур для рабочих задач: требования, сравнения ВКС, +заметки встреч, шаблоны КП. + +## Задача + +Много данных и рутины: требования заказчиков, сравнение решений, +история договорённостей, шаблоны документов. + +## Стек (план) + +| Блок | Инструмент | +|---|---| +| База знаний | эта Wiki + `buryan-work` | +| Заметки встреч | Whisper + Ollama | +| Задачи | Vikunja | +| CRM-lite | Twenty / EspoCRM | +| Документы | OnlyOffice / Docuseal | +| Автоматизация | n8n | + +## MVP + +1. Шаблоны КП, ТЗ, чек-лист. +2. Матрица сравнения ВКС. +3. Транскрипция встречи → выжимка → база. +4. Бот `!пресейл <клиент>` — история и следующие шаги. + +Приватность: всё локально, без облаков.