Skip to content

About

🎓 Электронная система тестирования студентов РТСУ — Spring Boot, PostgreSQL, учебный план, расписание, ведомости, REST API

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🎓 ЭСТ · Электронная система тестирования студентов

Тесты, расписание, учебный план и ведомости — в одной системе, построенной на структуре реального вуза

Java Spring Boot Spring Security PostgreSQL Flyway Postman Tests

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

👋 Привет! Я Тимур Чибряков

Студент Российско-Таджикского (Славянского) университета. Это мой проект — электронная система тестирования студентов для РТСУ: от анализа предметной области и UML-диаграмм до работающего веб-приложения с базой данных, REST API и автотестами.

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

15
таблиц в БД
3
роли
6
групп · 99 студентов
154
пары в расписании
49
автотестов
47
проверок в Postman

01 — Что умеет система

Для кого Что может
🧑‍🎓 Студент видит тесты только своей группы, проходит их с таймером, сразу получает результат с разбором; расписание своей группы и ближайшие экзамены на главной
👩‍🏫 Преподаватель создаёт тесты только по своим дисциплинам, загружает вопросы из Excel, видит результаты своих групп и «Моё расписание»
🛠 Администратор ведёт группы, учебный план и расписание, формирует ведомость в один клик, смотрит аналитику, управляет пользователями и журналом действий

Ключевые возможности

  • Учебный план — для пары «группа + дисциплина»: преподаватель, семестр, форма контроля (экзамен / зачёт / дифф. зачёт)
  • Ведомость — выбираешь группу и дисциплину, а факультет, кафедра, преподаватель, курс, семестр и форма контроля подставляются сами; печать / PDF, CSV, Excel
  • Расписание — недельная сетка с числителем и знаменателем, расписание сессии с отсчётом «через N дней»
  • Защита от списывания — перемешивание вопросов и вариантов, лимит попыток и пауза между ними
  • Автосохранение ответов — если пропал интернет или вышло время, засчитываются сохранённые ответы
  • Правильные ответы и пояснения — преподаватель решает, показывать их сразу, после последней попытки или никогда; оценки можно выдавать после проверки
  • Качество вопросов — система отмечает вопросы, которые плохо отделяют знающих студентов от незнающих
  • Импорт вопросов из Excel — по шаблону, «всё или ничего», с номером строки в ошибке
  • Аналитика — успеваемость по тестам, сложность вопросов, сравнение групп, рейтинг студентов
  • Журнал действий — кто и когда изменил тесты, расписание, учебный план, пользователей
  • Удобное прохождение — панель с номерами вопросов, флажок «вернуться позже», сводка перед отправкой, ответы клавишами 1–9
  • Оформление «Академия» — тёмно-синий и золото, заголовки с засечками, верхнее меню как у сайтов университетов
  • Мобильная версия — меню прячется в выезжающую панель, все страницы адаптированы

02 — Скриншоты

Главная администратора
Главная администратора — главные действия в один клик
Ведомость
Ведомость — шапка заполняется из учебного плана
Учебный план
Учебный план группы — кто какой предмет ведёт
Расписание
Расписание — числитель и знаменатель, сегодняшний день подсвечен
Главная студента
Главная студента — пары на сегодня, экзамены, свои тесты со статусом
Прохождение теста
Прохождение — таймер и прогресс «отвечено N из M»
Результат
Результат — кольцо с процентом и разбор по вопросам
Аналитика
Аналитика — сравнение групп и рейтинг студентов
Редактор теста
Карточка теста — вопросы, настройки, импорт из Excel
Мобильная версия
Мобильная версия

Скриншоты сделаны на демонстрационных данных: студенты и преподаватели вымышленные.

03 — Стек

Слой Технологии
Backend Java 17 · Spring Boot 3.5 (Web, Security, Data JPA, Validation) · Hibernate 6.6
База данных PostgreSQL 18 · Flyway (8 миграций)
Frontend Thymeleaf 3.1 · Bootstrap 5.3 · Bootstrap Icons · шрифты Inter и Source Serif 4 (всё подключено локально — работает без интернета)
Документы Apache POI — ведомость и импорт вопросов в Excel
Тестирование JUnit 5 · MockMvc · H2 · Postman / Newman
Инструменты Maven · Git · PlantUML

04 — Быстрый старт

Нужно: JDK 17+, Maven 3.9+ (или встроенный Maven Wrapper), PostgreSQL 14+.

CREATE USER testing_app WITH PASSWORD 'ваш_пароль';
CREATE DATABASE testing_system OWNER testing_app;
cp .env.example .env          # задайте пароли: DB_PASSWORD, ADMIN_PASSWORD, DEMO_PASSWORD, DEMO_TEACHER_PASSWORD
./run.sh                      # или двойной щелчок: «Запустить.command» (macOS) / «Запустить.bat» (Windows)

