README.md

Voca Studio

웹 기반 영어 단어 학습 앱입니다. 로그인한 사용자별로 단어장, 그룹, 학습 기록이 분리되어 서버에 저장됩니다.

기능

• 반응형 웹 UI와 슬라이드 메뉴
• 홈 대시보드에서 단어 테스트, 암기하러가기, 단어장 생성, 학습 기록 바로가기
• 이메일, 아이디, 비밀번호, 이름 기반 회원가입
• 로그인, 자동 로그인 유지, 로그아웃, 비밀번호 변경
• 설정 화면에서 계정, 다크모드, 로그인 세션 조회 및 다른 기기 종료
• 사용자별 단어장, 그룹, 학습 기록 관리
• JSON 파일 업로드로 단어장 추가
• 직접 입력으로 단어장 추가
• 단어장 이름, 그룹, 메모 저장 및 수정
• 단어장 관리 화면에서 검색, 전체 단어 보기, 퀴즈/암기 시작, JSON 내보내기 및 삭제
• 단어장 보기 화면에서 영어, 뜻, 품사 표시 및 영어 발음 듣기
• 설정 화면에서 단어장 관리, 그룹관리, 비밀번호 변경
• 관리자 전용 페이지에서 사용자 계정 정보/권한 수정, 사용자 삭제, 서버 감사로그, 전체 사용자 단어장 조회
• 관리자 단어장 보관소에 JSON 단어장을 업로드하고 원하는 사용자에게 복사 배포
• 암기 모드: 단어장 선택, 1초~10초 표시 시간, 영어/한국어/둘 다 표시 선택
• 암기 모드에서 선택한 시간 후 상대 언어를 3초 동안 표시
• 한글, 영어, 랜덤 출제 모드
• 10개, 20개, 30개, 40개, 50개 테스트
• 3초, 5초, 6초 표시 시간
• 단어 수가 부족하면 섞어서 반복 출제
• 퀴즈 중단
• 이전 학습 기록 검색 및 조회
• 학습 기록 CSV, TXT, JSON 다운로드

개발 실행

npm install
npm run dev

기본 주소는 http://localhost:3000입니다.

운영 배포

npm run build
npm start

• APP_ORIGIN 또는 APP_ORIGINS에 실제 서비스 주소를 설정하면 API 쓰기 요청의 Origin 검증에 사용됩니다.
• HTTPS 리버스 프록시 뒤에서 실행하면 TRUST_PROXY=1을 설정하세요.
• 프록시 설정과 무관하게 로그인 쿠키에 Secure 속성을 강제하려면 COOKIE_SECURE=1을 설정하세요.