modified: .gitignore

docs/faq.md

@@ -0,0 +1,85 @@
+# Частые вопросы
+
+## Не получается войти в систему
+
+Проверьте:
+
+- правильность логина;
+- правильность пароля;
+- раскладку клавиатуры;
+- не включен ли `Caps Lock`.
+
+Если проблема сохраняется, обратитесь к администратору системы.
+
+## Почему я не вижу нужный раздел
+
+Доступность разделов зависит от вашей роли.
+
+Например:
+
+- врач работает со сводной;
+- заведующий видит статистику отделения;
+- администратор имеет доступ к административным функциям.
+
+Если у вас несколько ролей, попробуйте переключить роль в верхней части интерфейса.
+
+## Почему кнопка «Заполнить сводную» недоступна
+
+Возможные причины:
+
+- для вашей роли действует ограничение по времени;
+- у вас нет права на создание отчета;
+- текущая роль не предназначена для заполнения сводной.
+
+## Почему система сообщает, что сводная уже создана
+
+Это означает, что за выбранную дату и отделение уже есть отчет.
+
+В этом случае:
+
+1. Откройте существующую сводную.
+2. Проверьте, кто указан ответственным.
+3. При необходимости уточните дальнейшие действия у заведующего или администратора.
+
+## Почему данные за период выглядят слишком большими или слишком маленькими
+
+Сначала проверьте:
+
+- дату;
+- диапазон дат;
+- отделение;
+- выбранную роль.
+
+Чаще всего причина связана с тем, что выбран не тот период, например месяц вместо недели или текущий год вместо одного дня.
+
+## Почему я не могу сохранить отчет
+
+Проверьте:
+
+- заполнены ли обязательные поля;
+- нет ли предупреждения на странице;
+- доступна ли кнопка `Сохранить отчет`;
+- открыт ли отчет в режиме редактирования, а не только просмотра.
+
+## Как понять, за какой период сейчас показаны данные
+
+Ориентируйтесь на блок выбора даты в верхней части страницы.
+
+Именно выбранная там дата или диапазон определяют:
+
+- содержимое сводной;
+- содержимое статистики;
+- выгрузку в Excel.
+
+## Что делать, если отображаются неверные данные
+
+Подготовьте для обращения в поддержку следующую информацию:
+
+- ваше ФИО;
+- роль, под которой вы работаете;
+- отделение;
+- дата или период;
+- краткое описание проблемы;
+- что вы ожидали увидеть на экране.
+
+Это поможет быстрее найти причину и проверить данные.

docs/index.md

@@ -0,0 +1,79 @@
+# Метрика
+
+Добро пожаловать в руководство пользователя системы **«Метрика»**.
+
+Система помогает:
+
+- формировать сводный отчет по отделению;
+- просматривать статистику по отделению или по нескольким отделениям;
+- контролировать нежелательные события;
+- отслеживать пациентов на контроле;
+- работать в пределах своей роли и доступных отделений.
+
+## Для кого предназначена система
+
+Система используется медицинским персоналом и сотрудниками, которые работают с оперативной отчетностью отделений.
+
+В зависимости от вашей роли в системе вам могут быть доступны разные разделы:
+
+- `Врач` — заполнение сводной;
+- `Заведующий отделением` — просмотр статистики и работа со сводными по отделению;
+- `Администратор` — полный доступ, включая административную панель.
+
+Если у вас несколько ролей, нужную роль можно переключить в верхней части интерфейса.
+
+## Как начать работу
+
+1. Откройте страницу входа в систему.
+2. Введите логин и пароль.
+3. После входа вы попадете на стартовую страницу.
+4. Выберите нужный раздел:
+   - `Заполнить сводную`;
+   - `Статистика моего отделения`;
+   - `Панель администратора` — только для администратора.
+
+## Что находится на стартовой странице
+
+На стартовой странице отображаются:
+
+- имя пользователя;
+- текущая дата и время сервера;
+- кнопки перехода к основным разделам;
+- кнопка выхода из системы.
+
+### Кнопка «Заполнить сводную»
+
+Назначение кнопки зависит от вашей роли:
+
+- для `врача` она открывает выбор ответственного и отделения перед переходом к отчету;
+- для `администратора` она открывает форму сводной напрямую;
+- для `заведующего` доступ к сводной определяется рабочим сценарием и выбранной ролью.
+
+Для врача кнопка доступна только в установленный интервал времени. Если кнопка заблокирована, поверх нее отображается подсказка с доступным временем.
+
+## Основные разделы документации
+
+- [Работа со сводной](./reporting.md)
+- [Статистика](./statistics.md)
+- [Частые вопросы](./faq.md)
+
+## Общая логика работы
+
+Система строится вокруг даты и отделения.
+
+Обычно работа выглядит так:
+
+1. Пользователь выбирает нужный раздел.
+2. При необходимости выбирает отделение и ответственного.
+3. Указывает дату или период.
+4. Просматривает данные.
+5. При наличии права сохраняет отчет.
+
+## Полезный совет
+
+Если данные на экране не совпадают с ожидаемыми, в первую очередь проверьте:
+
+- выбранную роль;
+- выбранное отделение;
+- дату или диапазон дат;
+- наличие уже созданной сводной за нужный день.

