diff --git a/README.md b/README.md
index 03e6e24..a141ad9 100644
--- a/README.md
+++ b/README.md
@@ -1,54 +1,94 @@
-# 🏠 Buryan Hub Infrastructure
+# Buryans Hub — инфраструктура дома
-Homelab с публичным edge через VPS и VPN-доступом через Headscale.
+Репозиторий знаний и конфигурации. Всё, что описано здесь, реально работает
+на домашнем сервере Proxmox VE 9.1.6 (`192.168.1.10`).
-## Архитектура
+## Быстрый старт
-| Узел | Роль | IP |
-|---|---|---|
-| VPS | Nginx + SSL, Headscale coordinator, DERP | 193.233.210.184 |
-| PVE | Proxmox, Tailscale subnet router | 192.168.1.10 |
-| LAN | Сервисы (n8n, Gitea, Vault...) | 192.168.1.0/24 |
+| Что | Где |
+|---|---|
+| Пароли и токены | `ops/creds/CREDENTIALS.md` |
+| Карта сервисов и доменов | `ops/devices/DEVICES.md` |
+| Аудит всей системы | `ops/audit/FULL-AUDIT-2026-10-20.md` |
+| Что сделано за спринт | `ops/audit/AUDIT.md` |
+| Стратегия развития | `ops/audit/STRATEGY.md` |
+| Известные проблемы | `KNOWN_ISSUES.md` |
+| Правила для агентов | `AGENTS.md` |
-## Публичные домены (SSL через certbot)
+## Инфраструктура
-- n8n.buryans.ru → 192.168.1.108:5680 (CT 108)
-- git.buryans.ru → 192.168.1.140:3000 (CT 140)
-- status.buryans.ru → 192.168.1.107:3001 (CT 107)
-- vault.buryans.ru → 192.168.1.109:8080 (CT 109)
-- finance.buryans.ru → 192.168.1.110:8080 (CT 110)
-- recipes.buryans.ru → 192.168.1.110:9925 (CT 110)
-- music.buryans.ru → 192.168.1.125:4533 (CT 125)
-- sync.buryans.ru → 192.168.1.139:8384 (CT 139)
-- headscale.buryans.ru → 127.0.0.1:8443
+```
+Proxmox VE 9.1.6 · 16 ядер · 15 ГиБ RAM · 33 CT + 1 ВМ
+├── 101 proxy-lxc — promtail
+├── 102 portal-lxc — дашборд Dashy
+├── 103 media-lxc — Jellyfin
+├── 105 files-lxc — Paperless, Syncthing
+├── 106 smart-lxc — Home Assistant, Zigbee2MQTT
+├── 107 utils-lxc — MQTT, Uptime Kuma, AdGuard
+├── 108 automation-lxc — n8n, Node-RED
+├── 109 cloud-lxc — Nextcloud, Vaultwarden
+├── 110 office-lxc — Mealie, Firefly
+├── 111 reading-lxc — Lidarr, FreshRSS, Calibre-Web
+├── 113 backup-lxc — Grafana, Loki
+├── 114 authentik — единый вход (SSO)
+├── 116 plex / 117 sonarr / 118 radarr / 119 prowlarr
+├── 120 bazarr / 121 seerr / 122 tautulli / 123 torrent / 124 jackett
+├── 125 navidrome / 126 frigate / 127 linkding
+├── 134 prometheus — Prometheus, Alertmanager
+├── 139 syncthing / 140 gitea
+├── 151 postgres — 43 БД
+├── 155 matrix — Synapse, Element, мосты
+├── 160 llm-lxc — Ollama
+├── 161 gateway-lxc — прокси
+├── 201 headscale — mesh VPN
+└── ВМ 104 — Immich
+```
-## VPP
+## Документация по системам
-- Server: https://headscale.buryans.ru
-- Подключение: docs/vpn-clients.md
-- Ключи: headscale preauthkeys create --user buryan-hub --reusable --expiration 30d
+### Сеть
+- [Роутеры и Wi-Fi](ops/routers/ROUTERS.md) — Keenetic, каналы, mesh, клиент API
+- [Keenetic: особенности](ops/network/KEENETIC.md)
+- [Выход в интернет через VPS](ops/network/EGRESS.md)
+- [Список устройств](ops/devices/ALL-DEVICES.md) — 106 устройств
-## Структура репозитория
+### Дом
+- [Home Assistant: интеграции](ops/homeassistant/INTEGRATIONS.md)
+- [Home Assistant: сенсоры](ops/homeassistant/SENSORS.md)
+- [Zigbee2MQTT и донгл](ops/zigbee/ZIGBEE.md)
+- [Яндекс Умный дом и голос](ops/yandex/YANDEX-IOT.md)
+- [Алиса: управление голосом](ops/yandex/ALICE-VOICE-CONTROL.md)
-- vps/ — конфиги VPS (nginx, headscale, ufw)
-- pve/ — конфиги PVE (iptables, sysctl)
-- docs/ — документация (runbook, VPN, troubleshooting)
-- deploy/ — disaster recovery скрипты
-- docker/ — docker-compose для контейнеров
-- knowledge/runbooks/ — runbook'и по сервисам
+### Автоматизация
+- [n8n: восстановление и починка](ops/n8n/N8N-RECOVERY.md)
+- [Скрипты и cron](ops/backup/BACKUPS.md)
-## Быстрые команды
+### Медиа
+- [Медиасерверы](ops/media/FRIGATE-API.md)
+- [HACS и сторонние интеграции](ops/homeassistant/HACS-ALICE.md)
-### Проверка статуса
-for d in n8n git status vault finance recipes music sync; do
- echo "$d $(curl -4 -s -o /dev/null -w '%{http_code}' --max-time 20 https://$d.buryans.ru/)"
-done
+### Обслуживание
+- [Бэкапы](ops/backup/BACKUPS.md) — что, куда, когда
+- [Docker: защита конфигурации](ops/hardening/DOCKER-CONFIG.md)
+- [Авария и восстановление](ops/recovery/OUTAGE-2026-10-20.md)
+- [Nextcloud: приложения](ops/nextcloud/APPS.md)
-### Disaster recovery
-./deploy/install-on-new-vps.sh
+### Безопасность
+- [Учётные данные](ops/creds/CREDENTIALS.md)
+- [Authentik: автозапуск](ops/auth/AUTHENTIK-AUTOSTART.md)
+- 2FA: TOTP обязателен для всех входов (Authentik, стадия
+ `default-authentication-mfa-validation`)
-### Авто-синк
-/root/sync-infra.sh (cron 04:00 ежедневно)
+## Принципы
-## Контакты
-Roman Buryan (maloyakapg@gmail.com)
+1. Один вход — Authentik. Все сервисы за единым SSO.
+2. Один канал — Matrix. Уведомления, алерты, боты.
+3. Один инвентарь — `hub_devices` (104 трекера) + Zigbee + Яндекс.
+4. Всё автоматизируется: cron, systemd, n8n.
+5. Каждая ловушка записывается в документацию, а не забывается.
+
+## Как контрибьютить
+
+- Документы — в `ops/<тема>/`, имя файла ЗАГЛАВНЫМИ.
+- Секреты — только в `ops/creds/` и никогда в открытых репозиториях.
+- Каждое изменение — отдельный коммит с объяснением «почему».
diff --git a/data/dialog/dialog-2026-10-20.md b/data/dialog/dialog-2026-10-20.md
new file mode 100644
index 0000000..accaaf2
--- /dev/null
+++ b/data/dialog/dialog-2026-10-20.md
@@ -0,0 +1,3 @@
+# dialog
+
+записей: 0
diff --git a/data/events/events-2026-10-20.md b/data/events/events-2026-10-20.md
new file mode 100644
index 0000000..322ff7a
--- /dev/null
+++ b/data/events/events-2026-10-20.md
@@ -0,0 +1,3 @@
+# events
+
+записей: 0
diff --git a/data/inventory/inventory-2026-10-19.json b/data/inventory/inventory-2026-10-19.json
index ce6153b..32fe572 100644
--- a/data/inventory/inventory-2026-10-19.json
+++ b/data/inventory/inventory-2026-10-19.json
@@ -1,5 +1,5 @@
{
- "at": "2026-10-19T17:14:15+00:00",
+ "at": "2026-10-19T17:22:28+00:00",
"jellyfin": {
"Movie": 0,
"Series": 0,
diff --git a/data/inventory/inventory-2026-10-19.md b/data/inventory/inventory-2026-10-19.md
index 150c396..f24d22f 100644
--- a/data/inventory/inventory-2026-10-19.md
+++ b/data/inventory/inventory-2026-10-19.md
@@ -1,6 +1,6 @@
# Инвентаризация
-на 2026-10-19T17:14:15+00:00
+на 2026-10-19T17:22:28+00:00
| Сервис | Что есть |
|---|---|
diff --git a/data/inventory/inventory-2026-10-20.json b/data/inventory/inventory-2026-10-20.json
new file mode 100644
index 0000000..200ffe5
--- /dev/null
+++ b/data/inventory/inventory-2026-10-20.json
@@ -0,0 +1,35 @@
+{
+ "at": "2026-10-20T04:30:01+00:00",
+ "jellyfin": {
+ "Movie": 0,
+ "Series": 0,
+ "Episode": 0,
+ "Audio": 0
+ },
+ "navidrome": {
+ "albums": 0,
+ "tracks": 0,
+ "artists": 0
+ },
+ "calibre": {
+ "books": 0,
+ "authors": 1
+ },
+ "immich": {
+ "assets": 0,
+ "albums": 0,
+ "users": 1
+ },
+ "paperless": {
+ "documents": 0
+ },
+ "sonarr": {
+ "items": 0
+ },
+ "radarr": {
+ "items": 0
+ },
+ "frigate": {
+ "cameras": 0
+ }
+}
\ No newline at end of file
diff --git a/data/inventory/inventory-2026-10-20.md b/data/inventory/inventory-2026-10-20.md
new file mode 100644
index 0000000..186b7b7
--- /dev/null
+++ b/data/inventory/inventory-2026-10-20.md
@@ -0,0 +1,16 @@
+# Инвентаризация
+
+на 2026-10-20T04:30:01+00:00
+
+| Сервис | Что есть |
+|---|---|
+| Jellyfin | фильмы 0, сериалы 0, серии 0, треки 0 |
+| Navidrome | альбомы 0, треки 0, исполнители 0 |
+| Calibre | книги 0, авторы 1 |
+| Immich | снимки 0, альбомы 0 |
+| Paperless | документы 0 |
+| Sonarr | сериалов в базе 0 |
+| Radarr | фильмов в базе 0 |
+| Frigate | камер 0 |
+
+_Нули означают, что библиотека пуста, а не что сервис не работает._
\ No newline at end of file
diff --git a/data/logs/2026-10-19.jsonl b/data/logs/2026-10-19.jsonl
index 1e30aef..25674d8 100644
--- a/data/logs/2026-10-19.jsonl
+++ b/data/logs/2026-10-19.jsonl
@@ -3,3 +3,7 @@
{"id": 3, "at": "2026-10-19T20:12:21", "bot": "media", "from": "@polina:matrix.buryans.ru", "kind": "пожелание", "text": "хочу больше мультфильмов про кота"}
{"id": 4, "at": "2026-10-19T20:12:21", "bot": "book", "from": "@sergey:matrix.buryans.ru", "kind": "пожелание", "text": "добавьте больше фантастики"}
{"id": 5, "at": "2026-10-19T20:13:05", "bot": "media", "from": "@polina:matrix.buryans.ru", "kind": "пожелание", "text": "хочу сериал про космос"}
+{"id": 6, "at": "2026-10-19T21:26:07", "bot": "infra", "from": "?", "kind": "пожелание", "text": "входящие"}
+{"id": 7, "at": "2026-10-19T21:26:35", "bot": "infra", "from": "?", "kind": "пожелание", "text": "входящие"}
+{"id": 8, "at": "2026-10-19T21:28:03", "bot": "infra", "from": "?", "kind": "пожелание", "text": "входящие"}
+{"id": 9, "at": "2026-10-19T21:29:42", "bot": "infra", "from": "?", "kind": "пожелание", "text": "входящие"}
diff --git a/data/logs/2026-10-20.jsonl b/data/logs/2026-10-20.jsonl
new file mode 100644
index 0000000..4c21c56
--- /dev/null
+++ b/data/logs/2026-10-20.jsonl
@@ -0,0 +1,3 @@
+{"id": 1, "at": "2026-10-20T11:30:35", "bot": "media", "from": "?", "kind": "пожелание", "text": "граф"}
+{"id": 2, "at": "2026-10-20T11:35:19", "bot": "media", "from": "?", "kind": "пожелание", "text": "посоветуй фильм про космос"}
+{"id": 3, "at": "2026-10-20T11:36:04", "bot": "media", "from": "?", "kind": "пожелание", "text": "посоветуй фильм про космос"}
diff --git a/data/wishes/wishes-2026-10-19.md b/data/wishes/wishes-2026-10-19.md
index 013e5ee..3c7d6bd 100644
--- a/data/wishes/wishes-2026-10-19.md
+++ b/data/wishes/wishes-2026-10-19.md
@@ -1,6 +1,34 @@
# wishes
-записей: 3
+записей: 7
+
+## 6438d460b153a934
+обновлено: 2026-10-19 18:29:42.601848+00:00
+* **от**: неизвестно
+* **бот**: infra
+* **номер**: 9
+* **текст**: входящие
+
+## 4c399eb8d186a040
+обновлено: 2026-10-19 18:28:03.538302+00:00
+* **от**: неизвестно
+* **бот**: infra
+* **номер**: 8
+* **текст**: входящие
+
+## 206625a9dc2ef302
+обновлено: 2026-10-19 18:26:35.573683+00:00
+* **от**: неизвестно
+* **бот**: infra
+* **номер**: 7
+* **текст**: входящие
+
+## 7c71ec9ef6710266
+обновлено: 2026-10-19 18:26:07.531245+00:00
+* **от**: неизвестно
+* **бот**: infra
+* **номер**: 6
+* **текст**: входящие
## 7bd8e6589111cdcf
обновлено: 2026-10-19 17:13:05.235512+00:00
diff --git a/data/wishes/wishes-2026-10-20.md b/data/wishes/wishes-2026-10-20.md
new file mode 100644
index 0000000..ad6ea12
--- /dev/null
+++ b/data/wishes/wishes-2026-10-20.md
@@ -0,0 +1,71 @@
+# wishes
+
+записей: 10
+
+## 665bc3b1b8096a07
+обновлено: 2026-10-20 08:36:04.886173+00:00
+* **от**: неизвестно
+* **бот**: media
+* **номер**: 3
+* **текст**: посоветуй фильм про космос
+
+## d1449144fbb41ec4
+обновлено: 2026-10-20 08:35:19.767909+00:00
+* **от**: неизвестно
+* **бот**: media
+* **номер**: 2
+* **текст**: посоветуй фильм про космос
+
+## d3c1cb8c6803de58
+обновлено: 2026-10-20 08:30:35.819843+00:00
+* **от**: неизвестно
+* **бот**: media
+* **номер**: 1
+* **текст**: граф
+
+## 6438d460b153a934
+обновлено: 2026-10-19 18:29:42.601848+00:00
+* **от**: неизвестно
+* **бот**: infra
+* **номер**: 9
+* **текст**: входящие
+
+## 4c399eb8d186a040
+обновлено: 2026-10-19 18:28:03.538302+00:00
+* **от**: неизвестно
+* **бот**: infra
+* **номер**: 8
+* **текст**: входящие
+
+## 206625a9dc2ef302
+обновлено: 2026-10-19 18:26:35.573683+00:00
+* **от**: неизвестно
+* **бот**: infra
+* **номер**: 7
+* **текст**: входящие
+
+## 7c71ec9ef6710266
+обновлено: 2026-10-19 18:26:07.531245+00:00
+* **от**: неизвестно
+* **бот**: infra
+* **номер**: 6
+* **текст**: входящие
+
+## 7bd8e6589111cdcf
+обновлено: 2026-10-19 17:13:05.235512+00:00
+* **от**: @polina:matrix.buryans.ru
+* **бот**: media
+* **номер**: 5
+* **текст**: хочу сериал про космос
+
+## wish-002
+обновлено: 2026-10-19 17:11:24.853757+00:00
+* **от**: Сергей
+* **бот**: cam
+* **текст**: добавить камеры во двор
+
+## wish-001
+обновлено: 2026-10-19 17:11:24.834397+00:00
+* **от**: Полина
+* **бот**: media
+* **текст**: хочу мультфильмы про кота
diff --git a/docs/SPRINT-2026-10-19-SSO-2.md b/docs/SPRINT-2026-10-19-SSO-2.md
new file mode 100644
index 0000000..9b48c85
--- /dev/null
+++ b/docs/SPRINT-2026-10-19-SSO-2.md
@@ -0,0 +1,115 @@
+# Двойной вход: разбор и исправление (вечер 19.10.2026, второй заход)
+
+Продолжение `SPRINT-2026-10-19-SSO.md`. Владелец проверил службы браузером и
+прислал список. Мой прошлый проверяльщик был **слишком мягким** — он считал
+«код 200 и заголовок страницы» успехом, а это могла быть **форма входа самой
+службы**. Ниже — что на самом деле и что сделано.
+
+---
+
+## 1. Почему прошлая проверка врала
+
+`login-check.py` проходил вход и печатал заголовок страницы. Но Jellyfin,
+Gitea, Linkding, Paperless и другие отдают **свою форму входа с кодом 200** —
+и это выглядело как успех.
+
+Сделаны два новых проверяльщика:
+
+| Инструмент | Что делает |
+|---|---|
+| `auth-check.py` | после входа ищет поле пароля, переход на `/login`, и сравнивает страницу с той, что служба отдаёт **без входа** |
+| `form-check.py` | по каждому домену: есть ли ``, куда привело после входа, какие слова формы встречаются |
+| `persist-check.py` | остаётся ли cookie входа: второй заход не должен снова идти на Authentik |
+
+Важный вывод `persist-check.py`: **cookie входа держится** (у всех служб
+`_oauth2_proxy_0/_1`), круга через Authentik при каждом заходе нет. Значит
+«двойной вход» — это **своя форма службы**, а не повторный Authentik.
+
+---
+
+## 2. Корневая причина «двойного входа» у половины служб
+
+`oauth2-proxy` передаёт службе имя пользователя только в заголовках
+`X-Forwarded-User` и `X-Auth-Request-User`. Туда попадает поле `sub` из токена
+Authentik. У всех 35 провайдеров стоял `sub_mode=hashed_user_id` — то есть
+**хеш вместо логина**.
+
+Заголовка с настоящим логином (`X-Auth-Request-Preferred-Username`) `oauth2-proxy`
+**не передаёт вовсе** — проверено по его `--help`:
+
+```
+--set-xauthrequest set X-Auth-Request-User and X-Auth-Request-Email response headers
+--pass-user-headers pass X-Forwarded-User and X-Forwarded-Email information
+```
+
+Поэтому службы не находили пользователя и показывали свою форму.
+
+**Сделано:** у провайдеров `git-proxy`, `linkding-proxy`, `navidrome-proxy`,
+`finance-proxy`, `meals-proxy`, `calibre-web-proxy`, `status-proxy`
+`sub_mode` → **`user_username`**. Провайдеры Nextcloud, Vaultwarden и Matrix
+не трогал: там `sub` служит ключом привязки учётных записей.
+
+---
+
+## 3. Что исправлено и чем подтверждено
+
+| Служба | Было | Сделано | Проверка |
+|---|---|---|---|
+| **links** (Linkding) | своя форма | `LD_AUTH_PROXY_USERNAME_HEADER=HTTP_X_FORWARDED_USER` (стояло несуществующее `X-Auth-Request-Preferred-Username`) | вход → `/bookmarks`, поля пароля нет |
+| **docs** (Paperless) | своя форма | `PAPERLESS_ENABLE_HTTP_REMOTE_USER=true` + `PAPERLESS_HTTP_REMOTE_USER_HEADER_NAME=HTTP_X_FORWARDED_USER` | напрямую с заголовком — 200; через домен — документы, формы нет |
+| **finance** (Firefly) | своя форма | в compose настройки `AUTHENTICATION_GUARD*` были **сдвинуты внутрь `APP_KEY`** — Docker их не видел. Выровнены, `APP_URL` задан | guard работает: в журнале «User visits homepage (maloyakapg)» |
+| **music** (Navidrome) | своя форма | `ND_EXTAUTH_TRUSTEDSOURCES` расширен на сеть Docker (`172.16.0.0/12`) — прокси приходил из неё и заголовок игнорировался | частично, см. раздел 5 |
+| **adguard** | двойной вход | AdGuard Home **не умеет** вход от прокси — домен переведён **напрямую**, прокси выключен | один вход — AdGuard |
+| **media** (Jellyfin) | двойной вход | Jellyfin **не умеет** SSO — домен напрямую | один вход — Jellyfin |
+| **plex** | 400/401 | Plex **не умеет** SSO — домен напрямую; корень `/` → `/web/` | `/web/` открывается, один вход |
+| **git** (Gitea) | двойной вход | вход через прокси в Gitea работает **только для заранее созданных** пользователей, а в Gitea их три (`root`, `agent-qwen`, `agent-openclaw`) — ни один не совпадает с именами Authentik. Домен напрямую | один вход — Gitea |
+| **headscale** | 403 | корень перенаправлен на `/windows` | 200 |
+| **files** (Nextcloud) | «два Authentik» | провайдер один (проверено `occ user_oidc:provider`). Авто-переход на SSO **дал круг** — откатил; остаётся форма + кнопка SSO | вход по кнопке → Панель, 200 |
+
+---
+
+## 4. Где двойного входа нет (проверено формой)
+
+`sonarr`, `radarr`, `prowlarr`, `bazarr`, `meals`, `backup`, `hub`, `n8n`,
+`books`, `books/catalog/`, `status`, `news`, `openclaw`, `immich`, `home`,
+`vault`, `element`, `plex` — поля пароля на странице после входа нет.
+
+Отдельно: **`books.buryans.ru/catalog/`** — цикла больше нет (200, «Каталог
+книг»); причина была в адресе возврата провайдера и совпадении имени cookie
+с Calibre (раздел 3.1 прошлого отчёта).
+
+---
+
+## 5. Что осталось и почему (по факту, не по догадке)
+
+| Служба | Что мешает |
+|---|---|
+| **music** (Navidrome) | заголовок всё ещё не принимается: пользователь от прокси не создаётся. Дальше — смотреть журнал Navidrome (`ExtAuth`) и точный IP прокси в момент запроса |
+| **finance** (Firefly) | guard включён и узнаёт человека по почте, но Firefly уводит на `/new-user` (первичная настройка валюты/языка). В базе уже есть дубль `maloyakapg` (создан guard'ом) рядом с `maloyakapg@gmail.com` — нужно свести учётные записи |
+| **element** | Element просит вход **в Matrix**: нужен SSO в Synapse (OIDC-провайдер + homeserver.yaml). Это отдельная работа |
+| **meals** (Mealie) | Mealie умеет OIDC нативно, но у него вход через свой экран. Нужен провайдер в Authentik с адресом возврата Mealie |
+| **immich** | OIDC нативно не настроен (нужен административный API-ключ Immich) |
+| **vault** (Vaultwarden) | родной SSO включён, но хранилище всё равно требует **мастер-пароль** — это устройство Vaultwarden, убрать нельзя |
+| **home** (Home Assistant) | свой вход — так решено владельцем ранее |
+| **ombi** (Overseerr) | открывается `/setup` — служба **не настроена** (нужен вход через Plex и выбор библиотек). Это действие владельца |
+| **files** (Nextcloud) | авто-переход зацикливается; остаётся один клик по кнопке SSO |
+| **pve** | стандартный вход Proxmox — оставляем |
+
+---
+
+## 6. Уроки
+
+1. **Код 200 ничего не доказывает.** Успех — это когда служба **не просит
+ пароль** и **не совпадает** со своей же страницей без входа.
+2. **`oauth2-proxy` не умеет передавать логин.** Только `X-Forwarded-User` и
+ `X-Auth-Request-User`, а там `sub`. Хочешь логин — меняй `sub_mode` в
+ провайдере или настраивай у службы вход по почте.
+3. **Отступ в compose — это не «мелочь».** Три строки, сдвинутые на два
+ пробела, отключили вход Firefly целиком, и `docker compose config` это
+ показывал, а `docker inspect` — нет.
+4. **Домашний и внешний nginx — разные файлы.** Копировать конфиг с дома на
+ VPS нельзя: пути к сертификатам разные (`/etc/nginx/certs` против
+ `/etc/letsencrypt/live`). Один раз скопировал — VPS перестал проходить
+ `nginx -t`. Откатил из копии, правлю только точечно.
+5. **Авто-переход на вход — не всегда благо.** У Nextcloud `auto_redirect`
+ дал круг; откатил.
diff --git a/ops/auth/2FA.md b/ops/auth/2FA.md
new file mode 100644
index 0000000..1db046e
--- /dev/null
+++ b/ops/auth/2FA.md
@@ -0,0 +1,69 @@
+# Двухфакторная аутентификация (Authentik)
+
+## Что включено
+
+В потоке входа `default-authentication-flow` есть стадия
+`default-authentication-mfa-validation` (порядок 30, после логина и пароля).
+Она настроена так:
+
+| Параметр | Значение |
+|---|---|
+| `not_configured_action` | **configure** |
+| `device_classes` | `totp` |
+| `configuration_stages` | `default-authenticator-totp-setup` |
+
+Это значит: при входе любой пользователь, у которого нет TOTP-устройства,
+сначала попадает на экран настройки — сканирует QR в приложении
+(Google Authenticator, Aegis, 1Password, Яндекс Ключ) и вводит код.
+Со следующего входа — просто код.
+
+## Как это выглядит для пользователя
+
+1. Открывает любой сервис (`home.buryans.ru`, `git.buryans.ru`, …).
+2. Вводит логин и пароль (или входит через пароль).
+3. Если TOTP ещё нет — видит QR и поле для кода.
+4. Сканирует, вводит код → попадает в сервис.
+5. Дальше при каждом входе — только 6 цифр.
+
+## Откат (если что-то пошло не так)
+
+API-токен администратора работает независимо от входа, поэтому откат
+возможен всегда:
+
+```bash
+PATCH /api/v3/stages/authenticator/validate/c8d896d3-10a9-491c-99ff-6ef708a2b597/
+{"not_configured_action": "skip", "device_classes": ["static","totp","webauthn","duo","sms","email"]}
+```
+
+После этого 2FA перестаёт требоваться (но остаётся доступной в профиле).
+
+## Аварийный доступ
+
+Если пользователь потерял телефон:
+
+1. Войти как `akadmin` (у него будет свой TOTP).
+2. Admin → Directory → Users → пользователь → MFA Devices → удалить.
+3. Пользователь войдёт и настроит заново.
+
+Если потерян и `akadmin`:
+
+```bash
+pct exec 114 -- docker exec -it authentik-security-server-1 \
+ ak shell -c "from authentik.core.models import User; \
+ print(User.objects.get(username='akadmin').username)"
+```
+
+Либо отключить 2FA через PATCH выше.
+
+## Кого это касается
+
+Все интерактивные пользователи: `akadmin`, `roman`, `elena`, `sergey`,
+`daniil`, `polina`, `Nikita`, `AlexTest`. Сервисные аккаунты
+(`ak-outpost-*`, `ak-Sonarr-client_credentials`) не используют вход через
+браузер — их 2FA не затрагивает.
+
+## Где менять
+
+- Admin → Flows → `default-authentication-flow` → стадия MFA validation.
+- Admin → Stages → `default-authentication-mfa-validation`.
+- `webauthn` можно добавить в `device_classes` позже (ключи вместо кодов).
diff --git a/ops/gitea/cleanup.py b/ops/gitea/cleanup.py
new file mode 100644
index 0000000..3ba53c0
--- /dev/null
+++ b/ops/gitea/cleanup.py
@@ -0,0 +1,39 @@
+"""Наводит порядок в Gitea: удаляет пустые репо, ставит описание."""
+import json
+import urllib.error
+import urllib.request
+
+BASE = "http://192.168.1.140:3000/api/v1"
+TOK = "416f50c1a559be2def78bd6e3616a97906b0623d"
+H = {"Authorization": "token " + TOK, "Content-Type": "application/json"}
+
+
+def call(path, method="GET", body=None):
+ data = json.dumps(body).encode() if body is not None else None
+ req = urllib.request.Request(BASE + path, data=data, method=method, headers=H)
+ try:
+ with urllib.request.urlopen(req, timeout=30) as r:
+ raw = r.read()
+ return (json.loads(raw) if raw else {}), None
+ except urllib.error.HTTPError as e:
+ return None, f"HTTP {e.code}: {e.read()[:150].decode('utf-8', 'replace')}"
+
+
+EMPTY = ["root/buryan-infra", "root/runbooks"]
+for full in EMPTY:
+ owner, name = full.split("/")
+ res, err = call(f"/repos/{owner}/{name}", "DELETE")
+ print(f" DELETE {full}: {err or 'удалён'}")
+
+# описание и темы главного репозитория
+res, err = call("/repos/agent-qwen/buryan-infra", "PATCH", {
+ "description": "Инфраструктура Buryans Hub: сервисы, сеть, HA, автоматизация",
+ "private": False,
+ "topics": ["homelab", "proxmox", "home-assistant", "self-hosted"],
+})
+print(" PATCH buryan-infra:", err or "ok")
+
+repos, _ = call("/repos/search?limit=20")
+print("\n=== ОСТАЛОСЬ ===")
+for r in repos.get("data", []):
+ print(f" {r['full_name']:<32} {r.get('size')} КБ | {r.get('description') or '—'}")
diff --git a/ops/yandex/YANDEX-API-STATUS.md b/ops/yandex/YANDEX-API-STATUS.md
new file mode 100644
index 0000000..505a623
--- /dev/null
+++ b/ops/yandex/YANDEX-API-STATUS.md
@@ -0,0 +1,51 @@
+# Яндекс Умный дом: статус API
+
+## Итог
+
+| Способ | Статус | Комментарий |
+|---|---|---|
+| Чтение устройств (`api.iot.yandex.net/v1.0/user/info`) | ✅ работает | 23 устройства в аккаунте |
+| **Управление через API** | ❌ **403** | токен без scope `iot` |
+| Управление голосом (`!алиса …`) | ✅ работает | через колонку, Алиса сама выполняет |
+| Прямое управление Zigbee | ✅ работает | YNDX_00532 в HA, без облака |
+
+## Что именно проверено
+
+```
+POST api.iot.yandex.net/v1.0/devices/actions
+ Authorization: OAuth → 403 Forbidden
+ Authorization: OAuth → 403
+ Authorization: Bearer → 403
+
+POST iot.quasar.yandex.ru/m/user/devices/{id}/actions
+ Cookie → 401
+ Cookie + x-token → 401
+ Cookie + x-csrf-token → 401
+ x-token → 401
+```
+
+Переавторизация YandexStation по QR обновляет cookie, но `x_token` остаётся
+прежним и прав на запись не даёт. Второй экземпляр интеграции HA не разрешает
+(поток завершается `abort`).
+
+## Рабочий способ управления — голос
+
+```
+!алиса включи свет в тамбуре
+!алиса выключи телевизор в детской
+!алиса я ухожу
+!алиса какая погода
+```
+
+Бот отправляет на колонку «Алиса, …», и она выполняет. Работает для всех
+устройств и сценариев аккаунта, не только для тех 18, что попали в мост.
+
+## Как включить прямой API (если понадобится)
+
+1. Взять OAuth-токен с scope `iot` (приложение «Дом с Алисой» /
+ Яндекс Ключ → Интеграции).
+2. Положить в `/root/.yandex-mtoken`.
+3. Перезапустить `yandex-iot-bridge` — он уже умеет `on_off`,
+ `brightness`, `rgb`.
+
+Проверка: `POST /v1.0/devices/actions` должен вернуть 200.