Руководство пользователя системы учета посещаемости

1. Назначение системы

Система предназначена для:

• фиксации посещаемости по классам за конкретную дату
• ведения списка отсутствующих с причинами
• просмотра статистики за дату
• экспорта статистики в Excel и CSV.

Система поддерживает 2 роли:

• admin (администратор)
• teacher (учётная запись класса).

2. Вход в систему

1. Откройте веб-интерфейс.
2. В поле API Base URL укажите адрес API (обычно менять не нужно).
3. Введите логин и пароль.
4. Нажмите Войти.

После входа в верхней части экрана отображаются роль и userId.

3. Навигация по интерфейсу

Основные вкладки:

• Классы (только для admin);
• Посещаемость;
• Статистика;
• Управление учётными данными (только для admin).

Дополнительно:

• кнопка Выйти завершает сессию;
• кнопка Тёмная тема / Светлая тема переключает оформление.

4. Работа учителя

4.1. Заполнение посещаемости

Вкладка: Посещаемость → блок Заполнить / обновить посещаемость.

Для учителя класс подставляется автоматически по его учётной записи.

1. Выберите дату.
2. Дождитесь автозагрузки данных.
3. Укажите: По списку (totalStudents); Присутствуют (presentCount).
4. Добавьте отсутствующих: Отсутствующие по неуважительным причинам; Отсутствующие по уважительным причинам (с обязательной причиной).
5. Нажмите Сохранить посещаемость.

Валидация:

• presentCount не может быть больше totalStudents;
• количество отсутствующих должно равняться totalStudents - presentCount;
• дубли фамилий не допускаются;
• для уважительных отсутствий причина обязательна.

4.2. Просмотр посещаемости

Вкладка: Посещаемость → блок Просмотр посещаемости за дату.

1. Выберите дату.
2. Нажмите Загрузить.

Для учителя загружается посещаемость только его класса.

4.3. Просмотр статистики

Вкладка: Статистика.

1. Выберите дату.
2. Нажмите Показать.

Для учителя выводится статистика по его классу без выбора класса.

Результат:

• список отсутствующих;
• класс и причина отсутствия;
• общее число отсутствующих.

4.4. Экспорт статистики

Вкладка: Статистика.

1. Выберите дату.
2. Нажмите:

Экспорт в Excel для .xlsx; Экспорт в CSV для .csv.

Файл скачивается автоматически.

5. Работа администратора

5.1. Управление классами

Вкладка: Классы.

Функции:

• выбор класса;
• создание класса (класс + пароль);
• просмотр данных выбранного класса;
• изменение логина/пароля выбранного класса;
• удаление класса.

5.2. Управление собственными учётными данными

Вкладка: Управление учётными данными.

Доступные операции:

• изменение собственных логина и пароля администратора.

5.3. Незаполненные классы

Вкладка: Статистика.

1. Выберите дату.
2. Нажмите Показать незаполненные классы.

Для admin выводится таблица:

• класс;
• логин класса;
• ID учётной записи.

6. Рекомендации по работе

• Сначала выбирайте дату, затем вводите данные.
• Для админа: сначала выберите нужный класс на вкладке Классы, затем меняйте его учётные данные.
• Используйте экспорт для передачи статистики.

7. Частые проблемы

7.1. Не удаётся войти

Проверьте:

• правильность API Base URL (если меняли);
• логин/пароль;
• доступность backend.

7.2. Ошибка при сохранении посещаемости

Проверьте:

• соответствие формуле totalStudents - presentCount;
• отсутствие дублей в списке отсутствующих;
• заполнены ли причины для отсутствующих по уважительным причинам.

7.3. Не скачивается файл экспорта

Проверьте:

• выбрана ли дата;
• не блокирует ли браузер загрузки.

8. Контакты для сопровождения

Если проблему не удалось устранить:

• сохраните текст ошибки;
• укажите дату, класс и роль пользователя;
• передайте информацию администратору системы или разработчику.

Контакты разработчика:

• электронная почта: ornihex@proton.me;
• репозиторий: https://github.com/Ornihex/Attendence.