docs: bootstrap repo — CLAUDE.md, spec, ADR, TenVex-style workflow

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/product/00_ideas.md

@@ -0,0 +1,7 @@
+# Идеи команды
+
+## 1. Фокус на психиатрии и ментальных расстройствах
+Обычные трекеры требуют высокой мотивации, которой у пациентов с депрессией просто нет. Если сфокусироваться на психиатрическом профиле, можно создать систему, которая не просто «звенит», а использует поведенческие паттерны. Например, ИИ-ассистент, который по характеру ответов или активности в приложении понимает, что пациент близок к отказу от терапии (например, при подборе антидепрессантов в первые недели, когда побочки уже есть, а эффекта ещё нет), и сигнализирует об этом лечащему врачу.
+
+## 2. Предиктивная аналитика для врача (дашборд)
+Главная проблема текущих систем — врач изолирован от данных пациента. Акцент на интерфейсе лечащего врача. Система агрегирует данные о комплаенсе и подсвечивает специалисту «красные зоны»: какие пациенты находятся в группе риска по прерыванию терапии. Алгоритм анализирует риски, но окончательное решение об изменении терапии принимает врач (что снимает часть этических и юридических проблем атрибуции ответственности ИИ).

docs/product/01_demo_persona.md

@@ -0,0 +1,69 @@
+# 01. Демо-персона и сценарии
+
+Источник для seed-данных и сценария демо. Все данные вымышленные.
+
+## Основная персона
+
+| Поле | Значение |
+|---|---|
+| Имя | Алексей, 28 лет, Москва |
+| Работа | разработчик |
+| Жалобы (2 мес.) | сниженное настроение, нет интереса к делам, плохой сон, трудно работать |
+| Барьер | к врачу не шёл: «боюсь, что поставят на учёт» |
+| Скрининг (день −3) | PHQ-9 = 14 (умеренная), п.9 = 0; травмы не было → PC-PTSD-5 пропущен; GAD-7 = 9 |
+| Визит к психиатру (день 0) | депрессивный эпизод средней степени; сертралин 50 мг 1 р/сут утром после еды; следующий визит через 4 недели |
+| Врач | д-р Смирнова Е. А., психиатр |
+
+## Сценарий А — скрининг (демо 30–40 сек)
+
+1. Пользователь открывает бота без регистрации → дисклеймер («это не диагноз») + согласие на обработку данных.
+2. Вопрос о возрасте. Если < 18 → детский телефон доверия 8-800-2000-122, совет обратиться к взрослым / школьному психологу.
+3. PHQ-9 → 14 баллов, п.9 = 0.
+4. Вопрос о травматическом событии (вход в PC-PTSD-5) → «нет» → пропуск.
+5. GAD-7 → 9 баллов.
+6. Агент объясняет результат без слова «диагноз», рекомендует консультацию психиатра.
+7. Пользователь: «А меня поставят на учёт?» → агент объясняет (добровольное обращение = консультативно-лечебная помощь).
+8. Агент предлагает варианты (ПНД/поликлиника, платно, онлайн) → `book_visit` (мок) → с согласия `send_screening_summary` врачу.
+
+## Сценарий Б — сопровождение после визита (основное демо)
+
+Врач на дашборде нажимает «Подключить пациента», вводит препарат и дату следующего визита.
+
+| День | Приём | Настр. 0–10 | Сон | Алкоголь | Жалобы / свободный текст | Шкалы | Уровень | Действие агента |
+|---|---|---|---|---|---|---|---|---|
+| 1 | да | 4 | 6–8 | нет | — | — | 🟢 | приветствие, напоминание |
+| 2 | да | 4 | 4–6 | нет | тошнота | — | 🟢 | объясняет: частая, обычно проходит за 1–2 нед.; принимать после еды |
+| 3 | да | 4 | 4–6 | нет | тошнота | — | 🟢 | поддержка |
+| 4 | да | 3 | 4–6 | нет | тошнота | — | 🟡 | побочка 3 дня подряд → `raise_alert(yellow)` |
+| 5 | решил не принимать | 3 | 4–6 | нет | «от таблеток только хуже, брошу» | — | 🟡 | объясняет отсроченный эффект; не бросать без врача; `notify_doctor` |
+| 6 | да | 4 | 6–8 | нет | — | — | 🟢 | врач позвонил, пациент продолжает |
+| 7 | да | 4 | 6–8 | нет | — | PHQ-9 = 13, п.9 = 0 | 🟢 | плановый PHQ-9 |
+| 8 | да | 4 | < 4 | 1–2 | — | — | 🟢 | — |
+| 9 | да | 4 | < 4 | больше | — | — | 🟢 | — |
+| 10 | да | 4 | < 4 | больше | «не могу уснуть без пива» | — | 🟡 | сон < 4 ч 3 ночи (F_Y6) + алкоголь 3 дня (F_Y5) → инфо о взаимодействии; `notify_doctor`; `book_visit` раньше |
+| 11 | да | 3 | 4–6 | 1–2 | — | — | 🟡 | (алкоголь продолжается) |
+| 12 | да | 3 | 4–6 | нет | — | — | 🟡 | — |
+| 13 | да | 2 | < 4 | нет | «всё бессмысленно, устал от всего» | внеплановый PHQ-9 = 18, п.9 = 2 | 🔴 | настроение ≤ 3 три дня → внеплановый PHQ-9 → п.9 ≥ 1 → `crisis_protocol` + `raise_alert(red)` |
+
+## Дашборд врача: ещё 7 фейковых пациентов
+
+| Пациент | Возраст | Диагноз | Препарат | День терапии | Статус | Последнее событие |
+|---|---|---|---|---|---|---|
+| Ирина К. | 34 | депрессия | эсциталопрам 10 мг | 21 | 🟢 | PHQ-9 16 → 9 |
+| Дмитрий В. | 41 | ПТСР | сертралин 100 мг | 45 | 🟡 | кошмары, сон < 4 ч 3 ночи |
+| Ольга Н. | 29 | депрессия + тревога | сертралин 50 мг | 10 | 🟢 | тошнота прошла |
+| Сергей П. | 37 | ПТСР | пароксетин 20 мг | 30 | 🟡 | пропуски 3 из 7 дней |
+| Анна Л. | 23 | депрессия | флуоксетин 20 мг | 8 | 🟡 | возраст < 25: усиленный мониторинг; беспокойство |
+| Павел Р. | 45 | депрессия | эсциталопрам 10 мг | 60 | 🟢 | ремиссия, PHQ-9 = 4 |
+| Наталья Ф. | 52 | ПТСР | сертралин 50 мг | 14 | 🟡 | алкоголь 4 из 7 дней |
+| Алексей | 28 | депрессия | сертралин 50 мг | 13 | 🔴 | п.9 PHQ-9 = 2 |
+
+История для графиков у остальных пациентов можно сгенерировать случайно в пределах указанного статуса.
+
+## Порядок демо (≈ 3 мин)
+
+1. Скрининг Алексея → запись к врачу — 40 с
+2. Врач подключает пациента на дашборде — 10 с
+3. День 5: «хочу бросить» → объяснение + алерт — 40 с
+4. День 10: алкоголь + бессонница → запись раньше — 30 с
+5. День 13: внеплановый PHQ-9 → 🔴 → кризисный протокол + карточка алерта на дашборде — 40 с

