Files
buryan-infra/ops/hub-core/README.md
T
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

27 lines
1.1 KiB
Markdown

# 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.