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 (следующие итерации)

Аудио-сопровождение занятий и видео-демонстрация техники ингаляции.
Интерактивный тренажёр ингаляции с обратной связью.
Версия для слабовидящих (увеличенный шрифт, высокий контраст, screen-reader).
Экспорт свидетельства о прохождении школы (PDF с ФИО пациента).
Интеграция с расписанием занятий ПМСП и записью пациента.
Дополнительные темы: кислородотерапия, паллиативная помощь, группы поддержки.
Третий язык (английский) при необходимости.

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

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

12 KiB Raw Permalink Blame History Unescape Escape