곡 보관함과 악보 학습 기능을 보완

업로드 형식을 MIDI와 MusicXML과 MXL 및 PDF로 확장하고 파일별 검증을 추가했다.

AlphaTab 악보 자산과 Nginx MIME 설정을 보완해 운영에서 오선과 음표가 표시되도록 수정했다.

공개 도메인 클래식과 난이도별 연습 편곡 7개를 같은 제목별로 묶고 출처와 운영 검증 결과를 문서화했다.

검사: TypeScript 검사와 Vitest 67개 및 Vite 운영 빌드 통과. 운영 브라우저 악보 표시와 네 가지 업로드 검증 형식 확인.
백업: /home/syskiller/piano/backups/bach-to-basics/20261003-1545-sheet-upload
운영 반영: 완료

backend/library_db.py

@@ -109,62 +109,126 @@ def delete_session(token: str | None) -> None:
 
 SAMPLES = (
     {
-        "storage_name": "first-snow-melody.mid",
-        "title": "첫눈이 내리는 밤",
-        "artist": "ITOSM 연습곡",
-        "description": "오른손으로 천천히 익히는 다장조 멜로디 연습곡",
+        "storage_name": "minuet-bwv-anh-114-beginner.mid",
+        "title": "미뉴에트 사장조 BWV Anh. 114",
+        "artist": "크리스티안 페촐트",
+        "description": "오른손 선율을 느린 속도로 먼저 익히는 입문 편곡입니다. 공개 도메인 원곡에서 연습용으로 구성했습니다.",
         "difficulty": "beginner",
-        "genre": "연습곡",
+        "genre": "바로크",
         "arrangement": "melody",
-        "tags": ["다장조", "오른손", "겨울", "입문"],
+        "tags": ["미뉴에트", "사장조", "오른손", "입문", "공개 도메인"],
     },
     {
-        "storage_name": "first-snow-accompaniment.mid",
-        "title": "첫눈이 내리는 밤",
-        "artist": "ITOSM 연습곡",
-        "description": "같은 곡을 양손 반주형으로 편곡한 중급 연습 버전",
-        "difficulty": "intermediate",
-        "genre": "연습곡",
-        "arrangement": "accompaniment",
-        "tags": ["다장조", "양손", "반주", "겨울"],
-    },
-    {
-        "storage_name": "blue-breeze-walk.mid",
-        "title": "파란 바람 산책",
-        "artist": "ITOSM 연습곡",
-        "description": "가벼운 리듬으로 연주하는 쉬운 멜로디",
+        "storage_name": "minuet-bwv-anh-114.mid",
+        "title": "미뉴에트 사장조 BWV Anh. 114",
+        "artist": "크리스티안 페촐트",
+        "description": "안나 막달레나 바흐 음악수첩에 수록된 양손 원곡입니다. Mutopia Project 공개 도메인 자료를 사용했습니다.",
         "difficulty": "easy",
-        "genre": "가요풍",
-        "arrangement": "melody",
-        "tags": ["멜로디", "리듬", "쉬움", "가요풍"],
+        "genre": "바로크",
+        "arrangement": "piano_solo",
+        "tags": ["미뉴에트", "사장조", "양손", "입문", "공개 도메인"],
     },
     {
-        "storage_name": "little-morning-waltz.mid",
-        "title": "아침의 작은 왈츠",
-        "artist": "ITOSM 연습곡",
-        "description": "3박자와 왼손 화음을 함께 익히는 피아노 독주곡",
-        "difficulty": "intermediate",
-        "genre": "왈츠",
-        "arrangement": "piano_solo",
-        "tags": ["3박자", "왈츠", "양손", "화음"],
+        "storage_name": "menuett-woo-82-easy.mid",
+        "title": "미뉴에트 내림마장조 WoO 82",
+        "artist": "루트비히 판 베토벤",
+        "description": "오른손 선율을 느린 속도로 익히는 쉬운 편곡입니다. 공개 도메인 원곡에서 연습용으로 구성했습니다.",
+        "difficulty": "easy",
+        "genre": "고전",
+        "arrangement": "melody",
+        "tags": ["미뉴에트", "내림마장조", "오른손", "쉬움", "공개 도메인"],
     },
+    {
+        "storage_name": "menuett-woo-82.mid",
+        "title": "미뉴에트 내림마장조 WoO 82",
+        "artist": "루트비히 판 베토벤",
+        "description": "고전주의의 프레이징과 양손 균형을 익히는 미뉴에트입니다. Mutopia Project 공개 도메인 자료를 사용했습니다.",
+        "difficulty": "intermediate",
+        "genre": "고전",
+        "arrangement": "piano_solo",
+        "tags": ["미뉴에트", "내림마장조", "양손", "고전", "공개 도메인"],
+    },
+    {
+        "storage_name": "fur-elise-beginner.mid",
+        "title": "엘리제를 위하여 WoO 59",
+        "artist": "루트비히 판 베토벤",
+        "description": "유명한 첫 주제를 오른손으로 천천히 익히는 입문 편곡입니다. 공개 도메인 원곡에서 연습용으로 구성했습니다.",
+        "difficulty": "beginner",
+        "genre": "고전",
+        "arrangement": "melody",
+        "tags": ["오른손", "주제 연습", "입문", "베토벤", "공개 도메인"],
+    },
+    {
+        "storage_name": "fur-elise-easy.mid",
+        "title": "엘리제를 위하여 WoO 59",
+        "artist": "루트비히 판 베토벤",
+        "description": "첫 주제의 오른손 선율과 단순화한 왼손 근음을 함께 연습하는 쉬운 양손 편곡입니다.",
+        "difficulty": "easy",
+        "genre": "고전",
+        "arrangement": "accompaniment",
+        "tags": ["양손", "쉬운 반주", "주제 연습", "베토벤", "공개 도메인"],
+    },
+    {
+        "storage_name": "fur-elise.mid",
+        "title": "엘리제를 위하여 WoO 59",
+        "artist": "루트비히 판 베토벤",
+        "description": "오른손 아르페지오와 양손 전환을 연습하는 대표적인 피아노 소품입니다. Mutopia Project 공개 도메인 자료를 사용했습니다.",
+        "difficulty": "advanced",
+        "genre": "고전",
+        "arrangement": "piano_solo",
+        "tags": ["아르페지오", "양손", "피아노 소품", "베토벤", "공개 도메인"],
+    },
+)
+
+LEGACY_SAMPLE_KEYS = (
+    "first-snow-melody.mid",
+    "first-snow-accompaniment.mid",
+    "blue-breeze-walk.mid",
+    "little-morning-waltz.mid",
 )
 
 
 def _seed_samples() -> None:
     source_root = Path(__file__).with_name("sample_midi")
     with connect() as connection:
