Files
hyungi_document_server/migrations/210_quiz_sessions_mode.sql
Hyungi Ahn 13404cd366 feat(study): 같은 유형 과밀 방지 — 출제 단계 spacing (PR-12-B)
학습 의미: 한 quiz 세션 안에서 같은 유형 문제가 과도하게 몰리지 않게 분산.
같은 유형을 없애는 게 아니라 펼치는 것 — dedup/제거 프레임 금지.

- 마이그레이션 210: study_quiz_sessions.quiz_mode VARCHAR(30) DEFAULT 'random'
- ORM: StudyQuizSession.quiz_mode 필드
- service.related_types: apply_type_spacing helper 추가
  - SPACING_THRESHOLD=0.88 (회차 무관 — PR-12-A 회차 필터 재사용 X)
  - PER_TYPE_CAP=2 (local neighbor cap, transitive cluster 보장 X)
  - SPACING_BUFFER_RATIO=2.0
  - 3단계 fallback: ready spacing → pending 보충 → hold cap 위반 fallback
  - debug 로그 type_spacing_applied subject=... ready=N selected=M ...
- _select_questions_for_topic: subject bucket 단위 spacing (과목 균등 보호)
- QuizMode Enum (random) — 향후 frequent_focus/wrong_variants 예약
- start_quiz_session 에 quiz_mode 받기 + apply_spacing 전달
- 프론트 startNewQuiz body 에 quiz_mode='random' 명시

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-29 08:45:15 +09:00

8 lines
392 B
SQL

-- 210_quiz_sessions_mode.sql (PR-12-B)
-- 출제 모드 메타 영구 보존 — 향후 모드별 정답률 분석용.
-- 권장값: random (1차) / frequent_focus / wrong_variants (PR-12-C 예약).
-- 강한 enum 미사용 — VARCHAR 권장값 패턴 (PR-9 outcome 와 동일).
ALTER TABLE study_quiz_sessions
ADD COLUMN IF NOT EXISTS quiz_mode VARCHAR(30) NOT NULL DEFAULT 'random';