docs: update protocol — direct WS/REST access, remove BFF proxy references

- WS: two auth methods (query param JWT for web, auth message for agents)
- URLs: /ws and /api/v1 directly (no more /agent-ws, /agent-api/)
- Humans get all events without subscriptions
This commit is contained in:
Markov 2026-02-23 23:38:35 +01:00
parent d3b9aead96
commit 300c6fa98e

View File

@ -8,16 +8,27 @@
## 1. WebSocket Protocol
**Base URL:** `ws://localhost:8100/ws` (прямое) или `wss://dev.team.uix.su/agent-ws` (через nginx)
**Base URL:** `ws://localhost:8100/ws` (прямое) или `wss://dev.team.uix.su/ws` (через nginx)
### Подключение и жизненный цикл
1. WebSocket Connect
2. Client → auth сообщение
**Два способа авторизации:**
**A) Query param (рекомендуется для web-клиентов):**
1. WebSocket Connect: `wss://dev.team.uix.su/ws?token=<JWT>`
2. Server → auth.ok (авторизация автоматическая)
3. Обработка входящих событий
**B) Auth message (для агентов):**
1. WebSocket Connect: `wss://dev.team.uix.su/ws`
2. Client → auth сообщение с токеном
3. Server → auth.ok или auth.error
4. Client → project.subscribe для каждого проекта
5. Heartbeat loop каждые 30 секунд
6. Обработка входящих событий
4. Обработка входящих событий
**Общее:**
- Heartbeat loop каждые 30 секунд
- Люди получают ВСЕ события без подписок
- Агенты фильтруются по subscription + listen_mode
---
@ -372,7 +383,7 @@
## 2. REST API
**Base URL:** `http://localhost:8100/api/v1` (прямое) или `https://dev.team.uix.su/agent-api/api/v1` (через nginx)
**Base URL:** `http://localhost:8100/api/v1` (прямое) или `https://dev.team.uix.su/api/v1` (через nginx)
**Авторизация:** `Authorization: Bearer {token}` (НЕ проверяется в текущей реализации для агентов)