modified: .gitignore

docs/index.md

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