# AGENTS.md

> Если ты LLM, которой поручили встроить e2e-panel в проект — тебе сюда.

## Что это

e2e-panel — виджет ручного e2e-тестирования. Живёт на отдельном домене
(`e2e-panel.aipika.tech`), подключается на любой сайт кросс-доменно. Сценарии
и действия берёт с тестируемого домена из `/.e2e/tests.yaml`.

## Полный контракт встраивания

**[docs/INTEGRATION.md](docs/INTEGRATION.md)** — машинно-читаемый гайд: пути,
YAML-схема, API-контракты, CSP, примеры для Next.js/Express/nginx, чек-лист.

## TL;DR для встраивания

1. Положи `/.e2e/tests.yaml` на тестируемый домен (статика, без авторизации)
2. Добавь `<script async src="https://e2e-panel.aipika.tech/loader.js">` на страницы
3. (Опционально) Реализуй `POST /api/e2e/feedback` для очереди комментариев

## Файлы в репо

- `public/loader.js` — загрузчик (CDN Vue 3 → Shadow DOM)
- `public/widget.vue` — Vue 3 SFC, грузится на лету
- `public/tests.sample.yaml` — образец YAML
- `extension/` — Chrome-расширение (MV3)
- `docs/INTEGRATION.md` — полный контракт для встраивания
- `README.md` — документация для людей

## Деплой

```bash
node ../rsync-docker-compose/index.js root@<хост>
```
nginx:alpine + traefik → `e2e-panel.aipika.tech`.