영어 단어 학습 앱 다중 교재 구조 구축

주요 기능

무엇을 만들었나요?

• 교재 선택 화면 — 학습자가 앱에 들어오면 자신이 보유한 교재 목록을 불러와 학습할 교재를 고릅니다. 아직 등록하지 않은 교재는 잠금 표시로 구분됩니다.
• 시리얼 코드로 교재 열기 — 학습자가 8자리 시리얼 코드를 입력하면 그 코드에 연결된 교재가 계정에 매핑되어 바로 학습할 수 있게 됩니다.
• 교재별 학습 진도 — 사용자와 교재를 묶어 진도를 저장하므로, 한 사람이 여러 교재를 각각의 진도로 동시에 학습할 수 있습니다.
• 일일 학습과 단어 상세 — 하루에 학습할 단어 수를 고르면 그 기준으로 일자별 학습 목록이 구성되고, 단어마다 발음기호·뜻·예문을 확인하며 진행합니다.
• 북마크와 북마크 테스트 — 학습 중 저장한 단어를 모아 보고, 저장한 단어만으로 테스트를 볼 수 있습니다. 북마크 응답에 예문이 함께 내려가도록 보완했습니다.
• 챌린지 테스트 — 교재 전체 단어에서 70·100·150개를 무작위로 뽑아 객관식으로 출제합니다.
• 관리자 교재 등록 — 운영자가 교재명과 설명, 표지 이미지를 넣고 챕터·단어·뜻·예문 CSV 네 개를 올리면 교재 한 권이 통째로 등록됩니다.
• 관리자 시리얼 코드 발급 — 운영자가 교재를 고르고 수량을 입력하면 8자리 코드가 일괄 생성되고 엑셀 파일로 내려받을 수 있습니다. 단어·뜻·예문·오답 선지는 관리자 웹에서 개별 수정합니다.

해결 과정

제약을 어떻게 풀었나요?

1. 제약 1

   운영 중인 서비스라 스키마를 바꾸는 동안 서비스를 멈출 수 없었고, 업데이트하지 않은 구버전 앱이 계속 요청을 보내는 상황이었습니다.

   의사결정: 기존 데이터를 모두 기본 교재 한 권에 소속시키고, 교재를 지정하지 않은 요청은 서버가 기본 교재로 처리하도록 정했습니다. 구버전 앱을 강제 업데이트시키지 않기 위한 선택이었습니다.

   구현: 교재 테이블을 만들고 챕터·시리얼 코드·학습 진도에 교재 외래키를 추가한 뒤, 기존 챕터 41건과 시리얼 코드 55,367건, 학습 상태 7,494건을 기본 교재로 옮겼습니다. 마이그레이션은 단계별 SQL로 나누고 롤백 스크립트를 함께 작성해 적용 후 검증했습니다.

2. 제약 2

   교재가 여러 권이 되면 교재마다 1번 챕터가 생기고, 한 사용자가 교재별로 서로 다른 진도를 갖게 되어 기존의 단일 제약조건과 충돌했습니다.

   의사결정: 중복을 막던 제약을 교재 단위 복합 조건으로 다시 설계했습니다. 데이터 단계에서 교재별 분리를 보장해야 앱과 관리자 웹 양쪽의 예외 처리를 줄일 수 있다고 판단했습니다.

   구현: 챕터는 번호만 보던 제약을 교재와 번호를 함께 보는 제약으로, 학습 진도는 사용자만 보던 제약을 사용자와 교재를 함께 보는 제약으로 바꿨습니다. 그 결과 교재마다 같은 챕터 번호를 쓰면서도 진도는 따로 쌓입니다.

3. 제약 3

   이전 버전과 현재 버전의 도메인·인프라가 섞여 있어 운영 중 작업 대상을 혼동할 위험이 있었습니다.

   의사결정: 코드와 인프라의 경계를 먼저 나눈 뒤 기능 작업을 진행하기로 했습니다.

   구현: 서버·안드로이드·iOS·관리자 웹을 각각 별도의 비공개 저장소로 분리하고, 서버의 DB 접속 설정을 운영·개발·테스트 환경으로 나눠 로드하도록 정리했습니다.

결과

무엇이 달라졌나요?

기존 데이터 이관

챕터 41건 · 시리얼 코드 55,367건 · 학습 상태 7,494건을 기본 교재로 이관

근거: 고객 제공 개발 완료 보고서의 마이그레이션 적용·검증 기록 (비공개)

배포 준비 상태

iOS 1.1.6(빌드 9) · Android 1.1.0(버전코드 46) 빌드까지 완료, 교재 명칭·표지 자료 수령 후 스토어 제출

근거: 고객 제공 개발 완료 보고서의 산출물 항목 (비공개)

화면

실제 화면과 구조

사용 기술