개인 학습용 포크: KSH0660/Yumi-Opic — 푸시 연결 확인용입니다.

Yumi OPIc

OPIc AL 준비를 위한 개인 연습 앱입니다. 서베이 11개 주제와 돌발 9개 주제를 연습할 수 있습니다.

현재 범위

아래 11개 서베이 토픽과 별도의 돌발 문제은행을 제공합니다.

• 혼자 아파트 거주
• 음악 듣기
• 해변
• 공원
• 콘서트
• 쇼핑
• 조깅
• 걷기
• 헬스
• 집에서 보내는 휴가
• 해외여행

활성 문제은행은 src/data/survey-bank.ts를 중심으로 구성합니다. 대부분의 주제는 기본 8문항에 롤플레이 3문항을 더해 11문항입니다. 음악 듣기는 13문항, 제공 자료의 고정 세트를 사용하는 공원은 19문항입니다.

• 묘사 2문항
• 습관 1문항
• 경험 2문항
• 기억에 남는 경험 1문항
• 롤플레이 질문하기(11번) 1문항
• 롤플레이 문제 해결(12번) 1문항
• 롤플레이 관련 경험(13번) 1문항
• 비교 1문항
• 이슈 1문항

서베이는 총 196문항, 돌발은 144문항입니다. 기출 복원·제공 자료·출제 유형 기반 문항을 모두 후보에 둡니다. 실전 모의고사는 명시적으로 제외한 걷기·콘서트·조깅 33문항을 뺀 307문항을 활용하며, 누적 출제 이력에 따라 세트를 고릅니다. 출제 규칙에 막혀 후보에서 빠지는 문항은 없습니다.

화면 구성

홈(/)은 오늘 무엇을 연습할지 고르는 화면입니다. 배경 설문은 한 번 정하면 브라우저에 남는 설정이라 /survey 로 따로 두었습니다.

• 마지막 연습이 있으면 맨 위에 이어서 연습하기가 붙습니다. 주제별 연습은 같은 주제로, 모의고사·랜덤 연습은 같은 모드로 새로 뽑아 다시 시작합니다.
• 아래에 주제별 연습·실전 모의고사·1문제 랜덤 연습·1토픽 랜덤 연습과 최근 기록 5개가 있고, 그다음에 지금 고른 배경 설문 상태와 배경 설문 수정 링크가 있습니다.
• 저장된 설정이 없는 첫 방문만 /survey 로 보냅니다. 실제 시험처럼 Step 1 부터 시작하되, 두 번째 방문부터는 설문을 다시 지나지 않습니다.

배경 설문(/survey)은 실제 오픽 시험의 Background Survey 화면을 그대로 옮겨 놓은 것입니다. 문항 8개와 선택지 84개의 문구·순서·선택 방식은 2026 오픽 서베이 항목 안내를 따르며, src/data/survey-form.ts 한 곳에서 관리합니다.

• 1~3번(직업·학생·수강)은 실제 시험처럼 고를 수 있지만 이 앱은 업무·학업 주제를 다루지 않아 연습 문제로 이어지지 않습니다. 기본값은 일 경험 없음, 학생 아님, 수강 후 5년 이상 지남입니다.
• 문제은행이 있는 11개 항목에는 연습 가능 표시가 붙고, 처음에는 이 항목이 모두 켜져 있습니다. 나머지 항목도 실제 시험처럼 고를 수 있으나 고르면 문제 준비 중 으로 표시하고 출제에는 쓰지 않습니다.
• 4~8번에서 고른 항목이 곧 출제 범위입니다. 연습 가능한 항목을 3개 이상 골라야 주제별 연습과 실전 모의고사를 시작할 수 있고, 실제 시험의 합산 12개 기준은 안내 문구로만 보여 줍니다.
• 아래 Next ▶ 는 홈으로 이어집니다. 연습 방식은 홈에서 고릅니다.
• 선택은 yumi-opic:settings 의 surveyChoiceIds 에 그대로 남고, 그 가운데 문제 은행이 있는 주제만 추린 값이 enabledSurveyIds 입니다. 두 값은 saveSurveyChoices 와 saveEnabledTopics 로만 함께 바뀝니다. 이 화면에 들어오면 아무것도 고치지 않아도 방문 사실이 저장돼, 홈이 다시 설문으로 되돌리지 않습니다.

나머지 화면은 다음과 같습니다.

