Документация / Инструкция по эксплуатации

QA Деск. Инструкция по эксплуатации

Версия 1.3Обновлено: 13.11.2026ООО «Эм Си Арт РУС»

1. Вход в систему

Кабинет доступен по адресу https://app.qadesk.ru. Способы входа:

  • адрес электронной почты и пароль (адрес должен быть подтверждён по ссылке из письма);
  • Яндекс ID;
  • сквозной вход с портала Битрикс24 — из установленного приложения;
  • доменная учётная запись LDAP / Active Directory — в экземпляре на своей инфраструктуре, если вход настроен администратором (раздел 4.4 документа «Установка»).

Забытый пароль восстанавливается по ссылке «Забыли пароль?» на экране входа: на почту приходит одноразовая ссылка для задания нового.

2. Рабочие пространства и участники

Пространство QA Деск объединяет участников, проекты и данные. Личное пространство создаётся при регистрации, командное пополняется приглашениями на почту; участник может состоять в нескольких пространствах. Роль участника — одна из 6: администратор, тестировщик, разработчик, менеджер, аналитик, наблюдатель.

Участники и роли в QA Деск
Администратор, QA, разработчик, менеджер, аналитик, наблюдатель; ИИ-агент — отдельный участник со своим владельцем.
  • При регистрации создаётся личное пространство. Командное пространство пополняется приглашениями: администратор отправляет приглашение на почту, приглашённый принимает его по ссылке.
  • Переключение между пространствами — переключателем в кабинете.
  • Администратор меняет роли участников и исключает их из пространства; участник может выйти сам. Роли и их права перечислены в функциональных характеристиках.
  • Пошагово по ролям — руководства по ролям: что делает с дефектом тестировщик, разработчик, менеджер и аналитик.

3. Проекты

Создайте проект и задайте буквенный ключ (например, SHOP) — дефекты проекта получат номера SHOP-1, SHOP-2… По номеру дефект находится глобальным поиском и открывается по прямой ссылке.

Рабочий стол проектов в QA Деск
Все проекты пространства на одном экране: открытые дефекты, доля пройденных проверок, идущие прогоны.

3.1. Свои поля

Если стандартной карточки мало — CVSS и CWE для аудита ИБ, объект и стойка для пусконаладки, критерий WCAG, пункт ТЗ, — заведите поле сами: «Настройки → Проект → Карточка проекта → Свои поля». Поле бывает у дефекта, у кейса и у строки прогона; тип — строка, число, список вариантов, дата или ссылка.

  • Ключ латиницей (cvss) нужен для API, фильтра и выгрузки. Ключ и тип потом не меняются; нужна другая форма — заведите новое поле.
  • Обязательное поле форма не даст оставить пустым при заведении дефекта и кейса, а в прогоне — при отметке итога строки. Отметить упавший шаг можно и без него.
  • Кто правит — право из «Участники → Права ролей»: «править свои поля дефекта» или право стандартного поля (например, «кто правит серьёзность, тот и CVSS»).
  • Значения видны в карточке и в истории, по полю-списку фильтруется список дефектов, в выгрузке CSV проекта у каждого поля своя колонка. ИИ-агент (MCP) видит поля проекта и заполняет их.
  • Удаления нет — только архив: поле пропадает из форм, значения в карточках остаются.

4. Работа с дефектами

Дефект заводится кнопкой «Завести баг» с обязательными окружением и платформой и проходит 5 основных стадий: Новый, В работе, Устранён, На повторной проверке, Закрыт. Для блокирующих и критичных дефектов обязательно вложение — снимок экрана или лог.

4.1. Заведение дефекта

  1. Нажмите «Завести баг», выберите проект.
  2. Заполните название и описание; выберите тип записи (дефект / вопрос / предложение).
  3. Обязательно укажите, где воспроизведено: окружение и платформу. Эти поля не заполняются автоматически. Если у проекта заведены свои площадки («Настройки → Проект → Карточка проекта → Площадки проекта»), вместо общего списка окружений форма предлагает их, а единственную площадку подставляет сама.
  4. Если проект типа «Железо и прошивки» и в нём заведены устройства («Настройки → Проект → Карточка проекта → Устройства проекта»), в форме появляется поле «Устройство»: выберите экземпляр — модель и серийный номер, на котором воспроизведено. Списанные экземпляры в выбор не попадают. У программных проектов поля нет.
  5. При необходимости укажите серьёзность и приоритет. Для блокирующих и критичных дефектов приложите подтверждение (снимок экрана, лог) — без вложения такой дефект не сохранится.
  6. Исполнитель: нажмите на поле — курсор встанет в поиск, а под полем откроются участники задачи Битрикс24, к которой привязан дефект (без задачи — участники проекта). Нужен кто-то другой — начните вводить ФИО, почту или должность: поиск идёт по всем сотрудникам пространства. Исполнитель назначается только выбором из списка. Так же поле работает в карточке дефекта и во вкладке «QA Деск: дефекты» задачи портала.
Карточка дефекта в QA Деск
Шаги воспроизведения, фактический и ожидаемый результат, вложения и обсуждение команды.

4.2. Стадии и переходы

Дефект движется по стадиям: Новый → В работе → Устранён → На повторной проверке → Закрыт; в любой момент возможны «Не баг» и «Отложен» по правилам воркфлоу, возврат закрытого — через «Переоткрыт». Кнопки на карточке показывают только допустимые из текущей стадии переходы; для «Не бага», «Отложен» и возвратов система запросит причину. Полная матрица переходов — в функциональных характеристиках.

Если у проекта особый процесс, ему можно назначить свою схему стадий: «Настройки → Проект → Карточка проекта → Процесс проекта». Схема создаётся копией стандартной и правится: свои стадии и подписи, переходы между ними и право, которым закрыт каждый переход. У каждой стадии есть категория (новый, в работе, ждёт внешнего, устранён, на проверке, переоткрыт, отложен, закрыт, не баг) — по ней считаются метрики, счётчики и колонки доски, поэтому свои стадии не выпадают из отчётов.

  • Схемы пространства правит администратор (право «управлять пространством»); назначить схему проекту может тот, кто управляет проектами.
  • Редактор сразу показывает ошибки: нет стадии «Закрыт» или «Не баг», выход из конечной стадии не в «Переоткрыт», стадия без пути до закрытия.
  • Если при смене схемы или удалении стадии на исчезающих стадиях есть дефекты, система попросит указать, куда их перенести, и запишет перенос в историю каждого дефекта. Стадии с тем же ключом переносятся сами.
  • Правила, которые не настраиваются: причина при переходе в «Не баг», «Отложен», «Переоткрыт»; из «Закрыт» и «Не баг» — только в «Переоткрыт».

4.3. Доска и список

  • Доска показывает открытые дефекты по стадиям; карточки переносятся между колонками перетаскиванием — перенос равносилен переходу и подчиняется тем же правилам.
  • Список — фильтры, сортировка, постраничная навигация, экспорт текущей выборки в CSV и импорт реестра из Excel/CSV (4.5).
  • Мои дефекты — всё, что назначено на вас, во всех проектах пространства. Выборку сужают выпадающие списки: проекты (можно отметить несколько), статус, тип и серьёзность; «Сбросить» возвращает всё.
  • Поиск в шапке кабинета ищет по всем проектам пространства и подсказывает совпадения по мере ввода; понимает ключи вида QAD-17.
Доска дефектов в QA Деск
Дефекты по стадиям воркфлоу: серьёзность, окружение и исполнитель на каждой карточке.

