Surfaces_team/surfaces
4
0
Fork 0
Code Issues 5 Pull requests Projects Releases Packages Wiki Activity Actions

docs: add local fullstack e2e instructions to new surface guide

Browse source
This commit is contained in:
Mikhail Putilovskij 2026-05-03 00:06:16 +03:00
parent e7e3912b5f
commit 7b2543aee7
1 changed files with 13 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

14
docs/new-surface-guide.md
View file

@ -282,7 +282,19 @@ Matrix surface поддерживает staged attachments:
- независимая проверка `config/<platform>-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. Проверка контрактов
Особое внимание: