Первый шаг проекта: база hub_core (UTF8) на общем PostgreSQL, служба hub-core на порту 9120. Умеет: принимать события от сервисов (POST /event), вести карточки сущностей (kind + key, статус, внешние ключи), связывать карточки, искать и показывать последние события, публиковать важное в личку владельцу через Matrix. Проверено: событие radarr/media.imported записалось, карточка «фильм | Дюна: часть вторая» создалась с кириллицей. По пути: systemd разбивал DSN по пробелам (нужны кавычки), база была создана в SQL_ASCII — пересоздана в UTF8.
27 lines
1.1 KiB
Markdown
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.
|