4.4. Связи, комментарии, история

  • Дубликат связывается с оригиналом; дефект связывается с тест-кейсами.
  • Комментарии и вложения — на карточке; там же полная история изменений: кто, когда и что поменял, с причинами переходов.
  • Удаление дефекта — архивирование: номер сохраняется, внешние ссылки (например, из задач Битрикс24) не ломаются.

4.5. Импорт реестра дефектов из Excel и CSV

Реестр дефектов из Excel (.xlsx) или CSV заводится в проект одним файлом: сначала проверка без записи — какой столбец куда ляжет и какие строки не пройдут, потом запись.

  1. Список → «Импорт из Excel/CSV», выберите файл. CSV — в UTF-8 или Windows-1251, разделитель «;», «,» или табуляция; шапка реестра над таблицей пропускается.
  2. Проверьте сопоставление столбцов: «Суть», «ФР», «ОР», «Критичность», «Ответственный», «Стенд» узнаются сами. Столбцы без поля — номер у клиента, дата, статус — по умолчанию попадают в описание блоком «Из реестра».
  3. Задайте значения для строк без своих: тип, окружение, платформа, задача Битрикс24.
  4. Прочтите отчёт: отказы (✕) и предупреждения (!) построчно. «Завести» заводит все строки разом; если есть отказы — только с отметкой «пропустить строки с отказом».
  • Статус из реестра в стадию не переносится: дефект встаёт на первую стадию процесса проекта.
  • Неоднозначная серьёзность («высокая», «средняя») не угадывается — поле остаётся пустым. Блокирующая и критическая без файла отклоняются или заводятся без серьёзности с пометкой.
  • Исполнитель ищется по почте или ФИО участника («Сидорук В.» тоже подходит).
  • В чат задачи Битрикс24 уходит одна запись на весь импорт со списком ключей.
  • До 1000 строк и 5 МБ за раз. Сопоставление запоминается для следующего файла того же вида.

4.6. Аналитика устранения

Раздел «Аналитика» показывает, как быстро устраняются дефекты за 30, 90, 180 или 365 дней — по проекту или по всему пространству. Всё считается из истории переходов, вводить ничего не нужно.

Аналитика устранения дефектов в QA Деск
Медиана до закрытия, возвраты с проверки, переоткрытия, приток и отток по неделям.
  • Плитки: заведено и закрыто, время до закрытия (медиана и 85 %), доля возвратов с повторной проверки, переоткрытия, доля «не баг», время реакции.
  • Приток и отток по неделям и время на стадиях: где дефекты застревают и сколько их в каждой стадии сейчас.
  • «Не баг» по причинам и время реакции — от заведения или переоткрытия до взятия в работу, по тому, кто взял.
  • Рейтинга людей по числу дефектов нет: много найденных дефектов — не плохо.

5. Тест-кейсы

Тест-кейс в QA Деск — шаги с ожидаемыми результатами и версиями: прогон ссылается на версию, по которой выполнялся. Кейс проходит 3 статуса — черновик, актуален, архив; библиотека раскладывается по папкам, импортируется из CSV и Test IT.

Библиотека тест-кейсов в QA Деск
Папки, ключи, приоритеты и теги; кейсы ставятся из каталога готовых пакетов.
  • Кейс состоит из шагов с ожидаемыми результатами. Изменения образуют версии: прогон всегда ссылается на ту версию, по которой выполнялся.
  • Статусы кейса: черновик → актуален → архив.
  • Кейсы раскладываются по дереву папок; кейс можно продублировать. Полное имя папки с путём видно при наведении, а строка «Поиск папки» над деревом оставляет только папки с набранным названием и путь к ним.
  • Предусловия папки. У папки (секции) могут быть общие предусловия для всех кейсов в ней и во вложенных — например, настройки модуля, которые проверяют перед каждым кейсом раздела. Задаются кнопкой «≡» у папки в дереве. В карточке кейса и при выполнении прогона они стоят над собственными предусловиями кейса, от верхней папки к папке кейса. Прогон запоминает их на старте: правка предусловий папки потом уже пройденный прогон не меняет.
  • Ссылка на кейс или папку. Кнопка «🔗 Ссылка» в карточке кейса и значок 🔗 у папки дерева копируют прямую ссылку. По ней коллега попадает в нужный проект — независимо от того, в каком работал до этого, — в раздел «Кейсы» с открытой карточкой или выбранной папкой. Раздел — та же папка верхнего уровня. Ссылка открывается только участникам пространства.
  • Редактор кейса открывается отдельной страницей со своим адресом: «Действие» и «Ожидаемый результат» стоят рядом, у них и у предусловий — панель форматирования (жирный, курсив, код, списки), поля растут по тексту. Шаг можно поднять, опустить или вставить после текущего. При уходе с изменённой формы — крестиком, «Отменой», Esc или кнопкой «Назад» браузера — QA Деск спрашивает: сохранить, не сохранять или остаться.
  • Карточку кейса можно растянуть за левый край до бокового меню; двойной клик по краю — во всю ширину и обратно.
  • Файлы в шаге. К действию и к ожидаемому результату шага прикрепляются свои файлы — кнопкой «📎 Файл», а скриншот можно вставить прямо в поле (Ctrl+V) или перетащить. Картинки видны в шаге картинками — в редакторе, на карточке кейса и при выполнении прогона; клик открывает просмотр с листанием по всем картинкам кейса. Число файлов видно в списке кейсов и в шапке карточки. Файлы принадлежат версии кейса: правка создаёт новую версию, а прогон по старой версии показывает её файлы.
  • Импорт: CSV по шаблону (система показывает ошибки построчно) и перенос из Test IT (выгрузка XLSX/CSV). Экспорт: CSV.

5.1. Требования и матрица покрытия

Требования проекта открываются кнопкой «📋 Требования» в карточке тест-плана или прогона. Требование — код пункта ТЗ («4.2.1», «ФТ-07»), формулировка, полный текст и источник; код уникален в проекте без учёта регистра.

Требования и покрытие в QA Деск
Дерево требований ТУ со связанными кейсами и дефектами; видно, что не проверено.
  • Требования складываются в дерево до шести уровней: раздел, в который вложить, выбирается при заведении. Архив раздела уносит в архив всё вложенное, «Вернуть» возвращает.
  • Правка текста создаёт новую редакцию — прежние видны в «Истории редакций». Связь с кейсом помнит, на какой редакции её поставили.
  • К требованию привязываются кейсы (по ключам: SRV-C1, SRV-C4) и дефекты. Дефект, заведённый из строки прогона по кейсу требования, показывается у требования сам.
  • Матрица покрытия — в двух режимах: «по этому прогону» (открыта из прогона) и «по последним итогам» каждого кейса. Итог требования — «выполнено» (все кейсы пройдены), «не выполнено», «проверка заблокирована», «не проверено» или «нет проверок»; рядом — открытые дефекты. Пропущенный кейс требование не подтверждает.
  • Импорт ТЗ. Кнопка «📥 Импорт ТЗ» заводит пункты документа заказчика требованиями: DOCX с нумерованными пунктами (номер набран текстом или нарисован автонумерацией Word), XLSX или CSV со столбцами «Номер» и «Текст». Код требования — префикс и номер пункта («ТЗ-4.2.1»), дерево — по номерам, абзацы без номера относятся к пункту выше. Перед записью QA Деск показывает план: какие пункты новые, какие изменились (было/стало), какие сняты. Новая редакция документа загружается с тем же префиксом и тегом: изменённый пункт получает новую редакцию требования, его кейсы — отметку «⟳ к пересмотру», снятые пункты уходят в архив. Запись идёт целиком или не идёт: если код пункта занят требованием, заведённым вручную, импорт предложит сменить префикс или тег.
  • Черновики кейсов. Когда в пространстве подключён ИИ-помощник, кнопка «✨ Черновики кейсов» готовит по одному кейсу на каждое требование без кейсов в текущем фильтре по тегу — по тексту пункта; разделы пропускаются. Кейс привязывается к требованию и приходит черновиком с пометкой «Черновик ИИ по требованию …» в истории: в план и прогон он попадёт после того, как специалист проверит его и переведёт в актуальные.
  • Читать требования может любой участник проекта, менять — участник с правом на запись кейсов.

