76 lines
5.3 KiB
Markdown
76 lines
5.3 KiB
Markdown
# ЕДИНЫЙ СТАНДАРТ СЕРВИСА Buryans Hub
|
||
Дата: 07.11.2026. Проверка автоматическая: `/tmp/standard_check.py`,
|
||
отчёт: `/tmp/standard-report.csv`. Сервисов проверено: **64**.
|
||
|
||
## 1. Пять требований
|
||
| # | Требование | Как проверяется |
|
||
|---|---|---|
|
||
| S1 | **Идентичность** — вход через Authentik | есть свой oauth2-proxy или нативный OIDC |
|
||
| S2 | **Данные** — есть бэкап | архив в `/mnt/backups` (сервисный, БД или общий) |
|
||
| S3 | **Здоровье** — сервис отвечает | HTTP < 500 по `/`, `/health`, `/api/health` и др. |
|
||
| S4 | **Документация** — есть описание | каталог `deploy/ctNNN` в репозитории |
|
||
| S5 | **Уникальность** — нет дубля роли | ручная проверка при добавлении |
|
||
|
||
## 2. Текущее соответствие
|
||
| Требование | Соответствует | Процент |
|
||
|---|---|---|
|
||
| S1 идентичность | 32 / 64 | **50%** |
|
||
| S2 бэкап данных | 60 / 64 | **94%** |
|
||
| S3 здоровье | 40 / 64 | **62%** |
|
||
| S4 документация | 64 / 64 | **100%** |
|
||
| **полный стандарт (4/4)** | **19 / 64** | **30%** |
|
||
|
||
## 3. Что уже приведено к стандарту полностью (4/4)
|
||
|
||
bazarr (CT120), beszel (CT110), docmost (CT103), element-web (CT155), firefly (CT110), grocy (CT110), house3d-web (CT110), monica (CT110), n8n (CT108), nextcloud (CT109), node_red (CT108), paperless (CT105), podfetch (CT103), prometheus (CT134), prowlarr (CT119), radarr (CT118), sonarr (CT117), uptime_kuma (CT107), vaultwarden (CT109)
|
||
|
||
## 4. Где не хватает идентичности (S1)
|
||
|
||
Это внутренние сервисы, боты, экспортёры и те, что ещё не закрыты SSO:
|
||
|
||
adguard (CT107), alertmanager (CT134), authentik-security-server-1 (CT114), authentik-security-worker-1 (CT114), book-bot (CT111), buryan-alert-webhook (CT134), duplicati (CT111), exportarr-bazarr (CT134), exportarr-prowlarr (CT134), exportarr-radarr (CT134), exportarr-sonarr (CT134), frigate (CT126), gitea-runner (CT140), grafana (CT113), ha-strip (CT106), homebox (CT110), jackett (CT124), jellystat (CT103), kavita (CT111), lidarr (CT111), livekit (CT155), loki (CT113), matrix-coturn (CT155), matrix-synapse (CT155), mautrix-telegram (CT155), mealie (CT110), memos (CT110), mosquitto (CT107), seerr (CT121), syncthing (CT139), tg-admin-bot (CT108), vikunja (CT110)
|
||
|
||
## 5. Где не подтверждено здоровье (S3)
|
||
|
||
Часть сервисов не отдаёт HTTP на порту (внутренние экспортёры, MQTT, coturn,
|
||
livekit) — для них нужен отдельный тип проверки (TCP/процесс), а не HTTP.
|
||
|
||
adguard (CT107), alertmanager (CT134), audiobookshelf (CT111), authentik-security-worker-1 (CT114), book-bot (CT111), buryan-alert-webhook (CT134), calibre-web (CT111), catalog (CT111), dashy (CT102), dozzle (CT110), duplicati (CT111), freshrss (CT111), gitea (CT140), gitea-runner (CT140), homeassistant (CT106), jellyfin (CT103), lidarr (CT111), livekit (CT155), matrix-coturn (CT155), mosquitto (CT107), navidrome (CT125), openclaw (CT115), stirling-pdf (CT110), tg-admin-bot (CT108)
|
||
|
||
## 6. Что сделано для стандарта в эту ночь
|
||
|
||
| Требование | Действие | Результат |
|
||
|---|---|---|
|
||
| S2 | Ночной бэкап данных сервисов: `/usr/local/bin/hub-services-backup.sh`, таймер 03:45, ротация 7 дней | **28% → 94%** |
|
||
| S2 | Ежемесячные restore-учения (таймер) + проверка Immich/Paperless | работает |
|
||
| S1 | SSO для Nextcloud, Gitea, Jellyfin, Paperless, Vaultwarden | 5 сервисов |
|
||
| S4 | deploy/ для всех CT, удалён deploy/ct116 | 100% |
|
||
| S5 | Удалены Plex, Tautulli, Paperless-дубль, Mosquitto-дубль, Kavita | дублей нет |
|
||
|
||
## 7. Следующие шаги по стандарту (от центра к периферии)
|
||
|
||
| Приоритет | Что | Требование |
|
||
|---|---|---|
|
||
| 1 | TCP-проверки для MQTT, coturn, livekit, экспортёров | S3 |
|
||
| 2 | SSO для внутренних веб-сервисов (adguard, jackett, seerr, syncthing, frigate) | S1 |
|
||
| 3 | Бэкап медиа-метаданных (Jellyfin, Frigate записи) | S2 |
|
||
| 4 | Реестр сервисов в одном файле (роль, владелец, бэкап, SSO) | S4 |
|
||
| 5 | Автопроверка стандарта в CI (Gitea Actions) | все |
|
||
|
||
## 8. Правило приёмки нового сервиса
|
||
|
||
```
|
||
Сервис не добавляется, пока не выполнены S1–S4:
|
||
S1 — вход через Authentik
|
||
S2 — бэкап данных в /mnt/backups
|
||
S3 — health-проверка (HTTP или TCP)
|
||
S4 — deploy/ctNNN с compose и описанием
|
||
```
|
||
|
||
## 9. Как проверять
|
||
|
||
```bash
|
||
python3 /tmp/standard_check.py # таблица + сводка
|
||
cat /tmp/standard-report.csv # машинный отчёт
|
||
```
|