docs/reporting.md

@@ -0,0 +1,132 @@
+# Работа со сводной
+
+Эта страница описывает, как открыть, проверить и сохранить сводный отчет.
+
+## Что такое сводная
+
+Сводная — это отчет по отделению за выбранную дату или период.
+
+В сводной отображаются:
+
+- показатели отделения;
+- количество поступивших и выбывших пациентов;
+- число пациентов, состоящих в отделении;
+- данные по операциям;
+- нежелательные события;
+- пациенты на контроле.
+
+Состав и доступность полей могут зависеть от роли пользователя и от того, открыт ли отчет только для просмотра или для заполнения.
+
+## Как открыть сводную
+
+### Вариант 1. Со стартовой страницы
+
+1. Нажмите `Заполнить сводную`.
+2. Если откроется окно выбора, укажите:
+   - ответственного;
+   - отделение.
+3. Нажмите `Перейти к заполнению сводной`.
+
+Если сводная за текущую дату уже существует, система предупредит об этом и предложит перейти к уже созданному отчету.
+
+### Вариант 2. Из раздела статистики
+
+1. Откройте `Статистика моего отделения`.
+2. Выберите нужную дату или период.
+3. Нажмите на название отделения в таблице.
+4. Откроется сводная по выбранному отделению и выбранному периоду.
+
+## Что находится на странице сводной
+
+На странице сводной обычно доступны:
+
+- название отделения;
+- выбранная дата или диапазон дат;
+- сводные числовые показатели;
+- поля формы отчета;
+- разделы с пациентами;
+- кнопка `Сохранить отчет`, если редактирование разрешено.
+
+Также на странице может отображаться предупреждение, если отчет за этот день уже был создан другим пользователем.
+
+## Как выбрать дату
+
+В верхней части страницы находится выбор даты.
+
+В зависимости от роли можно выбрать:
+
+- одну дату;
+- диапазон дат.
+
+После выбора периода система обновляет данные на странице.
+
+### Кнопка «Сегодня» и «Текущий год»
+
+Рядом с выбором даты могут быть доступны быстрые действия:
+
+- `Сегодня` — переход к текущей дате;
+- `Текущий год` — переход к периоду с начала года до текущей даты.
+
+## Что проверять перед сохранением
+
+Перед тем как нажать `Сохранить отчет`, проверьте:
+
+- правильность отделения;
+- правильность даты или периода;
+- корректность числовых значений;
+- заполнение обязательных полей;
+- список нежелательных событий;
+- пациентов на контроле, если они должны быть указаны.
+
+## Как сохранить отчет
+
+1. Заполните доступные поля.
+2. Проверьте предупреждения на странице.
+3. Нажмите `Сохранить отчет`.
+
+Если форма заполнена корректно, система сохранит отчет и покажет сообщение об успешном сохранении.
+
+## Когда кнопка сохранения может быть недоступна
+
+Кнопка `Сохранить отчет` может отсутствовать или быть недоступной, если:
+
+- у пользователя нет права на сохранение;
+- отчет открыт только для просмотра;
+- выбран период, для которого редактирование не предусмотрено;
+- отчет уже создан и текущий пользователь не является ответственным за его заполнение.
+
+## Нежелательные события
+
+На странице сводной можно работать с нежелательными событиями.
+
+Обычно пользователь может:
+
+- просмотреть список событий;
+- добавить новое событие;
+- отредактировать существующее;
+- удалить событие, если это разрешено.
+
+Количество нежелательных событий отображается рядом с соответствующей кнопкой.
+
+## Пациенты на контроле
+
+В системе предусмотрен раздел для пациентов, требующих дополнительного внимания.
+
+Пользователь может:
+
+- просматривать список пациентов на контроле;
+- добавлять комментарии;
+- удалять пациента из контроля, если необходимость отпала.
+
+## Если данные выглядят неверно
+
+Если в сводной отображаются неожиданные данные:
+
+1. Проверьте выбранный диапазон дат.
+2. Убедитесь, что выбрано нужное отделение.
+3. Проверьте, не открыта ли уже существующая сводная за другой день.
+4. Обновите страницу и снова выберите дату.
+5. Если проблема сохраняется, сообщите администратору, указав:
+   - отделение;
+   - дату или период;
+   - что именно отображается неверно.

