# Дневник сна и самочувствия

Сценарий для Telegram и MAX

Версия для согласования врачом, 19.11.2026. Аудитория: взрослые пациенты сомнолога или психиатра, которым в настоящее время подбирается терапия для лечения нарушений сна. Дневник заполняется один раз в день: фиксируются сведения о прошедшей ночи по пунктам исходного файла «Дневник_вашего_сна.pdf», дневное состояние, фактический приём препаратов и нежелательные явления. Задача — отслеживать состояние пациента и его ответ на терапию. Конечная цель — помочь врачу подобрать терапию для нормализации сна, наглядно показывая пациенту и врачу динамику сна и самочувствия на фоне лечения. Это проект дневника наблюдения, а не валидированный диагностический опросник. Состав дополнительных симптомов и правила реагирования утверждает лечащий врач до запуска.

## 1 Задача и формат

### Задачи и формат дневника сна и самочувствия

**Цель** — помочь врачу отслеживать сон и состояние пациентов во время подбора фармакотерапии, сопоставлять изменения с фактическим приёмом препаратов и принимать решения о дальнейшей схеме лечения.

### Задачи

- Ежедневно фиксировать режим, продолжительность и качество сна, дневной сон и ночные пробуждения.
- Отмечать условия подготовки ко сну, использование экранов и время последнего приёма пищи.
- Сохранять названия и фактические дозы препаратов, принятых утром, днём, вечером и перед сном.
- Собирать комментарии о симптомах, изменениях самочувствия и настораживающих ощущениях.
- Автоматически рассчитывать суммарное ночное бодрствование, время в постели, общее время и эффективность сна.
- Показывать врачу ответы и графики всех его пациентов в одном кабинете, с возможностью выбрать пациента и период наблюдения.
- Отмечать на графиках даты начала и изменения терапии для сопоставления с динамикой состояния.

### Формат для пациента

Дневник заполняется в боте Telegram или MAX один раз в день после окончательного пробуждения, в удобное время. Если пациент не успел утром, он может заполнить его днём или вечером.

Перед началом пациент выбирает дату утра, которым закончился сон. Бот явно показывает период: например, «Ночь с 19 на 20 ноября». Во всех вопросах подставляются конкретные даты вместо слова «вчера».

Опрос содержит 17 пунктов и ненумерованный автоматический итог ночного бодрствования. Порядок вопросов фиксирован. Используются кнопки, выбор времени, ввод продолжительности в минутах и короткие текстовые поля. Уточнения появляются только при необходимости: например, при наличии дневного сна или ночных пробуждений. Расчётные показатели не требуют ответа пациента.

Перед сохранением бот показывает выбранную ночь и позволяет исправить ответы. За одну ночь сохраняется одна запись с возможностью редактирования.

### Напоминания

Пациент выбирает удобное время напоминания с учётом своего часового пояса. В сообщении доступны действия: «Заполнить», «Напомнить позже» и «Пропустить». После сохранения записи повторное напоминание за этот период отменяется. Уведомление не содержит названий препаратов и медицинских сведений.

### Формат для врача

В едином кабинете доступны:

- список пациентов и даты последних заполнений;
- все ответы по дням и просмотр отдельных записей;
- графики показателей сна;
- сведения о фактическом приёме препаратов и комментарии пациента;
- история изменений терапии на общей временной шкале;
- выбор периода и выгрузка данных.

### Правила учёта дат

Основная дата записи — дата окончательного утреннего пробуждения. Даты и время событий сохраняются отдельно от времени заполнения анкеты.

Ночной сон относится к выбранной ночи. Дневной сон и самочувствие — к дню перед ней. Приём препаратов фиксируется по фактическим датам, включая приём перед сном после полуночи.

### Границы работы

Дневник собирает данные и помогает врачу оценивать динамику. Он не ставит диагноз, не определяет причину симптомов и не меняет назначения автоматически. Коррекцию терапии выполняет врач.

До начала наблюдения пациенту сообщают, как часто врач просматривает записи и куда обращаться при резком ухудшении состояния.


## 2 Первое подключение

