# ITOSM Bach to Basics 프로젝트 기록

## 프로젝트 소속

- 서비스: ITOSM 피아노 학습실의 Bach to Basics 한국어판
- 공개 주소: `https://learn.itosm.co.kr`
- 운영 소스: `/home/syskiller/piano/bach-to-basics`
- Gitea 저장소: `syskiller/ITOSMPiano-BachToBasics`
- ITOSMGames와 `game.itosm.co.kr`에는 이 프로젝트 파일과 기록을 넣지 않는다.

## 2026-10-03 현재 상태

- Docker의 `piano-bach-frontend`와 `piano-bach-backend`로 운영한다.
- 로그인과 회원 가입과 비밀번호 변경과 회원 탈퇴를 지원한다.
- 관리자 권한이 확인된 계정에만 관리자 패널 진입 버튼을 표시한다.
- 곡별 공개 범위와 최소 회원 등급과 지정 회원 공유를 지원한다.
- 보관함 업로드 형식은 MIDI와 MusicXML과 MXL 및 PDF다.
- 공개 샘플은 Mutopia Project 공개 도메인 자료와 그 단계별 연습 편곡 7개다.
- 악보 표시에는 AlphaTab과 Bravura SMuFL 글꼴을 사용한다.

## 확인된 운영 결과

- 기존 회원 업로드 `20360.mid`는 `보글보글`이라는 제목으로 보존돼 있다.
- 엘리제를 위하여는 입문과 쉬움과 고급 3개 버전으로 묶여 표시된다.
- 두 미뉴에트는 각각 오른손 연습과 양손 원곡 2개 버전으로 묶여 표시된다.
- 운영 브라우저에서 미뉴에트와 엘리제를 위하여 입문 악보의 오선과 음표 표시를 확인했다.
- 운영 백엔드에서 MIDI와 MusicXML과 MXL 및 PDF 검증기를 모두 통과했다.
- 프런트 타입 검사와 67개 테스트와 운영 빌드를 통과했다.

## 백업

- 작업 전 DB와 수정 대상 소스: `/home/syskiller/piano/backups/bach-to-basics/20261003-1545-sheet-upload`

## 남은 확인

- 실제 회원 화면에서 MusicXML과 MXL 및 PDF 파일을 각각 업로드한 뒤 삭제하는 통합 검사를 추가로 수행한다.
- 실제 USB MIDI 피아노를 연결한 모바일 또는 태블릿 Chromium 환경에서 입력 지연과 따라치기 동작을 확인한다.