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. Бот `!пресейл <клиент>` — история и следующие шаги. + +Приватность: всё локально, без облаков.