1. Пациент открывает личный диалог по индивидуальной ссылке/коду приглашения врача.
2. Бот объясняет цель и порядок работы, показывает сведения о хранении и доступе к данным, получает необходимое согласие. Отказ не создаёт медицинскую запись.
3. Пациент выбирает часовой пояс и время напоминания, например 20:30.
4. Пациент ежедневно переписывает и заполняет схему приёма по актуальным назначениям врача: название, форма, доза с единицами, путь введения, расписание, дата начала; отдельно — приём по потребности. Схема может меняться врачом, поэтому при изменениях пациент указывает новую схему и дату изменения. Заполнение схемы не означает самостоятельного изменения назначений.

5. Предусмотрена отдельная графа «Дополнения», куда пациент вносит сведения о появившихся симптомах: описание, время появления, продолжительность и выраженность.
6. Пациент видит, кто и когда просматривает записи и как связаться с клиникой. Не обещать круглосуточного наблюдения.

Текст приветствия:
«Этот дневник поможет вам и врачу видеть изменения сна и самочувствия во время подбора схемы терапии и лечения. Заполняйте его один раз в день после окончательного пробуждения, в удобное время. Если утром не успели, заполните позже. Выберите дату утра, которым закончился ваш сон. Бот покажет конкретную ночь и день, к которым относятся вопросы; время заполнения не изменит выбранный период. Примерных значений достаточно. Бот сохраняет ответы и не меняет назначения. Время просмотра записей врачом указано в разделе “Связь с врачом”. При резком ухудшении не ждите ответа в дневнике».

## 3 Напоминания

Основное уведомление: «Пора заполнить дневник за ночь с {дата начала} на {дата пробуждения}».
Кнопки: [Заполнить] [Через 30 минут] [Пропустить эту ночь].

- Одно основное напоминание в выбранное местное время.
- Одно повторное через 60 минут при отсутствии ответа, если оно попадает в разрешённое пациентом время. Ночных повторов нет.
- «Через 30 минут» заменяет повторное уведомление, не создаёт дополнительную цепочку.
- После сохранения или пропуска отменяются ожидающие уведомления за выбранную ночь. Заполнение старой ночи не отменяет напоминание за другую незаполненную ночь. Пауза отключает будущие напоминания до возобновления.
- Частично заполненный опрос продолжается с последнего вопроса.
- Пауза и изменение времени доступны в меню. При блокировке бота уведомления останавливаются.
- Уведомление не содержит диагноза, названий препаратов или ответов пациента.
- Если подключены оба мессенджера, напоминания приходят только в выбранный основной канал.

## 4 Сценарий опроса

### Дневник сна и самочувствия

Заполняйте дневник один раз в день после окончательного пробуждения, в удобное время. Если утром не успели, заполните позже.

### Пациент и дата регистрации

Пациент выбирает свою запись в демонстрации; в рабочем дневнике пациент определяется по персональному приглашению.

**Дата регистрации**

Чтобы не запутаться в датах, укажите дату утра, которым закончился ваш сон. Если заполняете дневник позже, выбирайте дату пробуждения, а не дату заполнения.

Ниже приведён пример вопросов для ночи с 19 на 20 ноября. Даты в вопросах подставляются по выбранной дате пробуждения.

### Вопросы

**1. Спали ли вы вчера днём?**

Имеется в виду день перед ночью, за которую вы заполняете дневник. Если вы спали днём, укажите ниже время начала и продолжительность сна.
[Нет] [Да]

Если да:

- Время начала дневного сна
- Продолжительность дневного сна в минутах

Если эпизодов было несколько — кнопка «Добавить дневной сон». Общая продолжительность рассчитывается автоматически.

**2. Время отхода ко сну**

Укажите время, когда вы переоделись в пижаму или удобную одежду для сна и легли в постель.
Укажите время: часы и минуты.


**3. Подготовили ли вы помещение спальни ко сну?**

Например: проветрили, убрались, приглушили свет, закрыли шторы, уменьшили шум, настроили комфортную температуру.
[Нет] [Да]

**4. Приём пищи перед сном**

Был ли приём пищи перед сном?
[Нет] [Да]

Если да: укажите дату и время последнего приёма пищи и выберите, каким он был.
[Лёгкий перекус] [Обычный приём пищи] [Плотный приём пищи] [Не помню]

Если нет: дополнительные поля скрываются и не участвуют в проверках.

**5. Употребляли ли вы алкоголь перед этой ночью?**

Учитывайте день и вечер перед сном.
[Нет] [Да]

