Добавлен PRD.md — описание продукта Школы здоровья ХОБЛ

PRD.md

@@ -0,0 +1,116 @@
+# PRD — Школа здоровья для пациентов с ХОБЛ (Денсаулық мектебі)
+
+**Версия:** 1.0 · **Статус:** опубликован · **Проект:** `Amanbayeva_Nazym/copd-school`
+**URL:** https://pages.git.vibe42.kz/Amanbayeva_Nazym/copd-school/
+**Языки:** Русский (РУ) + Қазақша (ҚЗ) — переключатель в шапке
+
+---
+
+## 1. Описание продукта
+
+Двуязычный учебный веб-курс для школ здоровья в первичной медико-санитарной помощи (ПМСП). Предназначен для обучения пациентов с хронической обструктивной болезнью лёгких (ХОБЛ) всем аспектам самоменеджмента. Курс состоит из 7 занятий с теорией, чек-листами, самопроверкой и домашними заданиями, а также из 6 печатных памяток/флаеров для раздачи пациентам.
+
+## 2. Проблема и цель
+
+- **Проблема:** пациенты с ХОБЛ часто не владеют навыками самопомощи (ингаляция, дыхательная гимнастика, план действий при обострении), что ведёт к позднему обращению и росту госпитализаций.
+- **Цель:** обучить пациента контролировать болезнь, правильно принимать терапию, распознавать обострение и действовать по плану — снизить число обострений и госпитализаций, повысить качество жизни.
+
+## 3. Пользователи
+
+| Роль | Сценарий |
+|------|----------|
+| **Пациент с ХОБЛ** | Проходит занятия, отмечает прогресс, скачивает/печатает памятки, выполняет домашние задания. |
+| **Медицинский работник ПМСП** | Ведёт занятия школы здоровья, раздаёт памятки, использует курс как учебный материал. |
+
+## 4. Границы продукта (стек и ограничения)
+
+- **Тип:** статическое клиентское веб-приложение (HTML + CSS + vanilla JS).
+- **Данные:** `localStorage` браузера (только прогресс прохождения).
+- **Без бэкенда, БД, аутентификации.**
+- **Двуязычность:** весь контент хранится как данные в одном файле; рендер по выбранному языку.
+- **Адаптив:** десктоп и мобильные.
+- **Печать:** памятки открываются в отдельном окне с print-CSS для печати или сохранения в PDF.
+
+## 5. Функциональные требования
+
+- **FR-1. Переключатель языков РУ/ҚЗ** в шапке; выбор сохраняется в браузере; переключение мгновенно переводит весь интерфейс и контент.
+- **FR-2. Курс из 7 занятий** (см. раздел 6): каждое занятие содержит цель, содержание, чек-лист, самопроверку (ответы скрыты в `<details>`) и домашнее задание.
+- **FR-3. Трекер прогресса:** чекбокс «Пройдено» у каждого занятия, прогресс-бар в шапке, сохранение в `localStorage`. При 7/7 открывается сертификат.
+- **FR-4. Навигация по занятиям** — быстрые ссылки на все 7 занятий.
+- **FR-5. Памятки/флаеры для раздачи** (см. раздел 7): 6 одностраничных памяток с кнопкой «Печать / PDF».
+- **FR-6. Инфографика пошаговых действий** в памятках: числовые шаги с иконками, блок-схема «светофор», таймлайн дня.
+- **FR-7. Адаптивная вёрстка** для десктопа и мобильных.
+
+## 6. Структура курса — 7 занятий
+
+| № | Занятие (РУ) | Сабақ (ҚЗ) | Ключевые темы |
+|---|--------------|------------|---------------|
+| 1 | Знакомство с ХОБЛ: что происходит с лёгкими | ХОБЛ-мен танысу | природа болезни, причины (курение), симптомы, стадии GOLD, отличие от астмы |
+| 2 | Самоконтроль: измерения, шкалы, дневник | Өзіндік бақылау | пульсоксиметрия, спирометрия, CAT, mMRC, дневник, зоны «светофор» |
+| 3 | Лекарства и правильная ингаляция | Дәрілер және ингаляция | классы препаратов, базис vs спасательная, техника ДАИ, спейсер, adherence |
+| 4 | Дыхательная гимнастика и физическая активность | Тыныс алу гимнастикасы | диафрагмальное дыхание, дыхание через сжатые губы, положения, «разговорный тест», реабилитация |
+| 5 | Питание, отказ от курения, вакцинация, триггеры | Тамақтану, темекіні тастау | питание, НРТ/варениклин, вакцинация (грипп, пневмококк, COVID), триггеры |
+| 6 | Обострения: ранние признаки, план действий, красные флаги | Асқынулар | ранние признаки, план «светофор», спасательная терапия, ГКС/антибиотики, красные флаги, скорая |
+| 7 | Жизнь с ХОБЛ: психология, близкие, путешествия, права | ХОБЛ-мен өмір | тревога/депрессия, сон, сексуальная жизнь, путешествия, сопутствующие болезни, права пациента |
+
+Каждое занятие: **цель → содержание → чек-лист → самопроверка → домашнее задание**.
+
+## 7. Памятки/флаеры для раздачи пациентам (6)
+
+| Памятка | Содержание | Инфографика |
+|---------|-----------|-------------|
+| 🚦 План действий «светофор» | зоны риска, действия, красные флаги, контакты | блок-схема решения |
+| 💊 Техника ингаляции | ДАИ пошагово, частые ошибки, спейсер | 8-шаговая инфографика |
+| 🌬 Дыхательная гимнастика | диафрагмальное/через сжатые губы, положения, комплекс | пошаговая инфографика |
+| 📔 Дневник пациента | шаблон-таблица на неделю (SpO₂, АД, ЧСС, ЧДД, одышка, мокрота, препараты) | таблица |
+| 🥗 Питание и отказ от курения | принципы питания, план отказа, вакцинация | 5-шаговая инфографика |
+| 🎓 Итоговая памятка выпускника | ключевые навыки, «светофор», когда скорая | таймлайн дня |
+
+Все памятки доступны на обоих языках и форматируются для печати (print-CSS, отдельное окно).
+
+## 8. Локализация (РУ/ҚЗ)
+
+- Весь контент (UI-строки, 7 занятий, 6 памяток, инфографика) продублирован на русском и казахском.
+- Архитектура data-driven: объект `PACKS = {ru: RU, kz: KZ}`; функция `render()` перестраивает DOM по выбранному языку.
+- Прогресс прохождения общий для обоих языков (не зависит от языка).
+
+## 9. Архитектура и модель данных
+
+- **Рендер:** единая функция `render()` строит страницу из языкового пакета `P()`.
+- **Структура языкового пакета:** `ui` (строки интерфейса), `lessons[]` (7 занятий), `handouts{}` (6 памяток с функциями-билдерами HTML), `handoutCards[]` (карточки-превью).
+- **Хелперы инфографики (общие):** `stepsHtml(steps)` — числовые шаги; `flowHtml(a,b)` — блок-схема; `timelineHtml(rows)` — таймлайн; `diaryRows(days)` — строки таблицы дневника.
+- **Хранилище (localStorage, ключ `copd_school_bi_v1`):**
+```
+state = { lang: "ru"|"kz", done: { "l1-d": true, ... } }
+```
+`done` хранит отметки «Пройдено» по занятиям.
+
+## 10. Нефункциональные требования
+
+- NFR-1. Только статика (HTML/CSS/JS), без сборщиков и фреймворков.
+- NFR-2. Работает офлайн после первой загрузки (прогресс в localStorage).
+- NFR-3. Адаптивный интерфейс (мобильные/десктоп).
+- NFR-4. Печать памяток через `window.open` + print-CSS (корректно в Chrome/Edge/Firefox).
+- NFR-5. Медицинский контент основан на рекомендациях GOLD; носит ознакомительный характер, не заменяет консультацию врача.
+
+## 11. За пределами версии (Out of scope)
+
+- Учётные записи пациентов, серверная часть, синхронизация прогресса между устройствами.
+- Сертификаты с подписью/верификацией.
+- Интеграция с ЭМК / записью на занятия.
+- Аудио/видео-материалы, интерактивные симуляции ингаляции.
+- Тестирование с автоматической проверкой и балльной оценкой.
+
+## 12. Roadmap (следующие итерации)
+
+1. Аудио-сопровождение занятий и видео-демонстрация техники ингаляции.
+2. Интерактивный тренажёр ингаляции с обратной связью.
+3. Версия для слабовидящих (увеличенный шрифт, высокий контраст, screen-reader).
+4. Экспорт свидетельства о прохождении школы (PDF с ФИО пациента).
+5. Интеграция с расписанием занятий ПМСП и записью пациента.
+6. Дополнительные темы: кислородотерапия, паллиативная помощь, группы поддержки.
+7. Третий язык (английский) при необходимости.
+
+## 13. Технологии
+
+HTML5 · CSS3 (собственная дизайн-система, палитра: ink `#0F1218`, cyan `#00E5FF`, зелёная/жёлтая/красная зоны) · vanilla JavaScript (ES5) · localStorage · печать через `window.open` + print-CSS · публикация через ветку `pages` (Caddy).