Files
buryan-infra/ops/hub-core/README.md
buryan-agent 125ca73696 Hub Core: шина событий и граф сущностей в PostgreSQL
Первый шаг проекта: база hub_core (UTF8) на общем PostgreSQL, служба
hub-core на порту 9120.

Умеет: принимать события от сервисов (POST /event), вести карточки
сущностей (kind + key, статус, внешние ключи), связывать карточки,
искать и показывать последние события, публиковать важное в личку
владельцу через Matrix.

Проверено: событие radarr/media.imported записалось, карточка
«фильм | Дюна: часть вторая» создалась с кириллицей.

По пути: systemd разбивал DSN по пробелам (нужны кавычки), база была
создана в SQL_ASCII — пересоздана в UTF8.
2026-10-19 18:11:19 +03:00

1.1 KiB

Buryan Hub Core

Шина событий и граф сущностей.

Что делает

  • POST /event — принять событие от сервиса, записать в events, обновить карточку сущности, показать важное в Matrix.
  • POST /entity — создать/обновить карточку (kind + key).
  • POST /link — связать две карточки (например, фильм и книга).
  • GET /entities?q= — поиск по карточкам.
  • GET /events — последние события.
  • GET /health — состояние.

База

PostgreSQL на CT 151, база hub_core (UTF8), таблицы: entities, entity_links, events, sync_state.

Служба

/etc/systemd/system/hub-core.service, порт 9120, лог /var/log/hub-core.log, настройки /etc/hub-core/env.

Важно: в systemd DSN должен быть в кавычках (иначе разбивается по пробелам), и база обязательно UTF8 — иначе кириллица падает с UnicodeEncodeError.