6. Тест-планы и прогоны

Ручной прогон в QA Деск запускается из тест-плана, собранного из кейсов библиотеки. Результат ставится по каждому шагу — пройден, упал, пропущен; из упавшего шага дефект заводится со связью с кейсом и прогоном.

Прогоны в QA Деск
Стабильность, покрытие и возвраты; ручные регрессы и прогоны из CI рядом.
  1. Соберите план из кейсов библиотеки — из раздела «Планы» или прямо из «Кейсов»: отметьте кейсы или папки (вложенные тоже попадут) и нажмите «Создать план из выбранного»; без отметок план соберётся из текущей папки. Черновики и архивные кейсы в план не попадают.
  2. Запустите прогон. На экране прогона отмечайте результат каждого шага: пройден, упал, пропущен.
  3. Из упавшего шага заводится дефект — связь с кейсом и прогоном устанавливается автоматически. Открывается та же полная форма, что при обычном заведении: шаги воспроизведения, ожидаемый результат, окружение и устройство уже заполнены из кейса и прогона, их можно поправить, а исполнителя и задачу Битрикс24 — выбрать сразу.
  4. Сводка прогона показывает метрики: сколько пройдено, упало, пропущено.

6.1. Устройства: модели и экземпляры

Тип проекта. При создании и в «Карточке проекта» выбирается тип: «Программный продукт» (по умолчанию — 1С, API, десктоп), «Битрикс24», «Веб-сервис», «Мобильное приложение», «ИИ-модель», «Железо и прошивки» или «Производство (ОТК)». У каждого типа свой значок — он стоит на рабочем столе, в переключателе проектов и в шапке. Пакет из каталога сам ставит свой тип проекту, у которого тип ещё не выбирали: установили «Битрикс24: смоук» — проект стал «Битрикс24». Тип, выбранный руками, пакет не меняет. Тип задаёт и разделы проекта по умолчанию: у «Железа и прошивок» включены все шесть — устройства, стек версий, испытания на стенде, логи железа во вложениях, средства измерений и несоответствия (NCR), у «Производства (ОТК)» — изделия, средства измерений и несоответствия, у остальных типов разделов нет. Дальше разделы включаются руками: «Настройки → Проект → Карточка проекта → Разделы проекта». Стек версий пригодится веб-проекту для нагрузки и учений по восстановлению, приборы — пусконаладке; менять ради этого тип не нужно. Несоответствия работают только вместе с устройствами — форма включит их сама. Выбор другого типа в карточке сразу показывает его разделы, их можно поправить до сохранения. Установка пакета из каталога, сменившая тип, разделы только добавляет. Выключение раздела и смена типа ничего не удаляют — справочник и история остаются, закрывается только новая запись; включили обратно — всё на месте.

Прогоны испытаний оборудования в QA Деск
Экземпляр устройства, снапшот версий прошивочного стека и партия на каждом прогоне.

Производство (ОТК). Тип для швейного производства, металлоконструкций и серийной продукции. Справочник тот же, что у железа, но говорит языком ОТК: «Изделия проекта» вместо «Устройств», модель изделия (производитель — свой цех или подрядчик, модель или артикул, ревизия КД) и изделие с заводским номером. В формах дефекта и прогона поле называется «Изделие», в протоколе испытаний — «Заводской номер» и «Контролёр ОТК», в ПМИ — «Модели изделий». Партия, несоответствия и средства измерений работают так же, как у железа.

Для испытаний железа у проекта есть справочник устройств: модель (вендор, модель, ревизия платы) и экземпляр с серийным и инвентарным номером и состоянием — в работе, в ремонте, списан. Экземпляр — объект испытаний: «не воспроизводится на втором образце» становится фактом, а не фразой.

  • Справочник ведёт тот, у кого есть право управлять проектами: «Настройки → Проект → Карточка проекта → Устройства проекта». Ничего не удаляется — модель уходит в архив, экземпляр списывается; история остаётся.
  • При запуске прогона выберите «Устройство (экземпляр)» — прогон привязывается к нему, а дефект из упавшего шага наследует экземпляр сам.
  • Карточка экземпляра (клик по нему в справочнике) показывает прогоны и дефекты на этой железке.
  • Серийный номер уникален в проекте без учёта регистра; экземпляр другого проекта к дефекту или прогону не привязать.

6.2. Приёмочные испытания (ПСИ по ГОСТ Р 59795-2021)

Программа, протокол и акт приёмки внедрения — прямо из деска, без сборки трёх документов в Word. При создании тест-плана выберите режим «ПСИ» и заполните разделы программы по ГОСТ Р 59795-2021: объект, цель, общие положения, объём, условия, порядок, материально-техническое и метрологическое обеспечение, отчётность. Пустой раздел QA Деск заполнит сам — числом проверок, пунктами ТЗ, компонентами стека, средствами измерений, маршрутом подписания.

Приёмочные испытания (ПСИ) в QA Деск
Прогон по программе ПСИ с комиссией заказчика; замечания со сроками устранения.
  • Программа фиксируется на старте. Прогон от плана ПСИ снимает разделы программы; правка плана после старта испытания задним числом не переписывает. Кнопка «📄 ПМИ» у плана — программа и методика приёмочных испытаний.
  • Замечание — это дефект. В карточке прогона блок «ПСИ: замечания и акт»: отметьте дефект строки (или замечание заказчика по ключу) и срок устранения. Не пройденная проверка без замечания видна сразу — с ней систему принять нельзя.
  • Решение — правилом: «принимается», «принимается с замечаниями», «не принимается» (есть отказ без замечания) или «испытания не завершены».
  • Подписание — по маршруту проекта. Кнопка «Маршрут ПСИ» в карточке проекта заготавливает этапы «Исполнитель → Руководитель проекта → Представитель заказчика». Этап заказчика отмечен как внешняя сторона: его подписывает ваш сотрудник за представителя — с ФИО, должностью и сканом подписи на бумаге (PDF, JPEG или PNG до 8 МБ).
  • После первой подписи перечень замечаний и сроки не меняются — они часть подписанного акта.
  • Акт закрывается, когда каждое замечание устранено (дефект закрыт), перенесено в опытную эксплуатацию или снято комиссией. Переносит и снимает член комиссии — участник маршрута подписания, с обоснованием. «📄 Акт приёмки» — документ DOCX; «🖨» — для печати в PDF.
  • Готовые проверки для Битрикс24. В каталоге пакетов — «Битрикс24: приёмочные испытания (ПСИ) внедрения»: 41 проверка коробки или облака в порядке программы — условия испытаний, оргструктура и права, CRM и перенос данных, задачи, бизнес-процессы, интеграции, резервное копирование и восстановление, производительность, итоги. Установите пакет в проект, в план ПСИ включите только подсистемы из ТЗ, а пункты ТЗ свяжите с кейсами — программа получит матрицу трассировки.

6.3. Замеры и средства измерений

Шаг кейса становится измерением, если заполнить у него «Допуск измерения» одной строкой: ≤ 85 °C, ≥ 900 МБ/с, 12 ± 0.5 В, 180…220 Вт. При исполнении в шаг вводится число, вердикт «пройден» или «провален» считает система.

