modified: .gitignore

docs/reporting.md

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