+        # 초기 시험용으로 만든 짧은 음형은 실제 공개 도메인 연습곡으로 교체한다.
+        # seed_key가 정확히 일치하는 기본 자료만 지우므로 회원 업로드에는 영향을 주지 않는다.
+        placeholders = ",".join("?" for _ in LEGACY_SAMPLE_KEYS)
+        connection.execute(
+            f"DELETE FROM midi_items WHERE owner_id IS NULL AND seed_key IN ({placeholders})",
+            LEGACY_SAMPLE_KEYS,
+        )
+        for legacy_name in LEGACY_SAMPLE_KEYS:
+            (MIDI_ROOT / legacy_name).unlink(missing_ok=True)
         for sample in SAMPLES:
             source = source_root / sample["storage_name"]
             if not source.exists():
                 continue
             target = MIDI_ROOT / sample["storage_name"]
-            if not target.exists():
+            if not target.exists() or hashlib.sha256(target.read_bytes()).digest() != hashlib.sha256(source.read_bytes()).digest():
                 shutil.copyfile(source, target)
             existing = connection.execute(
                 "SELECT id FROM midi_items WHERE seed_key = ?", (sample["storage_name"],)
             ).fetchone()
             if existing:
+                content = target.read_bytes()
+                connection.execute(
+                    """
+                    UPDATE midi_items
+                       SET title = ?, artist = ?, description = ?, original_name = ?,
+                           storage_name = ?, size_bytes = ?, sha256 = ?, visibility = 'public',
+                           min_tier = 0, difficulty = ?, genre = ?, arrangement = ?,
+                           tags_json = ?, updated_at = ?
+                     WHERE id = ?
+                    """,
+                    (
+                        sample["title"], sample["artist"], sample["description"],
+                        sample["storage_name"], sample["storage_name"], len(content),
+                        hashlib.sha256(content).hexdigest(), sample["difficulty"], sample["genre"],
+                        sample["arrangement"], json.dumps(sample["tags"], ensure_ascii=False),
+                        utc_now(), existing["id"],
+                    ),
+                )
                 continue
             content = target.read_bytes()
             connection.execute(