Измерения с допуском и тренд в QA Деск
Числовой результат, прибор с поверкой и тренд по версиям прошивки: выход за допуск виден сразу.
  • Единица — только подпись: система сравнивает число с числом и ничего не пересчитывает.
  • В карточке кейса — раздел «Измерения по прогонам»: тренд с полосой допуска, клик по точке открывает прогон.
  • Справочник приборов — раздел «Средства измерений» в левом меню: тип, модель, серийный номер, свидетельство и даты поверки. Плитки показывают, у каких приборов поверка истекает в ближайшие 30 дней или уже истекла, график — у скольких приборов срок кончается в каждом из 12 месяцев. В карточке прибора вносится новая поверка и идёт сверка с ФГИС «Аршин»; список выгружается в CSV.
  • К числу на шаге указывается прибор — «чем снято число». В прогоне сохраняется снимок прибора с состоянием поверки на момент замера.

Размерная сетка. Если допуск зависит от размера, роста или типоразмера, вместо одного допуска задайте сетку: сетка см: 48-50/170 = 74 ± 1; 52-54/176 = 78 ± 1. Строки разделяются точкой с запятой или переводом строки; три столбца из Excel (исполнение, номинал, допуск) тоже подходят. Один кейс закрывает всю сетку.

  • Исполнение указывается при старте прогона — поле «Исполнение (размер/рост)» для партии одного размера — или у изделия в справочнике. Исполнение прогона важнее исполнения изделия.
  • Число сравнивается со строкой своего исполнения. Если исполнение не указано или его нет в сетке, запись не проходит — система называет исполнения, которые есть в сетке.
  • В протоколе испытаний — строка «Исполнение (размер/рост)» и допуск своей строки у каждого замера.

6.4. Партия: один план на несколько экземпляров

Для серийных и приёмо-сдаточных испытаний в диалоге «Новый прогон» отметьте в блоке «Партия» от 2 до 50 экземпляров. Система создаёт по прогону на каждый экземпляр с одинаковым составом кейсов и открывает сводку партии: сколько годных и на каких шагах отказы.

  • Список партий — кнопка «📦 Партии» на экране прогонов; метка «📦 партия» у прогона ведёт в сводку.
  • Списанные экземпляры в партию не предлагаются.
Сводка партии в QA Деск: выход годных, Парето отказов по шагам, несоответствия
Один план на партию изделий: вердикт по каждому, отказы по шагам в порядке убывания, несоответствия.

6.5. Подписи прогона

Маршрут подписания задаётся в карточке проекта, блок «Маршрут подписания»: до шести этапов, например «Исполнитель → ОТК → Представитель заказчика», и у каждого этапа — поимённо те, кто вправе его подписать. Настраивает маршрут участник с правом управления проектом.

Протокол испытаний с подписями в QA Деск
Маршрут подписания по ролям; подписанный результат нельзя изменить задним числом.
  • В карточке прогона кнопка «✍ Подписать как «этап»» видна тому, кто назван в следующем по порядку этапе. Агент не подписывает.
  • Подпись фиксирует SHA-256 содержимого прогона. Подписанный прогон изменить нельзя — это запрещает база данных; если содержимое всё же разошлось с подписью, прогон и протокол помечаются «подпись нарушена».
  • Подпись не отзывается: ошибка в подписанном результате исправляется новым прогоном или отступлением (6.6).

6.6. Отступления от ПМИ и несоответствия

Если на стенде шаг приходится выполнить иначе, чем написано, кнопка «✎ Отступление» у шага прогона фиксирует, что меняется — действие, ожидаемый результат или допуск — и обоснование. Версия кейса при этом не меняется.

Несоответствие по изделию в QA Деск
Несоответствие по экземпляру со вложением; решение — ремонт, допуск с отклонением, брак или возврат.
  • Отступление утверждает или отклоняет участник маршрута подписания, не автор. Оно видно на прогоне и в протоколе испытаний.
  • Утверждённое отступление можно перенести в кейс — появится новая версия кейса.
  • Отказ экземпляра заводится как «Несоответствие» (NCR) — вид записи в проектах с устройствами. Экземпляр обязателен; закрыть NCR можно только после решения по изделию: ремонт, допустить с отклонением, забраковать или вернуть поставщику. Решение меняет состояние экземпляра. У несоответствия без экземпляра решения другие: в лаборатории и водоканале — подтверждено повторным отбором, закрыто мерой CAPA или результат аннулирован; по мере ИБ — мера устранена или риск принят.

6.7. Регулярные проверки по расписанию

Учения по восстановлению, проверки резервных копий и другой периодический контроль задаются расписанием у тест-плана: блок «Регулярная проверка» в карточке плана, кнопка «Задать расписание». Период — в днях, неделях, календарных месяцах или кварталах.

  • Срок следующей проверки считается от последнего завершённого прогона плана; прерванный прогон проверкой не считается.
  • За заданное число дней до срока система сама создаёт прогон на ответственного и показывает «пора проверять»; после срока — «проверка просрочена» на плитке рабочего стола.
  • Проверку может прислать и скрипт — через qadesk-cli upload --plan со ссылкой на план (7.1).
  • Настраивает расписание участник с правом на запись планов.

6.8. Выборочный контроль по AQL

Приёмка партии по выборке — по ГОСТ Р ИСО 2859-1, одноступенчатый план, нормальный контроль. Раздел «Выборочный контроль (AQL)» включён у проектов типа «Производство (ОТК)», у остальных включается в карточке проекта. В карточке идущего прогона, блок «🎯 Выборочный контроль (AQL)»:

  1. Укажите объём партии и уровень контроля (по умолчанию общий II).
  2. Для каждого класса дефектов — критических, значительных, малозначительных — выберите AQL или «не контролируется». Код, объём выборки и приёмочное/браковочное числа (Ac/Re) видны сразу, до сохранения; после «Задать план» их фиксирует сервер.
  3. По ходу контроля вносите по каждому классу, сколько единиц проверено и сколько из них дефектных.
  • Класс бракуется, как только дефектных стало Re, — даже если выборка ещё не досмотрена. Принимается — только когда выборка проверена полностью и дефектных не больше Ac. Неполная выборка без брака — «контроль не завершён», а не приёмка.
  • Партия бракуется, если бракуется любой класс, и принимается, только если приняты все.
  • Если по таблице объём выборки не меньше партии, контролируется каждая единица (сплошной контроль).
  • План меняется или снимается, пока по нему ничего не внесено; после подписи прогона выборка заморожена.
  • В протоколе испытаний — раздел «Выборочный контроль партии» и решение по партии в заключении.
  • Пока не поддерживаются усиленный и ослабленный контроль и AQL выше 10.

6.9. Входной контроль: поставщики и партии материалов

Раздел «Входной контроль» включён у проектов типа «Производство (ОТК)», у остальных включается в карточке проекта. В карточке проекта, блок «Входной контроль»:

  1. Добавьте поставщика — название и, при желании, ИНН.
  2. Заведите партию материала: поставщик, материал, номер партии, рулона или плавки, дата прихода, количество, номер документа о качестве.
  3. Назначьте партии прогон входного контроля — обычный или с выборкой по AQL (раздел 6.8).
  • Вердикт партии считает сервер по этому прогону, руками он не ставится: все строки пройдены и выборка принята — «принята»; провал строки или брак выборки — «отклонена», сразу, не дожидаясь конца прогона; пропуски, прерванный прогон, недосчитанная выборка — «контроль не завершён».
  • В карточке прогона-партии изделий блок «🧵 Материалы»: отметьте, из каких партий материалов она сделана, — там же виден риск цепочки: всё принято, есть непроверенное или есть отклонённый материал.
  • У партии материала видно, куда она ушла; у поставщика — сколько партий принято и отклонено.
  • Склад, остатки и списание остаются в учётной системе (1С, SAP).

