bomcard
안키 엔진을 감싸 웹으로 옮긴 간격반복 학습 시스템 — 엔진 캡슐화와 크로스오리진 카드 렌더.
2026.05 — 운영 중운영 중
FastAPIReactanki engineMariaDB
일본어 공부를 위해 만든 간격반복(SRS) 학습 웹 시스템입니다. 데스크톱 안키를 쓰지 않고도 폰에서 같은 컬렉션을 돌릴 수 있게 하는 게 목표였습니다.
만든 것
- 엔진 캡슐화: 스케줄링(FSRS)·카드 렌더·
.apkg임포트는 안키 파이썬 엔진에 맡기고,ankiimport는 파일 하나에만 둡니다. 라우터는 안키 타입을 만지지 않습니다. 스케줄러를 직접 구현하지 않은 게 이 프로젝트의 가장 중요한 결정입니다 - 크로스오리진 카드 렌더: 덱 카드는 자체 스크립트와 스타일을 품고 있어서 앱에 그대로 넣으면 오염됩니다. 별 오리진의 iframe에 세션리스 서명 토큰으로 렌더해서, 카드 JS는 앱에 접근할 수 없고 자기 오리진의 폰트·저장소는 정상 동작합니다
- 학습 루프: 채점과 다음 카드를 한 왕복으로 처리하고, 정답 면을 미리 받아둬서 카드 전환에 흰 깜빡임이 없습니다
- 덱 운영: 덱별 옵션 그룹(하루 신규·복습 한도)을 앱에서 만들고 배정할 수 있고, 덱 단위로 카드를 재울 수 있습니다. 학습 이력이 있는 카드는 건드리지 않습니다
- 멀티유저: 승인제 회원가입과 유저별 격리 컬렉션. 계정 정보는 중앙 MariaDB에, 컬렉션은 유저별 경로에 둡니다
배운 것
iOS 사파리의 iframe 터치 이벤트는 지뢰밭입니다. 오파시티로 미리 띄워둔 프레임에 터치가 붙지 않는 문제를 공개 시점 마운트로 풀었습니다. "동작하는 코드"와 "모바일 사파리에서 동작하는 코드"는 다른 프로젝트입니다.
그리고 남이 만든 데이터에 의존하는 시스템은 그 데이터가 바뀔 때를 설계에 넣어야 합니다. 덱 업데이트 한 번에 우선순위 필드가 비워지면서 학습 계획의 기준이 사라진 적이 있습니다. 엔진을 한 곳에 가둬둔 덕에 앱 쪽 수정은 없었지만, 계획은 다시 짜야 했습니다.