diff --git a/10-systems/services/gnexus-synapse.md b/10-systems/services/gnexus-synapse.md index e886e21..e7794aa 100644 --- a/10-systems/services/gnexus-synapse.md +++ b/10-systems/services/gnexus-synapse.md @@ -14,7 +14,7 @@ ## Identity - Host: `gnsynapse` (192.168.1.172), VM на `hp-proliant-dl380-g6` -- Deploy path: `/home/ubuntu/gnsynapse` (git clone, HEAD `0ba611c`) +- Deploy path: `/home/ubuntu/gnsynapse` (git clone, HEAD `2f6d8d4`) - Stack: docker compose (api + worker + postgres:17 + redis:7), порт хоста 8013 - Public URL: `https://synapse.gnexus.space` - Credentials: gnexus-creds secret `gn-synapse-prod-secrets` (id 616b707b-8194-4c98-a031-374b39012e9c) — POSTGRES_PASSWORD, MCP_TOKEN, GAUTH_CLIENT_ID/SECRET, GAUTH_WEBHOOK_SECRET; SSH хоста — secret `gnsynapse-ssh` @@ -61,6 +61,15 @@ - Проверено: initialize на LAN-эндпоинте → 200, serverInfo `synapse v1.30.0`; после рестарта navi.service в реестре Navi 35 тулов `mcp__synapse__*` (system_status, stats_get, sources_*, keys_*, types_*, targets_*, rules_*, events_*, deliveries_list, push_*, settings_*, me, my_*, send_test_event) — в docs/07 было 31, список вырос. - Нюанс рестарта navi.service: SIGTERM не завершал старый процесс, пока жива сессия агента (веб-клиент держит соединение); systemd добил по TimeoutStopSec (~90 c), новый процесс подхватил конфиг. Проверка подключения без journalctl: `GET http://127.0.0.1:8099/agents/mcp_servers` (без авторизации) → `connected: true`. +## Update 2026-10-05 04:35 (navi rei) — admin-сводка и мобильная адаптация + +- Обновление `0ba611c..2f6d8d4` (2 коммита): `a188bf8` Обзор: admin-сводка вместо пустой витрины; `2f6d8d4` Мобильная адаптация: перенос строк и модалка правил на узких экранах. +- Diffstat: 14 файлов +277/−51 — admin_routes.py (+46), mcp/tools.py (−44), DashboardView.vue (+143), i18n ru/en/uk (+11 каждый), RuleForm.vue, api.js, мелкие правки views. +- Миграций нет: `alembic current` = `a4f8d2c17b90 (head)` — без изменений. +- `.env` не менялся; локально только untracked `docker-compose.override.yml` (пережил pull и пересборку). +- Бэкап ДО обновления: `/home/ubuntu/backup-synapse-preupdate-2026-10-05-0433.sql` (28 KB, валидный дамп, pg_dump rc=0). +- Проверено после обновления: api healthy, postgres/redis healthy, worker celery ready (beat запущен, connected to redis), healthz `{"status":"ok","service":"synapse"}`, readyz postgres ok + redis ok, логи api без traceback (миграции entrypoint'ом — «применяю миграции...» без ошибок), MCP-запросы обрабатываются (POST /mcp 200). + ## SSO (gnexus-auth) — настроено 2026-10-04 (рантбук §5) - Владелец зарегистрировал OAuth-клиент `synapse` в gnexus-auth и передал креды; они вписаны в `.env` на хосте (GAUTH_CLIENT_ID `gnx_N4NS…`, GAUTH_CLIENT_SECRET, GAUTH_WEBHOOK_SECRET — значения в gnexus-creds, не в доках). diff --git a/90-maintenance/pending-changes/20261005013547-df4028a8.json b/90-maintenance/pending-changes/20261005013547-df4028a8.json new file mode 100644 index 0000000..898b130 --- /dev/null +++ b/90-maintenance/pending-changes/20261005013547-df4028a8.json @@ -0,0 +1,19 @@ +{ + "id": "20261005013547-df4028a8", + "kind": "doc", + "target": "10-systems/services/gnexus-synapse.md", + "summary": "Update 2026-10-05 04:35: стек обновлён 0ba611c..2f6d8d4 (admin-сводка + мобильная адаптация), миграций нет, бэкап 28 KB, все health-проверки пройдены", + "reason": "Обновление стека 0ba611c..2f6d8d4 выполнено 2026-10-05 04:35 (navi rei): 2 коммита (admin-сводка, мобильная адаптация), миграций нет, бэкап preupdate-2026-10-05-0433.sql (28 KB), все проверки здоровья пройдены. Факты получены по SSH с хоста gnsynapse.", + "payload": { + "content": "---\nowner: gmikcon\nstatus: active\nlast_reviewed: 2026-10-05\nreview_interval: 90d\nconfidence: high\nsource_of_truth: ssh-host-and-live-verified\n---\n\n# Gnexus Synapse\n\nЦентрализованный хаб уведомлений экосистемы Gnexus: сервисы присылают событие «что случилось», Synapse решает, кому, куда и каким каналом доставить (Telegram, Email, Push, internal log, system-to-system в Navi). Проект gntodo id 9; репозиторий `root/gn-synapse` на GitBucket.\n\n## Identity\n\n- Host: `gnsynapse` (192.168.1.172), VM на `hp-proliant-dl380-g6`\n- Deploy path: `/home/ubuntu/gnsynapse` (git clone, HEAD `2f6d8d4`)\n- Stack: docker compose (api + worker + postgres:17 + redis:7), порт хоста 8013\n- Public URL: `https://synapse.gnexus.space`\n- Credentials: gnexus-creds secret `gn-synapse-prod-secrets` (id 616b707b-8194-4c98-a031-374b39012e9c) — POSTGRES_PASSWORD, MCP_TOKEN, GAUTH_CLIENT_ID/SECRET, GAUTH_WEBHOOK_SECRET; SSH хоста — secret `gnsynapse-ssh`\n\n## Deployment (2026-10-04, navi rei)\n\n- `docker compose up -d --build` через sudo (user ubuntu не в docker-группе — ловушка как на bugtrail).\n- Alembic-миграции применяются entrypoint'ом api автоматически; голова `a4f8d2c17b90` (после Update 18:40).\n- `.env` создан из `.env.example`: POSTGRES_PASSWORD и MCP_TOKEN = `openssl rand -hex`, `GAUTH_BASE_URL=https://auth.gnexus.space`, `GAUTH_VERIFY_TLS=true`, `GAUTH_REDIRECT_URI=https://synapse.gnexus.space/auth/callback`, `SYNAPSE_PORT=8013`.\n- `docker-compose.override.yml` (локальная модификация, переживает git pull): extra_hosts `auth.gnexus.space:192.168.1.226` для api и worker — серверный call-home (валидация opaque-токенов через userinfo) идёт в LAN через internal-proxy, где валидный LE-сертификат. Браузерный редирект остаётся на публичный auth.gnexus.space (GAUTH_BASE_URL).\n\n## Update 2026-10-04 13:37 (navi rei)\n\n- Минорное обновление `82d9181..e00539e` (fix: знак Synapse на экране входа, правка frontend-ассетов).\n- Апстрим-баг: коммит `e00539e` удалил `frontend/public/assets/imgs/gnexus-mark.svg`, но ссылка в `LoginView.vue:19` осталась — Vite-сборка пала (`npm run build` exit 1, unresolved import). Описание коммита утверждало замену на `synapse-mark.svg`, фактически строка не была изменена.\n- Локальный фикс: `LoginView.vue:19` → `/assets/imgs/synapse-mark.svg` (sed), пересборка, стек поднят.\n- Бэкап перед обновлением: `/home/ubuntu/backup-synapse-2026-10-04-1337.sql` (24 KB).\n- Проверено после обновления: postgres/redis healthy, api healthy, worker celery ready, healthz/readyz ok, SPA отдаётся, `/assets/imgs/synapse-mark.svg` → 200 image/svg+xml, старый ассет → SPA-fallback (200 text/html, файл из dist удалён), публичный healthz ok, `/login` 200.\n\n## Update 2026-10-04 15:00 (navi rei) — персональные MCP-ключи\n\n- Обновление `e00539e..f13a251` (2 коммита): `f13a251` feat: персональные MCP-ключи — выпуск в SPA, роль владельца у тула; `2b86b4b` fix: ссылки на gnexus-mark в LoginView и docs/06 (дополнение к e00539e).\n- Локальный фикс LoginView из Update 13:37 сброшен перед pull — апстримный `2b86b4b` содержит идентичное исправление (тот же diff f7c45c0..f8ff947); пункт «запушить фикс» из Pending закрыт апстримом.\n- Миграция `20261004_0008_mcp_tokens.py` (c9a2d6e71f43): таблица `mcp_tokens` (user_id, name, system_role, token_hash, token_hint, last_used_at, revoked_at) — применена, `alembic current` = head.\n- `.env` не менялся: по новому `.env.example` семантика `MCP_TOKEN` сместилась — теперь это опциональный статический Bearer суперадмин-бэкдора; `/mcp` монтируется всегда, персональные ключи `mcp_...` пользователи выпускают себе в SPA на `/mcp-keys`. Наш MCP_TOKEN оставлен как есть (работает как бэкдор).\n- Бэкап после обновления: `/home/ubuntu/backup-synapse-2026-10-04-postupdate.sql` (26 KB).\n- Проверено после обновления: api healthy, postgres/redis healthy, worker обрабатывает задачи (`synapse.retry_due succeeded` в логах, PID1 `celery -A app.worker.celery_app worker -B`), healthz/readyz ok, SPA 200, `/mcp` без токена 401, `/mcp-keys` 200, публичный healthz ok, публичная SPA 200.\n\n## Update 2026-10-04 18:40 (navi rei) — i18n и блокировка пользователей\n\n- Обновление `f13a251..0ba611c` (3 коммита): `0ba611c` docs/06: язык интерфейса в Настройках (override, /me, Accept-Language); `597fb30` синхронизация с gnexus-handbook: healthz, /mcp-protocol/, блокировка, i18n; `689ea95` docs: конвенции экосистемы — ссылка на gnexus-handbook.\n- Diffstat: 40 файлов +2281/−452 — i18n ru/en/uk (~389–390 строк каждый), все views обновлены.\n- Миграция `20261004_0009_user_prefs.py` (a4f8d2c17b90): таблица `user_prefs` (user_id = sub gnexus-auth PK, locale override, blocked NOT NULL default false, blocked_at, updated_at) — применена, `alembic current` = head.\n- Флаг `blocked` приходит из вебхуков gnexus-auth (user.blocked/unblocked/deleted/archived/restored) и гейтит MCP-токены владельца.\n- `.env` не менялся; локально только untracked `docker-compose.override.yml` (не мешает).\n- Бэкап ДО обновления: `/home/ubuntu/backup-synapse-2026-10-04-1505-preupdate.sql` (26 KB, валидный дамп).\n- Проверено после обновления: api healthy, postgres/redis healthy, worker обрабатывает задачи (`synapse.retry_due succeeded`), healthz/readyz ok, SPA 200, `/mcp` без токена 401, публичный healthz ok, публичная SPA 200.\n\n## Update 2026-10-05 03:50 (navi rei) — MCP подключён к Navi (rei)\n\n- Владелец выдал персональный MCP-ключ (роль владельца); Navi rei подключила Synapse как MCP-сервер: `/home/ubuntu/navi-1/mcp_servers.d/synapse.json` (локальная модификация, переживает git stash при обновлениях). Конфиг: url `http://192.168.1.172:8013/mcp`, headers `Authorization: Bearer mcp_…` + `Host: localhost:8013`.\n- **Ловушка Host-заголовка**: FastMCP на бэкенде Synapse отклоняет запросы с Host `synapse.gnexus.space` → 421 «Invalid Host header» (DNS-rebinding защита). Прямой LAN-эндпоинт `http://192.168.1.172:8013/mcp` принимает только `Host: localhost:8013` или `127.0.0.1:8013`.\n- **Следствие — публичный MCP-эндпоинт сломан для внешних клиентов**: nginx на .226 передаёт `proxy_set_header Host $host`, бэкенд отвечает 421 на `https://synapse.gnexus.space/mcp`. Варианты фикса (не применены, решение за владельцем): (а) на .226 выделить `location /mcp` с `proxy_set_header Host localhost:8013`; (б) серверно ослабить host-validation в Synapse (доверенный хост). Внутренние клиенты LAN работают через прямое подключение с подменой Host.\n- Проверено: initialize на LAN-эндпоинте → 200, serverInfo `synapse v1.30.0`; после рестарта navi.service в реестре Navi 35 тулов `mcp__synapse__*` (system_status, stats_get, sources_*, keys_*, types_*, targets_*, rules_*, events_*, deliveries_list, push_*, settings_*, me, my_*, send_test_event) — в docs/07 было 31, список вырос.\n- Нюанс рестарта navi.service: SIGTERM не завершал старый процесс, пока жива сессия агента (веб-клиент держит соединение); systemd добил по TimeoutStopSec (~90 c), новый процесс подхватил конфиг. Проверка подключения без journalctl: `GET http://127.0.0.1:8099/agents/mcp_servers` (без авторизации) → `connected: true`.\n\n## Update 2026-10-05 04:35 (navi rei) — admin-сводка и мобильная адаптация\n\n- Обновление `0ba611c..2f6d8d4` (2 коммита): `a188bf8` Обзор: admin-сводка вместо пустой витрины; `2f6d8d4` Мобильная адаптация: перенос строк и модалка правил на узких экранах.\n- Diffstat: 14 файлов +277/−51 — admin_routes.py (+46), mcp/tools.py (−44), DashboardView.vue (+143), i18n ru/en/uk (+11 каждый), RuleForm.vue, api.js, мелкие правки views.\n- Миграций нет: `alembic current` = `a4f8d2c17b90 (head)` — без изменений.\n- `.env` не менялся; локально только untracked `docker-compose.override.yml` (пережил pull и пересборку).\n- Бэкап ДО обновления: `/home/ubuntu/backup-synapse-preupdate-2026-10-05-0433.sql` (28 KB, валидный дамп, pg_dump rc=0).\n- Проверено после обновления: api healthy, postgres/redis healthy, worker celery ready (beat запущен, connected to redis), healthz `{\"status\":\"ok\",\"service\":\"synapse\"}`, readyz postgres ok + redis ok, логи api без traceback (миграции entrypoint'ом — «применяю миграции...» без ошибок), MCP-запросы обрабатываются (POST /mcp 200).\n\n## SSO (gnexus-auth) — настроено 2026-10-04 (рантбук §5)\n\n- Владелец зарегистрировал OAuth-клиент `synapse` в gnexus-auth и передал креды; они вписаны в `.env` на хосте (GAUTH_CLIENT_ID `gnx_N4NS…`, GAUTH_CLIENT_SECRET, GAUTH_WEBHOOK_SECRET — значения в gnexus-creds, не в доках).\n- `docker compose up -d` пересоздал api и worker; api healthy.\n- Проверка: `/auth/login` → 307 на `https://auth.gnexus.space/oauth/authorize` с реальным client_id, redirect_uri `https://synapse.gnexus.space/auth/callback`, PKCE S256, scope `openid email profile roles permissions` (локально и через публичный HTTPS).\n- `authorize`-эндпоинт auth-сервера на этот запрос → 302 на `/login` — клиент зарегистрирован, PKCE принят (при неизвестном клиенте была бы ошибка 400).\n- Вебхуки `auth.logout` / `auth.global_logout` / `session.revoked` → `https://synapse.gnexus.space/auth/webhooks` зарегистрированы владельцем в auth при создании клиента; подпись проверяется через GAUTH_WEBHOOK_SECRET.\n\n## Public entry\n\n- Route: internet → external-vps (catch-all → internal-proxy) → nginx на `internal-proxy-vps` (.226) → `http://192.168.1.172:8013`.\n- nginx site: `/etc/nginx/sites-available/synapse.gnexus.space` на .226; TLS Let's Encrypt `synapse.gnexus.space` (certbot --nginx, до 2027-01-02, автопродление); HTTP→HTTPS 301 добавлен вручную (certbot не вписал).\n- DNS: wildcard `*.gnexus.space` → 51.83.131.93 (external-vps), отдельной записи не потребовалось.\n- `proxy_buffering off` + `proxy_read_timeout 300s` — для SSE/MCP.\n- Внимание: для `/mcp` см. Update 2026-10-05 — бэкенд отклоняет Host `$host`, публичный MCP-эндпоинт требует фикса.\n\n## Verified smoke (2026-10-04)\n\n- `/api/healthz` → `{\"status\":\"ok\",\"service\":\"synapse\"}`; `/api/readyz` → postgres ok, redis ok.\n- Worker: `celery@... ready.` в логах.\n- SPA отдаётся на `/` (Vue 3, lang=ru).\n- `/mcp` без токена → 401 (MCP включён, MCP_TOKEN задан).\n- Полный конвейер: source `monitoring` + type (container/down) + target `internal_log/smoke-log` + rule + API-ключ созданы через `python -m app.cli`; POST `/api/v1/events` через публичный HTTPS → 202; доставка в БД `delivered` с отрендеренным шаблоном.\n\n## Pending (владелец)\n\n1. Telegram-канал — отложен до задачи #29 (не создавать цель telegram).\n2. Push-канал (VAPID) — опционально, рантбук §7.\n3. Фикс публичного `/mcp` (421 Invalid Host header для внешних клиентов) — варианты в Update 2026-10-05 03:50.\n\n## Operations\n\n- Обновление: `cd /home/ubuntu/gnsynapse && git pull && sudo docker compose up -d --build` (перед этим `pg_dump` — откат миграций вниз не поддерживается всеми ревизиями).\n- Бэкап БД: `sudo docker compose exec -T postgres pg_dump -U synapse synapse > backup-$(date +%F).sql`.\n- MCP-управление: LAN `http://192.168.1.172:8013/mcp` с `Host: localhost:8013` (работает для внутренних клиентов) или персональным ключом `mcp_...`; публичный `https://synapse.gnexus.space/mcp` — см. Pending №3 (421 для внешних клиентов).\n- Smoke-объекты приёмки (source monitoring, key smoke-key, target smoke-log, rule id=1) — можно архивировать через админку/MCP после реальной настройки." + }, + "status": "applied", + "created_at": "2026-10-05T01:35:47Z", + "updated_at": "2026-10-05T01:35:49Z", + "applied_at": "2026-10-05T01:35:49Z", + "validation": { + "status": "ok", + "issue_count": 0, + "issues": [] + } +}