6.10. Партия продукции и паспорт качества

Раздел «Партии продукции» включён у проектов типа «Производство (ОТК)», у остальных включается в карточке проекта. Прогон, которым проверяют готовую продукцию, называет, какую партию он проверял, — в карточке прогона, блок «🛢 Партия продукции»:

  1. Укажите номер партии и продукцию.
  2. Укажите количество и единицу: шт, м³, кг, т или л. У газа, химии и пищевой продукции партия — это объём или масса: резервуар, цистерна, рампа наполнения.
  3. При необходимости — нормативный документ (ГОСТ, ТУ, марка, сорт), ёмкость или тару, число единиц тары (баллонов) и дату изготовления.
  • Номер партии уникален в проекте без учёта регистра: «П-0931» и «п-0931» — одна партия.
  • Если у прогона есть выборочный контроль (6.8), число единиц тары должно совпадать с объёмом партии в плане выборки — выборку берут из этих баллонов.
  • Партию можно вписать и после анализа; после подписи прогона она не меняется.
  • Кнопка «📄 Паспорт качества» выпускает паспорт партии: продукция, НД, количество, таблица показателей «норма — фактически — вердикт» по измерительным шагам прогона (6.3), решение выборочного контроля, заключение и подписи.
  • Заключение ставит система, руками оно не пишется: показатель вне нормы — «не соответствует», сразу; «соответствует» — только когда прогон завершён и все показатели измерены в норме поверенными приборами; иначе — «не определено». Показатель, снятый прибором с истёкшей поверкой, даёт «не определено».
  • Сорт партии. Итог приёмки газа или зерна — не только «годен / не годен», а сорт или класс по стандарту на продукт. В карточке проекта, блок «Шкалы сортов», шкала вводится текстом: первая строка «Сорта: первый | второй» (от лучшего к худшему), дальше по строке на показатель — «Объёмная доля кислорода, %: ≥ 99,7 | ≥ 99,5» (нормы технического кислорода по таблице 1 ГОСТ 5583-78; для своей продукции берите нормы из действующей редакции стандарта или ТУ). Граница — «≥ a», «≤ b», «a–b» (включительно) или «-» без ограничения; ошибку кабинет показывает до сохранения и называет строку. Шкала выбирается у партии.
  • Сорт показателя — лучший сорт, в границы которого попал замер; сорт партии — худший из сортов показателей. Показатель шкалы — измерительный шаг прогона с тем же названием и единицей. Замер вне границ всех сортов — «вне сортов», паспорт «не соответствует» (даже если шаг в своём допуске); показатель не измерен, единица другая или поверка прибора истекла — сорт «не определён».
  • В паспорте — раздел «Сорт партии» и сорт в заключении. Шкалу, которая стоит у партии, удалить нельзя; шкала, по которой сортирована партия подписанного прогона, не меняется — новые границы вводятся новой шкалой.
  • В протоколе испытаний партия указана в разделе «Объект и условия испытаний».
  • Склад, остатки и отгрузки остаются в учётной системе.
  • Изделия партии по маркировке. Если продукция штучная и маркируется — рельсы, балки, единицы проката, — в блоке «🏷 Изделия партии по маркировке» под партией ведётся список изделий. Кнопка «Вставить таблицей» принимает таблицу из Excel или выгрузки L2 (до 5000 строк за раз): первая строка — заголовок; колонка «Маркировка» (иначе первая) — строка маркировки, колонка «Плавка» — номер плавки, остальные колонки — реквизиты маркировки под своими заголовками (категория, способ упрочнения, год и месяц — состав задаёт ваша НТД).
  • Маркировка уникальна в проекте без учёта регистра. Если в таблице есть маркировки, которые уже заведены, не добавляется ни одна строка, а система называет повторы. После подписи прогона состав партии не меняется.
  • Поле «Найти в проекте» ищет по началу маркировки или по номеру плавки во всех партиях проекта. Карточка изделия показывает путь: партию и прогон её контроля (подписан ли), сколько изделий той же плавки и в каких партиях, несоответствия и дефекты прогона партии — так рельс, найденный в пути, сводится к плавке и к результатам приёмочного контроля.

6.11. Оборотная тара: бутыли 19 л

Раздел «Оборотная тара» включается в карточке проекта вместе с разделом «Партии продукции». Учёт ведётся по партии тары — одной поставке бутылей: номер партии, материал (ПЭТ, поликарбонат, стекло), объём, дата ввода в оборот, сколько бутылей введено и пределы — по числу оборотов и по сроку в месяцах. Пределы задаёт завод по документам изготовителя тары.

  • Отбраковка. В блоке «♻ Оборотная тара» карточки проекта кнопка «Отбраковать» записывает число бутылей и причину: посторонний запах, царапины, трещина, деформация, налёт, посторонние предметы, неотмываемая маркировка, предел по оборотам или сроку. Отбраковать больше, чем введено, нельзя. Причины собираются в Парето — что даёт основную долю брака.
  • Розлив. В карточке прогона партии воды блок «♻ Розлив по партиям тары»: сколько бутылей из какой партии тары налито. Налить больше бутылей, чем партия держит в обороте, нельзя; после подписи прогона розлив не меняется.
  • Состояние партии тары. В обороте — введено минус отбраковано. Средний оборот — сколько раз в среднем налита каждая бутыль. С 90 % любого из пределов партия «на подходе к пределу», со 100 % — «предел превышен»: такую партию выводят из оборота, и новый розлив из неё не принимается.
  • Мойку бутылей ведут прогоном плана с измерительными шагами (температура раствора, остаток моющего средства — 6.3); отбраковку можно связать с этим прогоном.
  • Логистика доставки, клиенты и залоги за тару остаются в учётной системе.

6.12. Источник воды: скважина или родник

Раздел «Источники воды» включается в карточке проекта вместе с разделами «Устройства» и «Партии продукции». Источник — экземпляр устройства (номер скважины или название родника): анализы воды, осмотры зоны санитарной охраны и замеры уровней ведутся обычными прогонами плана на этом экземпляре, сроки — периодическими проверками в карточке экземпляра.

  • Паспорт источника. В блоке «💧 Источники воды» карточки проекта: вид (скважина или родник), водоносный горизонт, радиусы трёх поясов зоны санитарной охраны, утверждённый дебит, статический и динамический уровень. Пояса не убывают от первого к третьему, динамический уровень не выше статического, у родника уровней нет — несогласованный паспорт не сохраняется.
  • Источник у партии воды. В карточке прогона партии блок «💧 Источник воды партии»: из каких источников вода партии — один или несколько. Источник в ремонте или списанный к новой партии не добавить; после подписи прогона источники партии не меняются.
  • Состояние и партии под вопросом. Последний анализ вне нормы или открытое несоответствие на источнике — состояние «отклонение». Под вопросом все партии из источника, сделанные в день последнего хорошего анализа до начала отклонения или позже: их список виден в строке источника.
  • Протокол подрядной лаборатории. В карточке прогона на источнике — дата отбора пробы, лаборатория и номер протокола. Анализы прошлых лет, внесённые сегодня, встают на свои даты: по дате отбора считаются состояние источника, партии под вопросом и тренд. Дата отбора не может быть позже завершения прогона.
  • Тренд показателей. Кнопка «Тренд» показывает значения показателей анализа по годам — только по этому источнику; значения вне нормы выделены.
  • Учёт недропользования и гидрогеологическая отчётность остаются вне QA Деск.

6.13. Электроустановки: объект, узлы и сроки испытаний