docs/statistics.md

@@ -0,0 +1,108 @@
+# Статистика
+
+Раздел статистики помогает просматривать показатели по отделениям за выбранную дату или период.
+
+## Для чего нужен раздел
+
+В разделе статистики можно:
+
+- оценить показатели работы отделений;
+- сравнить данные по нескольким отделениям;
+- открыть сводную конкретного отделения;
+- просмотреть нежелательные события;
+- посмотреть пациентов на контроле;
+- выгрузить таблицу в Excel.
+
+## Как открыть статистику
+
+1. На стартовой странице нажмите `Статистика моего отделения`.
+2. В верхней части страницы выберите дату или период.
+3. Дождитесь обновления таблицы.
+
+## Как работает выбор периода
+
+В верхней части страницы расположен календарь.
+
+С его помощью можно выбрать:
+
+- одну дату;
+- диапазон дат.
+
+После выбора периода система пересчитывает статистику по выбранному интервалу.
+
+### Быстрые действия
+
+Для быстрого перехода могут использоваться кнопки:
+
+- `Сегодня`;
+- `Текущий год`.
+
+Они помогают быстро открыть самые частые сценарии просмотра данных.
+
+## Что отображается в таблице
+
+В таблице статистики могут присутствовать следующие показатели:
+
+- отделение;
+- количество коек;
+- поступило;
+- выбыло;
+- состоит;
+- средний койко-день;
+- предоперационный койко-день;
+- процент загруженности;
+- процент летальности;
+- количество операций;
+- число умерших;
+- количество медицинского персонала.
+
+В отдельных строках система может показывать:
+
+- групповые заголовки;
+- итоговые строки;
+- индикатор наличия отчета по отделению.
+
+## Как открыть сводную из статистики
+
+1. Найдите нужное отделение в таблице.
+2. Нажмите на его название.
+3. Система откроет страницу сводной по выбранному отделению.
+
+При переходе сохраняется выбранный период, чтобы вы сразу видели данные за тот же интервал.
+
+## Нежелательные события и пациенты на контроле
+
+Напротив отделения могут отображаться дополнительные индикаторы:
+
+- значок нежелательных событий;
+- значок пациентов на контроле.
+
+Нажатие на них открывает отдельное окно с подробностями.
+
+## Выгрузка в Excel
+
+Чтобы скачать статистику:
+
+1. Выберите нужную дату или период.
+2. Нажмите `Сохранить в Excel`.
+3. Дождитесь скачивания файла.
+
+Файл будет сформирован по текущему периоду, который выбран на странице в момент выгрузки.
+
+## Как правильно интерпретировать данные
+
+Перед анализом статистики убедитесь, что:
+
+- выбран корректный период;
+- вы находитесь в нужной роли;
+- данные относятся к нужному отделению;
+- отчет за интересующую дату уже создан, если вы ожидаете увидеть итоговые значения по завершенному дню.
+
+## Когда данные могут отличаться от ожидаемых
+
+Чаще всего причина в одном из следующих факторов:
+
+- выбран не тот диапазон дат;
+- открыта статистика по другому отделению;
+- отчет за нужную дату еще не сформирован;
+- пользователь работает под другой ролью.