Спринт: Wiki, статус-страница, рой агентов на DeepSeek

Wiki в Gitea: 9 страниц (архитектура, сервисы, агенты, дорожная карта,
регламенты, ADR, онбординг, работа). Инициализирована через API, затем
пушится как git-репозиторий.

Статус-страница hub.buryans.ru/status: 62 сервиса по группам, состояние
берётся из docker ps (TCP-проверка давала ложные срабатывания для CT111),
кэш 60 с, JSON на /status.json.

Рой агентов: groups.yaml (6 групп), policy.yaml (классы A/B/C/D, лимиты,
тихие часы), ТЗ шести секретарей и Головы, раннер (наблюдение) и мозг на
DeepSeek (json-ответ: диагноз, severity, предложенные действия). Таймеры:
раннер каждые 30 минут, мозг ежечасно. В v0 ничего не выполняется — только
диагностика и предложения; уведомление уходит при crit.

Найдено и исправлено агентом: freshrss, catalog и их oauth2-proxy были
недоступны — перезапущены, статус 62/62.
This commit is contained in:
buryan-agent committed 2026-10-21 12:43:57 +03:00
1 parent a931175a30
commit c20cddd747
13 files changed
+908

No files matched your search

+173
View File
@@ -0,0 +1,173 @@
#!/usr/bin/env python3
"""Мозг роя на DeepSeek: агент анализирует свою группу и предлагает действия.
v0 — режим наблюдения: ничего не выполняет, только диагностирует и предлагает.
Правила: строго по ТЗ агента, ответ в JSON, журнал, эскалация Голове.
"""
import json
import os
import sys
import time
import urllib.error
import urllib.request
from datetime import datetime
sys.path.insert(0, "/opt/hub-agents")
import agent_runner as runner # noqa: E402
API = "https://api.deepseek.com/v1/chat/completions"
KEY_FILE = "/root/.deepseek-key"
MODEL = os.environ.get("DEEPSEEK_MODEL", "deepseek-chat")
JOURNAL = "/var/lib/hub-agents/journal"
STATE = "/var/lib/hub-agents/state.json"
AGENTS = "/opt/hub-agents/agents"
def api_key():
try:
return open(KEY_FILE, encoding="utf-8").read().strip()
except Exception:
return ""
def llm(system, user, max_tokens=700):
key = api_key()
if not key:
return None, "нет ключа"
body = {
"model": MODEL,
"messages": [{"role": "system", "content": system},
{"role": "user", "content": user}],
"temperature": 0.2,
"max_tokens": max_tokens,
"response_format": {"type": "json_object"},
}
req = urllib.request.Request(API, data=json.dumps(body).encode(), method="POST",
headers={"Authorization": "Bearer " + key,
"Content-Type": "application/json"})
try:
with urllib.request.urlopen(req, timeout=90) as r:
data = json.loads(r.read() or b"{}")
return data["choices"][0]["message"]["content"], None
except urllib.error.HTTPError as e:
return None, f"HTTP {e.code}: {e.read()[:200].decode('utf-8', 'replace')}"
except Exception as e:
return None, str(e)[:150]
def load_agent(name):
path = os.path.join(AGENTS, name + ".yaml")
return runner.read_yaml(path)
def state():
try:
return json.load(open(STATE, encoding="utf-8"))
except Exception:
return {}
def save_state(st):
os.makedirs(os.path.dirname(STATE), exist_ok=True)
json.dump(st, open(STATE, "w", encoding="utf-8"), ensure_ascii=False)
def agent_system(tz):
return (
"Ты — секретарь направления в домашней инфраструктуре Buryans Hub. "
"Работаешь строго в рамках ТЗ. Не выдумывай фактов: опирайся только на данные. "
f"ТЗ: имя={tz.get('name')}, зона={tz.get('group')}, миссия={tz.get('mission')}. "
f"Разрешённые классы действий: {tz.get('allowed')}. "
f"Запрещено: {tz.get('forbidden')}. "
"Верни JSON: {\"diagnosis\": краткий вывод, \"severity\": \"ok|warn|crit\", "
"\"actions\": [{\"class\":\"A|B|C\",\"action\":\"restart_container|cleanup_logs|"
"update_container|reindex|notify|noop\",\"target\":\"имя\",\"why\":\"причина\"}], "
"\"summary\": одно предложение для человека}. "
"Если всё в порядке — actions: [] и severity: ok. Не предлагай запрещённое."
)
def run_agent(name, tz, group_report, policy, history):
user = json.dumps({
"group": group_report,
"policy": policy.get("classes") or {},
"recent": history[-3:],
"now": datetime.now().isoformat(timespec="seconds"),
}, ensure_ascii=False)
raw, err = llm(agent_system(tz), user)
if err:
return {"agent": name, "error": err}
try:
parsed = json.loads(raw)
except Exception:
parsed = {"diagnosis": raw[:300], "severity": "warn", "actions": [], "summary": ""}
parsed["agent"] = name
parsed["ts"] = datetime.now().isoformat(timespec="seconds")
parsed["group"] = group_report.get("group")
return parsed
def main():
groups_doc = runner.read_yaml("/opt/hub-agents/groups.yaml")
policy = runner.read_yaml("/opt/hub-agents/policy.yaml")
st = runner.status()
os.makedirs(JOURNAL, exist_ok=True)
stamp = datetime.now().strftime("%Y-%m-%d")
results = []
problems = 0
for gname, group in (groups_doc.get("groups") or {}).items():
if not isinstance(group, dict):
continue
rep = runner.check_group(gname, group, st)
agent = group.get("agent") or gname
tz = load_agent(agent)
has_issue = bool(rep["down"])
extra = rep.get("extra") or {}
if extra.get("disk_used_pct", 0) > 80 or extra.get("swap_used_pct", 0) > 70:
has_issue = True
if (extra.get("newest_backup_hours") or 0) > 30:
has_issue = True
if not has_issue:
continue
problems += 1
hist = []
try:
hist = json.load(open(os.path.join(JOURNAL, f"{stamp}-{agent}.json"),
encoding="utf-8"))
hist = hist if isinstance(hist, list) else [hist]
except Exception:
pass
res = run_agent(agent, tz, rep, policy, hist)
results.append(res)
path = os.path.join(JOURNAL, f"{stamp}-{agent}-llm.json")
json.dump(res, open(path, "w", encoding="utf-8"), ensure_ascii=False, indent=1)
sev = res.get("severity", "?")
print(f" {agent:<10} severity={sev:<5} {str(res.get('summary') or res.get('diagnosis'))[:90]}")
for a in res.get("actions") or []:
print(f" → [{a.get('class')}] {a.get('action')} {a.get('target')}: {a.get('why')}")
if not problems:
print("все группы в норме — LLM не вызывался")
# Голова: если есть crit — уведомить
crit = [r for r in results if r.get("severity") == "crit"]
if crit:
lines = [f"🔴 {r['agent']}: {r.get('summary') or r.get('diagnosis')}" for r in crit]
runner.notify("Голова: критичные проблемы", "\n".join(lines)[:1500])
print(" уведомление Головы отправлено")
stt = state()
stt["last_run"] = datetime.now().isoformat(timespec="seconds")
stt["agents"] = {r["agent"]: {"severity": r.get("severity"),
"summary": r.get("summary") or r.get("diagnosis")}
for r in results}
save_state(stt)
if __name__ == "__main__":
main()
+217
View File
@@ -0,0 +1,217 @@
#!/usr/bin/env python3
"""Раннер роя: читает группы и политику, проверяет сервисы, пишет журнал.
Режим v0 — только наблюдение: ничего не меняет, только собирает факты
и готовит отчёт Голове.
"""
import json
import os
import shutil
import socket
import subprocess
import sys
import time
from datetime import datetime
AGENTS_DIR = "/opt/hub-agents"
JOURNAL = "/var/lib/hub-agents/journal"
STATUS_URL = "http://127.0.0.1:9120/status.json"
NOTIFY = "http://127.0.0.1:9120/notify"
def read_yaml(path):
"""Минимальный YAML-парсер под наши файлы (без зависимостей)."""
out, cur, stack = {}, None, []
try:
lines = open(path, encoding="utf-8").read().splitlines()
except Exception:
return {}
for raw in lines:
if not raw.strip() or raw.strip().startswith("#"):
continue
indent = len(raw) - len(raw.lstrip())
line = raw.strip()
key, _, val = line.partition(":")
val = val.strip()
if indent == 0:
cur = None
if val:
out[key] = parse_scalar(val)
else:
out[key] = {}
stack = [(0, out[key])]
continue
# вложенность
while stack and indent <= stack[-1][0]:
stack.pop()
if not stack:
continue
target = stack[-1][1]
if val.startswith("["):
target[key] = [x.strip().strip("'\"") for x in val.strip("[]").split(",") if x.strip()]
elif val:
target[key] = parse_scalar(val)
else:
target[key] = {}
stack.append((indent, target[key]))
return out
def parse_scalar(v):
v = v.strip()
if v in ("true", "yes"):
return True
if v in ("false", "no"):
return False
if v.isdigit():
return int(v)
return v.strip("'\"")
def status():
import urllib.request
try:
with urllib.request.urlopen(STATUS_URL, timeout=25) as r:
return json.loads(r.read())
except Exception:
return {"services": [], "groups": {}, "total": 0, "up": 0}
def disk():
st = os.statvfs("/")
used = 1 - st.f_bavail / st.f_blocks
return round(used * 100, 1)
def swap():
try:
for line in open("/proc/meminfo"):
if line.startswith("SwapTotal"):
total = int(line.split()[1])
if line.startswith("SwapFree"):
free = int(line.split()[1])
return round(100 * (total - free) / total, 1) if total else 0.0
except Exception:
return 0.0
def backup_age_hours():
"""Сколько часов самому свежему дампу/архиву."""
best = None
for root in ("/mnt/backups", "/root/matrix-backups"):
for dirpath, _, files in os.walk(root):
for f in files:
if not (f.endswith((".gz", ".tar.gz", ".sql.gz", ".zst", ".tar"))):
continue
p = os.path.join(dirpath, f)
try:
m = os.path.getmtime(p)
except Exception:
continue
if best is None or m > best:
best = m
if not best:
return None
return round((time.time() - best) / 3600, 1)
def tcp(ip, port, timeout=1.2):
try:
with socket.create_connection((ip, port), timeout=timeout):
return True
except Exception:
return False
def notify(title, message):
import urllib.request
body = json.dumps({"title": title, "message": message}).encode()
req = urllib.request.Request(NOTIFY, data=body, method="POST",
headers={"Content-Type": "application/json"})
try:
urllib.request.urlopen(req, timeout=15).read()
return True
except Exception:
return False
def check_group(name, group, st):
"""Проверка группы: сервисы + доп. проверки."""
wanted = [x for x in (group.get("services") or []) if x]
services = st.get("services") or []
checked, down = 0, []
for svc in wanted:
matches = [s for s in services
if svc in (s.get("name") or "") or (s.get("name") or "") in svc]
if not matches:
continue
checked += len(matches)
for m in matches:
if not m.get("up"):
down.append(m.get("name"))
down = sorted(set(down))
extra = {}
checks = group.get("extra_checks") or []
if "disk" in checks:
extra["disk_used_pct"] = disk()
if "swap" in checks:
extra["swap_used_pct"] = swap()
if "backups" in checks:
extra["newest_backup_hours"] = backup_age_hours()
if "tls" in checks:
extra["tls_ok"] = tcp("127.0.0.1", 443)
if "ha_api" in checks:
extra["ha_ok"] = tcp("192.168.1.106", 8123)
if "zigbee" in checks:
extra["zigbee_bridge"] = tcp("192.168.1.10", 8098)
return {
"group": name,
"checked": checked,
"down": down,
"extra": extra,
}
def main():
groups_doc = read_yaml(os.path.join(AGENTS_DIR, "groups.yaml"))
policy = read_yaml(os.path.join(AGENTS_DIR, "policy.yaml"))
st = status()
os.makedirs(JOURNAL, exist_ok=True)
stamp = datetime.now().strftime("%Y-%m-%d")
reports = []
for name, group in (groups_doc.get("groups") or {}).items():
if not isinstance(group, dict):
continue
rep = check_group(name, group, st)
rep["agent"] = group.get("agent")
rep["ts"] = datetime.now().isoformat(timespec="seconds")
reports.append(rep)
path = os.path.join(JOURNAL, f"{stamp}-{rep['agent']}.json")
json.dump(rep, open(path, "w", encoding="utf-8"), ensure_ascii=False)
total_down = sum(len(r["down"]) for r in reports)
total_checked = sum(r["checked"] for r in reports)
print(f"проверено сервисов: {total_checked}, проблем: {total_down}")
for r in reports:
tail = f" — {', '.join(r['down'])}" if r["down"] else ""
print(f" {r['group']:<14} {r['checked'] - len(r['down'])}/{r['checked']}{tail}")
for k, v in (r["extra"] or {}).items():
print(f" {k}: {v}")
# Голова: сообщает только если есть проблемы и не тихие часы
hour = datetime.now().hour
quiet = hour >= 23 or hour < 8
if total_down and not quiet:
lines = [f"⚠️ Проблемы: {total_down}"]
for r in reports:
if r["down"]:
lines.append(f"• {r['group']}: {', '.join(r['down'])}")
notify("Страж: проблемы в сервисах", "\n".join(lines))
print(" уведомление отправлено")
else:
print(" уведомление не нужно")
if __name__ == "__main__":
main()
+9
View File
@@ -0,0 +1,9 @@
name: automaton
title: Автомат
group: automation
mission: n8n, боты, сценарии, доставка уведомлений, дайджест.
allowed: [A, B]
forbidden: [delete_workflow]
schedule: "*/20 * * * *"
kpi: {webhooks_ok: true, bots_active: true}
escalate: chief
+8
View File
@@ -0,0 +1,8 @@
name: chief
title: Голова
group: all
mission: Собирать отчёты, разрешать конфликты, эскалировать человеку, вести приоритеты.
allowed: [A]
forbidden: [direct_change]
schedule: "5 12 * * *"
reports_to: owner
+9
View File
@@ -0,0 +1,9 @@
name: domovoy
title: Домовой
group: home
mission: Устройства, Zigbee, MQTT, сценарии, интеграции Home Assistant.
allowed: [A]
forbidden: [change_zigbee_channel, remove_device]
schedule: "*/15 * * * *"
kpi: {zigbee_online: true, ha_ok: true}
escalate: keeper
+9
View File
@@ -0,0 +1,9 @@
name: keeper
title: Хранитель
group: core
mission: Следить за входом, сертификатами, DNS, БД и бэкапами; восстанавливать первым.
allowed: [A, B]
forbidden: [delete_backup, change_dns, rotate_root_password]
schedule: "*/30 * * * *"
kpi: {backup_age_hours_max: 26, disk_max: 85, swap_max: 50}
escalate: chief
+9
View File
@@ -0,0 +1,9 @@
name: librarian
title: Библиотекарь
group: knowledge
mission: Документы, книги, закладки, git, файлы, индексация.
allowed: [A, B]
forbidden: [delete_documents]
schedule: "0 6 * * *"
kpi: {paperless_ok: true, gitea_ok: true}
escalate: chief
+9
View File
@@ -0,0 +1,9 @@
name: mediator
title: Медиатор
group: media
mission: Библиотеки, каталог, метаданные, субтитры, запросы.
allowed: [A, B]
forbidden: [delete_media]
schedule: "0 */2 * * *"
kpi: {arr_ok: true, bazarr_linked: true}
escalate: chief
+9
View File
@@ -0,0 +1,9 @@
name: watcher
title: Страж
group: observability
mission: Метрики, алерты, SLO, разбор инцидентов, журнал.
allowed: [A]
forbidden: [change_retention, delete_metrics]
schedule: "*/10 * * * *"
kpi: {prometheus_ok: true, alerts_delivered: true}
escalate: chief
+54
View File
@@ -0,0 +1,54 @@
version: 1
# Группы сервисов и их секретари. Источник: services.yaml (ключ group).
groups:
core:
title: Ядро
agent: keeper
criticality: high
services: [authentik-security-server-1, authentik-security-worker-1,
authentik-security-postgresql-1, authentik-security-redis-1,
homeassistant-db, matrix-synapse, element-web, gitea, postgres]
extra_checks: [disk, swap, backups, tls]
home:
title: Дом
agent: domovoy
criticality: high
services: [homeassistant, mosquitto, zigbee2mqtt, adguard, frigate]
extra_checks: [zigbee, ha_api]
media:
title: Медиа
agent: mediator
criticality: normal
services: [jellyfin, plex, radarr, sonarr, lidarr, prowlarr, bazarr,
seerr, tautulli, navidrome, calibre-web, immich_database,
immich_machine_learning, qbittorrent]
extra_checks: [library_counts]
knowledge:
title: Знания
agent: librarian
criticality: normal
services: [paperless, gitea, nextcloud, linkding, freshrss, syncthing, mealie]
extra_checks: [documents]
automation:
title: Автоматизация
agent: automaton
criticality: high
services: [n8n, hub-core, book-bot, tg-admin-bot, dashy, catalog]
extra_checks: [bots, workflows]
observability:
title: Наблюдаемость
agent: watcher
criticality: high
services: [prometheus, alertmanager, grafana, loki, uptime_kuma]
extra_checks: [alerts]
chief:
agent: chief
schedule: "12:05"
reports_to: owner
+46
View File
@@ -0,0 +1,46 @@
version: 1
# Политика действий агентов.
classes:
A:
title: Безопасное
auto: true
examples: [restart_container, cleanup_logs, health_check, vacuum_journal]
limits:
actions_per_hour: 10
actions_per_day: 50
B:
title: Заметное
auto: true
notify: journal
examples: [update_container, rotate_logs, reindex_library, refresh_cache]
limits:
actions_per_hour: 3
actions_per_day: 10
C:
title: Рискованное
auto: false
approval: matrix_owner
examples: [change_config, migrate_data, delete_service, change_dns]
D:
title: Запрещено
auto: false
approval: never
examples: [delete_backup, read_secrets, change_router_config, disable_2fa]
notifications:
owner:
channels: [matrix]
max_per_day: 3
quiet_hours: "23:00-08:00"
digest: "12:00"
family:
channels: [matrix]
only: [personal]
journal: /var/lib/hub-agents/journal
safety:
dry_run_first_days: 14
snapshot_before_change: true
auto_rollback_if_unhealthy: true
max_parallel_actions: 1
+17
View File
@@ -21,3 +21,20 @@
Мониторинг и Home Assistant теперь пишут в Matrix: если что-то упало —
узнаете сразу, а не случайно.
## 2026-10-21 — Вики как единая истина
Вся документация теперь в Gitea Wiki: архитектура, карточки сервисов, агенты,
регламенты. Открывается по адресу `git.buryans.ru/agent-qwen/buryan-infra/wiki`.
## 2026-10-21 — Страница статуса
`hub.buryans.ru/status` показывает, что работает прямо сейчас: 62 сервиса
по группам, обновление раз в минуту. Не нужно спрашивать «а оно живое?».
## 2026-10-21 — Рой агентов
Появились шесть секретарей направлений: Хранитель (ядро), Домовой (дом),
Медиатор (медиа), Библиотекарь (знания), Автомат (автоматизация), Страж
(наблюдаемость) и Голова. Пока они только смотрят и предлагают — ничего
не меняют без разрешения. Отчёт приходит, только если есть проблема.
+339
View File
@@ -0,0 +1,339 @@
#!/usr/bin/env python3
"""Генерирует страницы Wiki из реестра и документов."""
import os
import re
REPO = "/root/buryan-infra"
OUT = "/root/wiki"
REG = os.path.join(REPO, "ops/registry/services.yaml")
def parse_registry():
text = open(REG, encoding="utf-8").read()
facts = {}
for m in re.finditer(r"^ (guests_ct|guests_vm|containers|domains|databases): (.+)$", text, re.M):
facts[m.group(1)] = m.group(2).strip()
services = []
cur = None
for line in text.splitlines():
if line.startswith(" - key:"):
if cur:
services.append(cur)
cur = {"key": line.split(":", 1)[1].strip().strip('"')}
elif cur is not None and line.startswith(" "):
k, _, v = line.strip().partition(":")
cur[k] = v.strip().strip('"')
if cur:
services.append(cur)
return facts, services
def page_home(facts):
return f"""# Buryans Hub — база знаний
Центральная истина проекта. Всё, что здесь описано, работает на домашнем
сервере Proxmox VE.
## Что такое Hub
Дом, который сам себя обслуживает: единый вход, единый канал уведомлений,
единый реестр сервисов, рой агентов-секретарей.
## Цифры
| Параметр | Значение |
|---|---|
| Гостей | {facts.get('guests_ct', '?')} CT + {facts.get('guests_vm', '?')} ВМ |
| Контейнеров | {facts.get('containers', '?')} |
| Доменов | {facts.get('domains', '?')} |
| Баз данных | {facts.get('databases', '?')} |
## Разделы
- [Архитектура](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. Уведомления — не больше трёх в день человеку.
"""
def page_architecture():
return """# Архитектура
## Шесть групп
| Группа | Назначение | Агент |
|---|---|---|
| Ядро | вход, сеть, БД, бэкапы | Хранитель |
| Дом | устройства, сценарии | Домовой |
| Медиа | фильмы, музыка, книги, фото | Медиатор |
| Знания | документы, код, файлы, закладки | Библиотекарь |
| Автоматизация | n8n, боты, hub-core | Автомат |
| Наблюдаемость | метрики, алерты, логи | Страж |
Над ними — **Голова**: сводка, приоритеты, эскалация.
## Потоки
```
Пользователь → Authentik (SSO + TOTP) → сервис
Событие → hub-core / MQTT → агент → действие или журнал
Контент → библиотека → дайджест 12:00 → Matrix
Инцидент → Страж → Голова → Matrix (с приоритетом)
```
## Принципы
1. **Один вход** — Authentik.
2. **Один канал** — Matrix, с резервом в Telegram.
3. **Один реестр** — `services.yaml`.
4. **Один журнал** — действия агентов.
5. **Одна истина** — эта Wiki.
"""
def page_services(facts, services):
groups = {}
for s in services:
groups.setdefault(s.get("group", "other"), []).append(s)
names = {
"core": "Ядро", "home": "Дом", "media": "Медиа", "knowledge": "Знания",
"automation": "Автоматизация", "observability": "Наблюдаемость",
"support": "Служебные", "other": "Прочее",
}
out = [f"# Сервисы\n", f"Всего контейнеров: **{len(services)}**.\n"]
for g in ("core", "home", "media", "knowledge", "automation", "observability", "support", "other"):
items = groups.get(g) or []
if not items:
continue
out.append(f"\n## {names.get(g, g)} ({len(items)})\n")
out.append("| Сервис | CT | Образ | Критичность |")
out.append("|---|---|---|---|")
for s in sorted(items, key=lambda x: x.get("name", "")):
out.append(f"| `{s.get('name')}` | {s.get('ct')} | {s.get('image', '')[:48]} | {s.get('criticality')} |")
out.append("\n## Как добавить сервис\n")
out.append("1. Добавить в `services.yaml` (или перегенерировать реестр).")
out.append("2. Создать карточку: домен, порт, SSO, бэкап, владелец.")
out.append("3. Настроить мониторинг и бэкап.")
out.append("4. Записать анонс в `ops/product/WHATS-NEW.md`.")
return "\n".join(out)
def page_agents():
return """# Агенты
## Рой
| Агент | Группа | Отвечает |
|---|---|---|
| Хранитель | Ядро | вход, 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/` — по файлу на агента в день.
Голова агрегирует и присылает сводку только при проблемах.
"""
def page_roadmap():
return """# Дорожная карта
| Фаза | Статус | Результат |
|---|---|---|
| 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`.
"""
def page_runbooks():
return """# Регламенты
## Сервис не отвечает
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. Запустить вручную и убедиться.
"""
def page_adr():
return """# Решения (ADR)
## ADR-001. Gitea — центральная истина
Вся документация, реестр и решения живут в Gitea. Wiki — точка входа.
Причина: знания не должны зависеть от памяти одного человека.
## ADR-002. Authentik как единый вход
Все сервисы за SSO, 2FA обязателен.
Причина: один пароль, один контур безопасности.
## ADR-003. Matrix как единый канал
Уведомления, боты, отчёты — в Matrix. Резерв — Telegram.
Причина: не десять приложений, а один канал.
## ADR-004. Реестр сервисов как код
`services.yaml` генерируется из факта и правится вручную только осознанно.
Причина: «что у нас есть» должно быть проверяемым.
## ADR-005. Агенты начинают с наблюдения
Сначала только читают и предлагают, права добавляются постепенно.
Причина: автономия без доверия опасна.
"""
def page_onboarding():
return """# Онбординг
## Добавить человека
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.
"""
def page_work():
return """# Работа: ВКС/Presale
Отдельный контур для рабочих задач: требования, сравнения ВКС,
заметки встреч, шаблоны КП.
## Задача
Много данных и рутины: требования заказчиков, сравнение решений,
история договорённостей, шаблоны документов.
## Стек (план)
| Блок | Инструмент |
|---|---|
| База знаний | эта Wiki + `buryan-work` |
| Заметки встреч | Whisper + Ollama |
| Задачи | Vikunja |
| CRM-lite | Twenty / EspoCRM |
| Документы | OnlyOffice / Docuseal |
| Автоматизация | n8n |
## MVP
1. Шаблоны КП, ТЗ, чек-лист.
2. Матрица сравнения ВКС.
3. Транскрипция встречи → выжимка → база.
4. Бот `!пресейл <клиент>` — история и следующие шаги.
Приватность: всё локально, без облаков.
"""
def main():
os.makedirs(OUT, exist_ok=True)
facts, services = parse_registry()
pages = {
"Home.md": page_home(facts),
"Architecture.md": page_architecture(),
"Services.md": page_services(facts, services),
"Agents.md": page_agents(),
"Roadmap.md": page_roadmap(),
"Runbooks.md": page_runbooks(),
"ADR.md": page_adr(),
"Onboarding.md": page_onboarding(),
"Work.md": page_work(),
}
for name, text in pages.items():
open(os.path.join(OUT, name), "w", encoding="utf-8").write(text)
print("страниц:", len(pages))
for name in pages:
print(" ", name)
if __name__ == "__main__":
main()