Init

docs/telemt-control-api.md

@@ -0,0 +1,22 @@
+# Telemt Control API (BFF)
+
+Панель проксирует [Telemt Control API `/v1`](https://github.com/telemt/telemt/blob/main/docs/Architecture/API/API.md).
+
+## Контракт UI
+
+| Режим | Путь |
+|-------|------|
+| standalone | `GET/POST/PATCH/DELETE /api/telemt/*` → `TELEMT_API_URL/v1/*` |
+| оба | `… /api/servers/:id/telemt/*` (`local` в standalone) |
+| fleet | job `telemt.proxy` на агенте |
+
+Envelope: `{ ok, data?, revision?, error? }`. Для мутаций с revision передавайте `If-Match`.
+
+## Типичные эндпоинты
+
+- `/v1/health`, `/v1/stats/summary`
+- `/v1/users`
+- `/v1/runtime/me_pool_state`, `/v1/runtime/events/recent`
+- `/v1/security/posture`
+
+Клиент: `apps/api/src/services/telemt-client.ts`.