edit readme

README.md

@@ -1,3 +1,1302 @@
-# lab_14
+# Руководство пользователя
 
-Документы по работе 14
+# Информационная система «Система обучения и аттестации сотрудников ресторанного бизнеса»
+
+---
+
+> [!NOTE]
+> Настоящее руководство предназначено для сотрудников, администраторов и руководителей ресторанного бизнеса, использующих информационную систему обучения и аттестации персонала.
+
+<details>
+<summary>Краткое описание системы</summary>
+
+Информационная система предназначена для автоматизации процессов обучения и аттестации сотрудников ресторанного бизнеса.
+
+Система включает:
+
+* мобильное приложение для сотрудников;
+* административную web-панель для администраторов и руководителей;
+* систему управления курсами;
+* систему тестирования и аттестации;
+* инструменты аналитики и отчетности.
+
+</details>
+
+---
+
+# Аннотация
+
+Настоящий документ является руководством пользователя информационной системы «Система обучения и аттестации сотрудников ресторанного бизнеса».
+
+Документ предназначен для сотрудников ресторанов, администраторов системы и руководителей подразделений.
+
+Руководство содержит сведения о назначении программного продукта, требованиях к окружению, порядке работы с административной панелью и мобильным приложением, а также описание основных операций, выполняемых пользователями системы.
+
+---
+
+# Содержание
+
+1. [Введение](#1-введение)
+
+   * 1.1 [Область применения](#11-область-применения)
+   * 1.2 [Краткое описание возможностей](#12-краткое-описание-возможностей)
+   * 1.3 [Уровень подготовки пользователя](#13-уровень-подготовки-пользователя)
+   * 1.4 [Перечень эксплуатационной документации](#14-перечень-эксплуатационной-документации)
+
+2. [Назначение и условия применения](#2-назначение-и-условия-применения)
+
+   * 2.1 [Назначение продукта](#21-назначение-продукта)
+   * 2.2 [Роли пользователей](#22-роли-пользователей)
+   * 2.3 [Условия применения](#23-условия-применения)
+
+3. [Установка](#3-установка)
+
+4. [Подготовка к работе](#4-подготовка-к-работе)
+
+   * 4.1 [Требования к окружению](#41-требования-к-окружению)
+   * 4.2 [Доступ к системе](#42-доступ-к-системе)
+   * 4.3 [Вход в программу](#43-вход-в-программу)
+   * 4.4 [Главное меню административной панели](#44-главное-меню-административной-панели)
+   * 4.5 [Порядок проверки работоспособности](#45-порядок-проверки-работоспособности)
+   * 4.6 [Выход из программы](#46-выход-из-программы)
+
+5. [Описание операций](#5-описание-операций)
+
+   * 5.1 [Работа с сотрудниками](#51-работа-с-сотрудниками)
+   * 5.2 [Работа с обучающими курсами](#52-работа-с-обучающими-курсами)
+   * 5.3 [Работа с тестами](#53-работа-с-тестами)
+   * 5.4 [Назначение обучения](#54-назначение-обучения)
+   * 5.5 [Работа сотрудника в мобильном приложении](#55-работа-сотрудника-в-мобильном-приложении)
+   * 5.6 [Прохождение тестирования](#56-прохождение-тестирования)
+   * 5.7 [Просмотр аналитики и отчетов](#57-просмотр-аналитики-и-отчетов)
+   * 5.8 [Настройки и профиль пользователя](#58-настройки-и-профиль-пользователя)
+
+6. [Аварийные ситуации](#6-аварийные-ситуации)
+
+7. [Рекомендации по освоению](#7-рекомендации-по-освоению)
+
+8. [Термины и сокращения](#8-термины-и-сокращения)
+
+9. [Контакты](#9-контакты)
+
+10. [Лист регистрации изменений](#10-лист-регистрации-изменений)
+
+---
+
+# 1. Введение
+
+## 1.1 Область применения
+
+Настоящий документ предназначен для пользователей информационной системы «Система обучения и аттестации сотрудников ресторанного бизнеса» (далее — Система).
+
+Система используется для организации обучения персонала ресторанов, управления учебными курсами, проведения аттестации сотрудников и контроля результатов обучения.
+
+Доступ к системе осуществляется посредством административной web-панели и мобильного приложения.
+
+---
+
+## 1.2 Краткое описание возможностей
+
+Система обеспечивает выполнение следующих функций:
+
+* управление учетными записями сотрудников;
+* создание и редактирование учебных курсов;
+* управление учебными материалами;
+* создание тестов и аттестаций;
+* назначение обучения сотрудникам и подразделениям;
+* прохождение обучения через мобильное приложение;
+* проведение тестирования;
+* автоматический расчет результатов;
+* контроль прогресса обучения;
+* формирование аналитических отчетов;
+* мониторинг эффективности обучения персонала.
+
+---
+
+## 1.3 Уровень подготовки пользователя
+
+Для работы с системой пользователю достаточно обладать базовыми навыками использования компьютера или мобильного устройства.
+
+Специальной технической подготовки не требуется.
+
+Пользователь должен уметь:
+
+* работать с web-браузером;
+* пользоваться мобильными приложениями;
+* вводить данные в формы;
+* переходить между разделами приложения;
+* работать с учебными материалами и тестами.
+
+---
+
+## 1.4 Перечень эксплуатационной документации
+
+Перед началом эксплуатации рекомендуется ознакомиться со следующими документами:
+
+* техническое задание;
+* руководство программиста;
+* руководство администратора;
+* руководство пользователя (настоящий документ);
+* документация по развертыванию системы.
+
+---
+
+# 2. Назначение и условия применения
+
+## 2.1 Назначение продукта
+
+Программный продукт предназначен для автоматизации процессов обучения и аттестации сотрудников ресторанного бизнеса.
+
+Основной задачей системы является централизованное хранение учебных материалов, организация обучения персонала, проведение тестирования и контроль результатов прохождения аттестации.
+
+Использование системы позволяет:
+
+* обеспечить единый стандарт подготовки сотрудников;
+* сократить время на проведение обучения;
+* автоматизировать процесс проверки знаний;
+* контролировать качество подготовки персонала;
+* получать объективную статистику по результатам обучения;
+* выявлять сотрудников, нуждающихся в дополнительной подготовке.
+
+Система состоит из двух основных компонентов:
+
+* мобильного приложения для сотрудников;
+* административной web-панели для администраторов и руководителей.
+
+Через мобильное приложение сотрудник получает доступ к назначенным курсам, базе знаний, тестированию и результатам обучения.
+
+Через административную панель осуществляется управление пользователями, курсами, тестами, назначениями и аналитикой.
+
+---
+
+## 2.2 Роли пользователей
+
+В системе предусмотрены три основные категории пользователей.
+
+### Сотрудник
+
+Сотрудник выполняет следующие действия:
+
+* проходит авторизацию в мобильном приложении;
+* просматривает назначенные курсы;
+* изучает учебные материалы;
+* использует базу знаний;
+* проходит тестирование;
+* просматривает результаты аттестации;
+* отслеживает собственный прогресс обучения;
+* работает с личным профилем.
+
+### Администратор
+
+Администратор выполняет следующие действия:
+
+* управляет учетными записями пользователей;
+* создает и редактирует курсы;
+* добавляет учебные материалы;
+* создает тесты и вопросы;
+* настраивает параметры тестирования;
+* назначает обучение сотрудникам;
+* контролирует выполнение назначений;
+* просматривает результаты обучения.
+
+### Руководитель
+
+Руководитель выполняет следующие действия:
+
+* анализирует результаты обучения сотрудников;
+* просматривает статистику прохождения курсов;
+* контролирует выполнение назначений;
+* формирует отчеты;
+* оценивает эффективность обучения подразделений;
+* принимает управленческие решения на основе аналитических данных.
+
+---
+
+## 2.3 Условия применения
+
+Система может использоваться при соблюдении следующих условий.
+
+### Аппаратные требования
+
+Для серверной части:
+
+* процессор x86_64 не менее 2 ядер;
+* оперативная память не менее 4 ГБ;
+* SSD накопитель не менее 30 ГБ;
+* постоянное подключение к сети Интернет.
+
+Рекомендуемая конфигурация:
+
+* 4 ядра CPU;
+* 8 ГБ оперативной памяти;
+* SSD от 50 ГБ;
+* резервное копирование данных.
+
+Для рабочих мест пользователей:
+
+* персональный компьютер или ноутбук для работы с административной панелью;
+* мобильное устройство Android или iOS для работы сотрудников.
+
+### Программные требования
+
+Для серверной части:
+
+* Linux (Ubuntu 22.04 LTS или аналогичная ОС);
+* PostgreSQL;
+* Go Runtime;
+* Nginx;
+* HTTPS-соединение.
+
+Для административной панели:
+
+* Google Chrome;
+* Mozilla Firefox;
+* Microsoft Edge;
+* Safari.
+
+Для мобильного приложения:
+
+* Android;
+* iOS;
+* доступ к сети Интернет.
+
+---
+
+# 3. Установка
+
+> [!IMPORTANT]
+> Установка серверной части выполняется администратором системы.
+
+Для подготовки системы к эксплуатации необходимо выполнить следующие действия:
+
+* подготовить серверное окружение;
+* установить PostgreSQL;
+* настроить серверное приложение;
+* настроить Nginx;
+* указать переменные окружения;
+* выполнить миграции базы данных;
+* создать учетные записи пользователей;
+* назначить роли пользователям.
+
+### Подготовка серверного окружения
+
+1. Подготовить VPS-сервер.
+2. Установить операционную систему Linux.
+3. Настроить сетевой доступ.
+4. Настроить HTTPS-соединение.
+
+### Настройка базы данных
+
+1. Создать базу данных PostgreSQL.
+2. Настроить пользователя БД.
+3. Выполнить миграции.
+4. Проверить подключение приложения к БД.
+
+### Развертывание административной панели
+
+Административная панель публикуется на web-сервере в виде статических файлов.
+
+Дополнительная установка на рабочие станции пользователей не требуется.
+
+Для доступа достаточно открыть браузер и перейти по адресу системы.
+
+### Установка мобильного приложения
+
+Сотрудник устанавливает мобильное приложение на устройство под управлением Android или iOS.
+
+После установки необходимо:
+
+1. Запустить приложение.
+2. Выполнить авторизацию.
+3. Получить доступ к назначенным курсам и тестированию.
+
+### Проверка готовности системы
+
+Перед началом эксплуатации рекомендуется выполнить следующие действия:
+
+* проверить доступность сервера;
+* проверить подключение к базе данных;
+* выполнить тестовый вход в административную панель;
+* выполнить тестовый вход в мобильное приложение;
+* убедиться в корректной работе основных функций системы.
+
+---
+
+# 4. Подготовка к работе
+
+## 4.1 Требования к окружению
+
+Перед началом работы необходимо убедиться, что устройство соответствует минимальным требованиям.
+
+### Для административной панели
+
+* современный web-браузер;
+* подключение к сети Интернет;
+* разрешение экрана не менее 1280×720.
+
+### Для мобильного приложения
+
+* устройство на базе Android или iOS;
+* установленное мобильное приложение;
+* доступ к сети Интернет.
+
+### Рекомендуемые условия работы
+
+> [!TIP]
+> Для обеспечения стабильной работы рекомендуется использовать актуальные версии браузеров и операционных систем.
+
+Перед началом работы рекомендуется проверить:
+
+* подключение к сети Интернет;
+* корректность работы браузера;
+* наличие доступа к серверу системы;
+* актуальность версии мобильного приложения.
+
+---
+
+## 4.2 Доступ к системе
+
+Доступ к системе предоставляется администратором.
+
+Каждому пользователю выдаются:
+
+* логин;
+* пароль;
+* роль в системе.
+
+От выбранной роли зависит набор доступных функций.
+
+| Роль          | Интерфейс            |
+| ------------- | -------------------- |
+| Сотрудник     | Мобильное приложение |
+| Администратор | Web-панель           |
+| Руководитель  | Web-панель           |
+
+> [!NOTE]
+> Не рекомендуется передавать свои учетные данные другим пользователям.
+
+---
+
+## 4.3 Вход в программу
+
+Для начала работы необходимо пройти авторизацию.
+
+Для входа выполните следующие действия:
+
+1. Откройте мобильное приложение или web-панель.
+2. Введите логин.
+3. Введите пароль.
+4. Нажмите кнопку **«Войти»**.
+
+<span id="fig-auth"></span>
+
+Форма авторизации представлена ниже (см. [Рисунок 1](#fig-auth)).
+
+![Форма авторизации](screen/img_1.png)
+
+*Рисунок 1 – Форма авторизации*
+
+После ввода учетных данных система выполняет их проверку.
+
+При успешной авторизации пользователь получает доступ к функциям системы согласно своей роли.
+
+Если данные введены неверно, отображается сообщение об ошибке.
+
+> [!WARNING]
+> После нескольких неудачных попыток входа доступ к системе может быть временно ограничен.
+
+---
+
+## 4.4 Главное меню административной панели
+
+После успешной авторизации администратор или руководитель попадает на главную страницу административной панели.
+
+<span id="fig-dashboard"></span>
+
+Главная страница административной панели представлена ниже (см. [Рисунок 2](#fig-dashboard)).
+
+![Главная страница административной панели](screen/img_2.png)
+
+*Рисунок 2 – Главная страница административной панели*
+
+Интерфейс административной панели состоит из следующих элементов:
+
+* боковое меню навигации;
+* верхняя панель;
+* рабочая область;
+* информационные карточки;
+* таблицы и формы.
+
+### Основные разделы панели
+
+| Раздел            | Назначение                     |
+| ----------------- | ------------------------------ |
+| Панель управления | Общая статистика               |
+| Сотрудники        | Управление персоналом          |
+| Обучение          | Управление курсами             |
+| Тесты             | Создание тестов                |
+| Назначения        | Назначение обучения            |
+| Аналитика         | Просмотр статистики            |
+| Отчеты            | Формирование отчетности        |
+| Настройки         | Управление параметрами системы |
+
+В разделе «Панель управления» отображаются:
+
+* количество сотрудников;
+* количество курсов;
+* количество завершенных тестирований;
+* средний результат обучения;
+* последние действия пользователей.
+
+---
+
+## 4.5 Порядок проверки работоспособности
+
+После входа рекомендуется убедиться в корректной работе системы.
+
+Для проверки необходимо:
+
+1. Выполнить авторизацию.
+2. Убедиться в открытии главной страницы.
+3. Перейти в разделы меню.
+4. Проверить отображение таблиц и данных.
+5. Убедиться в отсутствии сообщений об ошибках.
+
+### Контрольный список
+
+* [ ] Выполнен вход в систему
+* [ ] Загружается главная страница
+* [ ] Работают переходы между разделами
+* [ ] Отображаются данные пользователей
+* [ ] Работают формы создания и редактирования
+
+Если все пункты выполнены успешно, система считается работоспособной.
+
+---
+
+## 4.6 Выход из программы
+
+Для завершения работы рекомендуется выполнить выход из учетной записи.
+
+Для выхода необходимо:
+
+1. Открыть профиль пользователя.
+2. Нажать кнопку **«Выйти»**.
+3. Подтвердить действие.
+
+После выхода пользователь перенаправляется на страницу авторизации.
+
+> [!IMPORTANT]
+> На общих устройствах рекомендуется всегда выполнять выход из системы после завершения работы.
+
+---
+
+# 5. Описание операций
+
+## 5.1 Работа с сотрудниками
+
+Раздел «Сотрудники» предназначен для просмотра и управления учетными записями работников ресторана.
+
+<span id="fig-users"></span>
+
+Раздел «Сотрудники» представлен на [Рисунке 3](#fig-users).
+
+![Раздел сотрудники](screen/img_3.png)
+
+*Рисунок 3 – Раздел «Сотрудники»*
+
+В разделе отображаются:
+
+* фамилия и имя сотрудника;
+* должность;
+* подразделение;
+* статус учетной записи;
+* прогресс обучения;
+* результаты тестирования.
+
+Для поиска используется строка поиска и система фильтрации.
+
+### Карточка сотрудника
+
+Для просмотра подробной информации необходимо открыть карточку сотрудника.
+
+<span id="fig-user-card"></span>
+
+Карточка сотрудника представлена на [Рисунке 4](#fig-user-card).
+
+![Карточка сотрудника](screen/img_4.png)
+
+*Рисунок 4 – Карточка сотрудника*
+
+Карточка содержит:
+
+* персональные данные;
+* контактную информацию;
+* должность;
+* подразделение;
+* назначенные курсы;
+* историю обучения;
+* результаты тестирования.
+
+Руководитель может использовать данный раздел для анализа эффективности обучения конкретного сотрудника.
+
+---
+
+## 5.2 Работа с обучающими курсами
+
+Раздел **«Обучение»** предназначен для создания, редактирования и управления учебными курсами.
+
+Учебный курс представляет собой набор материалов, которые сотрудник должен изучить перед прохождением аттестации или выполнением рабочих обязанностей.
+
+<span id="fig-courses"></span>
+
+Раздел «Обучение» представлен на [Рисунке 5](#fig-courses).
+
+![Раздел обучение](screen/img_5.png)
+
+*Рисунок 5 – Раздел «Обучение»*
+
+В списке курсов отображаются:
+
+* название курса;
+* категория;
+* статус публикации;
+* длительность изучения;
+* количество модулей;
+* статистика прохождения.
+
+### Создание курса
+
+Для создания нового курса необходимо:
+
+1. Перейти в раздел **«Обучение»**.
+2. Нажать кнопку **«Создать курс»**.
+3. Заполнить необходимые поля.
+4. Сохранить курс.
+
+<span id="fig-create-course"></span>
+
+Форма создания курса представлена на [Рисунке 6](#fig-create-course).
+
+![Создание курса](screen/img_6.png)
+
+*Рисунок 6 – Создание учебного курса*
+
+При создании курса необходимо указать:
+
+* название;
+* категорию;
+* описание;
+* длительность обучения;
+* учебные модули;
+* учебные материалы.
+
+### Пример создания учебного курса
+
+Следующий пример демонстрирует обработчик API для создания нового учебного курса.
+
+```go
+func CreateCourse(c *gin.Context) {
+    var course models.Course
+
+    if err := c.ShouldBindJSON(&course); err != nil {
+        c.JSON(http.StatusBadRequest, gin.H{
+            "error": "Некорректные данные",
+        })
+        return
+    }
+
+    if err := database.DB.Create(&course).Error; err != nil {
+        c.JSON(http.StatusInternalServerError, gin.H{
+            "error": "Ошибка создания курса",
+        })
+        return
+    }
+
+    c.JSON(http.StatusCreated, course)
+}
+```
+
+Обработчик принимает данные курса, сохраняет их в базе данных PostgreSQL и возвращает созданную запись клиентскому приложению.
+
+### Учебные материалы
+
+Курс может содержать:
+
+* текстовые инструкции;
+* изображения;
+* видеоматериалы;
+* документы;
+* технологические карты;
+* ссылки на внутренние ресурсы;
+* предупреждения и важные уведомления.
+
+> [!NOTE]
+> До публикации курс доступен только администраторам системы.
+
+### Редактирование курса
+
+Для изменения курса необходимо:
+
+1. Открыть карточку курса.
+2. Нажать кнопку редактирования.
+3. Внести изменения.
+4. Сохранить обновленные данные.
+
+После публикации курс может быть назначен сотрудникам.
+
+---
+
+## 5.3 Работа с тестами
+
+Раздел **«Тесты»** используется для создания аттестаций и проверки знаний сотрудников.
+
+Тесты могут быть связаны с конкретными учебными курсами.
+
+<span id="fig-tests"></span>
+
+Раздел «Тесты» представлен на [Рисунке 7](#fig-tests).
+
+![Раздел тесты](screen/img_7.png)
+
+*Рисунок 7 – Раздел «Тесты»*
+
+В списке тестов отображаются:
+
+* название теста;
+* связанный курс;
+* количество вопросов;
+* проходной балл;
+* ограничение времени;
+* количество попыток;
+* статус теста.
+
+### Создание теста
+
+Для создания тестирования необходимо:
+
+1. Перейти в раздел **«Тесты»**.
+2. Нажать кнопку **«Создать тест»**.
+3. Настроить параметры тестирования.
+4. Добавить вопросы.
+5. Сохранить тест.
+
+<span id="fig-create-test"></span>
+
+Форма создания теста представлена на [Рисунке 8](#fig-create-test).
+
+![Создание теста](screen/img_8.png)
+
+*Рисунок 8 – Создание теста*
+
+### Настраиваемые параметры
+
+При создании теста можно указать:
+
+| Параметр       | Описание                                  |
+| -------------- | ----------------------------------------- |
+| Название       | Наименование тестирования                 |
+| Курс           | Связанный курс                            |
+| Проходной балл | Минимальный процент успешного прохождения |
+| Время          | Ограничение по времени                    |
+| Попытки        | Максимальное количество попыток           |
+
+### Типы вопросов
+
+Система поддерживает следующие типы вопросов:
+
+* выбор одного варианта ответа;
+* выбор нескольких вариантов ответа;
+* ввод текстового ответа.
+
+После завершения настройки тест публикуется и становится доступным для назначения сотрудникам.
+
+> [!IMPORTANT]
+> Изменение опубликованного теста может повлиять на результаты последующих попыток прохождения.
+
+---
+
+## 5.4 Назначение обучения
+
+Раздел **«Назначения»** используется для выдачи курсов сотрудникам и подразделениям.
+
+Назначение определяет, кто должен пройти конкретный курс и в какие сроки.
+
+<span id="fig-assignments"></span>
+
+Раздел «Назначения» представлен на [Рисунке 9](#fig-assignments).
+
+![Раздел назначения](screen/img_9.png)
+
+*Рисунок 9 – Раздел «Назначения»*
+
+В разделе отображаются:
+
+* назначенный курс;
+* получатель;
+* срок прохождения;
+* текущий статус;
+* дата создания назначения.
+
+### Создание назначения
+
+Для создания назначения необходимо:
+
+1. Перейти в раздел **«Назначения»**.
+2. Нажать кнопку **«Создать назначение»**.
+3. Заполнить параметры назначения.
+4. Сохранить запись.
+
+<span id="fig-create-assignment"></span>
+
+Форма создания назначения представлена на [Рисунке 10](#fig-create-assignment).
+
+![Создание назначения](screen/img_10.png)
+
+*Рисунок 10 – Создание назначения курса*
+
+### Параметры назначения
+
+При создании назначения указываются:
+
+* учебный курс;
+* тип получателя;
+* сотрудник, подразделение или ресторан;
+* срок прохождения;
+* дополнительные настройки.
+
+### Типы получателей
+
+Система поддерживает три варианта назначения:
+
+1. Конкретный сотрудник.
+2. Подразделение.
+3. Весь ресторан.
+
+> [!WARNING]
+> В рамках одного назначения допускается выбор только одного типа получателя.
+
+### Контроль выполнения
+
+После сохранения назначение автоматически становится доступным сотруднику в мобильном приложении.
+
+Статусы прохождения:
+
+| Статус     | Описание               |
+| ---------- | ---------------------- |
+| Назначено  | Курс выдан сотруднику  |
+| В процессе | Изучение курса начато  |
+| Завершено  | Курс успешно пройден   |
+| Просрочено | Истек срок прохождения |
+
+Руководитель и администратор могут отслеживать выполнение назначений в режиме реального времени.
+
+---
+
+## 5.5 Работа сотрудника в мобильном приложении
+
+После успешной авторизации сотрудник получает доступ к основным функциям мобильного приложения.
+
+Главный экран предоставляет быстрый доступ к курсам, тестированию, базе знаний и личному профилю.
+
+<span id="fig-mobile-home"></span>
+
+Главный экран мобильного приложения представлен на [Рисунке 11](#fig-mobile-home).
+
+![Главный экран мобильного приложения](screen/img_11.png)
+
+*Рисунок 11 – Главный экран мобильного приложения*
+
+На главном экране отображаются:
+
+* общий прогресс обучения;
+* назначенные курсы;
+* рекомендуемые материалы;
+* уведомления;
+* предстоящие тестирования;
+* быстрые действия.
+
+### Основные разделы приложения
+
+| Раздел      | Назначение                      |
+| ----------- | ------------------------------- |
+| Главная     | Основная информация и прогресс  |
+| Курсы       | Список назначенных курсов       |
+| Тесты       | Доступные экзамены и аттестации |
+| База знаний | Учебные материалы               |
+| Профиль     | Данные пользователя             |
+
+---
+
+### Просмотр списка курсов
+
+Для просмотра доступных курсов необходимо открыть раздел **«Курсы»**.
+
+<span id="fig-mobile-courses"></span>
+
+Список курсов представлен на [Рисунке 12](#fig-mobile-courses).
+
+![Список курсов](screen/img_12.png)
+
+*Рисунок 12 – Список курсов в мобильном приложении*
+
+Для каждого курса отображается:
+
+* название;
+* краткое описание;
+* процент выполнения;
+* статус прохождения;
+* наличие тестирования.
+
+Для начала обучения необходимо выбрать курс из списка.
+
+---
+
+### Детальный экран курса
+
+После выбора курса открывается его подробное описание.
+
+<span id="fig-course-details"></span>
+
+Детальный экран курса представлен на [Рисунке 13](#fig-course-details).
+
+![Детальный экран курса](screen/img_13.png)
+
+*Рисунок 13 – Детальный экран курса*
+
+На экране отображаются:
+
+* описание курса;
+* список модулей;
+* прогресс прохождения;
+* связанные материалы;
+* информация о тестировании.
+
+Пользователь может последовательно изучать учебные модули и отслеживать прогресс обучения.
+
+---
+
+### Просмотр учебного материала
+
+Для изучения материала необходимо открыть соответствующий модуль курса.
+
+<span id="fig-learning-material"></span>
+
+Просмотр учебного материала представлен на [Рисунке 14](#fig-learning-material).
+
+![Просмотр учебного материала](screen/img_14.png)
+
+*Рисунок 14 – Просмотр учебного материала*
+
+Учебный материал может содержать:
+
+* текстовые инструкции;
+* изображения;
+* видеоролики;
+* документы;
+* технологические карты;
+* предупреждения;
+* дополнительные рекомендации.
+
+> [!TIP]
+> Рекомендуется полностью изучить все материалы курса перед началом тестирования.
+
+После завершения изучения пользователь может перейти к прохождению аттестации.
+
+---
+
+## 5.6 Прохождение тестирования
+
+Тестирование используется для проверки усвоения учебного материала.
+
+Для прохождения теста сотрудник открывает раздел **«Тесты»** или запускает тестирование непосредственно из курса.
+
+---
+
+### Список экзаменов
+
+В разделе отображаются все доступные сотруднику тестирования.
+
+<span id="fig-exams"></span>
+
+Список экзаменов представлен на [Рисунке 15](#fig-exams).
+
+![Список экзаменов](screen/img_15.png)
+
+*Рисунок 15 – Список экзаменов в мобильном приложении*
+
+Для каждого теста отображаются:
+
+* название;
+* описание;
+* количество попыток;
+* статус прохождения;
+* дата назначения.
+
+Для начала прохождения необходимо выбрать тест из списка.
+
+---
+
+### Стартовый экран тестирования
+
+Перед запуском теста отображается информационный экран.
+
+<span id="fig-test-start"></span>
+
+Стартовый экран тестирования представлен на [Рисунке 16](#fig-test-start).
+
+![Стартовый экран тестирования](screen/img_16.png)
+
+*Рисунок 16 – Стартовый экран тестирования*
+
+На стартовом экране отображаются:
+
+* название теста;
+* описание;
+* количество вопросов;
+* проходной процент;
+* ограничение по времени;
+* количество доступных попыток.
+
+Для запуска тестирования необходимо нажать кнопку **«Начать тест»**.
+
+> [!IMPORTANT]
+> После начала тестирования начинается отсчет времени прохождения.
+
+---
+
+### Прохождение теста
+
+После запуска открывается первый вопрос тестирования.
+
+<span id="fig-test-question"></span>
+
+Экран вопроса теста представлен на [Рисунке 17](#fig-test-question).
+
+![Экран вопроса](screen/img_17.png)
+
+*Рисунок 17 – Экран вопроса теста*
+
+Пользователь может:
+
+* выбрать один вариант ответа;
+* выбрать несколько вариантов ответа;
+* ввести текстовый ответ (если предусмотрено тестом).
+
+После ответа необходимо перейти к следующему вопросу.
+
+Во время прохождения тестирования система автоматически сохраняет ответы пользователя.
+
+### Проверка результатов
+
+После завершения последнего вопроса выполняется автоматическая проверка.
+
+Система рассчитывает:
+
+* количество правильных ответов;
+* процент прохождения;
+* итоговый статус попытки.
+
+---
+
+### Результат прохождения тестирования
+
+После проверки отображается итоговый результат.
+
+<span id="fig-test-result"></span>
+
+Результат прохождения тестирования представлен на [Рисунке 18](#fig-test-result).
+
+![Результат тестирования](screen/img_18.png)
+
+*Рисунок 18 – Результат прохождения теста*
+
+На экране результата отображаются:
+
+* итоговый процент;
+* количество набранных баллов;
+* статус прохождения;
+* номер попытки;
+* дата и время завершения;
+* возможность возврата к списку тестов.
+
+### Интерпретация результата
+
+| Статус     | Описание                                     |
+| ---------- | -------------------------------------------- |
+| Пройден    | Результат равен или превышает проходной балл |
+| Не пройден | Результат ниже установленного порога         |
+
+Если тест не пройден и остались доступные попытки, пользователь может пройти тестирование повторно.
+
+> [!NOTE]
+> Все результаты сохраняются в системе и доступны для просмотра сотруднику, администратору и руководителю в рамках их прав доступа.
+
+---
+
+## 5.7 Просмотр аналитики и отчетов
+
+Раздел **«Аналитика»** предназначен для контроля эффективности обучения сотрудников и анализа результатов прохождения курсов и тестирований.
+
+Доступ к разделу имеют администраторы и руководители.
+
+<span id="fig-analytics"></span>
+
+Раздел аналитики представлен на [Рисунке 19](#fig-analytics).
+
+![Раздел аналитики](screen/img_19.png)
+
+*Рисунок 19 – Раздел «Аналитика»*
+
+В разделе отображаются:
+
+* общий процент прохождения обучения;
+* количество завершенных курсов;
+* количество активных назначений;
+* средний балл сотрудников;
+* статистика прохождения тестирований;
+* данные по подразделениям;
+* динамика обучения за выбранный период.
+
+### Возможности аналитики
+
+Система позволяет:
+
+* анализировать результаты отдельных сотрудников;
+* сравнивать показатели подразделений;
+* выявлять сотрудников с низкими результатами;
+* контролировать выполнение назначенного обучения;
+* отслеживать эффективность учебных программ.
+
+### Фильтрация данных
+
+Для более детального анализа доступны фильтры:
+
+* по подразделению;
+* по должности;
+* по сотруднику;
+* по периоду времени;
+* по курсу;
+* по тестированию.
+
+> [!TIP]
+> Использование фильтров позволяет быстро получать статистику по конкретному направлению обучения.
+
+---
+
+### Формирование отчетов
+
+Раздел **«Отчеты»** предназначен для формирования итоговой документации по обучению персонала.
+
+<span id="fig-reports"></span>
+
+Раздел отчетов представлен на [Рисунке 20](#fig-reports).
+
+![Раздел отчетов](screen/img_20.png)
+
+*Рисунок 20 – Раздел «Отчеты»*
+
+В разделе доступны следующие виды отчетов:
+
+* отчет по сотруднику;
+* отчет по подразделению;
+* отчет по курсу;
+* отчет по тестированию;
+* общий отчет по ресторану.
+
+### Формирование отчета
+
+Для формирования отчета необходимо:
+
+1. Открыть раздел **«Отчеты»**.
+2. Выбрать тип отчета.
+3. Указать параметры формирования.
+4. Нажать кнопку **«Сформировать»**.
+
+После обработки данных отчет становится доступным для просмотра или скачивания.
+
+---
+
+## 5.8 Настройки и профиль пользователя
+
+Каждый пользователь имеет доступ к своему профилю.
+
+В профиле отображается информация об учетной записи и персональных данных.
+
+<span id="fig-profile"></span>
+
+Профиль пользователя представлен на [Рисунке 21](#fig-profile).
+
+![Профиль пользователя](screen/img_21.png)
+
+*Рисунок 21 – Профиль сотрудника в мобильном приложении*
+
+В профиле отображаются:
+
+* фамилия и имя;
+* должность;
+* подразделение;
+* контактные данные;
+* результаты обучения;
+* назначенные курсы;
+* статистика прохождения тестирований.
+
+### Доступные действия
+
+Пользователь может:
+
+* просматривать информацию о себе;
+* изменять отдельные настройки;
+* просматривать историю обучения;
+* контролировать прогресс прохождения курсов.
+
+---
+
+### Настройки административной панели
+
+Для администраторов дополнительно доступен раздел настроек системы.
+
+<span id="fig-settings"></span>
+
+Раздел настроек представлен на [Рисунке 22](#fig-settings).
+
+![Настройки системы](screen/img_22.png)
+
+*Рисунок 22 – Настройки административной панели*
+
+Через данный раздел выполняется:
+
+* управление параметрами системы;
+* настройка ролей пользователей;
+* изменение общих настроек обучения;
+* управление справочниками;
+* настройка уведомлений.
+
+> [!IMPORTANT]
+> Изменение системных настроек доступно только пользователям с соответствующими правами.
+
+---
+
+## 5.9 Выход из программы
+
+Для завершения работы рекомендуется выполнять выход из учетной записи.
+
+Это особенно важно при использовании общих или служебных устройств.
+
+<span id="fig-logout"></span>
+
+Выход из мобильного приложения представлен на [Рисунке 23](#fig-logout).
+
+![Выход из приложения](screen/img_23.png)
+
+*Рисунок 23 – Выход из мобильного приложения*
+
+Для выхода необходимо:
+
+1. Перейти в раздел **«Профиль»**.
+2. Нажать кнопку **«Выйти»**.
+3. Подтвердить действие.
+
+После завершения сеанса пользователь возвращается на экран авторизации.
+
+---
+
+# 6. Аварийные ситуации
+
+В процессе эксплуатации могут возникать различные ошибки. В большинстве случаев система выводит понятное сообщение с описанием проблемы.
+
+| Сообщение                 | Возможная причина       | Решение                                            |
+| ------------------------- | ----------------------- | -------------------------------------------------- |
+| Неверный логин или пароль | Ошибка авторизации      | Проверить введенные данные                         |
+| Нет подключения к серверу | Проблемы сети           | Проверить интернет-соединение                      |
+| Ошибка загрузки данных    | Недоступность сервера   | Повторить попытку позже                            |
+| Тестирование недоступно   | Отсутствует назначение  | Обратиться к администратору                        |
+| Недостаточно прав         | Ограничение роли        | Выполнить вход под нужной учетной записью          |
+| Время прохождения истекло | Закончилось время теста | Начать новую попытку при наличии доступных попыток |
+
+> [!WARNING]
+> При возникновении повторяющихся ошибок необходимо обратиться к администратору системы.
+
+---
+
+# 7. Рекомендации по освоению
+
+Для быстрого освоения системы рекомендуется придерживаться следующего порядка работы.
+
+### Для сотрудников
+
+1. Изучить структуру мобильного приложения.
+2. Ознакомиться с назначенными курсами.
+3. Изучить материалы базы знаний.
+4. Пройти тестирование.
+5. Проверить результаты обучения.
+
+### Для администраторов
+
+1. Изучить структуру административной панели.
+2. Создать тестового пользователя.
+3. Создать учебный курс.
+4. Создать тестирование.
+5. Назначить обучение сотруднику.
+6. Проверить прохождение курса и тестирования.
+
+### Для руководителей
+
+1. Ознакомиться с разделом аналитики.
+2. Изучить механизмы формирования отчетов.
+3. Настроить контроль выполнения назначений.
+4. Использовать статистику для оценки эффективности обучения.
+
+> [!TIP]
+> Рекомендуется периодически проверять актуальность учебных материалов и тестов.
+
+---
+
+# 8. Термины и сокращения
+
+| Сокращение | Расшифровка                                                      |
+| ---------- | ---------------------------------------------------------------- |
+| API        | Программный интерфейс приложения                                 |
+| БД         | База данных                                                      |
+| ИС         | Информационная система                                           |
+| MVP        | Минимально жизнеспособная версия продукта                        |
+| ОС         | Операционная система                                             |
+| ПП         | Программный продукт                                              |
+| СУБД       | Система управления базами данных                                 |
+| REST       | Архитектурный стиль взаимодействия клиентской и серверной частей |
+| JSON       | Формат обмена данными                                            |
+| HTTPS      | Защищенный протокол передачи данных                              |
+| Go         | Язык программирования серверной части                            |
+| PostgreSQL | Система управления реляционными базами данных                    |
+| Vue.js     | Фреймворк для административной панели                            |
+| Flutter    | Фреймворк мобильного приложения                                  |
+| VPS        | Виртуальный выделенный сервер                                    |
+
+---
+
+# 9. Контакты
+
+По вопросам эксплуатации системы необходимо обращаться к администратору информационной системы.
+
+При обращении рекомендуется указать:
+
+* дату возникновения проблемы;
+* описание выполняемых действий;
+* текст сообщения об ошибке;
+* при наличии — снимок экрана с ошибкой.
+
+---
+
+# 10. Лист регистрации изменений
+
+| Версия | Дата | Автор         | Описание изменений         |
+| ------ | ---- | ------------- | -------------------------- |
+| 0.1    | 2026 | Вдовский И.О. | Первичная версия документа |
+|        |      |               |                            |
+|        |      |               |                            |
+|        |      |               |                            |
+
+---
+
+> [!NOTE]
+> Конец документа.