docs: simplify testing section in new surface guide

This commit is contained in:
Mikhail Putilovskij 2026-05-03 00:11:01 +03:00
parent 7b2543aee7
commit 6dde5be17d

View file

@ -252,37 +252,7 @@ Matrix surface поддерживает staged attachments:
---
## 8. Тестирование и валидация
### 8.1. Юнит-тесты
В ветке есть покрытие для Matrix surface:
- `tests/adapter/matrix/test_files.py`
- `tests/adapter/matrix/test_dispatcher.py`
- `tests/adapter/matrix/test_routed_platform.py`
- `tests/adapter/matrix/test_reconciliation.py`
- `tests/adapter/matrix/test_context_commands.py`
Для Платформа создайте аналогичные тесты:
- проверка загрузки вложений
- проверка маршрутизации по `agent_id`
- проверка восстановления `platform_chat_id`
- проверка конвертации команд
### 8.2. Smoke-проверка deployment
Для Matrix surface есть `docker-compose.prod.yml` и `docker-compose.fullstack.yml`.
Для New surface должно быть достаточно:
- bot-only production deployment
- shared volume `/agents`
- независимая проверка `config/<platform>-agents.yaml`
- проверка, что surface запускается без локального агента
### 8.3. Локальное E2E тестирование (fullstack)
## 8. Локальное тестирование
Для тестирования новой поверхности вместе с одним локальным агентом используйте паттерн `docker-compose.fullstack.yml`.
В этом режиме:
@ -294,15 +264,6 @@ Matrix surface поддерживает staged attachments:
Это самый быстрый способ проверить интеграцию новой платформы без внешнего бэкенда.
### 8.4. Проверка контрактов
Особое внимание:
- `agent_registry` должен загружать `workspace_path`
- file flow должен поддерживать `workspace_path` в `Attachment`
- отправка файлов должна использовать `resolve_workspace_attachment_path()`
- `platform_chat_id` должен существовать до вызова агента
---
## 9. Реализация шаг за шагом