Раздел «Электроустановки» включается в карточке проекта вместе с разделом «Устройства». Объект заказчика (здание, подстанция, площадка) — экземпляр устройства в корне дерева: щиты, распределительные устройства, линии и аппараты — его «Состав изделия», вид испытания и интервал у каждого узла — периодические проверки в карточке экземпляра. Испытание узла — обычный прогон плана на нём с замерами, приборами и подписями.

  • Паспорт объекта. В блоке «⚡ Электроустановки» карточки проекта: заказчик, адрес, вид объекта и номинальное напряжение. Объектом может быть только корень дерева: экземпляр, стоящий в составе другого, объектом не станет, а объект нельзя поставить узлом в другой экземпляр.
  • Что не испытано в срок. Состояние объекта — худшее по срокам всех его узлов: «есть просрочка», «пора испытывать», «в срок» или «сроков нет». Таблица заказчиков сводит объекты одного заказчика (регистр и пробелы в названии не делят его на два) и показывает, у скольких объектов есть просрочка.
  • Карточка объекта. Дерево узлов с позициями по схеме, у каждого узла — испытания, сроки и дата последнего испытания.
  • Протокол за выезд. В карточке объекта — период выезда и кнопка «Протокол (DOCX)» или печать. В протокол попадают завершённые испытания узлов объекта за эти дни (по московскому времени): замеры с нормой, прибором и поверкой, подписи, отдельным разделом — что не испытано в срок на дату протокола. Заключение: хоть один замер вне нормы — «не соответствует»; замер прибором с истёкшей поверкой — «не определено»; испытаний за период нет — «не определено».
  • Готовый набор испытаний электроустановок до 1 кВ (изоляция, металлосвязь, заземление, петля «фаза — нуль», автоматы, УЗО) есть в каталоге пакетов; нормы перед первым прогоном сверяются с действующими редакциями документов.
  • Проектная документация и однолинейные схемы прикладываются вложениями; расчёта токов короткого замыкания в QA Деск нет.

6.14. Формы и гнёзда: ресурс, заглушки, брак по гнезду

Раздел «Формы и гнёзда» включается в карточке проекта. Форма — объект учёта: номер (на донышке или в маркировке изделия), вид (литьевая, выдувная, форма преформ, стеклоформа секции, пресс-форма), машина и секция, изделие, число гнёзд, счётчик циклов и ресурсы — до профилактики и до списания. Ресурсы задаёт предприятие по документам изготовителя формы.

  • Журнал формы. В блоке «⚙ Формы и гнёзда» кнопка «Журнал»: показание счётчика, профилактика, ремонт, полировка. Счётчик только растёт — показание меньше текущего не принимается; профилактика обнуляет наработку. Записи журнала задним числом не правятся.
  • Состояние. С 90 % любого ресурса — «на подходе», со 100 % — «просрочена» или «выработан»; показывается худшее. После ремонта или полировки у формы пометка «перепроверить», пока с этой формы не пройдёт и не завершится новая выборка.
  • Заглушённые гнёзда. Кнопка «Гнёзда» показывает сводку: выборки, упавшие шаги и несоответствия по каждому гнезду, худшее — первым. Гнездо заглушают с причиной; с заглушённого гнезда новую выборку не берут.
  • Выборка прогона. В карточке прогона блок «⚙ Форма и гнездо выборки»: с какой формы и какого гнезда взяты изделия. Все замеры прогона — по этому гнезду; в карточке кейса тренд и контрольная карта строятся и по одному гнезду. После подписи прогона форма и гнездо не меняются.
  • Несоответствие. Несоответствие из упавшей строки такого прогона получает форму и гнездо само. Претензию розлива «по номеру формы» заводят несоответствием и в его карточке выбирают форму и гнездо.
  • ТОиР машин и график ремонтов форм — в системе ТОиР; счётчик из АСУ ТП вносится показанием в журнал.

6.15. Энергоменеджмент: показатели против базовой линии

Раздел «Энергоменеджмент» включается в карточке проекта. Показатель — удельный расход значимого потребителя (компрессорная, сушилка, печь) с единицами энергии и выпуска, моделью базовой линии, базовым периодом и целью снижения. Показатель сравнивается не с прошлым годом, а с ожидаемым расходом — моделью базового периода при фактическом выпуске и погоде.

  • Модель. Удельный расход (энергия ÷ выпуск) или линейная модель от выпуска и, по желанию, градусо-суток: постоянная часть отделяется от зависящей от выпуска. Качество модели — R², CV(RMSE), NMBE; критерии годности задаёт организация.
  • Показания. В карточке показателя кнопка «Анализ»: вставьте строки из Excel — период (месяц ГГГГ-ММ или две даты), энергия, выпуск, градусо-сутки. То же начало периода заменяет показание; пересекающиеся периоды не принимаются, и пачка не записывается целиком.
  • Анализ. По каждому периоду — ожидаемый расход, индекс факт ÷ ожидаемое (меньше 1 — экономия) и накопленное отклонение (CUSUM); график «факт / ожидаемое» с затенённым базовым периодом; итог против цели.
  • Мероприятия. Название, дата внедрения и ожидаемая экономия, при необходимости — связь с CAPA. Эффект сравнивает средний индекс до и после внедрения: «эффект подтверждён», «не подтверждён» или «ждёт данных».
  • Приём показаний из АСКУЭ по расписанию и учёт тарифов — в системе учёта энергоресурсов.

6.16. Экологический менеджмент: аспекты и обязательства

Раздел «Экологический менеджмент» включается в карточке проекта. В нём два реестра — экологические аспекты и обязательства соответствия.

  • Порог значимости. Балл тяжесть × вероятность (1–25), с которого аспект значим. Порог задаёт организация; без порога значимость по баллу «не определена».
  • Аспекты. Код, деятельность, аспект, воздействие, режим (нормальный, нештатный, аварийный), тяжесть и вероятность 1–5. Решение «значимый» или «незначимый» важнее балла и принимается только с обоснованием.
  • Обязательства. Кнопка «+ Обязательство из требования»: требование проекта получает вид (закон, разрешение, договор, добровольное), документ и срок действия. Срок — «действует», «истекает» (90 дней и меньше), «истекло»; контроль — из реестра мер: последняя проверка, просрочка, открытые несоответствия.
  • Связи. Кнопка «Обязательства» в строке аспекта: отметьте обязательства, которые его регулируют.
  • Экологическая отчётность и расчёт платы за негативное воздействие — в специализированных системах.

6.17. Лифты: паспорт, сроки, остановка по замечанию, отчёт владельцу

Раздел «Лифты» включается в карточке проекта вместе с «Устройствами». Лифт — экземпляр с паспортом: заводской номер, владелец, адрес и подъезд, регистрационный номер, вид, грузоподъёмность, остановки, дата ввода и назначенный срок службы.

  • Парк. Блок «Лифты»: счётчики, свёртка по владельцам, список с отметкой «остановлен», сроками осмотров и сроком службы. Фильтр «только остановленные» и по владельцу.
  • Сроки. Ежемесячный осмотр, обслуживание и освидетельствование — «Периодические проверки» лифта. Состояние — худшее по лифту и его узлам.
  • Остановка. Замечание, при котором эксплуатация запрещена, — несоответствие на лифте или узле: лифт уходит на карантин и показан остановленным с причиной. Пуск — снятие карантина решением подписанта.
  • Срок службы. За 365 дней до окончания назначенного срока — «пора обследовать», с дня окончания — «срок службы истёк».
  • Загрузка парка. «Загрузить парк из Excel»: вставьте строки — заводской номер, изготовитель, модель, владелец, адрес, подъезд, рег. номер, вид, грузоподъёмность, остановки, дата ввода, срок службы. Ошибка в одной строке — не загружается ничего.
  • Отчёт владельцу. Выберите владельца в свёртке — появится «Отчёт владельцу» за период (DOCX или печать): работы, остановки с причиной и простоем, неисправности и заявки со временем устранения, не обслужено в срок.
  • Регистрация в реестре лифтов и диспетчеризация — вне QA Деск.