docs/product/02_hackathon_requirements.md

@@ -0,0 +1,21 @@
+# 02. Кейс SberMed AI и требования к оформлению
+
+Конспект `Кейс_SBERMED AI.pdf` и `Требования к оформлению.pdf` (оригиналы в корне).
+
+## Кейс
+- **Задача:** ИИ-помощник, через который пациент в диалоговом формате взаимодействует с государственной системой здравоохранения в цифровом канале.
+- **Сценарии (выбрать 1–2):** запись к врачу, получение справок, предварительный сбор жалоб и анамнеза, **мониторинг после обращения**, **управление приёмом лекарств**.
+- **ЦА:** граждане РФ старше 18 лет в периметре госсистемы здравоохранения.
+- **Бизнес-эффекты:** снижение операционных издержек, удержание клиентов, удовлетворённость пациентов, рост доли MedTech в B2G.
+- **Ограничения и риски:** 152-ФЗ и обработка медданных; комплаенс и ИБ.
+- **Конкуренты:** ИИ-помощник Genotek, ChatGPT Health (OpenAI).
+- **Критерии оценки:** 1) работоспособность прототипа; 2) функциональность; 3) дизайн презентации и прототипа; 4) оценка клинико-экономических эффектов; 5) описание клиентского пути.
+
+## Требования к оформлению (чек-лист сдачи)
+- [ ] `README.md`: цели и задачи; что реализовано; развёртывание, запуск, использование (окружение, зависимости); входные/выходные данные, API; ограничения и особенности медтематики.
+- [ ] Структура каталогов: код (`/app`), скрипты развёртывания (`Dockerfile`, `docker-compose.yml`), `/tests`, `/docs`, демо-набор данных без ПДн.
+- [ ] Код с комментариями, особенно в алгоритмах обработки медданных; документация интерфейсов.
+- [ ] **Конфигурационные файлы — в отдельной папке.**
+- [ ] Docker для воспроизводимости; команды установки зависимостей.
+- [ ] Презентация (PDF или слайды в репозитории): принцип работы, логика, архитектура.
+- [ ] Решение должно запускаться **и на технике организатора, и на ноутбуках команды** без установки нелицензионного/непредусмотренного ПО.