PKC Korean Learning App - 개발 진행 현황

📚 PKC Korean Learning App - 개발 진행 현황

작성일: 2025년 11월 24일
프로젝트: PKC Korean Learning App
개발 상태: 진행 중 (In Development)

프로젝트 소개

PKC Korean Learning App은 전 세계 학습자가 자신의 모국어로

한국어를 배울 수 있도록 설계된 웹 기반 다국어 학습 플랫폼이에요.

현재 핵심 기능 구현을 완료하고, 11개국어 지원을 위한 데이터 구축 단계를 진행하고 있답니다.​

기술 스택 및 아키텍처

사용 기술

• 프론트엔드: HTML5, CSS3, JavaScript (ES6+)
• 데이터: JSON 기반 구조화된 언어팩
• 주요 기능: Web Speech API (TTS), LocalStorage (사용자 설정 저장)​

 

디렉토리 설계

로직(js)과 데이터(locales)를 완전히 분리하여 확장성을 최대화했어요.​

Root/

├── index.html # 메인 진입점

├── css/ # 스타일시트

├── js/ # 핵심 로직

│ ├── app.js # 앱 초기화

│ ├── i18n.js # 다국어 처리 엔진

│ ├── hangul-learning.js # 한글 학습 모듈

│ ├── vocabulary.js # 어휘 학습 모듈

│ ├── grammar.js # 문법 학습 모듈

│ └── flashcard.js # 플래시카드 모듈

├── data/ # 기본 한국어 데이터

└── locales/ # 다국어 언어팩

   ├── en/ # 영어

   ├── ja/ # 일본어

   └── ... # 총 11개 언어

핵심 구현 기능

독자적 I18n 엔진

자체 개발한 국제화 엔진은 다음과 같은 특징을 가지고 있어요: PKC-Korean-Learning-App​

• 동적 로딩: 언어 변경 시 해당 언어팩만 비동기로 로드하여 성능 최적화
• 경로 관리: locales/{lang}/{lang}_{type}.json 패턴 자동 인식
• Fallback 시스템: 파일 누락 시 한국어 데이터로 자동 대체

데이터 정규화

각 언어 파일의 고유 키(English, Japanese 등)를 내부적으로 meaning 속성으로 통일하여,

UI 코드 수정 없이 모든 언어 데이터를 표시할 수 있도록 구현했답니다.​

학습 모듈

• 한글 배우기: 자음·모음·받침 탭 구분, 언어별 맞춤 설명
• 어휘 학습: 카테고리별 필터링, TTS 발음 듣기
• 플래시카드: 카드 뒤집기 인터랙션, 학습 진도 저장
• 문법 학습: SOV 어순, 문법 시스템 설명​

다국어 지원 현황

지원 언어 (11개국)

영어, 일본어, 중국어, 러시아어, 태국어, 독일어, 스페인어, 프랑스어, 이탈리아어, 포르투갈어, 네덜란드어​

진행 상태

• ✅ 데이터 구조 설계 완료
• ✅ 10개 언어 기본 단어 번역 데이터 생성 (_words.json)
• 🔄 UI 및 설명 데이터 JSON 파일 생성 및 폴더 구조화 진행 중​

향후 로드맵

1. UI 통합 테스트: 생성된 언어팩의 실제 연동 상태 최종 점검
2. 문법 설명 고도화: 언어권별 맞춤형 문법 설명 보강
3. 반응형 디자인: 긴 텍스트(독일어, 러시아어 등) 대응 레이아웃 강화​

마치며

PKC Korean Learning App은 데이터와 로직이 분리된 유연한 아키텍처를 기반으로,

언어팩 파일만 추가하면 즉시 새로운 언어로 서비스할 수 있는

확장 가능한 플랫폼으로 개발하고 있어요.

전 세계 학습자들이 자신의 모국어로 한국어를 쉽게 배울 수 있는 날을 기대해주세요!​