6.18. Объекты и зоны: дерево объекта, службы, «что не готово»

Раздел «Объекты и зоны» включается в карточке проекта вместе с «Устройствами». Объект (арена, здание, торговый центр) — корневой экземпляр; трибуны, этажи, секторы, помещения, входные группы и системы — его состав.

  • Карточка зоны. Кнопка «Карточка» у узла: вид, название, вместимость, ответственная служба, у зоны — арендатор, у объекта — адрес и владелец. Служба, не заданная у узла, берётся от узла выше.
  • Состояние. Просроченная проверка или блокирующее замечание — «не готово»; подходящий срок или открытое замечание — «требует внимания»; без проверок — «нет проверок», а не «готово».
  • Что не готово. В карточке объекта — сводка по службам и дерево узлов со сроками и замечаниями; вместимость объекта без двойного счёта трибун и секторов.
  • По веткам дерева. В карточке объекта выберите уровень: 1 — горизонты, корпуса, трибуны; 2 — участки, этажи, секторы. По ветке — «не готово», последняя выполненная проверка и ближайший срок: видно, где давно не проверяли.
  • Загрузка дерева. «Загрузить дерево из Excel»: путь от объекта через «/» (здание / корпус / этаж / помещение), вид, вместимость, служба, арендатор. Новые узлы заводятся сами, «Этаж 2» разных корпусов — разные узлы; ошибка в одной строке — не загружается ничего.
  • Поэтажные планы и схемы арены — вложениями; СКУД и BIM — вне QA Деск.

6.19. Автоматический контроль выбросов: сверка канала с лабораторией

Раздел «Автоматический контроль выбросов» включается в карточке проекта вместе с «Устройствами». Канал — источник выбросов (труба, газоход) или станция контроля воздуха; номер канала — номер экземпляра, экземпляр заводится сам, если его ещё нет.

  • Канал. Вещество и единица, средство измерений из реестра приборов проекта с датой окончания поверки, интервал сверки с лабораторией и допустимое расхождение — абсолютное, в процентах от результата лаборатории или оба (допустимо большее). Допуски берутся из регламента организации.
  • Сверка. Кнопка «Карточка» у канала: дата, показание канала, результат лаборатории и номер протокола. Вердикт «в допуске» или «вне допуска» считается по допуску на момент сверки — смена допуска прошлые вердикты не переписывает. Граница включена.
  • Вне допуска. Несоответствие заводится сразу на экземпляре канала (нужен раздел «Несоответствия (NCR)»), канал встаёт на карантин до решения: его данные под вопросом. Без раздела NCR сверка помечается «без NCR», кнопка «Завести NCR» — после включения раздела.
  • Отказы. Начало, конец или «длится», причина; отказ тоже заводит несоответствие. «Канал восстановлен» закрывает длящийся отказ. Доступность данных — доля времени без отказов за последние 30 суток.
  • Реестр. Сначала просроченные сверки, затем каналы вне допуска и с длящимся отказом; сводка — каналы на карантине, с истекшей поверкой средства измерений, средняя доступность данных.
  • Передача данных в государственные системы и расчёт валовых выбросов — вне QA Деск; показания с систем автоматического контроля — вручную или выгрузкой.

6.20. Геотехнический мониторинг оснований

Раздел «Геотехнический мониторинг» включается в карточке проекта вместе с «Устройствами». Объект — здание, резервуар, фундамент оборудования или опора трубопровода; точки наблюдения — термометрические скважины, осадочные марки, датчики крена, маяки на трещинах — его состав.

  • Объект. Номер, название, вид, площадка, ответственный за предписания и срок предписания в днях. Если к пространству привязан портал Битрикс24, площадка выбирается из подразделений его структуры; без портала — вводится названием.
  • Точка. Кнопка «Карточка» у объекта, затем «+ Точка»: номер, глубина или место, единица, направление «хуже» (выше — потепление грунта, осадка, крен; ниже), пороги «предупреждение» и «авария», интервал замера.
  • Замеры. Вставьте строки из Excel: номер точки, дата, значение. Та же дата у точки заменяет замер; ошибка в одной строке — не загружается ничего. По точке — последний замер с уровнем, скорость за 30 суток, срок следующего замера; «Тренд» — график с линиями порогов.
  • Предписание. Замер на пороге «авария» заводит предписание: ответственный объекта, срок — дата замера плюс срок предписания, и несоответствие на точке (нужен раздел NCR, иначе — кнопка «Завести NCR»). Повторный замер виден у предписания; закрывает его решение по несоответствию.
  • Сводка. Объект «предписание», «наблюдение» (выше нормы или замер просрочен), «нет данных» или «в норме»; по площадкам — сколько объектов в каждом состоянии.
  • Расчёт несущей способности и прогноз — у проектировщика; данные термокос и инклинометров — вставкой или через шлюз.

6.21. Тиражирование решения на площадки

Раздел «Тиражирование решения на площадки» включается в карточке проекта. Эталон — план в режиме «ПСИ» (программа приёмочных испытаний по ГОСТ Р 59795, § 6.2) с требованиями; приёмка на каждой площадке — прогон ПСИ этого плана.

  • Тиражирование. «+ Тиражирование»: название и эталонный план; на один план — одно тиражирование.
  • Площадки. Если к пространству привязан портал Битрикс24, площадки выбираются из подразделений его структуры (можно несколько сразу); без портала — вписываются по одной в строке. Повтор не принимается.
  • Приёмка. «Начать приёмку» у площадки запускает прогон ПСИ эталона со снимком программы; дальше — как обычная ПСИ: местные отступления, замечания, акт и подписи (представителей площадки — подписью за внешнюю сторону со сканом).
  • Сводка. По каждой площадке — «не начато», «идут испытания», «испытания не завершены», «не принято», «на подписании», «принято с замечаниями» или «принято» по её акту; подписи, замечания, отступления.
  • Общие замечания к эталону. Дефект проекта, отмеченный общим, виден у всех площадок; пока он открыт, площадка принимается только с замечаниями.
  • Новая редакция. Если требование эталона изменилось после старта приёмки площадки, у неё видно «после старта изменилось требований: N»; в эталоне — число подозрительных связей «требование ↔ кейс».
  • Сводка — в пределах пространства; площадки в разных пространствах холдинга — после решения по тарифу для холдинга.

7. Автотесты: приём отчётов из CI

QA Деск принимает отчёты автотестов в 2 форматах — JUnit XML и Allure — по HTTP с токеном проекта. Повторная отправка того же запуска CI дублей не создаёт; для конвейера есть утилита qadesk-cli.

Где найти и кто выпускает токен. В кабинете: «Настройки → Интеграции → CI / автотесты» — вкладка видна всем участникам пространства. Токен приёма выпускается на проект, поэтому сначала выберите проект в шапке. Выпускает и отзывает токены администратор пространства: остальным ролям вкладка показывает, кто именно, и ссылки на инструкции.

Автотесты из CI в QA Деск
Отчёт e2e Playwright из GitLab CI разложен по кейсам проекта.

Адреса приёма:

