167 lines
14 KiB
Markdown
167 lines
14 KiB
Markdown
# PRD · ПУЛЬС — Неотложка
|
||
|
||
**Игровой тренажёр клинических кейсов по неотложной медицинской помощи**
|
||
|
||
Версия документа: 1.0
|
||
Статус: реализовано (MVP), в итеративной доработке
|
||
Платформа: статический сайт (HTML + CSS + vanilla JS), публикуется через Git Pages
|
||
|
||
---
|
||
|
||
## 1. Концепция
|
||
|
||
**ПУЛЬС** — образовательный игровой тренажёр для студентов-медиков 6 курса. Студент работает с «говорящими» видео-пациентами: выслушивает жалобы голосом, самостоятельно назначает обследования и лечение, ставит диагноз и оказывает экстренную помощь на время. За точность начисляется опыт (XP), открываются достижения и уровни, результаты попадают в рейтинг. Алгоритмы решения основаны на клинических протоколах диагностики и лечения МЗ РК.
|
||
|
||
**Ценность:** превращает сухую зубрёжку протоколов в тренировку клинического мышления в условиях, близких к приёмному отделению, с мгновенной обратной связью и игровой мотивацией.
|
||
|
||
---
|
||
|
||
## 2. Целевая аудитория
|
||
|
||
- **Основная:** студенты 6 курса медицинских вузов (интерны, ординаторы) — отработка неотложных состояний.
|
||
- **Дополнительная:** врачи СМП и приёмного покоя для повторения алгоритмов; преподаватели — как материал для семинаров.
|
||
- **Контекст применения:** Казахстан (протоколы МЗ РК, русскоязычный интерфейс).
|
||
|
||
---
|
||
|
||
## 3. Цели и задачи
|
||
|
||
### Цели продукта
|
||
1. Дать практику клинического мышления по неотложным состояниям в безопасной среде.
|
||
2. Закрепить алгоритмы клинических протоколов МЗ РК через повторение.
|
||
3. Повысить мотивацию к обучению за счёт геймификации.
|
||
|
||
### Метрики успеха (MVP)
|
||
- Завершение полного экзамена (6 кейсов) за один заход — основная конверсия.
|
||
- Доля повторных прохождений кейсов (replay) — вовлечённость.
|
||
- Средний балл по кейсу/экзамену — уровень усвоения.
|
||
- Количество разблокированных достижений — глубина погружения.
|
||
|
||
---
|
||
|
||
## 4. Функциональные требования
|
||
|
||
### 4.1. Профиль игрока и уровни
|
||
- Создание профиля: имя + аватар (emoji).
|
||
- Система опыта (XP): начисляется за результаты кейсов (пропорционально приросту лучшего балла).
|
||
- 8 уровней: Стажёр → Студент → Интерн → Ординатор → Врач → Специалист → Эксперт → Профессор.
|
||
- Шапка профиля: аватар, имя, текущий уровень, XP-бар до следующего уровня.
|
||
- Сохранение профиля и прогресса в браузере (localStorage).
|
||
|
||
### 4.2. Карта прохождения тем
|
||
- 3 темы: «ОКС и инфаркт», «ОДН · астма · ХОБЛ», «Шок и травма».
|
||
- По каждой теме: прогресс-бар (кейсов пройдено), заработанные звёзды.
|
||
- Клик по теме фильтрует кейсы и переносит к списку.
|
||
|
||
### 4.3. Кейсы
|
||
- 6 клинических кейсов (по 2 на тему).
|
||
- Карточка кейса: портрет-аватар (фото), тема, звёзды (1–3), лучший результат, счётчик прохождений, статус «Пройден», кнопка «Играть/Повторить».
|
||
|
||
### 4.4. Видео-пациент (говорящий аватар)
|
||
- В шаге «Пациент» — видеоплеер с крупным портретом пациента.
|
||
- При нажатии «Прослушать»: синтез речи (Web Speech API), портрет «оживает» — звуковые волны, лёгкая анимация говорения, индикатор LIVE.
|
||
- **Субтитры** синхронно с речью (по фразам).
|
||
- Голос подбирается под пациента: пол, возраст, состояние (pitch/rate/громкость), паузы-«дыхание» между фразами (у астматика — рваная речь с длинными паузами, у шокового — тихая и замедленная).
|
||
|
||
### 4.5. Пошаговое решение кейса (экзамен)
|
||
Каждый кейс = 4 шага + результат:
|
||
1. **Обследования** — множественный выбор из перечня (нужные vs лишние).
|
||
2. **Лечение** — множественный выбор препаратов (нужные vs противопоказанные).
|
||
3. **Диагноз** — выбор одного верного варианта.
|
||
4. **Экстренная помощь ⏱** — за 60 секунд выбрать правильные действия; таймер с обратным отсчётом, автозавершение при истечении.
|
||
|
||
Требования к выбору вариантов:
|
||
- Варианты кликабельны и доступны для нажатия на всех шагах.
|
||
- После «Подтвердить» варианты блокируются и подсвечиваются: верно / лишнее / пропущено / верный диагноз.
|
||
|
||
### 4.6. Оценка и обратная связь
|
||
- Балл за шаг множественного выбора: `(TP + TN) / всего × 100%`.
|
||
- Диагноз: 100% / 0%.
|
||
- Вес шагов в кейсе: обследования 20%, лечение 20%, диагноз 30%, экстренная помощь 30%.
|
||
- Экран результата кейса: кольцевой индикатор %, грейд (Отлично/Хорошо/Удовл./Неуд), разбивка по шагам, награды (звёзды, XP, новые достижения), разбор: правильный диагноз, **протокол МЗ РК**, ключевые данные, типичные ошибки.
|
||
|
||
### 4.7. Геймификация
|
||
- **Звёзды за кейс:** ≥85% → 3, ≥70% → 2, ≥55% → 1.
|
||
- **Достижения (11 шт.):** «Первый шаг», «Точный диагноз», «Безупречный кейс», «Чистая работа», «Молниеносная реакция», «Мастер ОКС/ОДН/шока», «Великий диагност», «Полное прохождение», «Профессор».
|
||
- **Тосты** при разблокировке достижений и повышении уровня.
|
||
|
||
### 4.8. Рейтинг игроков
|
||
- Топ-10 результатов полного экзамена (имя, аватар, %, дата).
|
||
- Сохраняется локально в браузере; результат текущего игрока подсвечен.
|
||
|
||
### 4.9. Полный экзамен
|
||
- Последовательное прохождение всех 6 кейсов.
|
||
- Итоговый экран: средний %, грейд, разбивка по темам и по кейсам.
|
||
- Результат добавляется в рейтинг.
|
||
|
||
---
|
||
|
||
## 5. Содержание кейсов (по протоколам МЗ РК)
|
||
|
||
| # | Тема | Кейс | Протокол МЗ РК |
|
||
|---|------|------|----------------|
|
||
| 1 | ОКС | Острый инфаркт миокарда с подъёмом ST (STEMI) | «Острый коронарный синдром» |
|
||
| 2 | ОКС | ОКС без подъёма ST (NSTEMI) | «Острый коронарный синдром» |
|
||
| 3 | ОДН | Острый тяжёлый приступ бронхиальной астмы | «Бронхиальная астма» |
|
||
| 4 | ОДН | Обострение ХОБЛ с ОДН 2 типа | «Хроническая обструктивная болезнь лёгких» |
|
||
| 5 | Шок | Травматический геморрагический шок | «Шок», «Острое кровотечение» |
|
||
| 6 | Шок | Септический шок | «Сепсис и септический шок» |
|
||
|
||
Ключевые положения протоколов, отражённые в кейсах:
|
||
- **STEMI:** первичное ЧКВ (door-to-balloon ≤ 90 мин); при недоступности ≤ 120 мин — фибринолизис, в т.ч. догоспитальный; двойная антитромбоцитарная терапия + антикоагулянт.
|
||
- **NSTEMI:** тромболизис НЕ показан; стратификация по GRACE; ранняя инвазивная стратегия.
|
||
- **Астма:** β2-агонисты + ипратропия бромид + системные ГКС + магний; седативные/опиоиды противопоказаны.
|
||
- **ХОБЛ:** контролируемая О₂-терапия (целевой SpO₂ 88–92%); NIV при гиперкапнии.
|
||
- **Геморрагический шок:** damage control, остановка кровотечения, гемотрансфузия 1:1:1, транексамовая кислота; борьба с триадой смерти.
|
||
- **Сепсис:** hour-1 bundle (лактат, гемокультуры, антибиотики в 1-й час, инфузия 30 мл/кг, норадреналин).
|
||
|
||
---
|
||
|
||
## 6. Дизайн
|
||
|
||
- **Стиль:** выдержанная классическая палитра — графит-navy, кремовый «бумажный» фон, приглушённое золото (акцент), бордо (ОКС), тёмно-бирюзовый (ОДН), кирпичный (шок), хирургический зелёный (верно). Строгий медицинский вид, без неон-яркости.
|
||
- **Типографика:** Manrope.
|
||
- **Адаптив:** desktop / планшет / мобильный.
|
||
- **Иконки:** emoji и inline-элементы.
|
||
|
||
---
|
||
|
||
## 7. Технологии и ограничения
|
||
|
||
- **Стек:** статические `index.html` + `style.css` + `app.js` (vanilla JS). Без бэкенда, БД, сборщиков, аутентификации.
|
||
- **Озвучка:** Web Speech API (SpeechSynthesis), русские голоса браузера.
|
||
- **Хранение:** localStorage (профиль, прогресс, рейтинг).
|
||
- **Публикация:** Git Pages, ветка `pages`.
|
||
- **Ограничения песочницы:** только статика; реальные фото/видео пациентов не используются (этика) — применяется анимированный видео-аватар.
|
||
|
||
---
|
||
|
||
## 8. Пользовательский путь
|
||
|
||
1. Открывает сайт → видит шапку профиля и hero с уровнем/XP.
|
||
2. Создаёт профиль (имя + аватар) через ⚙️.
|
||
3. Заходит в «Карту прохождения» или сразу в «Кейсы».
|
||
4. Выбирает кейс → видеопациент рассказывает жалобы голосом.
|
||
5. Проходит 4 шага (обследования → лечение → диагноз → экстренная помощь на 60 с).
|
||
6. Получает результат: %, звёзды, XP, достижения, разбор с протоколом МЗ РК.
|
||
7. Идёт к следующему кейсу или запускает полный экзамен → попадает в рейтинг.
|
||
8. Растёт в уровне от Стажёра до Профессора.
|
||
|
||
---
|
||
|
||
## 9. Roadmap (возможные доработки)
|
||
|
||
- Расширение тем: кома и неврология, острый живот, отравления, анафилаксия.
|
||
- Режим «Экзамен с таймером на весь кейс».
|
||
- Экспорт результата / сертификат прохождения.
|
||
- Импорт своих медиа (фото/видео пациентов) для преподавателя.
|
||
- Поддержка казахского языка интерфейса.
|
||
- Синхронизация прогресса между устройствами (требует бэкенда — вне песочницы).
|
||
|
||
---
|
||
|
||
## 10. Ссылки
|
||
|
||
- Сайт: https://pages.git.vibe42.kz/saniya_akpanova_91/emergency-cases/
|
||
- Репозиторий: https://git.vibe42.kz/saniya_akpanova_91/emergency-cases
|