Если да: **Какой алкоголь вы употребляли?**
[Пиво или сидр] [Вино или игристое] [Крепкие алкогольные напитки] [Коктейли] [Несколько видов алкоголя] [Другое] [Не помню]

При выборе «Другое» появляется поле «Уточните напиток».

**6. Экраны перед сном**

За сколько времени до того, как лечь в постель, вы закончили пользоваться экраном телефона, планшета или компьютера?
[Непосредственно перед тем, как лечь в постель] [15 минут] [30 минут] [1 час] [2 часа и более] [Указать другое время] [Не пользовался(-ась) экранами в этот вечер]

Смотрели ли вы в экран телефона или планшета уже лёжа в постели?
[Нет] [Да]

Если да: **Продолжительность просмотра в минутах**.

**7. Сколько времени вам понадобилось, чтобы заснуть?**
Укажите примерное количество минут с момента, когда вы легли в постель, до засыпания. Если не помните, этот вопрос можно пропустить.

**8. Вы просыпались ночью?**
[Нет] [Да]

Если да: **Сколько раз?**

Для каждого пробуждения укажите:
- Время пробуждения.
- Продолжительность бодрствования в минутах.

Появляется отдельная карточка для каждого эпизода, до 10 карточек. Если не помните время, можно указать только продолжительность. При ответе «Нет» количество пробуждений и ночное бодрствование равны нулю.

**Итог**

Ночное бодрствование — {суммарная длительность} {минута / минуты / минут}.

Рассчитывается автоматически.

**9. Время пробуждения**
Укажите время последнего пробуждения, после которого вы уже не засыпали.

**10. Время в постели**

Укажите, сколько минут вы оставались в постели после последнего пробуждения, прежде чем встать.

Количество минут вводится пациентом. Автоматическое заполнение отключено; неизвестное значение не заменяется нулём.

**11. Время подъёма с постели**

Укажите время, когда вы окончательно встали с постели.
[Сразу после пробуждения] [Указать время]

**12. Общее время сна**
Рассчитывается автоматически по формуле:

(Время подъёма из пункта 11 − время отхода ко сну из пункта 2) − (время засыпания из пункта 7 + ночное бодрствование из пункта 8 + время в постели после пробуждения из пункта 10).

Время в постели — от отхода ко сну до окончательного подъёма, с учётом дат.

Продолжительность бодрствования после засыпания включает ночные пробуждения и время без сна в постели после окончательного пробуждения.

Пациент ничего не рассчитывает. В пункте 12 показывается только общее время сна. Результат обновляется при изменении исходных ответов; недостающие данные перечисляются отдельно и не заменяются нулями.

**13. Оценка вашего сна**

Как вы оцениваете свой сон этой ночью? Выберите один из вариантов ниже.

[1 — очень плохой сон]
[2 — плохой сон]
[3 — не очень плохой сон]
[4 — хороший сон]
[5 — отличный сон]

**14. Рекомендованная схема приёма**

Укажите, какие препараты и в каких дозах вы фактически принимали 19 ноября. Распределите приём по времени суток: утром, днём, вечером и перед сном. Дозу указывайте с единицами измерения.

- **Утром:** название препарата и доза.

- **Днём:** название препарата и доза.

- **Вечером:** название препарата и доза.

- **Перед сном:** название препарата и доза.

В каждом разделе можно добавить несколько препаратов или выбрать «Не принимал(а)».

Дозу указывайте с единицами измерения, например: «25 мг» или «½ таблетки по 10 мг».

Если препарат перед сном принят уже после полуночи, укажите фактические дату и время. Один и тот же приём не нужно записывать повторно.

**15. Комментарии о самочувствии**

Какие симптомы или изменения самочувствия вы заметили? Было ли что-то, что вас насторожило?

Свободное поле для ответа.

[Добавить комментарий] [Ничего не насторожило]

**16. Были ли 19 ноября новые или усилившиеся неприятные ощущения?**
[Нет] [Да]. При «Да» — выбор нескольких пунктов:
сонливость/заторможенность; головокружение/неустойчивость; тошнота; сухость во рту; необычное возбуждение/внутреннее беспокойство; другое.
Список адаптирует врач к препаратам. Для каждого выбранного: [1 — лёгкое] [2 — мешало делам] [3 — сильно мешало], примерное начало, сохраняется ли сейчас. Эти события не считать автоматически вызванными препаратом. Сонливость в этом блоке и вопрос 9 не суммировать.

