From 81bcdf8047ba8c09dffbbdf12283892d97ebe7aa Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Fri, 30 Oct 2026 23:50:11 +0300 Subject: [PATCH] =?UTF-8?q?[HOME]=20=D0=A1=D1=82=D0=B0=D0=BD=D0=B4=D0=B0?= =?UTF-8?q?=D1=80=D1=82=20=D0=BD=D0=BE=D0=B2=D1=8B=D1=85=20=D1=81=D0=B5?= =?UTF-8?q?=D1=80=D0=B2=D0=B8=D1=81=D0=BE=D0=B2:=20SSO=20Authentik=20+=20P?= =?UTF-8?q?ostgreSQL=20=D0=BD=D0=B0=20151;=20=D0=B1=D0=B0=D0=B7=D0=B0=20ho?= =?UTF-8?q?use3d=20=D0=B7=D0=B0=D0=B2=D0=B5=D0=B4=D0=B5=D0=BD=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/home/SERVICE-STANDARD.md | 58 ++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 ops/home/SERVICE-STANDARD.md diff --git a/ops/home/SERVICE-STANDARD.md b/ops/home/SERVICE-STANDARD.md new file mode 100644 index 0000000..82a650a --- /dev/null +++ b/ops/home/SERVICE-STANDARD.md @@ -0,0 +1,58 @@ +# Стандарт для новых сервисов Buryans Hub (зафиксировано 30.10.2026) + +Владелец: «всё делаем в нашем стиле — сразу SSO и база на 151». +Это правило для любого нового сервиса, в том числе для 3D-панели дома. + +## 1. Доступ — только через единый вход (Authentik) + +1. В Authentik создаётся **Application** + **Provider** (proxy). +2. Перед сервисом ставится **oauth2-proxy** (как у остальных сервисов): + контейнер в том же CT, конфиг — в `deploy/ctNNN/docker-compose.yml`. +3. nginx (локальный хост + VPS) добавляет `auth_request /oauth2/auth` + и `error_page 401 = /oauth2/sign_in`. +4. Сертификат — из Let's Encrypt на VPS, синхронизируется + `sync_certs.py` (Tailscale), локальный nginx работает с валидным сертом. + +Исключения (осознанные): API-эндпоинты, которые не могут пройти SSO +(Matrix client API, HA API с токеном) — для них SSO отключён точечно. + +## 2. Данные — только на основном PostgreSQL 192.168.1.151 + +1. Отдельная **база** и **роль** под сервис (никакого общего superuser). +2. Пароль — в `/root/.-db.env` (права 600), в репозиторий не попадает. +3. Локальный SQLite — только как временное исключение (HA recorder — см. п. 4). +4. Дампы — через существующий `db_dumps.py`, хранение в `/mnt/archive/backups/db`. + +Уже заведено для 3D-панели: + +| Параметр | Значение | +|---|---| +| База | `house3d` | +| Роль | `house3d` | +| Хост | `192.168.1.151:5432` | +| Креды | `/root/.house3d-db.env` (600) | + +## 3. Эксплуатация (как у всех) + +* compose в `deploy/ctNNN/docker-compose.yml`, образ с пином; +* сервис в `ops/update-manager/services.yaml`; +* мониторинг: цель в Prometheus + монитор в Uptime Kuma; +* бэкап: дампы БД + конфиги в общий контур; +* документация в `ops/<тема>/` и коммит с ID. + +## 4. Открытый вопрос по HA + +Сейчас история HA пишется в локальный SQLite (recorder). По новому правилу +её место — Postgres на 151 (отдельная база `homeassistant`). Переезд +возможен, но требует аккуратной миграции и остановки записи; решение за +владельцем. + +## 5. 3D-панель дома — предварительный план + +| Компонент | Где | +|---|---| +| Рендер/сцена | Blender на хосте (артефакты — PNG/SVG в репозитории) | +| Веб-панель (three.js) | контейнер в CT110 (office-lxc) или новый CT | +| Данные (комнаты, устройства, сцены) | Postgres `house3d` на 151 | +| Доступ | Authentik + oauth2-proxy, домен (предложить `3d.buryans.ru`) | +| Мониторинг | Prometheus + Kuma |