• 주제별 연습(/topics): 서베이 11개·돌발 7개 주제를 분류 버튼으로 전환하는 목록. 주제마다 지금까지 연습한 횟수를 함께 보여 주고, 목록 아래에 주제별·랜덤 연습 기록이 쌓입니다.
• 실전 모의고사(/exam?mode=full): 시작 화면에서 배경 설문 주제를 고릅니다. 처음에는 11개가 모두 켜져 있습니다. 걷기·콘서트·조깅은 목록에 모의고사 제외로 남고 출제에서만 빠지며, 옆 링크로 따로 연습할 수 있습니다. 나머지 주제는 3개 이상 남겨야 합니다. 아래에 모의고사 기록을 보여 줍니다.
• 피드백 모아보기(/report?ids=…): 연습 기록 목록에서 고른 회차의 질문·답변·AI 피드백을 한 화면에 모아 보고, 그대로 인쇄해 PDF 로 저장합니다.

연습 기록은 화면마다 그 화면의 모드만 보여 주며, 전체 삭제도 그 목록에 보이는 기록만 지웁니다. 목록 왼쪽의 체크상자로 여러 회차를 골라 모아보기 · PDF 저장 하거나 선택 삭제할 수 있습니다. 홈의 최근 기록은 보기 전용이라 삭제와 모아보기는 각 화면의 목록에서 합니다.

화면 사이를 오가는 길

연습 화면에서 나갈 때는 늘 홈이 아니라 그 연습을 고른 목록으로 되돌아갑니다. 다음 주제를 고르려고 배경 설문을 다시 지나야 했던 것을 없애기 위해서입니다. src/lib/nav.ts 한 곳에서 정합니다.

화면	나가기	다음
주제별 연습·랜덤 연습	← 주제별 연습(/topics)	—
실전 모의고사	← 실전 모의고사(시작 화면)	—
연습 결과	위와 같음. 오른쪽에 홈 →	다른 주제 연습하기 →

답변이나 녹음이 있는 채로 연습 화면을 벗어나려 하면 확인창이 뜹니다. 기록은 결과 화면에 닿아야 처음 저장되기 때문입니다. 새로고침과 창 닫기는 브라우저 기본 확인창이 막지만, 브라우저 뒤로가기 버튼은 막지 않습니다.

연습 방식

실전 모의고사

선택한 배경 설문 주제와 돌발 주제를 섞어 실제 시험과 같은 번호 구조로 연습합니다. 주제는 모의고사 시작 화면에서 고르고, 선택값은 yumi-opic:settings 에 남습니다. 걷기·콘서트·조깅은 설문에서 골라도 모의고사와 랜덤 연습에는 나오지 않고 (DRAW_EXCLUDED_TOPIC_IDS), 주제별 연습에서만 풉니다.

2~15번은 다섯 구간으로 나눕니다.

구간	번호	유형	출처
세트 1	2·3·4	묘사 → 습관 → 경험	배경 설문 또는 돌발
세트 2	5·6·7	묘사 → 경험 → 기억에 남는 경험	배경 설문 또는 돌발
세트 3	8·9·10	묘사 → 경험 → 기억에 남는 경험	배경 설문 또는 돌발
롤플레이 세트	11·12·13	질문하기 → 문제 해결 → 관련 경험	배경 설문 또는 돌발
어드밴스 세트	14·15	비교 → 이슈	배경 설문 또는 돌발

구간을 채우는 방식은 주제가 고정 세트(fixedPracticeSets)를 선언했는지에 따라 갈립니다.

• 고정 세트를 선언한 주제는 자료의 표시 번호로 구간이 정해지고 원래 유형·순서를 그대로 냅니다. 위 표의 번호별 유형을 강요하지 않으므로, 집 COMBO 1의 묘사 → 습관 → 비교나 산업 COMBO 1의 묘사 → 묘사 → 경험도 자료 그대로 24번에 나옵니다. 57번과 8~10번은 유형 구성이 같은 한 쌍이라 서로의 자리에 들어갈 수 있습니다.
• 고정 세트가 없는 배경 설문 주제는 위 표의 번호별 유형을 그대로 따릅니다.
• 고정 세트가 없는 돌발 주제는 아래처럼 자료 순서를 따릅니다.

실제 시험처럼 세 구간은 배경 설문에서, 두 구간은 돌발에서 뽑습니다 (FULL_EXAM_SURPRISE_GROUPS). 돌발이 어느 구간에 들어갈지는 아래의 출제 우선순위를 고려해 정하고, 우선순위가 같으면 무작위로 고릅니다. 다섯 구간 중 두 곳을 고르는 열 가지 배치가 모두 나올 수 있습니다. 한 회차에 같은 주제가 두 구간에 나오지 않으며, 가능한 구간·주제 배정을 함께 비교해 완성된 세트로 시험을 만듭니다. 그래서 배경 설문 주제는 최소 3개를 골라야 합니다(MIN_FULL_EXAM_SURVEY_TOPICS).