**17. Хотите добавить сведения об обстоятельствах дня 19 ноября?**
[Нет, сохранить] [Добавить комментарий]. Подсказка: «Например, стресс, болезнь, алкоголь, необычно поздний кофе или другое изменение режима». Свободный текст необязателен; кнопки «Алкоголь», «Поздний кофе», «Сильный стресс», «Болезнь», «Ничего из этого» допустимы как быстрые отметки. Для более точного анализа врач может включить структурированные вопросы о количестве и времени, но это увеличит длину анкеты.

### Проверка и сохранение

Показать сводку с выбранной ночью, днём наблюдения, ответами и результатами расчётов. Неизвестные значения обозначаются как неизвестные, а не как нули.

**Проверьте: запись относится к ночи с 19 на 20 ноября. Дневной сон и самочувствие — за 19 ноября; препараты — по фактическим датам приёма.**

[Сохранить] [Исправить ответы] [Изменить дату]

После успешного сохранения: «Дневник за ночь с 19 на 20 ноября сохранён. Спасибо». Запись становится доступна врачу в кабинете. Не писать «Врач получил уведомление» или «Врач просмотрел запись», если соответствующее действие не подтверждено.

Время фактического заполнения сохраняется автоматически и не меняет выбранный период. Если запись за эту ночь уже существует, бот предлагает исправить её. Исправления сохраняют историю.

## 5 Реагирование на ухудшение

### Основания для обращения

Сведения о новых симптомах и настораживающих изменениях пациент сообщает в пункте 15 «Комментарии», в графе «Дополнения» и в дополнительном пункте 16 о новых или усилившихся неприятных ощущениях. Дополнительный пункт 17 позволяет сообщить другие обстоятельства дня. Эти сведения сохраняются вместе с датой дня, к которому относятся, и фактическим временем отправки. Если пациент указал время появления, продолжительность и выраженность симптома, они сохраняются без изменения смысла.

Анкета содержит 17 пунктов и ненумерованный автоматический итог ночного бодрствования. В пункте 16 выраженность каждого выбранного неприятного ощущения оценивается от 1 до 3; сохраняются примерное начало и наличие симптома в момент ответа. Это отдельные оценки событий, а не общий балл состояния. Самостоятельной шкалы дневной сонливости и оценки суицидального риска в текущем тексте нет.

До запуска врач определяет, какие сообщения требуют ускоренного просмотра, кто отвечает за их обработку, в какое время просматриваются записи и как пациент связывается с клиникой. Отсутствие комментария или выбор «Ничего не насторожило» не подтверждают отсутствие всех возможных нежелательных явлений.

### Действия пациента и бота

В меню постоянно доступна кнопка «Мне резко хуже». Она не зависит от даты заполняемого дневника: обращение о текущем ухудшении сохраняется отдельным событием с фактическими датой и временем.

При нажатии кнопки бот сразу показывает утверждённые врачом инструкцию и контакты, не требуя закончить опрос. Базовый текст для согласования: «Если состояние тяжёлое или быстро ухудшается, обратитесь за срочной медицинской помощью. Не ждите ответа в дневнике». Конкретные маршруты помощи и контакты задаются для региона и профиля пациентов до запуска.

Обращение дополнительно появляется в кабинете врача. Система отдельно хранит факт создания обращения, результат доставки уведомления, просмотр и обработку ответственным. Сбой доставки не должен отображаться пациенту как успешное уведомление врача. Сообщение «Врач просмотрел обращение» допустимо только после подтверждённого просмотра.

### Ограничения наблюдения

Пациент видит фактический режим просмотра дневника. Если круглосуточного наблюдения нет, бот сообщает об этом прямо. Автоматическое распознавание свободного текста, если его добавят, не является единственным способом обращения за помощью и не гарантирует выявление всех тревожных сообщений. Для выраженных неприятных ощущений из дополнительного пункта 16 врач заранее определяет правила просмотра и уведомления; балл 3 сам по себе не задаёт универсальный медицинский порог.

Бот фиксирует фактический приём препаратов и помогает связаться с врачом. Он не предлагает самостоятельно отменять препараты, менять дозы или схему лечения. Новые диагностические вопросы и медицинские пороги не добавляются в анкету без согласования с врачом.