POST https://api.qadesk.ru/ingest/v1/junit?name=…&environment=…&platform=…&ciRunId=…&attempt=…
POST https://api.qadesk.ru/ingest/v1/allure?name=…&environment=…&platform=…&ciRunId=…&attempt=…
  • Форматы: JUnit XML и Allure (NDJSON).
  • Повторная отправка того же отчёта (совпадают запуск CI и номер попытки) не создаёт дублей.
  • Результаты сопоставляются с кейсами библиотеки по ключам; прогон появляется в кабинете как автоматический.
  • Для отправки из конвейера CI удобна консольная утилита qadesk-cli — бинарники для Linux, macOS и Windows, флаги и примеры пайплайнов на странице qadesk.ru/cli.

7.1. Нагрузочные прогоны: k6, JMeter, Gatling

Сводку нагрузочного теста qadesk-cli превращает в обычный прогон: транзакция — строка прогона, её показатели — числа на измерительных шагах кейса (6.3). Вердикт по допуску считает система, поэтому строка краснеет, даже если CI отчитался «зелёным».

  • Форматы: --format k6-summary (итог k6 run --summary-export), jmeter-jtl (CSV JTL) и gatling (js/stats.json отчёта).
  • Кейс нагрузки по умолчанию — пять шагов: p50, p95, p99 (мс), rps, доля ошибок (%). Другой набор задаётся флагом --load-steps, например p95=1,errors=2.
  • Ключ кейса берётся из имени транзакции (QAD-C31 checkout); для сводки из одной безымянной транзакции — флаг --case.
  • Сырые данные и генерация нагрузки остаются у инструмента, в систему уходит только сводка; тренд p95 по версиям — на карточке кейса.
  • Итог регулярной проверки (6.7) скрипт отправляет с флагом --plan — прогон засчитывается как проверка плана.

8. Работа из Битрикс24

В Битрикс24 QA Деск работает во вкладке «QA Деск: дефекты» карточки задачи: там видны связанные дефекты и заводится новый. Исполнитель выбирается из участников задачи, связь дефекта с задачей ставится автоматически, переход в кабинет — без отдельного пароля.

  • В карточке задачи портала — вкладка «QA Деск: дефекты»: связанные дефекты и форма заведения нового прямо из задачи.
  • Исполнитель нового дефекта выбирается из участников задачи; дефект и задача связываются автоматически.
  • Из вкладки доступен переход к дефекту в кабинете — вход выполняется сквозным образом, без отдельного пароля.

В карточке дефекта кабинета нажмите «Поставить задачу в Битрикс24». Если проект привязан к скрам-группе, в поле «Куда положить» выберите «Бэклог» (выбран по умолчанию) или активный либо запланированный спринт. Завершённые спринты не предлагаются; перед созданием задачи выбор проверяется повторно. Если у учётки приложения нет прав на скрам, доступен только бэклог. Если задачу портала не удалось перенести в выбранный спринт, появится сообщение с причиной и предложением перенести её на доске.

9. Подключение ИИ-агента (MCP)

ИИ-агент (Claude Code, Claude Desktop, Cursor) подключается к QA Деск по MCP за 3 шага: токен qdpt_… в «Настройки → MCP», адрес https://api.qadesk.ru/mcp в клиенте, работа в правах владельца токена.

  1. В кабинете откройте Настройки → MCP и выпустите персональный токен. Секрет qdpt_… показывается один раз — сохраните его сразу; утерянный токен отзывается и выпускается заново.
  2. Подключите MCP-клиент (Claude Code, Claude Desktop, Cursor и другие): тип сервера — Streamable HTTP, адрес https://api.qadesk.ru/mcp, заголовок Authorization: Bearer qdpt_….
  3. Агент действует от вашего имени, строго в ваших правах и в пределах областей токена, выбранных при выпуске: ищет дефекты, отвечает по карточкам, заводит новые, переводит по стадиям, комментирует.

9.1. Агент как отдельный участник

Автоматику можно завести отдельным участником пространства — агентом, чтобы в прогонах и дефектах была подпись «кем проверено», а не имя выпустившего токен. Агента заводит администратор во вкладке настроек «Агенты»: имя, назначение, роль и владелец-сотрудник.

  • У агента нет почты и пароля; он действует только своими токенами MCP (qdpt_…) и токенами приёма отчётов.
  • Роль агента — любая, кроме администратора. Агент не занимает платное место специалиста.
  • Агента нельзя удалить — только выключить: его токены перестают приниматься, а история сохраняет подпись. Включение возвращает токены в работу.

10. Ошибки из Sentry — в дефекты

Ошибка уровня error или fatal в проекте Sentry становится дефектом выбранного проекта QA Деск — со ссылкой на issue, типом исключения и местом возникновения. Одна ошибка — один дефект: повторные срабатывания правила дефект не дублируют.

  1. В Sentry выпустите Auth Token: Settings → Auth Tokens → Create New Token, право project:read. Это не «Security Token» из раздела Security & Privacy — тот нужен только для скачивания карт источников и здесь не используется.
  2. В кабинете откройте Настройки → Sentry (право управления пространством). В поле «Инсталляция» вставьте ссылку на проект из адресной строки Sentry целиком — например https://sentry.example.com/organizations/acme/projects/shop/?project=4509; адрес установки, организация и проект разберутся сами. Вставьте токен, выберите проект QA Деск для дефектов и нажмите «Проверить и подключить». Подключение сохраняется только после того, как Sentry принял токен и показал ему проект; отказ приходит с причиной и с названием поля.
  3. Скопируйте с карточки подключения адрес вебхука — он содержит секрет, не публикуйте его. Новый адрес можно выпустить в любой момент, старый перестаёт приниматься сразу.
  4. В Sentry включите плагин WebHooks: проект → Settings → Integrations → WebHooks → Enable, затем Configure plugin (прямой адрес: /settings/<организация>/projects/<проект>/plugins/webhooks/). В поле Callback URLs вставьте адрес вебхука, сохраните.
  5. Создайте правило оповещений: Alerts → Create Alert → Issues, условие «A new issue is created», действие «Send a notification via WebHooks». Без правила плагин ничего не отправляет.
  6. Проверьте: Test Plugin на странице плагина или Send Test Notification в правиле. В проекте появится дефект с пометкой источника, на карточке подключения — время последнего вебхука и число заведённых дефектов. Тестовый дефект можно удалить — связка уйдёт вместе с ним.

Строже: Settings → Developer Settings → Internal Integration с Webhook URL, галочкой «Alert Rule Action», правом Issue & Event: Read и вебхуком issue: created. Его Client Secret впишите на карточке подключения («Заменить токен» → Client Secret, поле токена оставьте пустым) — тогда каждая доставка проверяется по подписи.

В карточке дефекта блок «Ошибки Sentry» показывает связанные issue; существующую ошибку можно привязать по id или ссылке. Среда, платформа и серьёзность заводимых дефектов задаются на карточке подключения; blocker/critical недоступны — у них обязательно вложение, а вебхук его не несёт.

Как подключить Alertmanager

  1. С правом workspace.manage откройте в кабинете Настройки → Интеграции → Мониторинг, укажите подпись и проект для дефектов и нажмите «Получить адрес вебхука».
  2. В настройках Alertmanager вставьте полученный адрес в receivers.webhook_configs вместо плейсхолдера ниже и направьте нужные алёрты маршрутом на получателя qadesk:
    receivers:
      - name: qadesk
        webhook_configs:
          - url: "<АДРЕС_ВЕБХУКА_ИЗ_КАБИНЕТА>"
            send_resolved: true
    Адрес содержит секрет; не публикуйте его. send_resolved: true нужен для комментария «алёрт погас»; дефект при этом не закрывается.
  3. После первого алёрта проверьте дату и итог последней доставки на карточке подключения в кабинете. До доставки там показано «доставок не было». Правила создания и повторных срабатываний.

11. Поддержка

Вопросы по работе системы, внедрению и переносу данных: hello@qadesk.ru. Поддержка ведётся на русском языке.