Amanbayeva_Nazym/copd-monitor
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
242766ad0b
copd-monitor/PRD.md

13 KiB
Raw Blame History

PRD — ПульсоMonitor: дистанционный мониторинг пациентов с ХОБЛ

Версия: 1.0 · Статус: прототип (демо) · Репозиторий: Amanbayeva_Nazym/copd-monitor URL: https://pages.git.vibe42.kz/Amanbayeva_Nazym/copd-monitor/

1. Описание продукта

Веб-приложение для дистанционного мониторинга пациентов с хронической обструктивной болезнью лёгких (ХОБЛ) медицинским персоналом. Пациент ведёт дневник самомонаблюдения и отмечает приём препаратов; система автоматически сегментирует состояние по зонам риска (светофор), показывает «красные флаги» и инструкции самопомощи. Медработник видит панель пациентов, отсортированную по степени риска, отчёты по сегментации и охвату, протокол действий и может назначать базисную терапию из каталога.

2. Проблема и цель

  • Проблема: обострения ХОБЛ часто выявляются поздно — на этапе госпитализации. Рутинный контроль в поликлинике нерегулярен, adherence к терапии низкий.
  • Цель: раннее выявление ухудшений по ежедневным показателям, снижение числа госпитализаций и нагрузки на приём врача, повышение приверженности лечению.

3. Пользователи и роли

Роль Сценарий
Пациент с ХОБЛ Ежедневно заполняет дневник (SpO₂, АД, ЧСС, ЧДД, одышка, CAT), отмечает приём препаратов, видит свою зону риска, красные флаги и образовательные материалы.
Медицинский персонал (врач / медсестра) Мониторит контур пациентов по зонам риска, работает с отчётами, назначает терапию, фиксирует вмешательства, действует по протоколу «светофор».

В прототипе роли переключаются в шапке без аутентификации (демо-режим).

4. Границы продукта (стек и ограничения)

  • Тип: статическое клиентское веб-приложение (HTML + CSS + vanilla JS).
  • Хранилище: localStorage браузера (данные не синхронизируются между устройствами).
  • Без бэкенда, БД, аутентификации, серверов.
  • Интеграция с приборами — имитация (mock) Bluetooth-чтения (Web Bluetooth не используется).
  • Адаптив: десктоп и мобильные.

5. Функциональные требования

5.1. Кабинет пациента

  • FR-1. Дневник самомонаблюдения (новая запись): SpO₂ (%), АД (систолическое/диастолическое, мм рт.ст.), ЧСС (уд/мин), ЧДД (/мин), одышка по шкале mMRC (0–4), характер мокроты, заметка.
  • FR-2. Анкета CAT — 8 вопросов (0–5 баллов), автоподсчёт суммы (0–40) с интерпретацией уровня влияния ХОБЛ.
  • FR-3. Базисные препараты и время приёма — список назначенной схемы, отметка «принят/пропущен/запланирован», кнопка «Отметить приём».
  • FR-4. Напоминания — при пропуске времени приёма препарата пациенту показывается напоминание, врач видит пропуск.
  • FR-5. Интеграция с приборами (mock) — кнопки «Пульсоксиметр» (заполняет SpO₂, ЧСС) и «Тонометр» (заполняет АД) в форме дневника.
  • FR-6. Сегментация состояния — после сохранения записи определяется зона риска (🟢/🟡/🔴) по SpO₂, ЧСС, ЧДД.
  • FR-7. Красные флаги — динамические инструкции самопомощи при ухудшении (падение SpO₂, резкая одышка, ЧДД>24, ЧСС>110) с порогом вызова скорой.
  • FR-8. Образование и самопомощь — раскрытые блоки: дыхательная гимнастика, техника ингаляции, план действий «светофор», когда вызывать скорую.
  • FR-9. История записей — таблица всех замеров с зоной.

5.2. Панель медработника

  • FR-10. Вкладки: 🩺 Пациенты / 📊 Отчёты / 🚦 Протокол (светофор).
  • FR-11. Список пациентов по степени риска — сортировка красная → жёлтая → зелёная, флаги «ухудшение / внимание / пропуск препарата / CAT», мини-показатели.
  • FR-12. Карточка пациента — последние показатели, динамика (sparkline SpO₂/ЧСС/ЧДД), история, adherence по препаратам, текущие флаги.
  • FR-13. Вмешательства и назначения врача — добавление текстовых записей (вмешательства/назначения) с датой, хранение в истории пациента.
  • FR-14. Назначение базисной терапии — выбор препаратов из каталога (с группировкой по классам) с редактируемым временем приёма; назначенная схема отображается в кабинете пациента. Дубликаты не добавляются.