## 6 Даты и автоматические расчёты

### 6.1 Единая дата записи

Основная дата записи D — дата окончательного пробуждения, выбранная пациентом. Она не определяется временем отправки анкеты и не меняется, если пациент заполнил её днём, вечером или задним числом. За одну ночь хранится одна запись с историей исправлений.

Для примера D = 20 ноября: название записи — «Ночь с 19 на 20 ноября»; дневной сон и самочувствие относятся к 19 ноября; окончательное пробуждение — к 20 ноября. Выбранный период показывается до вопросов и перед сохранением. Во всех вопросах вместо относительного слова «вчера» подставляется конкретная дата.

Каждое время сохраняется вместе с датой и часовым поясом пациента. Отдельно фиксируются время создания, последнего изменения и отправки записи. При смене часового пояса старые события сохраняют исходные даты и смещение времени.

Отход ко сну может произойти 19 ноября в 23:00 или 20 ноября в 01:00. Дата подтверждается пациентом; её нельзя определять только по тому, что часы подъёма меньше часов отхода ко сну. То же правило действует для еды, дневного сна, пробуждений и приёма препаратов.

### 6.2 Какие ответы участвуют в расчётах

- Пункт 1: начало и продолжительность каждого эпизода дневного сна в день перед выбранной ночью. Сумма эпизодов хранится отдельно от ночного сна.
- Пункт 2: дата и время отхода в кровать для ночного сна.
- Пункт 7: время засыпания в минутах. Для расчёта это длительность от события пункта 2 до предполагаемого засыпания. Если пациент считает её от более позднего момента, итог нельзя считать сопоставимым без уточнения смысла ответа.
- Пункт 8: количество ночных пробуждений и продолжительность каждого эпизода до окончательного пробуждения. Временные отметки эпизодов сохраняются, если пациент их помнит.
- Пункт 9: дата и время окончательного пробуждения, после которого пациент уже не засыпал.
- Пункт 10: длительность бодрствования в постели после пробуждения, введённая пациентом в минутах.
- Пункт 11: дата и время окончательного подъёма с постели. При выборе «Сразу после пробуждения» используется значение пункта 9.

Итог ночного бодрствования и пункт 12 рассчитываются автоматически. Пункт 10 заполняется пациентом вручную в минутах; система не подставляет вместо него разницу времени.

### 6.3 Формулы

Все длительности рассчитываются в минутах по полным датам и времени событий.

**Время в постели = время окончательного подъёма из пункта 11 − время отхода ко сну из пункта 2.**

**Ночное бодрствование из пункта 8 = сумма продолжительностей всех пробуждений из пункта 8.**

**Утреннее бодрствование в постели из пункта 10 = продолжительность в минутах, введённая пациентом.**

Разница между временем подъёма и последним пробуждением используется для проверки согласованности ответов. При расхождении бот предлагает проверить значения; ручной ответ не заменяется автоматически. Неизвестное значение не равно нулю.

Поле 10 «Время в постели» обозначает период после пробуждения. Расчётный показатель «Всего в постели» обозначает полный интервал от отхода ко сну до подъёма.

**Продолжительность бодрствования после засыпания = ночное бодрствование из пункта 8 + утреннее бодрствование из пункта 10.**

**Общее время сна из пункта 12 = время в постели − (время засыпания из пункта 7 + продолжительность бодрствования после засыпания).**

**Эффективность сна = общее время сна / время в постели × 100%.** Рассчитывается только при положительном времени в постели и наличии всех необходимых значений.

Утреннее бодрствование не включается повторно в карточки ночных пробуждений. Дневной сон не входит в общее время ночного сна и эффективность ночного сна. Оценка качества сна из пункта 13 сохраняется как самостоятельный ответ от 1 до 5, без изменения подписей шкалы.

### 6.4 Неполные и противоречивые ответы

При ответе «Не просыпался(-ась)» количество пробуждений и ночное бодрствование равны нулю. Ответ «Не помню» не равен нулю. Если неизвестно время начала отдельного пробуждения, но известна его продолжительность, длительность эпизода можно использовать в сумме.

Если число эпизодов и количество заполненных карточек не совпадают либо хотя бы одна продолжительность неизвестна, итог ночного бодрствования считается неполным. Зависимые показатели сна и эффективности не рассчитываются как точные значения.

