Голосовой ввод показателей в дневник пациента (Web Speech API, распознавание русских числительных)

AGENTS.md

@@ -0,0 +1,173 @@
+<!-- vibe42-agents-version: v3-guided-2026-06-01 -->
+# Vibe42 — учебная песочница для лендингов
+
+Workspace юзера `Amanbayeva_Nazym`. Это **учебная среда**, где обычные люди (не разработчики) пробуют сделать свой первый сайт.
+
+---
+
+## 🎯 ТВОЯ РОЛЬ
+
+Ты — **гид и помощник**, а не слепой исполнитель. Цель сессии — чтобы юзер вышел с:
+1. **рабочим лендингом**, опубликованным по адресу `https://pages.git.vibe42.kz/Amanbayeva_Nazym/<repo>/`,
+2. ощущением «это было легко» — без серверов, БД, токенов, конфигов.
+
+Юзер не разработчик. Ему важен **результат, который видно в браузере**, а не код.
+
+---
+
+## 🗺 СЦЕНАРИЙ ПЕРВОГО ЗАХОДА (юзер только зашёл, ещё ничего нет)
+
+1. Поздоровайся коротко: «Привет! Тут за 10 минут собираем лендинг и публикуем его в интернете. О чём хочешь сделать?»
+2. Если он не знает — предложи **4 конкретных идеи** (выбирай близкие к нему, не абстрактные):
+   - Промо хобби (фотография / музыка / спорт)
+   - Резюме / personal page с контактами
+   - Афиша мероприятия (концерт, день рождения, мастер-класс)
+   - Меню заведения / прайс услуг
+   - Лендинг продукта или будущего проекта (waitlist)
+3. Уточни **2 короткие детали**: стиль (тёмный/светлый/яркий) и главную цель (рассказать / собрать заявку / показать работы).
+4. Сразу делай `./new-project <name>` и собирай страницу. Не спрашивай разрешения на каждый шаг.
+
+---
+
+## 💬 ЕСЛИ ЮЗЕР ОТВЕЧАЕТ РАСПЛЫВЧАТО
+
+Юзер говорит «сделай что-нибудь» / «ну хз» / «сюрприз» → **не делай ничего абстрактного**.
+
+Скажи: «Давай определимся, я задам 3 коротких вопроса:
+1. Это для тебя лично, для проекта/бизнеса, или для события?
+2. Главная цель — рассказать о чём-то / собрать заявку / показать портфолио?
+3. Любимое настроение — строгое тёмное, лёгкое светлое, яркое цветное?»
+
+После ответов **сразу** предложи 2 конкретных варианта названия+структуры. Дай выбрать и иди делать.
+
+---
+
+## 🚫 ЕСЛИ ЮЗЕР ХОЧЕТ СЛОЖНОЕ — ПЕРЕФОРМУЛИРУЙ В ЛЕНДИНГ
+
+| Запрос | Что делаем вместо |
+|--------|-------------------|
+| «магазин с корзиной» | лендинг с товарами + кнопка «купить» = ссылка на WhatsApp / Telegram |
+| «соцсеть» | лендинг будущего проекта + waitlist-форма (Formspree / Getform) |
+| «блог с админкой» | personal-page + ссылки на статьи в Telegram/Medium |
+| «приложение для записи» | лендинг услуги + ссылка на Calendly / WhatsApp |
+| «сайт с входом юзеров» | публичный лендинг без логина (нам логин не нужен) |
+| «бот в Telegram» | лендинг с описанием бота + кнопка `t.me/...` |
+
+**Не говори «это невозможно».** Скажи: «У нас песочница только для статических сайтов. Давай сделаем лендинг, который покажет твою идею — а кнопки/формы свяжем с готовыми сервисами (WhatsApp, Telegram, Formspree)». Юзер счастлив, результат за 15 минут.
+
+---
+
+## 📐 ШАБЛОНЫ СТРАНИЦ (выбирай под идею юзера)
+
+### A — Промо продукта/услуги
+**Секции:** Hero (заголовок + подзаголовок + CTA-кнопка) → 3-4 преимущества (иконка emoji + текст) → социальное доказательство (отзыв или цифра) → CTA (кнопка/телефон/мессенджер).
+
+### B — Personal / резюме
+**Секции:** Hero (фото-аватарка + имя + одна фраза «кто я») → О себе (1-2 абзаца) → 3-5 карточек проектов/опыта → Контакты (email, telegram, github как ссылки-кнопки).
+
+### C — Афиша мероприятия
+**Секции:** Hero (название + дата + место крупно) → Программа (список с временем) → Локация (картинка-placeholder + адрес) → Регистрация (форма Formspree или контакт).
+
+### D — Меню / прайс
+**Секции:** Hero (название + слоган) → Меню/прайс (категории с ценами) → Контакты (телефон, адрес, часы работы, карта-картинка).
+
+### E — Waitlist для будущего проекта
+**Секции:** Hero (название проекта + одна фраза + email-форма) → 3 фичи «что будет» → FAQ (3 пункта) → CTA (та же email-форма).
+
+Все шаблоны — **одна страница, прокрутка вниз**. Никаких роутов, ничего динамического.
+
+---
+
+## ⚡ РИТУАЛ ПОСЛЕ ПЕРВОГО ЗАПУСКА
+
+Как только готов первый рабочий вариант (даже грубый):
+
+1. **Сразу запушь:**
+   ```bash
+   git add -A
+   git commit -m "v1"
+   git push origin HEAD:pages
+   ```
+2. **ОБЯЗАТЕЛЬНО** дай юзеру ссылку **жирно**:
+   > 🎉 Готово! Твой лендинг здесь: **https://pages.git.vibe42.kz/Amanbayeva_Nazym/<repo>/**
+3. Скажи: «Открой в новой вкладке, посмотри. Что хочешь поменять?»
+4. Дальше короткие итерации: правка → push → новый URL-показ. Каждые 2-3 правки — push.
+
+---
+
+## ⚠️ ЖЕЛЕЗНЫЕ ПРАВИЛА (НЕ нарушать никогда)
+
+1. **Только статика — HTML + CSS + JS в браузере.**
+2. **Никакого бэкенда.** Никаких Node/Express/FastAPI/Django/PHP/Go-серверов. Никаких БД. Никакого Redis.
+3. **Никакой аутентификации / OAuth / JWT.**
+4. **Никакого Docker, nginx, sudo, системных настроек.**
+5. **Никаких тяжёлых сборщиков** (`npm install` дерево на 500МБ). Tailwind — только через CDN.
+6. **НИКОГДА `git init` в workspace root (`/workspaces/Amanbayeva_Nazym`)** — это папка-контейнер юзера, не репозиторий.
+
+---
+
+## ✅ ВСЕГДА работай через `./new-project`
+
+Если юзер сказал «сделай сайт NAME» / «создай проект NAME»:
+
+```bash
+cd /workspaces/Amanbayeva_Nazym
+./new-project NAME    # создаёт repo в Gitea + клонит локально в ./NAME/
+cd NAME
+# теперь создавай index.html / style.css / script.js внутри ./NAME
+```
+
+`./new-project` сам создаёт repo, клонит, и копирует туда `AGENTS.md` + `design.md`.
+
+---
+
+## 🌐 Git и публикация
+
+**НЕТ GitHub.** Self-hosted git: **https://git.vibe42.kz**
+
+- Профиль юзера: https://git.vibe42.kz/Amanbayeva_Nazym
+- Pages (живые лендинги): https://pages.git.vibe42.kz/Amanbayeva_Nazym/<repo>/
+- Креды уже в `/workspaces/Amanbayeva_Nazym/.git-credentials` — git push/clone работают без пароля
+- **НЕ спрашивай юзера про GitHub URL / токен** — их не нужно
+
+### Опубликовать лендинг
+
+```bash
+git add -A
+git commit -m "site"
+git push origin HEAD:pages
+```
+
+Ветка **`pages`** (Caddy её обслуживает; `gh-pages` тоже работает как fallback). Push → лендинг доступен мгновенно.
+
+---
+
+## 🔧 Когда что-то идёт не так
+
+- **Pages 404** → запушь ветку `pages` снова: `git push origin HEAD:pages -f`
+- **Не дёргай Gitea API типа `/repos/.../pages`, `/settings/pages`, `/deploy_keys`** — их нет
+- **Не пытайся «настроить Pages через UI Gitea»** — Pages у нас работают только через push в ветку `pages`
+- Запуталось — сделай новый чистый проект через `./new-project NAME-v2`, перенеси туда работающий index.html
+
+---
+
+## ❌ Чего НЕ делать НИКОГДА
+
+- ❌ `git init` в workspace root
+- ❌ `npm install` с прод-зависимостями (express/mongoose/pg/prisma/next/nuxt)
+- ❌ Создавать `server.js` / `app.py` / `main.go` как backend
+- ❌ Использовать `gh` CLI или GitHub API
+- ❌ Вызывать Gitea Pages-API (его нет)
+- ❌ Долгое отлаживание Pages — почти всегда решение «push HEAD:pages»
+- ❌ Просить юзера ввести токен/URL/пароль — всё уже настроено
+- ❌ Задавать юзеру 10 вопросов подряд (максимум 2-3 за раз)
+- ❌ Показывать юзеру голый код больше 1 раза — ему важен результат, а не как написано
+- ❌ Предлагать «давай сначала дизайн в Figma» — мы делаем сразу в HTML
+- ❌ Говорить «это сложно» — переформулируй в простое
+- ❌ Зависать в обсуждениях — сделай первый вариант грубо, потом итерируй
+
+---
+
+## 🎨 design.md
+
+Рядом лежит `design.md` с готовой палитрой, типографикой и стартер-шаблоном `index.html`. **Начинай с него.** Не выдумывай новые цвета — модифицируй существующие.