롤플레이 구간(11~13번)은 배경 설문과 돌발 모두 들어갈 수 있지만, 실제 roleplay_* 문항을 가진 주제만 채웁니다. 자료 순서 세트로는 대신할 수 없습니다. 현재 이 구간에 들어갈 수 있는 돌발은 구직·진로, 예약, 지역 행사를 뺀 여섯 주제입니다.

출제 순서는 미출제 지문이 많은 조합 → 누적 노출 횟수가 적은 조합 → 오래전에 본 조합입니다. 같은 우선순위의 주제·세트는 무작위로 고릅니다. ID가 달라도 영문 지문이 같으면 같은 문제로 기억하며 대소문자·공백·문장부호 차이도 무시합니다. 롤플레이와 산업의 선행 질문 관계, 공원·집에서 보내는 휴가의 고정 세트는 그대로 유지합니다.

누적 이력은 이 브라우저의 yumi-opic:exam-exposure에 지문별 횟수와 마지막 노출 시각 등을 저장합니다. 실전 모의고사에서 실제 낭독이 시작되거나 지문·해석을 열었을 때 기록합니다. 준비 화면에서 다시 뽑기, 시작하기, 듣지 않고 건너뛰기는 기록하지 않습니다. 같은 회차의 재청취는 횟수를 늘리지 않으며, 결과에서 같은 시험을 다시 풀면 새 회차로 셉니다. 주제별·랜덤 연습은 이 모의고사 이력을 늘리지 않습니다.

결과 목록의 최근 20회 제한과 별개로 보관하므로 오래된 결과가 밀려나거나 목록에서 삭제되어도 출제 진도는 남습니다. 브라우저의 전체 사이트 데이터를 지우거나 코드의 clearHistory()로 전체 기록을 초기화하면 함께 초기화됩니다. 처음에는 남아 있는 과거 모의고사 결과 중 답변·답변 시간·힌트·재청취 기록이 있는 문항을 기존 이력으로 가져옵니다. 브라우저 저장이 차단된 환경에서는 새 청취 이력이 다음 추첨에 남지 않을 수 있습니다.

고정 세트가 없는 돌발은 주제마다 가진 유형이 제각각이라 번호별 유형을 강요하지 않습니다. 없는 유형을 지어내 연습량만 늘리는 대신 제공 자료 안에서만 세트를 만듭니다. (구직·진로를 뺀 여덟 돌발 주제는 고정 세트를 선언했으므로 위의 고정 세트 규칙을 따릅니다.)

• 일반 구간(24·57·8~10번)은 자료의 1번을 고정하고, 나머지 두 문항을 자료 순서를 지켜 무작위로 고릅니다. 1·2·3 뿐 아니라 1·2·4, 1·3·4도 나옵니다. 비교·이슈는 어드밴스 구간 몫이라 여기서 뺍니다. 앞 질문을 전제로 하는 산업 문항은 그 앞 질문 뒤에만 나옵니다.
• 어드밴스 구간(14~15번)만 비교 → 이슈 순서를 지킵니다. 두 유형을 모두 가진 네 주제 (재활용, 산업, 구직·진로, 직업·직장)만 이 구간에 들어갑니다.

화면과 결과에는 자료 번호가 아니라 시험 번호를 적습니다.

11~13번은 하나의 주제에서 이어지는 세트로 생성합니다. 11번에서 정보를 묻고, 12번에서 관련 문제를 해결하며, 13번에서는 이어지는 경험을 배경 → 문제 → 해결·행동 → 결과 구조로 말하는 연습을 합니다.

번호와 유형의 대응은 자주 나오는 순서를 정리한 것이며, 실제 시험에서 항상 같은 번호에 고정된다는 뜻은 아닙니다.

주제별 연습

돌발 주제는 src/data/surprise-bank.ts에 있으며, 제공 자료의 영어 지문·제목·번호·순서를 보존합니다. 한국어 해석도 함께 제공합니다. 돌발은 문항을 새로 지어내지 않고 제공 자료 144문항만 씁니다. 그래서 주제마다 가진 유형이 다르며, 모의고사도 그 범위 안에서 세트를 만듭니다.

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