# Benchmark обменов Pro → EAM → APS

Отдельный ручной прогон, без Docker, на PHP 8.6 и PostgreSQL 19. Данные создаются во временном кластере; прикладные базы не используются. Используется реальный код трёх приложений, HTTP-контракты и штатная outbox-доставка, без заглушек получателя.

[Первый контрольный прогон: результаты и ограничения](report.md).

## Локальный запуск

В соседних Pro и APS должны быть установлены зависимости из lock-файлов. Из EAM:

```sh
python3 tools/tests/run_stage5.py --benchmark --pro ../modernerp_pro --aps ../modernerp_aps
```

Если серверные PostgreSQL binaries не находятся через pg_config, задайте `POSTGRES_BIN`. Требуются Python 3.12+, PHP 8.6 с расширениями из lock-файла и непривилегированный пользователь. Предварительно выполняются миграции, тесты и 65 интеграционных проверок. Подготовка и регрессионные тесты не входят в измеряемые интервалы. Не запускайте несколько экземпляров на одном worktree: сценарий использует общие cache/log директории приложений.

Результат — `exchanges.json`; диагностические журналы трёх приложений — `var/stage5/`. При ошибке сохраняется частичный JSON с `passed: false`. Архив production для этого сценария не требуется.

## GitVerse

Workflow `.gitverse/workflows/exchange-benchmark.yaml` запускается вручную. Введите полные SHA коммитов Pro и APS; значения по умолчанию фиксируют исходную базу замеров. Linux host runner с метками `self-hosted`, `linux` должен проходить `tools/ci/preflight.sh` и иметь SSH-доступ на чтение обоих репозиториев GitVerse, с настроенными known_hosts. Ключи и токены не передаются в YAML и не включаются в результат. Скрипт клонирует зафиксированные ревизии в чистый `var/ci/`, устанавливает зависимости и публикует JSON как artifact `exchange-benchmark` даже при неудачном прогоне.

## Сценарии и смысл метрик

- ERP: 100, 1000 и 5000 записей snapshot. В каждом наборе одна организация, одна площадка, один участок и соответственно 97, 997, 4997 машин. Это учитывает существующий лимит в 5000 суммарных записей контракта. Для каждого набора EAM получает чистую проекцию: замеряются первичный preview/download по страницам и commit, три повторных импорта без изменений, затем одна новая ревизия с переименованной машиной. Проверяются число объектов, replay без дублей и единственное обновление. Throughput первичного импорта учитывает структуру вместе с оборудованием.
- APS, одиночные события: пять полных циклов подтверждения, изменения окна и отмены простоя. Для каждой фазы измеряется отдельный запуск штатной команды доставки, включая PHP/Symfony startup и HTTP ACK. После каждой доставки проверяется эффективный календарь реального APS.
- APS, массовая очередь: 100 простоев, по 100 событий на подтверждение, изменение и отмену. Измеряются время постановки через API и время разгрузки штатной командой, вычисляется событий/сек. Все простои относятся к одному явно подтверждённому ресурсу с пересекающимися окнами: это проверяет стоимость пересчёта одного календаря, а не масштабирование по множеству ресурсов.
- Недоступность APS: процесс получателя останавливается, подтверждаются ещё 100 простоев, попытка отправки сохраняет все события в pending. Повторный вызов до истечения backoff не отправляет их снова. Получатель запускается на прежнем адресе; очередь разгружается с естественной задержкой retry, без переписывания nextAttemptAt. Отдельно фиксируются время от готовности получателя до пустой очереди, время команд с успешными отправками и распределение createdAt → deliveredAt для этих событий.
- Повторная доставка: одно уже принятое APS событие повторно отправляется пять раз с исходным eventId и payload. ACK обязан содержать duplicate=true; число записей inbox не меняется. Итоговая сверка требует совпадения числа отправленных уникальных событий и inbox APS.

p50/p95/p99 считаются nearest-rank по сохранённым образцам. На трёх или пяти образцах p95/p99 часто совпадают с максимумом; это описание прогона, а не статистически устойчивая оценка хвоста.

## Границы применимости

Все HTTP-вызовы выполняются последовательно через loopback, каждое приложение обслуживается одним встроенным PHP HTTP-процессом в окружении test с debug. Это сравнительная база для последующих оптимизаций, не SLA и не оценка производительности Nginx/PHP-FPM, сети или конкретного VPS. Метрики одиночной доставки включают запуск CLI и отличаются от времени запроса APS; прямой HTTP отдельно измеряется для replay.

Проверяется отказ соединения при остановке APS. Сетевой timeout, потеря ACK после успешного commit, конкурентные worker-процессы и длительный soak-test не моделируются. Проверка replay подтверждает идемпотентность получателя, но не имитирует сетевую потерю ACK. Автоматических порогов производительности пока нет; корректность и отсутствие потерь/дублей обязательны для успешного завершения.