5.3. Отчёты (FR-15..FR-16)

  • FR-15. Отчёт по сегментации пациентов: распределение по зонам (количество и %), столбчатые индикаторы, списки пациентов по каждой зоне.
  • FR-16. Отчёт по охвату мониторингом: всего под наблюдением; активны (замер ≤24ч); нет замеров >24ч; adherence препаратов (% принятых доз от назначенных); средний CAT; счётчики по зонам; список пациентов, требующих внимания (нет свежих замеров).

5.4. Протокол «светофор» (FR-17)

  • Расширенный протокол по трём зонам с блоками: критерии, действия пациента, действия медперсонала, эскалация.

6. Логика сегментации (светофор)

Общая зона = худшая из трёх показателей.

Показатель 🟢 Зелёная 🟡 Жёлтая 🔴 Красная
SpO₂ ≥ 95 % 90–94 % < 90 %
ЧСС 60–100 101–110 (или 50–59) > 110 (или < 50)
ЧДД 12–20 21–24 > 24 (или < 12)

CAT (сумма 8 вопросов, 0–40): ≤9 — низкое влияние; 10–20 — среднее; 21–30 — высокое; >30 — очень высокое. mMRC (одышка): 0–4.

7. Каталог базисной терапии ХОБЛ

Группы для назначения врачом:

  1. Купирование — сальбутамол, фенотерол, ипратропия бромид, ипратропий/фенотерол.
  2. ЛАМА — тиотропий, гликопирроний, аклидиний, умеклидиний.
  3. ЛАБА — индакатерол, олодатерол, сальметерол, формотерол.
  4. ЛАМА/ЛАБА — гликопирроний/индакатерол, тиотропий/олодатерол, умеклидиний/вилинтерол.
  5. ИГКС/ЛАБА — будесонид/формотерол, флутиказон/сальметерол, флутиказон/вилинтерол, беклометазон/формотерол.
  6. Тройная терапия (ИГКС/ЛАБА/ЛАМА) — флутиказон/умеклидиний/вилинтерол, беклометазон/формотерол/гликопирроний.
  7. Прочее — рофлумиласт (ФДЭ-4), N-ацетилцистеин, эрдостеин, азитромицин (профилактика обострений), длительная О₂-терапия.

8. Модель данных (localStorage, ключ copd_monitor_v2)

state = {
  role: "patient" | "staff",
  staffTab: "patients" | "reports" | "protocol",
  currentPatient: "p1",
  patients: [ patient ]
}
patient = {
  id, name, age, diag,
  meds: [ { id, name, times: ["08:00",...] } ],
  entries: [ entry ],
  interventions: [ { ts, text } ]
}
entry = {
  id, ts,
  spo2, sys, dia, hr, rr, mmrc,
  cat: [8 чисел 0–5], catTotal,
  meds: { "medId@time": { taken: bool, at? } },
  note
}

9. Демо-данные

4 пациента с разным состоянием: стабилен (зелёная), внимание (жёлтая, пропуск препарата), ухудшение (красная, гнойная мокрота, О₂-терапия, демо-вмешательства), стабилен (зелёная).

10. Нефункциональные требования

  • NFR-1. Только статика (HTML/CSS/JS), без сборщиков и фреймворков.
  • NFR-2. Работает офлайн после первой загрузки (данные в localStorage).
  • NFR-3. Адаптивный интерфейс (мобильные/десктоп).
  • NFR-4. Соответствие подходу 152-ФЗ заявлено в интерфейсе (в прототипе реальная обработка ПДн не реализована — нет сервера).

11. За пределами версии (Out of scope)

  • Реальный бэкенд, БД, аутентификация ролей и синхронизация данных.
  • Реальная интеграция с медицинскими приборами по Bluetooth (Web Bluetooth API).
  • Интеграция с ЭМК / ЕМИАС, направления на госпитализацию.
  • Push-уведомления вне браузера, телеметрия в реальном времени (WebSocket).
  • Спирометрия (ПСВ/ОФВ1) с расчётом от должных значений.

12. Roadmap (следующие итерации)

  1. Спирометрия — ПСВ и ОФВ1, расчёт от должных (рост/возраст/пол), отдельная сегментация.
  2. Экспорт карты пациента в PDF (печать).
  3. Реальная интеграция с приборами через Web Bluetooth API.
  4. Серверная часть + БД + ролевая аутентификация (врач/медсестра/пациент).
  5. Интеграция с ЭМК, автоматические направления и госпитализация.
  6. Push-уведомления и телеметрия в реальном времени.
  7. Многоязычность (KK/RU), доступность (a11y).

13. Технологии

HTML5 · CSS3 (собственная дизайн-система, палитра: ink #0F1218, cyan #00E5FF, зелёная/жёлтая/красная зоны) · vanilla JavaScript (ES5) · localStorage · публикация через ветку pages (Caddy).