# 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).