학습 결과 제공 범위

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

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

지표의 의미와 결과 구조

• 읽기 속도: 정확하게 발음한 단어 수/분입니다. 단순 발화 단어 수/분과 구분합니다. wpm·hesitationAvgSec와 세 판정 비율은 소수점 한 자리 문자열로 제공하며 미준비 값은 null입니다.
• 머뭇거림 시간: 현재 RAV3가 선택한 문장별 최고점 녹음의 총 머뭇거림 시간을 기존 방식으로 집계한 값입니다. 머뭇거림 한 번의 평균 길이가 아닙니다.
• 전체 녹음 이력·시도 횟수: RA는 해당 학습 차시의 콘텐츠별 모든 저장 녹음 결과를 반환합니다. sentences[].attempts[].attemptIndex는 각 녹음의 순번이고 totalAttempt는 해당 콘텐츠의 전체 시도 수입니다. 분석 중이거나 실패한 녹음도 내부 이력에서 제거하지 않습니다. 외부 반환은 결과 공개·준비 상태를 따르며, 결과 본문을 제공할 때 측정값이 없는 시도는 null로 표시하고 다른 시도의 점수로 대체하지 않습니다. 전체 점수·통계는 현재 RAV3의 문장/콘텐츠별 최고점 선택·집계 방식을 그대로 사용하며, 종합 코멘트도 같은 집계를 근거로 생성합니다.
• 단어 위치: 평가 구간은 tokenIndex로 순서를 표시하며 startIndex·endIndex는 originalText의 UTF-16 시작 포함·끝 제외 위치를 정수로 반환합니다. 토큰 순서는 시도마다 1부터, 문자 위치는 0부터 시작합니다.
• 문법 교정: grammarCorrections[]에는 틀린 문장만 포함하며 수정 한 건당 항목 하나로 반환합니다. 한 문장에 수정이 여러 개면 originalSentence·correctedSentence가 반복되며, 각 항목의 wrongToken·correctedToken·feedback은 해당 수정에 대응합니다. 반환 항목의 correctYn은 "N"이며 맞는 문장은 포함하지 않습니다. 분석 완료 후 틀린 문장이 없으면 []를 반환하고, 미준비 상태는 null로 구분합니다. 전체 교정문 correctedEssay에는 맞는 문장도 유지합니다.
• 미션: 정량·정성 미션 모두 제목(title), 판정 근거(basis), 통과 여부(isPassed)만 제공합니다. achievementRate는 제외하며 실제 수행 개수는 basis에 표시합니다.
• 음원: 존재하는 음원만 제공합니다. 만료되는 음원 URL은 결과 재조회로 갱신하는 방식을 제안합니다.

전체 종합 코멘트

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

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

추후 논의 항목

항목	현재 제약	제공 규칙
Speaking 발음·음성 유창성 점수	현재 커스텀 루브릭 평가는 STT 텍스트 기반이므로 실제 발음·속도·멈춤을 평가하지 못함	1차 평가에서 제외하며 지원 여부·평가 방식은 추후 결정. 연동 전에는 FLUENCY/PRONUNCIATION 객체의 score/strengths/improvements를 모두 JSON null로 반환. ready 상태에서도 동일하며 RA 결과 제공에는 영향 없음

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

1차 출시 제외 항목

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

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

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