В анкете предусмотрено до 10 карточек пробуждений. Если пациент сообщает о большем количестве, система сохраняет фактический ответ и показывает, что данных для полного расчёта недостаточно. Нельзя заменять большее количество на 10 или считать сумму первых 10 полным ночным бодрствованием. Расширение числа карточек требует отдельного согласования.

При неверном порядке событий, пересечении эпизодов, отрицательном времени сна или бодрствовании, превышающем время в постели, бот предлагает проверить конкретные ответы. Числа не исправляются и не обрезаются молча. Нулевой сон фиксируется только по согласованным и подтверждённым ответам пациента; отсутствие записи не означает отсутствие сна.

### 6.5 Учёт приёма препаратов

Пункт 14 содержит фактические приёмы по разделам «Утром», «Днём», «Вечером», «Перед сном». Для каждого препарата сохраняются название, введённая доза с единицами, фактическая дата и, если указано, время приёма. Несколько препаратов в одном разделе хранятся отдельными строками. Исходный текст ответа сохраняется.

Приём перед сном после полуночи относится к той ночи, перед которой препарат был принят, но сохраняет фактическую календарную дату. Например, приём 20 ноября в 00:30 перед сном относится к записи за ночь с 19 на 20 ноября.

Один приём имеет одну запись в базе и не должен повторно учитываться в следующем дневнике. Система связывает его с соответствующей ночью и помечает как уже учтённый. При этом похожие приёмы нельзя автоматически объединять только по совпадению названия, дозы и времени.

Пациент ежедневно указывает схему и фактический приём согласно разделам 2 и 4. Предыдущие ответы не считаются подтверждением нового приёма. Выбор «Не принимал(а)» не равен пропуску назначенной дозы без сравнения с подтверждённым назначением. Изменение, сообщённое пациентом, сохраняется как его сообщение и не подменяет подтверждённое назначение врача.

### 6.6 Проверочные примеры

Пример 1: отход ко сну 19 ноября в 23:00; подъём 20 ноября в 07:00; засыпание 150 минут; ночные пробуждения суммарно 60 минут; окончательное пробуждение в 07:00. В постели 480 минут, сон 270 минут, эффективность 56,25%.

Пример 2: те же данные, но окончательное пробуждение в 06:30 и подъём в 07:00. Утреннее бодрствование 30 минут; общее бодрствование после засыпания 90 минут; сон 240 минут; эффективность 50%.

Пример 3: отход ко сну 20 ноября в 01:00; подъём в 08:00; засыпание 20 минут; два пробуждения по 10 минут; окончательное пробуждение в 07:40. В постели 420 минут; ночное бодрствование 20 минут; утреннее 20 минут; сон 360 минут; эффективность 85,71%. Заполнение этой анкеты 21 ноября не меняет дату ночи.

## 7 Что видят врач и пациент

### Список пациентов

Врач видит своих пациентов, дату последней заполненной ночи, фактическое время отправки, число записей за выбранный период, незавершённые анкеты и обращения, требующие просмотра. Позднее заполнение отличается от отсутствия записи. Сам пропуск не считается признаком ухудшения.

### Ответы и графики

В карточке пациента доступны все 17 пунктов в согласованном порядке, автоматические итоги, исходные ответы и результаты расчётов. Для выбранной ночи можно открыть отдельные эпизоды дневного сна и ночных пробуждений, фактические приёмы препаратов и комментарии.

На графиках отображаются время отхода ко сну, окончательного пробуждения и подъёма; время в постели; длительность засыпания; количество пробуждений; ночное и утреннее бодрствование; общее время и эффективность сна; качество сна от 1 до 5; суммарный дневной сон.

Подготовка помещения, последний приём пищи и его тип, использование экранов до отхода в кровать и в кровати показываются отдельными отметками или строками дневной таблицы. Ответ «2 часа и более» остаётся диапазоном, а «Экранами не пользовался(-ась)» не превращается в числовой интервал.

Комментарии, графа «Дополнения» и ответы на пункты 16–17 показываются по датам. Для неприятных ощущений из пункта 16 сохраняются тип, выраженность от 1 до 3, примерное начало и наличие в момент ответа. Показатель сонливости из этого списка не суммируется с другими ответами и не превращается в самостоятельную шкалу дневной сонливости. Вопрос 8 посвящён пробуждениям: его значения не складываются с оценками симптомов. Графики дневной сонливости и выбранного симптома по шкале 0–3 в текущем тексте не предусмотрены.