Сайт: http://localhost:8080. Таблицы создаются миграциями Flyway, база заполняется демо-данными: 6 групп, 30 дисциплин, 30 преподавателей, 99 студентов, расписание, сессия и 17 тестов с историей прохождения.

Вход: администратор — admin / ADMIN_PASSWORD; преподаватели и студенты — логины транслитом (фамилия.инициалы), полный список создаётся в data/accounts.csv; пароли — DEMO_TEACHER_PASSWORD и DEMO_PASSWORD.

Своё расписание вуза можно загрузить из data/university.json — папка data/ в Git не попадает. Без неё загружается демо-набор src/main/resources/seed/demo-university.json с вымышленными преподавателями.

Запуск на своём сервере с доменом, HTTPS и резервными копиями: docs/DEPLOY.md.

05 — Архитектура

Браузер / Postman
       │  HTTP (форма входа + сессия  |  HTTP Basic для API)
       ▼
Spring Security ── роли + проверка по учебному плану (на сервере, а не только в меню)
       ▼
web/  (Thymeleaf)      api/  (REST, JSON)        ← одни и те же сервисы, правила не дублируются
       ▼
service/  тесты · попытки · ведомость · расписание · отчёты · журнал действий
       ▼
repository/  Spring Data JPA  ──►  PostgreSQL (15 таблиц, Flyway)
src/main/java/ru/edu/testing
├── api/          REST-контроллеры и обработчик ошибок API
├── web/          страницы (Thymeleaf) и обработчик ошибок
├── service/      бизнес-логика
├── repository/   Spring Data JPA
├── domain/       сущности: структура вуза, учебный план, расписание, тесты, попытки, журнал
├── dto/          формы и DTO
├── security/     пользователь Spring Security, защита от подбора пароля
└── config/       безопасность, начальные данные
docs/             UML-диаграммы (PlantUML), ER-диаграмма, скриншоты
postman/          коллекция Postman

Диаграммы: вариантов использования · классов · деятельности · последовательности · ER · компонентов · развёртывания

06 — REST API

Метод Путь Доступ
POST /api/auth/register все (регистрация студента в группу)
GET /api/auth/me авторизованные
GET /api/tests?q=&subjectId=&sort= по учебному плану: студент — своя группа, преподаватель — свои дисциплины
POST / PUT / DELETE /api/tests[/{id}], /api/tests/{id}/questions, /api/questions/{id} автор теста, администратор
POST /api/tests/{id}/attempts, /api/attempts/{id}/submit студент
GET /api/attempts?q=&testId=&subjectId=&passed=&groupId=&sort= свои / своих групп / все
GET /api/schedule/groups/{id}, /api/schedule/teachers/{id} своя группа / своё расписание / администратор
GET / POST /api/groups, /api/groups/{id}/curriculum чтение — все, изменение — администратор
GET /api/reports/summary, /api/reports/tests администратор
GET / POST / PATCH / DELETE /api/users?q=&role=&groupId= администратор

Коллекция Postman: postman/student-testing-system.postman_collection.json — задайте adminPassword и teacherPassword и нажмите Run: 25 запросов, 47 проверок.

07 — Тестирование

mvn test        # 49 тестов: 43 интеграционных сценария + 6 модульных

Интеграционные тесты проходят весь стек — Spring Security, контроллеры, сервисы, БД (H2 в режиме PostgreSQL): авторизация и защита от подбора, CSRF, CRUD, поиск и фильтры, прохождение теста, права по учебному плану, ведомость (экзамен и зачёт, CSV и Excel), расписание, лимит попыток, перемешивание, импорт из Excel, журнал действий, смена пароля, аналитика.

08 — Безопасность

  • пароли — только хеш BCrypt; секреты — в .env, который не попадает в Git
  • права проверяются на сервере: роль + учебный план (студент не откроет чужую группу даже по прямой ссылке)
  • студенту не передаются правильные ответы — ни при прохождении, ни в результатах
  • блокировка входа после 5 неудачных попыток; CSRF-защита форм; cookie HttpOnly + SameSite
  • Content-Security-Policy только для собственного домена, X-Frame-Options: DENY
  • параметризованные SQL-запросы, сортировка по белому списку, экранирование вывода (XSS), защита от CSV-инъекции
  • ограничение размера загружаемых файлов; все изменения данных пишутся в журнал действий
  • согласие на обработку данных при регистрации, политика конфиденциальности и обезличивание журнала при удалении пользователя

09 — Фото и лицензии

Фотографии РТСУ и обложки дисциплин — настоящие снимки с Wikimedia Commons под свободными лицензиями, авторы перечислены в docs/IMAGE_CREDITS.md и на странице сайта /credits.


Тимур Чибряков · Российско-Таджикский (Славянский) университет · 2026

GitHub

About

🎓 Электронная система тестирования студентов РТСУ — Spring Boot, PostgreSQL, учебный план, расписание, ведомости, REST API

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages