6.4 KiB

Raw Blame History

Как пользоваться стендом dev (простыми словами)

Для кого: тот, кто проверяет интерфейс на своей машине или на общем dev-сервере, без погрузки в код.

Адрес по умолчанию: http://localhost:3107 — если вы подняли проект командой docker compose -f docker-compose.dev.yml up из корня репозитория. В браузере откройте :3107 (интерфейс); запросы к /api/… с этой страницы идут на бэкенд через Nginx. Прямой адрес API с вашего ПК: http://localhost:3001 (если смотрите health или тестируете curl).

Если кто-то дал другой URL (например, внутренний хост клиники) — откройте его; логика та же.

1. Вход

Откройте в браузере адрес стенда. Должна открыться страница входа (логин, пароль, кнопка «Войти»).
Введите логин и пароль, которые вам выдали для этой базы clinic_tests (или HR, если включён HR_AUTH — смотрите, что сказал разработчик).
После успешного входа вы попадаете в раздел «Тесты». В шапке справа: Фамилия с инициалами и роль; слева — название портала. «Выйти» завершает сессию.

Если не пускает — не подбирайте пароль: напишите тому, кто администрирует БД или .env на стенде.

2. Список «Тесты»

Каждая строка — один тест (одна цепочка; номер версии в подписи внизу строки).
Слева — название (клик открывает карточку теста: настройки, вопросы, назначения — если вы автор, или краткую информацию — если вам только назначили).
Справа — кнопка «Пройти»: начать попытку сразу по текущей активной версии (именно с неё, а не с «старой из назначения»).
Под названием: Автор: Вы — если вы создали тест; Автор: Фамилия И. О. — если тест чужой, но вам назначен.

Пустой список: либо вам ничего не назначили и вы не создавали тесты, либо всё скрыто из списка (у автора внизу может быть блок «Скрытые вами»).

3. Карточка теста (автор)

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

Автор не запускает экзамен с карточки в том же сценарии, что сотрудник: для самопрохождения — «Пройти» в списке «Тесты».

4. Прохождение и разбор (сотрудник или самопроверка автора)

В списке нажмите «Пройти» у нужного теста.
Ответьте на вопросы, нажмите «Завершить тест».
Увидите сводку (сколько верно, процент, зачёт/незачёт) и разбор по вопросам (что отмечено, что было верно). Есть ссылка на отдельную страницу разбора — удобно, если нужно вернуться позже.

5. Что сказать разработчику, если «что-то не так»

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

6. Где почитать подробности для разработки

PROJECT_STATUS.md — что в целом сделано и что в планах.
../README.md — Docker, БД, переменные окружения.

6.4 KiB Raw Blame History