From 300c6fa98e53050b8bf53024344abaef5cb6720b Mon Sep 17 00:00:00 2001
From: Markov <markov@uix.su>
Date: Mon, 23 Feb 2026 23:38:35 +0100
Subject: [PATCH] =?UTF-8?q?docs:=20update=20protocol=20=E2=80=94=20direct?=
 =?UTF-8?q?=20WS/REST=20access,=20remove=20BFF=20proxy=20references?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 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
---
 TRACKER-PROTOCOL.md | 25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/TRACKER-PROTOCOL.md b/TRACKER-PROTOCOL.md
index d95ff37..1dc17d9 100644
--- a/TRACKER-PROTOCOL.md
+++ b/TRACKER-PROTOCOL.md
@@ -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}` (НЕ проверяется в текущей реализации для агентов)