Deckbase에 JSON 플래시카드 데이터를 가져오는 방법

이 워크플로를 사용해야 하는 경우

커스텀 도구, API, 프로그램 방식으로 카드를 생성하는 환경에서 옮겨오면서 가져오기 과정을 스키마 수준에서 제어해야 하는 개발자와 고급 사용자를 위한 내용이에요.

이 과정은 단순한 일회성 파일 업로드가 아니라 운영 관점의 마이그레이션 절차로 다뤄야 해요. 목표는 가져오기에 성공하는 것만이 아니라, 전환 후 몇 주 동안 복습 일관성을 높이고 카드 유지 관리 부담을 줄이는 것이에요.

가져오기 전 점검 목록

• JSON 파일이 front와 back에 대해 일관된 키를 가진 객체 배열 형태예요.
• 문자열이 유효한 UTF-8이고 이스케이프되지 않은 제어 문자를 포함하지 않아요.
• 태그, 메모 같은 선택 필드가 모든 객체에서 예측 가능한 키를 사용해요.

점검 목록 항목 중 하나라도 실패하면 가져오기 전에 먼저 해결하세요. 마이그레이션 후 수백 개의 카드를 고치는 것보다 미리 정리하는 편이 훨씬 빠릅니다.

단계별 마이그레이션 흐름

1. 1
   린터로 JSON 구조를 검증하고 모든 객체에 필수 front, back 키가 있는지 확인하세요.
2. 2
   매핑을 정하세요: 어떤 키가 카드 front, back, 태그, 메모가 될지 결정해요.
3. 3
   객체 10개로 작은 테스트 가져오기를 실행하고 카드 렌더링을 확인하세요.
4. 4
   인코딩 문제나 잘못 평탄화된 중첩 객체를 수정하세요.
5. 5
   전체 데이터셋을 가져오고 총 카드 수가 예상 행 수와 일치하는지 확인하세요.

자주 발생하는 오류와 해결 방법

수정할 때마다 작은 파일럿 덱으로 테스트하세요. 파일럿 품질이 유지되면 같은 수정 방식을 전체 배치에 적용하세요.

예시 결과물 품질 점검

• Front: JSON 스키마란? | Back: JSON 문서의 유효한 구조를 정의하는 어휘 체계예요.
• Front: JSON 배열과 객체의 차이는? | Back: 배열은 순서가 있는 목록이고, 객체는 순서가 없는 키-값 모음이에요.
• Front: 가져오기 전에 JSON을 검증해야 하는 이유는? | Back: 사전 검증으로 잘못된 카드와 대량 가져오기 실패를 막을 수 있어요.

QA 단계에서는 각 샘플 카드가 명확한지, 원자적인지, 답이 정확한지 확인하세요. 이해도를 확인하지 않고 표현만 시험하는 카드는 가져오지 마세요.

실용적인 기준은 이거예요. 복습 중 10초 안에 정확히 답할 수 있으면 보통 카드 범위가 적절해요. 그렇지 않다면 카드를 나누거나 다시 작성하세요.

자주 묻는 질문

관련 가이드

팁: 고급 워크플로를 사용한다면 원본 내보내기 파일을 백업으로 보관하고, 각 마이그레이션 시도를 배치 이름과 날짜로 기록하세요.