Проект — это один проверяемый сайт или приложение. Все настройки проекта лежат обычными файлами в отдельной папке: их видят инструменты разработки, их можно перенести на другой сервер простым копированием и по ним видно историю правок. Ниже — что именно лежит в папке, что хранится в базе и как завести новый проект.
Проект — это папка
Один сайт — один проект — одна папка. В папке лежит всё, что описывает ваши проверки, и ничего лишнего: файлы настроек и небольшие скрипты. Папку проектов можно скопировать на другой сервер целиком и продолжить работу там — никакого экспорта и переноса базы для этого не нужно.
| Что в папке | Зачем это |
project.yml | Название, базовый адрес сайта, описание, часовой пояс и модель ИИ-агента для этого проекта |
screen-types.yml | Типы экранов: «вход», «оплата», «кабинет» — с образцом адреса, по которому тип определяется |
rules/ | Сами проверки — по одному небольшому файлу на правило |
actions/ | Записанные и написанные агентом сценарии работы с интерфейсом |
tests/ | Тесты: последовательности шагов, которые запускаются вместе |
skills/ | Знания для агента: validator.md (что агент уже понял про ваш интерфейс) и navigation.md (как по нему ходить) |
comments/ | Замечания к экранам — обычный текст, по файлу на экран |
Все эти файлы удобно держать под контролем версий — так называют программу, которая запоминает историю изменений файлов (например, git). Тогда у каждой правки есть автор и время, а любую неудачную правку можно откатить. Изменения в историю записывает человек: сервер сам не записывает изменения в историю, чтобы в истории не появлялись служебные записи без вашего ведома.
Что хранится в базе
Часть данных живёт не в папке, а в базе продукта: снимки экранов, запуски с их шагами и результатами, проблемы, расписания и разборы замечаний. Причина простая: этого добра много, оно меняется каждый день, и хранить его в папке проекта было бы неудобно и для истории правок, и для самого продукта. Настройки и скрипты, наоборот, меняются редко и важны как документ — поэтому они в файлах.
Снимки экранов хранятся прямо в базе, а не отдельными картинками на диске. Из этого следует приятная для владельца вещь: база и папка проектов — это всё, что нужно сохранить, чтобы ничего не потерять.
Создание проекта
- Название — как проект будет называться в интерфейсе. Пишите по-человечески: «Магазин», «Личный кабинет».
- Адрес папки — из названия предлагается автоматически: строчные латинские буквы, цифры и дефисы, от 3 до 63 знаков. Именно эта папка появится на диске.
- Базовый адрес — адрес сайта, который проверяем. По нему панель в браузере сама понимает, к какому проекту относится открытая страница.
- Описание — пара слов для себя и для агента: что это за система.
- Часовой пояс — по нему считаются расписания. Если ошибиться, запуски будут приходить в неправильное время, поэтому неверное значение продукт не примет и покажет ошибку у поля.
- Модель агента — какую модель использовать для разбора замечаний именно в этом проекте. Проекты разные, и требования к модели у них тоже разные.
После создания продукт сразу заводит папку со всеми файлами, а карточка проекта появляется в списке без перезагрузки страницы.
Как менять настройки
Название, базовый адрес, часовой пояс и модель агента меняются на вкладке «Настройки проекта» в обычной форме — файлы настроек переписываются аккуратно, и неверное значение никогда не оставит файл в половинчатом состоянии. Правила, действия и тесты можно посмотреть и поправить через диалог «Файлы проекта»: если файл изменён на диске, список в интерфейсе сразу это покажет, потому что он читается из файлов, а не из памяти продукта.
Изоляция проектов
Проекты не видят друг друга: списки экранов, правила и проблемы одного проекта никогда не попадут в другой. Это важно, когда проверяете сразу несколько систем — например, клиентский сайт и внутреннюю программу.
Удаление проекта
При удалении проекта папка удаляется целиком вместе с правилами, действиями и тестами. Отменить это нельзя — восстанавливать придётся из вашей истории версий, если вы её ведёте. Если проект нужно просто приостановить, удалять его не стоит: снимите галочку с расписаний, и запусков не будет, а накопленные проверки останутся на месте.
Дальше: как установить дополнение Chrome и что в его панели — в разделе Дополнение Chrome.