Константин Лебединский
47279c72e3
- compose: testing-web 3107:80, testing-backend 3001:3001, PORT+FRONTEND_URL - nginx → testing-backend:3001; Vite 3107, proxy /api → 3001 - server default PORT 3001; Dockerfile EXPOSE 3001; CORS dev — localhost:3107 - README, журнал, user guide Made-with: Cursor
64 lines
6.4 KiB
Markdown
64 lines
6.4 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, БД, переменные окружения.
|