Тесты, расписание, учебный план и ведомости — в одной системе, построенной на структуре реального вуза
Студент Российско-Таджикского (Славянского) университета. Это мой проект — электронная система тестирования студентов для РТСУ: от анализа предметной области и UML-диаграмм до работающего веб-приложения с базой данных, REST API и автотестами.
Идея простая: преподавателю не нужно проверять тесты вручную и заполнять ведомости, а студенту — ждать результат. Система знает учебный план вуза — у какой группы какой предмет, кто его ведёт и экзамен это или зачёт, — поэтому сама разграничивает доступ и сама заполняет ведомость.
| 15 таблиц в БД |
3 роли |
6 групп · 99 студентов |
154 пары в расписании |
49 автотестов |
47 проверок в Postman |
| Для кого | Что может |
|---|---|
| 🧑🎓 Студент | видит тесты только своей группы, проходит их с таймером, сразу получает результат с разбором; расписание своей группы и ближайшие экзамены на главной |
| 👩🏫 Преподаватель | создаёт тесты только по своим дисциплинам, загружает вопросы из Excel, видит результаты своих групп и «Моё расписание» |
| 🛠 Администратор | ведёт группы, учебный план и расписание, формирует ведомость в один клик, смотрит аналитику, управляет пользователями и журналом действий |
Ключевые возможности
- Учебный план — для пары «группа + дисциплина»: преподаватель, семестр, форма контроля (экзамен / зачёт / дифф. зачёт)
- Ведомость — выбираешь группу и дисциплину, а факультет, кафедра, преподаватель, курс, семестр и форма контроля подставляются сами; печать / PDF, CSV, Excel
- Расписание — недельная сетка с числителем и знаменателем, расписание сессии с отсчётом «через N дней»
- Защита от списывания — перемешивание вопросов и вариантов, лимит попыток и пауза между ними
- Автосохранение ответов — если пропал интернет или вышло время, засчитываются сохранённые ответы
- Правильные ответы и пояснения — преподаватель решает, показывать их сразу, после последней попытки или никогда; оценки можно выдавать после проверки
- Качество вопросов — система отмечает вопросы, которые плохо отделяют знающих студентов от незнающих
- Импорт вопросов из Excel — по шаблону, «всё или ничего», с номером строки в ошибке
- Аналитика — успеваемость по тестам, сложность вопросов, сравнение групп, рейтинг студентов
- Журнал действий — кто и когда изменил тесты, расписание, учебный план, пользователей
- Удобное прохождение — панель с номерами вопросов, флажок «вернуться позже», сводка перед отправкой, ответы клавишами 1–9
- Оформление «Академия» — тёмно-синий и золото, заголовки с засечками, верхнее меню как у сайтов университетов
- Мобильная версия — меню прячется в выезжающую панель, все страницы адаптированы
Скриншоты сделаны на демонстрационных данных: студенты и преподаватели вымышленные.
| Слой | Технологии |
|---|---|
| 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 |
Нужно: 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.
Браузер / 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 · компонентов · развёртывания
| Метод | Путь | Доступ |
|---|---|---|
| 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 проверок.
mvn test # 49 тестов: 43 интеграционных сценария + 6 модульныхИнтеграционные тесты проходят весь стек — Spring Security, контроллеры, сервисы, БД (H2 в режиме PostgreSQL): авторизация и защита от подбора, CSRF, CRUD, поиск и фильтры, прохождение теста, права по учебному плану, ведомость (экзамен и зачёт, CSV и Excel), расписание, лимит попыток, перемешивание, импорт из Excel, журнал действий, смена пароля, аналитика.
- пароли — только хеш BCrypt; секреты — в
.env, который не попадает в Git - права проверяются на сервере: роль + учебный план (студент не откроет чужую группу даже по прямой ссылке)
- студенту не передаются правильные ответы — ни при прохождении, ни в результатах
- блокировка входа после 5 неудачных попыток; CSRF-защита форм; cookie
HttpOnly+SameSite - Content-Security-Policy только для собственного домена,
X-Frame-Options: DENY - параметризованные SQL-запросы, сортировка по белому списку, экранирование вывода (XSS), защита от CSV-инъекции
- ограничение размера загружаемых файлов; все изменения данных пишутся в журнал действий
- согласие на обработку данных при регистрации, политика конфиденциальности и обезличивание журнала при удалении пользователя
Фотографии РТСУ и обложки дисциплин — настоящие снимки с Wikimedia Commons под свободными лицензиями,
авторы перечислены в docs/IMAGE_CREDITS.md и на странице сайта /credits.
Тимур Чибряков · Российско-Таджикский (Славянский) университет · 2026









