학습 결과 제공 범위

아래의 ‘제공 가능’은 현재 데이터와 평가 기능으로 연동 개발이 가능하다는 의미입니다. 원천 데이터가 없는 개별 결과까지 보장하는 의미는 아닙니다.

영역	요청 항목	제공 방향
RA	정확성·유창성 점수와 별점	기존 분석 결과 활용 가능
RA	좋음·보통·부족 단어 수와 비율	기존 단어별 평가를 활용하고 동일 판정 기준으로 집계
RA	문장별 점수·단어 하이라이트·학생 녹음	기존 데이터 활용 가능. 단어·문단 단위 활동도 있어 콘텐츠 유형을 함께 구분
RA	속도·머뭇거림 지표와 안내 문구	기존 지표 활용 가능. 단위와 의미는 아래 설명에 맞춰 제공
WR	제출 원문·교정문·교정 이유	제공 가능. 교사 수정이 있으면 현재 수정 결과 반영. 원문 문단 서식 보존은 별도 검토
SP	제출 녹음·STT 텍스트	유효 녹음과 전사문 제공 가능
WR·SP	미션 통과 여부와 판정 근거	기존 평가 결과 활용 가능
WR·SP	아발론 루브릭별 점수·강점·개선점	텍스트 평가가 가능한 기준은 기존 커스텀 루브릭 활용. 실제 생성된 항목만 제공
공통	종합 점수	RA의 정확성·유창성 평균 및 WR·SP의 100점 환산은 유효 점수 범위·가중치·미평가 처리 규칙 확정 후 계산
RA·WR·SP	전체 종합 코멘트	아발론 연동 학습에 한해 생성하여 data.comment로 제공. 1차 출시 포함

지표의 의미와 결과 구조

• 읽기 속도: 정확하게 발음한 단어 수/분입니다. 단순 발화 단어 수/분과 구분합니다.
• 머뭇거림 시간: 선택된 각 녹음의 총 머뭇거림 시간을 평균한 값입니다. 머뭇거림 한 번의 평균 길이가 아닙니다.
• 대표 녹음: 현재 RA 결과는 콘텐츠별 최고점 시도 기준입니다. 마지막 녹음과 다를 수 있으므로 선택된 시도와 실제 시도 횟수를 구분합니다.
• 단어 위치: 원문의 startIdx·endIdx를 유지합니다. 기준 원문과 UTF-16 시작 포함·끝 제외 규칙을 명시하고, 원문과 같은 숫자 문자열로 반환하는 안입니다. 기준 텍스트 제공 방식은 최종 계약에서 확정합니다.
• 문법 교정: 원문의 grammarCorrections[]를 유지하고 수정 한 건당 항목 하나로 펼치는 안입니다. 한 문장에 수정이 여러 개면 originalSentence·correctedSentence가 반복되며, 각 항목의 wrongToken·correctedToken·feedback은 해당 수정에 대응합니다. 맞는 문장은 correctYn=Y, 수정 토큰은 null로 표현하는 안입니다.
• 미션 달성률: 단어 수 등 정량 조건은 산식을 정해 계산할 수 있습니다. 정성 조건은 통과 여부와 근거를 제공하며 임의의 달성률을 만들지 않습니다.
• 음원: 존재하는 음원만 제공합니다. 만료되는 음원 URL은 결과 재조회로 갱신하는 방식을 제안합니다.

전체 종합 코멘트

아발론 연동 학습의 RA·WR·SP 결과에 전체 종합 코멘트를 제공합니다. 기존 점수·루브릭·미션·교정 결과를 바탕으로 잘한 점과 다음 연습 방향을 요약하여 원문의 data.comment에 담습니다. 일반 플랭이나 다른 파트너 학습에는 이 코멘트를 추가 생성하지 않습니다.

• 기본 평가가 완료된 뒤 비동기로 생성합니다. 학생 창은 제출 완료 후 닫히며 코멘트 생성 완료를 기다리지 않습니다.
• 코멘트 생성 중에는 resultStatus=processing, unavailableReason=overall_comment_in_progress입니다. 코멘트까지 준비되면 ready와 comment를 함께 반환합니다.
• 제한된 재시도 후에도 생성에 실패하면 resultStatus=failed, unavailableReason=overall_comment_generation_failed로 표시합니다. 빈 코멘트를 정상 완료로 반환하지 않습니다.
• 재분석이나 교사 수정으로 근거가 달라지면 새 결과에 맞춰 재생성합니다. 이전 코멘트를 변경된 점수와 함께 반환하지 않습니다.
• 결과 재조회는 저장된 코멘트를 읽으며 매번 새로 생성하지 않습니다. 실제 평가하지 않은 발음·유창성에 대한 판단이나 취약 문법·단어 누적 통계를 추가하지 않습니다.

별도 개발 또는 협의가 필요한 항목

항목	현재 제약	제안
Speaking 발음·음성 유창성 점수	현재 커스텀 루브릭 평가는 STT 텍스트 기반이므로 실제 발음·속도·멈춤을 평가하지 못함	해당 축이 필수이면 별도 음성 평가 개발. 루브릭 문구 입력만으로 지원되는 항목으로 보지 않음

아발론 루브릭의 실제 항목·점수 기준을 적용한 샘플 태스크로 결과를 검증합니다. Writing의 주제 연관성·구성·뒷받침 내용·어휘·문법처럼 텍스트에서 판단 가능한 축과 실제 음성을 들어야 하는 축을 구분합니다.

1차 출시 제외 항목

취약 발음 단어와 취약 문법 통계는 1차 출시에 포함하지 않습니다.

• 취약 발음 단어 목록·순위, 워드클라우드, 관련 단어별 음원 및 월간 리포트
• 취약 문법 통계, 오류 유형별 누적 통계, 시제·관사·수일치 등 문법 TOP3
• 위 통계를 위한 집계 API와 리포트 iframe

개별 학습의 단어별 발음 결과·문법 교정·루브릭 결과는 제공합니다. 통계 기능의 후속 제공 시점은 미정입니다.