База знаний: архитектура, сервисы, агенты, регламенты, работа

This commit is contained in:
buryan-agent committed 2026-10-21 12:46:07 +03:00
1 parent b120e8a63d
commit b71dcbbf8b
9 files changed
+389

No files matched your search

+21
View File
@@ -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. Агенты начинают с наблюдения
Сначала только читают и предлагают, права добавляются постепенно.
Причина: автономия без доверия опасна.
+34
View File
@@ -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/` — по файлу на агента в день.
Голова агрегирует и присылает сводку только при проблемах.
+31
View File
@@ -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.
+43
View File
@@ -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. Уведомления — не больше трёх в день человеку.
+26
View File
@@ -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.
+15
View File
@@ -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`.
+28
View File
@@ -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. Запустить вручную и убедиться.
+162
View File
@@ -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`.
+29
View File
@@ -0,0 +1,29 @@
# Работа: ВКС/Presale
Отдельный контур для рабочих задач: требования, сравнения ВКС,
заметки встреч, шаблоны КП.
## Задача
Много данных и рутины: требования заказчиков, сравнение решений,
история договорённостей, шаблоны документов.
## Стек (план)
| Блок | Инструмент |
|---|---|
| База знаний | эта Wiki + `buryan-work` |
| Заметки встреч | Whisper + Ollama |
| Задачи | Vikunja |
| CRM-lite | Twenty / EspoCRM |
| Документы | OnlyOffice / Docuseal |
| Автоматизация | n8n |
## MVP
1. Шаблоны КП, ТЗ, чек-лист.
2. Матрица сравнения ВКС.
3. Транскрипция встречи → выжимка → база.
4. Бот `!пресейл <клиент>` — история и следующие шаги.
Приватность: всё локально, без облаков.