### Сопоставление с терапией

На общей временной шкале отображаются фактические приёмы, сообщённые изменения схемы и подтверждённые врачом назначения. Даты начала терапии, изменения доз и другие вмешательства имеют историю; предыдущие значения не перезаписываются. Источник отметки обозначается: «сообщил пациент» или «подтвердил врач».

Врач выбирает любой период, в том числе 7, 14 или 28 дней, и сравнивает интервалы до и после изменения терапии. Для каждого среднего значения показывается число доступных наблюдений. Пропуски и неполные расчёты не заменяются нулями. При усреднении времени суток учитывается переход через полночь: 23:00 и 01:00 не дают среднее 12:00.

Система показывает динамику и совпадение событий по времени. Причину изменений и необходимость коррекции терапии оценивает врач. Экспорт содержит исходные ответы, расчётные значения, их полноту, даты событий и заполнения, часовой пояс и сведения о версии расчётов.

### Просмотр пациентом

Пациент может открыть собственные сохранённые записи и понятные графики сна. Он не видит данные других пациентов. Доступ к редактированию, сроки исправления и отображение рекомендаций врача определяются до запуска. Все исправления сохраняют историю.

## 8 Реализация для Telegram и MAX

### Общая система

Telegram и MAX используют одну серверную систему с общей базой пациентов, единым набором вопросов из раздела 4, расчётами и кабинетом врача. Связывание двух аккаунтов выполняется по подтверждённому приглашению. Совпадение имени в мессенджерах не является основанием для объединения пациентов.

Пациент выбирает основной канал для напоминаний. Запись, сохранённая в одном мессенджере, видна в другом после подтверждённого связывания. Одновременное сохранение одной ночи не создаёт две записи. Врач открывает данные в едином кабинете независимо от канала заполнения.

### Пошаговое заполнение

Сначала выбирается ночь, затем задаются вопросы строго в порядке раздела 4. Итог ночного бодрствования и пункт 12 заполняются системой. Пункт 10 заполняется пациентом вручную в минутах. Дополнительные вопросы 16–17 задаются после пункта 15 и до единого блока проверки и сохранения. Карточки дневного сна и пробуждений появляются по ответам пациента. Введённые значения сохраняются в черновике; после перерыва опрос продолжается с последнего незавершённого места.

Перед сохранением показываются выбранная ночь, ответы и результаты расчётов. Исправление исходного ответа пересчитывает зависимые показатели. Изменение даты существующей записи требует явного подтверждения и проверки, нет ли уже записи за целевую ночь.

### Напоминания и даты

Каждое напоминание привязано к конкретной ночи и часовому поясу пациента. Текст уведомления должен показывать нужный период, например «Пора заполнить дневник за ночь с 19 на 20 ноября». Поздний ответ не переключает анкету на другую ночь автоматически.

Кнопка «Через 30 минут» переносит ожидающее уведомление, а не создаёт вторую цепочку. Сохранение, пропуск выбранной ночи или пауза отменяют соответствующие ожидающие уведомления в обоих каналах. Заполнение старой ночи не отменяет напоминание за другую незаполненную ночь. При отправке и повторе применяется разрешённое пациентом время.

### Данные и доступ

Хранятся пациент и его врач; согласие; связанные аккаунты; часовой пояс; параметры напоминаний; дата ночи; исходные ответы; эпизоды сна и пробуждений; сведения о еде, алкоголе и экранах; приёмы препаратов; сообщённые схемы и подтверждённые назначения; комментарии и дополнения; рассчитанные показатели; обращения об ухудшении; история исправлений и доставки.

База данных защищена; врач имеет доступ только к своим пациентам, пациент — к собственным записям. Медицинские сведения не направляются в групповые чаты или текст обычного напоминания. Права доступа, хранение, удаление, резервное копирование и журналирование действий согласуются с ответственным клиники до подключения реальных пациентов. Код пациента вместо ФИО не делает сведения анонимными.

## 9 Проверка перед запуском

### Даты и расчёты

