프로젝트 배경
온라인 교육이 빠르게 확산됨에 따라 기존 종이 기반 시험 방식은 현대 교육 환경의 요구를 충족하기 어려워졌습니다. 교육 기관은 대규모 시험 운영, 자동화된 성적 집계, 효율적인 데이터 관리를 지원하는 안정적인 온라인 시험 플랫폼이 필요합니다. 이러한 요구를 바탕으로 문제은행 관리, 스마트 시험지 생성, 실시간 시험 진행, 자동 채점, 성적 분석 등 핵심 기능을 갖춘 시스템을 구축했으며, 관리자·교사·학생 세 가지 역할 권한 관리를 지원합니다.
기술 스택
백엔드
| 기술 | 버전 | 용도 |
|---|---|---|
| Spring Boot | 3.2.7 | 핵심 프레임워크 |
| MyBatis Plus | 3.5.5 | ORM |
| JWT | - | 인증·인가 |
| Redis | - | 캐시 및 세션 |
| MySQL | 5.5+ | 데이터베이스 |
| WebSocket | - | 실시간 데이터 푸시 |
| EasyExcel | - | Excel 가져오기/내보내기 |
| Lombok | - | 보일러플레이트 코드 감소 |
프론트엔드
| 기술 | 버전 | 용도 |
|---|---|---|
| Vue | 3.4.21 | 프론트엔드 프레임워크 |
| Vite | 4.5.0 | 빌드 도구 |
| Element Plus | 2.13.2 | UI 컴포넌트 라이브러리 |
| Pinia | 2.1.7 | 상태 관리 |
| Vue Router | 4.3.0 | 라우팅 |
| ECharts | 5.4.3 | 데이터 시각화 |
| Vue I18n | - | 국제화 |
| Axios | 1.6.8 | HTTP 통신 |
역할별 기능 모듈
- 관리자: 사용자 관리(교사/학생 CRUD), 학급 관리, 과목 관리, 시스템 공지사항, 데이터 통계(가입 추이, 인원 집계)
- 교사: 문제은행 관리(객관식·주관식·참거짓·빈칸·단답형, Excel 일괄 등록/내보내기), 시험지 관리(수동/랜덤 생성, 미리보기), 시험 관리(정식/모의고사 발행, 실시간 모니터링), 성적 관리(객관식 자동 채점, 주관식 온라인 채점, 성적 내보내기), 시험 알림(발송 및 읽음 확인), 데이터 통계(학급 성적, 학기 분석, 학생 추이)
- 학생: 시험 센터(알림 확인, 정식/모의고사 응시), 성적 조회(점수 확인, 분석, 오답回顾), 개인 센터(오답노트, 즐겨찾기, 개인 통계), 시스템 공지사항
주요 기술 포인트
1. 부정행위 방지 체계
시험 중 화면 전환 감지, 제한 시간 자동 제출, 문제 및 선택지 순서 랜덤화, 단일 기기 로그인 제한 등 다양한 방어 전략을 적용했습니다.
@MessageMapping("/monitor/violation")
public void processViolation(ProctorEvent evt) {
String violationKey = "proctor:" + evt.getAttemptId();
Long violationCnt = stringRedisTemplate.opsForValue().increment(violationKey);
if (violationCnt != null && violationCnt >= MAX_VIOLATION_THRESHOLD) {
forceSubmitAttempt(evt.getAttemptId());
}
}
2. 스마트 시험지 생성
수동 출제와 랜덤 출제 두 가지 방식을 지원합니다. 랜덤 출제는 문제 유형별 개수와 배점을 설정하면 시스템이 문제은행에서 무작위로 추출하여 구성합니다.
public ExamPaper buildRandomPaper(PaperSpec spec) {
List<QuizItem> selectedItems = new ArrayList<>();
for (QuizCategory cat : spec.getCategories()) {
List<QuizItem> pool = quizMapper.pickRandomByCategory(
cat.getCategoryId(), cat.getRequiredCount()
);
selectedItems.addAll(pool);
}
Collections.shuffle(selectedItems);
return assemblePaper(selectedItems, spec);
}
3. 자동 채점 및 주관식 보조 채점
객관식(단일선택, 다중선택, 참/거짓)은 제출 즉시 자동 채점되며, 빈칸 문제는 복수 정답 매칭을 지원하고 단답형은 교사가 온라인으로 채점합니다.
public void runAutoGrading(AttemptRecord attempt) {
List<StudentAnswer> answerList = answerMapper.findByAttemptId(attempt.getId());
int earnedScore = 0;
for (StudentAnswer ans : answerList) {
QuizItem quiz = quizMapper.selectById(ans.getQuizId());
switch (quiz.getQuizType()) {
case SINGLE:
case TRUE_FALSE:
if (ans.getContent().equals(quiz.getAnswerKey())) {
ans.setAwardedScore(quiz.getMaxScore());
earnedScore += quiz.getMaxScore();
}
break;
case MULTIPLE:
int partial = computePartialScore(ans, quiz);
ans.setAwardedScore(partial);
earnedScore += partial;
break;
default:
break;
}
answerMapper.updateById(ans);
}
attempt.setCalculatedScore(earnedScore);
attemptMapper.updateById(attempt);
}
4. 읽음/안 읽음 알림 시스템
교사가 시험 알림을 발송하면 학생 측 사이드바에 미확인 배지가 표시되며, 조회 시 자동으로 읽음 처리됩니다. 전체 읽음 처리 기능도 제공합니다.
<template>
<div class="alert-panel">
<div v-for="item in alertList" :key="item.id" class="alert-row">
<span :class="{ 'is-unread': !item.readFlag }">{{ item.title }}</span>
<el-badge v-if="!item.readFlag" value="N" />
<el-button v-if="!item.readFlag" @click="toggleRead(item)">
읽음 처리
</el-button>
</div>
</div>
</template>
5. Excel 일괄 가져오기/내보내기
EasyExcel을 활용해 문제 일괄 등록과 성적 보고서 내보내기를 구현했습니다. 가져오기 시 데이터 형식 자동 검증을 수행합니다.
@PostMapping("/upload/quiz-batch")
public ApiResponse<String> batchUploadQuiz(@RequestParam("file") MultipartFile upload) {
List<QuizImportVO> rows = EasyExcel.read(upload.getInputStream())
.head(QuizImportVO.class)
.sheet()
.doReadSync();
List<String> validationErrors = verifyQuizData(rows);
if (!validationErrors.isEmpty()) {
return ApiResponse.fail("가져오기 실패: " + String.join("; ", validationErrors));
}
quizService.saveBatch(mapToEntities(rows));
return ApiResponse.success(rows.size() + "건 등록 완료");
}
6. 국제화 지원
Vue I18n을 통해 중국어/영어 전환을 지원하며, 페이지 새로고침 없이 실시간 언어 전환이 가능합니다.
import { createI18n } from 'vue-i18n'
import messagesZh from './locales/zh-CN'
import messagesEn from './locales/en-US'
const i18nInstance = createI18n({
legacy: false,
locale: localStorage.getItem('appLang') || 'zh-CN',
fallbackLocale: 'en-US',
messages: {
'zh-CN': messagesZh,
'en-US': messagesEn
}
})
7. 데이터 시각화 통계
ECharts를 활용해 관리자(가입 추이, 역할 분포), 교사(학급 성적 분포, 학생 추이, 문제 정답률), 학생(개인 성적 추이, 지식 포인트 달성도) 각각에 맞는 차트를 제공합니다.
const renderScoreTrendChart = () => {
const dom = document.getElementById('scoreTrend')
const instance = echarts.init(dom)
instance.setOption({
title: { text: '최근 10회 시험 성적 추이', left: 'center' },
tooltip: { trigger: 'axis' },
xAxis: { type: 'category', data: ['1차','2차','3차','4차','5차','6차','7차','8차','9차','10차'] },
yAxis: { type: 'value', min: 0, max: 100 },
series: [{
data: [85, 88, 82, 90, 87, 92, 89, 94, 91, 95],
type: 'line',
smooth: true,
areaStyle: {
color: new echarts.graphic.LinearGradient(0, 0, 0, 1, [
{ offset: 0, color: 'rgba(102,126,234,0.3)' },
{ offset: 1, color: 'rgba(102,126,234,0.05)' }
])
},
itemStyle: { color: '#667eea' },
lineStyle: { width: 3 }
}]
})
}
핵심 코드
통일된 응답 래퍼
public class ApiResponse<T> {
private Integer status;
private String message;
private T payload;
public static <T> ApiResponse<T> success() {
return success(null);
}
public static <T> ApiResponse<T> success(T data) {
ApiResponse<T> resp = new ApiResponse<>();
resp.status = 200;
resp.message = "success";
resp.payload = data;
return resp;
}
public static <T> ApiResponse<T> fail(String msg) {
ApiResponse<T> resp = new ApiResponse<>();
resp.status = 500;
resp.message = msg;
return resp;
}
}
JWT 로그인 인증
@RestController
@RequestMapping("/api/account")
public class AccountController {
@PostMapping("/signin")
public ApiResponse<String> signin(@RequestBody LoginRequest req) {
String cachedCaptcha = stringRedisTemplate.opsForValue()
.get("captcha:" + req.getSessionId());
if (!req.getCaptcha().equalsIgnoreCase(cachedCaptcha)) {
return ApiResponse.fail("인증코드가 올바르지 않습니다");
}
UserAccount account = accountService.authenticate(
req.getUsername(), req.getPassword()
);
if (account == null) {
return ApiResponse.fail("아이디 또는 비밀번호를 확인해 주세요");
}
String jwt = JwtHelper.createToken(account.getId(), account.getRoleType());
return ApiResponse.success(jwt);
}
}
시험 타이머 컴포넌트
<template>
<div class="countdown-bar" :class="{ 'urgent': leftSeconds < 300 }">
<el-icon><Timer /></el-icon>
<span>{{ prettyTime(leftSeconds) }}</span>
</div>
</template>
<script setup>
import { ref, onMounted, onUnmounted } from 'vue'
const props = defineProps({ deadline: Number })
const emit = defineEmits(['expired'])
const leftSeconds = ref(0)
let intervalId = null
const prettyTime = (sec) => {
const h = Math.floor(sec / 3600)
const m = Math.floor((sec % 3600) / 60)
const s = sec % 60
return `${String(h).padStart(2,'0')}:${String(m).padStart(2,'0')}:${String(s).padStart(2,'0')}`
}
onMounted(() => {
intervalId = setInterval(() => {
leftSeconds.value = Math.max(0, Math.floor((props.deadline - Date.now()) / 1000))
if (leftSeconds.value === 0) {
emit('expired')
clearInterval(intervalId)
}
}, 1000)
})
onUnmounted(() => clearInterval(intervalId))
</script>
Vue3 Composition API 실천
<script setup>
import { ref, onMounted, computed } from 'vue'
import { useExamStore } from '@/stores/exam'
import { useI18n } from 'vue-i18n'
const { t } = useI18n()
const examStore = useExamStore()
const isLoading = ref(false)
const activeIndex = ref(0)
const answerMap = ref({})
const progressRatio = computed(() => {
return (Object.keys(answerMap.value).length / examStore.quizList.length) * 100
})
const recordAnswer = (quizId, val) => {
answerMap.value[quizId] = val
}
const finalizeExam = async () => {
isLoading.value = true
try {
await examStore.submitAttempt(answerMap.value)
ElMessage.success(t('exam.submitted'))
} finally {
isLoading.value = false
}
}
onMounted(() => examStore.loadQuizList())
</script>