Константин Лебединский
31b51b7768
- СПРИНТЫ: remove inline instruction and sprint 4; link to РУКОВОДСТВО + images - Add docs/РУКОВОДСТВО_КАБИНЕТ_ТЕСТОВ.md (user-facing, with SVG refs) - ПРЕДЛОЖЕНИЕ_ДИЗАЙН: актуализация TestDetail/cabinet-theme vs legacy TestForm - PROJECT_STATUS, DEV_CONTOUR, шаги 05+README, migration, README: current block names and links Made-with: Cursor
65 lines
6.5 KiB
Markdown
65 lines
6.5 KiB
Markdown
# Как пользоваться стендом **dev** (простыми словами)
|
||
|
||
**Для кого:** тот, кто **проверяет** интерфейс на своей машине или на общем dev-сервере, без погрузки в код.
|
||
|
||
**Адрес по умолчанию:** [http://localhost:3107](http://localhost:3107) — если вы подняли проект командой `docker compose -f docker-compose.dev.yml up` из корня репозитория. В браузере откройте **:3107** (интерфейс); запросы к `/api/…` с этой страницы идут на бэкенд через Nginx. Прямой адрес API с вашего ПК: **http://localhost:3001** (если смотрите health или тестируете curl).
|
||
|
||
Если кто-то дал **другой URL** (например, внутренний хост клиники) — откройте его; логика та же.
|
||
|
||
---
|
||
|
||
## 1. Вход
|
||
|
||
1. Откройте в браузере адрес стенда. Должна открыться **страница входа** (логин, пароль, кнопка «Войти»).
|
||
2. Введите **логин и пароль**, которые вам выдали для **этой** базы `clinic_tests` (или HR, если включён `HR_AUTH` — смотрите, что сказал разработчик).
|
||
3. После успешного входа вы попадаете в раздел **«Тесты»**. В **шапке** справа: **Фамилия с инициалами** и роль; слева — название портала. **«Выйти»** завершает сессию.
|
||
|
||
Если не пускает — не подбирайте пароль: напишите тому, кто администрирует БД или `.env` на стенде.
|
||
|
||
---
|
||
|
||
## 2. Список «Тесты»
|
||
|
||
- Каждая **строка** — один тест (одна **цепочка**; номер версии в подписи внизу строки).
|
||
- **Слева** — **название** (клик открывает **карточку** теста: настройки, вопросы, назначения — если вы автор, или краткую информацию — если вам только **назначили**).
|
||
- **Справа** — кнопка **«Пройти»**: начать попытку **сразу** по **текущей активной** версии (именно с неё, а не с «старой из назначения»).
|
||
- Под названием: **Автор: Вы** — если вы создали тест; **Автор: Фамилия И. О.** — если тест чужой, но вам **назначен**.
|
||
|
||
Пустой список: либо вам **ничего не назначили** и вы **не создавали** тесты, либо всё **скрыто** из списка (у автора внизу может быть блок «Скрытые вами»).
|
||
|
||
---
|
||
|
||
## 3. Карточка теста (автор)
|
||
|
||
Блоки **сворачиваются** (заголовок — тап). Внизу экрана на телефоне часто закреплены **«Сохранить черновик»** и **«К списку»**.
|
||
|
||
- **О тесте** — название, описание, **порог зачёта**. **Сохранить черновик** — записывает правки. Если по тесту **уже были прогоны**, при изменении **содержимого** система заведёт **новую версию** (и предупредит, что так и задумано).
|
||
- **Вопросы** — тексты вопросов и варианты, отметка верных, **ИИ** (если есть), внизу секции — **«Документ в вопросы»** (загрузка файла и вставка в черновик, если на стенде настроен LLM).
|
||
- **История** — **Версии** (все версии, **сделать активной** с подтверждением) и **Прохождения** (кто сдавал; **Разбор** по вопросам).
|
||
- **Показ в каталоге** — **Видимость** (скрыть из общего списка или снова показать); при включённом назначении — **Кому выдать** (поиск, **«Назначить выбранных»**).
|
||
|
||
Автор **не** запускает экзамен **с карточки** в том же сценарии, что сотрудник: для самопрохождения — **«Пройти»** в **списке** «Тесты».
|
||
|
||
---
|
||
|
||
## 4. Прохождение и разбор (сотрудник или самопроверка автора)
|
||
|
||
1. В списке нажмите **«Пройти»** у нужного теста.
|
||
2. Ответьте на вопросы, нажмите **«Завершить тест»**.
|
||
3. Увидите **сводку** (сколько верно, процент, зачёт/незачёт) и **разбор по вопросам** (что отмечено, что было верно). Есть ссылка на **отдельную страницу разбора** — удобно, если нужно вернуться позже.
|
||
|
||
---
|
||
|
||
## 5. Что сказать разработчику, если «что-то не так»
|
||
|
||
- **«Белый экран» / ошибка** — сделайте скриншот и опишите, **на какой странице** (например, «после Войти» или «после Пройти»).
|
||
- **«Не вижу тест»** — уточните, вы **автор** или вам должны были **назначить**; проверьте блок **скрытых** тестов.
|
||
- **«Сохранил, а версия не та»** — скажите, были ли **уже** попытки у других: после первой попытки **любая** смена содержимого **увеличивает** номер версии **специально**, чтобы старые ответы не «переписывались».
|
||
|
||
---
|
||
|
||
## 6. Где почитать подробности для разработки
|
||
|
||
- [PROJECT_STATUS.md](PROJECT_STATUS.md) — что в целом сделано и что в планах.
|
||
- [../README.md](../README.md) — Docker, БД, переменные окружения.
|