diff --git a/ops/agents/agent_brain.py b/ops/agents/agent_brain.py new file mode 100644 index 0000000..8d5e30c --- /dev/null +++ b/ops/agents/agent_brain.py @@ -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() diff --git a/ops/agents/agent_runner.py b/ops/agents/agent_runner.py new file mode 100644 index 0000000..f9d3a8e --- /dev/null +++ b/ops/agents/agent_runner.py @@ -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() diff --git a/ops/agents/agents/automaton.yaml b/ops/agents/agents/automaton.yaml new file mode 100644 index 0000000..55c9baa --- /dev/null +++ b/ops/agents/agents/automaton.yaml @@ -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 diff --git a/ops/agents/agents/chief.yaml b/ops/agents/agents/chief.yaml new file mode 100644 index 0000000..0e8e258 --- /dev/null +++ b/ops/agents/agents/chief.yaml @@ -0,0 +1,8 @@ +name: chief +title: Голова +group: all +mission: Собирать отчёты, разрешать конфликты, эскалировать человеку, вести приоритеты. +allowed: [A] +forbidden: [direct_change] +schedule: "5 12 * * *" +reports_to: owner diff --git a/ops/agents/agents/domovoy.yaml b/ops/agents/agents/domovoy.yaml new file mode 100644 index 0000000..5a5eee3 --- /dev/null +++ b/ops/agents/agents/domovoy.yaml @@ -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 diff --git a/ops/agents/agents/keeper.yaml b/ops/agents/agents/keeper.yaml new file mode 100644 index 0000000..83dafcf --- /dev/null +++ b/ops/agents/agents/keeper.yaml @@ -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 diff --git a/ops/agents/agents/librarian.yaml b/ops/agents/agents/librarian.yaml new file mode 100644 index 0000000..c4d0cd1 --- /dev/null +++ b/ops/agents/agents/librarian.yaml @@ -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 diff --git a/ops/agents/agents/mediator.yaml b/ops/agents/agents/mediator.yaml new file mode 100644 index 0000000..551564d --- /dev/null +++ b/ops/agents/agents/mediator.yaml @@ -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 diff --git a/ops/agents/agents/watcher.yaml b/ops/agents/agents/watcher.yaml new file mode 100644 index 0000000..27da5a7 --- /dev/null +++ b/ops/agents/agents/watcher.yaml @@ -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 diff --git a/ops/agents/groups.yaml b/ops/agents/groups.yaml new file mode 100644 index 0000000..14fbff3 --- /dev/null +++ b/ops/agents/groups.yaml @@ -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 diff --git a/ops/agents/policy.yaml b/ops/agents/policy.yaml new file mode 100644 index 0000000..cfc55d8 --- /dev/null +++ b/ops/agents/policy.yaml @@ -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 diff --git a/ops/product/WHATS-NEW.md b/ops/product/WHATS-NEW.md index 08ecac4..789a88b 100644 --- a/ops/product/WHATS-NEW.md +++ b/ops/product/WHATS-NEW.md @@ -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 — Рой агентов + +Появились шесть секретарей направлений: Хранитель (ядро), Домовой (дом), +Медиатор (медиа), Библиотекарь (знания), Автомат (автоматизация), Страж +(наблюдаемость) и Голова. Пока они только смотрят и предлагают — ничего +не меняют без разрешения. Отчёт приходит, только если есть проблема. diff --git a/ops/wiki/build_wiki.py b/ops/wiki/build_wiki.py new file mode 100644 index 0000000..9844dc0 --- /dev/null +++ b/ops/wiki/build_wiki.py @@ -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()