From 7b2543aee742724592a03980909d676dfaf0497d Mon Sep 17 00:00:00 2001 From: Mikhail Putilovskij Date: Sun, 3 May 2026 00:06:16 +0300 Subject: [PATCH] docs: add local fullstack e2e instructions to new surface guide --- docs/new-surface-guide.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/new-surface-guide.md b/docs/new-surface-guide.md index d057c4e..f3b72b0 100644 --- a/docs/new-surface-guide.md +++ b/docs/new-surface-guide.md @@ -282,7 +282,19 @@ Matrix surface поддерживает staged attachments: - независимая проверка `config/-agents.yaml` - проверка, что surface запускается без локального агента -### 8.3. Проверка контрактов +### 8.3. Локальное E2E тестирование (fullstack) + +Для тестирования новой поверхности вместе с одним локальным агентом используйте паттерн `docker-compose.fullstack.yml`. +В этом режиме: +- Запускается 1 контейнер вашей поверхности +- Запускается 1 контейнер `platform-agent` +- Поднимается локальный shared volume (`surfaces-agents`) +- Поверхность настроена маршрутизировать запросы на `http://platform-agent:8000` (через `AGENT_BASE_URL`) +- Пользователь общается с ботом, а бот напрямую общается с локальным агентом, разделяя с ним общую папку для файлов. + +Это самый быстрый способ проверить интеграцию новой платформы без внешнего бэкенда. + +### 8.4. Проверка контрактов Особое внимание: