이 글의 핵심

화면보다 먼저 단어·문법·예문·음성 데이터를 분리해 관리하면 앱 수정과 확장이 쉬워지는 이유를 설명합니다.

한 항목의 필드를 먼저 정한다

예를 들어 영어 구동사라면 id, 표현, 뜻, 예문 목록, 한국어 해석, 난이도, 카테고리 같은 필드를 정합니다. 중국어라면 한자, 병음, 뜻이 추가될 수 있습니다. 화면에 필요한 정보를 먼저 표로 정리하면 나중에 JSON이나 Dart 모델로 옮기기 쉽습니다.

데이터와 화면을 분리

문장을 화면 코드에 직접 적어 넣으면 오타 하나를 고칠 때 소스 파일을 찾아 다시 빌드해야 합니다. 데이터를 JSON, CSV 또는 별도 Dart 데이터 파일로 관리하면 검수와 교체가 쉬워집니다. 같은 데이터로 앱, 웹, 영상 제작까지 연결하기도 편합니다.

고유 ID를 유지

표현이나 제목을 키로 사용하면 문구를 수정했을 때 즐겨찾기나 진행 기록이 끊길 수 있습니다. 변경되지 않는 고유 ID를 두고 화면에 보이는 텍스트는 별도로 관리하면 업데이트가 안전합니다.

작게 테스트하고 늘리기

처음부터 5,000개 데이터를 넣지 말고 20~50개 샘플로 목록, 검색, TTS, 퀴즈가 모두 작동하는지 확인합니다. 구조가 안정된 뒤 전체 데이터를 넣으면 대량 수정 비용을 줄일 수 있습니다.