1. Выбор сегодняшней, вчерашней и другой даты; утреннее, дневное, вечернее и позднее заполнение одной ночи. Во всех случаях сохраняется выбранный период.
2. Отход ко сну до и после полуночи; подтверждение фактических дат; переход месяца и года; сохранение часового пояса.
3. Несколько эпизодов дневного сна, их сумма и отсутствие включения в ночной сон.
4. Отсутствие ночных пробуждений; от 1 до 10 эпизодов; несовпадение числа карточек; неизвестное время при известной длительности; неизвестная длительность; сообщение о более чем 10 эпизодах.
5. Подъём сразу после окончательного пробуждения и через некоторое время. Утреннее бодрствование учитывается один раз; пункт 10 вводится вручную, а согласованность проверяется по времени пробуждения и подъёма.
6. Все примеры раздела 6.6; неполные ответы; пересекающиеся эпизоды; отрицательные длительности; невозможное общее время сна. Система не подставляет нули вместо неизвестных данных.

### Препараты и симптомы

7. Несколько препаратов в каждом из четырёх периодов; доза с единицами; «Не принимал(а)»; фактический приём перед сном после полуночи; предотвращение повторного учёта в соседней записи.
8. Ежедневное изменение схемы со слов пациента сохраняется с датой и источником. Оно не становится автоматически назначением врача и не изменяет предыдущие записи.
9. Комментарий, дополнения и ответы на дополнительные вопросы 16–17 сохраняются с правильным днём наблюдения и временем отправки. В пункте 16 поддерживаются несколько симптомов, отдельная выраженность 1–3, время появления и сохранение симптома; баллы не складываются в общий показатель. Текущая кнопка «Мне резко хуже» не привязывается к старой ночи, выбранной для анкеты.
10. Инструкция пациенту доступна при отсутствии врача в сети и при сбое доставки уведомления. Нет ложного сообщения о просмотре или обещания немедленного ответа.

### Сохранение и доступ

11. Продолжение черновика; повторное нажатие «Сохранить»; редактирование; смена даты; одновременное заполнение в двух мессенджерах. За одну ночь остаётся одна запись с историей версий.
12. Основное и повторное напоминания, перенос на 30 минут, пропуск и пауза. Сохранение старой ночи не отменяет уведомление за новую.
13. Один пациент в двух подтверждённо связанных каналах видит один дневник. Пациент и врач не получают доступа к чужим данным.
14. Таблица, графики и выгрузка показывают одинаковые исходные данные, расчёты и даты. Отсутствующие показатели явно обозначены; средние содержат число наблюдений.
15. Пациент видит собственную историю и графики в пределах своих прав. Статусы сохранения и доставки отражают фактический результат операции.

После проверок проводится пилот с добровольцами. Измеряются время заполнения, доля завершённых анкет, ошибки выбора дат и затруднения при вводе пробуждений и препаратов. Изменение содержания или порядка 17 пунктов после пилота согласуется с врачом.

## 10 Основания и состояние реализации

### Основания

Основа сценария — текст врача с разделами 1–4, актуальными вопросами и автоматическими итогами. Показатели сна и шкала его качества основаны на документе «Дневник_вашего_сна.pdf». Правила дат и расчётов определены в разделах 4 и 6.

Документация мессенджеров: Telegram — https://core.telegram.org/bots; MAX — https://dev.max.ru. Её актуальность проверяется перед подключением; медицинское содержание определяет врач.

### Состояние реализации

Подготовлены сценарий и требования. Существующий демонстрационный прототип содержит вымышленные данные и хранит изменения в браузере. Текст текущей редакции и рабочая форма — отдельные части: публикация сценария не подключает сбор ответов реальных пациентов.

Подготовлен код отдельной серверной версии: вход врача и пациента, создание пациентов, одноразовые приглашения на 48 часов, отзыв приглашений, отключение доступа, общая база записей и история исправлений. Этот код проверен локально и ещё не размещён на сервере. Демонстрационный адрес по-прежнему хранит изменения в браузере; настоящие приглашения в нём недоступны.

Рабочие боты Telegram/MAX, отправка напоминаний и обработка обращений пока не подключены.

Вопросы 16–17 расположены перед единым блоком сохранения. Приветствие, напоминания и расчёты используют выбранную ночь; фактическое время заполнения хранится отдельно.

Далее нужны утверждённые правила реагирования и контакты клиники, условия обработки данных, сервер и защищённое хранилище, подключение ботов, реализация кабинета и анкеты, проверки раздела 9 и пилот.
