EOS · Платформа (Backend)

HTTP API графа EOS и ledger. Эта страница — справка по эндпоинтам. Веб-админка живёт на отдельном домене (app.*).

Порт: 3000 Фаза: /health Деплой: по git-тегам platform-<env>-v<semver>

Авторизация. Мутации /api/* требуют сессии: войдите через /api/auth/login или /api/auth/google — сервер выставит HTTP-only cookie, которую браузер шлёт автоматически (запросы — same-origin).

Ответы. JSON: успех — { "data": … }, ошибка — { "error": { "code", "message" } }. Права проверяются на каждой мутации (Scope/Capability), каждое изменение пишется в аудит.

Служебные

GET/healthLiveness + текущая фаза (0 — нет БД, 1 — настроена, 2 — инициализирована).
GET/Эта страница (инструкция по API).
GET/api/whoamiclientId текущего вызывающего (требует авторизации).

Инициализация БД (только фаза 0)

GET/api/db-setup/statusНужна ли первичная настройка БД.
POST/api/db-setup/createСоздать БД платформы.
POST/api/db-setup/connectПодключить существующую БД + миграции.

Авторизация и настройка

GET/api/setup/public-configПубличная конфигурация (для экрана входа).
POST/api/auth/logoutВыход (клиент отбрасывает токен).
GET/api/auth/meПрофиль (GET/PATCH/DELETE; Bearer-токен).

Мета-модель (типы)

EntityType / RelationType / AttributeType — CRUD + :id + /lineage.

GET/api/entity-typesТипы объектов (+ POST, :id, /lineage).
GET/api/relation-typesТипы связей (+ POST, :id, /lineage).
GET/api/attribute-typesТипы полей (+ POST, :id).

Граф (объекты и связи)

GET/api/entitiesОбъекты (+ POST, :id, /relations, /attribute-history).
GET/api/relations/:idСвязи (+ POST для создания/закрытия).
GET/api/graph/subgraphПодграф (рекурсивный обход).
GET/api/graph/scope/:scopeIdГраф в рамках Scope.
GET/api/graph/cyclesПоиск циклов.
GET/api/graph/timelineОтметки изменений графа для as-of таймлайна.

Области, права, правила, шаблоны

GET/api/scopesОбласти (+ POST, :id, /bindings, /effective-types, /archive).
GET/api/capabilitiesПрава в Scope (grant/revoke/list).
GET/api/policiesПравила (+ POST, :id, PATCH :id, /archive).
GET/api/templatesШаблоны (+ folders, versions, shares, /install).
PATCH/api/principals/:idПеренос привязки principal.

Финансы (ledger)

POST/api/finance/transactionsСоздать транзакцию.
POST/api/finance/accountsСоздать счёт.
GET/api/finance/balanceБаланс / позиции.

Отчёты и аудит

GET/api/reports/stateСрез состояния.
GET/api/reports/lifecycleОтчёт по жизненному циклу.
GET/api/auditЖурнал аудита (только чтение).