Quick Reference

Clarity는 문장을 소리 내어 읽거나 자유롭게 말하면 음성을 따라가며 속도와 진행 상황을 보여 주고, 세션이 끝난 뒤 말하기 점수와 연습 방향을 제시하는 iOS·Android 앱입니다.

연습: passage 읽기 / 짧은 drill / 자유 발화
피드백: teleprompter / waveform / pace / filler·flow·expression 점수
기록: 계정과 server database 없이 기기 로컬에 저장
선택: Expo 음성 인식, 로컬 분석과 선택형 AI coaching 구성을 살펴볼 때

살펴볼 지점

화면과 상태는 app, components, hooks에 두고, 점수·통계·문장 정렬 같은 순수 로직을 lib에, 음성 인식과 저장 같은 부수 효과를 services에 분리합니다. 순수 로직이 외부 service를 가져오지 않도록 한 구조라 모바일 UI 없이도 점수 계산과 기록 처리를 test할 수 있습니다.

음성 인식만으로 기본 점수를 만들고, Azure Speech를 연결하면 단어 단위 발음 평가를 추가합니다. 세션 뒤 AI coaching 문장은 Expo API route와 Vercel AI Gateway를 거쳐 생성하는 선택 기능입니다.

실행과 데이터 경계

음성 인식과 로컬 저장에 native module을 사용하므로 Expo Go가 아닌 development build가 필요합니다. iOS Simulator는 실제 음성 인식을 지원하지 않아 전체 흐름은 실기기에서 확인하거나 저장소의 mock practice 설정을 사용합니다.

연습 이력은 기기에 저장되지만 모든 기능이 완전한 로컬 처리라는 뜻은 아닙니다. Azure 발음 평가나 AI coaching을 켜면 해당 서비스로 전달되는 데이터, API 비용과 개인정보 처리 조건을 별도로 확인합니다. 설치에는 저장소가 사용하는 유료 icon package token도 필요할 수 있으므로 최신 환경 변수와 의존성을 먼저 확인합니다.