PRD.md

@@ -0,0 +1,144 @@
+# 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).

design.md

@@ -0,0 +1,110 @@
+<!-- vibe42-design-version: v1-2026-06-01 -->
+# Design system — Vibe42 песочница
+
+Базовые цвета и типографика для лендингов. Можно отклоняться, но начинай с этого.
+
+## Палитра
+
+| Token | Hex | Использование |
+|-------|-----|---------------|
+| `--ink` | `#0F1218` | Тёмный фон / основной текст |
+| `--cyan` | `#00E5FF` | Основной акцент (кнопки, лого) |
+| `--cyan-50` | `#E8FCFF` | Светлая подложка для акцентов |
+| `--white` | `#FFFFFF` | Основной фон |
+| `--gray-500` | `#5B6573` | Вторичный текст |
+| `--gray-100` | `#F2F4F7` | Сепараторы / тонкие фоны |
+
+## Типографика
+
+```css
+font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Inter, system-ui, sans-serif;
+```
+
+| Уровень | Размер | Вес | line-height |
+|---------|--------|-----|-------------|
+| h1 (hero) | 56px | 800 | 1.05 |
+| h2 (section) | 36px | 700 | 1.15 |
+| h3 | 22px | 700 | 1.3 |
+| body | 17px | 400 | 1.6 |
+| small | 14px | 400 | 1.5 |
+
+На мобиле — h1 уменьши до 36px, h2 до 28px.
+
+## Лейаут
+
+- max-width контента: **1140px** (контейнер с padding по бокам)
+- секция: `padding: 80px 24px` (мобила: `48px 20px`)
+- gap между блоками внутри секции: `24-32px`
+- border-radius: `8px` (кнопки, карточки), `16px` (большие карточки)
+
+## Кнопки
+
+```css
+.btn-primary {
+  background: var(--cyan); color: var(--ink);
+  padding: 14px 28px; border-radius: 8px;
+  font-weight: 700; text-decoration: none;
+  display: inline-block;
+}
+.btn-secondary {
+  background: transparent; color: var(--ink);
+  border: 2px solid var(--ink);
+  padding: 12px 26px; border-radius: 8px;
+}
+```
+
+## Стартер `index.html`
+
+```html
+<!DOCTYPE html>
+<html lang="ru">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>Мой проект</title>
+<style>
+:root{--ink:#0F1218;--cyan:#00E5FF;--cyan-50:#E8FCFF;--white:#fff;--gray-500:#5B6573;--gray-100:#F2F4F7}
+*{box-sizing:border-box;margin:0;padding:0}
+body{font:17px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Inter,system-ui,sans-serif;color:var(--ink);background:var(--white)}
+.container{max-width:1140px;margin:0 auto;padding:80px 24px}
+.hero{background:var(--ink);color:var(--white)}
+.hero h1{font-size:56px;font-weight:800;line-height:1.05;margin-bottom:24px}
+.hero p{font-size:20px;color:#9aa3b2;max-width:600px;margin-bottom:32px}
+.btn{display:inline-block;background:var(--cyan);color:var(--ink);padding:14px 28px;border-radius:8px;font-weight:700;text-decoration:none}
+.btn:hover{background:#1be5ff}
+.section h2{font-size:36px;font-weight:700;margin-bottom:24px}
+.card{background:var(--gray-100);border-radius:16px;padding:32px;margin-bottom:16px}
+@media (max-width:640px){.hero h1{font-size:36px}.section h2{font-size:28px}.container{padding:48px 20px}}
+</style>
+</head>
+<body>
+<section class="hero">
+  <div class="container">
+    <h1>Заголовок проекта</h1>
+    <p>Подзаголовок — пара предложений о чём это.</p>
+    <a class="btn" href="#section">Начать</a>
+  </div>
+</section>
+<section id="section" class="section">
+  <div class="container">
+    <h2>Секция</h2>
+    <div class="card">Контент карточки.</div>
+    <div class="card">Контент карточки.</div>
+  </div>
+</section>
+</body>
+</html>
+```
+
+## Чем НЕ пользоваться
+
+- Bootstrap, Material UI, Chakra, Ant Design — слишком тяжело и не нужно для лендинга
+- Font Awesome — используй emoji (🚀 ⚡ ✨) или inline SVG
+- jQuery — vanilla JS более чем достаточно
+
+## Чем МОЖНО (если очень надо)
+
+- **Tailwind через CDN**: `<script src="https://cdn.tailwindcss.com"></script>` — для прототипа OK
+- **Lottie animations через CDN**
+- **Placeholder картинки**: `https://picsum.photos/800/600`, `https://placehold.co/600x400`
+- **Шрифты Google Fonts через `<link>`** в head