Рекомендовать разработчику

Кнопка на каждой странице: что писать, скриншоты, кто читает, список Владыки портала.

Пока YouEDC растёт, лучшие идеи приходят от тех, кто в нём работает. Маленькая кнопка с лампочкой в верхней строке каждой страницы — Рекомендовать разработчику — открывает короткую форму: напишите идею, ошибку, неудобство или вопрос и при желании приложите скриншот. Дальше рекомендация идёт по трекеру: её разбирают, по ней принимают решение, автор видит каждый шаг и в конце проверяет, работает ли сделанное.

Форма открывается справа поверх страницы: то, что вы вводили на странице, не теряется.

Как отправить рекомендацию

1. Нажмите значок лампочки в верхней строке, слева от выбора языка (при наведении появляется подсказка «Рекомендовать разработчику»).
2. Выберите, о чём это: идея или пожелание, что-то не работает, неудобно или непонятно или вопрос.
3. Напишите своими словами, что вы делали и чего ждали. Чем конкретнее, тем быстрее получится сделать.
4. По желанию приложите до трёх скриншотов: вставьте из буфера (Ctrl+V), перетащите картинку, нажмите Выбрать файл или Снять экран — браузер сам спросит, какую вкладку или окно снять. Подходят PNG, JPEG и WebP до 8 МБ.
5. Нажмите Отправить ТГ. Панель покажет номер рекомендации; её можно закрыть и работать дальше.

Страницу, исследование, время и браузер записывать не нужно: портал сохраняет их сам, поэтому Владыка портала откроет ту же страницу, что видели вы.

Мои рекомендации: трекер

Открыть список можно в любой момент, не составляя новой рекомендации: пункт «Мои рекомендации» с их числом есть в боковом меню (он появляется после первой рекомендации) и на странице «Профиль».

«Мои рекомендации»: что стало с каждой рекомендацией, ответы ТГ и ваши действия.

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

Скриншоты и персональные данные

• На скриншоте не должно быть данных пациентов и чужих персональных данных. Перед снимком закройте карточку пациента или откройте демо-исследование.
• Снимок экрана делается только после вашего разрешения в окне браузера; вы видите картинку до отправки и можете её убрать.
• Портал заново сохраняет каждую картинку и выбрасывает метаданные файла (модель телефона, место съёмки, автора).
• Рекомендации видят только Владыки портала. Разработчику они уходят только в пакете для разбора: без имён и почт, а скриншоты только те, что Владыка портала посмотрел и отметил.
• Скриншоты закрытых рекомендаций удаляются через 12 месяцев (срок меняет Владыка портала), текст остаётся.
• Текст рекомендации не пишется в журнал аудита: там остаются только факты — отправка, решение, смена статуса, пакет, удаление.

Для Владыки портала: чей ход и решения

«Администрирование → Рекомендации»: вверху видно, чей ход и что ждёт вас.

• Вверху четыре карточки: Ваш ход (ждёт разбора, ждёт решения), Ход автора (уточняем у автора, готово и автор проверяет), Ход сборки (делаем, в сборке) и Закрыто или отложено. Щелчок по карточке или статусу фильтрует список.
• Справа порядок работы: скачать пакет для разбора, загрузить разбор, решить, а сделанное в релизе станет «готово» само. Там же цифры (сколько пришло, сколько дней до решения и до релиза, какая доля взята в работу), темы и блок «Кто рекомендует».

Экран решения: слева что написал автор, справа разбор разработчика и ваше решение.

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

Пакет для разбора и разбор разработчика

Пакет для разбора: вы видите, что уходит, и сами отмечаете скриншоты.

• Портал сам ничего никуда не отправляет и не использует ИИ. Пакет для разбора вы скачиваете и отдаёте разработчику.
• В пакет попадает всё, что изменилось с прошлого пакета: новые рекомендации, дописки и «не помогло» от авторов, ваши решения и то, что в плане на сборку.
• Вместо имени автора в пакете код (например A-3f9c2a), один и тот же во всех пакетах; почт нет. Скриншоты попадают только отмеченные вами галочкой «Нет ПДн: можно отдать». Каждый пакет записывается: когда, кто, какие рекомендации и скриншоты.
• Разработчик возвращает файл разбора (JSON). Загрузите его кнопкой Загрузить разбор. По каждой рекомендации в нём суть, что уже есть в портале, причина или объём, риски, тема, рекомендация и ответ автору от вашего имени. Карточка принимается только для той рекомендации, для которой написана: совпадают номер и отпечаток текста. Остальные пропускаются, и портал скажет, какие и почему. Критичные ошибки портал показывает отдельно.

Релиз, проверка автором и трассируемость

• Когда разработчик берёт рекомендацию в сборку, следующий разбор переводит её в В сборке с номером сборки и pull request.
• Релиз несёт список того, что он сделал. После установки эти рекомендации сами становятся Готово, автор проверяет с номером версии, а автор получает письмо с просьбой проверить.
• Трассируемость по релизам показывает для каждого релиза: какие рекомендации он закрыл, кто и когда решил, какая сборка и pull request, подтвердил ли автор. Таблицу Excel можно положить в пакет валидации релиза.

Письма и настройки

• Письма о новых рекомендациях. Впишите адреса (по одному в строке, до 10): каждая новая рекомендация, дописка автора и «не помогло» приходят туда письмом с текстом и ссылкой. Скриншоты в письмо не вкладываются, потому что на них могут быть персональные данные. Пока список не сохраняли, письма идут на адрес, заданный на сервере при установке, а если его нет, Владыкам портала; сохранённый пустой список — писем нет.
• Напоминание раз в неделю на те же адреса: сколько рекомендаций ждут разбора и решения и сколько дней ждёт самая старая. Выключается галочкой в «Настройках трекера».
• Там же срок хранения скриншотов закрытых рекомендаций в месяцах (0 — хранить всегда).
• Выгрузки в Excel и CSV содержат имена авторов: они для вашей работы, не для пересылки.
• Кнопку можно выключить для всех или для части людей в разделе «Функции и лимиты» (функция «Рекомендовать разработчику»). По умолчанию один человек отправляет не больше 30 рекомендаций в день.